本文在蓝牙技术联盟发布的Mesh Model Specification的基础上,介绍生活物联网平台蓝牙Mesh灯应用的Mesh Model配置。
背景信息
物模型是对设备是什么,能做什么的描述,包括设备的属性(properties)、服务(services)、事件(events)等。生活物联网平台通过物模型定义产品功能。蓝牙Mesh设备通过Mesh Model来实现物模型。
Mesh Model配置
生活物联网平台蓝牙Mesh灯产品的Mesh Model配置如下图所示。当蓝牙mesh智能灯作为一个独立的产品时,一般是一个元素(Element)。配置服务模型(Configuration
Server)与健康服务模型(Health Server)是所有设备的主元素(Primary Element)都要求支持的,非主元素(Secondary Elements)无需支持。灯的开关、亮度、色温、场景模式这几个主要属性,通过SIG
Model来实现,请参见Mesh Model Specification。除了上述几个主要属性之外的其他属性(如颜色等)、服务和事件等都通过Vendor Model即阿里巴巴厂商自定义模型实现,请参见蓝牙Mesh设备扩展协议。
Element | 属性 | 模型与SIG Model ID |
灯 (Primary Element) | 开关 | Generic OnOff Server(0x0100) |
亮度 | Light Lightness Server(0x1300) | |
色温 | Light CTL Server(0x1303) | |
场景模式 | Scene Server(0x1203) | |
其他属性(如颜色等)、服务和事件 | Alibaba Vendor Model Server(0x01A80000) |
Mesh Model与Opcode
Model | Message | Opcode | 说明 |
Generic OnOff Server | Generic OnOff Get | 0x8201 | 获取开关状态 |
Generic OnOff Set | 0x8202 | 设置开关 | |
Generic OnOff Set Unacknowledged | 0x8203 | 设置开关(无确认) | |
Generic OnOff Status | 0x8204 | 开关状态(设备上报) | |
Lightness Server | Light Lightness Get | 0x824B | 获取亮度状态 |
Light Lightness Set | 0x824C | 设置亮度 | |
Light Lightness Set Unacknowledged | 0x824D | 设置亮度(无确认) | |
Light Lightness Status | 0x824E | 亮度状态(设备上报) | |
Light CTL Server | Light CTL Get | 0x825D | 获取色温状态 |
Light CTL Set | 0x825E | 设置色温 | |
Light CTL Set Unacknowledged | 0x825F | 设置色温(无确认) | |
Light CTL Status | 0x8260 | 色温状态(设备上报) | |
Scene Server | Scene Get | 0x8241 | 获取场景模式状态 |
Scene Set | 0x8242 | 设置场景模式 | |
Scene Set Unacknowledged | 0x8243 | 设置模式(无确认) | |
Scene Status | 0x5E | 模式状态(设备上报) | |
Vendor Model | Vendor Message Attribute Get | 0xD001A8 | 获取一个或多个属性值 |
Vendor Message Attribute Set | 0xD101A8 | 设置一个或多个属性值 | |
Vendor Message Attribute Set Unacknowledged | 0xD201A8 | 设置一个或多个属性值(无确认) | |
Vendor Message Attribute Status | 0xD301A8 | 响应获取与设置指令回复的属性状态 | |
Vendor Message Attribute Indication | 0xD401A8 | 主动属性上报 | |
Vendor Message Attribute Confirmation | 0xD501A8 | 主动属性上报的确认 | |
Vendor Message Attribute Indication To GW | 0xDE01A8 | 设备给网关的上报 | |
Vendor Message Attribute Confirmation From GW | 0xDF01A8 | 网关给设备回复的确认 | |
Vendor Message Transparent msg | 0xCF01A8 | 厂商自定义透传数据 | |
Vendor Message Transparent Indication | 0xCE01A8 | 自定义主动上报 | |
Vendor Message Transparent ACK | 0xCD01A8 | 自定义上报回复 |
Mesh Model与物模型
Element | 名称 | Model | Attribute Type | Attribute Parameter | 备注 |
灯(Primary element) | 开关 | Generic OnOff Server 0x1000 | 不适用 | 不适用 | 必选 |
亮度 | Lightness Server 0x1300 | 可选 | |||
色温 | Light CTL Server 0x1303 | 可选 | |||
模式 | Scene Server 0x1203 | 可选 | |||
错误码 | Vendor Model Server 0x01A80000 | 0x0000 | 1字节 | 可选 | |
开关 | 0x0100 | 1字节:0 - 关闭;1 - 打开 | 必选,状态与Generic OnOff Server Model的开关状态一致,用于设备主动上报开关状态 | ||
电量 | 0x0104 | 1字节:0~100 百分比 | 可选 | ||
亮度 | 0x0121 | 2字节:0~65535 | 可选,状态与Lightness Server Model的亮度状态一致,用于设备主动上报亮度属性 | ||
色温 | 0x0122 | 2字节:800~20000 | 可选,状态与Light CTL Server的色温状态一致,用于设备主动上报色温属性 | ||
颜色 | 0x0123 | 6字节 | 可选 | ||
延时关闭时长 | 0x0133 | 2字节:0~65535 秒 | 可选 | ||
待机亮度 | 0x01F2 | 2字节:0~65535 | 可选 | ||
背光灯 | 0x0533 | 1字节:0 - 关闭;1 - 打开 | 可选 | ||
主灯 | 0x0534 | 1字节:0 - 关闭;1 - 打开 | 可选 | ||
夜灯 | 0x0572 | 1字节:0 - 关闭;1 - 打开 | 可选 | ||
模式 | 0xF004 | 2字节枚举 | 可选,状态与Scene Server一致,用于设备主动上报模式属性 | ||
事件 | 0xF009 | 1字节 |
|
||
定时开关 | 0xF010 | 可变 | 可选 | ||
时区 | 0xF01E | 1字节:-12~12 | 可选 | ||
时间 | 0xF01F | 4字节:标准UNIX时间 | 可选 | ||
在创建产品并定义产品功能阶段,添加的属性、服务和事件都会显示对应的Attr Type和数据定义与取值范围。如果添加的属性、服务和事件没有合法的Attr Type值,说明该项不适用于蓝牙Mesh设备,请更换或者联系aligenie.iot@list.alibaba-inc.com添加。