安信可A9/A9G GPRS模块10分钟使用机智云开发M2M应用教程

机智云

前言安信可 A9/A9G GPRS（GPS） 模块因为有GPRS，相比WIFI，它可以随时随地联网，实现24小时稳定在线，不受地理位置限制，而且提供基站定位和GPS定位功能。提供AT固件使用起来也非常简单，几条命令就快速配置成功。
另外，AT指令固件集成了机智云接入协议，使用简单的几条命令就可以快速接入机智云，从而在非常短的时间内实现M2M应用。
因此这里介绍如何使用A9/A9G模块快速建立一个简单的M2M应用。
目标

• A9/A9G内部集成了一个应用A9Tracker（定位器），实现手机远程查看定位器实时位置以及电子围栏功能，具体使用方法及效果可以看这里(A9/A9G GPRS模块内部集成应用A9Tracker使用方法)
• 使用串口助手操作A9/A9G模块，实现模块接入机智云，实现模块推送消息到手机、手机发送控制数据到模块
  

准备

• 硬件：
  

• 一个A9 或者 A9G模块（建议买A9 pudding开发板，方便开发），可在淘宝购买
  

A9G






A9





A9/A9G pudding开发板（链接稍后放出）

• 流量卡或者电话卡，如果不用短信或者电话功能，建议购买物联网卡，不需要实名更方便,点击图片可以买到
  

物联网卡

• USB转串口模块
  这个开发者一般都有，如果没有也需要购买，建议使用cilicon CP210x芯片的cp2102 usb转串口模块，供电能力比CH34和pl2303好很多。安信可也配套推出了最新的串口模块，包含了3.3V 4.2V 5V 三种供电电压，支持硬件流控，使用CP210x芯片，供电能力更好。
  

USB转串口模块

• 电源
  可以使用锂电池（3.7~4.2V）供电，也可以使用USB供电，但是要保证USB能提供足够的电流（建议峰值>600mA），串口供电也可以，同样保证峰值电流够大，有些串口芯片供电能力不足
  

开发过程

• 保证AT固件是最新固件，不是则需要到安信可官网下载并升级固件
  使用ATI\r\n查询固件信息，与最新固件版本对比
  固件升级指南
  固件发布页面
  
• 申请机智云账号
  
  

• 进入机智云开发者中心：点我进入
  注册并登陆
  

注册登录机智云

• 创建产品及数据点
  

• 点击创建新产品，选择移动网络，数据传输方式使用定长或者变长，定长就是每次上传数据需要把所有的数据点上传，变长就是可以一次只上传部分数据点，数据量大或者通讯频繁为了节约流量可以选变长，数据量不大可以选定长，如果你是第一次使用机智云，建议按照我的步骤来，会了之后自己探索。这里 选择了变长！
  

产品




产品创建

• 创建数据点
  

创建数据点




数据点




应用数据点

• 复制PK和PS
  
  
  
  
  基本信息
  
  
• 连接硬件到电脑
  注意要保证足够的供电能力，或者使用锂电池在VBAT端进行供电也可以
  
  
  
  
  硬件连接
  
  
• 下载并打开串口助手
  使用安信可串口助手，下载
  或者使用其它串口助手都可以，我这里使用的开源的串口助手COMTool(代码不到1000行哦)，下载，版本列表
  
• 连接A9/A9G模块，上电等待串口助手显示READY字样后，发送AT（回车结尾，即AT\r\n）测试连接以及模块是否正常工作（可以多发几次）注意每一个AT命令都是以\r\n（即windows下的换行符）结尾，后面所有命令默认都以\r\n结尾
  
  

ATOK


READY AT

• 连接机智云
  

• 查询IMEI是否正确AT+EGMR=2,7，如果不正确，看模块屏蔽罩上的IMEI，使用AT+EGMR=1,7,"..."写入
  
  
  
  
  IMEI
  
  
  
• 使用AT+GIZSTART=[PK],[PS]注册登录模块到刚刚建立的产品，使用AT+GIZSTOP注销登录
  ！这里值得注意的是：
  第一次注册时这个命令的参数PK、PS是必须的，如果注册过一次后，后面登录无需再使用PK和PS参数，直接使用AT+GIZSTART即可登录。
  如果带参数，模块则会重新注册一遍，模块重新注册会导致手机App用户绑定的这个模块自动解绑！使用时请注意
  
  
  
  
  注册模块到机智云产品
  
  
  这个时候在机智云后台会看到设备已经在线，点击查看可以看到更多设备信息
  
  

设备在线




上下线信息

• 设备推送消息
  使用AT+GIZSEND=<action>,[length],[data]推送数据到云端（/手机客户端）
  这里action代表数据的含义,如下表：
  

定长产品：
命令数值（十六进制）数值（十进制）含义

