正点原子atk-m7514g dtu包-产品模块用户手册

功能特 产品概 产品介 特性参 模块资源介 状态灯说 快速使 注意事 使用前准 网络透传数据测 HTTP请求数据测 MQTT透传数据测 阿里云透传数据测 云透传数据测 设备型数据传输测 数据型数据传输测 OneNET透传数据测 RNDIS上网功能测 RNDIS上网功能测 模式介 网络透传模 上位机配置流 数据分发功 上位机配置流 请求头信息说 上位机配置流 阿里云透传模 上位机配置流 云透传模 上位机配置流 上位机配置流 功能介 工作状 透传状 配置状 透传指 串口透传指 网络透传指 配 原子 如何配置原子云功 如何获取设备编号与设备.................................................................................如何建立两个设备节点之间的透传关 如何使用原子云API接 数据 心跳 串口功 时间打包机 长度打包机 串口参数修 发送功 自动任 定 自动重连机 参数保 个性化参 启动提示信 自定义信 模块配 上位机配 恢复出厂参 固件升 上位机本地升级和升 AT指令 错误代 提示信 重启信 异常信 上位机介 功能配 模式配 ..........................................................................................................................108AT指 指令帮 固件升 帮助信 原子软件仓 应用场 DTU与服务器之间进行通 两个用户设备之间通过DTU进行通 DTU与组态软件之间通 用户设备与组态软件之间通过原子云进行通 结构尺 其 8.1地 资料..........................................................................................................................技术支 产品介、、阿里云、云和OneNET）、支持TCP/UDP/HTTP/MQTT数据透传，支持USB无线网卡，支持自动定时任务、支持定位、支持自定义心跳包和包数据，支持上位机/AT指1.1.1ATK-M751特性参TD-LTE-DCS1800:Class1(30dBm+1/-3dB)GSM9008-PSK:ClassE2(27dBm+-3dB)DCS18008-PSK:ClassE2(26dBm+-37mA-SIM1.2.1ATK-M751模块资源介绍NET:3.SIM1.3.1ATK-M7511.1.状态指示灯1.3.2ATK-M7515.5.4.RSTATK-M751BB8.RS485接口6.RS232接口1.3.4ATK-M751状态灯说明LINK状态指示灯LINK灯的状TCPHTTPHTTP云注意事使用前准备将ATK-M751接上电源，会看见PWR灯常亮，如果已经提前打开了串口，会有“复位按键（RST）ATK-M751的LINK12和LINK34状态灯同时开始闪烁后，说网络透传数据测试云服务器！！！网络透传数据测试中使用的是原子云服务器 试，如果想要连接其注意：ATK-M751是根据用户配置的IP与PORT来云服务器！！！网络透传数据测试中使用的是原子云服务器 试，如果想要连接其服务器，只需要将对应的IPPORT具体配置步骤如下(图示步骤请参考图2.3.1)： IP和PORT就行。或者本文档4.4.2章节）。说明ATK-M751已经连上原子云了。栏显示“消息收发”按钮)，打开数据收发界面。这里我们在串口端发送“正点原子ATK-说明：2.3.2ALIENTEK-HRTDTATK-M7512.3.2HTTP请求数据测试HTTP请求数据测试功能说明：利用ATK-M751产品将串口数据POST到原子云的测试服原子云GET服务器测试地址 其中，正点原子的GET测试服务器会将用户请求资源中的数据(URL中的数据)返回，POST测试GET服务器时，上位机发送框的“发送新行”不能勾选！！！） 云服务器返回的应答数据，说明HTTP请求测试正常。MQTT透传数据测试布为“atk/sub”，从而以实现MQTT消息的自发自收功能。为了测试ATK-M751的MQTT功能，这里使用公开的MQTT测试服务器，IP为： ”，PORT为：“18831”，UserName为：TEST，Password为：TEST。配置MQTT工作参数。配置ClientID为“alientek”，Username为“TEST”，Password为“TEST”，服务器地址为“ ”，服务器端为LINK1ATK-M751以在串口端观察到MQTT服务器发送过来的数据，说明MQTT透传数据功能测试正常。阿里云透传数据测试 到DTU里面就可以了。阿里云创建物联网设备步骤如下：登录阿里云物联网平台控制台：. “Topic类列表->定义Topic类”，设备操作权限选择“发布和订阅”，Topic类定信息为：“/a1zo8o55qK7/${deviceName}/user/atk”。这里需要注意一下，DTU上位机上填写并不是这个信息，后面我们会讲到。“AINEDvcam里我们可以直接阿里云的三元素信息：ProductKey、DeviceName和DeviceSecret三个参数，如下图所示。关于阿里云物联网平台的其他教程可以参考官方： /detail/73705.html?spm=a2c4g..6.556.3a8配置“订阅”和“发布”。在“设备管理->设备->查看->Topic列表”下 /detail/40654.html?spm=a2c4g.息填入到DTU上位机的“地域信息”中就可以了。遗嘱保留状态默认为“0”，Keepalive默认为“300”。经过以上步骤后，会发现LINK1灯会闪烁，待灯变为常亮后，就说明ATK-M751已经连如何使用ATK-M751产品连接阿里云的步骤。云透传数据测试设备型数据传输测云物联网平台地址： 登录云物联网平台控制台：。如果没有账号入IoTHub”，点击进入即可。如下图所示。 “显示名称”为温度，“类型”为“number0，“单位”为：℃。humi为“number”，“默认值”为0，“单位”为：%RH。最后选择“创建”后，物模型 要必须先保存下来，后面配置DTU的参数时需要用到。云进行数据通讯，具体步骤如下(图示步骤请参考图)：入到DTU对应的参数里。温馨提示：也可以从创建物时“弹出的信息框”中这些参数，“Endpoint”其实就是name里“/”前的字符串，“物”是name里“/”后的字符串。状态”为1，“遗嘱保留状态”为0，“Keepalive”为300。通过以上步骤后，会发现LINK1灯会闪烁，等待灯变为常亮后，就说明ATK-M751已经连接上服务器了，然后在串口端发送对应的JSON格式数据：“{"reported":{"temp":22,"humi":67.1}}”，可以在串口端观察到云返回的应答数JSON数据格式错误，云会返回错误信息。数据型数据传输测云物联网平台地址： 登录云物联网平台控制台：。如果没有账号入IoTHub”，点击进入即可。如下图所示。“”为“atk”，“权限”为“发布和订阅”。创建。云数据型里面的“”信息是连接认证用的。在“项目列表->列表”下，选择“创建”。“名称”根据要求填写就行，这里填写策略，最后就行结果确认。DTU择“创建用户”。“名称”为“data”,下一步绑定，选择刚刚创建的 我们就来看看如何配置DTU的参数，使其连接上云。具体配置步骤如下（图示配置步骤如图所示）： 配域信息。从云物联网控制台的左上角可以看到，有一个地域位置信息为LINK1ATK-M751试”，可以在串口端观察到云返回一模一样的数据，说明云数据型功能测试正常。OneNET透传数据测试 / 登录OneNET物联网平台控制台：https://o 先账号。从右上角选择“开发者中心”，进入OneNET控制台。选择“多协议接入”。进入OneNET控制台后，将鼠标放在LOGO上，会自动出现导 体参数配置步骤如下（图示步骤请参考图2.8.1）： /,DTU使用MQTT协议进行连接的，所 保存所有参数。ATK-M751OneNET//o /do/bok/dvic-delop/mltpo/sk-dc-tl/dochml入MQT考“JSNtem":2.7OnNET刚U传24.7，说OneNET功能测试正常。LINK1烁RNDIS上网功能测试网连接，使电脑可以通过4G网络以实现无线上网功能。RNDIS模式使用注意事项：RNDISWIN10/WIN8/WIN7/XP如果自动安装不成功，例如XP系统，必须通过手动安装驱动。ATK-M751插入电脑后会有4个未知设备：MobileATInterface/MobileATInterface/MobileDiagInterface和RemoteNDISbasedInternetSharingDevice，这里我们只需要安装“RemoteNDISbasedInternetSharingDevice”RNDIS驱动安装这里先说一下自动更新RNDIS驱动步骤：插入电脑自动安装驱动。ATK-M751RNDIS查看RNDIS设备驱动。打开电脑的“控制面板”,将查看方式修改为“小图标”，然后找到设备“设备管理器”，在“其他设备”下找到“RemoteNDISbasedInternetSharingDevice”设备。如果按照以上方法驱动安装失败，请按照以下步骤手动安装驱动（示例为： 系统RNDIS上网功能测试按照2.9.1小节安装驱动后，接下来就可以使用ATK-M751为电脑提供上网功能了。温馨提示：本小节测试上网所需的流量费用全部来自插入ATK-M751中的卡！！！上网能力。，并正点原子的开源：http 经过以上步骤后，可以看到LINK12和LINK34灯同时慢闪，然后在电脑的“控制面板->网络和共享中心->更改适配器设置”中查看是否存在“RNDIS”网络。如下图红域所示打开浏览器输入开源地址：http /，就可以浏览正点原 网络透传模式3.1.1网络透传模式相关指令序AT指令指令描述1234567893.1.2网络透传模式相关指令表AT指令配置流程发送发送AT指令配置DTU使用网络透传模式实例（注：“//”后的内容为备注说明信息 //①进入配置模式（注这里不需要加回车//DTU返回二次确认信息（DTU主动返回//发送二次确认信息（用户主动发送到//成功进//②选择DTU的工作模式为网络透传模式//DTU工作//③打开第一路服务器连接，如果需要打开其它服务器请使用//对应指令，例如打开第二路服务器请使用//成功打开第一路服务//④配置第一路服务器的协议类型、地//其中：服务器地址可以 ，也可以为IP地//第一路//⑤配置第一路服务器的连接模式为长连接//⑥配置第一路服务器重连时间间隔为////⑦DTU//成功进入透传模式 会根据以上配置信息开始工//至此DTU// 如果需要在网络透传模式中使用原子云、心跳包 包等功能，需要在上面第//步之前将相关参数配置好//2.在发送AT指令前，必须要确保DTU已处于配置模式下。上位机配置流程数据分发功能开启开启DTU的串口透传指令功能（在上位机的“功能配置”界面下配置DTU确保DTU处于透传状态（最简单的方式是断电重启向 的串口端发送以下数据：ALIENTEK@AT+SEND=1,alientek（不需要回车符DTU会自动将第四步中的数据“alientek”发送到第一路服务器上ALIENTEK：为指令密钥（可以通过AT+CMDKEY指令或者上位机进行修改 HTTP模式3.2.1HTTPGET服务器：https://c 实际的URL不带“[]”符号。 HTTP模式相关指令序AT指令指令描述12343.2.2HTTPAT指令配置流程发送发送AT指令使用HTTP模式实例（注：“//”后的内容为备注说明信息 //①进入配置模式（注这里不需要加回车//DTU返回二次确认信息（DTU主动返回//发送二次确认信息（用户主动发送到//成功进//②选择DTU的工作模式为HTTP模式//DTU工作//③配置HTTP模式请求方式为//请求方//④配置HTTP模式请求超时时间为//请求超时时间配置成//⑤配置//请求URL配置成AT+HTTPHD="Connection:close"//HTTP模式下的请//注意如果有多个请求头信息，需要以“\r\n”字符串 //请求头//⑦重启//成功进//至此DTU的配置已经完成//注意：//1.如果需要开启其他功能，需要在第⑦步指令发送之前配置好这些功能。//2.在发送AT指令前，必须要确保DTU已处于配置模式下。//3.以上配置的参数均为示例配置，不保证参数的可用性上位机配置流程配置HTTPGET请求说DTU发送“回DTU发送“回车”数据！！！如果携带 数据，该次请求会失败，请严格按照URL的数GETURLGETURL地址为：用户可以按照以下步骤进行操作：配置DTU配置DTU配置DTU发送数据到DTU的串口

