Skip to content

Commit d53ff73

Browse files
Rbb666Rbb666
authored
add README_zh.md、led blink (RT-Thread#5666)
1 parent fa8c4bc commit d53ff73

File tree

6 files changed

+175
-78
lines changed

6 files changed

+175
-78
lines changed

‎bsp/imxrt/README.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ IMXRT 系列 BSP 目前支持情况如下表所示：
1313
| imxrt1052-fire-pro | 野火 i.MX RT1052 EVK PRO |
1414
| imxrt1052-nxp-evk | 恩智浦 i.MX RT1050 EVKB |
1515
| **i.MX RT1060 系列** | |
16-
| 暂无 | |
16+
| imxrt1060-nxp-evk | 恩智浦 i.MX RT1060 EVK |
1717
| **i.MX RT1064 系列** | |
1818
| imxrt1064-nxp-evk | 恩智浦 i.MX RT1064 EVK |
1919

‎bsp/imxrt/imxrt1060-nxp-evk/README.md

+58-70
Original file line numberDiff line numberDiff line change
@@ -1,109 +1,97 @@
1-
# BSP README 模板
1+
# NXP MIMXRT1060-EVK BSP Introduction
22

3-
## 简介
3+
[中文页](README_zh.md) |
44

5-
本文档为 MIMXRT1060-EVK 开发板的 BSP (板级支持包) 说明。
5+
This document records the instruction of the BSP (board support package) that provided by the RT-Thread development team for the MIMXRT1060-EVK development board.
66

7-
主要内容如下：
7+
The document is covered in three parts:
88

9-
- 开发板资源介绍
10-
- BSP 快速上手
11-
- 进阶使用方法
9+
- Resources Introduction
10+
- Quickly Get Started
11+
- Advanced Features
1212

13-
通过阅读快速上手章节开发者可以快速地上手该 BSP，将 RT-Thread 运行在开发板上。在进阶使用指南章节，将会介绍更多高级功能，帮助开发者利用 RT-Thread 驱动更多板载资源。
13+
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.
1414

15-
## 开发板介绍
15+
## Resources Introduction
1616

17-
开发板外观如下图所示：
17+
[![board](https://github.com/RT-Thread/rt-thread/raw/master/bsp/imxrt/imxrt1060-nxp-evk/figures/MIMXRT1060EVKB.jpg)](https://github.com/RT-Thread/rt-thread/blob/master/bsp/imxrt/imxrt1060-nxp-evk/figures/MIMXRT1060EVKB.jpg)
1818

19-
![board](figures/MIMXRT1060EVKB.jpg)
19+
Features:
2020

21-
该开发板常用 **板载资源** 如下：
21+
- MCU: MIMXRT1062DVL6A, 600MHz, 4096KB FLASH, 1024KB RAM
22+
- External RAM: IS42S16160J-6BLI, 32MB
23+
- External FLASH: S26KS512SDPBHI02, 64MB
24+
- Common-used Peripherals:
25+
- LED: One, D18(Green)
26+
- Button: One
27+
- Common-used Interfaces: USB 、SD Card、Ethernet、LCD, etc
28+
- Debugging interface, standard JTAG/SWD
2229

23-
- MCU：MIMXRT1062DVL6A，主频 600MHz，4096KB FLASH ，1024KB RAM
24-
- 外部 RAM：型号IS42S16160J-6BLI，32MB
25-
- 外部 FLASH：型号S26KS512SDPBHI02，64MB
26-
- 常用外设
27-
- LED：1个，D18（绿色）
28-
- 按键：1个
29-
- 常用接口：USB 转串口、SD 卡接口、以太网接口、LCD 接口等
30-
- 调试接口，标准 JTAG/SWD
30+
### For more details about these boards, please refer to [NXP Official Website](https://www.nxp.com/part/MIMXRT1060-EVK#/)
3131

32-
开发板更多详细信息请参考【NXP】 [MIMXRT1060-EVK开发板介绍](https://www.nxp.com.cn/design/development-boards/i-mx-evaluation-and-development-boards/i-mx-rt1060-evaluation-kit:MIMXRT1060-EVK)。
3332

34-
## 外设支持
3533

36-
本 BSP 目前对外设的支持情况如下：
3734

38-
| **板载外设** | **支持情况** | **备注** |
39-
| :----------------- | :----------: | :------------------------------------- |
40-
| USB 转串口 | 支持 | |
41-
| SPI Flash | 支持 | |
42-
| 以太网 | 支持 | |
43-
| **片上外设** | **支持情况** | **备注** |
44-
| GPIO | 支持 | PA0, PA1... PK15 ---> PIN: 0, 1...176 |
45-
| UART | 支持 | UART1 |
46-
| SPI | 暂不支持 | 即将支持 |
47-
| I2C | 暂不支持 | 即将支持 |
48-
| SDIO | 暂不支持 | 即将支持 |
49-
| RTC | 暂不支持 | 即将支持 |
50-
| PWM | 暂不支持 | 即将支持 |
51-
| USB Device | 暂不支持 | 即将支持 |
52-
| USB Host | 暂不支持 | 即将支持 |
53-
| IWG | 暂不支持 | 即将支持 |
54-
| **扩展模块** | **支持情况** | **备注** |
55-
| LVGL | 支持 | |
5635

57-
## 使用说明
36+
## Peripherals Condition
5837

59-
使用说明分为如下两个章节：
38+
Each peripheral supporting condition for this BSP is as follows:
6039

61-
- 快速上手
40+
| **On-board Peripherals** | **Support** | **Remark** |
41+
| ------------------------ | ----------- | ------------------------------------- |
42+
| USB | √ | |
43+
| SPI Flash | √ | |
44+
| Ethernet | √ | |
45+
| **On-chip Peripherals** | **Support** | **Remark** |
46+
| GPIO | √ | PA0, PA1... PK15 ---> PIN: 0, 1...176 |
47+
| UART | √ | UART1 |
48+
| SPI | | Coming Soon |
49+
| I2C | | Coming Soon |
50+
| SDIO | | Coming Soon |
51+
| RTC | | Coming Soon |
52+
| PWM | | Coming Soon |
53+
| USB Device | | Coming Soon |
54+
| USB Host | | Coming Soon |
55+
| IWG | | Coming Soon |
56+
| **Expansion Module** | **Support** | **Remark** |
57+
| LVGL | √ | |
6258

63-
本章节是为刚接触 RT-Thread 的新手准备的使用说明，遵循简单的步骤即可将 RT-Thread 操作系统运行在该开发板上，看到实验效果 。
59+
## Quickly Get Started
6460

65-
- 进阶使用
61+
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.
6662

67-
本章节是为需要在 RT-Thread 操作系统上使用更多开发板资源的开发者准备的。通过使用 ENV 工具对 BSP 进行配置，可以开启更多板载资源，实现更多高级功能。
63+
#### Hardware Connection
6864

65+
Use a cable to connect the development board to the PC and turn on the power switch.
6966

70-
### 快速上手
67+
### Compile and Download
7168

72-
本 BSP 为开发者提供 MDK4、MDK5 和 IAR 工程，以及GCC 开发环境。下面以 MDK5 开发环境为例，介绍如何将系统运行起来。
69+
Double-click the `project.uvprojx` file to open the MDK5 project, compile and download the program to the development board.
7370

74-
#### 硬件连接
71+
> The project defaults to use the CMSIS-DAP emulator to download the program, and as we're connecting the development board via USB, click the Download button can directly download the program to the development board
7572
76-
使用数据线连接开发板到 PC，打开电源开关。
73+
#### Running Results
7774

78-
#### 编译下载
75+
After the program is successfully downloaded, the system runs automatically. Observe the running results of the LED on the development board, the LED will light in 1Hz.
7976

80-
双击 project.uvprojx 文件，打开 MDK5 工程，编译并下载程序到开发板。
77+
Connect the corresponding serial port of the development board to the PC, 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:
8178

82-
> 工程默认配置使用 CMSIS-DAP 仿真器下载程序，在通过 USB 连接开发板的基础上，点击下载按钮即可下载程序到开发板
83-
84-
#### 运行结果
85-
86-
下载程序成功之后，系统会自动运行，LED会以1Hz的频率闪烁。
87-
88-
连接开发板对应串口到 PC , 在终端工具里打开相应的串口（115200-8-1-N），复位设备后，可以看到 RT-Thread 的输出信息:
89-
90-
```bash
79+
```
9180
\ | /
9281
- RT - Thread Operating System
9382
/ | \ 4.1.0 build Mar 10 2022 18:07:41
9483
2006 - 2022 Copyright by RT-Thread team
9584
msh >
9685
```
97-
### 进阶使用
98-
99-
此 BSP 默认只开启了 GPIO 和 串口1 的功能，如果需使用 SD 卡、Flash 等更多高级功能，需要利用 ENV 工具对BSP 进行配置(暂时还不支持，等待第二阶段)，步骤如下：
10086

101-
1. 在 bsp 下打开 env 工具。
87+
## **Advanced Features**
10288

103-
2. 输入`menuconfig`命令配置工程，配置好之后保存退出。
89+
This BSP only enables GPIO and UART1 by default. If you need more advanced features such as SD Card, Flash, or you need to configure the BSP with RT-Thread homegrown [ENV tool](https://www.rt-thread.io/download.html?download=Env), as follows:
10490

105-
3. 输入`pkgs --update`命令更新软件包。
91+
1. Open the ENV tool under the specific BSP folder;
92+
2. Enter `menuconfig` command to configure the project, then save and exit;
93+
3. Enter `pkgs --update` command to update the package;
94+
4. Enter `scons --target=mdk4/mdk5/iar` command to regenerate the project.
10695

107-
4. 输入`scons --target=mdk/iar` 命令重新生成工程。
96+
More details about NXP MIMXRT1060-EVK , check out [Here](https://github.com/RT-Thread/rt-thread/blob/master/bsp/imxrt/docs/IMXRT%E7%B3%BB%E5%88%97BSP%E5%A4%96%E8%AE%BE%E9%A9%B1%E5%8A%A8%E4%BD%BF%E7%94%A8%E6%95%99%E7%A8%8B.md).
10897

109-
本章节更多详细的介绍请参考 [IMXRT 系列 BSP 外设驱动使用教程](../docs/IMXRT系列BSP外设驱动使用教程.md)。

‎bsp/imxrt/imxrt1060-nxp-evk/README_zh.md

+109
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,109 @@
1+
# BSP README 模板
2+
3+
## 简介
4+
5+
本文档为 MIMXRT1060-EVK 开发板的 BSP (板级支持包) 说明。
6+
7+
主要内容如下：
8+
9+
- 开发板资源介绍
10+
- BSP 快速上手
11+
- 进阶使用方法
12+
13+
通过阅读快速上手章节开发者可以快速地上手该 BSP，将 RT-Thread 运行在开发板上。在进阶使用指南章节，将会介绍更多高级功能，帮助开发者利用 RT-Thread 驱动更多板载资源。
14+
15+
## 开发板介绍
16+
17+
开发板外观如下图所示：
18+
19+
![board](figures/MIMXRT1060EVKB.jpg)
20+
21+
该开发板常用 **板载资源** 如下：
22+
23+
- MCU：MIMXRT1062DVL6A，主频 600MHz，4096KB FLASH ，1024KB RAM
24+
- 外部 RAM：型号IS42S16160J-6BLI，32MB
25+
- 外部 FLASH：型号S26KS512SDPBHI02，64MB
26+
- 常用外设
27+
- LED：1个，D18（绿色）
28+
- 按键：1个
29+
- 常用接口：USB 转串口、SD 卡接口、以太网接口、LCD 接口等
30+
- 调试接口，标准 JTAG/SWD
31+
32+
开发板更多详细信息请参考【NXP】 [MIMXRT1060-EVK开发板介绍](https://www.nxp.com.cn/design/development-boards/i-mx-evaluation-and-development-boards/i-mx-rt1060-evaluation-kit:MIMXRT1060-EVK)。
33+
34+
## 外设支持
35+
36+
本 BSP 目前对外设的支持情况如下：
37+
38+
| **板载外设** | **支持情况** | **备注** |
39+
| :----------------- | :----------: | :------------------------------------- |
40+
| USB 转串口 | 支持 | |
41+
| SPI Flash | 支持 | |
42+
| 以太网 | 支持 | |
43+
| **片上外设** | **支持情况** | **备注** |
44+
| GPIO | 支持 | PA0, PA1... PK15 ---> PIN: 0, 1...176 |
45+
| UART | 支持 | UART1 |
46+
| SPI | 暂不支持 | 即将支持 |
47+
| I2C | 暂不支持 | 即将支持 |
48+
| SDIO | 暂不支持 | 即将支持 |
49+
| RTC | 暂不支持 | 即将支持 |
50+
| PWM | 暂不支持 | 即将支持 |
51+
| USB Device | 暂不支持 | 即将支持 |
52+
| USB Host | 暂不支持 | 即将支持 |
53+
| IWG | 暂不支持 | 即将支持 |
54+
| **扩展模块** | **支持情况** | **备注** |
55+
| LVGL | 支持 | |
56+
57+
## 使用说明
58+
59+
使用说明分为如下两个章节：
60+
61+
- 快速上手
62+
63+
本章节是为刚接触 RT-Thread 的新手准备的使用说明，遵循简单的步骤即可将 RT-Thread 操作系统运行在该开发板上，看到实验效果 。
64+
65+
- 进阶使用
66+
67+
本章节是为需要在 RT-Thread 操作系统上使用更多开发板资源的开发者准备的。通过使用 ENV 工具对 BSP 进行配置，可以开启更多板载资源，实现更多高级功能。
68+
69+
70+
### 快速上手
71+
72+
本 BSP 为开发者提供 MDK4、MDK5 和 IAR 工程，以及GCC 开发环境。下面以 MDK5 开发环境为例，介绍如何将系统运行起来。
73+
74+
#### 硬件连接
75+
76+
使用数据线连接开发板到 PC，打开电源开关。
77+
78+
#### 编译下载
79+
80+
双击 project.uvprojx 文件，打开 MDK5 工程，编译并下载程序到开发板。
81+
82+
> 工程默认配置使用 CMSIS-DAP 仿真器下载程序，在通过 USB 连接开发板的基础上，点击下载按钮即可下载程序到开发板
83+
84+
#### 运行结果
85+
86+
下载程序成功之后，系统会自动运行，LED会以1Hz的频率闪烁。
87+
88+
连接开发板对应串口到 PC , 在终端工具里打开相应的串口（115200-8-1-N），复位设备后，可以看到 RT-Thread 的输出信息:
89+
90+
```bash
91+
\ | /
92+
- RT - Thread Operating System
93+
/ | \ 4.1.0 build Mar 10 2022 18:07:41
94+
2006 - 2022 Copyright by RT-Thread team
95+
msh >
96+
```
97+
### 进阶使用
98+
99+
此 BSP 默认只开启了 GPIO 和 串口1 的功能，如果需使用 SD 卡、Flash 等更多高级功能，需要利用 ENV 工具对BSP 进行配置(暂时还不支持，等待第二阶段)，步骤如下：
100+
101+
1. 在 bsp 下打开 env 工具。
102+
103+
2. 输入`menuconfig`命令配置工程，配置好之后保存退出。
104+
105+
3. 输入`pkgs --update`命令更新软件包。
106+
107+
4. 输入`scons --target=mdk/iar` 命令重新生成工程。
108+
109+
本章节更多详细的介绍请参考 [IMXRT 系列 BSP 外设驱动使用教程](../docs/IMXRT系列BSP外设驱动使用教程.md)。

‎bsp/imxrt/imxrt1060-nxp-evk/applications/main.c

+1-1
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
#include "core_cm7.h"
1515

1616
/* defined the LED pin: GPIO1_IO9 */
17-
#define LED0_PIN GET_PIN(1, 9)
17+
#define LED0_PIN GET_PIN(1, 8)
1818

1919
int main(void)
2020
{

‎bsp/imxrt/imxrt1060-nxp-evk/board/board.c

+4-4
Original file line numberDiff line numberDiff line change
@@ -48,10 +48,10 @@ void BOARD_ConfigMPU(void)
4848
uint32_t nonCacheStart = (uint32_t)(&__base_NCACHE_REGION);
4949
uint32_t size = (uint32_t)(&__top_NCACHE_REGION) - nonCacheStart;
5050
#elif defined(__ICCARM__) || defined(__GNUC__)
51-
extern uint32_t __NCACHE_REGION_START[];
52-
extern uint32_t __NCACHE_REGION_SIZE[];
53-
uint32_t nonCacheStart = (uint32_t)__NCACHE_REGION_START;
54-
uint32_t size = (uint32_t)__NCACHE_REGION_SIZE;
51+
extern uint32_t __noncachedata_start__[];
52+
extern uint32_t __noncachedata_end__[];
53+
uint32_t nonCacheStart = (uint32_t)__noncachedata_start__;
54+
uint32_t size = (uint32_t)((uint32_t)__noncachedata_end__ - (uint32_t)__noncachedata_start__);
5555
#endif
5656
volatile uint32_t i = 0;
5757

‎bsp/imxrt/imxrt1060-nxp-evk/xip/fsl_flexspi_nor_boot.h

+2-2
Original file line numberDiff line numberDiff line change
@@ -75,8 +75,8 @@ extern uint32_t __Vectors[];
7575
extern uint32_t __VECTOR_TABLE[];
7676
#define IMAGE_ENTRY_ADDRESS ((uint32_t)__VECTOR_TABLE)
7777
#elif defined(__GNUC__)
78-
extern uint32_t __VECTOR_TABLE[];
79-
#define IMAGE_ENTRY_ADDRESS ((uint32_t)__VECTOR_TABLE)
78+
extern uint32_t __isr_vector[];
79+
#define IMAGE_ENTRY_ADDRESS ((uint32_t)__isr_vector)
8080
#endif
8181

8282
#if defined(XIP_BOOT_HEADER_DCD_ENABLE) && (1 == XIP_BOOT_HEADER_DCD_ENABLE)

0 commit comments

Comments
 (0)