文章目录

- 一、核心设计思想
- 二、命令系统实现详解（含完整注释）
- - 1. 示例命令函数实现
  - 2. 初始化命令系统
  - 3. 命令注册函数
  - 4. 命令查找函数
  - 5. 命令执行函数
- 三、命令结构体（cmd\_t）
- 四、运行效果示例
- 五、小结

在嵌入式系统的命令行控制台（Shell）中，命令解析模块扮演着关键角色。它负责：

接收字符串命令；
拆分命令参数；
查找匹配的命令函数；
调用命令对应的处理函数。

本文基于 cmd.c 实现讲解一个简单而高效的命令注册与执行框架。

一、核心设计思想

命令系统基于以下数据结构和接口实现：

命令表（cmd_table）：保存所有注册命令；
命令函数指针（cmd_func_t）：指向具体执行逻辑；
cmd_execute()：接收命令字符串，拆分参数并调用对应命令函数；
cmd_register()：注册命令；
cmd_find()：通过命令名查找。

二、命令系统实现详解（含完整注释）

#include "cmd.h"
#include <string.h>
#include <stdio.h>
#include <stdlib.h>#define CMD_TABLE_MAX 32  // 最多支持 32 个命令// 命令表：用于保存所有注册的命令
static cmd_t cmd_table[CMD_TABLE_MAX];
static int cmd_count = 0; // 当前注册命令数

1. 示例命令函数实现

// help 命令：打印帮助信息
int cmd_help(int argc, char *argv[])
{printf("help: Show this message\r\n");// 可扩展：遍历 cmd_table 打印所有命令和说明return 0;
}// echo 命令：回显输入参数
int cmd_echo(int argc, char *argv[])
{for (int i = 1; i < argc; i++){printf("%s ", argv[i]);}printf("\r\n");return 0;
}

2. 初始化命令系统

// 初始化命令系统：注册内置命令
void cmd_init(void)
{cmd_register("help", cmd_help, "Show help");cmd_register("echo", cmd_echo, "Echo args");
}

3. 命令注册函数

// 注册命令：添加命令名、函数指针和帮助信息到命令表
int cmd_register(const char *name, cmd_func_t func, const char *help)
{if (cmd_count >= CMD_TABLE_MAX)return -1; // 命令表满了，注册失败// 复制命令名到表项（限制最大长度）strncpy(cmd_table[cmd_count].name, name, CMD_NAME_LEN - 1);cmd_table[cmd_count].name[CMD_NAME_LEN - 1] = '\0';// 设置函数指针和帮助信息cmd_table[cmd_count].func = func;cmd_table[cmd_count].help = help;cmd_count++; // 更新命令数量return 0;
}

4. 命令查找函数

// 查找命令：通过命令名在命令表中查找
cmd_t *cmd_find(const char *name)
{for (int i = 0; i < cmd_count; i++){if (strcmp(cmd_table[i].name, name) == 0)return &cmd_table[i];  // 找到并返回指针}return NULL;  // 未找到
}

5. 命令执行函数

// 执行命令行字符串：拆分参数并调用命令函数
int cmd_execute(const char *cmdline)
{if (cmdline == NULL || *cmdline == '\0')return -1;  // 空命令行，忽略// 使用 buf 保存一份可修改的命令行char buf[128];strncpy(buf, cmdline, sizeof(buf) - 1);buf[sizeof(buf) - 1] = '\0';char *argv[CMD_MAX_ARGS];  // 参数数组int argc = 0;// 使用 strtok 拆分参数char *token = strtok(buf, " ");while (token && argc < CMD_MAX_ARGS){argv[argc++] = token;token = strtok(NULL, " ");}if (argc == 0)return -1;  // 没有有效参数// 查找对应命令cmd_t *cmd = cmd_find(argv[0]);if (!cmd){printf("Unknown command: %s\r\n", argv[0]);return -1;  // 未知命令}// 调用命令函数，传递 argc 和 argvreturn cmd->func(argc, argv);
}

三、命令结构体（cmd_t）

// cmd.h 中结构定义示例
#define CMD_NAME_LEN  16
#define CMD_MAX_ARGS  8typedef int (*cmd_func_t)(int argc, char *argv[]); // 命令处理函数类型typedef struct {char name[CMD_NAME_LEN];   // 命令名称cmd_func_t func;           // 命令处理函数const char *help;          // 帮助字符串
} cmd_t;