NXP Real-time Edge BareMetal开发实战：从环境搭建到外设驱动详解

1. 项目概述与核心价值

在嵌入式开发领域，尤其是工业控制、汽车电子和高端网络设备中，我们常常面临一个核心矛盾：Linux等通用操作系统提供了丰富的生态和便捷的开发体验，但其非确定性的任务调度和相对较高的中断延迟，使其难以满足某些对实时性要求严苛的场景。这时，BareMetal（裸机）编程模式就成为了解决问题的关键利器。它意味着你的代码直接运行在硬件之上，没有操作系统的抽象层，从而能够实现对处理器和外设的绝对控制，达到微秒级甚至纳秒级的响应精度。NXP推出的Real-time Edge软件框架，正是为了弥合高性能Linux与硬实时需求之间的鸿沟而生，它允许开发者在一个多核SoC上，让部分核心运行Linux处理复杂业务，而让其他核心运行BareMetal程序来处理实时任务。

最近，我在一个基于NXP LS1028A处理器的工业网关项目中，就深度使用了这套框架。项目要求主核心运行Linux处理网络协议栈和Web管理界面，而一个从核心必须运行BareMetal程序，以确定性的时序控制多个高速数字IO和同步采集传感器数据。从官方零散的文档和代码片段开始摸索，到最终稳定运行，整个过程充满了挑战也收获颇丰。本文就将我在这段时间的实践，从环境搭建、镜像编译，到最核心的外设驱动开发，进行一次系统性的梳理和分享。无论你是刚开始接触NXP多核实时开发，还是已经在其他平台上做过裸机开发想迁移过来，相信这些踩过的坑和总结的经验都能让你少走弯路。

2. 开发环境搭建与硬件准备

在开始敲代码之前，一个稳定可靠的开发环境是成功的基石。NXP Real-time Edge BareMetal开发主要涉及宿主机（Host）的交叉编译环境搭建，以及目标板的硬件连接。

2.1 宿主机开发环境配置

我的宿主机是一台运行Ubuntu 20.04 LTS的PC。NXP官方推荐使用Yocto项目来构建整个系统镜像，这包括了Linux根文件系统和BareMetal镜像。因此，首先需要确保宿主机满足Yocto构建的基本要求。

基础依赖安装：打开终端，执行以下命令安装必备工具。这里特别要注意磁盘空间，建议预留至少100GB，因为构建过程中会下载大量源码和缓存。

sudo apt-get update sudo apt-get install gawk wget git-core diffstat unzip texinfo gcc-multilib \ build-essential chrpath socat cpio python3 python3-pip python3-pexpect \ xz-utils debianutils iputils-ping python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev \ pylint3 xterm python3-subunit mesa-common-dev zstd liblz4-tool

工具链准备：Real-time Edge框架已经集成了所需的交叉编译工具链。当你通过source real-time-edge-setup-env.sh脚本初始化构建环境时，它会自动设置好所有环境变量。因此，我们无需手动下载和配置独立的ARM工具链，这是相比传统裸机开发的一个便利之处。

源码获取：我们需要获取两个核心仓库：用于构建BareMetal镜像的U-Boot源码，以及用于构建完整系统镜像的Yocto层。

# 1. 获取用于BareMetal的U-Boot源码（备用，用于独立编译） git clone https://github.com/real-time-edge-sw/real-time-edge-uboot.git cd real-time-edge-uboot git checkout Real-Time-Edge-v2.2-baremetal-202203 # 2. 获取Real-time Edge Yocto项目源码（主要构建方式） git clone https://github.com/real-time-edge-sw/yocto-real-time-edge.git cd yocto-real-time-edge

注意：网络环境是第一个“拦路虎”。由于需要从git.yoctoproject.org等站点拉取大量元数据，务必保证宿主机网络通畅。如果遇到下载缓慢或失败，可以尝试配置本地代理，或者使用一些国内镜像源替换DL_DIR中的特定URL，但这需要一定的Yocto经验。

2.2 目标板硬件连接详解

