--- a/eric6/Documentation/Source/eric6.MicroPython.EspDevices.html Wed Sep 25 19:40:31 2019 +0200 +++ b/eric6/Documentation/Source/eric6.MicroPython.EspDevices.html Wed Sep 25 19:42:44 2019 +0200 @@ -18,275 +18,358 @@ </style> </head> -<body><a NAME="top" ID="top"></a> +<body> +<a NAME="top" ID="top"></a> <h1>eric6.MicroPython.EspDevices</h1> + <p> Module implementing some utility functions and the MicroPythonDevice base class. </p> <h3>Global Attributes</h3> + <table> <tr><td>None</td></tr> </table> <h3>Classes</h3> + <table> + <tr> <td><a href="#EspDevice">EspDevice</a></td> <td>Class implementing the device for ESP32 and ESP8266 based boards.</td> </tr> </table> <h3>Functions</h3> + <table> <tr><td>None</td></tr> </table> -<hr /><hr /> +<hr /> +<hr /> <a NAME="EspDevice" ID="EspDevice"></a> <h2>EspDevice</h2> + <p> Class implementing the device for ESP32 and ESP8266 based 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="#EspDevice.__init__">EspDevice</a></td> <td>Constructor</td> -</tr><tr> +</tr> +<tr> <td><a href="#EspDevice.__eraseFlash">__eraseFlash</a></td> <td>Private slot to erase the device flash memory.</td> -</tr><tr> +</tr> +<tr> <td><a href="#EspDevice.__flashAddons">__flashAddons</a></td> <td>Private slot to flash some additional firmware images.</td> -</tr><tr> +</tr> +<tr> <td><a href="#EspDevice.__flashMicroPython">__flashMicroPython</a></td> <td>Private slot to flash a MicroPython firmware to the device.</td> -</tr><tr> +</tr> +<tr> <td><a href="#EspDevice.__installEspTool">__installEspTool</a></td> <td>Private slot to install the esptool package via pip.</td> -</tr><tr> +</tr> +<tr> <td><a href="#EspDevice.__resetDevice">__resetDevice</a></td> <td>Private slot to reset the connected device.</td> -</tr><tr> +</tr> +<tr> <td><a href="#EspDevice.addDeviceMenuEntries">addDeviceMenuEntries</a></td> <td>Public method to add device specific entries to the given menu.</td> -</tr><tr> +</tr> +<tr> <td><a href="#EspDevice.canRunScript">canRunScript</a></td> <td>Public method to determine, if a script can be executed.</td> -</tr><tr> +</tr> +<tr> <td><a href="#EspDevice.canStartFileManager">canStartFileManager</a></td> <td>Public method to determine, if a File Manager can be started.</td> -</tr><tr> +</tr> +<tr> <td><a href="#EspDevice.canStartPlotter">canStartPlotter</a></td> <td>Public method to determine, if a Plotter can be started.</td> -</tr><tr> +</tr> +<tr> <td><a href="#EspDevice.canStartRepl">canStartRepl</a></td> <td>Public method to determine, if a REPL can be started.</td> -</tr><tr> +</tr> +<tr> <td><a href="#EspDevice.deviceName">deviceName</a></td> <td>Public method to get the name of the device.</td> -</tr><tr> +</tr> +<tr> <td><a href="#EspDevice.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="#EspDevice.getDocumentationUrl">getDocumentationUrl</a></td> <td>Public method to get the device documentation URL.</td> -</tr><tr> +</tr> +<tr> <td><a href="#EspDevice.runScript">runScript</a></td> <td>Public method to run the given Python script.</td> -</tr><tr> +</tr> +<tr> <td><a href="#EspDevice.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="EspDevice.__init__" ID="EspDevice.__init__"></a> <h4>EspDevice (Constructor)</h4> <b>EspDevice</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="EspDevice.__eraseFlash" ID="EspDevice.__eraseFlash"></a> +</dl> +<a NAME="EspDevice.__eraseFlash" ID="EspDevice.__eraseFlash"></a> <h4>EspDevice.__eraseFlash</h4> <b>__eraseFlash</b>(<i></i>) + <p> Private slot to erase the device flash memory. -</p><a NAME="EspDevice.__flashAddons" ID="EspDevice.__flashAddons"></a> +</p> +<a NAME="EspDevice.__flashAddons" ID="EspDevice.__flashAddons"></a> <h4>EspDevice.__flashAddons</h4> <b>__flashAddons</b>(<i></i>) + <p> Private slot to flash some additional firmware images. -</p><a NAME="EspDevice.__flashMicroPython" ID="EspDevice.__flashMicroPython"></a> +</p> +<a NAME="EspDevice.__flashMicroPython" ID="EspDevice.__flashMicroPython"></a> <h4>EspDevice.__flashMicroPython</h4> <b>__flashMicroPython</b>(<i></i>) + <p> Private slot to flash a MicroPython firmware to the device. -</p><dl> +</p> +<dl> + <dt>Raises <b>ValueError</b>:</dt> <dd> raised to indicate an unsupported chip type </dd> -</dl><a NAME="EspDevice.__installEspTool" ID="EspDevice.__installEspTool"></a> +</dl> +<a NAME="EspDevice.__installEspTool" ID="EspDevice.__installEspTool"></a> <h4>EspDevice.__installEspTool</h4> <b>__installEspTool</b>(<i></i>) + <p> Private slot to install the esptool package via pip. -</p><a NAME="EspDevice.__resetDevice" ID="EspDevice.__resetDevice"></a> +</p> +<a NAME="EspDevice.__resetDevice" ID="EspDevice.__resetDevice"></a> <h4>EspDevice.__resetDevice</h4> <b>__resetDevice</b>(<i></i>) + <p> Private slot to reset the connected device. -</p><a NAME="EspDevice.addDeviceMenuEntries" ID="EspDevice.addDeviceMenuEntries"></a> +</p> +<a NAME="EspDevice.addDeviceMenuEntries" ID="EspDevice.addDeviceMenuEntries"></a> <h4>EspDevice.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="EspDevice.canRunScript" ID="EspDevice.canRunScript"></a> +</dl> +<a NAME="EspDevice.canRunScript" ID="EspDevice.canRunScript"></a> <h4>EspDevice.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="EspDevice.canStartFileManager" ID="EspDevice.canStartFileManager"></a> +</dl> +<a NAME="EspDevice.canStartFileManager" ID="EspDevice.canStartFileManager"></a> <h4>EspDevice.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="EspDevice.canStartPlotter" ID="EspDevice.canStartPlotter"></a> +</dl> +<a NAME="EspDevice.canStartPlotter" ID="EspDevice.canStartPlotter"></a> <h4>EspDevice.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="EspDevice.canStartRepl" ID="EspDevice.canStartRepl"></a> +</dl> +<a NAME="EspDevice.canStartRepl" ID="EspDevice.canStartRepl"></a> <h4>EspDevice.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="EspDevice.deviceName" ID="EspDevice.deviceName"></a> +</dl> +<a NAME="EspDevice.deviceName" ID="EspDevice.deviceName"></a> <h4>EspDevice.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="EspDevice.forceInterrupt" ID="EspDevice.forceInterrupt"></a> +</dl> +<a NAME="EspDevice.forceInterrupt" ID="EspDevice.forceInterrupt"></a> <h4>EspDevice.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="EspDevice.getDocumentationUrl" ID="EspDevice.getDocumentationUrl"></a> +</dl> +<a NAME="EspDevice.getDocumentationUrl" ID="EspDevice.getDocumentationUrl"></a> <h4>EspDevice.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="EspDevice.runScript" ID="EspDevice.runScript"></a> +</dl> +<a NAME="EspDevice.runScript" ID="EspDevice.runScript"></a> <h4>EspDevice.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="EspDevice.setButtons" ID="EspDevice.setButtons"></a> +</dl> +<a NAME="EspDevice.setButtons" ID="EspDevice.setButtons"></a> <h4>EspDevice.setButtons</h4> <b>setButtons</b>(<i></i>) + <p> Public method to enable the supported action buttons. </p>