diff -r 1779dc278077 -r 391d6b7b1eff eric6/Documentation/Source/eric6.MicroPython.CircuitPythonDevices.html --- a/eric6/Documentation/Source/eric6.MicroPython.CircuitPythonDevices.html Wed Sep 25 19:40:31 2019 +0200 +++ b/eric6/Documentation/Source/eric6.MicroPython.CircuitPythonDevices.html Wed Sep 25 19:42:44 2019 +0200 @@ -18,302 +18,391 @@ </style> </head> -<body><a NAME="top" ID="top"></a> +<body> +<a NAME="top" ID="top"></a> <h1>eric6.MicroPython.CircuitPythonDevices</h1> + <p> Module implementing the device interface class for CircuitPython boards. </p> <h3>Global Attributes</h3> + <table> <tr><td>None</td></tr> </table> <h3>Classes</h3> + <table> + <tr> <td><a href="#CircuitPythonDevice">CircuitPythonDevice</a></td> <td>Class implementing the device for CircuitPython boards.</td> </tr> </table> <h3>Functions</h3> + <table> <tr><td>None</td></tr> </table> -<hr /><hr /> +<hr /> +<hr /> <a NAME="CircuitPythonDevice" ID="CircuitPythonDevice"></a> <h2>CircuitPythonDevice</h2> + <p> Class implementing the device for CircuitPython boards. </p> <h3>Derived from</h3> MicroPythonDevice <h3>Class Attributes</h3> + <table> <tr><td>DeviceVolumeName</td></tr> </table> <h3>Class Methods</h3> + <table> <tr><td>None</td></tr> </table> <h3>Methods</h3> + <table> + <tr> <td><a href="#CircuitPythonDevice.__init__">CircuitPythonDevice</a></td> <td>Constructor</td> -</tr><tr> +</tr> +<tr> <td><a href="#CircuitPythonDevice.__deviceVolumeMounted">__deviceVolumeMounted</a></td> <td>Private method to check, if the device volume is mounted.</td> -</tr><tr> +</tr> +<tr> <td><a href="#CircuitPythonDevice.__flashCircuitPython">__flashCircuitPython</a></td> <td>Private slot to flash a CircuitPython firmware to the device.</td> -</tr><tr> +</tr> +<tr> <td><a href="#CircuitPythonDevice.__installLibraryFiles">__installLibraryFiles</a></td> <td>Private slot to install Python files into the onboard library.</td> -</tr><tr> +</tr> +<tr> <td><a href="#CircuitPythonDevice.addDeviceMenuEntries">addDeviceMenuEntries</a></td> <td>Public method to add device specific entries to the given menu.</td> -</tr><tr> +</tr> +<tr> <td><a href="#CircuitPythonDevice.canRunScript">canRunScript</a></td> <td>Public method to determine, if a script can be executed.</td> -</tr><tr> +</tr> +<tr> <td><a href="#CircuitPythonDevice.canStartFileManager">canStartFileManager</a></td> <td>Public method to determine, if a File Manager can be started.</td> -</tr><tr> +</tr> +<tr> <td><a href="#CircuitPythonDevice.canStartPlotter">canStartPlotter</a></td> <td>Public method to determine, if a Plotter can be started.</td> -</tr><tr> +</tr> +<tr> <td><a href="#CircuitPythonDevice.canStartRepl">canStartRepl</a></td> <td>Public method to determine, if a REPL can be started.</td> -</tr><tr> +</tr> +<tr> <td><a href="#CircuitPythonDevice.deviceName">deviceName</a></td> <td>Public method to get the name of the device.</td> -</tr><tr> +</tr> +<tr> <td><a href="#CircuitPythonDevice.forceInterrupt">forceInterrupt</a></td> <td>Public method to determine the need for an interrupt when opening the serial connection.</td> -</tr><tr> +</tr> +<tr> <td><a href="#CircuitPythonDevice.getDocumentationUrl">getDocumentationUrl</a></td> <td>Public method to get the device documentation URL.</td> -</tr><tr> +</tr> +<tr> <td><a href="#CircuitPythonDevice.getWorkspace">getWorkspace</a></td> <td>Public method to get the workspace directory.</td> -</tr><tr> +</tr> +<tr> <td><a href="#CircuitPythonDevice.runScript">runScript</a></td> <td>Public method to run the given Python script.</td> -</tr><tr> +</tr> +<tr> <td><a href="#CircuitPythonDevice.setButtons">setButtons</a></td> <td>Public method to enable the supported action buttons.</td> -</tr><tr> +</tr> +<tr> <td><a href="#CircuitPythonDevice.supportsLocalFileAccess">supportsLocalFileAccess</a></td> <td>Public method to indicate file access via a local directory.</td> </tr> </table> <h3>Static Methods</h3> + <table> <tr><td>None</td></tr> </table> + <a NAME="CircuitPythonDevice.__init__" ID="CircuitPythonDevice.__init__"></a> <h4>CircuitPythonDevice (Constructor)</h4> <b>CircuitPythonDevice</b>(<i>microPythonWidget, parent=None</i>) + <p> Constructor -</p><dl> +</p> +<dl> + <dt><i>microPythonWidget</i> (MicroPythonWidget)</dt> <dd> reference to the main MicroPython widget -</dd><dt><i>parent</i> (QObject)</dt> +</dd> +<dt><i>parent</i> (QObject)</dt> <dd> reference to the parent object </dd> -</dl><a NAME="CircuitPythonDevice.__deviceVolumeMounted" ID="CircuitPythonDevice.__deviceVolumeMounted"></a> +</dl> +<a NAME="CircuitPythonDevice.__deviceVolumeMounted" ID="CircuitPythonDevice.__deviceVolumeMounted"></a> <h4>CircuitPythonDevice.__deviceVolumeMounted</h4> <b>__deviceVolumeMounted</b>(<i></i>) + <p> Private method to check, if the device volume is mounted. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> flag indicated a mounted device </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> bool </dd> -</dl><a NAME="CircuitPythonDevice.__flashCircuitPython" ID="CircuitPythonDevice.__flashCircuitPython"></a> +</dl> +<a NAME="CircuitPythonDevice.__flashCircuitPython" ID="CircuitPythonDevice.__flashCircuitPython"></a> <h4>CircuitPythonDevice.__flashCircuitPython</h4> <b>__flashCircuitPython</b>(<i></i>) + <p> Private slot to flash a CircuitPython firmware to the device. -</p><a NAME="CircuitPythonDevice.__installLibraryFiles" ID="CircuitPythonDevice.__installLibraryFiles"></a> +</p> +<a NAME="CircuitPythonDevice.__installLibraryFiles" ID="CircuitPythonDevice.__installLibraryFiles"></a> <h4>CircuitPythonDevice.__installLibraryFiles</h4> <b>__installLibraryFiles</b>(<i></i>) + <p> Private slot to install Python files into the onboard library. -</p><a NAME="CircuitPythonDevice.addDeviceMenuEntries" ID="CircuitPythonDevice.addDeviceMenuEntries"></a> +</p> +<a NAME="CircuitPythonDevice.addDeviceMenuEntries" ID="CircuitPythonDevice.addDeviceMenuEntries"></a> <h4>CircuitPythonDevice.addDeviceMenuEntries</h4> <b>addDeviceMenuEntries</b>(<i>menu</i>) + <p> Public method to add device specific entries to the given menu. -</p><dl> +</p> +<dl> + <dt><i>menu</i> (QMenu)</dt> <dd> reference to the context menu </dd> -</dl><a NAME="CircuitPythonDevice.canRunScript" ID="CircuitPythonDevice.canRunScript"></a> +</dl> +<a NAME="CircuitPythonDevice.canRunScript" ID="CircuitPythonDevice.canRunScript"></a> <h4>CircuitPythonDevice.canRunScript</h4> <b>canRunScript</b>(<i></i>) + <p> Public method to determine, if a script can be executed. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> tuple containing a flag indicating it is safe to start a Plotter and a reason why it cannot. </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> tuple of (bool, str) </dd> -</dl><a NAME="CircuitPythonDevice.canStartFileManager" ID="CircuitPythonDevice.canStartFileManager"></a> +</dl> +<a NAME="CircuitPythonDevice.canStartFileManager" ID="CircuitPythonDevice.canStartFileManager"></a> <h4>CircuitPythonDevice.canStartFileManager</h4> <b>canStartFileManager</b>(<i></i>) + <p> Public method to determine, if a File Manager can be started. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> tuple containing a flag indicating it is safe to start a File Manager and a reason why it cannot. </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> tuple of (bool, str) </dd> -</dl><a NAME="CircuitPythonDevice.canStartPlotter" ID="CircuitPythonDevice.canStartPlotter"></a> +</dl> +<a NAME="CircuitPythonDevice.canStartPlotter" ID="CircuitPythonDevice.canStartPlotter"></a> <h4>CircuitPythonDevice.canStartPlotter</h4> <b>canStartPlotter</b>(<i></i>) + <p> Public method to determine, if a Plotter can be started. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> tuple containing a flag indicating it is safe to start a Plotter and a reason why it cannot. </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> tuple of (bool, str) </dd> -</dl><a NAME="CircuitPythonDevice.canStartRepl" ID="CircuitPythonDevice.canStartRepl"></a> +</dl> +<a NAME="CircuitPythonDevice.canStartRepl" ID="CircuitPythonDevice.canStartRepl"></a> <h4>CircuitPythonDevice.canStartRepl</h4> <b>canStartRepl</b>(<i></i>) + <p> Public method to determine, if a REPL can be started. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> tuple containing a flag indicating it is safe to start a REPL and a reason why it cannot. </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> tuple of (bool, str) </dd> -</dl><a NAME="CircuitPythonDevice.deviceName" ID="CircuitPythonDevice.deviceName"></a> +</dl> +<a NAME="CircuitPythonDevice.deviceName" ID="CircuitPythonDevice.deviceName"></a> <h4>CircuitPythonDevice.deviceName</h4> <b>deviceName</b>(<i></i>) + <p> Public method to get the name of the device. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> name of the device </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> str </dd> -</dl><a NAME="CircuitPythonDevice.forceInterrupt" ID="CircuitPythonDevice.forceInterrupt"></a> +</dl> +<a NAME="CircuitPythonDevice.forceInterrupt" ID="CircuitPythonDevice.forceInterrupt"></a> <h4>CircuitPythonDevice.forceInterrupt</h4> <b>forceInterrupt</b>(<i></i>) + <p> Public method to determine the need for an interrupt when opening the serial connection. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> flag indicating an interrupt is needed </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> bool </dd> -</dl><a NAME="CircuitPythonDevice.getDocumentationUrl" ID="CircuitPythonDevice.getDocumentationUrl"></a> +</dl> +<a NAME="CircuitPythonDevice.getDocumentationUrl" ID="CircuitPythonDevice.getDocumentationUrl"></a> <h4>CircuitPythonDevice.getDocumentationUrl</h4> <b>getDocumentationUrl</b>(<i></i>) + <p> Public method to get the device documentation URL. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> documentation URL of the device </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> str </dd> -</dl><a NAME="CircuitPythonDevice.getWorkspace" ID="CircuitPythonDevice.getWorkspace"></a> +</dl> +<a NAME="CircuitPythonDevice.getWorkspace" ID="CircuitPythonDevice.getWorkspace"></a> <h4>CircuitPythonDevice.getWorkspace</h4> <b>getWorkspace</b>(<i>silent=False</i>) + <p> Public method to get the workspace directory. -</p><dl> +</p> +<dl> + <dt><i>silent</i> (bool)</dt> <dd> flag indicating silent operations </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> workspace directory used for saving files </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> str </dd> -</dl><a NAME="CircuitPythonDevice.runScript" ID="CircuitPythonDevice.runScript"></a> +</dl> +<a NAME="CircuitPythonDevice.runScript" ID="CircuitPythonDevice.runScript"></a> <h4>CircuitPythonDevice.runScript</h4> <b>runScript</b>(<i>script</i>) + <p> Public method to run the given Python script. -</p><dl> +</p> +<dl> + <dt><i>script</i> (str)</dt> <dd> script to be executed </dd> -</dl><a NAME="CircuitPythonDevice.setButtons" ID="CircuitPythonDevice.setButtons"></a> +</dl> +<a NAME="CircuitPythonDevice.setButtons" ID="CircuitPythonDevice.setButtons"></a> <h4>CircuitPythonDevice.setButtons</h4> <b>setButtons</b>(<i></i>) + <p> Public method to enable the supported action buttons. -</p><a NAME="CircuitPythonDevice.supportsLocalFileAccess" ID="CircuitPythonDevice.supportsLocalFileAccess"></a> +</p> +<a NAME="CircuitPythonDevice.supportsLocalFileAccess" ID="CircuitPythonDevice.supportsLocalFileAccess"></a> <h4>CircuitPythonDevice.supportsLocalFileAccess</h4> <b>supportsLocalFileAccess</b>(<i></i>) + <p> Public method to indicate file access via a local directory. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> flag indicating file access via local directory </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> bool