cmd-parser命令解析器使用指南

最新推荐文章于 2024-09-09 09:47:31 发布

窦育培

最新推荐文章于 2024-09-09 09:47:31 发布

阅读量231

点赞数 4

本文链接：https://blog.csdn.net/gitblog_00968/article/details/141250510

版权

cmd-parser命令解析器使用指南

cmd-parser一个非常简单好用的命令解析器，占用资源极少极少，采用哈希算法超快匹配命令！项目地址:https://gitcode.com/gh_mirrors/cm/cmd-parser

项目介绍

cmd-parser 是一个极为轻量级的命令解析器，由作者 jiejie 开发并遵循 Apache-2.0 开源许可协议。该工具专为资源有限的环境设计，如嵌入式系统，采用高效的哈希算法进行命令的快速匹配。这极大地优化了传统的字符串匹配过程，将时间复杂度从 O(m*n) 降低到了 O(n)，提高了命令处理的效率。适用于通过串口或其他控制界面向设备发送控制命令的场景，比如在物联网设备、智能家居控制器等设备的固件开发中。

项目快速启动

安装与集成

克隆项目:

git clone https://github.com/jiejieTop/cmd-parser.git

集成到工程:
- 对于基于STM32或其他MCU的项目，首先确保你有一个裸机工程或RTOS工程。
- 将 cmd-parser 文件夹复制到你的工程目录中。
- 在你的IDE中（如Keil或STM32CubeIDE），将 cmd.c 和 cmd.h 添加到项目构建路径。
- 设置编译器路径以包含 cmd.h。

示例代码

初始化cmd-parser: 在 main.c 中引入必要的头文件并初始化：

#include "cmd.h"

char recv_buf[6] = {0}; // 初始化接收缓冲区

int main(void) {
    // ...
    cmd_init(); // 初始化命令解析器

    HAL_UART_Receive_IT(&huart1, (uint8_t*)recv_buf, 5); // 启用串口接收中断
    // ...
}

注册命令: 在合适的位置注册命令及其回调函数：

void led_on_cmd(void) { printf("LED On\n"); }
void led_off_cmd(void) { printf("LED Off\n"); }

REGISTER_CMD(ledon, led_on_cmd);
REGISTER_CMD(ledof, led_off_cmd);

解析命令: 在串口中断处理函数中调用 cmd_parsing 来解析接收到的数据：

void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) {
    if(huart->Instance == USART1) {
        cmd_parsing((char*)recv_buf); // 解析命令
        HAL_UART_Receive_IT(huart, (uint8_t*)recv_buf, 5); // 重启接收中断
    }
}