在通信技術(shù)日益發(fā)展的今天，AT命令作為一種古老但依舊強(qiáng)大的通信協(xié)議，依然廣泛應(yīng)用于調(diào)制解調(diào)器、移動(dòng)通信設(shè)備、藍(lán)牙模塊、GPS模塊等多種設(shè)備中。AT命令（Attention Command）源于早期調(diào)制解調(diào)器制造商的引入，通過(guò)“AT”前綴吸引設(shè)備注意并執(zhí)行特定指令。隨著技術(shù)的演進(jìn)，AT命令的應(yīng)用范圍不斷擴(kuò)大，其簡(jiǎn)單而有效的特點(diǎn)使得它成為控制和配置設(shè)備的通用方式。本文將詳細(xì)介紹一種AT命令通信解析模塊的設(shè)計(jì)和實(shí)現(xiàn)，探討其在現(xiàn)代通信技術(shù)中的重要作用。

AT命令通信解析模塊概述

AT命令通信解析模塊是連接AT設(shè)備和控制系統(tǒng)之間的橋梁，它負(fù)責(zé)解析由控制系統(tǒng)發(fā)送的AT命令，并處理來(lái)自AT設(shè)備的響應(yīng)。一個(gè)高效的AT命令通信解析模塊需要支持多種命令格式、錯(cuò)誤處理、超時(shí)機(jī)制以及URC（Unsolicited Result Code，非請(qǐng)求結(jié)果碼）處理等功能。

軟件架構(gòu)

該AT命令通信解析模塊支持裸機(jī)（at_chat）和操作系統(tǒng)（OS）兩個(gè)版本，分別適用于不同的應(yīng)用場(chǎng)景。在裸機(jī)版本中，模塊使用鏈?zhǔn)疥?duì)列及異步回調(diào)方式處理AT命令收發(fā)，支持URC處理、自定義命令發(fā)送與解析作業(yè)。而在OS版本中，模塊則依賴于操作系統(tǒng)提供的信號(hào)量操作、任務(wù)延時(shí)等接口進(jìn)行工作。

基本接口與功能

1. at_send_singlline

該接口用于發(fā)送單行AT命令，并默認(rèn)等待“OK”響應(yīng)，超時(shí)時(shí)間為3秒。如果命令執(zhí)行成功，將返回成功響應(yīng)；否則，返回錯(cuò)誤響應(yīng)或超時(shí)信息。

2. at_send_multiline

該接口支持發(fā)送多行AT命令，同樣默認(rèn)等待“OK”響應(yīng)，超時(shí)時(shí)間為3秒。多行命令通常用于執(zhí)行復(fù)雜操作，如設(shè)置網(wǎng)絡(luò)參數(shù)等。

3. at_do_cmd

該接口允許用戶自定義發(fā)送格式與接收匹配串，提供更高的靈活性。用戶可以根據(jù)需要，定義復(fù)雜的命令序列和期望的響應(yīng)格式。

4. at_do_work

適用于發(fā)送組合命令，如發(fā)送短信或進(jìn)行網(wǎng)絡(luò)連接等需要等待特定提示符的操作。通過(guò)該接口，用戶可以自定義發(fā)送與接收解析邏輯，以適應(yīng)不同設(shè)備的特殊需求。

設(shè)計(jì)與實(shí)現(xiàn)

1. AT控制器與通信適配器

AT控制器是該模塊的核心，負(fù)責(zé)維護(hù)命令的執(zhí)行狀態(tài)、處理URC等。通信適配器則負(fù)責(zé)與AT設(shè)備的物理連接，包括數(shù)據(jù)的發(fā)送和接收。適配器接口通常包括write（發(fā)送數(shù)據(jù)）、read（讀取數(shù)據(jù)）和error（錯(cuò)誤處理）等函數(shù)。

2. 作業(yè)項(xiàng)管理

模塊使用鏈?zhǔn)疥?duì)列管理作業(yè)項(xiàng)，包括空閑鏈表和就緒鏈表。每個(gè)作業(yè)項(xiàng)代表一個(gè)待執(zhí)行的AT命令，包括命令類型、狀態(tài)、參數(shù)等信息。命令執(zhí)行完畢后，作業(yè)項(xiàng)將被回收至空閑鏈表，以便復(fù)用。

3. URC處理

URC是AT設(shè)備主動(dòng)發(fā)送的非請(qǐng)求結(jié)果碼，用于通知控制系統(tǒng)某些事件的發(fā)生。模塊通過(guò)維護(hù)一個(gè)URC表，將收到的URC與表中的匹配項(xiàng)進(jìn)行比對(duì)，并執(zhí)行相應(yīng)的處理函數(shù)。

應(yīng)用示例

以下是一個(gè)使用AT命令通信解析模塊發(fā)送短信的示例：

c

// 定義URC表和緩沖區(qū)  

static char urc_buf[128];  

utc_item_t utc_tbl[] = {{"+CMGS:", sms_sent_handler}};  

// 初始化AT控制器和通信適配器  

at_obj_t at;  

const at_adapter_t adap = {  

   .urc_buf = urc_buf,  

   .urc_bufsize = sizeof(urc_buf),  

   .utc_tbl = utc_tbl,  

   .urc_tbl_count = sizeof(utc_tbl) / sizeof(utc_item_t),  

   .write = uart_write,  

   .read = uart_read,  

   // 其他接口...  

};  

// 發(fā)送短信  

static bool send_sms(at_obj_t *at, const char *phone_number, const char *message) {  

   char cmd[128];  

   snprintf(cmd, sizeof(cmd), "AT+CMGS=\"%s\"", phone_number);  

   at_respond_t r = {"OK", NULL, 0, 3000};  

   if (at_do_cmd(at, &r, cmd) != AT_RET_OK) {  

       return false;  

   }  

   // 發(fā)送短信內(nèi)容...  

   return true;  

}

