AN1011CN_MiCOKit_APP控制开发实例（基于APICloud）

Size: px

Start display at page:

Download "AN1011CN_MiCOKit_APP控制开发实例（基于APICloud）"

括金
5 years ago
Views:

MiCO Documentation Working Group (MDWG) Track Number: AN1017CN Jenny Liu MXCHIP Co., Ltd Version: 1.0 2017.7.20 Category: Application Note Open 获取更多帮助 (More Help) 登录上海庆科官方网站 :<http://mxchip.

1 MiCO Documentation Working Group (MDWG) Track Number: AN1017CN Jenny Liu MXCHIP Co., Ltd Version: Category: Application Note Open 获取更多帮助 (More Help) 登录上海庆科官方网站 :< 获取公司最新产品信息登录 MiCO 开发者论坛 :< 获取更多 MiCO 最新开发资料登录 FogCloud 开发者中心 :< 获取更多 FogCloud 云开发文档微信扫一扫关注 : MiCO 总动员公众号, 获取 MiCO 团队小伙伴最新活动信息版权声明 (Copyright Notice) Copyright (c) 2017 MDWG Trust and the persons identified as the document authors. All rights reserved. 上海庆科信息技术有限公司 Shanghai MXCHIP Information Technology Co., Ltd. 地址 : 上海市普陀区金沙江路 2145 弄 5 号楼 9 楼 (200333) 电话 : 网址 :

2 Application Note [Page 1] 目录... 1 版本记录概述串口设置 AT 指令通用命令 AT: 连接状态监测 AT?: 帮助命令 ATZ: 复位命令节点信息管理 AT+APPEUI: APPEUI 管理 AT+APPKEY: APPKEY 管理 AT+APPSKEY: APPSKEY 管理 AT+DADDR: 节点短地址 AT+DEUI: 节点 EUI AT+NWKSKEY: NWKSKEY 管理 AT+MAPPSKEY: 组播 APPSKEY 管理 AT+MNWKSKEY: 组播 NWKSKEY 管理 AT+MADDR: 组播地址管理组网和数据收发 AT+CFM: 消息确认模式 AT+CFS: 消息确认状态 AT+JOIN: 加入网络 AT+NJM: 入网方式 AT+NJS: 查询入网状态 AT+RECV: 接收数据 AT+RECVB: 接收数据 (16 进制字符串 ) AT+SEND: 发送数据 AT+SENDB: 发送数据 (16 进制 ) 网络管理 AT+ADR: 自适应速率 AT+CLASS: Class 模式设置 AT+DR: 速率设置 AT+FCD: 下行数据计数 AT+FCU: 上行数据计数 AT+TXP: 发射功率信息查询 AT+RSSI: 信号强度 AT+VER: 固件版本应用示例... 21

3 Application Note [Page 2] 3.1 加入网络发送数据消息确认接收数据 (CLASS A) 表目录表 2.1 AT 命令基本格式...6 表 2.2 连接检测...7 表 2.3 帮助命令...7 表 2.4 复位命令...7 表 2.5 APPEUI 管理...8 表 2.6 APPKEY 管理... 8 表 2.7 APPSKEY 管理...9 表 2.8 节点短地址管理... 9 表 2.9 节点 EUI 管理...10 表 2.10 NWKSKEY 管理...11 表 2.11 组播 APPSKEY 管理...11 表 2.12 组播 NWKSKEY 管理表 2.13 组播地址管理表 2.14 消息确认模式表 15 消息确认状态表 16 加入网络...14 表 17 入网方式...14 表 18 查询入网状态表 19 接收数据...15 表 20 接收数据 (16 进制字符串 ) 表 21 发送数据...16 表 22 发送数据 (16 进制 ) 表 23 自适应速率...17 表 24 Class 模式设置...17 表 25 速率设置...18 表 26 下行数据计数表 27 上行数据计数... 19

4 Application Note [Page 3] 表 28 发射功率...19 表 29 信号强度...20 表 30 固件版本...20

5 Application Note [Page 4] 版本记录日期版本修订人更新内容 V1.0 Perry Liu 1. 初始版本 V1.0 Perry Liu 1. AT+VER 命令的返回结果

6 Application Note [Page 5] 1. 概述本文档对 LoRaWAN 模块支持的 AT 指令做了详细说明, 并提供了使用示例 1.1 串口设置波特率 :9600 数据位 :8bit 停止位 :1bit 校验 : 无

