logo资料库

ML302_OneNET用户手册_V1.0.0.pdf

发布时间：2022-05-29 发布人：admin 分类：说明书 资料大小：1.23M 资料格式：pdf 举报 版权申诉
第1页 / 共51页
第2页 / 共51页
第3页 / 共51页
第4页 / 共51页
第5页 / 共51页
第6页 / 共51页
第7页 / 共51页
第8页 / 共51页
资料共51页，剩余部分请下载后查看
    服务与支持
    文档声明
    关于文档
    修订记录
    目录
    1 概述
    2 模组扩展指令功能需求
    2.1 模组扩展指令设计简介
    2.2 模组扩展指令设计思路
    2.3 模组扩展指令命名规则及使用说明
    2.4 模组扩展指令所实现的主要功能及分类
    3 OneNET大众版扩展指令详细说明
    3.1 大众版扩展指令一览表
    3.2 错误码定义
    3.3 指令格式说明
    3.4 AT指令
    3.4.1 AT^ONENETSET
    3.4.2 AT^ONENETPOST
    3.4.3 AT^ONENETGET
    3.4.4 AT^ONENETDELETE
    3.4.5 AT+CIOT
    3.4.6 AT+CIOTMKEY
    3.4.7 AT+CIOTINIT
    3.4.8 AT+CIOTID
    3.4.9 AT+CIOTIDC
    3.4.10 AT+CIOTKEY
    3.4.11 AT+CIOTKEYC
    3.4.12 AT+CIOTSTATUS
    3.4.13 AT+CIOTSTART
    3.4.14 AT+CIOTDAT
    3.4.15 AT+CIOTBINSET
    3.4.16 AT+CIOTBINSEND
    3.4.17 AT+CIOTBINEND
    3.4.18 AT+CIOTQUIT
    3.4.19 AT+CIOTSEND
    3.4.20 AT+CIOTPING
    3.4.21 +CIOTCMD
    3.4.22 AT+CIOTCONNECTPARA
    3.4.23 AT+CIOTIP
    3.4.24 AT+CIOTPORT
    3.4.25 AT+CIOTAUTHINFO
    3.4.26 AT+CIOTPROID
    3.4.27 AT+ CIOTSPLIT
    3.4.28 AT+CIOTLOC
    4 使用流程
    4.1 平台端注册产品（因平台端更新，平台端操作应视具体情况为准）
    4.1.1 注册OneNET用户
    4.1.2 创建产品
    4.2 新建设备
    4.2.1 方式一：平台端新建设备
    4.2.1.1 查看接入设备情况
    4.2.1.2 添加设备，获取设备ID
    4.2.1.3 添加设备APIKey
    4.2.2 方式二：模组端新建设备
    4.2.2.1 开机及激活网络
    4.2.2.2 申请设备ID
    4.2.2.3 申请设备APIKey
    4.2.2.4 查询设备ID
    4.2.2.5 查询设备APIKey
    4.2.2.6 删除设备ID
    4.2.2.7 删除设备APIkey
    4.2.3 方式三：模组端新建设备
    4.2.3.1 开机及激活网络
    4.2.3.2 设置产品ID、Masterkey
    4.2.3.3 设置鉴权信息
    4.2.3.4 设置设备名称、设备描述
    4.2.3.5 申请设备ID、设备apikey
    4.3 建立连接，数据传输
    4.3.1 使用HTTP短连接方式（推荐使用）
    4.3.1.1 开机及激活网络
    4.3.1.2 连接云平台服务器
    4.3.1.3 上传数据到云平台
    4.3.1.4 获取云平台数据
    4.3.2 使用EDP长连接方式
    4.3.2.1 开机及激活网络
    4.3.2.2 根据平台端的注册信息，设置模组端参数
    4.3.2.3 设置连接模式及相关参数
    4.3.2.4 短连接单次上传小数据
    4.3.2.5 长连接循环上传小数据
    4.3.2.6 状态查询与心跳报文
    4.3.2.7 平台下发命令
    4.3.2.8 上传二进制文件
    ML302 OneNET 用户手册 4G 系列 版本：V1.0.0 日期：2019 年 8 月
    中移物联网有限公司 服务与支持 如果您有任何关于模组产品及产品手册的评论、疑问、想法，或者任何无法从本手册中找到答案的疑问， 请通过以下方式联系我们。 中移物联网有限公司 网址：iot.10086.cn 邮箱：SmartModule@cmiot.chinamobile.com 客户服务热线：400-110-0866 微信公众号：OneMO2019 2
    中移物联网有限公司 文档声明 注意 本手册描述的产品及其附件特性和功能，取决于当地网络设计。因此，本手册中描述的全部或部分产 品及其附件特性和功能可能未包含在您的购买或使用范围之内。 免责声明 除非合同另有约定，中移物联网有限公司对本文档内容不做任何明示或暗示的声明或保证，并且不对 特定目的适销性及适用性或者任何间接、特殊或连带的损失承担任何责任。 由于产品版本升级或其他原因，本文档内容会不定期进行更新。除非另有约定，本文档仅作为使用指 导，本文档中的所有陈述、信息和建议不构成任何明示或暗示的担保。公司保留随时修改本手册中任何信 息的权利，无需进行提前通知且不承担任何责任。 操作系统更新声明 操作系统仅支持官方升级；如用户自己刷非官方系统，导致安全风险和损失由用户负责。 固件包完整性风险声明 固件仅支持官方升级；如用户自己刷非官方固件，导致安全风险和损失由用户负责。 版权所有©中移物联网有限公司。保留一切权利。 本手册中描述的产品，可能包含中移物联网公司及其存在的许可人享有版权的软件，除非获得相关权 利人的许可，否则，非经本公司书面同意，任何单位和个人不得擅自摘抄、复制本手册内容的部分或全部， 并以任何形式传播。 3
    中移物联网有限公司 关于文档 修订记录 版本 发布日期 V1.0.0 2019/08/12 作者 金俊 描述 初版 4
    中移物联网有限公司 目录 服务与支持 .................................................................................................................................................. 2 文档声明 ...................................................................................................................................................... 3 关于文档 ...................................................................................................................................................... 4 修订记录 ............................................................................................................................................................................ 4 目录 ............................................................................................................................................................. 5 1 概述 ...................................................................................................................................................... 7 2 模组扩展指令功能需求 .......................................................................................................................... 8 2.1 模组扩展指令设计简介 ..................................................................................................................................... 8 2.2 模组扩展指令设计思路 ..................................................................................................................................... 8 2.3 模组扩展指令命名规则及使用说明................................................................................................................. 9 2.4 模组扩展指令所实现的主要功能及分类 ........................................................................................................ 9 3 ONENET 大众版扩展指令详细说明 ..................................................................................................... 10 3.1 大众版扩展指令一览表 ................................................................................................................................... 10 3.2 错误码定义 ........................................................................................................................................................ 11 3.3 指令格式说明 .................................................................................................................................................... 12 3.4 AT 指令 ............................................................................................................................................................... 13 3.4.1 3.4.2 3.4.3 3.4.4 3.4.5 3.4.6 3.4.7 3.4.8 3.4.9 AT^ONENETSET ................................................................................................................................ 13 AT^ONENETPOST ............................................................................................................................ 14 AT^ONENETGET ............................................................................................................................... 15 AT^ONENETDELETE ........................................................................................................................ 16 AT+CIOT .............................................................................................................................................. 17 AT+CIOTMKEY ................................................................................................................................... 17 AT+CIOTINIT ...................................................................................................................................... 18 AT+CIOTID .......................................................................................................................................... 19 AT+CIOTIDC ....................................................................................................................................... 19 3.4.10 AT+CIOTKEY ....................................................................................................................................... 20 3.4.11 AT+CIOTKEYC .................................................................................................................................... 20 3.4.12 AT+CIOTSTATUS ............................................................................................................................... 21 3.4.13 AT+CIOTSTART .................................................................................................................................. 21 3.4.14 AT+CIOTDAT ...................................................................................................................................... 22 3.4.15 AT+CIOTBINSET ................................................................................................................................ 23 3.4.16 AT+CIOTBINSEND ............................................................................................................................ 24 3.4.17 AT+CIOTBINEND .............................................................................................................................. 24 5
    中移物联网有限公司 3.4.18 AT+CIOTQUIT .................................................................................................................................... 25 3.4.19 AT+CIOTSEND ................................................................................................................................... 26 3.4.20 AT+CIOTPING .................................................................................................................................... 27 3.4.21 +CIOTCMD ......................................................................................................................................... 27 3.4.22 AT+CIOTCONNECTPARA ............................................................................................................... 28 3.4.23 AT+CIOTIP .......................................................................................................................................... 29 3.4.24 AT+CIOTPORT ................................................................................................................................... 29 3.4.25 AT+CIOTAUTHINFO ......................................................................................................................... 30 3.4.26 AT+CIOTPROID ................................................................................................................................. 30 3.4.27 AT+ CIOTSPLIT .................................................................................................................................. 31 3.4.28 AT+CIOTLOC ...................................................................................................................................... 31 4 使用流程 ............................................................................................................................................. 32 4.1 平台端注册产品（因平台端更新，平台端操作应视具体情况为准） .................................................... 32 4.1.1 注册 OneNET 用户 ............................................................................................................................. 32 4.1.2 创建产品 ............................................................................................................................................... 32 4.2 新建设备 ............................................................................................................................................................ 33 4.2.1 方式一：平台端新建设备 .................................................................................................................. 33 4.2.2 方式二：模组端新建设备 .................................................................................................................. 35 4.2.3 方式三：模组端新建设备 .................................................................................................................. 42 4.3 建立连接，数据传输........................................................................................................................................ 43 4.3.1 使用 HTTP 短连接方式（推荐使用） ............................................................................................. 43 4.3.2 使用 EDP 长连接方式 ......................................................................................................................... 46 6
    中移物联网有限公司 1 概述 本文档描述了 ML302 模组的扩展指令集功能以及使用方法。 扩展指令集主要应用于中国移动物联网 OneNET 开放平台实现设备数据上传和命令控制功能，模块原有 AT 命令、OneNET 功能 AT 命令、TCP/IP 工具箱 AT 命令等保持不变。 7
    中移物联网有限公司 2 模组扩展指令功能需求 2.1 模组扩展指令设计简介 模组扩展指令的设计旨在实现终端设备和平台服务器之间数据通讯，其中终端设备主要由 ML302 模组及 MCU 主控模块组成，模组扩展指令的功能主要是将平台接入协议（HTTP 协议和 EDP 协议）植入 ML302 模组， 然后进行封装，给用户提供开放的指令接口，用户使用这些指令就可以轻松实现终端设备和平台服务器之间的 数据通讯，平台服务器、ML302 模组及 MCU 主控模块三者之间的关系如下图所示。 图 2-1：平台服务器、模组及 MCU 主控模块关系图 2.2 模组扩展指令设计思路 模组扩展指令的设计主要围绕终端设备和平台之间的数据通讯进行设计，主要包括以下过程和步骤： （1） 平台端产品申请--Masterkey 参数固化。终端设备开发商在 OneNET 平台注册公司管理用户账户， 并在该账号下新建一个产品，一个产品对应平台上的一个 Masterkey（也称主 Apikey）。将在平台申 请的 Masterkey、产品 ID 通过 AT+CIOTMKEY、AT+CIOTPROID 命令保存到模组内。 （2） 设备 ID、设备 apikey 等参数固化。共有三种方式：方式一，平台端新建设备。通过登录云平台，在 产品下添加设备 ID、设备 apikey 等参数，并通过 AT+CIOTID、AT+CIOTKEY 命令将获取的设备 ID、 设备 apikey 保存在模组存储空间内；方式二，模组端新建设备。使用 AT^ONENETSET、 AT^ONENETGET 命令，利用 Masterkey 向云平台申请设备的设备 ID 和设备 apikey，申请成功后， 通过 AT+CIOTID、AT+CIOTKEY 命令将设备 ID 和设备 apikey 保存在模组存储空间内；方式三，模 组端新建设备。使用 AT+CIOTINIT 命令,利用 Masterkey 向云平台申请设备的设备 ID 和设备 apikey， 申请成功后，设备 ID 和设备 apikey 自动保存在模组存储空间内。 （3） 建立设备连接---ML302 模组的数据通讯是采用的 EDP 协议，EDP 协议是建立在 TCP/IP 基础上，所 以要完成设备连接，先得确保模组连上可用的网络，然后 ML302 模组和平台服务器建立 TCP 连接， 最后利用设备 ID 及设备 apikey 封装成 EDP 连接报文建立设备连接。 （4） 数据上传---模组接收主控 MCU 的数据，然后封装成 EDP 报文，发送至平台服务器。 （5） 命令控制---组接收到平台服务器的 EDP 命令控制报文，解析报文内容，然后发送给主控 MCU。 8 ML302模组平台服务器主控
    分享到：
    赞 收藏

    相关推荐

    资料库

    开发技术

    共收录19306份资料，累计14个分类，关注成员有19位，主要包括：Actionscript,Javascript,PHP,VB,Perl,Delphi,Python,C#,C,Java,C++,Web开发,硬件开发,其它

    热门标签

    Actionscript Javascript PHP VB Perl Delphi Python C# C Java C++ Web开发 硬件开发 其它

    最新资料