本文在蓝牙技术联盟发布的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设备扩展协议灯应用Model定义
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字节
  • 0x0003 上电事件
  • 0x0023 硬件复位事件
定时开关 0xF010 可变 可选
时区 0xF01E 1字节:-12~12 可选
时间 0xF01F 4字节:标准UNIX时间 可选
创建产品并定义产品功能阶段,添加的属性、服务和事件都会显示对应的Attr Type和数据定义与取值范围。如果添加的属性、服务和事件没有合法的Attr Type值,说明该项不适用于蓝牙Mesh设备,请更换或者联系aligenie.iot@list.alibaba-inc.com添加。物模型与Mesh Model