get（DTU会自动将这个数据拼接到URL后面DTU会自动以GET方式请求该URL地址： 等待服务器响应 自动将服务器的响应数据通过串口输 POST请求说用户实际使用POST请求时的示例如下：用户URL地址为：配置DTU配置DTU配置DTU的请求头信息为发送以下数据到DTU的串口端

DTU会自动将第5步接收到的数据上传到POSTDTU自动将服务器的响应数据通过串口输请求头信息说明Content-Connection:close\r\nContent-使用ATAT+HTTPHD="Connection:close\r\nContent-HTTP状态如下表所示：HTTP状态序状态状态码说明123HTTPMQTT透传模在MQTT透传模式下，ATK-M751可以帮助用户快速实现串口数据与MQTT服务器数据交换功能。串口数据可以通过ATK-M751发送到MQTT服务器上，也可以接收来自MQTT服务器的MQTT模式相关指令序AT指令指令描述12345673.3.2MQTTAT指令配置流程发送发送AT指令配置DTU使用MQTT透传模式实例（注：“//”后的内容为备注说明信息 //①进入配置模式（注这里不需要加回车//DTU返回二次确认信息（DTU主动返回//发送二次确认信息（用户主动发送到//成功进//②选择DTU的工作模式为MQTT透传模式//DTU工作//ClientID配置成//username参数配置成 //第一路服务器的连接模式配置成功//服务器//⑦配置MQTT服务器的参//参数信 //⑧配置MQTT的订 信//订 配置成 //⑨配置MQTT的发 信//发 配置成//成功进入透传模式 会根据以上配置信息开始工//至此DTU////1.如果需要开启其他功能，需要在第⑩步指令发送之前配置好这些功能。//2.在发送AT指令前，必须要确保DTU已处于配置模式下。//3.以上配置的参数均为示例配置，不保证参数的可用性上位机配置流程阿里云透传模式在阿里云透传模式下，ATK-M7513.4.1阿里云模式相关指令序AT指令指令描述12345673.4.2阿里云透传模式相关指令表AT指令配置流程发送发送AT指令配置DTU使用阿里云透传模式实例（注：“//”后的内容为备注说明信息 //①进入配置模式（注这里不需要加回车//DTU返回二次确认信息（DTU主动返回 //发送二次确认信息（用户主动发送到 //成功进 //②选择DTU的工作模式为阿里云透传模式 //DTU工作模式配置成功 //③配置阿里云的ProductKey参数 //ProductKey配置成 //④配置阿里云的DeviceName参数 //DeviceName参数配置成功 //⑤配置阿里云的DeviceSecret参数 //DeviceSecret参数配置成功 //地域信 //⑦配置阿里云服务器的订 信 //订 配置成 //参数信 //⑩DTU进入透传 //成功进入透传模式 会根据以上配置信息开始工//至此DTU的配置已经完成//注意：//1.如果需要开启其他功能，需要在第⑩步指令发送之前配置好这些功能。//2.在发送AT指令前，必须要确保DTU已处于配置模式下。//3.以上配置的参数均为示例配置，不保证参数的可用性上位机配置流程云透传模式在云透传模式下，ATK-M751可以帮助用户快速实现串口数据与云服务器的数图3.5.1云透传模式数据传输示意图阿里云模式相关指令序AT指令指令描述1234567表3.5.2云透传模式相关指令AT指令配置流程发送发送AT指令配置DTU使 云透传模式实例（注：“//”后的内容为备注说明信息 //①进入配置模式（注这里不需要加回车 //DTU返回二次确认信息（DTU主动返回 //发送二次确认信息（用户主动发送到 //成功进 //②选择DTU的工作模式为 云透传模式 //DTU工作模式配置成功 云的Endpoint参数 //Endpoint参数配置成功 云的name参数 //name参数配置成功 //⑤配 云的key参 //⑥配 云的地域信 //地域信 //⑦配 云服务器的订 信//说明：该条指令只 云数据型设备中有效 //订 配置成 //⑧配 云服务器的发 信//说明：该条指令只 云数据型设备中有效 //发 信息配置成 //⑨配 云的参数信 //参数信 //⑩DTU进入透传 //成功进入透传模式 会根据以上配置信息开始工//至此DTU的配置已经完成//注意：//1.如果需要开启其他功能，需要在第⑩步指令发送之前配置好这些功能。//2.//2.在发送AT指令前，必须要确保DTU已处于配置模式下。//3.以上配置的参数均为示例配置，不保证参数的可用性。上位机配置流程OneNET透传模在OneNET透传模式下，ATK-M751可以帮助用户快速实现串口数据与云服务器的数据交换。串口数据可以通过ATK-M751发送到OneNET服务器上，也可以接收来自OneNET的阿里云模式相关指令序AT指令指令描述12345表3.6.2云透传模式相关指令AT指令配置流程发送发送AT指令配置DTU使用OneNET透传模式实例（注：“//”后的内容为备注说明信息 //①进入配置模式（注这里不需要加回车//DTU返回二次确认信息（DTU主动返回//发送二次确认信息（用户主动发送到//成功进入配置模//②选择DTU的工作模式为OneNET透传//DTU工作模式配置成//设备ID参数配置成"//产品ID参数配置成 //⑤配置OneNET的鉴权信息参// //⑦配置OneNET服务器的参数信 //订阅配置成 //⑧DTU进入透传模 //成功进入透传模式 会根据以上配置信息开始工//至此DTU的配置已经//注意：//1.如果需要开启其他功能，需要在第⑩步指令发送之前配置好这些功能//2.在发送AT指令前，必须要确保DTU已处于配置模式下//3.以上配置的参数均为示例配置，不保证参数的可用性上位机配置流程配置OneNETRNDIS模式3.7.1RNDIS工作状ATK-M751有两种工作状态：透传状态和配置状态。当处于透传状态下，DTU才会进透传状透传状态是指DTU工作在数据透明传输状态，该状态下，DTU把串口的数据与服务器的数据：“0x010x020x03”。DTU相关指令AT指令指令描述透传状态相关指令表发送发送AT指令进入透传状态实例：(注：发送AT指令时，DTU必须处于配置状态下① //从配置状态进入透//命令执②第 //DTU重启，重启后DTU默认处于透传状//命令执配置状“atk”，否则DTU会返回“ERROR”，这时必须重新发送“+++”。相关指令AT指令指令描述配置状态相关指令表发送发送AT指令进入配置 //进入配置模式（注这里不需要加回车//DTU返回二次确认信息（DTU主动返回//发送二次确认信息（用户主动发送到//成功进透传指透传指令是指DTU工作在透传状态下，用户可以使用“透传密钥+@+AT指令”（注：“+”是服务器端使用网络透传指令实现对DTU的参数查询与配置透传指令需要用到的指令如表4.2.1所示。相关指令AT指令指令描述4.2.1透传指令相关指令表图 发送发送AT指令使用串口透传指令实例//进入配置模式（注这里不需要加回车//DTU返回二次确认信息（DTU主动返回//发送二次确认信息（用户主动发送到//成功进//打开串口透传指令功能（网络透传指令使用对应指令就行 // //配置透传指令密钥（密钥数据通过这条指令进行修改//////串口透传指图 网络透传指务器端发送透传指令查询和配置DTU的参数。网络透传模式下，然后在服务器端（基于原子云进试）发送以下数据： 如图所示网络透传指令配配置功能是指用户可以以形式发送AT指令来配置与查询DTU的参数。配置DTU参数使用非常简单，直接使用其他向DTU上插入的卡发送AT指令相关短信就可以了，注意：发送AT指令的内容不需要加上“回车符”。原子云为： 与原子云服务器的连接。可以通过以下条件来判断DTU是否上原子云：相关指令AT指令相关指令AT指令指令描述4.4.1原子云相关指令表原子云与DTU数据传输方案一，如图4.4.1所示。图4.4.1 原子云与DTU数据传输方案二，如图4.4.2所示。图 如何配置原子云功能的区域如图4.4.3所示。发送发送AT指令配置原子//①进入配置模式（注这里不需要加回车//DTU返回二次确认信息（DTU主动返回//发送二次确认信息（用户主动发送到//成功进//②选择DTU的工作模式为网络透传模式//DTU工作//③打开第一路服务器，用于连//成功打开第一路服务//④配置原子云服务器的地址和 ，协议为//第一路//⑤配置第一路服务器的连接模式为长连接//第一路服务器的连接模式配置成功//⑥配置第一路服务器重连时间间隔为//第一路服务器重连时间间隔配//⑦启用//命令执0" //⑧配置原子云设备编号（这里只是实例展示，实际的设备编号请从原子云上获取）//命令执行成"//⑨配置原子云设//（这里只是实例展示，实际的设备请从原子云上获取//命令执行成//⑩进入透传模//命令执行成如何获取设备编号与设备API接入原子云来获取这些数据，以便用户开发。 册一个账号，有了账号后直接输入用户名和登录原子云就可以了。如图图所示。中就可以实现DTU与原子云之间的连接,如图所示。注意：这里的设备编图 下面显示“消息收发”按钮，点击进入就可以打开数据收发框。如图所示。图 如何建立两个设备节点之间的透传关系新增两个设备节点图 图 就可以实现两个DTU之间的数据透传。注意：如果在分组下面没有勾选设备节点，原子云是不会进行数据透传的。如图所示。图 如何使用原子云API接口原子云是完全免费的，并已开放了API接口以供用户使用（支持定制化服务器，API“资料包->1，文档资料”HTTPSWebSocket两类协API，供用户定制开发业务相关应用。其中：HTTPS协议接口：完成管理功能，例如阅，向设备发送消息等。通讯逻辑示意如图所示。有关原子云API接口的其他说明，请参考资料包中的原子云平台API文档。有任何疑问可以们淘宝或者宝贝描述下的QQ群进行咨询。图 数据心跳跃性，以至于不被运行商断开网络连接。DTU出厂默认是开启心跳包功能的。如果需要设置ASCII码的“ABC”，对应AT指令应该发送“414243”。相关指令AT指令指令描述心跳包相关指令表发送发送AT指令开启心跳包功能//进入配置模式（注这里不需要加回车//DTU返回二次确认信息（DTU主动返回//发送二次确认信息（用户主动发送到//成功进//启用心跳包功//命令执 //配置心跳包数据（是以16进制数字字符串的形式发送的//AT+HRTTM="60"////////包的 的 据前加上包数据）和ALL（同时支持以上两种方式）要设置ASCII码的“ABC”，对应AT指令应该发送“414243”。相关指令AT指令指令描述表包相关指令图 发送发送AT指令开 包功能实例 //进入配置模式（注这里不需要加回车//DTU返回二次确认信息（DTU主动返回//发送二次确认信息（用户主动发送到////启 包功////配 包模////配 包数据类// //配 包数据（注意心跳包数是以16进制数字字符串的形式发送的 //////串口功率为：115200，停止位：1位，数据位：8位，无奇偶校验位。相关指令AT指令指令描述4.6.1串口相关指令表发送发送AT指令修改串口//注意 修改串口参数后必须重启才能生效 //进入配置模式（注这里不需要加回车//DTU返回二次确认信息（DTU主动返回//发送二次确认信息（用户主动发送到//成功进//修改串//命令执 //修改串//命令执////时间打包机制大于等于打包时间T，则DTU会自动将前一个字节作为前一帧的结束，后一个字节作为新一长度打包机制LDTUL串口参数修改当前串口参数：【波特率：115200，停止位：1位，数据位：8位，无奇偶校验位】 【波特率：9600，停止位：1位，数据位：8位，无奇偶校验位】经过以上五个步骤后，这里就已经将DTU的波特率改为了9600。串口通讯参数发送功能插入DTU的卡必须支持收发功相关指令AT指令指令描述表4.7.1定位相关指令通过通过AT指令发送英 实例 //进入配置模式（注这里不需要加回车//DTU返回二次确认信息（DTU主动返回//发送二次确认信息（用户主动发送到//成功进// 发送成功，注意：如果发送失败返回SMSEND//命令执自动任如：、温湿度等功能。自动任务工作示意图如图4.8.1所图4.8.1自动任务工作示意图网络透传模式相关指令序AT指令指令描述12345678表 发送发送AT指令使用自 任务实例 //进入配置模式（注这里不需要加回车 //DTU返回二次确认信息（DTU主动返回 //发送二次确认信息（用户主动发送到 //成功进 //打开自 任 //命令执 任务命令发送时间间隔为1000ms //配置第 //命令执//配置第 //命令执//配置第 //命令执//配置第 //命令执//配置第 //命令执 //进入透 //命令执行成 //命令执行成定相关指令AT指令指令描述查询相关指令AT指令指令描述查询表4.9.1定位相关指令发送发送AT指令查 定位实例 //进入配置模式（注这里不需要加回车//DTU返回二次确认信息（DTU主动返回//发送二次确认信息（用户主动发送到//成功进// //查询到数//命令执选择“ 图 自动重连机制参数保新修改DTU的参数，DTU在上电后会继续工作在上一次配置的参数下，这样用户不必在每次上电时都重新配置一下DTU的参数。个性化