cAT AT 命令解析器基础示例
源码位置: samples/subsys/cAT/basic 查看源码
功能说明
演示如何使用 cAT 库创建一个简单的 AT 命令接口。通过 UART 接收命令、解析执行，并返回结果。
本示例包含的 AT 命令可用于查询系统状态、控制设备以及管理参数。
硬件连接
UART1_TX (PB2): 传输数据，连接到 USB-UART 转接器的 RX
UART1_RX (PB3): 接收数据，连接到 USB-UART 转接器的 TX
连接到 PC 串口工具，配置为 115200, 8N1, 无流控
示例内容
本示例演示以下功能：
初始化 cAT 解析器并绑定 UART 通信接口
通过 UART 接收 AT 命令并实时解析
查询固件版本（
AT+VERSION?）控制 LED 状态（
AT+LED=<state>）读取和设置 GPIO 引脚（
AT+GPIO=<pin>,<value>）执行设备重置（
AT+RESET）列出所有可用命令（
AT+HELP）
编译
重要提示：在编译前，请先确认您使用的开发板型号。SDK 目前支持以下开发板：
arcs_evb - ARCS EVB 评估板
arcs_mini - ARCS Mini 开发板
根据您的开发板型号，选择对应的编译命令：
在示例目录下执行编译:
# 使用 arcs_evb 开发板
./build.sh -C -DBOARD=arcs_evb
# 或使用 arcs_mini 开发板
./build.sh -C -DBOARD=arcs_mini
Note
如果在 SDK 根目录执行，需要指定示例路径:
# 使用 arcs_evb 开发板
./build.sh -C -S samples/<示例路径> -DBOARD=arcs_evb
# 或使用 arcs_mini 开发板
./build.sh -C -S samples/<示例路径> -DBOARD=arcs_mini
Note
确保已安装对应的工具链。
烧录
编译完成后，使用 SDK tools 目录下的 cskburn 工具烧录固件:
./tools/burn/cskburn -s /dev/ttyUSB0 -b 3000000 0x0 build/arcs.bin -C arcs
Note
烧录参数说明：
-s /dev/ttyUSB0：串口设备路径，需要根据实际情况修改 - Linux 系统：通常是/dev/ttyUSB0或/dev/ttyACM0- 可通过ls /dev/tty*命令查看可用串口设备 - 不同开发板或 USB 转串口芯片可能使用不同的设备名-b 3000000：烧录波特率（3Mbps）0x0：烧录起始地址build/arcs.bin：编译生成的固件路径-C arcs：芯片类型
注意事项：
确保开发板已正确连接到电脑
如果无法识别串口设备，请检查 USB 连接线是否正常，或尝试其他 USB 端口
预期输出
系统启动输出：
[I][cat_example] cAT AT Command Parser Example
[I][cat_example] =============================
[I][cat_uart] cAT UART adapter initialized on uart1 @ 115200 baud
[I][cat_example] AT command parser ready on uart1
[I][cat_example] Try commands: AT+VERSION?, AT+LED=1, AT+HELP
[I][cat_example] Supported AT commands:
[I][cat_example] +VERSION - Firmware version
[I][cat_example] +LED - LED control (0=off, 1=on)
[I][cat_example] +GPIO - GPIO control (pin, value)
[I][cat_example] +RESET - Reset device
[I][cat_example] +HELP - List all commands
[I][cat_uart] cAT UART task started
发送 AT+VERSION? 后的输出：
+VERSION: 1.0.0
OK
发送 AT+LED=1 后的输出：
[I][cat_example] LED state set to: 1
OK
发送 AT+GPIO=5,1 后的输出：
[I][cat_example] GPIO 5 set to: 1
OK
发送 AT+HELP 后的输出：
+HELP: +VERSION(RO),+LED(RW),+GPIO(RW),+RESET(RUN),+HELP(RUN)
OK
核心 API
API |
说明 |
|---|---|
|
初始化 UART 适配器 |
|
启动后台处理服务（自动初始化 cAT 解析器） |
|
停止后台处理服务 |
|
清理 UART 适配器 |
|
发送非请求响应（URC） |
关键代码
初始化 UART 适配器和启动服务：
/* 配置 UART 适配器 */
cat_uart_config_t uart_config = {
.uart_device_name = "uart1",
.baudrate = 115200,
};
/* 初始化适配器 */
cat_uart_adapter_t *adapter = cat_uart_adapter_init(&uart_config);
/* 启动后台处理任务（自动初始化 cAT 解析器） */
cat_uart_adapter_start_service(adapter, &cat, &cat_desc);
定义 AT 命令和变量：
/* LED 控制命令的变量 */
static int32_t led_state = 0;
static struct cat_variable led_vars[] = {
{
.name = "state",
.type = CAT_VAR_INT_DEC,
.data = &led_state,
.data_size = sizeof(led_state),
.access = CAT_VAR_ACCESS_READ_WRITE,
}
};
/* LED 命令定义 */
static struct cat_command commands[] = {
{
.name = "+LED",
.description = "LED control (0=off, 1=on)",
.write = cmd_led_write,
.read = cmd_led_read,
.var = led_vars,
.var_num = sizeof(led_vars) / sizeof(led_vars[0]),
},
/* 其他命令... */
};
命令处理器实现：
/* LED 写入处理器 - 处理 AT+LED=<state> */
static cat_return_state cmd_led_write(const struct cat_command *cmd,
const uint8_t *data, const size_t data_size,
const size_t args_num)
{
if (args_num < 1) {
return CAT_RETURN_STATE_ERROR;
}
LOGI("LED state set to: %d", (int)led_state);
if (led_state < 0 || led_state > 1) {
LOGE("Invalid LED state: %d", (int)led_state);
return CAT_RETURN_STATE_ERROR;
}
return CAT_RETURN_STATE_OK;
}
/* LED 读取处理器 - 处理 AT+LED? */
static cat_return_state cmd_led_read(const struct cat_command *cmd,
uint8_t *data, size_t *data_size,
const size_t max_data_size)
{
return CAT_RETURN_STATE_DATA_OK;
}
注意事项
UART 连接: 示例需要通过 UART 通信，确保硬件连接正确，波特率设置为 115200
串口工具配置: 使用任何串口调试工具（如 PuTTY、Minicom 或 VS Code Serial Monitor）连接，参数为 115200, 8N1, 无流控
命令格式: AT 命令必须以
\r\n结尾，写入命令后需按 Enter 键发送变量访问:
CAT_VAR_ACCESS_READ_WRITE: 支持读写CAT_VAR_ACCESS_READ_ONLY: 仅读CAT_VAR_ACCESS_WRITE_ONLY: 仅写
返回值检查: 所有 API 调用都应检查返回值，处理可能的错误情况
线程安全: cAT 解析器支持多任务环境，互斥锁由适配器自动管理
命令参考
命令 |
说明 |
示例 |
|---|---|---|
|
查询固件版本 |
|
|
设置 LED 状态 |
|
|
查询 LED 状态 |
|
|
设置 GPIO |
|
|
查询 GPIO（需实现） |
|
|
重置设备 |
|
|
列出所有命令 |
|