硬件连接的正确性是调试的起点。根据目标板型号不同，连接方式有细微差别，但核心原则是：为主核心（Core 0，通常运行Linux）和从核心（Core 1/2/3...，运行BareMetal）分别准备独立的串口控制台。

对于LS1028ARDB、LX2160ARDB等板卡：

• 主核心串口：连接至板卡上的UART1接口。这个串口将输出Linux内核的启动信息，并提供Linux系统的Shell。
• 从核心串口：连接至板卡上的UART2接口。这个串口专门用于输出BareMetal应用程序的printf日志和调试信息。这是监听BareMetal程序运行状态的生命线。
• SAI功能特殊设置：如果你的应用涉及音频（使用SAI接口），在LS1028ARDB上需要将拨码开关SW5_8设置为“ON”位置，以正确配置相关引脚复用。

对于LS1021A-IoT板卡：

• 主核心串口：连接至USB0/K22端口，它对应UART0。
• 从核心串口：连接需要一点小技巧。你需要一根杜邦线，将扩展接口J8的第7针（GND）与J17的第1针（Uart1_SIN）、第2针（Uart1_SOUT）连接起来，从而将LPUART信号引出作为UART1使用。具体连接关系如下表所示：

• GPIO测试连接：如果你想测试后续的GPIO驱动示例，需要用杜邦线短接J502.3(GPIO24) 和J502.5(GPIO25) 两个引脚，形成一个回环测试。

实操心得：强烈建议使用USB转TTL串口模块，并在宿主机上使用screen或minicom等工具同时打开两个串口终端窗口。将两个窗口并排显示，可以清晰地对比Linux核心与BareMetal核心的启动顺序和日志，对于理解双核启动流程和排查初期问题有巨大帮助。记得将串口波特率统一设置为115200。

3. BareMetal镜像的两种构建之道

构建BareMetal镜像有两种主流方法：一种是基于U-Boot源码的独立编译，灵活快速，适合驱动开发和单元测试；另一种是集成到Real-time Edge Yocto项目中统一构建，能生成包含Linux和BareMetal的完整系统镜像，适合产品集成与发布。

3.1 方法一：基于U-Boot源码独立编译

这种方法直接利用为Real-time Edge修改过的U-Boot仓库进行编译，生成纯粹的u-boot.bin（BareMetal镜像）。它不依赖庞大的Yocto构建系统，速度极快，非常适合在开发初期频繁修改和测试BareMetal应用程序。

步骤详解：

1. 获取并切换源码：如前所述，克隆特定标签的real-time-edge-uboot仓库。
2. 配置交叉编译环境：虽然Yocto环境已集成工具链，但独立编译需要手动导出。你可以从Yocto构建目录的tmp/sysroots中定位工具链路径，或使用NXP官方发布的独立工具链。假设工具链路径为/opt/fsl-imx-xwayland/6.1-snapshot/environment-setup-aarch64-poky-linux，则配置命令如下：

   source /opt/fsl-imx-xwayland/6.1-snapshot/environment-setup-aarch64-poky-linux

3. 选择配置并编译：进入U-Boot源码根目录，根据你的目标板选择对应的defconfig文件进行编译。编译命令是一个标准的两步流程：

   # 以 LS1028ARDB 为例 make ls1028ardb_bm_defconfig # 加载默认配置 make -j$(nproc) # 开始编译，-j参数利用多核加速

   其他常见板卡的配置命令如下：

   # i.MX 8M Mini EVK make imx8mm_evk_bm_defconfig && make # i.MX 8M Plus EVK make imx8mp_evk_bm_defconfig && make # LS1043ARDB make ls1043ardb_bm_defconfig && make # LX2160ARDB (注意输出文件不同) make lx2160ardb_bm_defconfig && make # 生成 u-boot-dtb.bin

4. 获取产物：编译成功后，在源码根目录下会生成u-boot.bin文件（对于LX2160ARDB则是u-boot-dtb.bin）。这个文件就是可以在从核心上运行的BareMetal镜像。

