别只会用help了！手把手教你定制自己的Uboot命令（基于U-Boot 2020.10源码）

weixin_30781775

318人浏览 · 2026-06-08 16:37:51

weixin_30781775 · 2026-06-08 16:37:51 发布

从零构建你的专属Uboot命令：源码级开发指南

在嵌入式开发领域，U-Boot作为开源的引导加载程序，其命令行接口的灵活性和可扩展性常常被开发者低估。大多数开发者仅满足于使用内置的 help 、 printenv 等基础命令，却忽视了Uboot允许开发者深度定制命令系统的能力。本文将带你深入Uboot 2020.10源码，从零开始构建完全属于你自己的Uboot命令，无论是简单的调试工具还是复杂的硬件控制接口，都能通过这套方法实现。

1. Uboot命令系统架构解析

Uboot的命令系统采用模块化设计，核心代码位于 cmd/ 目录下。每个命令本质上都是一个独立的结构体实例，通过 U_BOOT_CMD 宏注册到系统中。这个结构体包含命令名称、最大参数个数、帮助信息以及最重要的命令执行函数指针。

// 典型命令定义示例（取自cmd/mem.c）
U_BOOT_CMD(
    md,     // 命令名
    3,      // 最大参数个数
    1,      // 是否可重复执行
    do_mem_md, // 实际执行函数
    "memory display", // 简短帮助
    "address count [# of objects] - display memory\n" // 详细帮助
);

命令系统的工作流程可分为三个阶段：

初始化阶段 ：Uboot启动时通过 initcall 机制自动注册所有编译包含的命令
解析阶段 ：用户输入的命令行被hush shell解析为令牌序列
执行阶段 ：根据命令名查找对应的处理函数并传入参数

提示：Uboot 2020.10默认使用hush shell作为解析器，相比旧版的simple parser支持更复杂的语法如环境变量替换、条件判断等。

2. 创建第一个自定义命令：Hello World

让我们从最简单的"hello"命令开始，展示完整的创建流程。首先在 cmd/ 目录下新建 hello.c ：

#include <common.h>
#include <command.h>

static int do_hello(struct cmd_tbl *cmdtp, int flag, 
                   int argc, char *const argv[])
{
    printf("Hello, Uboot Command World!\n");
    return 0;
}

U_BOOT_CMD(
    hello, 1, 1, do_hello,
    "Print a hello message",
    ""
);

接下来需要将这个新命令集成到编译系统中：

修改 cmd/Makefile ，添加编译条目：
```
obj-$(CONFIG_CMD_HELLO) += hello.o
```
在 include/config_cmd_all.h 中添加配置宏：
```
#define CONFIG_CMD_HELLO 1
```
或者通过menuconfig界面启用：
```
make menuconfig
```
在 Command line interface → Miscellaneous commands 下找到 hello command 并启用

编译并烧写到开发板后，在Uboot命令行输入 hello ，你将看到问候信息。这个简单例子展示了自定义命令的基本框架，接下来我们将增强它的实用性。

3. 进阶命令开发：参数解析与硬件交互

真实的Uboot命令往往需要处理参数并与硬件交互。让我们创建一个更实用的 led 命令，用于控制开发板上的LED灯。

3.1 带参数的命令实现

#include <common.h>
#include <command.h>
#include <asm/io.h>

#define LED_CTRL_REG 0x020E0068
#define LED_PIN_MASK (1 << 5)

static int do_led(struct cmd_tbl *cmdtp, int flag,
                 int argc, char *const argv[])
{
    if (argc != 2) {
        printf("Usage: led <on|off>\n");
        return 1;
    }

    uint32_t reg = readl(LED_CTRL_REG);
    
    if (strcmp(argv[1], "on") == 0) {
        reg |= LED_PIN_MASK;
    } else if (strcmp(argv[1], "off") == 0) {
        reg &= ~LED_PIN_MASK;
    } else {
        printf("Invalid argument: %s\n", argv[1]);
        return 1;
    }

    writel(reg, LED_CTRL_REG);
    return 0;
}

U_BOOT_CMD(
    led, 2, 1, do_led,
    "Control board LED",
    "on/off - Turn LED on or off"
);

