This document records the execution instruction of the BSP (board support package) provided by the RT-Thread development team for the NXP i. MX RT1050 EVK development board.
- NXP i. MX RT1050 EVK Board Resources Introduction
- Quickly Get Started
- Advanced Features
## 开发板介绍
By reading the Quickly Get Started section developers can quickly get their hands on this BSP and run RT-Thread on the board. More advanced features will be introduced in the Advanced Features section to help developers take advantage of RT-Thread to drive more on-board resources.
The i.MX RT1050 EVK is a development board based on ARM Cortex-M7. The maximum main frequency is 600 MHz, and it has a wealth of on-board resources that can take full advantage of the RT1052's chip performance.
This BSP provides MDK 5 and IAR projects for developers and it supports the GCC development environment. Here's an example of the MDK5 development environment, to introduce how to run the system.
Double-click the project.uvprojx file, to open the MDK 5 project, compile and download the project to the board.
> By default, the project uses the CMSIS-DAP to download the program, when the CMSIS-DAP connects the board, clicking the download button can download the program to the board.
Once the project is successfully downloaded, the system runs automatically. The green LED on the board will flash periodically.
#### 硬件连接
Connect the serial port of the board to the PC, communicate with it via a serial terminal tool(115200-8-1-N). Reset the board and the startup information of RT-Thread will be observed:
This BSP only enables GPIO and serial port 1 by default. If you need more advanced features, you need to configure the BSP with RT-Thread [Env tools](https://www.rt-thread.io/download.html?download=Env), as follows:
维护人:
1. Open the env tool under BSP;
2. Enter menuconfig command to configure the project, then save and exit;
3. Enter pkgs --update command to update the package;
4. Enter scons --target=mdk4/mdk5/iar command to regenerate the project.
-[tyustli](https://github.com/tyustli)
\ No newline at end of file
Learn how to use RT-Thread Env, click [Here](https://github.com/RT-Thread/rtthread-manual-doc/blob/master/env/env.md).
# Raspberry PI 3B 32 BSP (Board Support Package) Execution Instruction
## 1. 简介
[中文页](README_zh.md) |
树莓派由注册于英国的慈善组织“Raspberry Pi 基金会”开发，莓派3采用4核Broadcom BCM2837 (ARMv8)芯片、双核VideoCore IV GPU和1GB内存。
## Introduction
这份RT-Thread BSP是针对 Raspberry Pi 3B （32位）的一份移植，树莓派价格便宜, 使用者甚众，是研究和运行RT-Thread的可选平台之一。
This document records the execution instruction of the BSP (board support package) provided by the RT-Thread development team for the Raspberry PI 3B 32 development board.
The cross-compiler gcc-arm-none-eabi-4_8-2014q1_linux is recommended in Linux environment. If you don’t have compiling tool, please uncompress the downloaded package like this:
```
tar vxf gcc-arm-none-eabi-5_4-2016q3-20160926-linux.tar.bz2
tar vxf gcc-arm-none-eabi-4_8-2014q1_linux.tar.bz2
In Linux environment, you need to modify the settings of the compiler directory, and modify the actual directory of the compiling tool in bsp/raspi3-32/rtconfig. py, remember to add the suffix /bin here.
If everything goes well, a new 'rtthread.elf' and 'kernel7.img' file will be generated. ‘kernel7.img' is what we need to put into the root directory of the Raspberry PI 3B SD card.
- Step 2: Open eclipse cdt and set workspace, and set the workspace to 'rt-thread/bsp/raspberry-pi/raspi3-32'.
- Step 3: Import the project by selecting 'General->Existing Projects into Workspace' and then 'Browse ...'. Noted that the compiling only supports scons now.
## 3. 执行
## **Running**
### 3.1 下载[raspbian镜像][3]，生成可以运行的raspbian SD卡
### **Prepare the [Raspbian](https://downloads.raspberrypi.org/raspbian_lite_latest) SD card**
Windows下，去[etcher.io][4]下载etcher,这是个可以烧写img的工具
Download the raspbian image, for example, "2018-06-27-raspbian-stretch-lite.zip". Unpack it.
解开下载的镜像文件, linux下使用如下的命令
**Burn the SD card on Windows**
```
unzip 2018-06-27-raspbian-stretch-lite.zip
```
On Windows, download the burning tool " [etcher.io](https://www.balena.io/etcher/) ", run it and choose the unpacked image "2018-06-27-raspbian-stretch-lite.img".
准备一张空SD卡，linux环境下，插入电脑并执行
When the burning process is completed, put "kernel8.img" into the boot partition to replace the file wit the same name.
This document records the execution instruction of the BSP (board support package) provided by the RT-Thread development team for the Raspberry PI 3–64 development board.
这份RT-Thread BSP是针对 Raspberry Pi 3 64位模式的一份移植，树莓派价格便宜, 使用者甚众，是研究和运行RT-Thread的可选平台之一。
## **Compilation Instruction**
### Build Environment on Windows
## 2. 编译说明
It's recommended to use the [env tool ](https://github.com/RT-Thread/rtthread-manual-doc/blob/master/env/env.md)to compile the Raspberry PI 3–64 BSP on Windows. Firstly, download the compiler GCC on Windows, from the official ARM website. You can refer to [Here](https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-a/downloads).
### 2.1 Window上的环境搭建
Here we choose the version "[gcc-arm-8.3–2019.03-i686-mingw32-aarch64-elf].
Windows环境下推荐使用[env工具][1]进行编译。
Unzip the compressed package to the local directory, like "E:/env/tools/gnu_gcc/arm_gcc".
collect2.exe:fatal error:CreateProcess:No such file or directory
```
### Build Environment on Linux
### 2.2 Linux上的环境搭建
The steps to build Raspberry PI 3–64 BSP on Linux is pretty similar to that on Windows, the only difference is that we need to download the GCC on Linux instead, such as the version "gcc-arm-8.3–2019.03-x86_64-aarch64-elf".
Then we unpack the compiler package, modify the file "rtconfig.h" and run "scons".
直接进入`bsp\raspberry-pi\raspi3-64`，输入scons编译即可。
## Execution
### Prepare the raspbian SD card
## 3. 执行
- Download the raspbian image, for example, "2018–06–27-raspbian-stretch-lite.zip". Unpack it.
### 3.1 下载[raspbian镜像][3]，生成可以运行的raspbian SD卡
- Burn the SD card on Windows
Windows下，去[etcher.io][4]下载etcher,这是个可以烧写img的工具
On Windows, download the burning tool "[etcher.io](http://etcher.io/)", run it and choose the unpacked image "2018–06–27-raspbian-stretch-lite.img".
解开下载的镜像文件, linux下使用如下的命令
When the burning process is completed, put "kernel8.img" into the boot partition to replace the file wit the same name.
```
unzip 2018-06-27-raspbian-stretch-lite.zip
```
- Burn the SD card on Linux
准备一张空SD卡，linux环境下，插入电脑并执行
Prepare an empty SD card, plug it in the computer and then execute the command below: "sudo dd if=2018–06–27-raspbian-stretch-lite.img of=/dev/xxx bs=32M conv=fsync"
The BSP uses GPIO 14 & GPIO 15 of raspi 3 as the communication ports, as shown in the following image (The board is raspberry-pi2, which uses the same pins as raspi-3):
The toolchain currently used for test is built from the standard GNU GCC 7.2.0 and newlib 2.5.0 and for the standard RV32IMC architecture, so the extension instructions of RV32M1 is not supported, note that the version of RT-Thread ENV used in this BSP is 1.0.
scons
It's recommended to use the [env tool](https://www.rt-thread.io/download.html?download=Env) to compile programs on Windows. Switch to the directory `bsp/rv32m1_vega/ri5cy` in the console and run the following command to compile this BSP:
Please use JLink to connect to the JTAG interface of the RISC-V core on the RV32M1_VEGA board, and change the JLink driver to WinUSB mode. The JTAG interface is located next to the RV32M1 chip and the antenna seat, with a small 20pin JTAG interface.
Use a USB cable to connect to a USB port marked with SDA, then a serial device is recognized by PC, which can be opened with the configuration of 115200-N-8-1. The serial pins used by the device are: `[PTC7/PTC8]`
When the rtthread.bin image file is generated after being correctly compiled, you can use gdb to connect to openocd and burn it to flash with the `load` command.
For more information about how to use JTAG and how to use gdb to debug the RV32M1_VEGA development board, please refer to [Development Environment Construction](https://github.com/open-isa-org/open-isa-org/open-isa.org/blob/master/RV32M1_Vega_Develop_Environment_Setup.pdf).
When the compiling and burning are done correctly, press the reset button `SW1` to reset the device, the startup message of RT-Thread can be observed via the serial port :
- Chip [Reference Manual and Data Sheet](https://github.com/open-isa-org/open-isa.org/blob/master/Reference Manual and Data Sheet/RV32M1DS_Rev.1.1.pdf)
This document records the execution instruction of the BSP (board support package) provided by the RT-Thread development team for the STM32F091RC-Nucleo development board.
By reading the Quickly Get Started section developers can quickly get their hands on this BSP and run RT-Thread on the board. More advanced features will be introduced in the Advanced Features section to help developers take advantage of RT-Thread to drive more on-board resources.
STM32F091RC-NuCLEO 开发板是 ST 官方推出的一款基于 ARM Cortex-M0 内核的开发板，最高主频为 48Mhz，该开发板具有丰富的扩展接口，可以方便验证 STM32F091 的芯片性能。
## STM32F091RC-Nucleo Resources Introduction
开发板外观如下图所示：
The STM32F091RC-Nucleo is a development board that contains a ARM Cortex-M0. The maximum main frequency is 48 MHz, and it has a wealth of on-board resources that can take full advantage of the STM32F091's chip performance.
The mainly-used resources of this board are shown as follows:
- MCU：STM32F091RC，主频 48MHz，256KB FLASH ，32KB RAM
- 外部 RAM：无
- 外部 FLASH：无
- 常用外设
- 按键：1个，user（兼具唤醒功能，PC13）
- 常用接口：USB 转串口、arduino 接口等
- 调试接口，标准 SWD
- MCU: STM32F091, Main Frequency 48MHz, 256KB FLASH, 32KB RAM
- External RAM: None
- External FLASH: None
- Common peripherals -Button: one, user (has the wake-up feature, PC13)
- Common-used interfaces: USB, Arduino interface, etc.
- Debug interface: standard SWD For more details about this board, please refer to [ST official](https://www.st.com/en/evaluation-tools/stm32-nucleo-boards.html?querycriteria=productId=LN1847).
This BSP provides MDK4, MDK5, and IAR projects for developers and it supports the GCC development environment. Here's an example of the MDK5 development environment, to introduce how to run the system.
Once the project is successfully downloaded, the system runs automatically.
#### 硬件连接
Connect the serial port of the board to PC, communicate with it via a serial terminal tool (115200bps, 8N1). Restart the board and the startup information of RT-Thread will be observed:
This BSP only enables GPIO and serial port 2 by default. If you need more advanced features such as SPI, I2C, you need to configure the BSP with RT-Thread [ENV tools](https://www.rt-thread.io/download.html?download=Env) , as follows:
## 联系人信息
1. Open the env tool under BSP;
2. Enter menuconfig command to configure the project, then save and exit;
3. Enter pkgs --update command to update the package;
4. Enter scons --target=mdk4/mdk5/iar command to regenerate the project.
维护人:
Learn how to use RT-Thread Env, click [Here](https://github.com/RT-Thread/rtthread-manual-doc/blob/master/env/env.md).
# STM32F401 Nucleo-64 BSP (Board Support Package) Execution Instruction
## 简介
[中文页](README_zh.md) |
本文档为 STM32F401 Nucleo-64 开发板的 BSP (板级支持包) 说明。
## Introduction
主要内容如下：
This document records the execution instruction of the BSP (board support package) provided by the RT-Thread development team for the STM32F401 Nucleo-64 development board.
By reading the Quickly Get Started section developers can quickly get their hands on this BSP and run RT-Thread on the board. More advanced features will be introduced in the Advanced Features section to help developers take advantage of RT-Thread to drive more on-board resources.
STM32 Nucleo-64 是 ST 官方推出的开发板，搭载 STM32F401RE 芯片，基于 ARM Cortex-M4 内核，最高主频 84 MHz，具有丰富的板载资源，可以充分发挥 STM32F401RE 的芯片性能。
## Board Resources Introduction
开发板外观如下图所示：
The STM32 Nucleo-64 is a development board based on STM32F401RE, which contains a Cortex-M4 core. The maximum main frequency is 84 MHz, and it has a wealth of on-board resources that can take full advantage of the STM32F401RE's chip performance.
- 3 LEDs: USB communication (LD1), user LED (LD2), power LED (LD3)
- 2 Buttons: USER and RESET
- Common-used interface: USB, Arduino Uno, and ST morpho
- Debug interface: ST-LINK/V2-1
*更多相关信息资料见 ST 官网详情页：[STM32 Nucleo-64 development board with STM32F401RE MCU](https://www.st.com/zh/evaluation-tools/nucleo-f401re.html)*
For more details about this board, please refer to the ST official documentation: [STM32 Nucleo-64 development board with STM32F401RE MCU](https://www.st.com/zh/evaluation-tools/nucleo-f401re.html)
## 外设支持
## Peripheral Condition
本 BSP 目前对外设的支持情况如下：
Each peripheral supporting condition for this BSP is as follows:
This BSP provides MDK5 and IAR projects for developers. Also support GCC development environment Here's an example of the MDK5 development environment, to introduce how to run the system.
Double-click the project.uvprojx file, to open the MDK5 project, compile and download the program to the board.
### 快速上手
> By default, the project uses ST_LINK simulator to download the program, when the ST_LINK connects the board, clicking the download button can download the program to the board.
After the program is successfully downloaded, the system runs automatically. Observe the running results of the LED on the development board, the red LD3 and LD1 will lit all the time, green LD2 will flash periodically.
使用 Type-A to Mini-B 线连接开发板和 PC 供电，红色 LED LD3 (PWR) 和 LD1 (COM) 会点亮。
The USB virtual COM port connects to serial port 2 by default, and when the corresponding serial port (115200-8-1-N) is opened in the terminal tool, the output information of RT-Thread can be seen when the device is reset:
#### 编译下载
双击 project.uvprojx 文件，打开 MDK5 工程，编译并下载程序到开发板。
> 工程默认配置使用 ST-LINK 下载程序，点击下载按钮即可下载程序到开发板。
#### 运行结果
下载程序成功之后，系统会自动运行，观察开发板上 LED 的运行效果，红色 LD3 和 LD1 常亮、绿色 LD2 会周期性闪烁。
USB 虚拟 COM 端口默认连接串口 2，在终端工具里打开相应的串口（115200-8-1-N），复位设备后，可以看到 RT-Thread 的输出信息:
This BSP only enables GPIO and serial port 2 by default. If need more advanced features, you need to configure the BSP with RT-Thread Env tools, as follows:
2. 输入 `menuconfig` 命令配置工程，配置好之后保存退出。
- Open the [Env](https://www.rt-thread.io/download.html?download=Env) tool under this BSP;
3. 输入 `pkgs --update` 命令更新软件包。
- Enter the `menuconfig` command to configure the project, then save and exit;
4. 输入 `scons --target=mdk4/mdk5/iar` 命令重新生成工程。
- Enter the `pkgs --update` command to update the packages;
This document records the execution instruction of the BSP (board support package) provided by the RT-Thread development team for the STM32H747-ST-DISCOVERY development board.
By reading the Quickly Get Started section developers can quickly get their hands on this BSP and run RT-Thread on the board. More advanced features will be introduced in the Advanced Features section to help developers take advantage of RT-Thread to drive more on-board resources.
STM32H747I-DISCO 是 ST 推出的一款基于 ARM Cortex-M7 内核的开发板，最高主频为 480Mhz，该开发板具有丰富的板载资源，可以充分发挥 STM32H747 的芯片性能。
## Board Resources Introduction
开发板外观如下图所示：
The STM32H747-ST-DISCOVERY is a development board that contains a ARM Cortex-M7. The maximum main frequency is 480 MHz, and it has a wealth of on-board resources that can take full advantage of the STM32H747's chip performance.
开发板更多详细信息请参考 ST 官方介绍页面 [STM32H747I-DISCO](https://www.st.com/content/st_com/en/products/evaluation-tools/product-evaluation-tools/mcu-mpu-eval-tools/stm32-mcu-mpu-eval-tools/stm32-discovery-kits/stm32h747i-disco.html)。
The mainly-used resources of this board are shown as follows:
## 外设支持
- MCU: STM32H747
- Main Frequency 480MHz
- Memory: 2MB FLASH, 1MB RAM
- Common-used peripherals: USB、Ethernet、arduino API etc.
- Debug interface: Standard JTAG/SWD.
本 BSP 目前对外设的支持情况如下：
For more details about this board, please refer to the ST official documentation [STM32H747I-DISCO](https://www.st.com/content/st_com/en/products/evaluation-tools/product-evaluation-tools/mcu-mpu-eval-tools/stm32-mcu-mpu-eval-tools/stm32-discovery-kits/stm32h747i-disco.html)。
This BSP provides MDK 5 and IAR projects for developers and it supports the GCC development environment. Here's an example of the MDK5 development environment, to introduce how to run the system.
Use a USB cable to connect the development board to the PC and turn on the power switch.
#### **Compile and Download**
### 快速上手
Double-click the project.uvprojx file, to open the MDK 5 project (MDK requires to download V 5.29 and above to support ST-LINK V3), compile and download the project to the board.
> By default, the project uses the ST_LINK simulator to download the program, when the ST_LINK connects the board, clicking the download button can download the program to the board.
#### 硬件连接
### **Running Results**
使用数据线连接开发板到 PC，打开电源开关。
Once the project is successfully downloaded, the system runs automatically, and LED will flash.
#### 编译下载
Connect the serial port of the board to PC, communicate with it via a serial terminal tool (115200-8-1-N). Restart the board and the startup information of RT-Thread will be observed:
This BSP only enables GPIO and serial port 1 by default. If you need more advanced features, you need to configure the BSP with [RT-Thread ENV tools](https://www.rt-thread.io/download.html?download=Env) , as follows:
- 调试串口为串口 1 映射说明
1. Open the env tool under BSP.
2. Enter menuconfig command to configure the project, then save and exit.
3. Enter pkgs --update command to update the package.
4. Enter scons --target=mdk4/mdk5/iar command to regenerate the project.
PA9 ------> USART1_TX
Learn how to use RT-Thread Env, click [Here](https://github.com/RT-Thread/rtthread-manual-doc/blob/master/env/env.md).
PA10 ------> USART1_RX
## **Notes**
## 联系人信息
- Debug serial port has the mapping description for serial port 1.
STM32H747I-DISCO 是 ST 推出的一款基于 ARM Cortex-M7 内核的开发板，最高主频为 480Mhz，该开发板具有丰富的板载资源，可以充分发挥 STM32H747 的芯片性能。
开发板外观如下图所示：
该开发板常用 **板载资源** 如下：
- MCU：STM32H747，主频 480MHz，2MB FLASH ，1MB RAM
- 常用接口：USB 转串口、以太网接口、arduino 接口等
- 调试接口，标准 JTAG/SWD
开发板更多详细信息请参考 ST 官方介绍页面 [STM32H747I-DISCO](https://www.st.com/content/st_com/en/products/evaluation-tools/product-evaluation-tools/mcu-mpu-eval-tools/stm32-mcu-mpu-eval-tools/stm32-discovery-kits/stm32h747i-disco.html)。
