PDF《ZM7100X AT 指令集》

User Manual ZM7100X AT 指令集 软件平台 UM01010101 V0.

1.0 Date:2018/09/14 产品用户手册 类别 内容 关键词 NB-IoT、ZM7100X 摘要描述 ZM7100X 模块的 AT 命令使用 广州致远电子有限公司 ?2018 广州致远电子有限公司 ZM7100X AT 指令集 软件平台 修订历史 版本 日期 原因 发布 0.1.0 2018/9/14 创建文档 产品用户手册 ?2018 Guangzhou ZHIYUAN Electronics Co., Ltd. ? i C

82 ? 广州致远电子-ZM7100X?2018 广州致远电子有限公司 ZM7100X AT 指令集 软件平台 目录1. AT 命令简介

1 1.1 AT 信息分类・1 1.2 AT 命令语法・1 1.3 AT 命令格式・1 2. 一般命令

1 2.1 查询国际移动台设备标识 IMSI 号:AT+CIMI・1 2.2 查询产品 IMEI 号:AT+CGSN

2 3. 网络服务命令・2 3.1 主动上报网络信息:AT+ZMMI

2 3.2 LTE 下锁频:AT+ZLTELC・3 3.3 运营商选择:AT+COPS

4 4. 安全性命令・4 4.1 PIN 码输入:AT+CPIN

4 4.2 功能锁定:AT+CLCK・5 4.3 更改密码:AT+CPWD・6 4.4 查询 PIN 剩余次数:AT+ZRAP

6 5. ME 控制和状态命令・7 5.1 操作模式设置:AT+CFUN・7 5.2 ICCID 上报:+ZICCID

7 5.3 CP 准备就绪指示:+ZMSRI

8 6. GPRS 命令

8 6.1 定义 PDP 上下文:AT+CGDCONT・8 6.2 PDP 上下文激活/去激活:AT+CGACT

10 6.3 PDP 激活之后的上报:+ZGIPDNS

11 6.4 PDP 上下文读取动态参数:AT+CGCONTRDP・12 6.5 EPS 网络注册状态:AT+CEREG

14 6.6 PS 域事件上报:+CGEV・16 6.7 省电模式设置:AT+CPSMS

17 6.8 eDRX 参数设置:AT+CEDRXS・18 6.9 读取 eDRX 动态参数:AT+CEDRXRDP

20 6.10 CIOT 最优配置:AT+CCIOTOPT・20 6.11 APN 速率控制:AT+CGAPNRC

21 6.12 附着及去附着:AT+CGATT

22 6.13 定义二次 PDP 上下文:AT+CGDSCONT・22 6.14 EPS 服务质量:AT+CGEQOS・23 产品用户手册 ?2018 Guangzhou ZHIYUAN Electronics Co., Ltd. ?

1 C

82 ? 广州致远电子-ZM7100X?2018 广州致远电子有限公司 ZM7100X AT 指令集 软件平台 6.15 EPS 服务质量读取动态参数:AT+CGEQOSRDP・24 6.16 PDP 上下文修改:AT+CGCMOD

24 7. 短消息命令・25 7.1 短信发送:AT+ZMGS・25 7.2 保存短信:AT+ZMGW・25 7.3 选择短消息存储器:AT+CPMS

26 7.4 新接收短信直接上报指示:+CMT

27 7.5 读取一条短信:AT+CMGR・27 7.6 删除短信:AT+CMGD・28 7.7 短消息服务中心号码:AT+CSCA・28 7.8 上层存储空间有效性通知:AT+ZMENA

29 8. 仪表测试和路测命令

30 8.1 TSP 版本配置设置:AT+ZSET

30 8.2 频段设置:AT+ZBANDSET・32 8.3 获取当前状态:AT+ZQCST

32 8.4 获取当前小区信号质量:AT+ZESQ

33 8.5 获取邻区信息:AT+ZNESQ

33 8.6 校准频段查询:AT+ZAMTBAND

34 8.7 小区覆盖等级查询:AT+ZCCLV

