一个简易的AT框架¶

作者：陈之敏时间：2020年12月10日关键字：csdk、RDA8910、二次开发、AT引擎 ## 目录

最近听说有的小伙伴看了我的教程后，有一些问题都跑到官方的gitee上面去问去了。导致官方的人没搞懂问的是啥，小伙伴们也没能知道自己想要的答案。给大家造成了困扰，这里我说声抱歉。

既然出现了这个问题，我这里就声明一下，本系列教程所涉及的内容(demo)不是官方的作品。我个人觉得官方的demo内容太多太全，往往都是把一个模块内所有的东西全部放在一起。这样的话对新手不是很友好，阅读起来也比较费劲。我就把官方的部分demo进行相关的简化，并推出教程这样的话可能会对新手朋友们有一定的帮助。

有时候周末闲暇时间我也会加上一些我觉得好玩的模块在里面，这些可能在官方的demo都没有，比如cJSON、PAHO-MQTT、http-client。

这就是官方的代码仓库。

git clone --recursive https://gitee.com/openLuat/Luat_CSDK_Air724U.git

当然各位小伙伴在看本教程时，我建议还是使用我下面提供的仓库比较好，看完之后在迁移到官方的仓库⇧。

git clone --recursive https://gitee.com/chenxiahuaxu/RDA8910_CSDK.git

再看本教程过程中如果遇到了问题，可以在本人的代码仓库下面评论。也可以在本人的博客下面评论。我要是看到的话，并且这个问题在我的能力范围的话我会尽力解答的（非官方，不要对我要求太多哦，要求太多我可能就不管啦）。

一、前言¶

很累啊，最近太忙了。一直没时间折腾CSDK，回头一看足足有三个月没写新东西了。太长时间不写感觉都有点手生，拿起键盘都不知道怎么才能下手。

这几天在CSDK上又折腾了下，搞了一个简易的AT引擎。合宙的CSDK默认也是支持一部分AT指令的，不是全部都支持，具体哪些不支持我也不是很清楚。

除了合宙现有的一些AT指令外，有的小伙伴可能还希望在AT版本上面实现其他更复杂的操作，实现自定义的一些功能。而一般平台商提供的AT指令都是通用的，一般不会提供定制功能。直接让模块厂家去添加特定的AT指令可能性不大。甚至可以说基本不可能。

比如有的小伙伴可能想要AT指令能够支持连接阿里云、腾讯云、百度云等等。而这些云平台一般都会有自己的鉴权算法，这些算法五花八门，并且还有可能会经常变动。合宙标准的AT指令也仅仅是提供了MQTT的连接命令，并没有针对这些平台提供具体的连接指令。这一类指令还好一点，受众挺广。以后可能会有，至于是什么时候谁都不知道，至少现在是没有的。

现在没有的情况下，需要使用自定义的AT指令进行交互怎么办？在这里插入图片描述看到这个表情应该知道是什么意思了吧，不急的话继续往下看↓。

二、简介¶

今天带来的文章带来了一个简易的AT引擎。该AT引擎可以实现自定义AT指令、可以实现对固件自带的AT指令实现重定向、可以直接使用固件自带的AT指令。

第一类用法自定义AT：顾名思义自定义AT就是添加属于自己的AT。这个用法和底层的AT没关系。一般情况下AT指令会有四种用法，分别是测试(test)、查询(query)、设置(setup)、执行(exe)。上述是通用用法，但是有些AT指令只具备其中的一个或多个，并不是每个AT指令都会有上述四种用法。

AT+TEST=?           //测试指令。这一般情况下会返回该AT可以输入的参数取值范围
AT+TEST?            //查询指令。一般会返回AT指令之前设置的结果或者默认值
AT+TEST=123456      //设置指令。设置参数，设置的值可以被查询指令查询
AT+TEST             //执行指令。根据设置的结果执行相应的动作

