Skip to main content

Bluetooth Mesh

Connect to a Bluetooth Mesh network via a Bluetooth Mesh proxy. Note that only Linux Docker host systems with a bluez protocol stack is supported.

Make sure that the file docker-compose.yml contains the following configuration settings:

...
...
volumes:
...
btmesh-data:
...
...
...
manager:
...
privileged: true
...
...
volumes:
- ...
- /var/run/dbus:/var/run/dbus
- btmesh-data:/btmesh
- ...
...
...

Agent configuration

The following describes the supported agent configuration attributes:

AttributeDescriptionValue typeRequired
networkKeyBluetooth Mesh network keyText, format: <key index>:<key> (e.g. 0:5EBBC0FE3CCEF029C049B00F27DC8A5C)Y
applicationKeyBluetooth Mesh application keyText, format: <key index>:<key> (e.g. 0:2AD08F7660AA535FA7DE4C918241F04F)Y
proxyAddressBluetooth Mesh proxy address - if omitted proxy with best RSSI is selectedText (e.g. B0:CE:18:A3:0B:09)N
sourceAddressBluetooth Mesh source unicast addressText, format: 4 hexadecimal digits (e.g. 199A), range: 0001-7FFFY
mtuMaximum transmission unit size for Bluetooth Mesh proxy communication - if omitted default value is 20Positive IntegerN
sequenceNumberBluetooth Mesh sequence number - if omitted default value is 1Positive IntegerN

For attributes linked to this agent, the following describes the supported agent link fields which are in addition to the standard Agent Link fields:

FieldDescriptionValue typeRequired
addressBluetooth Mesh destination unicast addressText, format: 4 hexadecimal digits (e.g. 0002), range: 0001-7FFFY
appKeyIndexBluetooth Mesh application key indexPositive IntegerY
modelNameBluetooth Mesh model nameText (e.g. GenericOnOffClient)Y

Note that currently only the GenericOnOffClient Bluetooth Mesh model is supported.