一种AT命令通信解析模块介绍

介绍

一种AT命令通信解析模块,支持裸机(at_chat)和OS版本(at)。适用于modem、WIFI模块、蓝牙通信。

软件架构

• at_chat.c at_chat.h list.h

用于无OS版本，使用链式队列及异步回调方式处理AT命令收发，支持URC处理、自定义命令发送与解析作业。

•at.c at.h at_util.h comdef.h

用于OS版本, 使用前需要根据at_util.h规定的操作系统相关的接口进行移植,如提供信号量操作、任务延时等操作。

使用说明

at_chat 模块(无OS)

基本概念

at_chat 模块使用链式队列进行管理，包含2条链表，空闲链表和就绪链表。它们的每一个基本工作单元称为一个作业项，对于将要执行的命令都会放到就绪链表中，命令执行完成之后由空闲链表来进行回收，作业项的定义如下：

/*AT作业项*/
typedefstruct{
unsignedintstate:3;
unsignedinttype:3;/*作业类型*/
unsignedintabort:1;
void*param;/*通用参数*/
void*info;/*通用信息指针*/
structlist_headnode;/*链表结点*/
}at_item_t;

作业是AT控制器定义时固定分配的，没有使用动态内存，默认支持10个作业项，即同时可以允许10个AT命令排队等待处理。

基本接口与描述

•at_send_singlline, 发送单行命令，默认等待OK响应，超时3S

•at_send_multiline, 多行命令，默认等待OK响应，超时3S

•at_do_cmd，支持自定义发送格式与接收匹配串

•at_do_work，支持自定义发送与接收解析

效果演示

详细使用可以参考Demo程序wifi_task.c模块

m169 wifi模组通信效果图

使用步骤

1.定义AT控制器及通信适配器接口

/*
*@brief定义AT控制器
*/
staticat_obj_tat;

constat_adapter_tadap={//AT适配器接口
//适配GPRS模块的串口读写接口
.write=uart_write,
.read=uart_read
...
};

1.初始化AT控制器并放入任务中轮询（考虑到处理实时性，建议20ms以下）

/*
*@briefwifi初始化
*/
voidwifi_init(void)
{
at_obj_init(&at,&adap);
/*...*/
}driver_init("wifi",wifi_init);

/*
*@briefwifi任务(10ms轮询1次)
*/
voidwifi_task(void)
{
at_poll_task(&at);
}task_register("wifi",wifi_task,10);

例子演示

//WIFIIO配置命令
=>AT+GPIO_TEST_EN=1


<= OK

/**
*@briefAT执行回调处理程序
*/
staticvoidtest_gpio_callback(at_response_t*r)
{
if(r->ret==AT_RET_OK){
printf("Executesuccessfully
");
}else{
printf("Executefailure
");
}
}
at_send_singlline(&at,test_gpio_callback,"AT+GPIO_TEST_EN=1");

at 模块(OS版本)

由于AT命令通信是一个比较复杂的过程，对于没有OS的环境下处理难度比较大，也很绕,对于不允许阻塞程序，除了使用状态与+回调没有其它更好的办法，所以推荐使用这个模块

基本接口与描述

• at_do_cmd，执行AT命令，可以通过这个接口进一步封装出一常用的单行命令、多行命令。

• at_split_respond_lines，命令响应分割器。

• at_do_work，适用于发送组合命令，如GPRS模组发送短信或者发送socket数据需要等待"<"或者"CONNECT"提示符，可以通过这个接口自定义收发。

使用步骤

1.定义AT控制器、通信适配器接口(包含URC回调函数表，接口缓冲区URC)

staticat_obj_tat;//定义AT控制器对象

staticcharurc_buf[128];//URC主动上报缓冲区

utc_item_tutc_tbl[]={//定义URC表
"+CSQ:",csq_updated_handler
}

constat_adapter_tadap={//AT适配器接口
.urc_buf=urc_buf,
.urc_bufsize=sizeof(urc_buf),
.utc_tbl=utc_tbl,
.urc_tbl_count=sizeof(utc_tbl)/sizeof(utc_item_t),
//debug调试接口
.debug=at_debug,
//适配GPRS模块的串口读写接口
.write=uart_write,
.read=uart_read
};

2.创建AT控制器并创建轮询处理线程

voidat_thread(void)
{
at_obj_create(&at,&adap);
while(1){
at_process(&at);
}
}

例子演示

例子1(查询无线模组信号质量)

/**at_do_cmd接口使用演示
查询GPRS模组信号质量命令
=>AT+CSQ

<= +CSQ: 24, 0
    <= OK
*/

/* 
 * @brief    获取csq值
 */ 
bool read_csq_value(at_obj_t *at, int *rssi, int *error_rate)
{
    //接收缓冲区
    unsigned char recvbuf[32];
    //AT应答
    at_respond_t r = {"OK", recvbuf, sizeof(recvbuf), 3000};
    //
    if (at_do_cmd(at, &r, "AT+CSQ") != AT_RET_OK)
        return false;
    //提取出响应数据
    return (sscanf(recv, "%*[^+]+CSQ: %d,%d", rssi, error_rate) == 2);

}

例子2(发送TCP数据)

/**at_do_work接口使用演示
参考自hl8518模组Socket数据发送命令
=>AT+KTCPSND=,

<= CONNECT
    
    =>

<= OK
*/

/*
 * @brief       数据发送处理
 * @retval      none
 */
static bool socket_send_handler(at_work_ctx_t *e)
{
    struct socket_info *i = (struct socket_info *)e->params;
structril_sock*s=i->s;

if(s->type==SOCK_TYPE_TCP)
e->printf(e,"AT+KTCPSND=%d,%d",s->session,i->bufsize);
else
e->printf(e,"AT+KUDPSND=%d,%s,%d,%d",s->session,s->host,
s->port,i->bufsize);

if(e->wait_resp(e,"CONNECT",5000)!=AT_RET_OK){//等待提示符
gotoError;
}
e->write(i->buf,i->bufsize);//发送数据

e->write("--EOF--Pattern--",strlen("--EOF--Pattern--"));//发送结束符

if(e->wait_resp(e,"OK",5000)==AT_RET_OK)
returntrue;
else{
Error:
e->write("--EOF--Pattern--",strlen("--EOF--Pattern--"));
returnfalse;
}
}

/**
*@briefsocket数据发送
*@param[in]s-socket
*@param[in]buf-数据缓冲区
*@param[in]len-缓冲区长度
*/
staticboolhl8518_sock_send(ril_obj_t*r,structril_sock*s,constvoid*buf,
unsignedintlen)
{
structsocket_infoinfo={s,(unsignedchar*)buf,len,0};
if(len==0)
returnfalse;
returnat_do_work(&r->at,(at_work)socket_send_handler,&info);
}

审核编辑：汤梓红