34 8.8 PUSCH 功率查询:AT+ZPSHPWR

35 9. Socket 相关命令

35 9.1 建立 TCP/UDP 连接:AT+ZIPOPEN

35 9.2 建立 Socket 数据模式:AT+ZDTMODE

36 9.3 TCP/UDP 数据发送:AT+ZIPSEND

37 9.4 TCP/UDP 数据接收:+ZIPRECV

39 9.5 检查 Socket 状态:AT+ZIPSTAT

40 9.6 关闭 TCP/UDP 连接:AT+ZIPCLOSE・40 10. 软件调试相关命令

41 10.1 iperf 设置・41 10.2 IPv4/IPv6 激活设置

43 10.3 默认 DNS 设置・43 10.4 网络探测 ping・43 10.5 低功耗相关命令

44 10.6 云开关设置・44 10.7 串口外设配置

45 10.8 系统支撑配置

46 产品用户手册 ?2018 Guangzhou ZHIYUAN Electronics Co., Ltd. ?

2 C

82 ? 广州致远电子-ZM7100X?2018 广州致远电子有限公司 ZM7100X AT 指令集 软件平台 11. UPDATE 命令

46 11.1 系统固件版本:AT+UPSYSVER

46 11.2 服务器固件版本查询:AT+UPYUNVER

47 11.3 FOTA 升级:AT+UPFOTA・47 11.4 离线升级:AT+UPOFFLINE

48 12. MQTT 命令

48 12.1 设置连接参数:AT+MQTTCFG

48 12.2 设置负载数据格式:AT+MQTTDTMODE

49 12.3 获取 mqtt 协议版本:AT+MQTTVER

49 12.4 发起连接:AT+MQTTCONN

50 12.5 断开连接:AT+MQTTDISCONN

50 12.6 发布消息:AT+MQTTPUB・50 12.7 订阅主题:AT+MQTTSUB・51 12.8 取消订阅:AT+MQTTUNSUB

51 12.9 订阅消息上报:+MQTTSUBSCRIBE

51 13. CoAP 命令

52 13.1 发送 CoAP 请求:AT+COAPSENDREQ

52 13.2 处理 CoAP 响应:+COAPRECVRESP・52 13.3 配置 CoAP 工作参数:AT+COAPCFG

53 13.4 设置或读取 CoAP 选项:AT+COAPOPT・54 14. LWM2M 命令・54 14.1 创建对象实例:AT+LWM2MOBJADD

54 14.2 删除对象实例:AT+LWM2MOBJDEL

55 14.3 lwm2m 注册:AT+LWM2MREG・55 14.4 设置资源值:AT+LWM2MSET・56 14.5 设置上报数据:AT+LWM2MNOTIFY

56 14.6 服务器写操作数据上报:+LWM2MWRITE

57 14.7 服务器读操作数据上报:+LWM2MREAD・57 14.8 服务器执行操作数据上报:+LWM2MEXE

57 14.9 获取版本:AT+LWM2MVER?58 15. OneNET 命令

58 15.1 创建基础通信套件:AT+MIPLCREATE

58 15.2 删除基础通信套件:AT+MIPLDELETE

62 15.3 设备注册:AT+MIPLOPEN

62 15.4 设备注销:AT+MIPLCLOSE

62 15.5 添加对象和实例:AT+MIPLADDOBJ・63 产品用户手册 ?2018 Guangzhou ZHIYUAN Electronics Co., Ltd. ?

3 C

82 ? 广州致远电子-ZM7100X?2018 广州致远电子有限公司 ZM7100X AT 指令集 软件平台 15.6 删除对象和实例:AT+MIPLDELOBJ・63 15.7 资源信息上报:AT+MIPLNOTIFY

64 15.8 回复 READ 命令:AT+MIPLREADRSP

64 15.9 回复 WRITE 命令:AT+MIPLWRITERSP・66 15.10 回复 EXECUTE 命令:AT+MIPLEXECUTERSP

66 15.11 回复 OBSERVE 命令:AT+MIPLOBSERVERSP