7 Application Note [Page 6] 2. AT 指令 AT 命令基本格式 : 符号 AT +CMD 描述 AT 指令, 都以 AT 开头, 不区分大小写 +CMD 为命令 = 说明当前为设置操作? 说明当前为读取操作, 参数分隔符, 可能带多个参数 <CR><LF> \r\n 表 2.1AT 命令基本格式 AT+<CMD>? : 获取 <CMD> 的帮助 AT+<CMD> : 执行 <CMD> AT+<CMD>=<value> : 设置 <CMD> 的参数,<value> 为参数值 AT+<CMD>=? : 获取设置参数所有命令以 <CR> 或 <LF> 结尾每个命令发送后都会有返回结果, 如下所示 : : 命令执行成功 AT_ERROR: 命令错误 : 命令参数错误 AT_BUSY_ERROR: 模块正在处理其他命令 AT_TEST_PARAM_OVERFLOW: 参数长度过长 AT_NO_NETWORK_JOINED: 尚未加入 LoRaWAN 网络 AT_RX_ERROR: 命令接收错误返回结果的格式 :<CR><LF>< 结果 ><CR><LF> 2.1 通用命令 AT: 连接状态监测该命令用于检测主机与模块间的串口连接状态

8 Application Note [Page 7] AT 表 2.2 连接检测 AT?: 帮助命令获取所有支持的命令 AT? AT+<CMD>?: help on <CMD AT+<CMD>: run <CMD> AT+<CMD>=<value>: set the value AT+<CMD>=?: get the value... 表 2.3 帮助命令 ATZ: 复位命令复位模块 ATZ? ATZ: triggers a reset of the MCU ATZ 无返回值, 模块复位表 2.4 复位命令 2.2 节点信息管理本章节主要介绍节点信息管理相关的命令 AT+APPEUI: APPEUI 管理用于管理 LoRaWAN 中的 APPEUI 值, 该值由 LoRaWAN 服务端提供 AT+APPEUI? AT+APPEUI: get or set the application EUI AT+APPEUI=? 8 个 16 进制字符串表示的

9 Application Note [Page 8] APPEUI, 以 : 隔开 AT+APPEUI= 16 进制字符串表示的 APPEUI, 以 : 隔开 / AT+APPEUI= 01:01:01:01:01:01:01:01 AT+APPEUI=? 01:01:01:01:01:01:01:01 表 2.5APPEUI 管理 AT+APPKEY: APPKEY 管理用于管理 LoRaWAN 中的 APPKEY 值, 该值由 LoRaWAN 服务端提供 AT+APPKEY? AT+APPKEY: get or set the application key AT+APPKEY=? 16 个 16 进制字符串表示的 APPKEY, 以 : 隔开 AT+APPKEY= 16 个 16 进制字符串表示的 APPKEY, 以 : 隔开 / AT+APPKEY= 2b:7e:15:16:28:ae:d2:a6: ab:f7:15:88:09:cf:4f:3c AT+APPKEY=? 2b:7e:15:16:28:ae:d2:a6:ab:f7 :15:88:09:cf:4f:3c 表 2.6APPKEY 管理 AT+APPSKEY: APPSKEY 管理用于管理 LoRaWAN 中的 APPSKEY 值, 该值由 LoRaWAN 服务端提供 AT+APPSKEY? AT+APPKEY: get or set the application session key

10 Application Note [Page 9] AT+APPSKEY=? 16 个 16 进制字符串表示的 APPSKEY, 以 : 隔开 AT+APPSKEY= 16 个 16 进制字符串表示的 APPSKEY, 以 : 隔开 / AT+APPSKEY= 2b:7e:15:16:28:ae:d2:a6: ab:f7:15:88:09:cf:4f:3c AT+APPSKEY=? 2b:7e:15:16:28:ae:d2:a6:ab:f7 :15:88:09:cf:4f:3c 表 2.7APPSKEY 管理 AT+DADDR: 节点短地址用于管理 LoRaWAN 中的节点短地址, 该值在 ABP 模式下需手动设置,OTAA 模式下, 无需设置 AT+DADDR? AT+DADDR: get or set the device address AT+DADDR=? 4 个 16 进制字符串表示的短地址, 以 : 隔开 AT+DADDR= 4 个 16 进制字符串表示的短地址, 以 : 隔开 / AT+DADDR= 11:22:33:44 AT+DADDR=? 11:22:33:44 表 2.8 节点短地址管理 AT+DEUI: 节点 EUI 用于管理 LoRaWAN 中的节点 EUI, 该值在 ABP 模式下需手动设置,OTAA 模式下, 无需设置

