快来尝鲜！！使用 D1s (RDC2022 纪念版) 运行 RT-Smart

发布于 2023-01-17 15:57:19 浏览：6859 订阅该版

[tocm]

## 出厂固件上手指南

### 软件环境:

* Ubuntu20.0.4
* win10

### 硬件环境：

* RDC2022 纪念版开发板
* Type-c 头数据线

![board.png](https://oss-club.rt-thread.org/uploads/20230117/e5c61fb3163baf240f797cab63a24635.png.webp)

#### 驱动安装

1. 上电前，按住下载模式按钮。然后使用 Type-c 数据线插入下载接口给开发板上电。
2. 打开资料包中的 `zadig` 软件/ [zadig](https://zadig.akeo.ie/downloads/) 官网下载。然后参照如下所示的 “驱动安装示意图”，安装 fel 驱动。

![screenshot_fel_driver.png](https://oss-club.rt-thread.org/uploads/20230117/66ea6f46e96dc3fe36ffbc267332959b.png.webp)

#### 连接串口工具

打开 **MobaXterm** /其他终端工具，将 Type-C 数据线插入开发板下方的串口调试口，并连接到对应的端口，选择波特率为：500000。

![screenshot_mobaxterm.png](https://oss-club.rt-thread.org/uploads/20230117/429d0ec0db8fb623bf6ac54ac7821c5c.png.webp)

可以按一下开发板的 RST 按钮，可以看到终端输出以下的信息，即为出厂固件

![screenshot_start.png](https://oss-club.rt-thread.org/uploads/20230117/6a3899d6562ee99ea3408b118ca6ffc4.png)

## 二次开发指南

### 下载代码

1.下载 RT-Smart 用户态应用代码：

```shell
git clone https://github.com/RT-Thread/userapps.git
```

2.进入 userapps 目录，下载 RT-Smart 内核代码（RT-Smart 现在已经合入 master，可以直接使用主线代码）

```shell
cd  userapps && git clone https://github.com/RT-Thread/rt-thread.git
```

### 配置工具链

运行 userapps\tools 目录下 get_toolchain.py 的脚本，会下载对应的工具链并展开到userapps\tools\gun_gcc 目录。

因为 D1S 是 RISCV-64 架构的，所以输入下面的命令：

```shell
python3 tools/get_toolchain.py riscv64
```

在 userapps 目录下，运行 smart-env.sh 配置工具链路径

```shell
source smart-env.sh riscv64
```

### 编译内核程序

进入 rt-thread/bsp/allwinner/d1s 目录下

```shell
cd rt-thread/bsp/allwinner/d1s
```

使用 `scons --menuconfig` 查看配置

smart 使用的串口为 UART3 ，对应引脚为 PG8 和 PG9。

1. 检查 UART3 是否开启，以及引脚是否正确

![screenshot_uart.png](https://oss-club.rt-thread.org/uploads/20230117/14117a528c96f0ee58ce6ec734eda152.png)

2. 检查终端使用串口是否为 `uart3`

![screenshot_kernel.png](https://oss-club.rt-thread.org/uploads/20230117/5f7a96da8d4a7fa6d144d75b6958a64d.png)

3. 使用 scons 命令编译 BSP

编译完内核之后，会自动执行打包命令 `./mksdimg.sh` 打包出 sd.bin 镜像文件。此文件将在后面借助下载工具，下载到 D1s 上运行。

![screenshot_build.png](https://oss-club.rt-thread.org/uploads/20230117/b5ab2a41b0da0cc502ae14910d4cf4a1.png.webp)

### 烧录系统内核

接下来借助 fel 工具烧录系统内核。

```
boot0_sdcard_sun20iw1p1_f133.bin   ---- 第一次烧录需要烧录此boot文件（后面不需要再烧录）
sd.bin                             ---- 打包好的系统内核镜像
xfel.exe                           ---- 烧录工具
```

在 window 中的 `xfel_v1.2.9` 目录下，打开终端使用以下命令烧录固件：

- 烧录boot镜像： xfel.exe write 8192 boot0_sdcard_sun20iw1p1_f133.bin
- 烧录内核镜像： xfel.exe sd write 57344 sd.bin

![screenshot_download.png](https://oss-club.rt-thread.org/uploads/20230117/f740d0cf43ecca8a82304dc8ea92085b.png)

> 注意：执行烧录命令前，需要使开发板处于fel下载模式（按住下载按钮并上电）

### 运行用户态应用(可选)

将 D1s BSP 目录下的 `./mksdcard.sh` 拷贝到 `userapps` 下。运行该脚本，将生成的 `sdroot.bin` ，复制到 window 中的 `xfel_v1.2.9` 目录下，使用以下命令即可烧录用户态程序到存储设备 :

```
xfel.exe sd write 8388608 sdroot.bin
```

![screenshot_sdroot.png](https://oss-club.rt-thread.org/uploads/20230117/2566de67121fa4dc90413b3bfd8469eb.png)

参照下面的运行日志，运行对应的用户态应用：

```shell
msh />ls
Directory /:
hello.elf           341224
ping.elf            347336
pong.elf            342160
umailbox.elf        357440
vi.elf              517464
webclient.elf       393032
webserver.elf       489416
msh /bin>hello.elf
msh /bin>hello world!
```

可以看到 hello world 程序已经成功运行，至此我们的用户态程序已经跑起来了。

文章中涉及到的软件以及开发板资料下载：
[RDC资料.7z](https://club.rt-thread.org/file_download/50cbb5ff37a84911)

> 欢迎小伙伴们基于 RDC 2022 开发板分享更多有意思的应用/案例。最后祝大家新春愉快，新的一年 RT-Thread 继续与你同行！！