文章目录
简介
在TencentOS Tiny AT指令解析源码解析的过程中，为了更好地理解代码的实现，需要对其定义的数据类型有所了解，本篇主要是对TencentOS Tiny AT指令解析源码中的数据类型定义进行讲解，便于后续对源码逻辑进行讲解。
AT指令解析状态与AT指令状态
AT指令解析状态
AT指令解析状态主要AT指令在解析时使用的，用于标记当前解析结果，解析状态的枚举定义如下：
c
typedef enum at_parse_status_en {
AT_PARSE_STATUS_NONE,
AT_PARSE_STATUS_NEWLINE,
AT_PARSE_STATUS_EVENT,
AT_PARSE_STATUS_EXPECT,
AT_PARSE_STATUS_OVERFLOW,
AT_PARSE_STATUS_OK,
AT_PARSE_STATUS_FAIL,
AT_PARSE_STATUS_ERROR
} at_parse_status_t;AT_PARSE_STATUS_NONE ：初识状态，程序开始执行时的状态
AT_PARSE_STATUS_NEWLINE ：空行，不需要进行处理
AT_PARSE_STATUS_EVENT ：事件，代表收到模组主动发送的数据
AT_PARSE_STATUS_EXPECT ：期望值，表示收到的模组应答符合预期
AT_PARSE_STATUS_OVERFLOW ：缓存区溢出
AT_PARSE_STATUS_OK ：收到应答"OK"
AT_PARSE_STATUS_FAIL ：收到应答"FAIL"
AT_PARSE_STATUS_ERROR：收到应答"ERROR"
AT指令状态
AT指令状态用于表示当前AT指令的执行状态，在AT指令接收处理中，对AT指令状态进行赋值，用于告知AT指令的执行结果。
c
typedef enum at_echo_status_en {
AT_ECHO_STATUS_NONE,
AT_ECHO_STATUS_OK,
AT_ECHO_STATUS_FAIL,
AT_ECHO_STATUS_ERROR,
AT_ECHO_STATUS_EXPECT,
} at_echo_status_t;AT_ECHO_STATUS_NONE :初始值
AT_ECHO_STATUS_OK ：指令执行成功
AT_ECHO_STATUS_FAIL ：指令执行失败
AT_ECHO_STATUS_ERROR ：指令执行发生错误
AT_ECHO_STATUS_EXPECT：指令执行应答符合预期
AT指令解析状态与AT指令状态的关系
在AT指令应答的解析时，首先AT指令解析模块会对接收的数据进行解析，并输出AT指令解析结果，然后根据AT指令解析结果得到AT指令的执行结果，后续采用信号量的方式将AT指令的执行结果，通知AT指令执行任务。
AT指令的数据结构
AT指令的数据结构中，涉及了应答数据缓存、预期数据缓存、信号量等内容。
数据结构定义如下：
c
typedef struct at_echo_st {
char *buffer;
size_t buffer_size;
char *echo_expect;
int line_num;
at_echo_status_t status;
size_t __w_idx;
int __is_expecting;
k_sem_t __expect_notify;
k_sem_t __status_set_notify;
int __is_fuzzy_match;
} at_echo_t;buffer ：在需要获取应答数据时，用于存储应答数据；不需要获取应答数据时，设置为NULL。
buffer_size ：buffer的大小，buffer为NULL时，设置为0。
echo_expect ：期望应答，不需要对比期望应答时，设置为NULL。
line_num ：应答数据的中数据行数。
status ：AT指令的状态。
__w_idx ：记录当前应答缓存区中的数据长度。
__is_expecting ：是否判断期望数据。
__expect_notify ：收到期望数据时用于同步的信号量。
__status_set_notify ：收到应答结果（OK、FAIL、ERROR）时用于同步的信号量。
__is_fuzzy_match:是否开启期望数据模糊匹配，开启时只要应答中包含期望数据即任务收到期望数据；不开启时，应答数据需要与期望完全一致才认为收到期望数据。
总结
以上内容，就是在分析TencentOS Tiny AT指令解析源码时需要了解的数据结构，了解这个数据定义后，能够更好地理解源码的实现。下一篇内容，我们将对正式开始对源码进行分析。