11 Application Note [Page 10] AT+DEUI? AT+DEUI: get or set the device EUI AT+DEUI=? 8 个 16 进制字符串表示的短地址, 以 : 隔开 AT+DEUI= < 参数 > 8 个 16 进制字符串表示的短地址, 以 : 隔开 / AT+DEUI= 31:35:37:31:4d:37:6c:18 AT+DEUI=? 31:35:37:31:4d:37:6c:18 表 2.9 节点 EUI 管理 AT+NWKSKEY: NWKSKEY 管理用于管理 LoRaWAN 中的 NWKSKEY, 该值在 ABP 模式下需手动设置,OTAA 模式下, 无需设置 AT+NWKSKEY? AT+NWKSKEY: get or set the network session key AT+NWKSKEY =? 16 个 16 进制字符串表示的短地址, 以 : 隔开 AT+NWKSKEY = 16 个 16 进制字符串表示的短地址, 以 : 隔开 / AT+NWKSKEY = 2b:7e:15:16:28:ae:d2:a6: ab:f7:15:88:09:cf:4f:3c AT+NWKSKEY =? 2b:7e:15:16:28:ae:d2:a6:ab:f7 :15:88:09:cf:4f:3c

12 Application Note [Page 11] 表 2.10NWKSKEY 管理 AT+MAPPSKEY: 组播 APPSKEY 管理用于管理 LoRaWAN 中的组播 APPSKEY 值, 该值由 LoRaWAN 服务端提供 AT+MAPPSKEY? AT+MAPPSKEY: Get or Set the Application Session Key for Multicast AT+MAPPSKEY =? 16 个 16 进制字符串表示的组播 APPSKEY, 以 : 隔开 AT+MAPPSKEY = 16 个 16 进制字符串表示的组播 APPSKEY, 以 : 隔开 / AT+MAPPSKEY = 2b:7e:15:16:28:ae:d2:a6 :ab:f7:15:88:09:cf:4f:3c AT+MAPPSKEY =? 2b:7e:15:16:28:ae:d2:a6:ab:f 7:15:88:09:cf:4f:3c 表 2.11 组播 APPSKEY 管理 AT+MNWKSKEY: 组播 NWKSKEY 管理用于管理 LoRaWAN 中的组播 NWKSKEY 值, 该值由 LoRaWAN 服务端提供 AT+MNWKSKEY? AT+MNWKSKEY: Get or Set the Network Session Key for Multicast AT+MNWKSKEY=? 16 个 16 进制字符串表示的组播 NWKSKEY, 以 : 隔开 AT+MNWKSKEY= 16 个 16 进制字符串表示的组播 /

13 Application Note [Page 12] NWKSKEY, 以 : 隔开 AT+MNWKSKEY= 2b:7e:15:16:28:ae:d2:a 6:ab:f7:15:88:09:cf:4f: 3c AT+MNWKSKEY=? 2b:7e:15:16:28:ae:d2:a6:ab:f 7:15:88:09:cf:4f:3c 表 2.12 组播 NWKSKEY 管理 AT+MADDR: 组播地址管理用于管理 LoRaWAN 中的组播地址, 该值由 LoRaWAN 服务端提供 AT+MADDR? AT+MADDR: get or set the multicast address AT+MADDR=? 4 个 16 进制字符串表示的短地址, 以 : 隔开 AT+MADDR= 4 个 16 进制字符串表示的短地址, 以 : 隔开 / AT+MADDR= 11:22:33:44 AT+MADDR=? 11:22:33:44 表 2.13 组播地址管理 2.3 组网和数据收发 AT+CFM: 消息确认模式用于设置上报的消息是否需要服务端 ACK 当设置为 1 时, 发送完数据后, 可以使用 AT+CFS=? 命令来查询服务端应答状态

