RT-Thread-利用RT-Thread Studio 制作开发板资源包RT-Thread问答社区

利用RT-Thread Studio 制作开发板资源包

发布于 2021-03-23 15:34:51 浏览：2291 订阅该版

[tocm]

# 开发板资源包制作教程

本文主要介绍如何从一个BSP转化为Studio工程，然后再以Studio工程为基础，借助开发板资源包制作工具制作一个开发板资源包。最后可以将开发板资源包贡献到SDK上。（BSP的获取可以从 [新手推荐开发板列表及其BSP](https://www.rt-thread.org/document/site/tutorial/quick-start/more/#stm32-bsp)这篇文章中获取，或者按照教程制作自己的BSP，这里不再赘述）

## 1.Studio工程制作

进入到bsp文件夹的目录中，打开RT-Thread env工具输入` scons --dist-ide --project-path=bsp（存储的文件夹名字） --project-name=stm32H750（生成的工程名）`即可生成studio工程。

## 2.开发板资源包制作

这里需要借助开发板资源包制作工具来制作。下面介绍开发板资源制作工具的使用方法。

### 准备工作

1. RT-Thread  Studio V2.1.0及以上版本
2. Studio工程
3. 开发板的基本信息，如开发板名称、厂商、调试器、调试接口等
4. 开发板所用芯片的基本信息，如芯片厂商，芯片名等
5. 开发板的大、小图片各一张，小图片尺寸为200x300
6. 开发板的文档

### 使用方法

打开Studio,点击工具栏`新建`按钮旁的下拉三角，选择`开发板支持包`

![image.png](https://oss-club.rt-thread.org/uploads/20210323/35f296e6fc29dfadc75a4286486112ea.png)

下图即为开发板制作包工具，共有五栏信息需要填写，左上角打*号的表示该项为必填项。

![image.png](https://oss-club.rt-thread.org/uploads/20210323/80c0dc3e9055a2c8619a1dbaec8ecb67.png)

下面对一些所填项进行解释说明，方便大家填写。

![image.png](https://oss-club.rt-thread.org/uploads/20210323/8cc2980df898d5c14fe41a341513f5f5.png)

![image.png](https://oss-club.rt-thread.org/uploads/20210323/c02545c33048c58f47c3a737c6705178.png)

![image.png](https://oss-club.rt-thread.org/uploads/20210323/b94f5f6903094aaeb2f73dd0f3b6757b.png)

到此所有信息都填写完成了，可以点击右上角`预览`按钮，检查开发板信息是否填写无误。检查没有问题后可点击`生成`按钮即可生成开发板资源包

![image.png](https://oss-club.rt-thread.org/uploads/20210323/f9e54625bcef75a6c7f66e5bb64ef0b1.png)

## 3.部署开发板支持包到Studio SDK Manager

1. 在github.com 新建一个仓库，存储制作好的开发板支持包，需要满足以下格式

+ 仓库名字以 “sdk-bsp-” 为首，例如 sdk-bsp-stm32h750-realthread-artpi
   + 开发板支持包描述文件 (yaml) 需要位于仓库的根目录下

参考仓库：https://github.com/RT-Thread-Studio/sdk-bsp-stm32h750-realthread-artpi

2. 将开发板支持包 push 到建好的 github 仓库中，并发布一个 release，需满足以下条件

+ release 版本号 tag version 与  yaml 里的 pkg version 保持一致，格式需为三位数字 [0-9].[0-9].[0-9] ，例如 1.0.0
   + 记录 Source code 的下载链接，在后续步骤使用

![image.png](https://oss-club.rt-thread.org/uploads/20210323/c3e1610477eb282875a4ab7649583c63.png)

3. Fork 一份RT-Thread Studio 的 SDK 索引仓库 https://github.com/RT-Thread-Studio/sdk-index 到个人 github 账号下

4. 在本地sdk-index 仓库的 sdk-index/Board_Support_Packages 下添加一个新的开发板信息

+ 检查 Board_Support_Packages 是否有新添加的开发板支持包的芯片文件夹，如果没有则参考目前已有的芯片添加一个新的芯片厂商文件夹
   + 在芯片厂商文件夹中，检查是否有需要添加的开发板，如果没有则参考其他开发板添加一个
   + 在开发板的文件夹中，添加新的开发板支持包release 信息，url 为 release 时的Source code的下载链接

```json
   {
       "name": "STM32H750-RT-ART-Pi",
       "vendor": "RealThread",
       "description": "STM32H750-RT-ART-Pi Board Support Packages",
       "license": "",
       "repository": "https://github.com/RT-Thread-Studio/sdk-bsp-stm32h750-realthread-artpi.git",
       "releases": [
           {
               "version": "1.1.0",
               "date": "2020-12-01",
               "description": "released v1.1.0",
               "size": "152 MB",
               "url": "https://github.com/RT-Thread-Studio/sdk-bsp-stm32h750-realthread-artpi/archive/1.1.0.zip"
           },
           {
               "version": "1.0.1",
               "date": "2020-10-23",
               "description": "released v1.0.1",
               "size": "136 MB",
               "url": "https://github.com/RT-Thread-Studio/sdk-bsp-stm32h750-realthread-artpi/archive/1.0.1.zip"
           }
       ]
   }
   ```

+ 注意事项：
     + 索引仓库中不要出现非ascii 字符
     + 开发板支持包名称 name字段 保持大写字母和中划线组合

5. 将改好的 sdk-index 仓库 push 到 github，并向官方 sdk-index 提出 PR

6. PR 合并后，开发板支持包将会更新在Studio 的SDK Manager 界面里