src/eric7/Documentation/Source/eric7.MicroPython.Devices.RP2040Devices.html

branch
mpy_network
changeset 9878
a82014a9e57b
parent 9871
4a302b8c4d28
child 9880
f425c58cf8e9
--- a/src/eric7/Documentation/Source/eric7.MicroPython.Devices.RP2040Devices.html	Sat Mar 11 15:28:47 2023 +0100
+++ b/src/eric7/Documentation/Source/eric7.MicroPython.Devices.RP2040Devices.html	Sun Mar 12 14:56:04 2023 +0100
@@ -124,10 +124,22 @@
 <td>Public method to check, if the internet can be reached.</td>
 </tr>
 <tr>
+<td><a href="#RP2040Device.checkInternetViaLan">checkInternetViaLan</a></td>
+<td>Public method to check, if the internet can be reached (LAN variant).</td>
+</tr>
+<tr>
+<td><a href="#RP2040Device.connectToLan">connectToLan</a></td>
+<td>Public method to connect the connected device to the LAN.</td>
+</tr>
+<tr>
 <td><a href="#RP2040Device.connectWifi">connectWifi</a></td>
 <td>Public method to connect a device to a WiFi network.</td>
 </tr>
 <tr>
+<td><a href="#RP2040Device.deactivateEthernet">deactivateEthernet</a></td>
+<td>Public method to deactivate the Ethernet interface of the connected device.</td>
+</tr>
+<tr>
 <td><a href="#RP2040Device.deactivateInterface">deactivateInterface</a></td>
 <td>Public method to deactivate a given WiFi interface of the connected device.</td>
 </tr>
@@ -136,6 +148,10 @@
 <td>Public method to get the name of the device.</td>
 </tr>
 <tr>
+<td><a href="#RP2040Device.disconnectFromLan">disconnectFromLan</a></td>
+<td>Public method  to disconnect from the LAN.</td>
+</tr>
+<tr>
 <td><a href="#RP2040Device.disconnectWifi">disconnectWifi</a></td>
 <td>Public method to disconnect a device from the WiFi network.</td>
 </tr>
@@ -156,10 +172,18 @@
 <td>Public method to retrieve the entries for the downloads menu.</td>
 </tr>
 <tr>
+<td><a href="#RP2040Device.getEthernetStatus">getEthernetStatus</a></td>
+<td>Public method to get Ethernet status data of the connected board.</td>
+</tr>
+<tr>
 <td><a href="#RP2040Device.getWifiData">getWifiData</a></td>
 <td>Public method to get data related to the current WiFi status.</td>
 </tr>
 <tr>
+<td><a href="#RP2040Device.hasEthernet">hasEthernet</a></td>
+<td>Public method to check the availability of Ethernet.</td>
+</tr>
+<tr>
 <td><a href="#RP2040Device.hasFlashMenuEntry">hasFlashMenuEntry</a></td>
 <td>Public method to check, if the device has its own flash menu entry.</td>
 </tr>
@@ -176,6 +200,10 @@
 <td>Public method to remove the saved credentials from the connected device.</td>
 </tr>
 <tr>
+<td><a href="#RP2040Device.removeLanAutoConnect">removeLanAutoConnect</a></td>
+<td>Public method to remove the saved IPv4 parameters from the connected device.</td>
+</tr>
+<tr>
 <td><a href="#RP2040Device.runScript">runScript</a></td>
 <td>Public method to run the given Python script.</td>
 </tr>
@@ -203,6 +231,10 @@
 <td><a href="#RP2040Device.writeCredentials">writeCredentials</a></td>
 <td>Public method to write the given credentials to the connected device and modify the start script to connect automatically.</td>
 </tr>
+<tr>
+<td><a href="#RP2040Device.writeLanAutoConnect">writeLanAutoConnect</a></td>
+<td>Public method to generate a script and associated configuration to connect the device to the LAN during boot time.</td>
+</tr>
 </table>
 <h3>Static Methods</h3>
 
@@ -442,6 +474,52 @@
 tuple of (bool, str)
 </dd>
 </dl>