14 Application Note [Page 13] AT+CFM? AT+CFM: get or set the confirm mode(01) AT+CFM=? 0 或 1 AT+CFM= 0 或 1 / AT+CFM= 1 AT+CFM=? 1 表 2.14 消息确认模式 AT+CFS: 消息确认状态当 AT+CFM 设置为 1 时, 用于查询发送消息后服务端的应答状态 AT+CFS? AT+CFS: get or set the confirmation status of the last AT+SEND(01) AT+CFS=? 0 或 1 AT+CFS=? 1 表 15 消息确认状态 AT+JOIN: 加入网络发起入网请求这是一个异步命令, 发送该命令后, 后台会发送入网请求, 用户可以通过发送 AT+NJS=? 来查询入网结果使用 ABP 模式时, 也需要发送该命令 AT+JOIN? AT+JOIN: join network

15 Application Note [Page 14] AT+JOIN / AT_BUSY_ERROR AT+JOIN=? 1 表 16 加入网络 AT+NJM: 入网方式用于设置节点加入网络时, 使用的入网方式 AT+NJM? AT+NJM: get or set the network join mode (0: ABP, 1: OTAA) AT+NJM=? AT+NJM= 0 或 1 / AT+NJM=? 1 AT+CFM= 1 表 17 入网方式 AT+NJS: 查询入网状态用于查询节点入网情况 AT+NJS? AT+NJS: get the join status AT+NJS=? 0( 未加入网络 ) 或 1( 已加入网络 ) AT+NJS=? 1

16 Application Note [Page 15] 表 18 查询入网状态 AT+RECV: 接收数据节点接收到服务端发过来的数据后, 会将数据缓存在内部, 如果使用 CLASS A 模式, 用户在每次 AT+SEND 后发送调该命令来查询服务端是否有下发数据 ; 如果使用 CLASS C 模式, 用户需要定时发送该命令来查询服务端是否下发数据 AT+RECV? AT+CFS: print the last received data in raw format AT+RECV=? 端口号 : 应用数据 AT+RECV=? 120:hello 表 19 接收数据 AT+RECVB: 接收数据 (16 进制字符串 ) 该命令功能与 AT+RECV 相同, 只是原始应用数据部分会被转换成 16 进制字符串后输出 AT+RECVB? AT+RECVB: print the last received data in binary format (with hexadecimal values) AT+RECVB=? 端口号 : 应用数据 AT+RECVB=? 120:48656c6c6f 表 20 接收数据 (16 进制字符串 ) AT+SEND: 发送数据用于向服务端发送数据 AT+SEND? AT+SEND: send text data along with the application port

17 Application Note [Page 16] AT+SEND= 端口号 : 应用数据 / / AT_BUSY_ERROR/ AT_NO_NETWORK_ JOINED AT+SEND= 120:hello 表 21 发送数据 AT+SENDB: 发送数据 (16 进制 ) 向服务端发送 16 进制数据需要将待发送的 16 进制数据转换成 16 进制字符串, 每个字节转换为 2 个字节的 16 进制字符串后再调用该命令发送 AT+SENDB? AT+SENDB: send hexadecimal data along with the application port AT+SENDB= 端口号 : 应用数据 / / AT_BUSY_ERROR/ AT_NO_NETWORK_ JOINED AT+SENDB= 120:48656c6c6f 表 22 发送数据 (16 进制 ) 2.4 网络管理 AT+ADR: 自适应速率用于设置节点是否启用 LoRaWAN 的 ADR 功能, 默认为 1( 开启 ) 该功能需服务端支持

18 Application Note [Page 17] AT+ADR? AT+ADR: get or set the adaptive data rate setting (0: off, 1: on) AT+ADR=? 0 或 1 AT+ADR= 0 或 1 / AT+ADR= 1 AT+ADR=? 1 表 23 自适应速率 AT+CLASS: Class 模式设置用于设置节点使用的 LoRaWAN Class 模式, 节点目前只支持 Class A 和 Class B AT+CLASS? AT+CLASS: get or set the device class AT+CLASS=? A 或 C AT+CLASS= A 或 C / AT+CLASS=? A 表 24Class 模式设置 AT+DR: 速率设置用于设置节点的传输速率 AT+DR? AT+DR: get or set the data rate (05 corresponding to DR_X)

19 Application Note [Page 18] AT+DR=? [0,1,2,3,4,5] AT+DR= [0,1,2,3,4,5] / AT+DR= 1 AT+DR=? 1 表 25 速率设置 AT+FCD: 下行数据计数用于获取和设置下行数据的计数值 AT+FCD? AT+FCD: get or set the downlink frame counter AT+FCD=? 下行数据计数值 AT+FCD= 下行数据计数值 / AT+FCD= 10 AT+FCD=? 100 表 26 下行数据计数 AT+FCU: 上行数据计数用于获取和设置上行数据的计数值 AT+FCU? AT+FCU: get or set the uplink frame counter AT+FCU=? 上行数据计数值 AT+FCU= 上行数据计数值 /