注意事项：独立编译出的u-boot.bin仅包含BareMetal部分。要运行它，你需要一个已经能启动到U-Boot命令行的主核心（Linux尚未启动）。通常是通过TFTP网络加载，或者将其打包进一个专门的Flash分区，由主核心的U-Boot通过cpu start命令去加载它。

3.2 方法二：通过Yocto项目集成构建

这是官方推荐的、用于生成最终发布镜像的方式。Yocto会构建一个完整的系统，包括Linux内核、根文件系统，并将BareMetal镜像作为资源文件打包进去，最终生成一个可直接烧录到SD卡或eMMC的.wic镜像。

构建流程：

1. 初始化构建环境：进入yocto-real-time-edge目录，通过source命令初始化针对特定机器和BareMetal发行版的构建环境。这个步骤会创建并配置一个独立的构建目录（build-*）。

   # 以构建LS1028ARDB的BareMetal镜像为例 DISTRO=nxp-real-time-edge-baremetal MACHINE=ls1028ardb source real-time-edge-setup-env.sh -b build-ls1028ardb-bm

   执行后，你的终端提示符会发生变化，并自动切换到新建的build-ls1028ardb-bm目录。
2. 启动构建过程：执行bitbake命令开始构建核心镜像。

   bitbake nxp-image-real-time-edge

   这个过程会持续较长时间（首次构建可能需要数小时），因为它需要从网络下载所有软件包的源码并从头编译。
3. 获取最终镜像：构建成功后，最终的系统镜像位于tmp/deploy/images/<machine>/目录下，例如对于LS1028ARDB：

   ls tmp/deploy/images/ls1028ardb/nxp-image-real-time-edge-ls1028ardb.wic.bz2

   这是一个经过压缩的磁盘镜像文件。

镜像烧录与启动：

1. 将SD卡插入宿主机，使用lsblk命令确认SD卡设备名（例如/dev/sdb）。
2. 解压并烧录镜像：

   bzip2 -d nxp-image-real-time-edge-ls1028ardb.wic.bz2 sudo dd if=./nxp-image-real-time-edge-ls1028ardb.wic of=/dev/sdb bs=1M status=progress

   警告：of=参数后的设备名务必确认正确，写错会导致宿主机磁盘数据丢失。bs=1M和status=progress参数能加速烧录并显示进度。
3. 将烧录好的SD卡插入目标板，上电启动。系统会自动完成引导：主核心启动Linux，并从核心启动BareMetal镜像。你可以在两个串口终端上分别看到它们的启动日志。

踩坑记录：Yocto构建失败最常见的原因是网络问题导致下载超时，或是宿主机的某些依赖包版本不兼容。务必仔细阅读构建开始时输出的错误信息。一个实用的技巧是，可以先尝试构建一个基础镜像（如core-image-minimal）来验证Yocto环境是否正常，再构建更复杂的nxp-image-real-time-edge。

4. BareMetal应用程序开发实战

当镜像成功启动，我们就进入了最核心的环节——开发自己的BareMetal应用程序。Real-time Edge BareMetal框架基于U-Boot，这意味着我们可以直接使用U-Boot中已经移植好的大量驱动框架和API，这极大地降低了裸机开发的难度。

4.1 应用程序入口与框架

所有BareMetal应用的入口都在<uboot-path>/app/app.c文件的core1_main()函数中。如果你通过Yocto构建，这个文件位于构建目录的<build-dir>/tmp/work/<machine>-poky-linux/u-boot-real-time-edge/<version>/git/app/路径下。

基础应用结构：

// app.c 示例 #include <common.h> #include <asm/io.h> extern void test_gpio(void); extern void test_i2c(void); extern void test_irq_init(void); void core1_main(void) { printf("BareMetal Application Start on Core 1!\n"); // 在此处调用你的各个功能模块 test_gpio(); test_i2c(); test_irq_init(); // 主循环 while (1) { // 执行周期性任务或事件处理 // udelay(1000000); // 例如：延时1秒 } }

你需要做的，就是在core1_main中组织你的任务逻辑。框架已经初始化了CPU、内存、时钟和必要的硬件，你可以直接调用各类驱动API。