在這個(gè)示例中，我們首先定義了URC表和緩沖區(qū)，并初始化了AT控制器和通信適配器。隨后，我們實(shí)現(xiàn)了一個(gè)send_sms函數(shù)，該函數(shù)利用AT命令通信解析模塊來(lái)發(fā)送短信。以下是send_sms函數(shù)以及后續(xù)處理短信發(fā)送內(nèi)容的完整示例：

c

#include <string.h>  

#include <stdbool.h>  

#include "at_parser.h" // 假設(shè)這是AT命令解析模塊的頭文件  

// 假設(shè)的UART讀寫(xiě)函數(shù)聲明  

extern int uart_write(const void *data, size_t size);  

extern int uart_read(void *data, size_t size, unsigned int timeout_ms);  

// URC處理函數(shù)，處理短信發(fā)送成功的URC  

static void sms_sent_handler(const char *urc) {  

   // 這里可以添加處理邏輯，比如打印日志、更新?tīng)顟B(tài)等  

   printf("SMS sent successfully: %s\n", urc);  

}  

// 發(fā)送短信的函數(shù)  

static bool send_sms(at_obj_t *at, const char *phone_number, const char *message) {  

   char cmd[128];  

   char final_cmd[256];  

   at_respond_t r = {"OK", NULL, 0, 3000}; // 等待"OK"響應(yīng)，超時(shí)3秒  

   // 第一步：發(fā)送AT+CMGS命令以開(kāi)始發(fā)送短信  

   snprintf(cmd, sizeof(cmd), "AT+CMGS=\"%s\"", phone_number);  

   if (at_send_command(at, &r, cmd) != AT_RET_OK) {  

       printf("Failed to start SMS sending\n");  

       return false;  

   }  

   // 第二步：發(fā)送短信內(nèi)容（注意：內(nèi)容后需要添加CTRL+Z（0x1A）作為結(jié)束符）  

   snprintf(final_cmd, sizeof(final_cmd), "%s%c", message, 0x1A);  

   if (uart_write(final_cmd, strlen(final_cmd)) < 0) {  

       printf("Failed to write SMS content\n");  

       return false;  

   }  

   // 注意：在某些情況下，可能不需要再次等待響應(yīng)，因?yàn)樵O(shè)備可能會(huì)直接通過(guò)URC通知發(fā)送結(jié)果  

   // 但為了示例完整性，這里假設(shè)我們還需要檢查是否有錯(cuò)誤發(fā)生（雖然這不是標(biāo)準(zhǔn)的做法）  

   // （可選）等待可能的錯(cuò)誤響應(yīng)或其他URC  

   // 這里可能需要一個(gè)更復(fù)雜的機(jī)制來(lái)區(qū)分不同類型的URC，但在此示例中我們省略了  

   // 假設(shè)一切正常，返回成功  

   return true;  

}  

int main(void) {  

   at_obj_t at;  

   // 初始化AT控制器（這里省略了具體的初始化代碼，因?yàn)樗蕾囉诰唧w的實(shí)現(xiàn)）  

   // ...  

   // 發(fā)送短信  

   const char *phone_number = "+1234567890";  

   const char *message = "Hello, this is a test SMS!";  

   if (send_sms(&at, phone_number, message)) {  

       printf("SMS sent successfully\n");  

   } else {  

       printf("Failed to send SMS\n");  

   }  

   // 清理資源，關(guān)閉連接等（此處省略）  

   // ...  

   return 0;  

}  

// 注意：上述代碼中的at_send_command是一個(gè)假設(shè)的函數(shù)，實(shí)際中你可能需要根據(jù)  

// AT命令解析模塊的具體實(shí)現(xiàn)來(lái)調(diào)用相應(yīng)的函數(shù)（如示例中的at_do_cmd或自定義的發(fā)送函數(shù)）。  

// 此外，UART的讀寫(xiě)函數(shù)也需要根據(jù)你的硬件平臺(tái)和驅(qū)動(dòng)進(jìn)行相應(yīng)的實(shí)現(xiàn)。

在這個(gè)完整的示例中，send_sms函數(shù)首先通過(guò)AT命令A(yù)T+CMGS開(kāi)始發(fā)送短信，并等待設(shè)備返回"OK"響應(yīng)。然后，它將短信內(nèi)容（后面跟著CTRL+Z作為結(jié)束符）通過(guò)UART發(fā)送出去。請(qǐng)注意，由于短信發(fā)送的結(jié)果通常是通過(guò)URC（如"+CMGS: <index>"后跟發(fā)送狀態(tài)）來(lái)通知的，因此send_sms函數(shù)在發(fā)送完短信內(nèi)容后并沒(méi)有立即等待特定的響應(yīng)。在實(shí)際應(yīng)用中，你可能需要實(shí)現(xiàn)一個(gè)機(jī)制來(lái)監(jiān)聽(tīng)和處理這些URC，以便了解短信是否成功發(fā)送。

此外，示例中的at_send_command函數(shù)是一個(gè)假設(shè)的函數(shù)，用于簡(jiǎn)化示例。在實(shí)際應(yīng)用中，你應(yīng)該使用AT命令解析模塊提供的實(shí)際函數(shù)（如at_do_cmd或類似的函數(shù)）來(lái)發(fā)送命令并處理響應(yīng)。同時(shí)，UART的讀寫(xiě)函數(shù)也需要根據(jù)你的硬件平臺(tái)和驅(qū)動(dòng)進(jìn)行相應(yīng)的實(shí)現(xiàn)。