diff --git a/_sidebar.md b/_sidebar.md index f5a30e7..d901d13 100644 --- 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 new file mode 100644 index 0000000..3df7557 Binary files /dev/null and b/images/adv-channel-pdu.png differ diff --git a/images/packet-format-top-level.png b/images/packet-format-top-level.png new file mode 100644 index 0000000..7f59619 Binary files /dev/null and b/images/packet-format-top-level.png differ diff --git a/variables.xml b/variables.xml index 2c82f11..d4c53f3 100644 --- a/variables.xml +++ b/variables.xml @@ -1,4 +1,4 @@ - 2024-11-05 22:00:01 - 1.14.17 + 2024-11-21 17:37:21 + 1.14.18 diff --git a/vscp_over_bt_ble.md b/vscp_over_bt_ble.md new file mode 100644 index 0000000..4d1679b --- /dev/null +++ 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') \ No newline at end of file diff --git a/vscp_specification_history.md b/vscp_specification_history.md index 7f7529d..b3a1b1e 100644 --- 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. |