4.2 关键外设驱动API详解与实战

下面，我将结合代码示例，深入讲解几个最常用外设的驱动开发要点。

4.2.1 GPIO驱动：数字世界的开关

GPIO是控制最简单数字设备（如LED、按键、继电器）的基石。框架提供的API与Linux内核的GPIO子系统类似，非常易用。

核心API实战：

// test_gpio.c 示例 (以LS1021A-IoT为例，连接GPIO24和GPIO25) #include <asm-generic/gpio.h> #include <common.h> void test_gpio(void) { int ret; int value_read; // 1. 申请GPIO资源 ret = gpio_request(25, "gpio25_out"); if (ret) { printf("Failed to request GPIO 25\n"); return; } ret = gpio_request(24, "gpio24_in"); if (ret) { printf("Failed to request GPIO 24\n"); gpio_free(25); return; } // 2. 设置方向：25输出，24输入 ret = gpio_direction_output(25, 0); // 初始输出低电平 if (ret < 0) { printf("Failed to set GPIO 25 as output\n"); goto free_gpio; } ret = gpio_direction_input(24); if (ret < 0) { printf("Failed to set GPIO 24 as input\n"); goto free_gpio; } // 3. 进行回环测试：输出高/低，并读取输入值 gpio_set_value(25, 1); // 设置GPIO25为高电平 udelay(10); // 短暂延时，等待信号稳定 value_read = gpio_get_value(24); printf("GPIO25 set HIGH, GPIO24 reads: %d\n", value_read); gpio_set_value(25, 0); // 设置GPIO25为低电平 udelay(10); value_read = gpio_get_value(24); printf("GPIO25 set LOW, GPIO24 reads: %d\n", value_read); free_gpio: // 4. 释放GPIO资源 gpio_free(25); gpio_free(24); }

避坑指南：

1. 引脚复用：在调用gpio_request之前，必须确保该GPIO引脚没有被其他功能（如I2C、SPI）复用。引脚复用通常在U-Boot的板级初始化代码中完成。如果你需要更改，需要修改对应板卡的设备树（DTS）或板级文件中的pinmux配置，并重新编译U-Boot。
2. 电平标准：注意开发板的GPIO电平是3.3V还是1.8V，连接外部设备时需确保电平兼容，否则可能损坏芯片。
3. 去抖动：当GPIO作为输入读取按键时，机械按键会产生抖动，需要在软件中实现去抖动逻辑，例如连续多次采样确定状态。

4.2.2 I2C驱动：与传感器和编解码器对话

I2C是连接各类传感器、EEPROM、音频编解码器的常用总线。框架的I2C API抽象得很好，使用流程清晰。

核心API实战：

// test_i2c.c 示例 (读取音频编解码器SGTL5000的芯片ID) #include <i2c.h> #include <common.h> #define I2C_BUS 0 // I2C总线编号，需根据板卡原理图确定 #define SGTL5000_ADDR 0x2A // SGTL5000的7位I2C地址 void test_i2c(void) { int ret; u8 chip_id; // 1. 选择I2C总线 ret = i2c_set_bus_num(I2C_BUS); if (ret) { printf("Failed to set I2C bus %d\n", I2C_BUS); return; } // 2. 从设备寄存器0x00读取一个字节（芯片ID） ret = i2c_read(SGTL5000_ADDR, 0x00, 1, &chip_id, 1); if (ret) { printf("I2C read failed at addr 0x%02x\n", SGTL5000_ADDR); return; } printf("SGTL5000 Chip ID: 0x%02x\n", chip_id); // SGTL5000的芯片ID固定为0xA0 if (chip_id == 0xa0) { printf("[OK] I2C test passed.\n"); } else { printf("[FAIL] Unexpected chip ID.\n"); } // 3. 示例：向寄存器0x08（模拟音频控制）写入0x10 u8 reg_val = 0x10; ret = i2c_write(SGTL5000_ADDR, 0x08, 1, ®_val, 1); if (ret) { printf("I2C write failed.\n"); } }

排查技巧：

