summaryrefslogtreecommitdiff
path: root/bsp/imxrt
diff options
context:
space:
mode:
authorYaochenger <[email protected]>2023-04-18 11:06:47 +0800
committerYunjie Gu <[email protected]>2023-04-19 10:26:15 +0100
commita3c5ce717ca962ff825fd06182e1fe97bad63653 (patch)
tree74cabd55e4915ae0da18d787a2ed430b611c18f8 /bsp/imxrt
parent1c886a857cea3cddbfc8c57ec0095198797a6f76 (diff)
[bsp][readme]合并ch32v208与RT1060的readme
Diffstat (limited to 'bsp/imxrt')
-rw-r--r--bsp/imxrt/imxrt1060-nxp-evk/MIMXRT1060-EVK User Manual.md128
-rw-r--r--bsp/imxrt/imxrt1060-nxp-evk/MIMXRT1060-EVK上手指南.md133
-rw-r--r--bsp/imxrt/imxrt1060-nxp-evk/README.md144
-rw-r--r--bsp/imxrt/imxrt1060-nxp-evk/README_zh.md157
4 files changed, 281 insertions, 281 deletions
diff --git a/bsp/imxrt/imxrt1060-nxp-evk/MIMXRT1060-EVK User Manual.md b/bsp/imxrt/imxrt1060-nxp-evk/MIMXRT1060-EVK User Manual.md
deleted file mode 100644
index 85da1bad2b..0000000000
--- a/bsp/imxrt/imxrt1060-nxp-evk/MIMXRT1060-EVK User Manual.md
+++ /dev/null
@@ -1,128 +0,0 @@
-# MIMXRT1060-EVK User Manual
-
-**English** | [中文](MIMXRT1060-EVK上手指南.md)
-
-This manual records the execution instruction of the MIMXRT1060-EVK on RT-Thread homebuilt IDE RT-Thread Studio.
-
-## 1 Preparation
-
-- Clone the RT-Thread repository from GitHub to your local. [Link](https://github.com/RT-Thread/rt-thread)
-- Download and install RT-Thread Studio. [Link](https://www.rt-thread.io/studio.html)
-- Prepare the [RW007](https://github.com/RT-Thread-packages/rw007/blob/master/README.md) module.
-
-## 2 Quickly Get Started
-
-### 2.1 menuconfig to configure the project
-
-Open the directory where the MIMXRT1060-EVK BSP is located and use the menuconfig command in the [ENV tool](https://www.rt-thread.io/download.html?download=Env) to configure the project
-
-![](./figures/6.png)
-
-### 2.2 Cancel the configuration that is not needed, as follows:
-
-Set the Onboard Peripheral Drivers option:
-
-![](./figures/4.png)
-
-Set the On-chip Peripheral Drivers option:
-
-![](./figures/5.png)
-
-### 2.3 Go to File, and click the Import
-
-![](./figures/1_en.png)
-
-### 2.4 Import RT-Thread BSP to workspace
-
-![](./figures/2_en.png)
-
-### 2.5 Fill out the project info
-
-![](./figures/3_en.png)
-
-### 2.6 Compile project
-
-![](./figures/8.png)
-
-Till now, the project is compiled, and the preparation is completed.
-
-## 3 Use RT-Studio to Configure BSP Driver
-
-Each BSP of RT-Thread already has several drivers by default, such as on-chip peripheral driver and on-board peripheral driver, and the drivers can be enabled by opening the corresponding configuration and setting the parameters according to the use environment on RT-Studio IDE. Since the pin has the multiplexing function, it may not have both the available on-chip peripheral driver and on-board peripheral driver at the same time, so it is necessary to check the schematic while enabling the corresponding peripheral drivers.
-
-RT-Thread has a lot of up-for-grab software packages, by using RT-Studio IDE, the software packages can be easily added to the project.
-
-![](./figures/17_en.png)
-
-## 4 Connect to Internet: Use the RW007 module
-
-The RW007 is a high-speed WIFI module that uses SPI to communicate with the host. Check the [User Manual](https://github.com/RT-Thread-packages/rw007/blob/master/README.md).
-
-The SPI interface provided by the MIMXRT1060-EVK onboard Arduino interface has duplicate pins with the pins used by the SDIO interface of the SD card, so the on-board SPI interface is not connected by default. We'll be needing you to connect it, check out the location marked DNP in the schematic diagram below (this step is necessary when using the SPI interface). You can use the SPI interface led by the onboard Arduino interface, in this case, the on-board SD card slot is not available.
-
-![](./figures/11.png)
-
-### 4.1 Configure the onboard SPI peripherals
-
-RW007 supports SPI interface for communication, MIMXRT1060-EVK supports SPI driver, defaults to using polling mode to communicate with RW007 (currently it does not support interrupt and DMA mode to communicate with RW007), the following shows how to use RT-Studio to configure SPI:
-
-![](./figures/10_en.png)
-
-### 4.2 Configure the RW007 package using RT-Studio
-
-Click the RT-Thread Settings option on the left, there is a configuration menu will be shown on the right, enter RW007 in the search bar, and select `rw007:SPI WIFI rw007 driver`, the corresponding configuration parameters are as follows:
-
-![](./figures/9_en.png)
-
-### 4.3 Plug the RW007 module into the onboard Arduino interface
-
-![](./figures/12.png)
-
-### 4.4 Modify the RW007 example
-
-Since the default example of the RW007 package is based on the STM32, minor modifications are required on the RT1060-EVK, modify the `rw007_stm32_port.c` file in the example folder in the RW007 package.
-
-Modify the `int wifi_spi_device_init(void)` function, replacing the example with the code given below:
-
-```
-int wifi_spi_device_init(void)
-{
- char sn_version[32];
-
- rw007_gpio_init();
- rt_hw_spi_device_attach(RW007_SPI_BUS_NAME, "wspi", RW007_CS_PIN);
- rt_hw_wifi_init("wspi");
-
- rt_wlan_set_mode(RT_WLAN_DEVICE_STA_NAME, RT_WLAN_STATION);
- rt_wlan_set_mode(RT_WLAN_DEVICE_AP_NAME, RT_WLAN_AP);
-
- rw007_sn_get(sn_version);
- rt_kprintf("\nrw007 sn: [%s]\n", sn_version);
- rw007_version_get(sn_version);
- rt_kprintf("rw007 ver: [%s]\n\n", sn_version);
-
- return 0;
-}
-```
-
-### 4.5 After the modification is completed, compile the project and burn the firmware
-
-![](./figures/13.png)
-
-`rw007 sn` and `rw007 ver` are successfully output, and RW007 driver is successfully connected.
-
-### 4.6 WIFI connection test
-
-Enter the `wifi scan` command into the shell to search for WIFI.
-
-![](./figures/14.png)
-
-Enter `wifi` and press `tab` to list wifi-related commands:
-
-![](./figures/15.png)
-
-Use the ping command to test if the WIFI connection is available:
-
-![](./figures/16.png)
-
-At this point, the basic environment of the MIMXRT1060-EVK is successfully set up! \ No newline at end of file
diff --git a/bsp/imxrt/imxrt1060-nxp-evk/MIMXRT1060-EVK上手指南.md b/bsp/imxrt/imxrt1060-nxp-evk/MIMXRT1060-EVK上手指南.md
deleted file mode 100644
index f8bc4328da..0000000000
--- a/bsp/imxrt/imxrt1060-nxp-evk/MIMXRT1060-EVK上手指南.md
+++ /dev/null
@@ -1,133 +0,0 @@
-# MIMXRT1060-EVK上手指南
-
-**中文** | [English](MIMXRT1060-EVK User Manual.md)
-
-MIMXRT1060-EVK支持RT-Studio工程,本上手指南以RT-Studio环境的开发说明举例。
-
-## 1 准备阶段
-
-- 拉取rt-thread的github仓库到本地,[链接地址](https://github.com/RT-Thread/rt-thread)。
-
-- 下载安装RT-Thread Studio,[链接地址](https://www.rt-thread.org/studio.html)。
-- 准备RW007模块。
-
-## 2 BSP上手阶段
-
-### 2.1 menuconfig配置工程
-
-打开MIMXRT1060-EVK BSP所在目录,在ENV工具中使用menuconfig命令配置工程
-
-![](./figures/6.png)
-
-### 2.2 取消暂时不需要的配置,具体操作如下:
-
-Onboard Peripherial Drivers选项设置:
-
-![](./figures/4.png)
-
-On-chip Peripherial Drivers选项设置:
-
-![](./figures/5.png)
-
-### 2.3 点击文件,选择导入选项。
-
-![](./figures/1.png)
-
-### 2.4 选择导入RT-Thread Bsp 到工作空间中
-
-![](./figures/2.png)
-
-<div STYLE="page-break-after: always;"></div>
-
-### 2.5 按照示例填写工程信息
-
-![](./figures/3.png)
-
-<div STYLE="page-break-after: always;"></div>
-
-### 2.6 编译工程
-
-![](./figures/8.png)
-
-工程编译通过,至此,准备阶段完成。
-
-## 3 使用RT-Studio配置BSP驱动
-
-RT-Thread每个BSP已经默认适配了若干片上外设驱动与板载外设驱动,使用RT-Studio将相应的开关直接打开并依据使用环境配置相应参数即可使用。由于各个管脚存在复用功能,所以并不是所有的片上外设驱动与板载外设驱动都可以同时使用,使用时需要结合原理图来合理开启相应的外设驱动。
-
-RT-Thread有许多软件软件包,使用RT-Studio将相应软件包的开关打开便可将软件包添加至工程使用。
-
-![](./figures/17.png)
-
-## 4 联网实操:使用RW007模块联网
-
-RW007 是由上海睿赛德电子科技有限公司开发的高速 WiFi 模块,使用 SPI 与主机通信。[RW007使用指南链接](https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-standard/application-note/packages/rw007_module_using/an0034-rw007-module-using)。
-
-MIMXRT1060-EVK板载arduino接口提供的SPI接口与SD卡的SDIO接口使用的管脚存在重复的管脚,所以板载的SPI接口默认未连接,将下方**原理图中标记DNP的地方连接起来(使用SPI接口一定要做这一步!!!)**便可以使用板载arduino接口引出的SPI接口,此时板载的SD卡槽不可使用。
-
-![](./figures/11.png)
-
-### 4.1 配置板载SPI外设
-
-RW007可采用SPI接口通讯,MIMXRT1060-EVK支持SPI驱动,默认采用轮询的方式与RW007通讯(暂不支持中断与DMA模式与RW007通讯),使用RT-Studio配置SPI的具体配置如下:
-
-![](./figures/10.png)
-
-### 4.2 使用RT-Studio配置RW007软件包
-
-点击左侧的RT-Thread Settings选项,弹出右侧的配置菜单,在搜索栏中输入RW007,选择`rw007:SPI WIFI rw007 driver `,相应配置参数如下:
-
-![](./figures/9.png)
-
-### 4.3 将RW007模块插入板载的arduino接口
-
-![](./figures/12.png)
-
-### 4.4 修改RW007示例
-
-由于RW007软件包的默认示例是基于STM32的示例,所以在RT1060-EVK上需进行少量的修改,修改RW007软件包中的example文件夹中的rw007_stm32_port.c文件。
-
-修改`int wifi_spi_device_init(void)`函数,使用下述给出的代码替换原有的示例:
-
-```c
-int wifi_spi_device_init(void)
-{
- char sn_version[32];
-
- rw007_gpio_init();
- rt_hw_spi_device_attach(RW007_SPI_BUS_NAME, "wspi", RW007_CS_PIN);
- rt_hw_wifi_init("wspi");
-
- rt_wlan_set_mode(RT_WLAN_DEVICE_STA_NAME, RT_WLAN_STATION);
- rt_wlan_set_mode(RT_WLAN_DEVICE_AP_NAME, RT_WLAN_AP);
-
- rw007_sn_get(sn_version);
- rt_kprintf("\nrw007 sn: [%s]\n", sn_version);
- rw007_version_get(sn_version);
- rt_kprintf("rw007 ver: [%s]\n\n", sn_version);
-
- return 0;
-}
-```
-
-### 4.5 修改完成后,编译工程,烧录固件。
-
-![](./figures/13.png)
-
-`rw007 sn`与`rw007 ver`可以正常输出无乱码时,RW007驱动成功!
-
-### 4.6 wifi联网测试
-
-在shell中输入`wifi scan`命令搜索WIFI。
-
-![](./figures/14.png)
-
-输入`wifi`,按`tab`键列出wifi相关命令:
-
-![](./figures/15.png)
-
-连接目标wifi测试,使用ping命令测试是否连接成功:
-
-![](./figures/16.png)
-
-至此MIMXRT1060-EVK的基础环境便搭建测试完毕! \ No newline at end of file
diff --git a/bsp/imxrt/imxrt1060-nxp-evk/README.md b/bsp/imxrt/imxrt1060-nxp-evk/README.md
index ad63ad6d8c..3209a38cf5 100644
--- a/bsp/imxrt/imxrt1060-nxp-evk/README.md
+++ b/bsp/imxrt/imxrt1060-nxp-evk/README.md
@@ -1,6 +1,6 @@
# NXP MIMXRT1060-EVK BSP Introduction
-[中文页](README_zh.md) |
+**英文** | [中文](README_zh.md)
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.
@@ -12,7 +12,7 @@ The document is covered in three parts:
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.
-## Resources Introduction
+## 1 Resources Introduction
[![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)
@@ -27,13 +27,13 @@ Features:
- Common-used Interfaces: USB 、SD Card、Ethernet、LCD, etc
- Debugging interface, standard JTAG/SWD
-### For more details about these boards, please refer to [NXP Official Website](https://www.nxp.com/part/MIMXRT1060-EVK#/)
+### 1.1 For more details about these boards, please refer to [NXP Official Website](https://www.nxp.com/part/MIMXRT1060-EVK#/)
-## Peripherals Condition
+### 1.2 Peripherals Condition
Each peripheral supporting condition for this BSP is as follows:
@@ -56,21 +56,21 @@ Each peripheral supporting condition for this BSP is as follows:
| **Expansion Module** | **Support** | **Remark** |
| LVGL | √ | |
-## Quickly Get Started
+### 1.3 Quickly Get Started
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.
-#### Hardware Connection
+### 1.4 Hardware Connection
Use a cable to connect the development board to the PC and turn on the power switch.
-### Compile and Download
+### 1.5 Compile and Download
Double-click the `project.uvprojx` file to open the MDK5 project, compile and download the program to the development board.
> 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
-#### Running Results
+### 1.6 Running Results
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.
@@ -84,7 +84,7 @@ Connect the corresponding serial port of the development board to the PC, and wh
msh >
```
-## **Advanced Features**
+### 1.7 **Advanced Features**
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:
@@ -95,3 +95,129 @@ This BSP only enables GPIO and UART1 by default. If you need more advanced featu
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).
+## 2 MIMXRT1060-EVK User Manual
+
+This manual records the execution instruction of the MIMXRT1060-EVK on RT-Thread homebuilt IDE RT-Thread Studio.
+
+### 2.1 Preparation
+
+- Clone the RT-Thread repository from GitHub to your local. [Link](https://github.com/RT-Thread/rt-thread)
+- Download and install RT-Thread Studio. [Link](https://www.rt-thread.io/studio.html)
+- Prepare the [RW007](https://github.com/RT-Thread-packages/rw007/blob/master/README.md) module.
+
+### 2.2 Quickly Get Started
+
+#### 2.2.1 menuconfig to configure the project
+
+Open the directory where the MIMXRT1060-EVK BSP is located and use the menuconfig command in the [ENV tool](https://www.rt-thread.io/download.html?download=Env) to configure the project
+
+![](./figures/6.png)
+
+#### 2.2.2 Cancel the configuration that is not needed, as follows:
+
+Set the Onboard Peripheral Drivers option:
+
+![](./figures/4.png)
+
+Set the On-chip Peripheral Drivers option:
+
+![](./figures/5.png)
+
+### 2.3 Go to File, and click the Import
+
+![](./figures/1_en.png)
+
+### 2.4 Import RT-Thread BSP to workspace
+
+![](./figures/2_en.png)
+
+### 2.5 Fill out the project info
+
+![](./figures/3_en.png)
+
+### 2.6 Compile project
+
+![](./figures/8.png)
+
+Till now, the project is compiled, and the preparation is completed.
+
+## 3 Use RT-Studio to Configure BSP Driver
+
+Each BSP of RT-Thread already has several drivers by default, such as on-chip peripheral driver and on-board peripheral driver, and the drivers can be enabled by opening the corresponding configuration and setting the parameters according to the use environment on RT-Studio IDE. Since the pin has the multiplexing function, it may not have both the available on-chip peripheral driver and on-board peripheral driver at the same time, so it is necessary to check the schematic while enabling the corresponding peripheral drivers.
+
+RT-Thread has a lot of up-for-grab software packages, by using RT-Studio IDE, the software packages can be easily added to the project.
+
+![](./figures/17_en.png)
+
+## 4 Connect to Internet: Use the RW007 module
+
+The RW007 is a high-speed WIFI module that uses SPI to communicate with the host. Check the [User Manual](https://github.com/RT-Thread-packages/rw007/blob/master/README.md).
+
+The SPI interface provided by the MIMXRT1060-EVK onboard Arduino interface has duplicate pins with the pins used by the SDIO interface of the SD card, so the on-board SPI interface is not connected by default. We'll be needing you to connect it, check out the location marked DNP in the schematic diagram below (this step is necessary when using the SPI interface). You can use the SPI interface led by the onboard Arduino interface, in this case, the on-board SD card slot is not available.
+
+![](./figures/11.png)
+
+### 4.1 Configure the onboard SPI peripherals
+
+RW007 supports SPI interface for communication, MIMXRT1060-EVK supports SPI driver, defaults to using polling mode to communicate with RW007 (currently it does not support interrupt and DMA mode to communicate with RW007), the following shows how to use RT-Studio to configure SPI:
+
+![](./figures/10_en.png)
+
+### 4.2 Configure the RW007 package using RT-Studio
+
+Click the RT-Thread Settings option on the left, there is a configuration menu will be shown on the right, enter RW007 in the search bar, and select `rw007:SPI WIFI rw007 driver`, the corresponding configuration parameters are as follows:
+
+![](./figures/9_en.png)
+
+### 4.3 Plug the RW007 module into the onboard Arduino interface
+
+![](./figures/12.png)
+
+### 4.4 Modify the RW007 example
+
+Since the default example of the RW007 package is based on the STM32, minor modifications are required on the RT1060-EVK, modify the `rw007_stm32_port.c` file in the example folder in the RW007 package.
+
+Modify the `int wifi_spi_device_init(void)` function, replacing the example with the code given below:
+
+```
+int wifi_spi_device_init(void)
+{
+ char sn_version[32];
+
+ rw007_gpio_init();
+ rt_hw_spi_device_attach(RW007_SPI_BUS_NAME, "wspi", RW007_CS_PIN);
+ rt_hw_wifi_init("wspi");
+
+ rt_wlan_set_mode(RT_WLAN_DEVICE_STA_NAME, RT_WLAN_STATION);
+ rt_wlan_set_mode(RT_WLAN_DEVICE_AP_NAME, RT_WLAN_AP);
+
+ rw007_sn_get(sn_version);
+ rt_kprintf("\nrw007 sn: [%s]\n", sn_version);
+ rw007_version_get(sn_version);
+ rt_kprintf("rw007 ver: [%s]\n\n", sn_version);
+
+ return 0;
+}
+```
+
+### 4.5 After the modification is completed, compile the project and burn the firmware
+
+![](./figures/13.png)
+
+`rw007 sn` and `rw007 ver` are successfully output, and RW007 driver is successfully connected.
+
+### 4.6 WIFI connection test
+
+Enter the `wifi scan` command into the shell to search for WIFI.
+
+![](./figures/14.png)
+
+Enter `wifi` and press `tab` to list wifi-related commands:
+
+![](./figures/15.png)
+
+Use the ping command to test if the WIFI connection is available:
+
+![](./figures/16.png)
+
+At this point, the basic environment of the MIMXRT1060-EVK is successfully set up! \ No newline at end of file
diff --git a/bsp/imxrt/imxrt1060-nxp-evk/README_zh.md b/bsp/imxrt/imxrt1060-nxp-evk/README_zh.md
index cf955d06f9..2ffc7d55de 100644
--- a/bsp/imxrt/imxrt1060-nxp-evk/README_zh.md
+++ b/bsp/imxrt/imxrt1060-nxp-evk/README_zh.md
@@ -1,6 +1,8 @@
-# BSP README 模板
+# MIMXRT1060-EVK
-## 简介
+**中文** | [英文](README.md)
+
+## 1 BSP简介
本文档为 MIMXRT1060-EVK 开发板的 BSP (板级支持包) 说明。
@@ -12,7 +14,7 @@
通过阅读快速上手章节开发者可以快速地上手该 BSP,将 RT-Thread 运行在开发板上。在进阶使用指南章节,将会介绍更多高级功能,帮助开发者利用 RT-Thread 驱动更多板载资源。
-## 开发板介绍
+### 1.2 开发板介绍
开发板外观如下图所示:
@@ -31,7 +33,7 @@
开发板更多详细信息请参考【NXP】 [MIMXRT1060-EVK开发板介绍](https://www.nxp.com.cn/design/development-boards/i-mx-evaluation-and-development-boards/i-mx-rt1060-evaluation-kit:MIMXRT1060-EVK)。
-## 外设支持
+### 1.3 外设支持
本 BSP 目前对外设的支持情况如下:
@@ -54,7 +56,7 @@
| **扩展模块** | **支持情况** | **备注** |
| LVGL | 支持 | |
-## 使用说明
+### 1.4 使用说明
使用说明分为如下两个章节:
@@ -66,22 +68,21 @@
本章节是为需要在 RT-Thread 操作系统上使用更多开发板资源的开发者准备的。通过使用 ENV 工具对 BSP 进行配置,可以开启更多板载资源,实现更多高级功能。
-
-### 快速上手
+### 1.6 快速上手
本 BSP 为开发者提供 MDK4、MDK5 和 IAR 工程,以及GCC 开发环境。下面以 MDK5 开发环境为例,介绍如何将系统运行起来。
-#### 硬件连接
+### 1.7 硬件连接
使用数据线连接开发板到 PC,打开电源开关。
-#### 编译下载
+### 1.8 编译下载
双击 project.uvprojx 文件,打开 MDK5 工程,编译并下载程序到开发板。
> 工程默认配置使用 CMSIS-DAP 仿真器下载程序,在通过 USB 连接开发板的基础上,点击下载按钮即可下载程序到开发板
-#### 运行结果
+### 1.9 运行结果
下载程序成功之后,系统会自动运行,LED会以1Hz的频率闪烁。
@@ -94,7 +95,7 @@
2006 - 2022 Copyright by RT-Thread team
msh >
```
-### 进阶使用
+### 1.10 进阶使用
此 BSP 默认只开启了 GPIO 和 串口1 的功能,如果需使用 SD 卡、Flash 等更多高级功能,需要利用 ENV 工具对BSP 进行配置(暂时还不支持,等待第二阶段),步骤如下:
@@ -107,3 +108,137 @@ msh >
4. 输入`scons --target=mdk/iar` 命令重新生成工程。
本章节更多详细的介绍请参考 [IMXRT 系列 BSP 外设驱动使用教程](../docs/IMXRT系列BSP外设驱动使用教程.md)。
+
+## 2 MIMXRT1060-EVK上手指南
+
+**中文** | [English](MIMXRT1060-EVK User Manual.md)
+
+MIMXRT1060-EVK支持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)。
+- 准备RW007模块。
+
+### 2.2 BSP上手阶段
+
+#### 2.2.1 menuconfig配置工程
+
+打开MIMXRT1060-EVK BSP所在目录,在ENV工具中使用menuconfig命令配置工程
+
+![](./figures/6.png)
+
+#### 2.2.2 取消暂时不需要的配置,具体操作如下:
+
+Onboard Peripherial Drivers选项设置:
+
+![](./figures/4.png)
+
+On-chip Peripherial Drivers选项设置:
+
+![](./figures/5.png)
+
+### 2.3 点击文件,选择导入选项。
+
+![](./figures/1.png)
+
+### 2.4 选择导入RT-Thread Bsp 到工作空间中
+
+![](./figures/2.png)
+
+<div STYLE="page-break-after: always;"></div>
+
+### 2.5 按照示例填写工程信息
+
+![](./figures/3.png)
+
+<div STYLE="page-break-after: always;"></div>
+
+### 2.6 编译工程
+
+![](./figures/8.png)
+
+工程编译通过,至此,准备阶段完成。
+
+## 3 使用RT-Studio配置BSP驱动
+
+RT-Thread每个BSP已经默认适配了若干片上外设驱动与板载外设驱动,使用RT-Studio将相应的开关直接打开并依据使用环境配置相应参数即可使用。由于各个管脚存在复用功能,所以并不是所有的片上外设驱动与板载外设驱动都可以同时使用,使用时需要结合原理图来合理开启相应的外设驱动。
+
+RT-Thread有许多软件软件包,使用RT-Studio将相应软件包的开关打开便可将软件包添加至工程使用。
+
+![](./figures/17.png)
+
+## 4 联网实操:使用RW007模块联网
+
+RW007 是由上海睿赛德电子科技有限公司开发的高速 WiFi 模块,使用 SPI 与主机通信。[RW007使用指南链接](https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-standard/application-note/packages/rw007_module_using/an0034-rw007-module-using)。
+
+MIMXRT1060-EVK板载arduino接口提供的SPI接口与SD卡的SDIO接口使用的管脚存在重复的管脚,所以板载的SPI接口默认未连接,将下方**原理图中标记DNP的地方连接起来(使用SPI接口一定要做这一步!!!)**便可以使用板载arduino接口引出的SPI接口,此时板载的SD卡槽不可使用。
+
+![](./figures/11.png)
+
+### 4.1 配置板载SPI外设
+
+RW007可采用SPI接口通讯,MIMXRT1060-EVK支持SPI驱动,默认采用轮询的方式与RW007通讯(暂不支持中断与DMA模式与RW007通讯),使用RT-Studio配置SPI的具体配置如下:
+
+![](./figures/10.png)
+
+### 4.2 使用RT-Studio配置RW007软件包
+
+点击左侧的RT-Thread Settings选项,弹出右侧的配置菜单,在搜索栏中输入RW007,选择`rw007:SPI WIFI rw007 driver `,相应配置参数如下:
+
+![](./figures/9.png)
+
+### 4.3 将RW007模块插入板载的arduino接口
+
+![](./figures/12.png)
+
+### 4.4 修改RW007示例
+
+由于RW007软件包的默认示例是基于STM32的示例,所以在RT1060-EVK上需进行少量的修改,修改RW007软件包中的example文件夹中的rw007_stm32_port.c文件。
+
+修改`int wifi_spi_device_init(void)`函数,使用下述给出的代码替换原有的示例:
+
+```c
+int wifi_spi_device_init(void)
+{
+ char sn_version[32];
+
+ rw007_gpio_init();
+ rt_hw_spi_device_attach(RW007_SPI_BUS_NAME, "wspi", RW007_CS_PIN);
+ rt_hw_wifi_init("wspi");
+
+ rt_wlan_set_mode(RT_WLAN_DEVICE_STA_NAME, RT_WLAN_STATION);
+ rt_wlan_set_mode(RT_WLAN_DEVICE_AP_NAME, RT_WLAN_AP);
+
+ rw007_sn_get(sn_version);
+ rt_kprintf("\nrw007 sn: [%s]\n", sn_version);
+ rw007_version_get(sn_version);
+ rt_kprintf("rw007 ver: [%s]\n\n", sn_version);
+
+ return 0;
+}
+```
+
+### 4.5 修改完成后,编译工程,烧录固件。
+
+![](./figures/13.png)
+
+`rw007 sn`与`rw007 ver`可以正常输出无乱码时,RW007驱动成功!
+
+### 4.6 wifi联网测试
+
+在shell中输入`wifi scan`命令搜索WIFI。
+
+![](./figures/14.png)
+
+输入`wifi`,按`tab`键列出wifi相关命令:
+
+![](./figures/15.png)
+
+连接目标wifi测试,使用ping命令测试是否连接成功:
+
+![](./figures/16.png)
+
+至此MIMXRT1060-EVK的基础环境便搭建测试完毕! \ No newline at end of file