首页 > 代码库 > AiCloud 2.0 AT开发文档【转】

AiCloud 2.0 AT开发文档【转】

2024-09-13 07:52:39   221人阅读

本文转载自：http://wiki.ai-thinker.com/aicloud/docs/atdevelop

AT指令一览表

AiCloud AT指令 
指令描述
AT+CLDSTART启动云服务
AT+RST复位模块/停止云服务
+CDATA接收对象化数据
+CRAW接收透传数据
+CSTATE云端连接状态
AT+CLDSEND发送数据点
AT+CLDSENDRAW发送透传数据
AT+CLDUNBIND解除设备与所有用户的绑定
AT+CLDOTA升级固件
AT+CLDSMART进入智能连接模式
AT+CLDAP进入AP连接模式
AT+CLDSTATE获取云端连接状态
AT+CLDTIME获取时间
AT+CSYSID查看芯片ID
AT+CSYSSEED配置模组激活码
AT+CSYSHASH模组hash值
AT+CIOBAUD串口配置
AT+CIOMODE配置IO口
AT+CIOWRITE写IO口
AT+CIOREAD读IO口
AT+CIOADC读ADC值
AT+CWSMARTSTART启动智能配网
AT+CWSMARTSTOP停止智能配网
AT+CWWPSSTART启动Wi-Fi WPS功能
AT+CWWPSSTOP停止Wi-Fi WPS功能

 

指令描述

 

AT+CLDSTART

命令AT+CLDSTART
参数无
说明启用云服务，若无错误则响应 OK，否则请检查网络连接以及密钥是否正常。
举例AT+CLDSTART 
OK

AT+RST

AT+RST 复位模块/停止云服务
执行命令: AT+RST  响应 OK
参数说明 无 
说明一旦启用AiCloud，必须重启模块才能停用。

+CDATA

+CDATA 接收对象化数据
+CDATA,<len>:datapoint:value,datapoint:value,……  响应 无
参数说明 无 
举例APP请求模组数据:   +CDATA,37:”s”,”m”,”hue”,”lit”,”sat”,”lum”,”tem”   
APP设置模组数据:   +CDATA,19:”s”:1,”m”:1,”hue”:0

 +CRAW

+CRAW 接收透传数据
+CRAW,<len>:data  响应 无
参数说明 无 
举例APP透传数据:   +CRAW,10:helloworld

 +CSTATE

+CSTATE 云端连接状态 
+CSTATE:[state]
云端断开连接 +CSTATE:[CLOUD_DISCONNECTED]   
开始智能配网 +CSTATE:[SMARTLINK_START]   
智能配网正在搜索Wi-Fi频道 +CSTATE:[SMARTLINK_FINDING]   
智能配网正在获取配置 +CSTATE:[SMARTLINK_GETTING]   
智能配网正在连接Wi-Fi路由器 +CSTATE:[SMARTLINK_LINKING]   
智能配网成功 +CSTATE:[SMARTLINK_OK]   
AP配网 +CSTATE:[AP_CONFIG]   
AP配网成功 +CSTATE:[AP_CONFIG_OK]   
正在连接云端 +CSTATE:[CLOUD_CONNECTING]   
进入AP-STATION模式 +CSTATE:[AP_STATION_OK]   
云端连接成功 +CSTATE:[CLOUD_CONNECTED]

 AT+CLDSEND

AT+CLDSEND 发送数据点
设置命令: AT+CLDSEND=<key>:<value>[,<key>:<value>…]  响应 OK
参数说明 无 
说明向云端发送数据： AT+CLDSEND=”s”:1,”m”:1

 AT+CLDSENDRAW

AT+CLDSENDRAW 发送透传数据
设置命令: AT+CLDSENDRAW=<len>  响应 OK
说明
AT+CLDSENDRAW=10   
OK 
> helloworld 
SEND OK

 AT+CLDUNBIND

AT+CLDUNBIND 解除设备与所有用户的绑定
执行命令: AT+CLDUNBIND  响应 OK
说明必须先和云端建立连接，此命令才可以成功

 AT+CLDOTA

AT+CLDOTA 升级固件
执行命令: AT+CLDOTA  响应 OK
说明必须先和AiCloud建立连接，才能升级。该升级是有版本号限制的，版本号只能向上升级。

 AT+CLDSMART