1. 总线与地址：最常遇到的问题是无法探测到设备。首先用示波器或逻辑分析仪检查SCL和SDA线上是否有波形，确认物理连接。其次，在U-Boot命令行下使用i2c probe命令扫描总线，确认设备地址是否正确，以及总线是否使能。
2. 确认板卡上拉电阻是否正常（通常4.7kΩ）。
3. 时序问题：如果读写不稳定，可能是时序不匹配。但U-Boot的I2C驱动通常已经适配好，除非你外接了特殊设备。可以尝试在板级配置中调整CONFIG_SYS_I2C_SPEED和CONFIG_SYS_I2C_SLAVE等宏定义。

4.2.3 中断（IRQ）与核间通信（IPI）

在实时系统中，中断是响应外部事件的关键。BareMetal框架使用ARM GIC（通用中断控制器）来管理中断，并提供了SGI（软件生成中断）用于核间通信。

核心API实战：

// test_irq_init.c 示例 #include <asm/interrupt-gic.h> #include <common.h> static void my_sgi_handler(int irq_num) { printf("SGI Interrupt %d received on core 1!\n", irq_num); } static void my_hardware_irq_handler(int irq_num) { printf("Hardware IRQ %d triggered.\n", irq_num); // 这里需要清除具体外设的中断标志位 } void test_irq_init(void) { // 1. 注册一个SGI中断处理函数 (ID 0-15) gic_irq_register(5, my_sgi_handler); // 使用SGI ID 5 printf("SGI IRQ handler registered for ID 5.\n"); // 2. 注册一个硬件中断处理函数 (例如外部GPIO中断，ID > 31) // 假设某个GPIO中断的硬件ID是 101 gic_irq_register(101, my_hardware_irq_handler); gic_set_target(1 << 1, 101); // 设置该中断发送给核心1 (掩码 0x02) gic_set_type(101); // 设置中断类型（具体参数需参考手册，通常为边沿或电平触发） printf("Hardware IRQ 101 registered and targeted to core 1.\n"); // 3. 触发一个SGI中断（例如从核心0触发到核心1） // 注意：此函数通常在发送中断的核心上调用。这里仅为演示。 // core_mask: 0x02 表示核心1 (bit1) // gic_set_sgi(0x02, 5); // 4. 使能中断接收（通常全局中断在框架初始化时已开启） }

重要提示：

• SGI保留项：SGI中断ID 8被框架内部的ICC（核间通信）模块保留，请勿使用。
• i.MX 8M系列：对于i.MX 8M Mini和Plus平台，SGI中断ID 9被用于核间通信。
• 硬件中断：使用硬件中断前，必须在外设本身（如GPIO控制器、定时器）中配置并使能中断源，并在GIC中正确配置目标核心和触发类型。清除中断标志位是处理函数的必要步骤，否则会持续触发。

4.2.4 网络（ENETC/以太网）驱动

对于LS1028A等高端处理器，其集成的ENETC（以太网控制器）性能强大。BareMetal框架提供了简化的网络API。

核心API实战：

// test_net.c 示例片段 (LS1028ARDB ENETC) #include <netdev.h> #include <common.h> void test_net(void) { char *ethact_name; int ret; // 1. 初始化PCIe（ENETC挂载在PCIe总线上） pci_init(); // 2. 初始化以太网 eth_initialize(); // 3. 设置板卡IP地址（静态配置示例） char *ipaddr = "192.168.1.100"; char *netmask = "255.255.255.0"; char *gateway = "192.168.1.1"; // 这里需要调用设置IP的函数，具体API可能因U-Boot版本略有不同 // 通常是设置环境变量，然后应用。例如： // setenv("ipaddr", ipaddr); // setenv("netmask", netmask); // setenv("gatewayip", gateway); // net_init(); printf("Network initialized. Trying to ping host 192.168.1.2...\n"); // 4. 执行Ping测试 (net_loop会处理ARP请求、ICMP Echo等) // 注意：原始的net_loop(PING)调用可能需要更具体的参数设置。 // 更常见的做法是直接调用 `ping` 命令函数（如果已实现）。 // 例如：do_ping(NULL, 0, 0, {"ping", "192.168.1.2"}); // 实际开发中需要查阅U-Boot网络命令的实现。 }

