保密资料,请勿外传 杭州涂鸦信息技术有限公司
433 通用网关接入流程与协议
文件状态:
文件标识:
[√] 草稿
当前版本:
1.0.0
[ ] 正式发布
作 者: 刘星辰
[ ]正在修改
完成日期:
2019.05.23
保密资料,请勿外传 杭州涂鸦信息技术有限公司
版 本 历 史
版本/状态
作者
参与者
审核
日期
备注
1.0.0
刘星辰
2019.05.23
版权声明
本文档及其所包含内容均为涂鸦智能(杭州涂鸦信息技术有
限公司)所有。除非经本公司书面授权,任何单位及个人不
得擅自摘抄、编撰及复制本文档内容的部分或者全部,不得
以任何形式(包括并不限于图片、链接、镜像等)进行传播,
违者将被依法追究责任。
保密资料,请勿外传 杭州涂鸦信息技术有限公司
一、产品简介
此 433 网关通用固件基于 WRG1 模块开发,芯片平台 8711AM。涂鸦可提
供 SDK 和对接协议给到客户做开发,客户需采购涂鸦的模块,对接自己设备的
MCU,使其设备具有网关的功能,能够连接涂鸦云,使用涂鸦 App,并可通过
私有协议连接自己的子设备。
二、固件信息
固件 key:keyth3n5me5jqu95
三、合作方式
保密资料,请勿外传 杭州涂鸦信息技术有限公司
1、涂鸦提供:WRG1 模块、SDK 工具包、对接协议;
2、客户需一次性付出:云服务费+模块费用(默认连接 3 个子设备);
四、项目对接流程
1、客户经理向客户介绍对接流与方式;
2、给客户寄送烧写好固件的 WRG1 模块,释放 SDK、对接协议文档;
3、客户根据自己需求开发,完成后与我方联调;
4、客户试产时提供产测工具和产测指导文档。
五、对接协议
1 串口通信约定
波特率:115200
保密资料,请勿外传 杭州涂鸦信息技术有限公司
数据位:8
奇偶校验:无
停止位:1
数据流控:无
MCU:用户控制板控制芯片,与涂鸦模块通过串口对接
长度(byte)
说明
2
1
1
2
N
1
固定为 0x55aa
升级扩展用
具体帧类型
大端
从帧头开始按字节求和得出的
结果对 256 求余
2 帧格式说明
字段
帧头
版本
命令字
数据长度
数据
校验和
说明:
3 基础协议详述
3.1 查询产品信息
说明:
保密资料,请勿外传 杭州涂鸦信息技术有限公司
1) product ID:对应涂鸦开发者平台 PID(产品标识),由涂鸦云开发者平台生
成,用于云端记录产品相关信息
2) 产品信息由 product ID、MCU 软件版本构成
3) MCU 软件版本号格式定义:采用点分十进制形式,”x.x.x”(0<=x<=99),
x 为十进制数
模块发送:
字段
帧头
版本
命令字
数据长度
数据
校验和
长度(byte)
2
1
1
2
0
1
说明
0x55aa
0x00
0x01
0x0000
无
从帧头开始按字节求和得出的
结果对 256 求余
例:0x55aa 00 01 0000 00
MCU 返回:
字段
帧头
版本
命令字
长度(byte)
2
1
1
说明
0x55aa
0x00
0x01
保密资料,请勿外传 杭州涂鸦信息技术有限公司
数据长度
数据
校验和
2
N
1
N
{“v”:”1.0.0”,”m”:
1,”cap”:0}
从帧头开始按字节求和得出的
结果对 256 求余
例:{“v”:”1.0.0”,”m”:1,”cap”:0}
v 表示 MCU 版本为 1.0.0
m 表示配网方式: 0 默认配网、1 低功耗、2 特殊配网
cap 表示设备能力: bit0(本地群组),bit1(本地场景) ,bit2(网关有功能 dp),
bit3(是 sigmesh)
例 1:设备支持本地群组, cap 为 0x01:
例 2:设备既支持本地群组又支持本地场景,cap 为 0x03;
例 3:设备不支持本地群组,本地场景,但是网关上有功能 dp.,cap 为 0x04
3.2 查询 MCU,设定模块的工作模式
说明:
1) 模块工作模式主要针对如何指示 WIFI 的工作状态以及如何重置 WIFI 而言,
主要分两种情况:
a. MCU 与模块配合处理,即模块通过串口通知 MCU WIFI 当前的工作状
态,由 MCU 提供显示支持;MCU 检测出 WIFI 的重置需求,通过串口
通知模块重置 WIFI。
保密资料,请勿外传 杭州涂鸦信息技术有限公司
b. 模块自处理:WIFI 模块的工作状态通过 WIFI 的 GPIO 引脚驱动 LED 状
态显示;WIFI 重置通过检测 GPIO 输入需求处理。
模块自处理 WIFI 重置方法为:WIFI 检测 GPIO 入口低电平持续 5s 以上
触发 WIFI 重置。指示灯与按钮所使用的 GPIO 管脚由以下命令配置。
模块发送:
字段
帧头
版本
命令字
数据长度
数据
校验和
长度(byte)
2
1
1
2
0
1
说明
0x55aa
0x00
0x02
0x0000
无
从帧头开始按字节求和得出的
结果对 256 求余
例:0x55aa 00 02 0000 01
MCU 返回:
字段
帧头
版本
命令字
长度(byte)
2
1
1
说明
0x55aa
0x00
0x02