3.2 参数解析技巧

Uboot提供了多种参数解析辅助函数：

simple_strtoul() ：字符串转无符号长整型
strict_strtoul() ：带错误检查的转换函数
getenv_ulong() ：从环境变量获取数值
cli_simple_process_macros() ：处理特殊字符序列

对于复杂参数，可以使用 argc 和 argv 进行手动解析，或者利用hush parser提供的更高级功能：

// 示例：解析数字参数
unsigned long addr;
if (strict_strtoul(argv[1], 16, &addr)) {
    printf("Invalid address: %s\n", argv[1]);
    return 1;
}

4. 将命令集成到Uboot构建系统

为了使自定义命令更加规范且易于维护，应该遵循Uboot的Kconfig构建系统规范。以下是完整步骤：

在 cmd/Kconfig 中添加配置选项：

config CMD_LED
    bool "led command"
    help
      This enables the 'led' command for controlling board LEDs.

更新 cmd/Makefile ：
```
obj-$(CONFIG_CMD_LED) += led.o
```
在板级配置文件中启用命令（如 include/configs/your_board.h ）：
```
#define CONFIG_CMD_LED 1
```

或者在menuconfig中交互式启用：

make menuconfig

导航至：

Command line interface → Hardware control commands → led command

这种集成方式使得命令的启用/禁用可以像官方命令一样灵活配置，也便于代码的移植和复用。

5. 调试与测试技巧

开发自定义命令时，有效的调试方法至关重要。以下是几种实用技巧：

5.1 早期调试方法

使用 printf 输出调试信息（注意Uboot的 printf 功能可能有限）
通过 md 命令查看内存状态
利用 gpio 命令测试硬件接口

5.2 常见问题排查表

问题现象	可能原因	解决方案
命令未显示	未正确注册	检查U_BOOT_CMD宏参数
执行无响应	函数未链接	确认Makefile配置正确
参数错误	解析逻辑错误	添加参数检查代码
硬件无反应	寄存器地址错误	核对硬件手册

5.3 自动化测试建议

虽然Uboot环境通常需要手动测试，但可以建立以下测试流程：

在QEMU中测试基本功能
在实际硬件上验证硬件相关命令
编写简单的测试脚本（通过串口工具发送命令）
使用 run 命令结合环境变量创建测试序列

# 示例测试序列
setenv test_cmds 'led on; sleep 1; led off; echo Test complete'
run test_cmds

6. 高级主题：命令组与条件命令

对于复杂的扩展需求，Uboot还支持更高级的命令组织方式：

6.1 创建命令组

当需要开发一组相关命令时，可以使用子命令模式：

static int do_led_set(struct cmd_tbl *cmdtp, int flag,
                     int argc, char *const argv[])
{
    // 实现led set子命令
}

static int do_led_get(struct cmd_tbl *cmdtp, int flag,
                     int argc, char *const argv[])
{
    // 实现led get子命令
}

U_BOOT_CMD_MKENT(set, 2, 1, do_led_set, "", "");
U_BOOT_CMD_MKENT(get, 1, 1, do_led_get, "", "");

static int do_led(struct cmd_tbl *cmdtp, int flag,
                 int argc, char *const argv[])
{
    struct cmd_tbl *cp;
    
    if (argc < 2)
        return CMD_RET_USAGE;
    
    cp = find_cmd_tbl(argv[1], led_sub, ARRAY_SIZE(led_sub));
    if (!cp)
        return CMD_RET_USAGE;
    
    return cp->cmd(cmdtp, flag, argc - 1, argv + 1);
}

U_BOOT_CMD(
    led, 3, 1, do_led,
    "LED control commands",
    "set <on|off> - Set LED state\n"
    "get - Get current LED state"
);

6.2 条件命令实现

有时命令的可用性需要依赖硬件配置或环境变量：

static int do_special(struct cmd_tbl *cmdtp, int flag,
                     int argc, char *const argv[])
{
    if (!env_get("enable_special")) {
        printf("Command disabled\n");
        return 1;
    }
    // 命令实现...
}

这种模式特别适合开发调试命令或硬件特定功能。