网络调试要点：

1. IP配置：BareMetal环境通常没有DHCP客户端，需要静态配置IP地址、子网掩码和网关。务必确保与待通信主机在同一网段。
2. MAC地址：检查U-Boot中是否定义了有效的MAC地址，否则网络栈可能无法正常工作。
3. 物理连接：确认网线已连接至正确的端口（如LS1028ARDB的ENETC端口）。使用ethact命令可以查看和切换当前活动的网络接口。
4. 防火墙：确保宿主机防火墙没有阻止ICMP回显请求（Ping）。

4.3 编译与加载自定义应用

当你修改或添加了app目录下的源代码后，需要重新编译BareMetal镜像。

对于独立编译方法：

1. 在U-Boot源码根目录，直接执行make即可。它会自动编译app/目录下的所有源文件并链接进最终的u-boot.bin。
2. 通过TFTP加载新的镜像进行测试：

   # 在目标板U-Boot命令行下 => tftp 0x84000000 ${serverip}:u-boot.bin => dcache flush => cpu start 0x84000000

对于Yocto构建方法：

1. 修改app.c或相关测试文件后，需要触发U-Boot软件包的重新编译。最干净的方法是：

   bitbake -c cleansstate u-boot-real-time-edge && bitbake u-boot-real-time-edge

2. 然后，重新构建最终镜像（增量构建，速度较快）：

   bitbake nxp-image-real-time-edge

3. 最后，使用新的.wic镜像重新烧录SD卡或更新对应分区。

5. 高级外设与综合调试技巧

掌握了基础外设后，可以进一步探索更复杂的组件，如QSPI Flash、USB Mass Storage、PCIe设备以及CAN总线。

5.1 QSPI Flash存储操作

QSPI Flash常用于存储程序、数据或配置文件。其操作遵循“初始化-擦除-读写”的标准流程。

// test_qspi.c 示例片段 #include <spi.h> #include <spi_flash.h> #include <common.h> void test_qspi(void) { struct spi_flash *flash; u8 buf[256], rbuf[256]; int ret; // 1. 查找并初始化SPI Flash设备 ret = spi_flash_probe_bus_cs(0, 0, 0, 0, &flash); if (ret || !flash) { printf("SPI Flash probe failed.\n"); return; } printf("SPI Flash: %s, Size: %ld MB\n", flash->name, flash->size >> 20); // 2. 擦除一段区域 (例如偏移0x1000，大小4KB) ret = spi_flash_erase(flash, 0x1000, 4096); if (ret) { printf("Erase failed.\n"); return; } // 3. 准备并写入数据 for (int i=0; i<256; i++) buf[i] = i; ret = spi_flash_write(flash, 0x1000, 256, buf); if (ret) { printf("Write failed.\n"); return; } // 4. 读回并验证数据 memset(rbuf, 0, 256); ret = spi_flash_read(flash, 0x1000, 256, rbuf); if (ret) { printf("Read failed.\n"); return; } if(memcmp(buf, rbuf, 256) == 0) { printf("[OK] QSPI read/write test passed.\n"); } }

注意事项：QSPI Flash有扇区/块大小的概念，擦除操作必须以块为单位。写操作前必须先擦除。务必查阅Flash芯片的数据手册，了解其扇区大小和擦除/编程时间。

5.2 综合调试与问题排查实录

在开发过程中，你一定会遇到各种问题。以下是我总结的常见问题排查清单：

最后的建议：嵌入式BareMetal调试，printf大法和逻辑分析仪是你的最佳伙伴。在关键代码路径添加详细的日志输出，可以快速定位问题范围。对于时序要求严格或通信协议问题，逻辑分析仪能直观地展示信号波形，是解决问题的终极武器。从最简单的LED闪烁开始，逐步增加外设功能，保持耐心，你一定能驾驭这套强大的实时开发框架。