AT+CLDSMART 进入智能连接模式
执行命令: AT+CLDSMART  响应 
+CSTATE:[CLOUD_DISCONNECTED] 
+CSTATE:[SMARTLINK_START] 
OK
说明 

 AT+CLDAP

AT+CLDAP 进入AP连接模式
执行命令: AT+CLDAP  响应 OK
说明 

 AT+CLDSTATE

AT+CLDSTATE 获取云端连接状态
执行命令: AT+CLDSTATE  响应 +CSTATE:[IDLE] OK
说明  
+CSTATE:[SMARTLINK_START] 
+CSTATE:[SMARTLINK_LINKING] 
+CSTATE:[SMARTLINK_FINDING] 
+CSTATE:[SMARTLINK_TIMEOUT] 
+CSTATE:[SMARTLINK_OK] 
+CSTATE:[AP_CONFIG] 
+CSTATE:[AP_CONFIG_OK] 
+CSTATE:[AP_OK] 
+CSTATE:[AP_ERROR] 
+CSTATE:[AP_STATION_OK] 
+CSTATE:[AP_STATION_ERROR] 
+CSTATE:[STATION_OK] 
+CSTATE:[STATION_ERROR] 
+CSTATE:[CLOUD_CONNECTING] 
+CSTATE:[CLOUD_CONNECTED] 
+CSTATE:[CLOUD_DISCONNECTED]

 AT+CLDTIME

AT+CLDTIME 获取时间
设置命令: AT+CLDTIME=<minute_offset>  响应 2017-1-11 16:23:38 OK
参数说明 <minute_offset>:时间偏移量, 分钟 
说明
协调世界时（英：Coordinated Universal Time ，法：Temps Universel Coordonné），又称世界统一时间，世界标准时间，国际协调时间。
英文（CUT）和法文（TUC）的缩写不同，作为妥协，简称UTC。 
协调世界时是以原子时秒长为基础，在时刻上尽量接近于世界时的一种时间计量系统。 
中国大陆采用ISO 8601-1988的《数据元和交换格式信息交换日期和时间表示法》（GB/T 7408-1994）称之为国际协调时间，现行标准号为GB/T 7408-2005，2005-10-01实施，代替原来的GB/T 7408-1994。 
中国台湾采用CNS 7648的《资料元及交换格式–资讯交换–日期及时间的表示法》（与ISO 8601类似）称之为世界统一时间。   获取国际协调时间（UTC）, 同时也是格林尼治天文台时间
示例获取北京时间（UTC+8） 
AT+CLDTIME=480 
2017-1-11 16:39:09 
OK   
获取华盛顿时间（UTC-5） 
AT+CLDTIME=-300 
2017-1-11 3:39:09 OK

 AT+CSYSID

AT+CSYSID 查看芯片ID
执行命令: AT+CSYSID  响应 
+CSYSID:CHIP:00004AF3;FLASH:001640E0;KEY:89931B67; 
OK
参数说明 无 
说明 

 AT+CSYSSEED

AT+CSYSSEED 配置模组激活码
设置命令: AT+CSYSSEED=<privatekey>  响应 OK
参数说明 <privatekey> 模组激活码,每一个模组唯一 
说明 

 AT+CSYSHASH

AT+CSYSHASH 模组hash值
执行命令: AT+CSYSHASH  响应 +CSYSHASH:00004AF3001640E089931B6789931B67 OK
参数说明 无 
说明需要烧录一个特定的key到flash的倒数第6个扇区才可以正常使用该指令。

 AT+CIOBAUD

AT+CIOBAUD 串口配置

