龙尚LTE模块MQTT物联网指令集V1 6VIP

龙尚科技（上海）有限公司 坦诚 尽责 简洁 开放的思维 勇气 龙尚 LTE 模块 MQTT 物联网指令集 V1.6 共 12 页 第 1 页 龙尚龙尚 LTE 模块模块 MQTT 物联网指令集物联网指令集 龙尚科技（上海）有限公司 坦诚 尽责 简洁 开放的思维 勇气 龙尚 LTE 模块 MQTT 物联网指令集 V1.6 共 12 页 第 2 页 目录 1 MQTT 参数配置指令 AT+LSMQTTCFG . 3 2. MQTT 打开网络连接指令 AT+LSMQTTCALL . 4 3. MQTT 连接服务器指令 AT+LSMQTTOPEN . 5 4. MQTT 关闭已连接指令：AT+LSMQTTCLOSE . 6 5. MQTT 订阅主题指令 AT+LSMQTTSUB . 7 6. MQTT 发布消息指令 AT+LSMQTTPUB . 8 7. 收到 MQTT 服务器数据后的主动上报 . 8 8. 设置 MQTT HEX 模式 AT+LSMQTTHEXMODE . 9 9. MQTT 使能主动上报 AT+LSMQTTURCIND . 10 10. MQTT 上报有消息提示+MQTTR . 11 11. MQTT 读取缓存消息 AT+LSMQTTREAD . 11 龙尚科技（上海）有限公司 坦诚 尽责 简洁 开放的思维 勇气 龙尚 LTE 模块 MQTT 物联网指令集 V1.6 共 12 页 第 3 页 1 MQTT 参数配置指令参数配置指令 AT+LSMQTTCFG AT+LSMQTTCFG操作指令 类型 指令 可能的返回结果 说明 设置指令 AT+LSMQTTCFG=, OK 测试指令 AT+LSMQTTCFG=? +LSMQTTCFG:, OK 指令例程 AT+LSMQTTCFG=topic, hello OK AT+LSMQTTCFG=messa ge,helloworld OK AT+LSMQTTCFG=clientid ,35340716 OK AT+LSMQTTCFG=userna me,152932 OK AT+LSMQTTCFG=passw ord,longsung OK AT+LSMQTTCFG=qos,1 OK AT+LSMQTTCFG? -CLIENTID:35340716 -MESSAGE: helloworld -TOPIC: hello -USERNAME: 152932 -PASSWORD: longsung -SESSION: 0 -RETAINED: 0 -QOS: 1 OK 龙尚科技（上海）有限公司 坦诚 尽责 简洁 开放的思维 勇气 龙尚 LTE 模块 MQTT 物联网指令集 V1.6 共 12 页 第 4 页 AT+LSMQTTCFG参数描述 参数 取值 说明 字符串 可输入项: “topic” 主题 “message” 消息 “clientid” 客户端标识号 “session” 是否保留服务器的客户订阅主题信息(默认不保留) “retained” 是否保留已发布的消息 “qos” 消息等级 “username” 用户名 “password” 密码 整型/字符 串 “topic”字符串，最大可输入63字符 “message” 字符串,最大可输入1280个数据。 “clientid” 字符串 “session” 0:保留订阅的主题或QOS1，2的消息 1:移除所有订阅主题和消息 “retained” 0:不保留消息 1:保留消息，新用户可收到订阅主题的最后一条消 息 “qos” 消息等级0-2 “username” 字符串 “password” 密码 2. MQTT 打开网络连接指令打开网络连接指令 AT+LSMQTTCALL AT+LSMQTTCALL操作指令 类型 指令 可能的返回结果 说明 设置命令 AT+LSMQTTCALL=, OK + LSMQTTCALL: 注：发送完命令后立即返 回 OK，此时模块正在连 接网络，连接成功或连接 失败后会有一个主动上报 “ +LSMQTTCALL : ” 注意：profile id 是可选 项，如果不带该参数，则 默认为profile 1。 如何查询设置profile， 请 参考文档中的 at+cgdcont命令 龙尚科技（上海）有限公司 坦诚 尽责 简洁 开放的思维 勇气 龙尚 LTE 模块 MQTT 物联网指令集 V1.6 共 12 页 第 5 页 查询指令 AT+LSMQTTCALL? + LSMQTTCALL: OK - 测试指令 AT+LSMQTTCALL=? +LSMQTTCALL:(0,1 ),(1-24) OK - 指令例程 AT+LSMQTTCALL=1, 1 或者 AT+LSMQTTCALL=1 OK +LSMQTTCALL:1 上报1表示成功 上报0表示失败 AT+LSMQTTCALL? + LSMQTTCALL: 1 OK - AT+LSMQTTCALL参数描述 参数 取值 说明 0 断开连接 1 连接 124 不支持 1 激活数据业务成功 0 激活数据业务失败 1 当前已激活 0 当前未激活 3. MQTT 连接服务器指令连接服务器指令 AT+LSMQTTOPEN AT+LSMQTTOPEN会使用到AT+LSMQTTCFG中的参数 “clientid” ， “topic” ， “message” ， “session” ， “retained” ， “qos” ， “username” ， “password” ， 可通过AT+LSMQTTCFG 配置。 AT+LSMQTTOPEN操作指令 类型 指令 可能的返回结果 说明 龙尚科技（上海）有限公司 坦诚 尽责 简洁 开放的思维 勇气 龙尚 LTE 模块 MQTT 物联网指令集 V1.6 共 12 页 第 6 页 设 置 命 令 AT+LSMQTTOPEN=,Remote_ Port，keepalive OK + LSMQTTOPEN: 注：打开连接为异步模 式，即发送完该命令后 可以立即得到返回OK， 但是并不代表已经连上 服务器，连接成功或连 接失败后会有一个主动 上报“+ LSMQTTOPEN:” 查 询 指 令 AT+LSMQTTOPEN? +LSMQTTOPEN: OK 指 令 例 程 AT+LSMQTTOPEN=1 20.77.148.42,1883,1 20 OK +LSMQTTOPEN:1 1表示连接成功 AT+LSMQTTOPEN? +LSMQTTOPEN: 0 OK AT+LSMQTTOPEN参数描述 参数 取值 说明 AAA.BBB.CC C.DDD 远程IP地址格式 AAA.BBB.CCC.DDD， 每个字节的范围 0-255。可以用 1个、 2个或者3个数字填写。 0-65535 远程端口 1 连接成功 0 连接失败 1-300 心跳包，1-300秒。默认300秒 4. MQTT 关闭已连接指令：关闭已连接指令：AT+LSMQTTCLOSE 使用AT+LSMQTTCLOSE=1关闭mqtt连接后，会清空LSMQTTCFG中所有的数据。 AT+LSMQTTCLOSE操作指令 龙尚科技（上海）有限公司 坦诚 尽责 简洁 开放的思维 勇气 龙尚 LTE 模块 MQTT 物联网指令集 V1.6 共 12 页 第 7 页 类型 指令 可能的返回结果 说明 设置命令 AT+LSMQTTCLOSE= OK - 测试指令 AT+LSMQTTCLOSE= ? +LSMQTTCLOSE: (0,1) OK - 指令例程 AT+LSMQTTCLOSE= 1 OK - AT+LSMQTTCLOSE参数描述 参数 取值 说明 1 关闭连接,并清空LSMQTTCFG配置数据 0 关闭连接,并不清空LSMQTTCFG配置数据 5. MQTT 订阅主题指令订阅主题指令 AT+LSMQTTSUB AT+LSMQTTSUB 命令订阅需要使用到 AT+LSMQTTCFG 中的“topic” ，“qos”属性，退订需 要使用到“topic”属性，可通过AT+LSMQTTCFG配置。 AT+LSMQTTSUB操作指令 类型 指令 可能的返回结果 说明 设置命令 AT+LSMQTTSUB= OK +LSMQTTSUB: 注：发送完命令后 立即返回OK， 订阅 成功或失败后会有 一 个 主 动 上 报 “+LSMQTTSUB :” 测试指令 AT+LSMQTTSUB=? +LSMQTTSUB:(0,1) OK - 龙尚科技（上海）有限公司 坦诚 尽责 简洁 开放的思维 勇气 龙尚 LTE 模块 MQTT 物联网指令集 V1.6 共 12 页 第 8 页 指令例程 AT+LSMQTTSUB=1 OK +LSMQTTSUB:1 - AT+LSMQTTSUB参数描述 参数 取值 说明 0 退订该主题 1 订阅该主题 1 订阅成功 0 订阅失败 6. MQTT 发布消息指令发布消息指令 AT+LSMQTTPUB AT+LSMQTTPUB 命令订阅需要使用到 AT+LSMQTTCFG 中的“topic” ，“message” ， “retained” ，“qos”属性 AT+LSMQTTPUB操作指令 类型 指令 可能的返回结果 说明 设置命令 AT+LSMQTTPUB= OK +LSMQTTPUB:1 注：发送完命令后立即返 回 OK，发布成功或失败 后会有一个主动上报 “ +LSMQTTPUB:” 指令例程 AT+LSMQTTPUB=1 OK +LSMQTTPUB:1 -发布成功 AT+LSMQTTPUB=1 OK +LSMQTTPUB:0 -发布失败 AT+LSMQTTPUB参数描述 参数 取值 说明 1 发布该主题 7. 收到收到 MQTT 服务器数据后的主动上报服务器数据后的主动上报 MQTT收到的主动上报消息 龙尚科技（上海）有限公司 坦诚 尽责 简洁 开放的思维 勇气 龙尚 LTE 模块 MQTT 物联网指令集 V1.6 共 12 页 第 9 页 类型 指令 可能的返回结果 上报命 令 + MESSAGE:, +MESSAGE: 4,high,10,3031323334 + MESSAGEHEX: , +MESSAGEHEX: 4,high,10,3031323334 +MESSAGE 参数描述 参数 取值 说明 163 Topic长度 字符串 主题名称 1150 0 Message内容长度 字符串 收到的服务器发来的消息内容 8. 设置设置 MQTT HEX 模式模式 AT+LSMQTTHEXMODE AT+LSMQTTHEXMODE可以设置AT+LSMQTTCFG中”message”的格式， 默认为字符格式。 请在输入AT+LSMQTTCFG中”message”前配置。 类型 指令 可能的返回结果 说明 设置命令 AT+LSMQTTHEXMODE= OK 查询指令 AT+LSMQTTHEXMODE? +LSMQTTMODE: OK - 测试指令 AT+LSMQTTHEXMODE=? +LSMQTTMODE: (0-2) OK - 龙尚科技（上海）有限公司 坦诚 尽责 简洁 开放的思维 勇气 龙尚 LTE 模块 MQTT 物联网指令集 V1.6 共 12 页 第 10 页 指令例程 AT+LSMQTTHEXMODE=1 OK - AT+LSMQTTHEXMODE? +LSMQTTMODE: 1 OK - AT+LSMQTTHEXMODE参数描述 参数 取值 说明 0 字符格式 1 HEX格式 2 发送HEX格式，接收为字符格式 9. MQTT 使能主动上报使能主动上报 AT+LSMQTTURCIND AT+LSMQTTURCIND可以设置+MESSAGE是否主动上报，默认为主动上报。 类型 指令 可能的返回结果 说明 设置命令 AT+LSMQTTURCIND= OK 查询指令 AT+LSMQTTURCIND? +LSMQTTURCIND: OK - 测试指令 AT+LSMQTTURCIND=? +LSMQTTURCIND: (0-1) OK - 指令例程 AT+LSMQTTURCIND=1 OK - 龙尚科技（上海）有限公司 坦诚 尽责 简洁 开放的思维 勇气 龙尚 LTE 模块 MQTT 物联网指令集 V1.6 共 12 页 第 11 页 AT+LSMQTTURCIND? +LSMQTTURCIND: 1 OK - AT+LSMQTTURCIND参数描述 参数 取值 说明 0 关闭主动上报 1 打开主动上报 10. MQTT 上报有消息提示上报有消息提示+MQTTR MQTT收到的主动上报消息 类型 指令 可能的返回结果 上报命 令 +MQTTR: + MQTTR: 1 +MQTTR 参数描述 参数 取值 说明 1 1表示收到的服务器发来的消息并缓存 11. MQTT 读取缓存消息读取缓存消息 AT+LSMQTTREAD AT+LSMQTTREAD操作指令 类型 指令 可能的返回结果 说明 设置指令 AT+LSMQTTREAD= +LSMQTTREAD: , OK 测试指令 AT+LSMQTTREAD=? +LSMQTTREAD: OK 指令例程 AT+LSMQTTREAD=10 OK 无缓存消息 AT+LSMQTTREAD=10 +LSMQTTREAD=4,high,10,30 31323334 OK 缓 存 了 主 题 为 “high”的消息 龙尚科技（上海）有限公司 坦诚 尽责 简洁 开放的思维 勇气 龙尚 LTE 模块 MQTT 物联网指令集 V1.6 共 12 页 第 12 页 AT+LSMQTTREAD参数描述 参数 取值 说明 整型 指定要读取的消息长度1,1024 整型 主题的长度 字符串 主题名称 整型 消息的长度 字符串 消息内容 MQTT 使用方法： AT+LSMQTTURCIND=0（关闭主动上报，内部缓存最多 3 条