+<a NAME="RP2040Device.checkInternetViaLan" ID="RP2040Device.checkInternetViaLan"></a>
+<h4>RP2040Device.checkInternetViaLan</h4>
+<b>checkInternetViaLan</b>(<i></i>)
+
+<p>
+        Public method to check, if the internet can be reached (LAN variant).
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+tuple containing a flag indicating reachability and an error string
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+tuple of (bool, str)
+</dd>
+</dl>
+<a NAME="RP2040Device.connectToLan" ID="RP2040Device.connectToLan"></a>
+<h4>RP2040Device.connectToLan</h4>
+<b>connectToLan</b>(<i>config</i>)
+
+<p>
+        Public method to connect the connected device to the LAN.
+</p>
+<dl>
+
+<dt><i>config</i> (str or tuple of (str, str, str, str))</dt>
+<dd>
+configuration for the connection (either the string 'dhcp'
+            for a dynamic address or a tuple of four strings with the IPv4 parameters.
+</dd>
+</dl>
+<dl>
+<dt>Return:</dt>
+<dd>
+tuple containing a flag indicating success and an error message
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+tuple of (bool, str)
+</dd>
+</dl>
 <a NAME="RP2040Device.connectWifi" ID="RP2040Device.connectWifi"></a>
 <h4>RP2040Device.connectWifi</h4>
 <b>connectWifi</b>(<i>ssid, password</i>)
@@ -472,6 +550,25 @@
 tuple of (bool, str)
 </dd>
 </dl>
+<a NAME="RP2040Device.deactivateEthernet" ID="RP2040Device.deactivateEthernet"></a>
+<h4>RP2040Device.deactivateEthernet</h4>
+<b>deactivateEthernet</b>(<i></i>)
+
+<p>
+        Public method to deactivate the Ethernet interface of the connected device.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+tuple containg a flag indicating success and an error message
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+tuple of (bool, str)
+</dd>
+</dl>
 <a NAME="RP2040Device.deactivateInterface" ID="RP2040Device.deactivateInterface"></a>
 <h4>RP2040Device.deactivateInterface</h4>
 <b>deactivateInterface</b>(<i>interface</i>)
@@ -525,6 +622,25 @@
 str
 </dd>
 </dl>
+<a NAME="RP2040Device.disconnectFromLan" ID="RP2040Device.disconnectFromLan"></a>
+<h4>RP2040Device.disconnectFromLan</h4>
+<b>disconnectFromLan</b>(<i></i>)
+
+<p>
+        Public method  to disconnect from the LAN.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+tuple containing a flag indicating success and an error message
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+tuple of (bool, str)
+</dd>
+</dl>
 <a NAME="RP2040Device.disconnectWifi" ID="RP2040Device.disconnectWifi"></a>
 <h4>RP2040Device.disconnectWifi</h4>
 <b>disconnectWifi</b>(<i></i>)
@@ -623,6 +739,33 @@
 list of tuple of (str, str)
 </dd>
 </dl>
+<a NAME="RP2040Device.getEthernetStatus" ID="RP2040Device.getEthernetStatus"></a>
+<h4>RP2040Device.getEthernetStatus</h4>
+<b>getEthernetStatus</b>(<i></i>)
+
+<p>
+        Public method to get Ethernet status data of the connected board.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+list of tuples containing the translated status data label and
+            the associated value
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+list of tuples of (str, str)
+</dd>
+</dl>
+<dl>
+
+<dt>Raises <b>OSError</b>:</dt>
+<dd>
+raised to indicate an issue with the device
+</dd>
+</dl>
 <a NAME="RP2040Device.getWifiData" ID="RP2040Device.getWifiData"></a>
 <h4>RP2040Device.getWifiData</h4>
 <b>getWifiData</b>(<i></i>)
@@ -650,6 +793,32 @@
 raised to indicate an issue with the device
 </dd>
 </dl>
+<a NAME="RP2040Device.hasEthernet" ID="RP2040Device.hasEthernet"></a>
+<h4>RP2040Device.hasEthernet</h4>
+<b>hasEthernet</b>(<i></i>)
+
+<p>
+        Public method to check the availability of Ethernet.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+flag indicating the availability of Ethernet
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+bool
+</dd>
+</dl>
+<dl>
+
+<dt>Raises <b>OSError</b>:</dt>
+<dd>
+raised to indicate an issue with the device
+</dd>
+</dl>
 <a NAME="RP2040Device.hasFlashMenuEntry" ID="RP2040Device.hasFlashMenuEntry"></a>
 <h4>RP2040Device.hasFlashMenuEntry</h4>
 <b>hasFlashMenuEntry</b>(<i></i>)
@@ -741,6 +910,28 @@
 tuple of (bool, str)
 </dd>
 </dl>
+<a NAME="RP2040Device.removeLanAutoConnect" ID="RP2040Device.removeLanAutoConnect"></a>
+<h4>RP2040Device.removeLanAutoConnect</h4>
+<b>removeLanAutoConnect</b>(<i></i>)
+
+<p>
+        Public method to remove the saved IPv4 parameters from the connected device.
+</p>
+<p>
+        Note: This disables the LAN auto-connect feature.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+tuple containing a flag indicating success and an error message
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+tuple of (bool, str)
+</dd>
+</dl>
 <a NAME="RP2040Device.runScript" ID="RP2040Device.runScript"></a>
 <h4>RP2040Device.runScript</h4>
 <b>runScript</b>(<i>script</i>)
@@ -908,6 +1099,34 @@
 tuple of (bool, str)
 </dd>
 </dl>
+<a NAME="RP2040Device.writeLanAutoConnect" ID="RP2040Device.writeLanAutoConnect"></a>
+<h4>RP2040Device.writeLanAutoConnect</h4>
+<b>writeLanAutoConnect</b>(<i>config</i>)
+
+<p>
+        Public method to generate a script and associated configuration to connect the
+        device to the LAN during boot time.
+</p>
+<dl>
+
+<dt><i>config</i> (str or tuple of (str, str, str, str))</dt>
+<dd>
+configuration for the connection (either the string 'dhcp'
+            for a dynamic address or a tuple of four strings with the IPv4 parameters.
+</dd>
+</dl>
+<dl>
+<dt>Return:</dt>
+<dd>
+tuple containing a flag indicating success and an error message
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+tuple of (bool, str)
+</dd>
+</dl>
 <div align="right"><a href="#top">Up</a></div>
 <hr />
 <hr />

eric ide

mercurial