Added missing BLE frame format

grodansparadis · Nov 21, 2024 · 65804c9 · 65804c9
1 parent a0b232f
commit 65804c9
Show file tree

Hide file tree

Showing 6 changed files with 35 additions and 3 deletions.
diff --git a/_sidebar.md b/_sidebar.md
@@ -27,6 +27,7 @@
    * [VSCP over CAN (CAN4VSCP)](./vscp_over_can_can4vscp.md)
    * [VSCP over a serial channel (RS-232)](./vscp_over_a_serial_channel_rs-232.md)
    * [VSCP Level I over RS-485/RS-422](./vscp_level_i_over_rs-485_rs-422.md)
+   * [VSCP over Bluetooth BLE](./vscp_over_bt_ble.md)
    * [VSCP over Bluetooth mesh](./vscp_over_bt_mesh.md)
    * [VSCP over IEEE 802.15.4](./vscp_over_ieee_802.15.4.md)
    * [VSCP Droplet model](./vscp_droplet_model.md)

diff --git a/images/adv-channel-pdu.png b/images/adv-channel-pdu.png
diff --git a/images/packet-format-top-level.png b/images/packet-format-top-level.png
diff --git a/variables.xml b/variables.xml
@@ -1,4 +1,4 @@
 <var>
-    <creation-time>2024-11-05 22:00:01</creation-time>
-    <document-version>1.14.17</document-version>
+    <creation-time>2024-11-21 17:37:21</creation-time>
+    <document-version>1.14.18</document-version>
 </var>
diff --git a/vscp_over_bt_ble.md b/vscp_over_bt_ble.md
@@ -0,0 +1,30 @@
+# VSCP over BLE
+
+The general BLE frame format is as follows
+
+![VSCP Bluetooth](https://developerhelp.microchip.com/xwiki/bin/download/applications/ble/introduction/bluetooth-architecture/bluetooth-controller-layer/bluetooth-link-layer/Packet-Types/WebHome/packet-format-top-level.png?width=600&height=210&rev=1.1)
+
+## Advertising format
+
+The general BLE advertising format is as follows
+
+![BLE Advertising](https://developerhelp.microchip.com/xwiki/bin/download/applications/ble/introduction/bluetooth-architecture/bluetooth-controller-layer/bluetooth-link-layer/Packet-Types/WebHome/adv-channel-pdu.png?width=450&height=183&rev=1.1)
+
+
+The VSCP advertising payload format is as follows
+
+
+| Description | Size | Note |    
+| --- | --- | --- |
+| head | 8-bit | |
+| timestamp | 32 bit | Microsecond timestamp
+| vscp-class | 32-bits | VSCP class |
+| vscp-type | 32 bits | VSCP type |
+| data | max =  37 - 13 = 24 | VSCP data |
+
+  * GUID is constructed from BLE MAC, prefix _FF:FF:FF:FF:FF:FF:FF:F8:YY:YY:YY:YY:YY:YY:XX:XX_ where _YY:YY:YY:YY:YY:YY_ is the BLE MAC and _XX:XX_ is the nodeid. 
+  * obid is set by receiver, zero if not used.
+  * time is set by receiver
+
+
+[filename](./bottom_copyright.md ':include')
diff --git a/vscp_specification_history.md b/vscp_specification_history.md
@@ -2,7 +2,8 @@
 
  | Date       | By   | Description |
  | ---------- | ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
- |2024-11-05| AKHE | Fixed VSCP2_TYPE_PROTOCOL_WRITE_REGISTER_DIRECT |
+|2024-11-21| AKHE | Added missing BLE transport frame format |
+|2024-11-05| AKHE | Fixed VSCP2_TYPE_PROTOCOL_WRITE_REGISTER_DIRECT |
 |2024-10-30| AKHE | Added "uf2" (RP2040 etc) as a valid firmware format. |
 |2024-10-23| AKHE | Added GigaDevice Semiconductor, Raspbery Pi, EspressIf manufacturer codes. |
 |2024-10-09| AKHE | Added info about possibility to skip JSON/XML fields in MQTT events. |