推薦一個開源的AT命令解析模組

☞ 【幹貨】

☞ 【幹貨】

來源：https://toscode.gitee.com/smtian/AT-Command

介紹

一種AT命令通訊解析模組,支持裸機(at_chat)和OS版本(at)。適用於modem、 WIFI模組 、藍芽通訊。

軟體架構

用於無OS版本，使用鏈式佇列及異步回呼方式處理AT命令收發，支持URC處理、自訂命令發送與解析作業。

用於OS版本, 使用前需要根據at_util.h規定的作業系統相關的介面進行移植,如提供號誌操作、任務延時等操作。

使用說明

at_chat 模組(無OS)

基本概念

at_chat 模組使用鏈式佇列進行管理，包含2條連結串列，空閑連結串列和就緒連結串列。它們的每一個基本工作單元稱為一個作業項，對於將要執行的命令都會放到就緒連結串列中，命令執行完成之後由空閑連結串列來進行回收，作業項的定義如下：

/*AT作業項*/
typedefstruct {
unsignedint state : 3;
unsignedint type : 3; /* 作業型別*/
unsignedintabort : 1; 
void *param; /* 通用參數*/
void *info; /* 通用資訊指標*/
structlist_headnode; /* 連結串列結點*/
}at_item_t;


作業是AT控制器定義時固定分配的，沒有使用動態記憶體，預設支持10個作業項，即同時可以允許10個AT命令排隊等待處理。

基本介面與描述

效果演示

詳細使用可以參考Demo程式wifi_task.c模組

使用步驟

1.定義AT控制器及通訊介面卡介面

/* 
 * @brief 定義AT控制器
 */
staticat_obj_t at;
constat_adapter_t adap = { //AT介面卡介面
//適配GPRS模組的串口讀寫介面
.write = uart_write,
.read = uart_read
...
};

1. 1. 初始化AT控制器並放入任務中輪詢（考慮到處理即時性，建議20ms以下）

/* 
 * @brief wifi初始化
 */
voidwifi_init(void)
{
at_obj_init(&at, &adap);
/*...*/
}driver_init("wifi", wifi_init); 
/* 
 * @brief wifi任務(10ms 輪詢1次)
 */
voidwifi_task(void)
{
at_poll_task(&at);
}task_register("wifi", wifi_task, 10);

例子演示

//WIFI IO配置命令
=> AT+GPIO_TEST_EN=1\r\n
<= OK\r\n


/**
 * @brief AT執行回呼處理常式
 */
staticvoidtest_gpio_callback(at_response_t *r)
{
if (r->ret == AT_RET_OK ) {
printf("Execute successfully\r\n");
} else {
printf("Execute failure\r\n");
}
}
at_send_singlline(&at, test_gpio_callback, "AT+GPIO_TEST_EN=1");

at 模組(OS版本)

由於AT命令通訊是一個比較復雜的過程，對於沒有OS的環境下處理難度比較大，也很繞,對於不允許阻塞程式，除了使用狀態與+回呼沒有其它更好的辦法，所以推薦使用這個模組

基本介面與描述

使用步驟

1.定義AT控制器、通訊介面卡介面(包含URC回呼函式表，介面緩沖區URC)

staticat_obj_t at; //定義AT控制器物件
staticchar urc_buf[128]; //URC主動上報緩沖區
utc_item_t utc_tbl[] = { //定義URC表
"+CSQ: ", csq_updated_handler
}
constat_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控制器並建立輪詢處理執行緒

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值
 */
boolread_csq_value(at_obj_t *at, int *rssi, int *error_rate)
{
//接收緩沖區
unsignedchar recvbuf[32];
//AT應答
at_respond_t r = {"OK", recvbuf, sizeof(recvbuf), 3000};
//
if (at_do_cmd(at, &r, "AT+CSQ") != AT_RET_OK)
returnfalse;
//提取出響應數據
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
 */
staticboolsocket_send_handler(at_work_ctx_t *e)
{
structsocket_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) { //等待提示符
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)
returntrue;
else {
Error:
e->write("--EOF--Pattern--", strlen("--EOF--Pattern--"));
returnfalse;
}
}
/**
 * @brief socket 數據發送
 * @param[in] s - socket
 * @param[in] buf - 數據緩沖區
 * @param[in] len - 緩沖區長度
 */
staticboolhl8518_sock_send(ril_obj_t *r, struct ril_sock *s, constvoid *buf, 
unsignedint len)
{
structsocket_infoinfo = {s, (unsignedchar *)buf, len, 0};
if (len == 0)
returnfalse;
return at_do_work(&r->at, (at_work)socket_send_handler, &info);
}







<END>

點這裏👇關註我，記得標星呀～

往期精選：

GPT中文網站

可以在國內同ChatGPT直接進行對話，支持GPT4.0 和 AI繪圖，簡直太方便了，今天新註冊的直接送4.0提問次數 ！

點「在看」的人都變好看了哦