在通信技術日益發(fā)展的今天，AT命令作為一種古老但依舊強大的通信協議，依然廣泛應用于調制解調器、移動通信設備、藍牙模塊、GPS模塊等多種設備中。AT命令（Attention Command）源于早期調制解調器制造商的引入，通過“AT”前綴吸引設備注意并執(zhí)行特定指令。隨著技術的演進，AT命令的應用范圍不斷擴大，其簡單而有效的特點使得它成為控制和配置設備的通用方式。本文將詳細介紹一種AT命令通信解析模塊的設計和實現，探討其在現代通信技術中的重要作用。
AT命令通信解析模塊概述
AT命令通信解析模塊是連接AT設備和控制系統之間的橋梁，它負責解析由控制系統發(fā)送的AT命令，并處理來自AT設備的響應。一個高效的AT命令通信解析模塊需要支持多種命令格式、錯誤處理、超時機制以及URC（Unsolicited Result Code，非請求結果碼）處理等功能。
軟件架構
該AT命令通信解析模塊支持裸機（at_chat）和操作系統（OS）兩個版本，分別適用于不同的應用場景。在裸機版本中，模塊使用鏈式隊列及異步回調方式處理AT命令收發(fā)，支持URC處理、自定義命令發(fā)送與解析作業(yè)。而在OS版本中，模塊則依賴于操作系統提供的信號量操作、任務延時等接口進行工作。
基本接口與功能
1. at_send_singlline
該接口用于發(fā)送單行AT命令，并默認等待“OK”響應，超時時間為3秒。如果命令執(zhí)行成功，將返回成功響應；否則，返回錯誤響應或超時信息。
2. at_send_multiline
該接口支持發(fā)送多行AT命令，同樣默認等待“OK”響應，超時時間為3秒。多行命令通常用于執(zhí)行復雜操作，如設置網絡參數等。
3. at_do_cmd
該接口允許用戶自定義發(fā)送格式與接收匹配串，提供更高的靈活性。用戶可以根據需要，定義復雜的命令序列和期望的響應格式。
4. at_do_work
適用于發(fā)送組合命令，如發(fā)送短信或進行網絡連接等需要等待特定提示符的操作。通過該接口，用戶可以自定義發(fā)送與接收解析邏輯，以適應不同設備的特殊需求。
設計與實現
1. AT控制器與通信適配器
AT控制器是該模塊的核心，負責維護命令的執(zhí)行狀態(tài)、處理URC等。通信適配器則負責與AT設備的物理連接，包括數據的發(fā)送和接收。適配器接口通常包括write（發(fā)送數據）、read（讀取數據）和error（錯誤處理）等函數。
2. 作業(yè)項管理
模塊使用鏈式隊列管理作業(yè)項，包括空閑鏈表和就緒鏈表。每個作業(yè)項代表一個待執(zhí)行的AT命令，包括命令類型、狀態(tài)、參數等信息。命令執(zhí)行完畢后，作業(yè)項將被回收至空閑鏈表，以便復用。
3. URC處理
URC是AT設備主動發(fā)送的非請求結果碼，用于通知控制系統某些事件的發(fā)生。模塊通過維護一個URC表，將收到的URC與表中的匹配項進行比對，并執(zhí)行相應的處理函數。
應用示例
以下是一個使用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ā)送短信內容...
return true;
}
在這個示例中，我們首先定義了URC表和緩沖區(qū)，并初始化了AT控制器和通信適配器。隨后，我們實現了一個send_sms函數，該函數利用AT命令通信解析模塊來發(fā)送短信。以下是send_sms函數以及后續(xù)處理短信發(fā)送內容的完整示例：
c
#include <string.h>
#include <stdbool.h>
#include "at_parser.h" // 假設這是AT命令解析模塊的頭文件
// 假設的UART讀寫函數聲明
extern int uart_write(const void *data, size_t size);
extern int uart_read(void *data, size_t size, unsigned int timeout_ms);
// URC處理函數，處理短信發(fā)送成功的URC
static void sms_sent_handler(const char *urc) {
// 這里可以添加處理邏輯，比如打印日志、更新狀態(tài)等
printf("SMS sent successfully: %s\n", urc);
}
// 發(fā)送短信的函數
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"響應，超時3秒
// 第一步：發(fā)送AT+CMGS命令以開始發(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ā)送短信內容（注意：內容后需要添加CTRL+Z（0x1A）作為結束符）
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;
}
// 注意：在某些情況下，可能不需要再次等待響應，因為設備可能會直接通過URC通知發(fā)送結果
// 但為了示例完整性，這里假設我們還需要檢查是否有錯誤發(fā)生（雖然這不是標準的做法）
// （可選）等待可能的錯誤響應或其他URC
// 這里可能需要一個更復雜的機制來區(qū)分不同類型的URC，但在此示例中我們省略了
// 假設一切正常，返回成功
return true;
}
int main(void) {
at_obj_t at;
// 初始化AT控制器（這里省略了具體的初始化代碼，因為它依賴于具體的實現）
// ...
// 發(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");
}
// 清理資源，關閉連接等（此處省略）
// ...
return 0;
}
// 注意：上述代碼中的at_send_command是一個假設的函數，實際中你可能需要根據
// AT命令解析模塊的具體實現來調用相應的函數（如示例中的at_do_cmd或自定義的發(fā)送函數）。
// 此外，UART的讀寫函數也需要根據你的硬件平臺和驅動進行相應的實現。
在這個完整的示例中，send_sms函數首先通過AT命令AT+CMGS開始發(fā)送短信，并等待設備返回"OK"響應。然后，它將短信內容（后面跟著CTRL+Z作為結束符）通過UART發(fā)送出去。請注意，由于短信發(fā)送的結果通常是通過URC（如"+CMGS: <index>"后跟發(fā)送狀態(tài)）來通知的，因此send_sms函數在發(fā)送完短信內容后并沒有立即等待特定的響應。在實際應用中，你可能需要實現一個機制來監(jiān)聽和處理這些URC，以便了解短信是否成功發(fā)送。
此外，示例中的at_send_command函數是一個假設的函數，用于簡化示例。在實際應用中，你應該使用AT命令解析模塊提供的實際函數（如at_do_cmd或類似的函數）來發(fā)送命令并處理響應。同時，UART的讀寫函數也需要根據你的硬件平臺和驅動進行相應的實現。
下載文檔
