【瑞萨AI挑战赛】Titan Board开发板RT-Thread开发环境搭建
本帖最后由 HonestQiaoQiao 于 2026-3-16 03:09 编辑> 从零开始搭建Titan Board（RA8P1）开发环境，包含RT-Thread Studio安装、SDK配置、工程创建和第一个程序的编译下载。
## 前言
Titan Board是RT-Thread推出的一款高性能AI开发板，搭载瑞萨RA8P1芯片（1GHz Cortex-M85 + 250MHz Cortex-M33双核），内置NPU（神经网络处理器），非常适合边缘AI和计算机视觉应用开发。
本文将手把手带你完成开发环境的搭建，让你能在5分钟内跑通第一个RT-Thread程序。
**参考文档：**
- (https://www.rt-thread.org/document/site/#/development-tools/rtthread-studio/um/studio-user-begin?id=%e5%ae%89%e8%a3%85-rt-thread-studio)
- (https://rt-thread-studio.github.io/sdk-bsp-ra8p1-titan-board/latest/start/Titan_template/README_zh.html)
---
## 硬件准备
### Titan Board开发板
!(https://www.eefocus.com/forum/data/attachment/forum/202603/16/030459hfmp4f8qfsss2777.png)
**主要硬件参数：**
| 项目 | 参数 |
|------|------|
| MCU | R7KA8P1KFLCAC |
| 主频 | 1GHz Cortex-M85 + 250MHz Cortex-M33 |
| 内存 | 1MB Code MRAM + 2MB SRAM（带ECC）|
| 调试接口 | 板载DAP-Link |
| 显示接口 | MIPI DSI/CSI、RGB LCD |
| 网络 | 2个以太网接口 |
| 其他 | 40Pin树莓派接口、4xCAN、2xRS485、USBHS/USBFS |
**需要的配件：**
- USB Type-C数据线（用于供电和调试）
- MIPI LCD或RGB LCD（可选，用于显示）
- OV5640摄像头（可选，用于视觉应用）
---
## 第一步：安装RT-Thread Studio
### 1.1 下载安装包
访问RT-Thread官网下载页面：https://www.rt-thread.io/studio.html
点击下载最新版本的RT-Thread Studio安装包（约500MB）。
### 1.2 安装步骤
双击下载的.exe文件开始安装：
**步骤1：欢迎界面**
点击"下一步"继续。
**步骤2：接受许可协议**
勾选"我接受许可协议中的条款"，点击"下一步"。
**步骤3：选择安装路径**
> **重要提示**：安装路径不要有**空格**和**中文字符**！建议使用默认路径或 `D:\RT-ThreadStudio`
**步骤4：选择开始菜单文件夹**
保持默认即可，点击"下一步"。
**步骤5：开始安装**
点击"安装"按钮，等待安装完成（约2-3分钟）。
**步骤6：完成安装**
勾选"运行RT-Thread Studio"，点击"完成"。
### 1.3 首次启动
第一次启动需要登录RT-Thread账号：
支持第三方账号登录（微信、GitHub等），登录一次后会自动记住账号。
---
## 第二步：安装Titan Board SDK
### 方法一：在线安装（可能失败）
正常情况下，通过SDK管理器在线安装：
1. 点击工具栏的 **SDK Manager** 按钮：
!(https://www.eefocus.com/forum/data/attachment/forum/202603/16/030613txeehof5sxfhpxhp.png)
2. 等待联网获取SDK信息：
!(https://www.eefocus.com/forum/data/attachment/forum/202603/16/030623kgi8uaa1dcgxgcva.png)
3. 在SDK资源库中找到 **Board_Support_Packages** → **Renesas** → **Titan Board**：
!(https://www.eefocus.com/forum/data/attachment/forum/202603/16/030633tzdna6wgzax3faf6.png)
4. 勾选并点击"安装"。
> **注意**：由于网络原因，在线安装Titan Board SDK可能会失败。如果失败，请使用下面的离线导入方法。
### 方法二：离线导入（推荐）
**步骤1：下载BSP包**
从GitHub Releases下载离线BSP包：
访问：https://github.com/RT-Thread-Studio/sdk-bsp-ra8p1-titan-board/releases/tag/1.0.2
下载文件：`sdk-bsp-ra8p1-titan-board-1.0.2.zip`（约200MB）
**步骤2：导入资源包**
1. 打开RT-Thread Studio，点击 **SDK Manager**
2. 点击右上角的 **导入** 按钮
3. 选择下载的zip文件
4. 点击"确定"开始导入
> **【图18】导入SDK资源包截图**
导入成功后，SDK资源库中会显示Titan Board相关的资源包。
---
## 第三步：创建第一个工程
### 3.1 新建项目
在"项目资源管理器"窗口中点击右键，选择 **新建 → 项目**：
### 3.2 选择项目类型
选择 **RT-Thread 项目**，点击"下一步"：
### 3.3 配置工程信息
填写以下信息：
| 配置项 | 推荐值 | 说明 |
|--------|--------|------|
| 工程名 | Titan_hello | 自定义项目名称 |
| 基于开发板 | Titan_Board | 选择Titan Board |
| BSP版本 | 1.0.2 | 选择最新版本 |
| RT-Thread版本 | 5.1.0 | 选择最新稳定版 |
| 调试器 | DAP-Link | 使用板载调试器 |
| 调试接口 | SWD | 默认 |
点击"完成"，等待工程创建（约1-2分钟）。
### 3.4 工程结构
创建成功后，"项目资源管理器"中会出现工程：
```
Titan_hello/
├── src/
│ └── hal_entry.c # 主程序入口
├── ra_gen/ # FSP生成的代码
├── ra_cfg/ # 配置文件
├── rtconfig.h # RT-Thread配置
└── configuration.xml # FSP配置
```
---
## 第四步：编译和下载
### 4.1 编译工程
点击工具栏的 **构建** 按钮（或按Ctrl+B）：
编译日志会显示在控制台窗口，看到以下信息表示编译成功：
```
Build Finished. 0 errors, 0 warnings.
```
### 4.2 硬件连接
使用USB Type-C数据线连接开发板到电脑：
- 开发板上的 **USB Debug** 接口（靠近DAP-Link芯片的Type-C口）
- 用于供电、程序下载和串口调试
> **【图19】硬件连接图**
> !(https://www.eefocus.com/forum/data/attachment/forum/202603/16/030805ogzlnaupzbaghrd0.jpg)
### 4.3 下载程序
点击工具栏的 **下载程序** 按钮，选择 **JLink**：
> **【图20】选择下载器**
> !(https://www.eefocus.com/forum/data/attachment/forum/202603/16/030817vo9nnzrdql7nid9i.png)
下载成功后，控制台显示：
```
Downloading finished.
```
### 4.4 查看运行结果
**打开串口终端：**
1. 打开串口工具（如SecureCRT、PuTTY或RT-Thread Studio自带的终端）
2. 选择串口（通常是COM3或类似）
3. 设置波特率：**115200-8-1-N**
**预期输出：**
---
## 第五步：修改程序
### 5.1 找到入口函数
应用层入口函数在 `src/hal_entry.c` 中：
```c
#include <rtthread.h>
#include "hal_data.h"
#define LED_PIN_0 BSP_IO_PORT_00_PIN_12// 用户LED
void hal_entry(void)
{
rt_kprintf("\n==================================================\n");
rt_kprintf("Hello, Titan Board!\n");
rt_kprintf("==================================================\n");
while (1)
{
rt_pin_write(LED_PIN_0, PIN_HIGH);
rt_thread_mdelay(1000);
rt_pin_write(LED_PIN_0, PIN_LOW);
rt_thread_mdelay(1000);
}
}
```
### 5.2 修改代码
尝试修改输出信息：
```c
rt_kprintf("\n==================================================\n");
rt_kprintf("Hello, RA8P1 AI Challenge!\n");
rt_kprintf("This is my first RT-Thread program!\n");
rt_kprintf("==================================================\n");
```
### 5.3 重新编译下载
1. 按Ctrl+S保存
2. 点击构建按钮编译
3. 点击下载按钮烧录
4. 查看串口输出
---
## 常见问题与解决方案
### 问题1：找不到DAP-Link
**现象**：下载时提示"未找到调试器"
**解决**：
1. 检查USB线是否连接正确（使用USB Debug口）
2. 安装libusb驱动（使用Zadig工具）
3. 参考：https://rt-thread-studio.github.io/sdk-bsp-ra8p1-titan-board/latest/faq/FAQ_page/README_zh.html
> **【图21】Zadig工具配置**
> !(https://www.eefocus.com/forum/data/attachment/forum/202603/16/030830kui1ievp2411wepe.png)
### 问题2：SDK在线安装失败
**现象**：SDK管理器中Titan Board安装卡住或报错
**解决**：使用本文推荐的离线导入方法，从GitHub Release下载BSP包导入。
### 问题3：编译报错"arm-none-eabi-gcc not found"
**现象**：构建时提示找不到编译器
**解决**：
1. 项目 → 属性 → MCU → ARM Toolchains path
2. 设置正确的工具链路径（通常在RT-ThreadStudio/repo/Extract/ToolChain_Support_Packages下）
> **【图22】工具链路径设置**
!(https://www.eefocus.com/forum/data/attachment/forum/202603/16/030841bl854yhzumq6uvf8.png)
### 问题4：POSIX相关编译错误
**现象**：编译时出现_POSIX_SOURCE相关的错误
**解决**：
1. 项目 → 属性 → C/C++构建 → 设置 → GNU ARM Cross C编译器 → 预处理器
2. 添加预处理器定义：`_POSIX_SOURCE=1`
页:
[1]