diff --git a/bsp/wch/risc-v/ch32v208w-r0/CH32V208W-R0 Getting Started Guide.md b/bsp/wch/risc-v/ch32v208w-r0/README_EN.md similarity index 94% rename from bsp/wch/risc-v/ch32v208w-r0/CH32V208W-R0 Getting Started Guide.md rename to bsp/wch/risc-v/ch32v208w-r0/README_EN.md index e925f76edc0..b53f23b5b73 100644 --- a/bsp/wch/risc-v/ch32v208w-r0/CH32V208W-R0 Getting Started Guide.md +++ b/bsp/wch/risc-v/ch32v208w-r0/README_EN.md @@ -1,6 +1,6 @@ # CH32V208W-R0 User Guide -**English** | [中文](./CH32V208W-R0上手指南.md) +**英文** | [中文](./README.md) The CH32V208W-R0 supports RT-Studio projects, and this tutorial gives an example of development instructions for the RT-Studio environment. @@ -56,7 +56,7 @@ RT-Thread has a number of software packages, which can be added to the project b ## 4 Networking with ESP8266 modules -The ESP8266 is a cost-effective, highly integrated Wi-Fi MCU for IoT applications, and can also be used as a standalone WIFI module with the following physical diagram. ESP8266 modules usually support [AT](https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-standard/programming-manual/at/at), RT-Thread provides an abstraction layer for these modules that support AT instructions, and this summary will use the AT group to communicate with ESP8266 and connect WIFI. +The ESP8266 is a cost-effective, highly integrated Wi-Fi MCU for IoT applications, and can also be used as a standalone WIFI module with the following physical diagram. ESP8266 modules usually support [AT](https://www.rt-thread.org/document/site/#/rt- thread-version/rt-thread-standard/programming-manual/at/at), RT-Thread provides an abstraction layer for these modules that support AT instructions, and this summary will use the AT group to communicate with ESP8266 and connect WIFI. diff --git a/bsp/wch/risc-v/ch32v208w-r0/README_ZN.md b/bsp/wch/risc-v/ch32v208w-r0/README_ZN.md deleted file mode 100644 index 80807cf188f..00000000000 --- a/bsp/wch/risc-v/ch32v208w-r0/README_ZN.md +++ /dev/null @@ -1,259 +0,0 @@ -# CH32V208W-R0 BSP 说明 - -**中文** | [英文](README.md) - -## 1 开发板简介 - -CH32V208W-R0 是 WCH 推出的一款基于 RISC-V 内核的开发板，最高主频为 144Mhz。比较适合入门学习 RISC-V 架构。 - -![board](./figures/ch32v208.png) - -**基本特性：** - -- MCU：CH32V208WBU6，主频 144MHz，FLASH和RAM可配置 -- LED：2个。 -- 按键：3个 Download ,Reset， User 。 -- USB：2个，Tpye-C。 -- 网口：1个，内置 10M PHY。 -- 板上无 WCH-Link 下载调试工具，需外接。 - -### 1.2 编译说明 - -板级包支持 RISC-V GCC 开发环境，以下是具体版本信息： - -| IDE/编译器 | 已测试版本 | -| ---------- | -------------------- | -| GCC | WCH RISC-V GCC 8.2.0 | - -### 1.3 使用说明 - ->本章节是为刚接触 RT-Thread 的新手准备的使用说明，遵循简单的步骤即可将 RT-Thread 操作系统运行在该开发板上，看到实验效果 。 - -### 1.4 使用Env编译BSP - -本节讲解如何使用Env工具来编译BSP工程。 - -#### 1.4.1 编译BSP - -1. [下载WCH编译工具链](https://github.com/NanjingQinheng/sdk-toolchain-RISC-V-GCC-WCH/archive/refs/tags/V1.0.0.zip) -2. 下载Env工具[最新版本](https://github.com/RT-Thread/env-windows/releases) -3. 下载RT-Thread[最新源码](https://github.com/RT-Thread/rt-thread/archive/refs/heads/master.zip) -4. 打开Env工具进入bsp目录 -5. 执行`scons --pyconfig-silent`刷新配置 -6. 执行`pkgs --update`拉取 -7. 执行 `scons --exec-path=D:\sdk-toolchain-RISC-V-GCC-WCH-1.0.0\bin` 命令，在指定工具链位置的同时直接编译。 -8. 编译完成之后会生成 **rtthread.bin** 文件。 - -![sconscompile](./figures/sconscompile.jpg) - -#### 1.4.2 硬件连接 - -使用数据线连接板载 wch-link 到 PC，打开电源开关。 - -#### 1.4.3 下载 - -打开 WCH RISC-V MCU ProgrammerTool 下载软件，选择刚刚生成的 **rtthread.bin** 文件，进行下载。 - -![tool](./figures/tool.png) - -#### 1.4.4 运行结果 - -在终端工具里打开板载 wch-link 串口（WCHDapLink SERIAL，默认115200-8-1-N），复位设备后，在串口上可以看到 RT-Thread 的输出信息： - -![end](./figures/end.png) - -### 1.5 使用VSCode编译工程 - -在Env终端中敲入命令 `scons --target=vsc` 来生成VSCode工程. 接着敲入命令 `code .` 来打开VSCode. - -使用 **VSCode 终端** 敲入命令 `scons -j12 --exec-path=D:\sdk-toolchain-RISC-V-GCC-WCH-1.0.0bin` 来编译工程。 - -![vscode-terminal](./figures/vscode-terminal.png) - -### 1.6 导入 RT-Thread Studio 工程 - -#### 1.6.1 导入 - -打开 RT-Thread Studio 后点击：文件->导入： - -![import](./figures/import.png) - -选择“RT-Thread Bsp 到工作空间中”： - -![windows](./figures/windows.png) - -填写项目信息，Bsp 根目录为 `\rt-thread\bsp\wch\risc-v\ch32v307v-r1` 目录： - -![config](./figures/config.png) - -#### 1.6.2 配置环境 - -工程导入后进行编译环境的设置，首先点击“打开构建设置”进入设置界面： - -![set](./figures/set.png) - -将编译链路径复制到 Toolchain path 中： - -![toolchain](./figures/toolchain.png) - -如图更改 Prefix ： - -![prefix](./figures/prefix.png) - -进行工具设置： - -![toolset](./figures/toolset.png) - -#### 1.6.3 编译 - -编译结果如下： - -#### ![success](./figures/success.png) - -## 2 CH32V208W-R0上手指南 - -**中文** | [English](./CH32V208W-R0 Getting Started Guide.md) - -CH32V208W-R0支持RT-Studio工程，本上手指南以RT-Studio环境的开发说明举例。 - -### 2.1 准备阶段 - -- 拉取rt-thread的github仓库到本地，[链接地址](https://github.com/RT-Thread/rt-thread)。 - -- 下载安装RT-Thread Studio,[链接地址](https://www.rt-thread.org/studio.html)。 -- 准备ESP8266模块。 - -### 2.2 BSP上手阶段 - -#### 2.2.1 点击文件，选择导入选项。 - - - -#### 2.2.2 选择导入RT-Thread Bsp 到工作空间中 - - - -
- -#### 2.2.3 按照示例填写工程信息 - - - -### 2.4 配置工程 - -导入工程后，在工程的根目录下存在参考文档readme,首先按照readme.md进行基础的配置 - -为了减小链接时添加的标准库带来的内存增大，我们可以选择使用相对占用内存较小的newlib,具体操作如下： - - - -### 2.5 编译工程 - -点击编译选项： - -![](E:/RTT/rt-thread/bsp/wch/risc-v/ch32v208w-r0/figures/4build.png) - -编译结果： - -![](E:/RTT/rt-thread/bsp/wch/risc-v/ch32v208w-r0/figures/5result.png) - -工程编译通过，至此，准备阶段完成。 - -## 3 使用RT-Studio配置BSP驱动 - -RT-Thread每个BSP已经默认适配了若干片上外设驱动与板载外设驱动，使用RT-Studio将相应的开关直接打开并依据使用环境配置相应参数即可使用。由于各个管脚存在复用功能，所以并不是所有的片上外设驱动与板载外设驱动都可以同时使用，使用时需要结合原理图来合理开启相应的外设驱动。 - -RT-Thread有许多软件软件包，使用RT-Studio将相应软件包的开关打开便可将软件包添加至工程使用。 - - - -## 4 联网实操：使用ESP8266模块联网 - -ESP8266是面向物联网应用的高性价比、高度集成的 Wi-Fi MCU,也可以将其作为一个单独的WIFI模块使用,其实物图如下。ESP8266模组通常支持[AT指令](https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-standard/programming-manual/at/at)的操作方式，RT-Thread针对这些支持AT指令的模组提供了一个抽象层,本小结将使用AT组将与ESP8266通讯并连接WIFI。 - - - -### 4.1 配置板载UART外设 - -使用AT组件与ESP8266模组通讯采用串口通讯的方式，所以需要再使能一路串口，这里我们使用UART2，串口驱动默认已经支持，我们仅需要在使用时在RT-Studio中打开即可，具体操作方式如下: - -![](E:/RTT/rt-thread/bsp/wch/risc-v/ch32v208w-r0/figures/8setting.png) - -开启选项后，`ctrl + s`保存设置，串口2即被初始化。 - -### 4.2 使用RT-Studio配置AT组件 - -点击左侧的RT-Thread Settings选项，弹出右侧的配置菜单，在搜索栏中输入AT,选择`AT设备 `，使能AT设备： - - - -选择ESP8266，并配置相应参数，示例如下: - - - -### 4.3 ESP8266模组连接 - -将板子上的`PA2`管脚与模组的`RX`管脚连接，将`PA3`管脚与模组的`TX`管脚连接，并使用开发板引出的电源为模组供电。 - - - -### 4.4 使能内核调试功能。 - -为了更加直观的了解组件的初始化过程，我们可以使能内核调试功能来观察(不需要时可以关掉)，操作方法如下： - -![](E:/RTT/rt-thread/bsp/wch/risc-v/ch32v208w-r0/figures/12kdebug.png) - -重新编译并烧录固件，shell输出如下： - -![](E:/RTT/rt-thread/bsp/wch/risc-v/ch32v208w-r0/figures/14shellinfo.png) - - - -### 4.5 wifi联网测试 - -我门在使用AT时已经配置了WIFI的ID与密码，在shell中输入`ping www.baidu.com`命令测试WIFI连接情况。 - -![](E:/RTT/rt-thread/bsp/wch/risc-v/ch32v208w-r0/figures/15ping.png) - -输出类似内容，ESP8266模组便联网成功！ - -## 5 RTduino组件 - -[RTduino](https://github.com/Yaochenger/RTduino)是RT-Thread实时操作系统的Arduino生态兼容层，为[RT-Thread社区](https://github.com/RT-Thread/rt-thread)的子社区、Arduino开源项目的下游项目，旨在兼容Arduino社区生态来丰富RT-Thread社区软件包生态（如上千种分门别类的Arduino库，以及Arduino社区优秀的开源项目），并降低RT-Thread操作系统以及与RT-Thread适配的芯片的学习门槛。 - -### 5.1 配置RTduino - -将板载设备驱动中的RTduino选项打开。 - -![](E:/RTT/rt-thread/bsp/wch/risc-v/ch32v208w-r0/figures/16rtduino.png) - -开启选项后，`ctrl + s`保存设置，RTduino软件包即可添加至工程。 - -### 5.2 使用RTduino - -在`arduino_main.cpp`中会看到熟悉的`void setup(void)`与`void loop(void)`,至此我们便可以在此像使用arduino官方板一样使用该BSP，示例代码如下： - -```c++ -#include - -void setup(void) - { - /* put your setup code here, to run once: */ - pinMode(LED_BUILTIN, OUTPUT); - } - -void loop(void) -{ - /* put your main code here, to run repeatedly: */ - digitalWrite(LED_BUILTIN, !digitalRead(LED_BUILTIN)); - delay(100); -} - -``` - - 工程默认执行一个LED闪烁的功能，ch32v208w-r0这款板子默认板载LED不与管脚直接连接，用户在使用LED时需要使用杜邦线手动将LED与控制管脚连接起来,现象如下图所示： - - - -至此ch32v208w-r0的基础环境便搭建测试完毕！ - diff --git a/bsp/wch/risc-v/ch32v208w-r0/readme.md b/bsp/wch/risc-v/ch32v208w-r0/readme.md index 739948bcbe2..8bb1a87be24 100644 --- a/bsp/wch/risc-v/ch32v208w-r0/readme.md +++ b/bsp/wch/risc-v/ch32v208w-r0/readme.md @@ -1,122 +1,252 @@ -# CH32V208W-R0 User Guide +# CH32V208W-R0 BSP 说明 -**英文** | [中文](./README_ZN.md) +**中文** | [英文](README_EN.md) -The CH32V208W-R0 supports RT-Studio projects, and this tutorial gives an example of development instructions for the RT-Studio environment. +## 1 开发板简介 -## 1 Preparation Stage +CH32V208W-R0 是 WCH 推出的一款基于 RISC-V 内核的开发板，最高主频为 144Mhz。比较适合入门学习 RISC-V 架构。 -- Pull the github repository for rt-thread locally, [link address](https://github.com/RT-Thread/rt-thread). -- Download and install RT-Thread Studio, [link to address](https://www.rt-thread.org/studio.html). -- Prepare the ESP8266 module. +![board](./figures/ch32v208.png) -## 2 BSP Start Stage +**基本特性：** -### 2.1 Click on the file and select the import option. +- MCU：CH32V208WBU6，主频 144MHz，FLASH和RAM可配置 +- LED：2个。 +- 按键：3个 Download ,Reset， User 。 +- USB：2个。 +- 网口：1个，内置 10M PHY。 +- 板上无 WCH-Link 下载调试工具，需外接。 - +### 1.2 编译说明 -### 2.2 Select to import RT-Thread BSP into the workspace +板级包支持 RISC-V GCC 开发环境，以下是具体版本信息： - +| IDE/编译器 | 已测试版本 | +| ---------- | -------------------- | +| GCC | WCH RISC-V GCC 8.2.0 | + +### 1.4 使用Env编译BSP + +本节讲解如何使用Env工具来编译BSP工程。 + +#### 1.4.1 编译BSP + +1. 从山河工作室处下载ide/工具链并安装/解压[MounRiver Studio](http://www.mounriver.com/download)。 +2. 对于安装ide的用户，推荐拷贝并重命名工具链至其他位置，避免路径中存在空格。 + * 对于mrs，工具链在`MounRiver_Studio\toolchain` + * 对于mrs2，工具链在`MounRiver_Studio2\resources\app\resources\win32\components\WCH\Toolchain` +3. 根据[Env 用户手册](https://www.rt-thread.org/document/site/#/development-tools/env/env)指引安装ENV。*nix用户和喜欢用PowerShell的用户可参考[RT-Thread/env: Python Scripts for RT-Thread/ENV](https://github.com/RT-Thread/env)。 +4. 下载或使用`git clone`获得rt-thread源码。可使用`--depth`来避免bsp瘦身计划前造成的过多历史记录。 +5. 打开env工具，使用cd命令进入bsp目录 +6. 设置环境变量以提供工具链（以下需要替换为你自己的工具链地址） + * 对于cmd与env提供的ConEmu，使用`set RTT_EXEC_PATH=C:\Users\yekai\Documents\DevTools\wch-riscv-none-elf-gcc-8\bin` + * 对于PowerShell，使用`$env:RTT_EXEC_PATH = C:\Users\yekai\Documents\DevTools\wch-riscv-none-elf-gcc-8\bin` + * 对于bash与zsh，使用`export RTT_EXEC_PATH=~/DevTools/wch-riscv-none-elf-gcc-8/bin ` +7. 执行`scons --pyconfig-silent` +8. 执行`pkgs --update`拉取所需的库 +9. 执行`scons -j4`编译项目 +10. 编译完成之后会生成 **rtthread.bin** 文件。 + +#### 1.4.2 硬件连接 + +* 不使用调试器：连接开发板到电脑 +* 使用调试器：使用杜邦线连接按钮下放排针与WCH-Link，SWDIO-DIO/SWCLK-CLK/TX-RXD/RX-TXD/GND-GND。将WCH-Link与开发板分别连接到电脑。 + +#### 1.4.3 下载 + +* 不使用调试器：打开 WCH RISC-V MCU ProgrammerTool 下载软件，选择刚刚生成的 **rtthread.bin** 文件，进行下载。 + +![tool](./figures/tool.png) + +* 使用调试器：使用`WCH-LinkUtility.exe`或`wlink`等软件下载 + +#### 1.4.4 运行结果 + +在终端工具里打开对应串口（115200-8-1-N），复位设备后，在串口上可以看到 RT-Thread 的输出信息： + +![end](./figures/end.png) + +### 1.5 使用CMake和CLion开发 + +```shell +scons --target=cmake +clion . +``` + +### 1.6 使用VSCode编译工程 + +在Env终端中敲入命令 `scons --target=vsc` 来生成VSCode工程. 接着敲入命令 `code .` 来打开VSCode. + +使用 **VSCode 终端** 敲入命令 `scons -j12 --exec-path=D:\sdk-toolchain-RISC-V-GCC-WCH-1.0.0bin` 来编译工程。 + +![vscode-terminal](./figures/vscode-terminal.png) + +### 1.7 导入 RT-Thread Studio 工程 + +#### 1.6.0 拉取sdk + +参照前文使用env编译一次即可。 + +#### 1.6.1 导入 + +打开 RT-Thread Studio 后点击：文件->导入： + +![import](./figures/import.png) + +选择“RT-Thread Bsp 到工作空间中”： + +![windows](./figures/windows.png) + +填写项目信息，Bsp 根目录为 `\rt-thread\bsp\wch\risc-v\ch32v307v-r1` 目录： + +![config](./figures/config.png) + +#### 1.6.2 配置环境 + +工程导入后进行编译环境的设置，首先点击“打开构建设置”进入设置界面： + +![set](./figures/set.png) + +将编译链路径复制到 Toolchain path 中： + +![toolchain](./figures/toolchain.png) + +如图更改 Prefix ： + +![prefix](./figures/prefix.png) + +进行工具设置： + +![toolset](./figures/toolset.png) + +#### 1.6.3 编译 + +编译结果如下： + +#### ![success](./figures/success.png) + +## 2 CH32V208W-R0上手指南 + +**中文** | [English](./CH32V208W-R0 Getting Started Guide.md) + +CH32V208W-R0支持RT-Studio工程，本上手指南以RT-Studio环境的开发说明举例。 + +### 2.1 准备阶段 + +- 拉取rt-thread的github仓库到本地，[链接地址](https://github.com/RT-Thread/rt-thread)。 + +- 下载安装RT-Thread Studio,[链接地址](https://www.rt-thread.org/studio.html)。 +- 准备ESP8266模块。 + +### 2.2 BSP上手阶段 + +#### 2.2.1 点击文件，选择导入选项。 + + + +#### 2.2.2 选择导入RT-Thread Bsp 到工作空间中 + +
-### 2.3 Fill in the project information according to the example +#### 2.2.3 按照示例填写工程信息 - + -### 2.4 Configuration Engineering +### 2.4 配置工程 -After importing the project, there is a reference document readme in the root directory of the project, first of all, follow the readme.md for basic configuration +导入工程后，在工程的根目录下存在参考文档readme,首先按照readme.md进行基础的配置 -In order to reduce the memory increase caused by the standard library added during linking, we can choose to use the relatively small memory consumption of newlib, as follows： +为了减小链接时添加的标准库带来的内存增大，我们可以选择使用相对占用内存较小的newlib,具体操作如下： - + -### 2.5 Compiling the project +### 2.5 编译工程 -Click on the compile option: +点击编译选项： -![](./figures_en/4build_en.png) +![](figures/4build.png) -Compile result: +编译结果： -![](./figures/5result.png) +![](figures/5result.png) -The project compiles and passes, and thus the preparation phase is completed. +工程编译通过，至此，准备阶段完成。 -## 3 Configuring the BSP driver with RT-Studio +## 3 使用RT-Studio配置BSP驱动 -Each BSP of RT-Thread has been configured with several on-chip peripheral drivers and onboard peripheral drivers by default, use RT-Studio to turn on the corresponding switches directly and configure the corresponding parameters according to the usage environment to use. Due to the multiplexing function of each pin, not all on-chip peripheral drivers and onboard peripheral drivers can be used at the same time, so you need to combine them with the schematic to enable the corresponding peripheral drivers. +RT-Thread每个BSP已经默认适配了若干片上外设驱动与板载外设驱动，使用RT-Studio将相应的开关直接打开并依据使用环境配置相应参数即可使用。由于各个管脚存在复用功能，所以并不是所有的片上外设驱动与板载外设驱动都可以同时使用，使用时需要结合原理图来合理开启相应的外设驱动。 -RT-Thread has a number of software packages, which can be added to the project by turning on the corresponding package switch using RT-Studio. +RT-Thread有许多软件软件包，使用RT-Studio将相应软件包的开关打开便可将软件包添加至工程使用。 - + -## 4 Networking with ESP8266 modules +## 4 联网实操：使用ESP8266模块联网 -The ESP8266 is a cost-effective, highly integrated Wi-Fi MCU for IoT applications, and can also be used as a standalone WIFI module with the following physical diagram. ESP8266 modules usually support [AT](https://www.rt-thread.org/document/site/#/rt- thread-version/rt-thread-standard/programming-manual/at/at), RT-Thread provides an abstraction layer for these modules that support AT instructions, and this summary will use the AT group to communicate with ESP8266 and connect WIFI. +ESP8266是面向物联网应用的高性价比、高度集成的 Wi-Fi MCU,也可以将其作为一个单独的WIFI模块使用,其实物图如下。ESP8266模组通常支持[AT指令](https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-standard/programming-manual/at/at)的操作方式，RT-Thread针对这些支持AT指令的模组提供了一个抽象层,本小结将使用AT组将与ESP8266通讯并连接WIFI。 - + -### 4.1 Configuring Onboard UART Peripherals +### 4.1 配置板载UART外设 -Using the AT component to communicate with the ESP8266 module using serial communication, so we need to enable one more serial port, here we use UART2, the serial driver is already supported by default, we just need to open it in RT-Studio when we use it, as follows: +使用AT组件与ESP8266模组通讯采用串口通讯的方式，所以需要再使能一路串口，这里我们使用UART2，串口驱动默认已经支持，我们仅需要在使用时在RT-Studio中打开即可，具体操作方式如下: -![](./figures_en/8setting_en.png) +![](figures/8setting.png) -After turning on the option, `ctrl + s` saves the settings and serial port 2 is initialized. +开启选项后，`ctrl + s`保存设置，串口2即被初始化。 -### 4.2 Configuring AT components with RT-Studio +### 4.2 使用RT-Studio配置AT组件 -Click on the RT-Thread Settings option on the left, the configuration menu on the right pops up, type AT in the search field, select `AT device` and enable the AT device: +点击左侧的RT-Thread Settings选项，弹出右侧的配置菜单，在搜索栏中输入AT,选择`AT设备 `，使能AT设备： - + -Select the ESP8266 and configure the appropriate parameters, as shown in the example below. +选择ESP8266，并配置相应参数，示例如下: - + -### 4.3 ESP8266 module connection +### 4.3 ESP8266模组连接 -Connect the `PA2` pin on the board to the `RX` pin of the module, connect the `PA3` pin to the `TX` pin of the module, and power the module using the power supply pinout from the development board. +将板子上的`PA2`管脚与模组的`RX`管脚连接，将`PA3`管脚与模组的`TX`管脚连接，并使用开发板引出的电源为模组供电。 - + -### 4.4 Enabling kernel debugging. +### 4.4 使能内核调试功能。 -For a more intuitive understanding of the component initialization process, we can enable the kernel debugging feature to observe it (you can turn it off when not needed) by doing the following: +为了更加直观的了解组件的初始化过程，我们可以使能内核调试功能来观察(不需要时可以关掉)，操作方法如下： -![](./figures_en/12kdebug_en.png) +![](figures/12kdebug.png) -Recompile and burn the firmware, the shell output is as follows: +重新编译并烧录固件，shell输出如下： -![](./figures/14shellinfo.png) +![](figures/14shellinfo.png) -### 4.5 wifi networking test -My door has configured the WIFI ID and password when using AT, enter the `ping www.baidu.com` command in the shell to test the WIFI connection. -![](./figures/15ping.png) +### 4.5 wifi联网测试 -Output similar content, the ESP8266 module is connected successfully! +我门在使用AT时已经配置了WIFI的ID与密码，在shell中输入`ping www.baidu.com`命令测试WIFI连接情况。 -### 5 RTduino components +![](figures/15ping.png) -[RTduino](https://github.com/Yaochenger/RTduino) is the Arduino eco-compatible layer of the RT-Thread real-time operating system, and is a sub-community of the [RT-Thread community](https://github.com/RT-Thread/rt- thread), the downstream project of the Arduino open source project, aims to be compatible with the Arduino community ecology to enrich the RT-Thread community package ecology (such as thousands of different Arduino libraries, as well as the excellent open source projects of the Arduino community), and to reduce the learning threshold of the RT-Thread operating system and the chips compatible with RT-Thread. and RT-Thread-adapted chips. +输出类似内容，ESP8266模组便联网成功！ -#### 5.1 Configuring RTduino +## 5 RTduino组件 -Turn on the RTduino option in the onboard device driver. +[RTduino](https://github.com/Yaochenger/RTduino)是RT-Thread实时操作系统的Arduino生态兼容层，为[RT-Thread社区](https://github.com/RT-Thread/rt-thread)的子社区、Arduino开源项目的下游项目，旨在兼容Arduino社区生态来丰富RT-Thread社区软件包生态（如上千种分门别类的Arduino库，以及Arduino社区优秀的开源项目），并降低RT-Thread操作系统以及与RT-Thread适配的芯片的学习门槛。 -![](./figures_en/16rtduino_en.png) +### 5.1 配置RTduino -After turning on the option, `ctrl + s` saves the settings and the RTduino package can be added to the project. +将板载设备驱动中的RTduino选项打开。 -#### 5.2 Using RTduino +![](figures/16rtduino.png) -In `arduino_main.cpp` you will see the familiar `void setup(void)` and `void loop(void)`, so we can use the BSP here like the official arduino board, the sample code is as follows: +开启选项后，`ctrl + s`保存设置，RTduino软件包即可添加至工程。 + +### 5.2 使用RTduino + +在`arduino_main.cpp`中会看到熟悉的`void setup(void)`与`void loop(void)`,至此我们便可以在此像使用arduino官方板一样使用该BSP，示例代码如下： ```c++ #include @@ -124,20 +254,21 @@ In `arduino_main.cpp` you will see the familiar `void setup(void)` and `void loo void setup(void) { /* put your setup code here, to run once: */ - pinMode(LED_BUILTIN, OUTPUT). + pinMode(LED_BUILTIN, OUTPUT); } void loop(void) { /* put your main code here, to run repeatedly: */ - digitalWrite(LED_BUILTIN, !digitalRead(LED_BUILTIN)). - delay(100). + digitalWrite(LED_BUILTIN, !digitalRead(LED_BUILTIN)); + delay(100); } ``` - By default, the project performs a blinking LED function. ch32v208w-r0, the default on-board LED is not directly connected to the pin, the user needs to manually connect the LED to the control pin using a duplex cable, the phenomenon is shown below: + 工程默认执行一个LED闪烁的功能，ch32v208w-r0这款板子默认板载LED不与管脚直接连接，用户在使用LED时需要使用杜邦线手动将LED与控制管脚连接起来,现象如下图所示： + + - +至此ch32v208w-r0的基础环境便搭建测试完毕！ -So the basic environment of ch32v208w-r0 is built and tested! \ No newline at end of file