一个开源的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作业项*/
typedef struct {
    unsigned int  state : 3;
    unsigned int  type  : 3;                                 /* 作业类型*/
    unsigned int  abort : 1; 
    void          *param;                                    /* 通用参数*/
	void          *info;                                     /* 通用信息指针*/
    struct list_head node;                                   /* 链表结点*/
}at_item_t;

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

/...未完，待续/

基本接口与描述

效果演示

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

使用步骤

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

/* 
 * @brief   定义at控制器
 */
static at_obj_t at;

const at_adapter_t adap = {  //at适配器接口
	//适配gprs模块的串口读写接口
	.write       = uart_write,
	.read        = uart_read
	...
};

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

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

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

例子演示

at 模块(os版本)

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

基本接口与描述

案例演示

参考我的另外一个项目ril(radio interface layer)

使用步骤

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

static at_obj_t at;          //定义at控制器对象

static char urc_buf[128];    //urc主动上报缓冲区

utc_item_t utc_tbl[] = {     //定义urc表
	"+csq: ", csq_updated_handler
}

const at_adapter_t adap = {  //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控制器并创建轮询处理线程

void at_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=<session_id>,<ndata>
	
	<= connect
	
	=> <data>
	
	<= ok
*/

/*
 * @brief       数据发送处理
 * @retval      none
 */
static bool socket_send_handler(at_work_ctx_t *e)
{
    struct socket_info *i = (struct socket_info *)e->params;
    struct ril_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) {      //等待提示符
       goto error;
    }         
    e->write(i->buf, i->bufsize);                             //发送数据
    
    e->write("--eof--pattern--", strlen("--eof--pattern--")); //发送结束符

    if (e->wait_resp(e, "ok", 5000) == at_ret_ok)
        return true;
    else {   
error:
        e->write("--eof--pattern--", strlen("--eof--pattern--"));
        return false;
    }
}

/**
 * @brief       socket 数据发送
 * @param[in]   s   - socket
 * @param[in]   buf - 数据缓冲区
 * @param[in]   len - 缓冲区长度
 */
static bool hl8518_sock_send(ril_obj_t *r, struct ril_sock *s, const void *buf, 
                       unsigned int len)
{
    struct socket_info info = {s, (unsigned char *)buf, len, 0};
    if (len == 0)
        return false;       
    return at_do_work(&r->at, (at_work)socket_send_handler, &info);
}

源码链接：at command: 一种at命令通信解析模块,支持裸机(at_chat)和os版本(at)。适用于modem、wifi模块、蓝牙通信。