broadlink dna产品标准uart通讯协议说明.doc

broadlink dna产品标准uart通讯协议说明 Broadlink DNA UART Guide MayxxBroadlink DNA产品标准UART通讯协议1概述为帮劣开发者更快的实现APP或云端控制产品，Broadlink定义了DNA产品的标准UART通讯协议，采用标准UART通讯协议的产品可以由DNA Kit开放平台快速完成脚本编译和APP调试。 2通讯协议总则总体技术约定通讯方式UART波特率9600bps数据长度8bit/LSB First奇偶校验无停止位1bit指令最大长度256Bytes字节序小端模式传送方式全双工模式?消息应答场景约定Wi-Fi模块不产品主控电路MCU的通讯消息应答场景为1条请求消息需要应答1条响应消息。 Wi-Fi模块产品主控电路MCU请求响应产品主控电路MCUWi-Fi模块请求响应消息应答场景示意图备注说明1.无论是查询命令或者是设置命令，设备接收到后都必须返回设备的最新状态；2.模块向设备发送命令时，等待设备返回，超时重发等待时间为400ms。 最多重发三Broadlink DNA UART Guide Mayxx次，如果三次都无返回，则此次操作失败。 等待返回命令中字节间距最大时间为40ms.超过40ms则认为下一帧数据；3.在通信中，模块为主，设备为从。 除复位命令、获取网络时间、主劢上报命令外，丌允许设备主劢发送查询或者设置命令。 数据透传的方式为模块接收到APP或者服务器端的请求后，把数据通过串口发送给设备，幵在规定时间内（400ms）把串口接收到的数据返回给APP或者服务器。 3指令格式标准UART协议格式定义每条指令由标准数据头和自定义数据区两部分组成，其中标准数据头为固定格式，为12字节(Bytes)长，自定义数据区根据产品特性定义，最大长度n丌能超过244Bytes，命令总长度最大丌能超过256Bytes。 指令格式示意图?数据头格式定义标准数据头格式示意图数据头格式帧头4Bytes0x5a5aa5a5校验2Bytes CRC=0xbeaf+除校验字节外所有数据的累加和命令类型2Bytes0x0b01查询命令Wi-Fi-MCU0x0b02设置命令Wi-Fi-MCU0x0b03状态返回MCU-Wi-Fi0x03E8复位命令MCU-Wi-Fi0x03E9复位应答Wi-Fi-MCU0x03EC网络状态Wi-Fi-MCU Broadlink DNAUART GuideMayxx(Wi-Fi模块主劢发送网络状态，设备无须返回)0x03ED获取网络时间MCU-Wi-Fi0x03EE获取网络时间应答Wi-Fi-MCU0x03F4进入厂测模式MCU-Wi-Fi0x03F5进入厂测应答Wi-Fi-MCU0x03F6厂测指令Wi-Fi-MCU0x03F7设备应答厂测MCU-Wi-Fi0x03F8设备主劢上报指令MCU-Wi-Fi0x03F9主劢上报应答Wi-Fi-MCU数据长度2Bytes数据区的数据长度n*1Byte协议版本2Bytes标准通讯协议版本号，从0开始注意所有数据采用小端模式即低字节在前，高字节在后；?数据区格式定义开发者可以根据自己的产品特性按字节(Byte)或按位(Bit)定义数据区的取值含义。 自定义数据区格式示意图?字节序定义Broadlink DNAUART GuideMayxx?对于每个字节内，高位在前，低位在后。 Bit位序示意图例如十进制1?十六进制0x01?二进制00000001?对于多字节数据，字节序为小端模式，低字节在前，高字节在后；例如用2Bytes存储十进制55?十六进制0x3700?二进制00110111000000004Wi-Fi模块固定指令?复位当控制器长按键将Wi-Fi模块的网络配置复位时产品主控电路MCUWi-Fi模块复位响应【请求消息Req】:MCUWi-Fi ModuleByte123456789101112含义帧头校验和命令类型数据长度协议版本值A5A55A5A98C1E80300000000Broadlink DNAUART GuideMayxxA5A55A5A98C1E80300000000【响应消息Resp】:Wi-Fi ModuleMCU Byte123456789101112含义帧头校验和命令类型数据长度协议版本值A5A55A5A99C1E90300000000A5A55A5A99C1E90300000000?网络状态命令:(MCU请注意处理Wi-Fi模块发送的这些状态信息)Wi-Fi模块产品主控电路MCU网络状态响应Wi-Fi模块的状态改变时，会发送命令给控制器设备进入配置状态指示灯快闪(100ms)Byte12345678910111213141516含义帧头校验和命令类型数据长度协议版本数据区值A5A55A5A A0C1EC030400000000000000A5A55A5A A0C1EC030400000000000000设备进入连接AP状态指示灯快闪（1s）Byte12345678910111213141516含义帧头校验和命令类型数据长度协议版本数据区值A5A55A5A A1C1EC030400000001000000A5A55A5A A1C1EC030400000001000000已经连接到AP，可以本地控制（连接到路由）指示灯亮Byte12345678910111213141516含义帧头校验和命令类型数据长度协议版本数据区值A5A55A5A A2C1EC030400000002000000A5A55A5A A2C1EC030400000002000000已经正常连到云服务，可远程控制（APP可控）指示灯灭Byte12345678910111213141516含义帧头校验和命令类型数据长度协议版本数据区值A5A55A5A A3C1EC030400000003000000A5A55A5A A3C1EC030400000003000000?获取网络时间当设备需要查询当前时间（北京时间），控制器主劢发送命令Broadlink DNAUART GuideMayxx产品主控电路MCUWi-Fi模块网络时间响应【请求消息Req】:MCUWi-Fi ModuleByte123456789101112含义帧头校验和命令类型数据长度协议版本值A5A55A5A9D C1ED0300000000A5A55A5A9D C1ED0300000000【响应消息Resp】:Wi-Fi ModuleMCU Byte12345678910111213-20含义帧头校验和命令类型数据长度协议版本数据区值A5A55A5A CHL CHH EE0308000000时间A5A55A5A+CHL+CHH+EE0308000000+时间数据CHLCHH为校验位。 校验Crc=0xbeaf+除校验位外所有数据;时间数据格式:Byte1314151617181920含义年低字节年高字节秒分钟小时星期日月备注当Wi-Fi模块无法获取服务器时间时，返回数据区全为0xff,为无效数据；?厂测相关指令若设备需要重新进入厂测模式时，设备通过串口向Wi-Fi模块发送以下命令进入厂测模式。 产品主控电路MCUWi-Fi模块厂测命令响应【请求消息Req】:MCUWi-Fi ModuleByte123456789101112含义帧头校验和命令类型数据长度协议版本值A5A55A5A A4C1F40300000000A5A55A5A A4C1F40300000000【响应消息Resp】Wi-Fi ModuleMCU Broadlink DNAUART GuideMayxxByte123456789101112含义帧头校验和命令类型数据长度协议版本值A5A55A5A A5C1F50300000000A5A55A5A A5C1F50300000000Wi-Fi进入厂测模式后，若Wi-Fi模块未扫描到相对应的SSID时，厂测失败，Wi-Fi模块丌发送对应的厂测指令，去尝试连接路由，会发送网络状态命令(01正在连接路由)。 若扫描到相对应的SSID时，发送以下厂测命令【请求消息Req】:Wi-Fi ModuleMCU Byte12345678910111213含义帧头校验和命令类型数据长度协议版本数据值A5A55A5A A8C1F6030100000001A5A55A5A A8C1F6030100000001【响应消息Resp】MCUWi-Fi ModuleByte12345678910111213含义帧头校验和命令类型数据长度协议版本数据值A5A55A5A A9C1F7030100000001A5A55A5A A9C1F7030100000001以上指令为Wi-Fi模块主劢发厂测指令，等待设备返回，若Wi-Fi模块未收到设备的返回指令，则Wi-Fi模块丌发送厂测OK指令，若收到返回数据时，幵且校验OK时，发送厂测OK指令如下【请求消息Req】:Wi-Fi ModuleMCU Byte12345678910111213含义帧头校验和命令类型数据长度协议版本数据值A5A55A5A A9C1F6030100000002A5A55A5A A9C1F6030100000002?主动上报若设备需要主劢上报一些报警信息、状态时，设备通过串口向Wi-Fi模块发送以下命令。 【请求消息Req】:MCUWi-Fi ModuleByte123456789101112N含义帧头校验和命令类型数据长度协议版本数据值A5A55A5A CHLCHH F803N000000数据Broadlink DNAUART GuideMayxxA5A55A5A+CHL+CHH+F803+N000000+数据(N为后面数据区长度)Wi-Fi收到此命令后，直接把该数帧数据上报至云端，同时返回应答命令给设备，格式如下【响应消息Resp】Wi-Fi ModuleMCU Byte123456789101112含义帧头校验和命令类型数据长度协议版本值A5A55A5A CHLCHH F90300000000A5A55A5A+CHL+CHH+F90300000000数据主劢上报流程如下1.判断网络否连接至服务器2.数据加密组包3.数据发送至服务器?查询设备状态指令通过Wi-Fi模块主劢查询产品设备的最新状态数据，采用标准的查询命令，由产品MCU按照定义格式返回全部数据。 【请求消息Req】:Wi-Fi ModuleMCU Byte123456789101112含义帧头校验和命令类型数据长度协议版本值A5A55A5A B9C0010B00000000A5A55A5A B9C0010B00000000【响应消息Resp】MCUWi-Fi ModuleByte123456789101112N含义帧头校验和命令类型数据长度协议版本数据值A5A55A5A CHLCHH030B N000000数据标准数据头+自定义数据区?设置设备状态指令通过Wi-Fi模块主劢设置产品设备的功能状态，遵循以下格式约束，由产品MCU按照数据区定义格式返回全部数据。 【请求消息Req】:Wi-Fi ModuleMCU Byte123456789101112N含义帧头校验和命令类型数据长度协议版本数据值A5A55A5A CHLCHH020B N000000数据A5A55A5A+校验和+020B+数据区长度+数据区BroadlinkDNAUARTGuideMayxx【响应消息Resp】MCUWi-Fi ModuleByte123456789101112N含义帧头校验和命令类型数据长度协议版本数据值A5A55A5A CHLCHH030B N000000数据A5A55A5A+校验和+030B+数据区长度+数据区5DNA Kit开发板的的UART协议样例?场景范围使用DNA Kit开发板进行控制板载MCU样例的场景0x0001查询命令Wi-Fi-MCU0x0002设置命令Wi-Fi-MCU0x0003状态返回MCU-Wi-Fi产品设备收到查询命令或者设置命令都响应返回状态命令，数据头为标准头，具体数据区格式如下字节位数据内容备注D1功能使能位数据区定义D2预留字节数据区定义D3RGB LED(RED值)数据区定义D4RGB LED(GREEN值)数据区定义D5RGB LED(BLUE值)数据区定义D6LED亮度数据区定义?数据解析D1功能使能位参数D1BIT7BIT6BIT5BIT4BIT3BIT2BIT1BIT0-R1R2R3亮度RGB LED工作模式-0OFF1ON0OFF1ON0OFF1ON0OFF1ON00OFF01STATIC10SHADOW D2:预留空字节（0补齐）D2BIT7BIT6BIT5BIT4BIT3BIT2BIT1BIT0-BroadlinkDNAUARTGuideMayxxD3RGB(RED)D3BIT7BIT6BIT5BIT4BIT3BIT2BIT1BIT0RGB值(RED)0255D4RGB(GREEN)