Bluetooth Low Energy Mesh Multi-Gang Switch Protocol

Last Updated on : 2024-11-20 08:51:41download

This topic describes how to configure standard fields and control methods for Bluetooth Low Energy (LE) mesh multi-gang switches. After you complete the configuration, a provisioner, typically the app or gateway, can then provision a Bluetooth LE mesh multi-gang switch.

Configure provisioning

For more information, see Bluetooth LE Mesh Protocol Specification.

Mesh category

The electrical product is a standard device type and its product category value is 0x02. The specific product types are as follows:

Product	Mesh category
One-gang switch/socket	0x1021
Two-gang switch/socket	0x1022
Three-gang switch/socket	0x1023
Four-gang switch/socket	0x1024
Five-gang switch/socket	0x1025

Element and model description

An element is an addressable entity within a device. This means that it is some part of a device that has at least one, independent state value that represents some condition of the element. All nodes must have at least one element. Some nodes will have multiple elements. A model defines a set of states, state transitions, state bindings, messages, and other associated behaviors. An element within a node must support one or more models and it is the model or models that define the functionality that an element has.

Element cnt: n (n-gang)

element_idx	model id	Model	Description
0	0x0000	Configuration Server model	Configure a device. For example, add or delete a group.
1	0x1000	Generic OnOff Server	Switch the device on/off and detect heartbeats.
2	0x1000	Generic OnOff Server	Switch the device on/off and detect heartbeats.
3	0x1000	Generic OnOff Server	Switch the device on/off and detect heartbeats.
4	0x1000	Generic OnOff Server	Switch the device on/off and detect heartbeats.
n…	0x1000	Generic OnOff Server	Switch the device on/off and detect heartbeats.
0	0x000407d0	Tuya vendor model	Custom functions such as countdown and power detection.

Common model opcode

Model	Opcode	Description
Generic OnOff Server	Generic OnOff Get	Query device on/off status.
Generic OnOff Server	Generic OnOff Set/Generic OnOff Set Unacknowledged	Switch the device on/off with or without acknowledgment.
Generic OnOff Server	Generic OnOff Status	Respond to device on/off status.

Electrical device data point (DP)

DP ID	DP function	Model
1	Switch 1	element_idx0 OnOff Model
2	Switch 2	element_idx1 OnOff Model
3	Switch 3	element_idx2 OnOff Model
4	Switch 4	element_idx3 OnOff Model
5	Switch 5	element_idx4 OnOff Model
6	Switch 6	element_idx5 OnOff Model
9	Countdown of switch 1	Vendor model
10	Countdown of switch 2	Vendor model
11	Countdown of switch 3	Vendor model
12	Countdown of switch 4	Vendor model
13	Countdown of switch 5	Vendor model
14	Countdown of switch 6	Vendor model

Note: For electrical devices, the DPs using the vendor model and other custom DPs all conform to Bluetooth LE Mesh Vendor Model Pass-Through Specifications.