diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/more.md b/rt-thread-version/rt-thread-standard/tutorial/quick-start/more.md index 239ac3abf37a34e7097fc112084ebcb4720edcc9..d92834279761f2558255cdd25c7b1440d7b74ac1 100644 --- a/rt-thread-version/rt-thread-standard/tutorial/quick-start/more.md +++ b/rt-thread-version/rt-thread-standard/tutorial/quick-start/more.md @@ -20,6 +20,7 @@ | | 【推荐】[Nuvoton NK-N9H30](../quick-start/nk-n9h30/quick-start.md) | | | 【推荐】[Nuvoton NuMaker-M032KI](../quick-start/numaker-m032ki/quick-start.md) | | | 【推荐】[Nuvoton NuMaker-M467HJ](../quick-start/numaker-m467hj/quick-start.md) | +| | 【推荐】[Nuvoton NuMaker-IoT-M467](../quick-start/numaker-iot-m467/quick-start.md) | ## 其他开发板及其 BSP diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/NuLinkMe_SwitchSetting.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/NuLinkMe_SwitchSetting.png new file mode 100644 index 0000000000000000000000000000000000000000..2a1822fbd43faed99552404d1274a9dc84d3dc0c Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/NuLinkMe_SwitchSetting.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/NuMicro_MCU_Disk.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/NuMicro_MCU_Disk.png new file mode 100644 index 0000000000000000000000000000000000000000..301fe5d2dc37e01279b5fa0835ffdb29451fab5a Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/NuMicro_MCU_Disk.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/SerialSetting.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/SerialSetting.png new file mode 100644 index 0000000000000000000000000000000000000000..7ab04331be0ebb2af5c8a16772e6c293a9f934a5 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/SerialSetting.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/board.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/board.png new file mode 100644 index 0000000000000000000000000000000000000000..c64d49ceb2d2a583254f6896c0cee49926d4efa2 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/board.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/console.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/console.png new file mode 100644 index 0000000000000000000000000000000000000000..7ab04331be0ebb2af5c8a16772e6c293a9f934a5 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/console.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/numicro_mcu.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/numicro_mcu.png new file mode 100644 index 0000000000000000000000000000000000000000..301fe5d2dc37e01279b5fa0835ffdb29451fab5a Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/numicro_mcu.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/run.gif b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/run.gif new file mode 100644 index 0000000000000000000000000000000000000000..40944175dad89ea5a68ab7d81f26f42edd741be1 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/run.gif differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/sendto.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/sendto.png new file mode 100644 index 0000000000000000000000000000000000000000..dac6dd29b1dfa6fcd3633c9aa55a3ab6e67bf6ec Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/figures/sendto.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/quick-start.md b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/quick-start.md new file mode 100644 index 0000000000000000000000000000000000000000..355c8d2e93b4c6c4d960de74ff859eafc3ed13e9 --- /dev/null +++ b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m467/quick-start.md @@ -0,0 +1,170 @@ +# NuMaker-IoT-M467 上手指南 + +## 简介 + +物联网应用广泛，从基础的端点到网关再到云端，之间需要控制、连网与加密等技术。新唐科技推出适合物联网使用之 NuMaker-IoT-M467 开发板，以 NuMicro M467 系列微控制器为主控核心，内建 RJ45 以太网络与 Wi-Fi 模块，让用户可以有线或无线的方式连接云端，以符合各种应用场景需求；配合 NuMicro M467 系列微控制器内建的加解密加速器，提高加密网络联机的效率。 + +NuMaker-IoT-M467 目标板带有 NuMicro M467HJHAN 微控制器，提供兼容于 Arduino UNO 与 mikroBUS™ 接口，方便搭配各式接口设备或 Arduino 模块，并有多种的电源供应设计，让项目的开发更加灵活，可与 GPIO、UART、ADC、PWM、SPI 或 I2C 等接口连接；外挂 SPI Flash 及提供 microSD 卡插槽，增加额外的数据存取空间。 + +![board](figures/board.png) + +该开发板常用 **板载资源** 如下： + +- MCU + - M467HJHAN，主频 200MHz，1MB FLASH ，512KB RAM +- 板載裝置 + - SPI NOR FLASH： W25Q32（SPI，4MB） + - Wi-Fi： ESP8266 (with AT firmware) + - Thermal sensor: NCT7717U + - 6-axis MotionTracking Sensor: MPU6500 + - 乙太網: RTL8201F +- 常用外设 + - LED：3 个 + - 按键：3 个 +- 常用接口： + - Arduino UNO 相容擴充 + - 2 mikroBus 相容擴充 + - RJ-45 + - USB 1.1/2.0 OTG + - SD 卡 + - CAN FD 通訊 + - USB 转串口 +- 调试接口 + - 板载的 NuLinkMe 下载 + +开发板更多详细信息请参考 [NuMaker-IoT-M467](https://www.nuvoton.com/board/NuMaker-IoT-M467) + +## 软硬件需求 + +### 软件需求 + +- Window 10 操作系统。 +- Env RT-Thread 开发辅助工具。 +- IAR-8.2 以上版本或是 Arm MDK v5 – 工程编译软件。(Optional) +- Nu-Link Driver for Keil MDK。(Optional) +- Nu-Link Driver for IAR。(Optional) +- 终端联机工具，如 Tera Term。 +- RT-Thread 源码。 + +### 硬件需求 + +- NuMaker-IoT-M467 开发板。 +- USB Micro 数据传输线 1 条。 + +## 准备工作 + +NuMaker-IoT-M467 板级支持包提供 MDK5 和 IAR 工程，并且支持 GCC 开发环境，介绍如何将示例程序运行起来。运行示例程序前需要做如下准备工作： + + 1. 源码获取 +在 env 窗口内运行 git clone 将程序拷贝到本地端。[源码目录说明](../src_code_introduction/rtthread_dir.md) + +```bash +git clone https://github.com/RT-Thread/rt-thread +``` + + 2. 开发环境 +支持 GCC, MDK5, IAR 开发环境. + +| IDE/Compiler | Tested version | +| ---------- | ---------------------------- | +| MDK5 | 5.26.2 | +| IAR | 8.2 | +| GCC | GCC 5.4.1 20160919 (release) | + +注意: 开发前，请先安装 [Nu-Link_Keil](https://www.nuvoton.com/resource-download.jsp?tp_GUID=SW1120200221180521) 或是 [Nu-Link_IAR](https://www.nuvoton.com/resource-download.jsp?tp_GUID=SW1120200221180914) 驱动。 + + 3. 使用 USB 线连接开发板的 USB ICE Connector 到 PC 机。 + +## 运行板载功能演示 + +- 下载项目相关套件 + +执行下列命令下载项目相关文件。 + +```bash +# cd rt-thread +# cd bsp/nuvoton/numaker-iot-m467 +# menuconfig --generate +# pkgs --update +Cloning into 'Z:\opennuvoton_rt-thread\bsp\nuvoton\numaker-iot-m467\packages\at_device-latest'... +remote: Enumerating objects: 1683, done. +remote: Counting objects: 100% (330/330), done. +remote: Compressing objects: 100% (147/147), done. +remote: Total 1683 (delta 212), reused 272 (delta 178), pack-reused 1353 +Receiving objects: 100% (1683/1683), 776.80 KiB | 1.37 MiB/s, done. +Resolving deltas: 100% (1084/1084), done. +==============================> AT_DEVICE latest is downloaded successfully. +... +Operation completed successfully. +``` + +- GCC 编译项目 +执行下列指令进行 gcc 编译工程，生成的文件为 rtthread.bin。 + +```bash +# cd rt-thread +# cd bsp/nuvoton/numaker-iot-m467 +# scons +… +… +LINK rtthread.elf +arm-none-eabi-objcopy -O binary rtthread.elf rtthread.bin +arm-none-eabi-size rtthread.elf + text data bss dec hex filename + 384040 4820 176628 565488 8a0f0 rtthread.elf +scons: done building targets. + +\bsp\nuvoton\numaker-iot-m467\rtthread.bin +``` + +- MDK5 编译项目 +通过下列指令选译生成 MDK5 项目工程文件。MDK 项目工程产生在这个目录内，文件名为 project.uvprojx。 + +```bash +# cd rt-thread +# cd bsp/nuvoton/numaker-iot-m467 +# scons --target=mdk5 –s + +\bsp\nuvoton\numaker-iot-m467\project.uvprojx +``` + +- IAR 编译项目 +可以通过下列指令生成 IAR 项目工程文件。IAR 项目工程产生在这个目录内，文件名为 project.ewp 和 project.eww。(注意: 编译 IAR 项目工程需使用 8.2 以上的版本。) + +```bash +# cd rt-thread +# cd bsp/nuvoton/numaker-iot-m467 +# scons --target=iar –s + +\bsp\nuvoton\numaker-iot-m467\project.eww +\bsp\nuvoton\numaker-iot-m467\project.ewp +``` + +- 固件下载 +简易的下载方法: 通过拖拉文档到 NuMicro MCU 虚拟磁盘或是使用传送到 NuMicro MCU 虚拟磁盘的方式，即可完成固件下载。 + +![numicro_mcu](figures/numicro_mcu.png) + +![numicro_mcu](figures/sendto.png) + +首先，配置 NuMaker-M467 上的 ICESW2，将 1 與 2 开关拨到 ‘ON’ 的位置。 + +![isw](figures/NuLinkMe_SwitchSetting.png) + +配置完成后，将开发板使用 Micro USB 连接线连接计算机，我的计算机将出现一个 NuMicro MCU 虚拟磁盘。接下来，我们将使用这个虚拟磁盘来进行固件下载。 + +- 运行 +使用 Tera Term 终端软件操作 rt-thread finsh/msh 命令行功能。串口的配置如图所示。(注意: Nuvoton Virtual Com Port 对应的串口编号可在设备管理器内找到。例如: 串口编号为 COM30, 115200N81。) + +![console](figures/console.png) + +- 读取 NCT7717U 温度传感器。 +- 读取 MPU6500 6-axis 传感器。 +- 操作 ifconfig 指令打印取得的 IP 地址, 并使用 ping 指令，进行测试网关连接。 +- 显示 SD Card 档案列表。 + +![run](figures/run.gif) + +## 继续学习 + +已完成 RT-Thread 快速上手！点击这里进行 [内核学习](../../kernel/kernel-video.md) 。