diff --git a/docs/common/dev/_kernel.mdx b/docs/common/dev/_kernel.mdx
index ee885b726..367d7c25d 100644
--- a/docs/common/dev/_kernel.mdx
+++ b/docs/common/dev/_kernel.mdx
@@ -4,11 +4,7 @@ import { PreView } from "@site/src/utils/docs";
bsp 是 Radxa 提供的一套快速构建 U-Boot Kernel 的工具,使用 bsp 非常方便就能构建出自己的 U-Boot 和 Kernel.
-
- {`
-下面将为您展示,以 #model# 为例如何使用 bsp 构建内核。
-`}
-
+下面将为您展示,以 {props.model} 为例如何使用 bsp 构建内核。
### bsp 环境配置
@@ -51,55 +47,52 @@ cd bsp
### 构建内核
+**完成 bsp 环境配置后,需要先编译一次内核才会从仓库拉取内核代码。**
+直接运行 `./bsp` 会显示所有参数及其解释,根据提示可知命令 `bsp [options] [product]`。
+以 {props.model} 为例,linux profile 为 "**{props.soc}**",以下是其他产品的 profile:
+
+| Model | profile |
+| :---------------: | :------: |
+| Radxa ROCK 5A | rockchip |
+| Radxa ROCK 5B | rockchip |
+| Radxa ROCK 5C | rockchip |
+| Radxa ROCK 5 ITX | rockchip |
+| Radxa ROCK 3A | rk356x |
+| Radxa ROCK 3B | rk356x |
+| Radxa ROCK 3C | rk356x |
+| Radxa CM3 Series | rk356x |
+| Radxa CM3I Series | rk356x |
+| Radxa ROCK PI S | stable |
+
+然后将产品对应 profile **{props.soc}** 填入 bsp 命令的 `profile` 参数即可构建内核,例如:
+
- {`
-完成 bsp 环境配置后,需要先编译一次内核才会从仓库拉取内核代码。
-直接运行 ./bsp 会显示所有参数及其解释,根据提示可知命令 "bsp [options] [product]"。
-以 #model# 为例,linux profile 为 "#soc#"。以下是其他产品的 profile:
-| Model | profile |
-| :--------------: | :------: |
-| Radxa ROCK 5A | rockchip |
-| Radxa ROCK 5B | rockchip |
-| Radxa ROCK 5C | rockchip |
-| Radxa ROCK 5 ITX | rockchip |
-| Radxa ROCK 3A | rk356x |
-| Radxa ROCK 3B | rk356x |
-| Radxa ROCK 3C | rk356x |
-| Radxa CM3 Series| rk356x |
-| Radxa CM3I Series| rk356x |
-| Radxa ROCK PI S | stable |
-然后将产品对应 profile **#soc#** 填入 bsp 命令的 **profile** 参数例如:**./bsp linux #soc#**,即可构建内核。
-内核源码的路径位于 bsp 目录下的 **.src/linux**,在修改内核源码后,可再次构建内核:
-`}
+ {`./bsp linux #soc#`}
+内核源码的路径位于 bsp 目录下的 `.src/linux`,在修改内核源码后,可再次构建内核:
+
- {`
- cd bsp
- ./bsp --no-prepare-source linux #soc# -r 999
- 参数说明:
- --no-prepare-source # 首次编译不需要加该参数,加该参数是为了使用本地修改进行编译,如果不加这个参数将会从 Radxa kernel 仓库同步最新代码并覆盖本地修改
- -r 999 # 指定内核的版本号为 999,以优先使用
-`}
+ {`cd bsp
+./bsp --no-prepare-source linux #soc# -r 999
+参数说明:
+--no-prepare-source # 首次编译不需要加该参数,加该参数是为了使用本地修改进行编译,如果不加这个参数将会从 Radxa kernel 仓库同步最新代码并覆盖本地修改
+-r 999 # 指定内核的版本号为 999,以优先使用`}
编译完成后会在当前目录生成许多 `deb` 包, 只需要安装下面两个 `deb` 即可
- {`
- linux-headers-5.10.160-999-#soc#_5.10.160-20_arm64.deb
- linux-image-5.10.160-999-#soc#_5.10.160-20_arm64.deb
-`}
+ {`linux-headers-5.10.160-999-#soc#_5.10.160-20_arm64.deb
+linux-image-5.10.160-999-#soc#_5.10.160-20_arm64.deb`}
将上面两个 `deb` 包复制到板子上使用 `dpkg` 指令安装即可完成内核安装
- {`
- sudo dpkg -i linux-image-5.10.160-999-#soc#_5.10.160-20_arm64.deb
- sudo dpkg -i linux-headers-5.10.160-999-#soc#_5.10.160-20_arm64.deb
- sudo reboot
-`}
+ {`sudo dpkg -i linux-image-5.10.160-999-#soc#_5.10.160-20_arm64.deb
+sudo dpkg -i linux-headers-5.10.160-999-#soc#_5.10.160-20_arm64.deb
+sudo reboot`}
重启完成后,可以通过 `uname -a` 查看当前启动的内核版本号,来查看是否安装成功
diff --git a/docs/common/dev/_u-boot.mdx b/docs/common/dev/_u-boot.mdx
index e6f13eaca..c14bf6759 100644
--- a/docs/common/dev/_u-boot.mdx
+++ b/docs/common/dev/_u-boot.mdx
@@ -47,69 +47,58 @@ cd bsp
### 构建 U-Boot
-
- {`
- 完成 bsp 环境配置后,需要先编译一次 U-Boot 才会从仓库拉取 U-Boot 代码。
- 直接运行 ./bsp 会显示所有参数及其解释,根据提示可知命令 "bsp [options] [product]"。
- 以 #model# 为例,U-Boot profile 为 **#profile#**。以下是其他产品的 profile:
- | Model | profile |
- | :--------------: | :-----: |
- | Radxa ROCK 5A | rknext |
- | Radxa ROCK 5B | rknext |
- | Radxa ROCK 5C | rknext |
- | Radxa ROCK 5 ITX | rknext |
- | Radxa ROCK 3A | latest |
- | Radxa ROCK 3B | latest |
- | Radxa ROCK 3C | latest |
- | Radxa CM3 Series| latest |
- | Radxa CM3I Series| latest |
- | Radxa ROCK PI S | latest |
- 然后将产品对应 profile **#profile#** 填入 bsp 命令的 profile 参数例如:"./bsp u-boot #profile# #product#",即可构建 U-Boot。
- U-Boot 源码的路径位于 bsp 目录下的 ".src/u-boot",在修改 U-Boot 源码后,可再次构建 U-Boot:
- `}
-
+**完成 bsp 环境配置后,需要先编译一次 U-Boot 才会从仓库拉取 U-Boot 代码。**
+直接运行 `./bsp` 会显示所有参数及其解释,根据提示可知命令 `bsp [options] [product]`。
+以 {props.model} 为例,U-Boot profile 为 "**{props.profile}**"。以下是其他产品的 profile:
+
+| Model | profile |
+| :---------------: | :-----: |
+| Radxa ROCK 5A | rknext |
+| Radxa ROCK 5B | rknext |
+| Radxa ROCK 5C | rknext |
+| Radxa ROCK 5 ITX | rknext |
+| Radxa ROCK 3A | latest |
+| Radxa ROCK 3B | latest |
+| Radxa ROCK 3C | latest |
+| Radxa CM3 Series | latest |
+| Radxa CM3I Series | latest |
+| Radxa ROCK PI S | latest |
+
+然后将 {props.model} 对应 profile "**{props.profile}**" 填入 bsp 命令的 `profile` 参数即可构建 U-Boot,例如:
+
+
+ {`./bsp u-boot #profile# #product#`}
+{" "}
+
+编译一次后 U-Boot 源码的路径位于 bsp 目录下的 `.src/u-boot`,在修改 U-Boot 源码后,可再次构建 U-Boot:
- {`
- cd bsp
- ./bsp --no-prepare-source u-boot #profile# #product#
- 参数说明:
- --no-prepare-source # 首次编译不需要加该参数,加该参数是为了使用本地修改进行编译,如果不加这个参数将会从 Radxa U-Boot 仓库同步最新代码并覆盖本地修改
- `}
+ {`cd bsp
+./bsp --no-prepare-source u-boot #profile# #product#
+参数说明:
+--no-prepare-source # 首次编译不需要加该参数,加该参数是为了使用本地修改进行编译,如果不加这个参数将会从 Radxa U-Boot 仓库同步最新代码并覆盖本地修改`}
-更多 bsp 参数使用说明可以执行 `./bsp`查看
+更多 bsp 参数使用说明可以执行 `./bsp` 查看
编译完成后会在当前目录生成许多 `deb` 包, 只需要安装下面的 `deb` 即可
- {`
- u-boot-#profile#_2023.10-1_arm64.deb
- `}
+ {`u-boot-#profile#_2023.10-1_arm64.deb`}
将上面两个 `deb` 包复制到板子上使用 `dpkg` 指令安装即可完成 U-Boot 安装
- {`
- sudo dpkg -i u-boot-#profile#_2023.10-1_arm64.deb
- `}
+ {`sudo dpkg -i u-boot-#profile#_2023.10-1_arm64.deb`}
安装完成后需要将 U-Boot 刷到启动介质中
- {`
- cd /usr/lib/u-boot/#product#/
- sudo ./setup.sh update_bootloader /dev/mmcblk1 #/dev/mmcblk1 为你当前使用的启动介质,需要根据实际使用的设备来选择
- sudo reboot
- `}
+ {`cd /usr/lib/u-boot/#product#/
+sudo ./setup.sh update_bootloader /dev/mmcblk1 #/dev/mmcblk1 为你当前使用的启动介质,需要根据实际使用的设备来选择
+sudo reboot`}
重启后可以观察 U-Boot 启动 log 查看 U-Boot 是否更新成功。