命令AT+CIOBAUD=<baudrate>,<databits>,<stopbits>, <parity>,<flowcontrol> 
响应 OK
参数<baudrate> 串口波特率 
<databits> 数据位   5：5bit数据位   6：6bit数据位   7：7bit数据位   8：8bit数据位 
<stopbits> 停止位   1：1bit停止位   2：1.5bit停止位   3：2bit停止位 
<parity> 校验位   0：None   1：Odd   2：EVEN 
<flowcontrol> 流控   0：不使能流控   1：使能RTS   2：使能CTS   3：同时使能RTS和CTS
说明1. 本设置将保存在Flashuserparameter区，重新上电后仍生效。 
2. 使用流控需要硬件支持流控，MTCK为UART0CTS,MTDO为UART0 RTS 
3. 波特率支持范围：110~115200*40 与AT+UART不同之处在于， AT+CIOBAUD允许省略后面的参数，
　例如： AT+CIOBAUD=115200 省略参数时，使用默认参数如下: 数据位:8 停止位:1 校验位:无 硬件流控:禁用（不使能流控）
示例AT+CIOBAUD=115200 
AT+CIOBAUD=115200,8 
AT+CIOBAUD=115200,8,1,0,0

 AT+CIOMODE

AT+CIOMODE 配置IO口
设置命令: AT+CIOMODE=<gpio>,<mode>  响应 OK
参数说明 <gpio> 引脚号0,1,2,3,4,5,9,10,12,13,14,15,16 <mode> 输入输出   0: 输入   1: 输出 
举例AT+CIOMODE=12,1

 AT+CIOWRITE

AT+CIOWRITE  写IO口
设置命令: AT+CIOMODE=<gpio>,<mode>  响应 OK
参数说明 <gpio> 引脚号0,1,2,3,4,5,9,10,12,13,14,15,16 <level> 输入输出   0: 低电平   1: 高电平 
举例AT+CIOWRITE=12,1

 AT+CIOREAD

AT+CIOREAD  读IO口
设置命令: AT+CIOREAD=<gpio>  响应 1:HIGH 0:LOW OK
参数说明 <gpio> 引脚号0,1,2,3,4,5,9,10,12,13,14,15,16 
举例AT+CIOREAD=12

 AT+CIOADC

AT+CIOADC  读ADC
设置命令: AT+CIOADC  响应 426 OK
参数说明 无 
说明 

 AT+CWSMARTSTART

AT+CWSMARTSTART  启动智能配网
设置命令: AT+CWSMARTSTART=<method>  响应 OK
参数说明 <method>整数变量，智能连接的方式。 0:使用安信可AI-LINK技术 1:使用ESP-TOUCH技术 2:使用AIR-KISS技术 
说明本设置会将模块设置为STATION模式。启动智能连接技术后，请在手机端启动AI-LINK智能连接APP并输入无线网络名称与密码。配置成功时会自动尝试连接配置的Wi-Fi.智能连接技术启动后，在以下两种条件下会停止： 1:用户执行AT+CWSMARTSTOP 2:配置成功 连接成功后，返回如下信息: SMARTSUCCESS SSID:<ssid> PASSWORD:<password> OK （此功能为安信可科技有限公司增加的功能，请向安信可科技有限公司反馈问 题）

 AT+CWSMARTSTOP

AT+CWSMARTSTOP停止ESP8266智能连接技术
执行命令: AT+CWSMARTSTOP  响应 OK
参数说明 无 
说明执行本指令会停止正在进行的智能连接技术。 （此功能为安信可科技有限公司增加的功能，请向安信可科技有限公司反馈问题）

 AT+CWWPSSTART

AT+CWWPSSTART启动Wi-FiWPS功能
设置命令: AT+CWWPSSTART=<method>  响应 OK
参数说明 <method>整数变量，WPS的类型。 1:使用WPSPBC类型 
说明执行本指令会停止正在进行的智能连接技术。 （此功能为安信可科技有限公司增加的功能，请向安信可科技有限公司反馈问题）

 AT+CWWPSSTOP

AT+CWWPSSTOP停止Wi-FiWPS功能
执行命令: AT+CWWPSSTOP  响应 OK
说明执行本指令会停止WPS功能。 （此功能为安信可科技有限公司增加的功能，请向安信可科技有限公司反馈问题）
举例AT+CWWPSSTOP

 AT+CWHOSTNAME

AT+CWHOSTNAME 
查询命令: AT+CWHOSTNAME?  响应 +CWHOSTNAME:ESP_1DBDEB OK
设置命令: AT+CWHOSTNAME=<name>响应 OK  
参数说明： <name> 字符串名字 
说明本指令不保存到flash，重启后hostname恢复成ESP_XXXXXX
举例AT+CWHOSTNAME=”ESP_MODULE”

 AT+CIUPDATE

