RT-Thread 安装指南（Windows/Linux 环境）

一、准备工作

1. 硬件准备：

   • 开发板（如 STM32F4/F7/H7、ESP32、树莓派 Pico 等）
   • 调试器（如 J-Link、ST-Link）
   • USB 转串口模块（用于日志输出）

2. 软件依赖：

   • Windows：安装 Git、Python 3.8+
   • Linux：使用包管理器安装 git 和 python3
   • 安装编译工具链：
     • ARM：arm-none-eabi-gcc（下载链接）
     • RISC-V：riscv-none-elf-gcc（下载链接）

二、安装 RT-Thread 开发环境（两种方法任选）

方法一：使用 RT-Thread Env 工具（推荐）

1. 下载 Env 工具：

   • Windows 版
   • Linux/macOS：通过源码安装

     git clone https://github.com/RT-Thread/env.git
     cd env/tools
     python3 setup.py install

2. 配置环境变量：

   • 打开 Env 控制台（Windows：env.bat；Linux：终端执行 source env.sh）

3. 创建/获取项目：

   # 示例：创建 STM32 项目
   rtt create-project --board=stm32l475-atk-pandora
   cd stm32l475-atk-pandora

方法二：从 GitHub 克隆源码

git clone https://github.com/RT-Thread/rt-thread.git
cd rt-thread/bsp/stm32/stm32f407-atk-explorer  # 进入具体开发板目录

三、编译和烧录（以 STM32 为例）

1. 配置工程：

   menuconfig  # 图形化配置内核/组件/驱动

   • 按需开启组件（如文件系统、网络协议栈）
   • 保存配置后退出

2. 更新软件包：

   pkgs --update

3. 编译工程：

   scons  # 使用默认编译器
   # 或指定工具链
   scons --target=mdk5  # 生成 Keil 工程

4. 烧录固件：

   • 方法一：通过 STM32CubeProgrammer 烧录 rtthread.bin
   • 方法二：使用 openocd（Linux 示例）

     openocd -f interface/stlink.cfg -f target/stm32f4x.cfg -c "program rtthread.bin 0x08000000"

四、验证安装

1. 连接串口（波特率 115200），使用终端工具（如 Putty、MobaXterm）查看输出。
2. 成功启动后会显示 RT-Thread Logo 和 Shell 提示符：

   \ | /
   - RT -     Thread Operating System
   / | \     5.0.0 build Nov 12 2023
   2006 - 2022 Copyright by rt-thread team
   msh > 

3. 输入命令测试：

   list_thread  # 查看系统线程
   free         # 查看内存使用

五、其他平台支持

• ESP32：

  git clone https://github.com/RT-Thread/rt-thread-esp-idf.git
  cd rt-thread-esp-idf
  ./build.sh menuconfig  # 配置后编译

• 树莓派 Pico：

  cd rt-thread/bsp/raspberry-pico
  scons --target=make  # 生成 makefile
  make

六、常见问题

1. 编译错误：

   • 检查工具链路径：在 menuconfig > Toolchain 设置正确编译器路径
   • 安装依赖：执行 pip install -r requirements.txt

2. 串口无输出：

   • 确认板载串口引脚配置（在 board.h 修改 TX/RX）
   • 检查 menuconfig 中的 BSP_USING_UART1 是否启用

3. 更多帮助：

   • 官方文档：https://www.rt-thread.org/document/site/
   • 论坛提问：https://club.rt-thread.org/

提示：使用 scons -j8 可加速编译，-j 后接线程数。