更新时间:2019-02-27 11:16
阿里云IoT鼓励网关厂商提供解决方案来让设备厂商可以在不对网关进行固件升级的情况下接入新开发的子设备,瑞瀛物联的RG4100+就是满足该需求的一款网关。
本文从设备厂商的视角描述如何通过瑞瀛物联的模组来开发接入阿里云IoT智能生活开放平台的一键开关产品,设备厂商可以通过该过程体验通过该方案接入一款产品需要开发的时间。在硬件就位的情况下,用户如果按照下面的流程通常可以在3小时以内完成该体验。
使用瑞瀛的模组开发板连接一键开关模组,并使用串口连接开发板和电脑,连接示意图如下:
注:开发板上电之后将会为模组供电
引脚含义:
引脚1 | 引脚4 | 引脚7 | 引脚8 | 引脚16 | 引脚17 | 引脚21 | 引脚22 | 引脚30 |
---|---|---|---|---|---|---|---|---|
GND | 继电器 | 按键灯 | 按键 | TXD | RXD | 过零检测口 | 网络指示灯 | VCC |
上图中中间的“模组串口收发针脚”需要连接模组的TX、RX针脚,“3.3V供电针脚”需要连接模组的VCC针脚,“接地针脚”需要连接模组的Gnd针脚;“DB9串口插头”用于连接电脑的串口。
上图连接了模组的VCC、Gnd到开发板的3.3V+和3.3V-,连接了串口的Tx、Rx到开发板的TXD和RXD,模组的针脚8(按键)连接到了VCC-。
注:当需要发起“配对”的时候,需要将模组的针脚8连接到开发板的3.3V+上10秒,然后再将针脚接到3.3V-上。
注:目前大多数电脑不提供DB9的串口接头,往往使用USB接口,所以需要确保使用的USB串口驱动在电脑上可以正常工作。
将电脑的串口与开发调试板的串口连接之后,参照下图左上的串口配置让电脑可以与模组通信:
向模组发送 AT+GETINFO 指令,模组将会返回模组的信息,其中包括模组的MAC地址。将其中的MAC地址复制,去掉空格作为设备的DeviceName待用。上图是模组已经连接到了一个Zigbee网关后的输出,其中有模组的NodeID、Zigbee网络的PANID等信息;
如果模组尚未连接Zigbee网关,那么显示将没有Zigbee网络的信息,显示效果如下图所示:
注:调试时可以从模组读取MAC地址并上传到阿里云IoT智能生活开放平台,开发完毕之后设备商从瑞瀛物联批量购买模组时需要瑞瀛物联提供这些模组的MAC地址列表,然后由设备商批量上传到阿里云IoT智能生活开放平台。
注:下面的描述中截取了飞燕控制台的页面图片,如果飞燕控制台页面发生改变将会导致与本文档中的显示不一致,因此本文档中的页面仅供参考,请以飞燕控制台的页面为准
创建产品时确保下图中框选的配置与图中保持一致:
并在该页面复制产品的ProductKey备用
注:修改烧录方式时会进行修改确认,按照提示操作即可
RG4100+启动之后将会创建一个WiFi热点,其SSID以及密码标注在RG4100+底部的标签上,如下图所示:
注:网关的WiFi热点的密码默认都是一样的,默认IP地址也一样。
您可以将您PC的WiFi连接到RG4100+的热点之后,使用telnet工具(比如putty)连接网关的地址:192.168.82.1,用户名/密码为:root/admin。正确登录之后界面如下所示:
为了接入新的子设备,用户需要在RG4100+上指定子设备型号->阿里云IoT ProuctKey的映射,映射文件位于/usr/rule,用户可以使用命令 cd /usr/rule
进入该目录,该目录下文件如下图所示:
其中文件ProductKey.map是指定子设备型号与ProductKey映射,其内容如下所示:
对于子设备厂商新创建的设备,需要在该表格中增加一行来指定子设备型号(rex_model_id)、子设备类型(rex_type)、以及对应的ProductKey(to_product_key)、desc(产品描述)。用户可以使用命令 vi ProductKey.map
打开该文件进行内容修改。
注:键入字符
i
可以让vi从命令模式进入编辑模式,退出编辑模式到命令模式可以按下Esc
键,保存修改需要在命令模式下键入:wq
并回车 。
本示例中使用已有的模组固件(型号为RH7031,rex_type为1101),并未向瑞瀛物联申请新的设备型号,因此无需添加新行,可以直接将to_product_key的值修改为上面创建的子设备的ProductKey【注意:在修改之前先将原productKey复制备用】,保存后退出。
注:设备商实际开发产品时,需要向瑞瀛物联申请子设备型号、子设备类型,并在mapper中增加一行产品描述,并需要瑞瀛提供相应的数据转换规则文件。
RG4100+需要为子设备创建数据处理规则文件,该规则文件的名称需要与子设备的ProductKey保持一致:
上图中右上方框选的文件即为RG4100+中型号RH7031对应的子设备的转换规则文件,本示例中我们需要为我们创建的产品创建转换规则文件。如上图命令所示,我们首先备份已有的a1rN8CghtG0.cvt,然后将其名称修改为我们新创建产品的ProductKey:a1zB0QPiYXB.cvt (注:用户操作时需要将该文件的名字修改为自己创建的产品的ProductKey的数值):
cp a1rN8CghtG0.cvt a1rN8CghtG0.cvt.orig //备份原有文件
mv a1rN8CghtG0.cvt a1zB0QPiYXB.cvt //为新产品创建转换规则文件
重启RG4100+让修改后的配置生效
将手机连接到RG4100+上联的路由器的WiFi热点
在主界面点击 +号,如果网络连接正常,将会自动显示出RG4100网关,如下图所示:
选择该发现的RG4100网关进行添加即可完成设备添加和绑定。
本步骤失败常见原因:
使用手机APP扫描在智能生活开放平台的产品“人机交互”页面中的二维码:
随后手机APP将会提示选择子设备需要接入的网关,选择在上面的步骤中绑定的RG4100+即可,随后手机APP会提示是否继续添加子设备:
点击“我确定,下一步”
将模组的针脚8连接到开发板的3.3v-10秒,让子设备进入配对状态,若一切正常,模组将会被加入网络以及被手机APP绑定,在手机APP的主页面将会出现添加的开关设备:
本步骤常见失败原因:
若排除上面的两个原因仍然出现失败,可以多尝试几次添加操作。
模组的针脚8的电平拉高再拉低(也即将针脚8连接到开发板的3.3V+再立即连回到3.3V-),会模拟一下开关的状态变化,模组将会把该变化上报给RG4100+,并由RG4100+上报到智能生活开放平台,然后打开手机APP上开关的面板查看开关的状态变化:
在文档使用中是否遇到以下问题
更多建议
匿名提交