为什么需要微ROS

我最早接触这个需求是在一个四足机器人项目上。主控的STM32F407要采集12路IMU和24路舵机角度，直接用完整ROS2节点跑，不到10个话题就把128KB RAM塞满了。微ROS就是解决这个矛盾——让只有几十KB内存的MCU也能成为ROS2网络中的一等公民。

特性	完整ROS2节点	微ROS客户端节点
最小RAM需求	≥ 512KB（含DDS堆）	≈ 12KB（含传输层缓冲）
最小Flash需求	≥ 2MB	≈ 100KB（带典型发布器）
实时OS依赖	Linux或RTOS	FreeRTOS/Zephyr/裸机
DDS协议栈	FastDDS/GurumDDS	DDS-XRCE精简协议
跨网络能力	有线/WiFi/共享内存	UDP/串口/蓝牙（需传输插件）

微ROS软件架构的层间关系

从架构图能清楚看到：上层用户代码只调用客户端API（如`rcl_publish`），这些API将数据序列化为XRCE协议帧，再由传输层抽象模块通过UART或UDP发出去。传输层抽象是移植的关键——它把硬件外设的收发接口封装成统一的`uxr_transport_t`结构体。

移植第一步：获取并配置微ROS源码

首先需要从官方GitHub仓库拉取`micro_ros_stm32cubemx_generators`。这个生成器在CubeMX工程里自动创建微ROS客户端库的CMakeLists.txt以及必要的头文件。实际开发中，大部分团队选择通过该生成器而非手动复制源码来保证版本匹配。

# 假设已在工程根目录下执行
git clone -b foxy https://github.com/micro-ROS/micro_ros_stm32cubemx_generators.git

# 将库路径填入CubeMX的额外工具链路径
# 生成工程后会自动包含：
#   micro_ros_stm32cubemx_generators/micro_ros_src/
#   micro_ros_stm32cubemx_generators/micro_ros_lib/

在CubeMX中需要额外配置： 1. 使能FreeRTOS（CMSIS_V1或V2均可，微ROS需要其定时器和互斥量） 2. 配置一个UART或USART实例（用于与Agent通信） 3. 堆栈大小建议：至少为微ROS留出4KB的任务栈，DMA缓冲区各1KB 如果生成的工程报`HAL_UART_Receive_DMA`未定义，直接换成轮询接收模式即可——这在低速传感器采集场景中完全够用，我经常在小批量原型上这么干，能节省一个DMA通道。

移植的中间件与传输层

微ROS的传输层通过一组函数指针驱动硬件。下面的概念卡片列出了必须实现的三个函数。 实际编码时，UART的写操作可直接调用`HAL_UART_Transmit_DMA`，读操作则用环形缓冲区加DMA空闲中断——这样Agent端发来的订阅消息能在后台被接收，不用轮询阻塞任务。

// 示例：写函数实现（STM32 UART）
static bool transport_write(void* transport, uint8_t* buf, size_t len, uint8_t* err) {
    if (HAL_UART_Transmit_DMA(&huart1, buf, len) != HAL_OK) {
        *err = 1;
        return false;
    }
    return true;
}

实战步骤：从CubeMX到第一个话题

整个移植流程可以用一条流水线概括： 以下是用程序表达的关键初始化序列（省去错误检查以突出逻辑）：

void main(void) {
    HAL_Init();
    SystemClock_Config();
    MX_GPIO_Init();
    MX_USART1_UART_Init();   // 微ROS代理通信串口
    MX_FREERTOS_Init();      // 包含微ROS任务
    osKernelStart();
}

void micro_ros_task(void* arg) {
    // 1. 设置传输层
    static uxr_transport_t transport;
    uxr_set_transport_custom(&transport, 0, transport_open, transport_close,
                             transport_write, transport_read);

    // 2. 初始化微ROS客户端
    uxr_session_t session = uxr_init_session(&transport, 0x01, 0x00);
    while (!uxr_create_session(&session)) { osDelay(100); }

    // 3. 创建RCL节点
    rcl_allocator_t alloc = rcl_get_default_allocator();
    rclc_support_t support;
    rclc_support_init(&support, 0, NULL, &alloc);
    rclc_node_init_default(&node, "stm32_node", "", &support);
    rclc_publisher_init_default(&pub, &node, ROSIDL_GET_MSG_TYPE(int32), "motor_rpm");

    // 4. 主循环发布
    int32_t rpm = 0;
    while (1) {
        rpm = get_rpm_from_encoder();  // 用户函数
        rcl_publish(&pub, &rpm, NULL);
        rclc_executor_spin_some(&executor, 10);  // 处理入站订阅
        osDelay(20);  // 50Hz发布
    }
}

注意上面代码中`rclc_executor_spin_some`的调用——这是微ROS中订阅回调驱动的核心。如果在FreeRTOS任务里不加这一行，则Agent发来的设置命令会一直堆积在接收缓冲中得不到处理。