AT+CIUPDATE  升级固件
执行命令: AT+CIUPDATE  响应 +CIUPDATE:1 +CIUPDATE:2 +CIUPDATE:3 +CIUPDATE:4 OK
举例AT+CIUPDATE
说明该升级不限制固件版本号，可升版本号也可降版本号。 v1.5.2及以后的版本支持该升级。与AT+CLDOTA有些区别。

 AT开发例程

这里用AT指令来连接AiCloud并和app做透传。

步骤1：注册app账号

技术分享技术分享技术分享 

步骤2：设备配网

以下三种方法均可以给设备配网，可以选择最适合您的任意一种。

方法一：使用AT+CLDSTART命令自动进入配网状态

AT+RST      //复位模块ready AT+CLDSTART  //启动云服务OK+CSTATE:[CLOUD_DISCONNECTED]+CSTATE:[AP_OK]+CSTATE:[SMARTLINK_START]+CSTATE:[SMARTLINK_FINDING] AT+CLDSTATE  //查询云端状态+CSTATE:[SMARTLINK_FINDING]OK // app点击配网之后的打印+CSTATE:[SMARTLINK_GETTING]+CSTATE:[SMARTLINK_LINKING]+CSTATE:[SMARTLINK_OK]+CSTATE:[CLOUD_CONNECTING]+CSTATE:[AP_STATION_OK]+CSTATE:[CLOUD_CONNECTED]    // 连接成功

技术分享

方法二：使用AT+CWSMARTSTART命令进行配网

AT+RSTready AT+CWMODE=1OK AT+CWSMARTSTART=1   // ESPTOUCH配网, 启动云之后请不要再使用该命令配网！OK // app点击配网之后的打印SMART SUCCESSSSID:TP-LINK_42ADPASSWORD:admin123456OKWIFI CONNECTEDWIFI GOT IPPHONE:192.168.0.114 AT+CLDSTART         // 配网成功后，启动云服务OK+CSTATE:[CLOUD_CONNECTING]+CSTATE:[STATION_OK]+CSTATE:[CLOUD_CONNECTED]  // 连接成功

方法三：直接加入wifi网络

AT+RSTready AT+CWMODE=1OK AT+CWJAP="ssid","passwd"  // 加入wifi网络WIFI CONNECTEDWIFI GOT IPOK AT+CLDSTART               // 启动云服务+CSTATE:[CLOUD_DISCONNECTED]+CSTATE:[CLOUD_CONNECTING]+CSTATE:[STATION_OK]+CSTATE:[CLOUD_CONNECTED] // 连接成功

方法四：使用AT+CLDSMART配网

AT+RSTready AT+CLDSTART              // 启动云服务+CSTATE:[CLOUD_CONNECTED] AT+CLDSMART              // 进入配网状态, 重新配置另一个wifi+CSTATE:[CLOUD_DISCONNECTED]+CSTATE:[SMARTLINK_START]OK+CSTATE:[SMARTLINK_FINDING]+CSTATE:[SMARTLINK_GETTING]+CSTATE:[SMARTLINK_LINKING]+CSTATE:[SMARTLINK_OK]+CSTATE:[CLOUD_CONNECTING]  // 配网成功后会自动连接AiCloud+CSTATE:[AP_STATION_OK]+CSTATE:[CLOUD_CONNECTED] AT+CLDSTOP   // 停止云服务OK+CSTATE:[CLOUD_DISCONNECTED]

步骤3：绑定设备

设备配网成功后，APP在”我的设备”下拉刷新，可以看到局域网的设备。

点击未绑定设备进行绑定。(按住设备左滑可以备注、删除、解绑设备。)

技术分享技术分享

步骤4：收发数据

 

透传数据

透传类型的数据不会被平台统计显示。

设备端:

AT+CLDSENDRAW=10   //发送透传数据> helloworldSEND OK

APP:

点击ESP系列模组，进入数据收发窗口，在底下的发送栏可以发送16进制透传数据。

技术分享技术分享 

 数据点

数据点类型的数据会被云平台统一显示。

AT+CLDSEND=”s”:1,”m”:1

AiCloud 2.0 AT开发文档【转】


联系
我们