src/eric7/Documentation/Source/eric7.MicroPython.BluetoothDialogs.BluetoothAdvertisement.html

branch
mpy_network
changeset 9860
d34667faa686
child 9863
5f2377b32716
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/eric7/Documentation/Source/eric7.MicroPython.BluetoothDialogs.BluetoothAdvertisement.html	Wed Mar 08 19:28:56 2023 +0100
@@ -0,0 +1,349 @@
+<!DOCTYPE html>
+<html><head>
+<title>eric7.MicroPython.BluetoothDialogs.BluetoothAdvertisement</title>
+<meta charset="UTF-8">
+<link rel="stylesheet" href="styles.css">
+</head>
+<body>
+<a NAME="top" ID="top"></a>
+<h1>eric7.MicroPython.BluetoothDialogs.BluetoothAdvertisement</h1>
+
+<p>
+Module implementing a class to parse and store the Bluetooth device advertisement data.
+</p>
+<h3>Global Attributes</h3>
+
+<table>
+<tr><td>ADV_DIRECT_IND</td></tr><tr><td>ADV_IND</td></tr><tr><td>ADV_NONCONN_IND</td></tr><tr><td>ADV_SCAN_IND</td></tr><tr><td>ADV_TYPE_COMPLETE_NAME</td></tr><tr><td>ADV_TYPE_MANUFACTURER</td></tr><tr><td>ADV_TYPE_SHORT_NAME</td></tr><tr><td>ADV_TYPE_SVC_DATA</td></tr><tr><td>ADV_TYPE_TX_POWER_LEVEL</td></tr><tr><td>ADV_TYPE_UUID128_COMPLETE</td></tr><tr><td>ADV_TYPE_UUID128_INCOMPLETE</td></tr><tr><td>ADV_TYPE_UUID16_COMPLETE</td></tr><tr><td>ADV_TYPE_UUID16_INCOMPLETE</td></tr><tr><td>ADV_TYPE_UUID32_COMPLETE</td></tr><tr><td>ADV_TYPE_UUID32_INCOMPLETE</td></tr><tr><td>ManufacturerId</td></tr><tr><td>SCAN_RSP</td></tr>
+</table>
+<h3>Classes</h3>
+
+<table>
+
+<tr>
+<td><a href="#BluetoothAdvertisement">BluetoothAdvertisement</a></td>
+<td>Class to parse and store the Bluetooth device advertisement data.</td>
+</tr>
+</table>
+<h3>Functions</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+<hr />
+<hr />
+<a NAME="BluetoothAdvertisement" ID="BluetoothAdvertisement"></a>
+<h2>BluetoothAdvertisement</h2>
+
+<p>
+    Class to parse and store the Bluetooth device advertisement data.
+</p>
+<h3>Derived from</h3>
+None
+<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="#BluetoothAdvertisement.__init__">BluetoothAdvertisement</a></td>
+<td>Constructor</td>
+</tr>
+<tr>
+<td><a href="#BluetoothAdvertisement.__decodeField">__decodeField</a></td>
+<td>Private method to get all fields of the specified types.</td>
+</tr>
+<tr>
+<td><a href="#BluetoothAdvertisement.__splitBytes">__splitBytes</a></td>
+<td>Private method to split some data into chunks of given size.</td>
+</tr>
+<tr>
+<td><a href="#BluetoothAdvertisement.__str__">__str__</a></td>
+<td>Special method to generate a string representation.</td>
+</tr>
+<tr>
+<td><a href="#BluetoothAdvertisement.address">address</a></td>
+<td>Public method to get the address string.</td>
+</tr>
+<tr>
+<td><a href="#BluetoothAdvertisement.manufacturer">manufacturer</a></td>
+<td>Public method to get the manufacturer data.</td>
+</tr>
+<tr>
+<td><a href="#BluetoothAdvertisement.name">name</a></td>
+<td>Public method to get the complete or shortened advertised name, if available.</td>
+</tr>
+<tr>
+<td><a href="#BluetoothAdvertisement.rssi">rssi</a></td>
+<td>Public method to get the RSSI value.</td>
+</tr>
+<tr>
+<td><a href="#BluetoothAdvertisement.services">services</a></td>
+<td>Public method to get the service IDs.</td>
+</tr>
+<tr>
+<td><a href="#BluetoothAdvertisement.txPower">txPower</a></td>
+<td>Public method to get the advertised power level in dBm.</td>
+</tr>
+<tr>
+<td><a href="#BluetoothAdvertisement.update">update</a></td>
+<td>Public method to update the advertisement data.</td>
+</tr>
+</table>
+<h3>Static Methods</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+
+<a NAME="BluetoothAdvertisement.__init__" ID="BluetoothAdvertisement.__init__"></a>
+<h4>BluetoothAdvertisement (Constructor)</h4>
+<b>BluetoothAdvertisement</b>(<i>address</i>)
+
+<p>
+        Constructor
+</p>
+<dl>
+
+<dt><i>address</i> (str)</dt>
+<dd>
+address of the device advertisement
+</dd>
+</dl>
+<a NAME="BluetoothAdvertisement.__decodeField" ID="BluetoothAdvertisement.__decodeField"></a>
+<h4>BluetoothAdvertisement.__decodeField</h4>
+<b>__decodeField</b>(<i>*advType</i>)
+
+<p>
+        Private method to get all fields of the specified types.
+</p>
+<dl>
+
+<dt><i>*advType</i> (int)</dt>
+<dd>
+type of fields to be extracted
+</dd>
+</dl>
+<dl>
+<dt>Yield:</dt>
+<dd>
+requested fields
+</dd>
+</dl>
+<dl>
+<dt>Yield Type:</dt>
+<dd>
+bytes
+</dd>
+</dl>
+<a NAME="BluetoothAdvertisement.__splitBytes" ID="BluetoothAdvertisement.__splitBytes"></a>
+<h4>BluetoothAdvertisement.__splitBytes</h4>
+<b>__splitBytes</b>(<i>data, chunkSize</i>)
+
+<p>
+        Private method to split some data into chunks of given size.
+</p>
+<dl>
+
+<dt><i>data</i> (bytes, bytearray, str)</dt>
+<dd>
+data to be chunked
+</dd>
+<dt><i>chunkSize</i> (int)</dt>
+<dd>
+size for each chunk
+</dd>
+</dl>
+<dl>
+<dt>Return:</dt>
+<dd>
+list of chunks
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+list of bytes, bytearray, str
+</dd>
+</dl>
+<a NAME="BluetoothAdvertisement.__str__" ID="BluetoothAdvertisement.__str__"></a>
+<h4>BluetoothAdvertisement.__str__</h4>
+<b>__str__</b>(<i></i>)
+
+<p>
+        Special method to generate a string representation.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+string representation
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+str
+</dd>
+</dl>
+<a NAME="BluetoothAdvertisement.address" ID="BluetoothAdvertisement.address"></a>
+<h4>BluetoothAdvertisement.address</h4>
+<b>address</b>(<i></i>)
+
+<p>
+        Public method to get the address string.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+address of the device
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+str
+</dd>
+</dl>
+<a NAME="BluetoothAdvertisement.manufacturer" ID="BluetoothAdvertisement.manufacturer"></a>
+<h4>BluetoothAdvertisement.manufacturer</h4>
+<b>manufacturer</b>(<i>filterId=None, withName=False</i>)
+
+<p>
+        Public method to get the manufacturer data.
+</p>
+<dl>
+
+<dt><i>filterId</i> (int (optional))</dt>
+<dd>
+manufacturer ID to filter on (defaults to None)
+</dd>
+<dt><i>withName</i> (bool)</dt>
+<dd>
+flag indicating to report the manufacturer name as well
+            (if available) (defaults to False)
+</dd>
+</dl>
+<dl>
+<dt>Return:</dt>
+<dd>
+tuple containing the manufacturer ID, associated data and manufacturer
+            name
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+tuple of (int, bytes, str)
+</dd>
+</dl>
+<a NAME="BluetoothAdvertisement.name" ID="BluetoothAdvertisement.name"></a>
+<h4>BluetoothAdvertisement.name</h4>
+<b>name</b>(<i></i>)
+
+<p>
+        Public method to get the complete or shortened advertised name, if available.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+advertised name
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+str
+</dd>
+</dl>
+<a NAME="BluetoothAdvertisement.rssi" ID="BluetoothAdvertisement.rssi"></a>
+<h4>BluetoothAdvertisement.rssi</h4>
+<b>rssi</b>(<i></i>)
+
+<p>
+        Public method to get the RSSI value.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+RSSI value in dBm
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+int
+</dd>
+</dl>
+<a NAME="BluetoothAdvertisement.services" ID="BluetoothAdvertisement.services"></a>
+<h4>BluetoothAdvertisement.services</h4>
+<b>services</b>(<i></i>)
+
+<p>
+        Public method to get the service IDs.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+list of tuples containing the advertised service ID and a
+            flag indicating a complete ID
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+list of tuple of (str, bool)
+</dd>
+</dl>
+<a NAME="BluetoothAdvertisement.txPower" ID="BluetoothAdvertisement.txPower"></a>
+<h4>BluetoothAdvertisement.txPower</h4>
+<b>txPower</b>(<i></i>)
+
+<p>
+        Public method to get the advertised power level in dBm.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+transmit power of the device (in dBm)
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+int
+</dd>
+</dl>
+<a NAME="BluetoothAdvertisement.update" ID="BluetoothAdvertisement.update"></a>
+<h4>BluetoothAdvertisement.update</h4>
+<b>update</b>(<i>advType, rssi, advData</i>)
+
+<p>
+        Public method to update the advertisement data.
+</p>
+<dl>
+
+<dt><i>advType</i> (int)</dt>
+<dd>
+type of advertisement data
+</dd>
+<dt><i>rssi</i> (int)</dt>
+<dd>
+RSSI value in dBm
+</dd>
+<dt><i>advData</i> (bytes)</dt>
+<dd>
+advertisement data
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr />
+</body></html>
\ No newline at end of file

eric ide

mercurial