Skip to content

[bsp][stm32] clarify BSP template copy path #11540

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Old-Ding wants to merge 1 commit into
base: master
Choose a base branch
from
+11 −0
Open

[bsp][stm32] clarify BSP template copy path #11540

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions bsp/stm32/docs/How to make a STM32 BSP for RT-Thread.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,12 @@ Copy the `stm32f10x` folder under the template folder and change the name of the

![Copying common templates](./figures_en/copy.png)

Note: Do not run `menuconfig` or `scons` directly inside `bsp/stm32/libraries/templates/<series>`.
The template directory is two levels deeper than a real BSP because of `libraries/templates`, so the
relative paths in `Kconfig` match only after the template has been copied to `bsp/stm32/<board>`.
Copy the matching series template into `bsp/stm32/`, rename it to the target BSP name, and then run
`menuconfig`, `pkgs --update`, and `scons` from the new BSP directory.

Modify the configuration file in the board folder. The modified content is shown in the following table:

| Item | Instruction |
Expand Down
5 changes: 5 additions & 0 deletions bsp/stm32/docs/STM32系列BSP制作教程.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -83,6 +83,11 @@ BSP 的制作过程分为如下五个步骤：

![复制通用模板](./figures/copy.png)

注意：不要直接在 `bsp/stm32/libraries/templates/<series>` 模板目录中执行 `menuconfig` 或 `scons`。
模板目录比实际 BSP 目录多了 `libraries/templates` 两级，`Kconfig` 中的相对路径只在模板被复制到
`bsp/stm32/<board>` 后才匹配。请先将同系列模板复制到 `bsp/stm32/` 目录下并重命名为目标 BSP 名称，
再进入新的 BSP 目录执行 `menuconfig`、`pkgs --update` 和 `scons`。

在接下来的 BSP 的制作过程中，将会修改 board 文件夹内的配置文件，将 F1 系列的 BSP 模板变成一个适用于正点原子 `stm32f103-atk-nano` 开发板的 BSP ，下表总结了 board 文件夹中需要修改的内容：

| 项目 | 需要修改的内容说明 |
Expand Down
Loading