第二类用法重定向AT：相当于给底层自带的AT起一个别名。本例中我将对+WIMEI命令进行重定向，使用+REPWIMEI命令来代替+WIMEI，用法是一摸一样的只是名字变了。不要担心，这个并不会影响到原来的AT，原来的AT还是可以正常使用的。

第三类用法转发AT，由于该模块默认串口1是AT口。我们实现自定义AT也是使用的串口1，这就会导致原来的AT通道不能正常使用。只能在AT引擎中将不匹配的AT通过VAT虚拟AT通道转发到底层处理。

二、编写程序¶

代码目录：Luat_CSDK_Air724U/ demo / at_engine

2.1、main.c¶

demo非常简单，只需要调用at_task_init();我们的AT引擎就可以跑起来了。

/***************
    demo_at_engine
****************/


#include "iot_debug.h"
#include "iot_os.h"


int appimg_enter(void *param)
{
    iot_debug_print("[hello]appimg_enter");

    iot_debug_set_fault_mode(OPENAT_FAULT_HANG);

    iot_vat_send_cmd("AT^TRACECTRL=0,1,1\r\n", sizeof("AT^TRACECTRL=0,1,1\r\n"));
    at_task_init();//初始化AT引擎
    return 0;
}

void appimg_exit(void)
{
    iot_debug_print("[hello]appimg_exit");
}

我们需要修改的内容在app\at_engine目录下，想要自定义命令需要修改三个文件，如果不修改的话默认也是可以跑的。

2.2、at_baseTable.h¶

at_baseTable.h文件存放的是用户自定义AT以及重定向AT的一个表。At引擎运行的时候会到这个表中进行匹配。这个表实际上是一个结构体数组，一个结构体元素代表一个AT命令。每个AT都有7个成员，从左到右依次是旧的AT指令、新的AT指令、新的AT指令长度、测试回调函数、查询回调函数、设置回调函数、执行回调函数。

#ifndef __AT_BASETABLE_H
#define __AT_BASETABLE_H

#include "at.h"
#include "at_baseCmd.h"

at_funcationType at_fun[] = {
    {NULL, "+NEW", 4, at_NEW_Cmdtest, at_NEW_Cmdquery, at_NEW_Cmdsetup, at_NEW_Cmdexe},
    {"I", "+REPI", 5, NULL, NULL, NULL, NULL},
    {"+WIMEI", "+REPWIMEI", 9, NULL, NULL, NULL, NULL},
    {NULL, NULL, 0, NULL, NULL, NULL, NULL}};
#endif

如果旧的AT指令存在，说明该条目是对底层AT进行重定向。这时候只需要在填入新的AT指令和新的AT指令长度即可，后面的四个回调都可以填NULL。实际填了也没用这并不会进入到这个回调中处理。

如果旧的AT指令不存在，说明该条目是一条自定义指令，那就需要填入后面的回调，按需填写。用到哪个就填哪个。简介中有介绍到AT的四种用法。

表中第1条：添加了一条AT+NEW指令，该条目是一个自定义指令，接下来还需要添加四个回调函数。at_NEW_Cmdtest, at_NEW_Cmdquery, at_NEW_Cmdsetup, at_NEW_Cmdexe 表中第2条：使用AT+REPI指令完成对ATI的重定向。原始命令仍可正常使用。表中第3条：使用AT+REPWIMEI指令完成对AT+WIMEI的重定向。原始命令仍可正常使用。 ## 2.3、at_baseCmd.h at_baseCmd.h文件存放的是回调函数声明。

#ifndef __AT_BASECMD_H
#define __AT_BASECMD_H

at_cmdResult at_NEW_Cmdtest(uint8_t id);

at_cmdResult at_NEW_Cmdquery(uint8_t id);

at_cmdResult at_NEW_Cmdsetup(uint8_t id, char *pPara);

at_cmdResult at_NEW_Cmdexe(uint8_t id);

#endif

2.4、at_baseCmd.c¶

at_baseCmd.c文件存放的是回调函数的具体实现。

