--- a/eric6/Documentation/Source/eric6.MicroPython.MicrobitDevices.html Wed Sep 25 19:40:31 2019 +0200 +++ b/eric6/Documentation/Source/eric6.MicroPython.MicrobitDevices.html Wed Sep 25 19:42:44 2019 +0200 @@ -18,316 +18,411 @@ </style> </head> -<body><a NAME="top" ID="top"></a> +<body> +<a NAME="top" ID="top"></a> <h1>eric6.MicroPython.MicrobitDevices</h1> + <p> Module implementing the device interface class for BBC micro:bit boards. </p> <h3>Global Attributes</h3> + <table> <tr><td>None</td></tr> </table> <h3>Classes</h3> + <table> + <tr> <td><a href="#MicrobitDevice">MicrobitDevice</a></td> <td>Class implementing the device for BBC micro:bit boards.</td> </tr> </table> <h3>Functions</h3> + <table> <tr><td>None</td></tr> </table> -<hr /><hr /> +<hr /> +<hr /> <a NAME="MicrobitDevice" ID="MicrobitDevice"></a> <h2>MicrobitDevice</h2> + <p> Class implementing the device for BBC micro:bit boards. </p> <h3>Derived from</h3> MicroPythonDevice <h3>Class Attributes</h3> + <table> <tr><td>None</td></tr> </table> <h3>Class Methods</h3> + <table> <tr><td>None</td></tr> </table> <h3>Methods</h3> + <table> + <tr> <td><a href="#MicrobitDevice.__init__">MicrobitDevice</a></td> <td>Constructor</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicrobitDevice.__flashCustomMicroPython">__flashCustomMicroPython</a></td> <td>Private slot to flash a custom MicroPython firmware to the device.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicrobitDevice.__flashMicroPython">__flashMicroPython</a></td> <td>Private slot to flash the default MicroPython firmware to the device.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicrobitDevice.__flashScript">__flashScript</a></td> <td>Private slot to flash the current script onto the selected device.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicrobitDevice.__installUflashTool">__installUflashTool</a></td> <td>Private slot to install the uflash package via pip.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicrobitDevice.__resetDevice">__resetDevice</a></td> <td>Private slot to reset the connected device.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicrobitDevice.__saveMain">__saveMain</a></td> <td>Private slot to copy the current script as 'main.py' onto the connected device.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicrobitDevice.addDeviceMenuEntries">addDeviceMenuEntries</a></td> <td>Public method to add device specific entries to the given menu.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicrobitDevice.canRunScript">canRunScript</a></td> <td>Public method to determine, if a script can be executed.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicrobitDevice.canStartFileManager">canStartFileManager</a></td> <td>Public method to determine, if a File Manager can be started.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicrobitDevice.canStartPlotter">canStartPlotter</a></td> <td>Public method to determine, if a Plotter can be started.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicrobitDevice.canStartRepl">canStartRepl</a></td> <td>Public method to determine, if a REPL can be started.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicrobitDevice.deviceName">deviceName</a></td> <td>Public method to get the name of the device.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicrobitDevice.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="#MicrobitDevice.getDocumentationUrl">getDocumentationUrl</a></td> <td>Public method to get the device documentation URL.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicrobitDevice.getWorkspace">getWorkspace</a></td> <td>Public method to get the workspace directory.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicrobitDevice.hasTimeCommands">hasTimeCommands</a></td> <td>Public method to check, if the device supports time commands.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicrobitDevice.runScript">runScript</a></td> <td>Public method to run the given Python script.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicrobitDevice.setButtons">setButtons</a></td> <td>Public method to enable the supported action buttons.</td> </tr> </table> <h3>Static Methods</h3> + <table> <tr><td>None</td></tr> </table> + <a NAME="MicrobitDevice.__init__" ID="MicrobitDevice.__init__"></a> <h4>MicrobitDevice (Constructor)</h4> <b>MicrobitDevice</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="MicrobitDevice.__flashCustomMicroPython" ID="MicrobitDevice.__flashCustomMicroPython"></a> +</dl> +<a NAME="MicrobitDevice.__flashCustomMicroPython" ID="MicrobitDevice.__flashCustomMicroPython"></a> <h4>MicrobitDevice.__flashCustomMicroPython</h4> <b>__flashCustomMicroPython</b>(<i></i>) + <p> Private slot to flash a custom MicroPython firmware to the device. -</p><a NAME="MicrobitDevice.__flashMicroPython" ID="MicrobitDevice.__flashMicroPython"></a> +</p> +<a NAME="MicrobitDevice.__flashMicroPython" ID="MicrobitDevice.__flashMicroPython"></a> <h4>MicrobitDevice.__flashMicroPython</h4> <b>__flashMicroPython</b>(<i></i>) + <p> Private slot to flash the default MicroPython firmware to the device. -</p><a NAME="MicrobitDevice.__flashScript" ID="MicrobitDevice.__flashScript"></a> +</p> +<a NAME="MicrobitDevice.__flashScript" ID="MicrobitDevice.__flashScript"></a> <h4>MicrobitDevice.__flashScript</h4> <b>__flashScript</b>(<i></i>) + <p> Private slot to flash the current script onto the selected device. -</p><a NAME="MicrobitDevice.__installUflashTool" ID="MicrobitDevice.__installUflashTool"></a> +</p> +<a NAME="MicrobitDevice.__installUflashTool" ID="MicrobitDevice.__installUflashTool"></a> <h4>MicrobitDevice.__installUflashTool</h4> <b>__installUflashTool</b>(<i></i>) + <p> Private slot to install the uflash package via pip. -</p><a NAME="MicrobitDevice.__resetDevice" ID="MicrobitDevice.__resetDevice"></a> +</p> +<a NAME="MicrobitDevice.__resetDevice" ID="MicrobitDevice.__resetDevice"></a> <h4>MicrobitDevice.__resetDevice</h4> <b>__resetDevice</b>(<i></i>) + <p> Private slot to reset the connected device. -</p><a NAME="MicrobitDevice.__saveMain" ID="MicrobitDevice.__saveMain"></a> +</p> +<a NAME="MicrobitDevice.__saveMain" ID="MicrobitDevice.__saveMain"></a> <h4>MicrobitDevice.__saveMain</h4> <b>__saveMain</b>(<i></i>) + <p> Private slot to copy the current script as 'main.py' onto the connected device. -</p><a NAME="MicrobitDevice.addDeviceMenuEntries" ID="MicrobitDevice.addDeviceMenuEntries"></a> +</p> +<a NAME="MicrobitDevice.addDeviceMenuEntries" ID="MicrobitDevice.addDeviceMenuEntries"></a> <h4>MicrobitDevice.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="MicrobitDevice.canRunScript" ID="MicrobitDevice.canRunScript"></a> +</dl> +<a NAME="MicrobitDevice.canRunScript" ID="MicrobitDevice.canRunScript"></a> <h4>MicrobitDevice.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="MicrobitDevice.canStartFileManager" ID="MicrobitDevice.canStartFileManager"></a> +</dl> +<a NAME="MicrobitDevice.canStartFileManager" ID="MicrobitDevice.canStartFileManager"></a> <h4>MicrobitDevice.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="MicrobitDevice.canStartPlotter" ID="MicrobitDevice.canStartPlotter"></a> +</dl> +<a NAME="MicrobitDevice.canStartPlotter" ID="MicrobitDevice.canStartPlotter"></a> <h4>MicrobitDevice.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="MicrobitDevice.canStartRepl" ID="MicrobitDevice.canStartRepl"></a> +</dl> +<a NAME="MicrobitDevice.canStartRepl" ID="MicrobitDevice.canStartRepl"></a> <h4>MicrobitDevice.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="MicrobitDevice.deviceName" ID="MicrobitDevice.deviceName"></a> +</dl> +<a NAME="MicrobitDevice.deviceName" ID="MicrobitDevice.deviceName"></a> <h4>MicrobitDevice.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="MicrobitDevice.forceInterrupt" ID="MicrobitDevice.forceInterrupt"></a> +</dl> +<a NAME="MicrobitDevice.forceInterrupt" ID="MicrobitDevice.forceInterrupt"></a> <h4>MicrobitDevice.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="MicrobitDevice.getDocumentationUrl" ID="MicrobitDevice.getDocumentationUrl"></a> +</dl> +<a NAME="MicrobitDevice.getDocumentationUrl" ID="MicrobitDevice.getDocumentationUrl"></a> <h4>MicrobitDevice.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="MicrobitDevice.getWorkspace" ID="MicrobitDevice.getWorkspace"></a> +</dl> +<a NAME="MicrobitDevice.getWorkspace" ID="MicrobitDevice.getWorkspace"></a> <h4>MicrobitDevice.getWorkspace</h4> <b>getWorkspace</b>(<i></i>) + <p> Public method to get the workspace directory. -</p><dl> +</p> +<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="MicrobitDevice.hasTimeCommands" ID="MicrobitDevice.hasTimeCommands"></a> +</dl> +<a NAME="MicrobitDevice.hasTimeCommands" ID="MicrobitDevice.hasTimeCommands"></a> <h4>MicrobitDevice.hasTimeCommands</h4> <b>hasTimeCommands</b>(<i></i>) + <p> Public method to check, if the device supports time commands. -</p><p> +</p> +<p> The default returns True. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> flag indicating support for time commands </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> bool </dd> -</dl><a NAME="MicrobitDevice.runScript" ID="MicrobitDevice.runScript"></a> +</dl> +<a NAME="MicrobitDevice.runScript" ID="MicrobitDevice.runScript"></a> <h4>MicrobitDevice.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="MicrobitDevice.setButtons" ID="MicrobitDevice.setButtons"></a> +</dl> +<a NAME="MicrobitDevice.setButtons" ID="MicrobitDevice.setButtons"></a> <h4>MicrobitDevice.setButtons</h4> <b>setButtons</b>(<i></i>) + <p> Public method to enable the supported action buttons. </p>