67 15.12 回复 DISCOVER 命令:AT+MIPLDISCOVERRSP・67 15.13 回复 PARAMETER 命令:AT+MIPLPARAMETERRSP

68 15.14 更新注册:AT+MIPLUPDATE

68 15.15 获取通信套件版本:AT+MIPLVER・69 15.16 读取请求消息:+MIPLREAD

69 15.17 读取请求消息:+MIPLWRITE

70 15.18 执行请求消息:+MIPLEXEUTE・70 15.19 观测请求消息:+MIPLOBSERVE

71 15.20 设置策略参数请求消息:+MIPLPARAMETER

71 15.21 object 属性请求消息:+MIPLDISCOVER・72 15.22 状态事件上报:+MIPLEVENT

72 16. 电信云命令

73 16.1 连接电信云平台:AT+CTIOTCONN

73 16.2 发送数据到电信云平台:AT+CTIOTSAD

73 16.3 接收电信云下发的写操作:+CTIOTRAD

73 17. 杂项命令・74 17.1 软件版本号获取:AT+CGMR・74 17.2 内部软件版本号获取:AT+ZVERSION

74 17.3 板号获取:AT+BOARDNUM

74 17.4 单个生产测试标志位获取:AT+PRODTEST・75 17.5 查询 IMEI 号:AT+CGSN

75 17.6 打开/关闭 bootloader 端口:AT+ZFLAG・75 17.7 读取所有生产测试标志位:AT+RTESTINFO

76 17.8 查询 MSN 地址:AT+RTESTINFO

76 17.9 切换成 AMT 模式:AT+RTESTINFO・77 17.10 查询芯片平台:AT+PLATFORM・77 18. 附录 A +CME ERROR 列表

77 19. 附录 B +CMS ERROR 列表・79 产品用户手册 ?2018 Guangzhou ZHIYUAN Electronics Co., Ltd. ?

4 C

82 ? 广州致远电子-ZM7100X?2018 广州致远电子有限公司 ZM7100X AT 指令集 软件平台 1. AT 命令简介 1.1 AT 信息分类 AT 信息分类如 表1.1 所示(以网络注册 AT+CEREG 为例) . 表1.1: 信息分类表 信息类型 格式(例) 说明 请求 查询请求 AT+CEREG? 获取当前设置的参数值 设置请求 AT+CEREG=<

参数 >

设置用户定义的参数值 执行请求 AT+CIMI 执行一个操作 响应 查询响应 +CEREG: OK 反馈读取结果 设置响应 OK 或ERROR 等 反馈设置结果以及所设参 数 执行响应 +CIMI: OK 或ERROR 等 反馈执行结果 通知 事件通知 +CGEV: …… 上报事件通知或命令执行 的中间结果 1.2 AT 命令语法 尖括号中的参数是必选参数,不可缺省. […] 方括号中的参数是可选参数,可缺省. abc 下划线标出的参数值为参数缺省时默认值. 1.3 AT 命令格式 ? AT 命令请求格式: AT 请求命令都以 AT 开头,以 结束. ? AT 命令返回格式: <

跟AT 命令相关的字符串 >

. ? AT 命令响应内容(OK 、ERROR ) : AT 命令响应内容有以下两种情况: 1. 若AT 命令格式错误或者其他错误, 会返回字符串 +CME ERROR: 或者 +CMS ERROR: , 和 表示不同的错误代码. 2. 如果 AT 命令执行成功,会返回每条命令对应的语法结构里的响应内容以及 OK . 2. 一般命令 2.1 查询国际移动台设备标识 IMSI 号:AT+CIMI ? 命令描述 产品用户手册 ?2018 Guangzhou ZHIYUAN Electronics Co., Ltd. ?

1 C

82 ? 广州致远电子-ZM7100X?2018 广州致远电子有限公司 ZM7100X AT 指令集 软件平台 执行命令,用于查询 USIM 卡的 IMSI 值. ? 语法结构 表2.2: AT+CIMI 操作指令 命令 可能的响应 说明 AT+CIMI +CIMI: OK 为查询到的 IMSI 号+CME ERROR: 失败, 为错误代码 ? 使用实例 请求:AT+CIMI 响应:+CIMI:

460010108912666 OK 或者 请求:AT+CIMI 响应:+CME ERROR:

3 2.2 查询产品 IMEI 号:AT+CGSN ? 命令描述 执行命令,用于查询单板的 IMEI. ? 语法结构 表2.3: AT+CGSN 操作指令 命令 可能的响应 说明 AT+CGSN +CGSN: OK 为查询到的 IMEI 号+CME ERROR: 失败, 为错误代码 ? 使用实例 请求:AT+CGSN 响应:+CGSN:

123456789012340 OK 或者 请求:AT+CGSN 响应:+CME ERROR:

3 3. 网络服务命令 3.1 主动上报网络信息:AT+ZMMI ? 命令描述 设置命令:设置是否开启网络信息上报,设置的值实时生效并且所设的值掉电保存. 读取命令:查询当前设置的 值. 产品用户手册 ?2018 Guangzhou ZHIYUAN Electronics Co., Ltd. ?

2 C

82 ? 广州致远电子-ZM7100X?2018 广州致远电子有限公司 ZM7100X AT 指令集 软件平台 主动上报用户使用信息 MmInformation 格式: +ZMMI:[],[],[],[],[][,[ →],[]] ? 语法结构 表3.4: AT+ZIMI 操作指令 命令 可能的响应 说明 AT+ZMMI=[] OK 设置成功 +CME ERROR: 失败, 为错误代码 AT+ZMMI? +ZMMI: 为当前设置的 n 值?取值说明 : 0:关闭主动上报 MmInformation 1:激活主动上报 MmInformation ? 使用实例 请求:AT+ZMMI=1 响应:OK 3.2 LTE 下锁频:AT+ZLTELC ? 命令描述 设置命令:LTE(NB-S1 mode) 制式下设置锁定频点和小区以及解锁功能.锁定时 必须存在. 读取命令:读取当前锁信息设置. 注:锁和解锁设置在下次掉电并重新上电开机后/软关机再开机时设置才生效. ? 语法结构 表3.5: AT+ZLTELC 操作指令 命令 可能的响应 说明 AT+ZLTELC=[,[,]] OK 成功 +CME ERROR: 失败 AT+ZLTELC? +ZLTELC: ,,

OK 当前设置 ? 取值说明 : 整型,锁或解锁小区及频点. 0:解除锁频点或解除锁小区 1:锁定频点或小区 :

4 字节整型,表示频点,锁定小区时有效.必须为 UE 支持频段范围内. : 整型,表示小区,锁定小区时有效.[0-503]. ? 使用实例 产品用户手册 ?2018 Guangzhou ZHIYUAN Electronics Co., Ltd. ?

3 C

82 ? 广州致远电子-ZM7100X?2018 广州致远电子有限公司 ZM7100X AT 指令集 软件平台 请求:AT+ZLTELC=1,46008,33 响应:OK 3.3 运营商选择:AT+COPS ? 命令描述 设置命令:选择运营商,完成对 NB-S1 模式 LTE 网络的选择. 读取命令:获取当前驻留的网络信息 (PLMNID) 及搜网模式等信息. 注:手动搜网必须携带 和 两个参数,前者需要取值为

2 表示数字格式, 后者为运营商 PlmnId.自动搜网仅携带 参数即可 ? 语法结构 表3.6: AT+COPS 操作指令 命令 可能的响应 说明 AT+COPS= [,,

] OK 成功 +CME ERROR: 失败 AT+COPS? +COPS: [,,

] OK 当前设置 ? 取值说明 : 搜网模式,整型. 0:自动搜网 1:手动搜网 : 运营商信息 的格式,整型. 2:数字格式 协议上的其他格式目前不支持. : 运营商信息,字符串类型 当 取值为

2 时, 即为运营商的 PLMNID ? 使用实例 请求........