2、开发环境搭建：STM32开发环境（STM32CubeIDE、HAL库）与ROS2环境（Ubuntu、ROS2 Humble）的安装与配置

在《STM32与ROS2通信实战》课程中，开发环境的搭建是决定后续学习效率与项目调试体验的基石。本章将系统讲解两大核心工具链的安装与配置：面向微控制器侧的 STM32CubeIDE（集成HAL库），以及面向高性能计算侧的 Ubuntu 22.04 + ROS2 Humble。我们将从工具链的架构原理出发，逐步拆解安装步骤、验证方法以及常见陷阱，帮助您构建一套稳定、可复用的嵌入式与机器人通信开发环境。

2.1 核心原理：为什么选择 STM32CubeIDE + HAL 与 Ubuntu + ROS2 Humble

在嵌入式与机器人融合开发中，工具链的选择直接影响开发效率与系统稳定性。STM32CubeIDE 是 ST 官方基于 Eclipse CDT 深度定制的集成开发环境，它最大的优势在于将 STM32CubeMX 配置工具、HAL 硬件抽象层库、GCC 交叉编译器以及 GDB 调试器无缝集成于一体。这意味着开发者无需在多个独立软件（如 Keil + CubeMX + ST-Link Utility）之间切换，即可完成从引脚配置、代码生成、编译烧录到在线调试的全流程。HAL 库则提供了面向外设（如 UART、SPI、I2C、TIM、DMA）的统一 API 接口，屏蔽了底层寄存器操作的复杂性，使得代码在不同 STM32 系列芯片之间具有极高的可移植性。

在 ROS2 侧，Ubuntu 22.04 LTS 是 ROS2 Humble 官方支持的首选操作系统。Humble 是 ROS2 的长期支持（LTS）版本，其基于 DDS（数据分发服务）的通信机制天然适合分布式、实时性要求较高的机器人系统。选择 Humble 而非更早的 Foxy 或更新的 Iron，是因为其拥有最丰富的社区文档、二进制预编译包以及第三方库兼容性。在 x86_64 架构的 PC 或虚拟机中运行 Ubuntu，可以充分利用其强大的计算资源进行图像处理、路径规划等复杂算法，并通过串口或网络与 STM32 进行数据交互。

2.2 操作流程：STM32CubeIDE 与 HAL 库的安装配置

安装 STM32CubeIDE 并非简单的“下一步”操作，其中涉及 Java 运行时、固件包下载路径、调试器驱动等多个关键环节。以下是经过验证的完整流程：

1. 获取安装包：访问 ST 官网（www.st.com），在“工具与软件”栏目下找到 STM32CubeIDE，选择对应操作系统（Windows/Linux/macOS）的安装包。注意选择 v1.13 及以上版本，以支持最新的 STM32U5 系列。
2. 安装 Java 环境（仅 Linux 需要）：Ubuntu 用户需先安装 OpenJDK 11 或 17，执行 sudo apt install openjdk-11-jre。Windows 版安装包自带 JRE，无需额外配置。
3. 运行安装程序：Windows 下双击 .exe 文件，Linux 下解压 tar.gz 后运行 ./stm32cubeide。安装路径建议不要包含中文或空格，例如 C:\ST\STM32CubeIDE 或 /opt/stm32cubeide。
4. 配置固件包路径：首次启动会提示下载固件库（如 STM32F4xx_HAL_Driver）。建议在 Window -> Preferences -> STM32Cube -> Firmware Updater 中设置一个非系统盘的大容量路径（如 D:\STM32Cube\Repository），避免 C 盘空间不足。
5. 安装 ST-Link 驱动：若使用 ST-Link/V2 调试器，Windows 需安装 ST-Link USB Driver；Linux 下通常无需额外驱动，但需确保 udev 规则已配置（安装包会自动处理）。
6. 验证安装：新建一个空白工程，选择芯片型号（如 STM32F407VGT6），在 CubeMX 图形界面中随意配置一个 GPIO 输出，生成代码并编译。若编译无错误且能生成 .elf 文件，则安装成功。

配置项	推荐值/操作	注意事项
IDE 版本	v1.13.1 及以上	旧版本不支持最新芯片，且存在已知的调试断点 bug
固件包路径	非系统盘，如 D:\STM32Cube\Repo	固件包约 2-3 GB，避免占用 C 盘空间
编译器优化级别	-O2（Release） / -O0（Debug）	调试时务必使用 -O0，否则变量监视不准确
调试器接口	SWD（Serial Wire Debug）	比 JTAG 占用更少引脚，推荐使用
HAL 库版本	随固件包自动匹配	不要手动修改 HAL 库源码，如需定制应使用用户代码区

2.3 操作流程：Ubuntu 22.04 与 ROS2 Humble 的安装配置

ROS2 Humble 的安装比 ROS1 更加规范化，但依然存在几个容易出错的细节。以下步骤在 Ubuntu 22.04 桌面版（或服务器版 + 桌面组件）上验证通过：

