Add JLINKARM_SetLogFile support (#90)

* Add JLINKARM_SetLogFile Support.

Author: Sauci

pylink/jlink.py

@@ -810,6 +810,25 @@ def test(self):
         res = self._dll.JLINKARM_Test()
         return (res == 0)
 
+    @open_required
+    def set_log_file(self, file_path):
+        """Sets the log file output path.
+        see https://wiki.segger.com/Enable_J-Link_log_file
+
+        Args:
+          self (JLink): the ``JLink`` instance
+          file_path (str): the file path where the log file will be stored
+
+        Returns:
+          ``None``
+
+        Raises:
+          JLinkException: if the path specified is invalid.
+        """
+        res = self._dll.JLINKARM_SetLogFile(file_path.encode())
+        if res:
+            raise errors.JLinkException(res)
+
     @open_required
     def invalidate_firmware(self):
         """Invalidates the emulator's firmware.

tests/unit/test_jlink.py

@@ -6201,6 +6201,32 @@ def test_cp15_register_write_raises_exception_if_CP15_WriteEx_fails(self):
         with self.assertRaises(JLinkException):
             self.jlink.cp15_register_write(0, 0, 0, 0, 0)
 
+    def test_set_log_file_success(self):
+        """Tests that set_log_file uses provided parameters.
+
+        Args:
+          self (TestJLink): the ``TestJLink`` instance
+
+        Returns:
+          ``None``
+        """
+        args = ['my/file/path']
+        self.dll.JLINKARM_SetLogFile.return_value = 0
+        self.jlink.set_log_file(*args)
+        assert self.dll.JLINKARM_SetLogFile.called_once_with(*args)
+
+    def test_set_log_file_raises_exception_if_SetLogFile_fails(self):
+        """Tests that set_log_file raises a JLinkException on failure.
+        Args:
+          self (TestJLink): the ``TestJLink`` instance
+
+        Returns:
+          ``None``
+        """
+        self.dll.JLINKARM_SetLogFile.return_value = -1
+        with self.assertRaises(JLinkException):
+            self.jlink.set_log_file('my/file/path')
+
 
 if __name__ == '__main__':
     unittest.main()