ACTION_CONTROL0x011App控制命令，设备收到手需要根据数据改变状态，然后上报状态
ACTION_READ_STATUS0x022App读取状态，设备收到后上报状态
ACTION_READ_STATUS_ACK0x033App读取状态后，设备返回状态
ACTION_REPORT_STATUS0x044设备主动上报状态
ACTION_TRANS_RECV0x055接收到MQTT原始数据
ACTION_TRANS_SEND0x066MQTT原始数据发送
ACTION_PUSH_OTA0xfe254OTA变长产品：
命令数值（十六进制）数值（十进制）含义

ACTION_CONTROL0x1117App控制命令，设备收到手需要根据数据改变状态，然后上报状态
ACTION_READ_STATUS0x1218App读取状态，设备收到后上报状态
ACTION_READ_STATUS_ACK0x1319App读取状态后，设备返回状态
ACTION_REPORT_STATUS0x1420设备主动上报状态
ACTION_TRANS_RECV0x1521接收到MQTT原始数据
ACTION_TRANS_SEND0x1622MQTT原始数据发送
ACTION_PUSH_OTA0xfe254OTA发送数据的方式有三种格式，类似AT+CIPSEND，如下图，更详细说明见AT指令文档



设备推送数据

在后台可以看到数据已经成功推送



后台数据记录

上面的数据推送是随便推送的，在这里没有任何含义！
那么如何推送数据点呢，我们创建了一个数据点，且因为是变长产品，根据协议（最后会详细说明，这里可以先不深入探究），我们需要发送两个字节的数据，报告灯为开：0x0101，报告灯为关：0x0100；因为是设备主动报告数据而且产品是变长，action为20：



上传数据点


在后台可以看到，推送数据点成功




后台数据

• 手机App查询状态以及控制设备
  

• 下载机智云App （支持二次开发），在手机应用商店搜索机智云下载安装
  

机智云App

• 生成设备二维码
  按照机智云官方文档教程生成这个设备的二维码，机智云App二维码生成教程
  
• App扫描二维码添加设备
  
  

扫描二维码




已绑定设备

• 查看设备状态及控制设备
  点击已绑定的设备，进入设备页面，设备会收到客户端进入设备页面的查询设备状态的消息
  

设备页面




设备收到消息（这里收到ACTION为18的数据即读取命令，数据内容没显示是因为是非ASCII码）

点击控制开关，设备会收到控制命令



点击App中的开关，发送控制命令




设备收到控制命令（这里收到ACTION为17的数据即控制命令，数据内容没显示是因为是非ASCII码）

如果设备推送设备状态（定长ACTION为4，变长ACTION为20）或者响应App的查询命令推送状态（定长ACTION为3，变长ACTION为19），App界面也会实时更新状态



设备推送数据


在App可以看到数据发生了变化



App灯从关变成了开状态

在后台也可以看到数据内容




后台数据内容

关于机智云的定长数据和变长数据定长定长就是每次传输都传输所有数据点的信息（相对简单，如果编程经验比较少，或者数据量不大或者通信频率不高建议直接选择这种方式），比如建了2个数据点，长度分别为4个字节，则每次推送都要推送两个数据点的数据即8个字节，如图：



定长传输

变长变长相对来说复杂一些！
在推送数据时，由于数据时变长的，服务器需要知道硬件上传的是哪些数据点的数据，所以需要有标志位来表示传输的是哪些数据点，所以在数据的开头会有数据点标志位，每位代表一个数据点（位数不足8位高位补0补足8位，即传输的单位是字节）。举个例子：
创建了一个数据点，数据点类型为bool类型(1位)，则传输数据应该为：
0x0100(False) 或者 0x0101(True)
创建了两个数据点，数据点类型为bool类型，
当只传输第一个数据点：
0x0100(False) 或者 0x0101(True)
当只传输第二个数据点：
0x0200(False) 或者 0x0201(True)
当传输两个数据点：
0x0300(False False) 或者 0x0301(False True)或者0x0302(True False)或者0x0303(True True)
同理，三个数据点标志位占3位，比如同时传输三个数据点数据，且三个数据点的数据都为1，数据为：0x0707
如果数据点不是bool类型，比如有一个bool 类型和一个2个字节的数据



两个数据

可以使用虚拟设备可以方便地进行调试，：




虚拟设备


实际发送的数据为：



后台数据

风之山谷

通过这个支持机智云的GPRS模块，只需几个简单的AT命令即可把当前设备各种状态发送出去或者接收到手机的指令，可以大大简化服务器的搭建的繁重又复杂的工作，让IOT开发变得简单易用~

机智云

风之山谷 发表于 2018-1-3 11:49
通过这个支持机智云的GPRS模块，只需几个简单的AT命令即可把当前设备各种状态发送出去或者接收到手机的指令 ...

我也觉得这个好用  而且这个模块的性价比很高  便宜 可插拔

加上机智云的云服务和在线工具

开发更快乐

风之山谷

机智云 发表于 2018-1-4 16:15
我也觉得这个好用  而且这个模块的性价比很高  便宜 可插拔

加上机智云的云服务和在线工具

这个模块性价比有多高？可否透露一下多少米？