1. 设置软件源：首先确保系统 locale 支持 UTF-8，执行 sudo apt update && sudo apt install locales，然后 sudo locale-gen en_US en_US.UTF-8。接着添加 ROS2 官方源：sudo add-apt-repository universe 以及 sudo apt install curl && curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg。
2. 添加源列表：将 deb [signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu jammy main 写入 /etc/apt/sources.list.d/ros2.list。
3. 安装 ROS2 Humble：执行 sudo apt update && sudo apt install ros-humble-desktop。该包包含 RViz2、rqt、demo 节点等完整桌面工具，体积约 3-4 GB。若空间有限，可安装 ros-humble-ros-base（仅命令行工具）。
4. 配置环境变量：将 source /opt/ros/humble/setup.bash 添加到 ~/.bashrc 末尾。注意不要使用 setup.sh，因为 bash 用户应使用 setup.bash。
5. 安装 colcon 与 vcstool：执行 sudo apt install python3-colcon-common-extensions python3-vcstool。colcon 是 ROS2 的编译工具，替代了 ROS1 的 catkin。
6. 验证安装：打开两个终端，分别运行 ros2 run demo_nodes_cpp talker 和 ros2 run demo_nodes_py listener。若能看到双方互相发送 "Hello World" 消息，则安装成功。

2.4 案例拆解：从零搭建一个串口回环测试环境

为了验证双端环境是否真正打通，我们设计一个最小化闭环案例：STM32 通过 USART2 接收数据，并将数据原样返回；ROS2 节点通过 USB 转串口模块发送字符串，并接收回显。此案例不涉及复杂协议，但能完整检验驱动、权限、波特率配置等基础环节。

背景与约束：硬件平台为 STM32F407 最小系统板，板载 CH340 USB 转串口芯片，连接 PC 的 /dev/ttyUSB0。ROS2 运行在 VMware 虚拟机中，需将 USB 设备直通到虚拟机（VMware 设置 -> USB 控制器 -> 连接）。

初始现象：STM32 代码编译下载正常，但 ROS2 端使用 echo "test" > /dev/ttyUSB0 发送数据后，cat /dev/ttyUSB0 无任何输出。

分析判断过程：首先检查 STM32 代码中 USART2 的 GPIO 配置（PA2=TX, PA3=RX），确认波特率设置为 115200-8-N-1。其次检查 Linux 端串口权限，执行 ls -l /dev/ttyUSB0，发现属主为 root，当前用户无读写权限。最后检查虚拟机 USB 直通是否成功，执行 dmesg | grep tty 查看内核日志。

实际操作步骤：

1. 将用户加入 dialout 组：sudo usermod -aG dialout $USER，注销重新登录。
2. 在 STM32CubeIDE 中，使用 CubeMX 配置 USART2 为异步模式，波特率 115200，开启全局中断。在 main.c 中添加回调函数：

   void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) {
       if (huart->Instance == USART2) {
           HAL_UART_Transmit(&huart2, &rx_buffer, 1, 100);
           HAL_UART_Receive_IT(&huart2, &rx_buffer, 1);
       }
   }
   // 在 main 函数中启动首次接收
   HAL_UART_Receive_IT(&huart2, &rx_buffer, 1);

3. 重新编译烧录，打开串口助手（如 minicom 或 Python pyserial）发送 "A"，观察是否回显 "A"。
4. 在 ROS2 端创建测试节点，使用 pyserial 库发送数据：

   import rclpy
   from rclpy.node import Node
   import serial
   
   class SerialTest(Node):
       def __init__(self):
           super().__init__('serial_test')
           self.ser = serial.Serial('/dev/ttyUSB0', 115200, timeout=1)
           self.timer = self.create_timer(1.0, self.timer_callback)
       def timer_callback(self):
           self.ser.write(b'Hello STM32\r\n')
           response = self.ser.readline()
           self.get_logger().info(f'Received: {response}')
   
   rclpy.init()
   node = SerialTest()
   rclpy.spin(node)

结果对比：修复权限后，ROS2 节点每秒钟能收到 STM32 回显的 "Hello STM32" 字符串。若仍无数据，使用 stty -F /dev/ttyUSB0 115200 检查串口参数，并用示波器测量 PA2 引脚是否有波形。

风险与代价：此案例中最大的风险是虚拟机 USB 直连不稳定，导致串口设备频繁掉线。建议在物理机上直接安装 Ubuntu 双系统，或使用 USB 网卡（如 CH340 转以太网）规避此问题。

复盘经验：环境搭建的 80% 问题集中在权限、设备节点、波特率不匹配三个方面。建议在编写业务代码前，先使用 echo 和 cat 命令验证物理链路，再逐步引入 ROS2 节点。

2.5 常见误区与总结复盘

在长期教学与项目实践中，以下误区出现频率最高，需要特别警惕：

• 误区一：在 Windows 上直接开发 ROS2。虽然 ROS2 支持 Windows，但大量第三方库（如 Gazebo、Navigation2）在 Windows 上编译困难，且性能不如 Linux。建议使用 VMware/VirtualBox 安装 Ubuntu，但需注意 USB 直通的稳定性。
• 误区二：忽略 HAL 库的堆栈设置。当使用 DMA + 中断时，若 Heap_Size 设置过小（默认 0x200），会导致 malloc 失败。建议在启动文件 startup_stm32f407xx.s 中将 Heap 调整为 0x1000。
• 误区三：ROS2 环境变量未持久化。每次打开新终端都要手动 source /opt/ros/humble/setup.bash，否则 ros2 命令找不到。务必将其写入 ~/.bashrc。
• 误区四：串口权限问题反复出现。即使加入了 dialout 组，某些 Linux 发行版（如 Fedora）仍需要额外的 udev 规则。建议在 /etc/udev/rules.d/ 下创建 99-stm32.rules，内容为 SUBSYSTEM=="tty", ATTRS{idVendor}=="1a86", MODE="0666"（CH340 的 Vendor ID）。

本章节从工具链原理、安装步骤、案例验证到误区排查，完整覆盖了 STM32 与 ROS2 双端环境的搭建过程。请务必亲手操作一遍，因为环境问题往往是项目中最耗时、最消磨耐心的部分。当您看到 STM32 的回显数据在 ROS2 终端中打印出来时，意味着您的开发环境已经具备了支撑后续实战的坚实基础。