20 Application Note [Page 19] AT+FCU= 10 AT+FCU=? 100 表 27 上行数据计数 AT+TXP: 发射功率设置节点的射频发射功率, 默认值为 0( 最大发射功率 ) 发射功率设置值与实际发射功率对应关系 : 0:17dBm,1:16dBm,2:14dBm,3:12dBm,4:10dBm,5:7dBm,6:5dBm,7:2dBm AT+TXP? AT+TXP: get or set the transmit power (07) AT+TXP=? [0,1,2,3,4,5,6,7] AT+TXP= [0,1,2,3,4,5,6,7] / AT+TXP= 0 AT+TXP=? 0 表 28 发射功率 2.5 信息查询 AT+RSSI: 信号强度用于查询上一次接收到的数据包信号强度, 单位 dbm AT+RSSI? AT+RSSI: get the RSSI of the last received packet

21 Application Note [Page 20] AT+RSSI=? 信号强度值 AT+RSSI=? 30 表 29 信号强度 AT+VER: 固件版本用于查询当前固件版本 AT+VER? AT+VER: get the version of the FW AT+VER=? 固件版本号 ;LoRaWAN 版本 AT+VER=? LRWA.0000.AT01;1.0.2 表 30 固件版本

22 Application Note [Page 21] 3. 应用示例 3.1 加入网络 # AT <CR><LF><CR><LF> # AT+JOIN <CR><LF><CR><LF> # AT+NJS=? 0<CR><LF>/* 未加入网络 */ <CR><LF><CR><LF> /* 等待加入网络 */ # AT+NJS=? 1<CR><LF>/* 已加入网络 */ <CR><LF><CR><LF> 3.2 发送数据 # AT+NJS=? /* 查询节点是否已加入网络 */ 1<CR><LF>/* 已加入网络 */ <CR><LF><CR><LF> # AT+SENDB=60:0123 /* 向 60 端口发送两个字节的数据 (0x01, 0x23) */ <CR><LF><CR><LF> 3.3 消息确认 # AT+NJS=? /* 查询节点是否已加入网络 */ 1<CR><LF>/* 已加入网络 */ <CR><LF><CR><LF> # AT+CFM=? 0<CR><LF>/* 无应答消息模式 */ <CR><LF><CR><LF> # AT+CFM=1/* 设置为有应答消息模式 */ <CR><LF><CR><LF> # AT+SEND=50:Hello World/* 向 50 端口发送数据 */ <CR><LF><CR><LF> # AT+CFS=?/* 查询消息应答状态 */ 0<CR><LF>/* 还未收到服务端的应答消息 */ <CR><LF><CR><LF>

23 Application Note [Page 22] /* 等待服务端应答 */ # AT+CFS=? 1<CR><LF>/* 已收到服务端的应答 */ <CR><LF><CR><LF> 3.4 接收数据 (Class A) # AT+NJS=? /* 查询节点是否已加入网络 */ 1<CR><LF>/* 已加入网络 */ <CR><LF><CR><LF> # AT+RECV=? 0:<CR><LF>/* 未收到数据 */ <CR><LF><CR><LF> /* 服务端向 20 端口发送了 3 个字节的 16 进制数据 (0x01,0xA0,0x23) */ /* 需要先执行发送后, 才能接收到数据 */ # AT+SENDB=2:ab <CR><LF><CR><LF> # AT+RECVB=? 0:<CR><LF>/* 未收到数据 */ <CR><LF><CR><LF> /* 等待接收完成 */ # AT+RECVB=? 20:01a023<CR><LF> /* 收到数据 */ <CR><LF><CR><LF> # AT+RECVB=? 20:<CR><LF>/* 无数据 */ <CR><LF><CR><LF>

Chapter #

Chapter # 第三章 TCP/IP 协议栈本章目标通过本章的学习, 您应该掌握以下内容 : 掌握 TCP/IP 分层模型掌握 IP 协议原理理解 OSI 和 TCP/IP 模型的区别和联系 TCP/IP 介绍主机主机 Internet TCP/IP 早期的协议族全球范围 TCP/IP 协议栈 7 6 5 4 3 应用层表示层会话层传输层网络层应用层主机到主机层 Internet 层 2 1 数据链路层