LiteOS通信模组教程04-深度剖析LiteOS的AT框架

1. AT客户端框架

在之前的三篇教程中，我们都是直接使用串口助手发送AT指令与模组通信，本篇教程就来探索一下如何使用 MCU 中的串口模组交互。

什么是AT客户端

在使用AT指令的时候，直接发送AT指令的一端称为客户端(AT Client)，接收AT指令并返回响应的一端称为服务端(AT Server)。

ESP8266、M26、BC35-G这些通信模组都是接收我们发送的AT指令，所以称为AT命令服务端，MCU 需要向模组主动发送AT指令，称为AT客户端，它们之间的通信架构如下：

为什么需要AT客户端框架

首先来看上图中的三个数据流：

• 发送AT指令：可以直接调用HAL库提供的API发送，AT框架并无太大作用；
• 等待接收返回结果：可以直接调用HAL库的API使用中断方式接收；
• 接收服务端主动发送的数据：可以直接调用HAL库的API使用中断方式接收；

三条数据流都可以调用HAL库的API直接实现呀，为什么要设计一层AT框架呢？

在直接调用HAL库实现的时候，首先无法保证每次模组向 MCU 发送的数据都能完整的被接收，所以，我们需要设计一层串口驱动以保证数据在任何时候都可以被完整的接收进缓冲区。

其次，在接收数据之后，难点在于对数据的处理，判断AT指令发送的数据是不是正常的返回结果，从返回结果中提取有效信息等等，这些如果每条指令接收之后，都去写代码依次判断，代码量陡增暂且不说，编程的难度也是直接上升，所以，我们需要基于串口驱动，在保证数据被完整接收的前提之上，再根据AT命令通信的特点，设计一层AT框架，专门负责解析数据，提取有效信息。

2. 剖析串口驱动框架实现

串口驱动直接使用LiteOS提供的驱动框架实现，由于其特殊性，最底层的驱动框架实现文件放在了工程目录中，调用HAL库提供的API实现：

uart_at.c文件中，主要完成了两个功能：

• 串口初始化
• 实现串口驱动框架的读写，并注册串口设备到系统中

2.1. 串口初始化

串口初始化函数的调用架构如图：

其中默认初始化的是LPUART1，如果将其它串口作为AT指令的串口，修改这两行代码即可：

2.2. ring_buffer

ring_buffer是专门实现的用户存放接收数据的缓冲区，用户只需要调用read和write操作缓冲区即可，其实现文件在iot-link SDK的IoT_LINK_1.0.0\iot_link\link_misc路径下：

ring_buffer在串口初始化函数中被调用初始化：

缓冲区大小在宏定义中声明：

初始化之后，向LiteOS注册的中断服务函数只需要调用ring_buffer_write向缓冲区不停的写入接收到的数据，即可保证串口数据被完整的接收。

2.3. 串口驱动框架实现

串口驱动框架中，因为已经有了初始化函数，所以只需要实现read函数和write函数即可，实现的函数架构如下：

因为数据全部保存在了ring_buffer中，所以串口驱动的read API实现用缓冲区提供的读取函数实现即可。

实现read和write两个函数之后，调用如下的宏定义，即可将设备和驱动注册到系统中：

OSDRIV_EXPORT(uart_at_driv,CONFIG_AT_DEVICENAME,(los_driv_op_t *)&s_at_op,NULL,O_RDWR);

CONFIG_AT_DEVICENAME由用户指定，不重复即可，在iot_link_config.h文件中，稍后会讲解。

3. 剖析AT客户端框架

AT客户端框架的实现源码在SDK的IoT_LINK_1.0.0\iot_link\at文件夹下：

AT框架的架构如下：

如图，因为串口设备已经注册到了系统中，所以AT框架的底层发送和接收函数直接调用LiteOS设备驱动框架提供的API实现，除了上述图中的这些，还涉及到大量的使用信号量、互斥锁、字符串比较等函数进行AT指令匹配处理，提取结果的代码，这些不是理解AT框架的重点，所以图中未给出。

在实现了AT框架之后，最终留给用户使用的接口只要三个，即可完成AT指令的交互，非常简洁：

• at_init：初始化AT框架，启动AT数据接收引擎(优先级为10)
• at_command：发送AT指令并匹配指定的返回结果
• at_oobregister：监控AT主动上报的数据

接下来，我们以ESP8266模组入网为例，讲述如何使用AT框架提供的简洁API与模组交互。

4. AT客户端框架的使用

AT框架使能及配置

经过上面的讲解，完整的AT框架其实包括设备驱动框架和AT框架实现两部分，所以首先需要在配置文件中使能驱动框架和AT框架。

打开之前新建的HelloWorld工程（如果没有可以参考之前的教程新建一个HelloWorld工程），在.sdkconfig中进行配置，如图：