#include "at.h"
#include "at_baseCmd.h"
//#include "gsm.h"
//执行AT命令
//存储数据
//上传
at_cmdResult at_NEW_Cmdtest(uint8_t id)
{
    char buf[] = "AT+NEW TEST";
    at_uart_send(buf, sizeof(buf) - 1);
    return cmdResultOk;
}
at_cmdResult at_NEW_Cmdquery(uint8_t id)
{
    char buf[] = "AT+NEW QUERY";
    at_uart_send(buf, sizeof(buf) - 1);
    return cmdResultOk;
}
at_cmdResult at_NEW_Cmdsetup(uint8_t id, char *pPara)
{
    char *data = pPara + 1;
    char buf[] = "AT+NEW SETUP pPara is: ";
    at_uart_send(buf, sizeof(buf) - 1);
    at_uart_send(data, strlen(data) - 2);
    return cmdResultOk;
}
at_cmdResult at_NEW_Cmdexe(uint8_t id)
{
    char buf[] = "AT+NEW EXE";
    at_uart_send(buf, sizeof(buf) - 1);
    return cmdResultOk;
}

三、下载验证¶

ATI和AT+REPI测试，可以看到两条命令返回一样的结果。

[2020-12-10 11:52:45.110]# SEND ASCII>
ATI

[2020-12-10 11:52:45.233]# RECV ASCII>

CSDK_V301736_RDA8910

OK

[2020-12-10 11:52:51.295]# SEND ASCII>
AT+REPI

[2020-12-10 11:52:51.426]# RECV ASCII>
AT+REPI

CSDK_V301736_RDA8910

OK

AT+REPWIMEI和AT+WIMEI测试，分别查询结果都是一样的。使用AT+WIMEI设置的新IMEI 也能被AT+REPWIMEI查询到。

[2020-12-10 11:56:18.597]# SEND ASCII>
AT+REPWIMEI?

[2020-12-10 11:56:18.736]# RECV ASCII>
AT+REPWIMEI?

+WIMEI: 866714049398888

OK

[2020-12-10 11:56:19.395]# SEND ASCII>
AT+WIMEI?

[2020-12-10 11:56:19.526]# RECV ASCII>

+WIMEI: 866714049398888

OK

[2020-12-10 11:56:24.068]# SEND ASCII>
AT+WIMEI=123456789123456

[2020-12-10 11:56:24.257]# RECV ASCII>

OK

[2020-12-10 11:56:26.975]# SEND ASCII>
AT+REPWIMEI?

[2020-12-10 11:56:27.110]# RECV ASCII>
AT+REPWIMEI?

+WIMEI: 123456789123456

OK

AT+NEW测试，通过串口一日志看到AT的四种使用形式，测试(test)、查询(query)、设置(setup)、执行(exe)都被正常识别。

[2020-12-10 11:58:12.083]# SEND ASCII>
AT+NEW=?

[2020-12-10 11:58:12.201]# RECV ASCII>
AT+NEW=?

AT+NEW TEST

OK

[2020-12-10 11:58:16.403]# SEND ASCII>
AT+NEW?

[2020-12-10 11:58:16.525]# RECV ASCII>
AT+NEW?

AT+NEW QUERY

OK

[2020-12-10 11:58:23.541]# SEND ASCII>
AT+NEW=123456

[2020-12-10 11:58:23.697]# RECV ASCII>
AT+NEW=123456

AT+NEW SETUP pPara is: 123456

OK

[2020-12-10 11:58:27.065]# SEND ASCII>
AT+NEW

[2020-12-10 11:58:27.179]# RECV ASCII>
AT+NEW

AT+NEW EXE

OK

不会下载的点击这里，进去查看我的RDA8910 CSDK二次开发入门教程专题第一篇博文1、RDA8910CSDK二次开发：环境搭建里面讲了怎么下载这里只是我的学习笔记，拿出来给大家分享，欢迎大家批评指正，本篇教程到此结束