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 b157daceca60e373a65f5f4cc202489fd56b236b..bb5679b7032b081c69837e557a108a934b1b2f69 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 @@ -12,6 +12,11 @@ | | 【推荐】[阿波罗 STM32F429](../quick-start/stm32f429-atk-apolo/quick-start.md) | | 野火 | 【推荐】[霸道 STM32F103](../quick-start/stm32f103-fire-arbitrary/quick-start.md) | | | 【推荐】[挑战者 STM32F429](../quick-start/stm32f429-fire-challenger/quick-start.md) | +| 新唐 | 【推荐】[Nuvoton NuMaker-PFM-M487](../quick-start/numaker-pfm-m487/quick-start.md) | +| | 【推荐】[Nuvoton NuMaker-IoT-M487](../quick-start/numaker-iot-m487/quick-start.md) | +| | 【推荐】[Nuvoton NK-980IOT](../quick-start/nk-980iot/quick-start.md) | +| | 【推荐】[Nuvoton NuMaker-M2354](../quick-start/numaker-m2354/quick-start.md) | +| | 【推荐】[Nuvoton NK-RTU980](../quick-start/nk-rtu980/quick-start.md) | ## 其他开发板及其 BSP @@ -33,4 +38,4 @@ RT-Thread 支持的全部 BSP 均在 github 的 `rt-thread` 源码中，位于 ` ## STM32 系列 BSP 制作 -RT-Thread 团队提供 [STM32 系列 BSP 制作教程](https://github.com/RT-Thread/rt-thread/blob/master/bsp/stm32/docs/STM32%E7%B3%BB%E5%88%97BSP%E5%88%B6%E4%BD%9C%E6%95%99%E7%A8%8B.md)，若目标开发板是 STM32 系列，但在 RT-Thread 源码中没有找到相应的 BSP，那么可以根据这里提供的教程制作一个新的 BSP。 \ No newline at end of file +RT-Thread 团队提供 [STM32 系列 BSP 制作教程](https://github.com/RT-Thread/rt-thread/blob/master/bsp/stm32/docs/STM32%E7%B3%BB%E5%88%97BSP%E5%88%B6%E4%BD%9C%E6%95%99%E7%A8%8B.md)，若目标开发板是 STM32 系列，但在 RT-Thread 源码中没有找到相应的 BSP，那么可以根据这里提供的教程制作一个新的 BSP。 diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-980iot/figures/board.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-980iot/figures/board.png new file mode 100644 index 0000000000000000000000000000000000000000..43da6a2634d06139f9c0581de260f43e06914f17 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-980iot/figures/board.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-980iot/figures/console.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-980iot/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/nk-980iot/figures/console.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-980iot/figures/nuwriter-sdram-download.gif b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-980iot/figures/nuwriter-sdram-download.gif new file mode 100644 index 0000000000000000000000000000000000000000..9906c89d2e9a09da239cb59d817586b415b4fb48 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-980iot/figures/nuwriter-sdram-download.gif differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-980iot/figures/nuwriter-spinand-program.gif b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-980iot/figures/nuwriter-spinand-program.gif new file mode 100644 index 0000000000000000000000000000000000000000..d2d79cb5ec4205b19e4851da52cd572468388f86 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-980iot/figures/nuwriter-spinand-program.gif differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-980iot/figures/nuwriter-spinor-program.gif b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-980iot/figures/nuwriter-spinor-program.gif new file mode 100644 index 0000000000000000000000000000000000000000..317f31e22459596a1ce493ecd4033d3b064f1c55 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-980iot/figures/nuwriter-spinor-program.gif differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-980iot/figures/run.gif b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-980iot/figures/run.gif new file mode 100644 index 0000000000000000000000000000000000000000..353fbae27c10b75e261dceadb747bb10ce413357 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-980iot/figures/run.gif differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-980iot/quick-start.md b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-980iot/quick-start.md new file mode 100644 index 0000000000000000000000000000000000000000..2affdc80744c426a74fafe57eaa696d888c2136c --- /dev/null +++ b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-980iot/quick-start.md @@ -0,0 +1,221 @@ +# NK-980IOT 上手指南 + +## 简介 + +新唐科技提供工业物联网开发平台采用 NUC980DK61Y 微处理器，此为一套完整的工业用物联网开平台，包含了完整的硬件设计与软件参考设计。内核为新唐执行速度 300 MHz 的 ARM9 MPU，内建 64 MB DDR 内存、单一 10/100 以太网口、2 个高速 USB 主机、1 Gb SPI NAND Flash 存储装置、麦克风输入、立体声耳机输出与 Arduino 兼容接口。 + +开发板外观如下图所示： + +![board](figures/board.png) + +该开发板常用 **板载资源** 如下： + +- MPU：NUC980DK61Y，主频 300MHz，embedded 64MB DDR SDRAM +- 外部装置：1Gbit SPI-NAND Flash、NAU8822 Audio Codec +- 常用外设 + * LED：3 个 + * 按键：3 个 +- 常用接口：Arduino、USB 转串口、RJ-45 接口、1xUSB host 2.0、1xUSB Dual-role 2.0、Micro SD。 +- 调试接口：外挂 J-link 调试 或 使用 NuWriter 烧录软件、SDRAM 下载。 + +开发板更多详细信息请参考 [Nuvoton Direct](https://direct.nuvoton.com/tw/numaker-iiot-nuc980)。 + +## 软硬件需求 + +### 软件需求 +- Window 10 操作系统。 +- Env RT-Thread 开发辅助工具。 +- Arm MDK v5(或是 v4) – 工程编译软件。(Optional) +- 终端联机工具，如 Tera Term。 +- RT-Thread 源码。 + +### 硬件需求 +- NK-980IoT 开发板。 +- USB Micro 数据传输线 2 条。 + +## 准备工作 + +NK-980IoT 板级支持包提供 MDK5 及 GCC 开发环境，介绍如何将示例程序运行起来。运行示例程序前需要做如下准备工作： + + - 源码获取 + + 在 env 窗口内运行 git clone 将程序拷贝到本地端。[源码目录说明](../src_code_introduction/rtthread_dir.md) + + ```bash + git clone https://github.com/RT-Thread/rt-thread + ``` + + - 开发环境 + + 支持 GCC, MDK5 开发环境. + + | IDE/Compiler | Tested version | + | ---------- | ---------------------------- | + | MDK5 | 5.26.2 | + | GCC | GCC 5.4.1 20160919 (release) | + + - PC 机连接 + + 使用两条 USB 线连接开发板的 VCOM 及 USB0 Device/HOST port 到 PC 机。 + +## 运行板载功能演示 + +- 下载项目相应套件 + + 执行下列命令下载项目相关文件。 + +```bash + # cd rt-thread + # cd bsp/nuvoton/nk-980iot + # menuconfig --generate + # pkgs --update + Cloning into 'C:\rt-thread\bsp\nuvoton\nk-980iot\packages\netutils-latest'... + remote: Enumerating objects: 442, done. + remote: Total 442 (delta 0), reused 0 (delta 0), pack-reused 442R + Receiving objects: 100% (442/442), 8.15 MiB | 36.00 KiB/s, done. + Resolving deltas: 100% (237/237), done. + ==============================> FAL v0.4.0 is downloaded successfully. + ==============================> netutils update done + Operation completed successfully. +``` + +- GCC 编译项目 + + 执行下列指令进行 gcc 编译工程，生成的文件为 rtthread.bin。 + +```bash + # cd rt-thread + # cd bsp/nuvoton/nk-980iot + # 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 + 245020 4556 10260 259836 3f6fc rtthread.elf + scons: done building targets. + + \bsp\nuvoton\nk-980iot\rtthread.bin +``` + +- MDK5 编译项目 + + 通过下列指令选译生成 MDK5 项目工程文件。MDK 项目工程产生在这个目录内，文件名为 project.uvprojx。 + +```bash + # cd rt-thread + # cd bsp/nuvoton/nk-980iot + # scons --target=mdk5 –s + + \bsp\nuvoton\nk-980iot\project.uvprojx +``` + +## 使用 NuWriter 工具 +進行下列操作之前，需先设定 **Power-on setting to USB booting**。 + [Download NuWriter](https://github.com/OpenNuvoton/NUC980_NuWriter) + +- 下载固件至 SDRAM 地址 + + ![run](figures/nuwriter-sdram-download.gif) + + Step 1: 选择下载类型 **Choose type: DDR/SRAM** 。 + + Step 2: 按下 **Re-Connect**。 + + Step 3: 选择 **Choose file: Specify path of your rtthread.bin file.**。 + + Step 4: 输入 **Execute Address: 0x0**。 + + Step 5: 按下 **Option: Download and run**。 + + Step 6: 按下 **Download**。 + + Step 7: 查看 **rtthread 是否运行**。 + +- 烧录固件至 SPI NOR Flash + + ![run](figures/nuwriter-spinor-program.gif) + + Step 1: 选择下载类型 **Choose type: SPI** 。 + + Step 2: 按下 **Re-Connect**。 + + Step 3: 选择 **Choose file: Specify path of your rtthread.bin file.**。 + + Step 4: 点选 **Image Type: Loader** + + Step 5: 输入 **Execute Address: 0x0**。 + + Step 6: 按下 **Program** 并等待结束。 + + Step 7: 设定 **Power-on setting to SPI NOR booting** + + Step 8: 按下 **Reset 按键**。 + + Step 9: 查看 **rtthread 是否运行**。 + +- 烧录固件至 SPI NAND Flash + + ![run](figures/nuwriter-spinand-program.gif) + + Step 1: 选择下载类型 **Choose type: SPINAND** 。 + + Step 2: 按下 **Re-Connect**。 + + Step 3: 按下 **Erase** + + Step 4: 点择 **Erase All** + + Step 5: 按下 **OK** + + Step 6: 选择 **Choose file: Specify path of uboot-spl.bin file.**。 + + Step 7: 点选 **Image Type: Loader** + + Step 8: 输入 **Execute Address: 0x200**。 + + Step 9: 按下 **Program** 并等待结束。 + + Step 10: 选择 **Choose file: Specify path of uboot.bin file.**。 + + Step 11: 点选 **Image Type: Data** + + Step 12: 输入 **Image start address: 0x100000**。 + + Step 13: 按下 **Program** 并等待结束。 + + Step 14: 选择 **Choose file: Specify path of rtthread.bin file.**。 + + Step 15: 点选 **Image Type: Data** + + Step 16: 输入 **Image start address: 0x200000**。 + + Step 17: 按下 **Program** 并等待结束。 + + Step 18: 选择 **Choose file: Specify path of env.txt file.**。 + + Step 19: 点选 **Image Type: Environment** + + Step 20: 输入 **Image start address: 0x80000**。 + + Step 21: 按下 **Program** 并等待结束。 + + Step 22: 设定 **Power-on setting to SPI NAND booting** + + Step 23: 按下 **Reset 按键**。 + + Step 24: 查看 **rtthread** 是否运行。 + +- 运行 + + 使用 Tera Term 终端软件操作 rt-thread finsh/msh 命令行功能。串口的配置如图所示。(注意: Nuvoton Virtual Com Port 对应的串口编号可在设备管理器内找到。例如: 串口编号为 COM30, 115200N81。) + + ![console](figures/console.png) + + 在 console 操作 ifconfig 指令打印取得的 IP 地址, 并使用 ping 指令，进行测试网关连接。 + + ![run](figures/run.gif) + +## 继续学习 +已完成 RT-Thread 快速上手！点击这里进行 [内核学习](../../kernel/kernel-video.md) 。 diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-rtu980/figures/board.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-rtu980/figures/board.png new file mode 100644 index 0000000000000000000000000000000000000000..56969734615705c80070a64b422888ffe99c8680 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-rtu980/figures/board.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-rtu980/figures/console.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-rtu980/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/nk-rtu980/figures/console.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-rtu980/figures/nuwriter-sdram-download.gif b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-rtu980/figures/nuwriter-sdram-download.gif new file mode 100644 index 0000000000000000000000000000000000000000..9906c89d2e9a09da239cb59d817586b415b4fb48 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-rtu980/figures/nuwriter-sdram-download.gif differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-rtu980/figures/nuwriter-spinor-program.gif b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-rtu980/figures/nuwriter-spinor-program.gif new file mode 100644 index 0000000000000000000000000000000000000000..317f31e22459596a1ce493ecd4033d3b064f1c55 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-rtu980/figures/nuwriter-spinor-program.gif differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-rtu980/figures/run.gif b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-rtu980/figures/run.gif new file mode 100644 index 0000000000000000000000000000000000000000..7d6462afd831d4d4cf84003bb429750069041fe2 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-rtu980/figures/run.gif differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-rtu980/quick-start.md b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-rtu980/quick-start.md new file mode 100644 index 0000000000000000000000000000000000000000..487df3955ff4f9f3b1ea04103c9ea723df34d83c --- /dev/null +++ b/rt-thread-version/rt-thread-standard/tutorial/quick-start/nk-rtu980/quick-start.md @@ -0,0 +1,169 @@ +# NK-RTU980 上手指南 + +## 简介 + +新唐科技除提供的 NuMaker-RTU-NUC980，又名 Chili Board，Chili Board 面积仅 5 cm x 5 cm，除完整开发环境外，亦提供了高规格的硬件配备，内建 Arm9 为核心的 NUC980DR61YC 微处理器，堆栈 64 MB DRAM，周边接口包含 1 颗 32 MB SPI NOR Flash、1 组 10 / 100 以太网络口、1 组 USB 高速 Host / Device 接口、1 组 CAN 总线、RS-485 界面及最高 5 组 GPIO、具有 RSA2048、AES256、ECC、SHA512 与 PRNG 的硬件加解密引擎可用于网络数据加密传输。 + +开发板外观如下图所示： + +![board](figures/board.png) + +该开发板常用 **板载资源** 如下： + +- MPU：NUC980DR61YC，主频 300MHz，embedded 64MB DDR SDRAM +- 外部装置：32 MB SPI-NOR Flash +- 常用外设 + * LED：2 个 + * 按键：2 个 +- 常用接口：USB 转串口、RJ-45 接口、1xUSB host 2.0、1xUSB Dual-role 2.0。 +- 调试接口：外挂 J-link 调试 或 使用 NuWriter 烧录软件、SDRAM 下载。 + +开发板更多详细信息请参考 [Nuvoton Direct](https://direct.nuvoton.com/tw/numaker-rtu-nuc980)。 + +## 软硬件需求 + +### 软件需求 +- Window 10 操作系统。 +- Env RT-Thread 开发辅助工具。 +- Arm MDK v5(或是 v4) – 工程编译软件。(Optional) +- 终端联机工具，如 Tera Term。 +- RT-Thread 源码。 + +### 硬件需求 +- NK-RTU980 开发板。 +- USB Micro 数据传输线 2 条。 + +## 准备工作 + +NK-RTU980 板级支持包提供 MDK5 及 GCC 开发环境，介绍如何将示例程序运行起来。运行示例程序前需要做如下准备工作： + + - 源码获取 + + 在 env 窗口内运行 git clone 将程序拷贝到本地端。[源码目录说明](../src_code_introduction/rtthread_dir.md) + + ```bash + git clone https://github.com/RT-Thread/rt-thread + ``` + + - 开发环境 + + 支持 GCC, MDK5 开发环境. + + | IDE/Compiler | Tested version | + | ---------- | ---------------------------- | + | MDK5 | 5.26.2 | + | GCC | GCC 5.4.1 20160919 (release) | + + - PC 机连接 + + 使用两条 USB 线连接开发板的 VCOM 及 USB0 Device/HOST port 到 PC 机。 + +## 运行板载功能演示 + +- 下载项目相应套件 + + 执行下列命令下载项目相关文件。 + +```bash + # cd rt-thread + # cd bsp/nuvoton/nk-rtu980 + # menuconfig --generate + # pkgs --update + Cloning into 'C:\rt-thread\bsp\nuvoton\nk-rtu980\packages\netutils-latest'... + remote: Enumerating objects: 442, done. + remote: Total 442 (delta 0), reused 0 (delta 0), pack-reused 442R + Receiving objects: 100% (442/442), 8.15 MiB | 36.00 KiB/s, done. + Resolving deltas: 100% (237/237), done. + ==============================> FAL v0.4.0 is downloaded successfully. + ==============================> netutils update done + Operation completed successfully. +``` + +- GCC 编译项目 + + 执行下列指令进行 gcc 编译工程，生成的文件为 rtthread.bin。 + +```bash + # cd rt-thread + # cd bsp/nuvoton/nk-rtu980 + # 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 + 245020 4556 10260 259836 3f6fc rtthread.elf + scons: done building targets. + + \bsp\nuvoton\nk-rtu980\rtthread.bin +``` + +- MDK5 编译项目 + + 通过下列指令选译生成 MDK5 项目工程文件。MDK 项目工程产生在这个目录内，文件名为 project.uvprojx。 + +```bash + # cd rt-thread + # cd bsp/nuvoton/nk-rtu980 + # scons --target=mdk5 –s + + \bsp\nuvoton\nk-rtu980\project.uvprojx +``` + +## 使用 NuWriter 工具 +进行下列操作之前，需先设定 **Power-on setting to USB booting**。 + [Download NuWriter](https://github.com/OpenNuvoton/NUC980_NuWriter) + +- 下载固件至 SDRAM 地址 + + ![run](figures/nuwriter-sdram-download.gif) + + Step 1: 选择下载类型 **Choose type: DDR/SRAM** 。 + + Step 2: 按下 **Re-Connect**。 + + Step 3: 选择 **Choose file: Specify path of your rtthread.bin file.**。 + + Step 4: 输入 **Execute Address: 0x0**。 + + Step 5: 按下 **Option: Download and run**。 + + Step 6: 按下 **Download**。 + + Step 7: 查看 **rtthread 是否运行**。 + +- 烧录固件至 SPI NOR Flash + + ![run](figures/nuwriter-spinor-program.gif) + + Step 1: 选择下载类型 **Choose type: SPI** 。 + + Step 2: 按下 **Re-Connect**。 + + Step 3: 选择 **Choose file: Specify path of your rtthread.bin file.**。 + + Step 4: 点选 **Image Type: Loader** + + Step 5: 输入 **Execute Address: 0x0**。 + + Step 6: 按下 **Program** 并等待结束。 + + Step 7: 设定 **Power-on setting to SPI NOR booting** + + Step 8: 按下 **Reset 按键**。 + + Step 9: 查看 **rtthread** 是否运行。 + +- 运行 + + 使用 Tera Term 终端软件操作 rt-thread finsh/msh 命令行功能。串口的配置如图所示。(注意: Nuvoton Virtual Com Port 对应的串口编号可在设备管理器内找到。例如: 串口编号为 COM30, 115200N81。) + + ![console](figures/console.png) + + 在 console 操作 ifconfig 指令打印取得的 IP 地址, 并使用 ping 指令，进行测试网关连接。 + + ![run](figures/run.gif) + +## 继续学习 +已完成 RT-Thread 快速上手！点击这里进行 [内核学习](../../kernel/kernel-video.md) 。 diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m487/figures/board.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m487/figures/board.png new file mode 100644 index 0000000000000000000000000000000000000000..b59e3929c2d7f1b6c48f03acfffc284b98d85d92 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m487/figures/board.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m487/figures/console.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m487/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-m487/figures/console.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m487/figures/nulinkme_isw.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m487/figures/nulinkme_isw.png new file mode 100644 index 0000000000000000000000000000000000000000..8b7c360955b6354ec6ebb52d12ae752edd231e86 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m487/figures/nulinkme_isw.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m487/figures/numicro_mcu.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m487/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-m487/figures/numicro_mcu.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m487/figures/run.gif b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m487/figures/run.gif new file mode 100644 index 0000000000000000000000000000000000000000..5c2650c59660378141bf302e8864e812b30d6923 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m487/figures/run.gif differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m487/quick-start.md b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m487/quick-start.md new file mode 100644 index 0000000000000000000000000000000000000000..57cacfffeeb702697614514f71fb7b235f67e061 --- /dev/null +++ b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-iot-m487/quick-start.md @@ -0,0 +1,157 @@ +# NuMaker-IoT-M487 上手指南 + +## 简介 + +物联网应用广泛，从基础的端点到网关再到云端，之间需要控制、连网与加密等技术。新唐科技推出适合物联网使用之 NuMaker-IoT-M487 开发板，以 NuMicro M487 系列微控制器为主控核心，内建 RJ45 以太网络与 Wi-Fi 模块，让用户可以有线或无线的方式连接云端，亦可通过不同的无线子板提供 NB-IoT、6LoWPAN 等联机能力，以符合各种应用场景需求；配合 NuMicro M487 系列微控制器内建的加解密加速器，提高加密网络联机的效率。 + +NuMaker-IoT-M487 提供兼容 Arduino UNO 与 mikroBUS™ 接口，可与 GPIO、UART、ADC、PWM、SPI 或 I2C 等接口连接；内建新唐积木式概念的传感器模块 NuMaker Brick I2C 接口；提供独特的仿真影像传感器接口，连接 CMOS 影像传感器，可用于截取影像进行分析；并结合 NAU88L25 音频编译码器，提供高音质的录放音功能；外挂 SPI Flash 及提供 microSD 卡插槽，增加额外的数据存取空间。 + +NuMaker-IoT-M487 提供多元连网方式与多种接口，并提供影像感测、录放音功能以及弹性扩充数据存取空间，不论是端点装置或轻量型的网关应用，NuMaker-IoT-M487 都是踏入物联网应用的适切选择。 + +开发板外观如下图所示： + +![board](figures/board.png) + +该开发板常用 **板载资源** 如下： + +- MCU：M487JIDAE，主频 192MHz，512KB FLASH ，160KB RAM +- 外部 FLASH：W25Q32（SPI，4MB）、NAU88L25 Audio Codec、ESP8266 Wi-Fi +- 常用外设 + * LED：3 个 + * 按键：3 个 +- 常用接口：mikro BUS、CMOS 影像接口、USB 转串口、RJ-45 接口、USB 1.1 OTG、USB 2.0 OTG +- 调试接口，板载的 NuLinkMe 下载 + +开发板更多详细信息请参考 [Nuvoton Direct](https://direct.nuvoton.com/tw/numaker-iot-m487)。 + +## 软硬件需求 + +### 软件需求 +- Window 10 操作系统。 +- Env RT-Thread 开发辅助工具。 +- IAR-8.2 以上版本或是 Arm MDK v5(或是 v4) – 工程编译软件。(Optional) +- Nu-Link Driver for Keil MDK。(Optional) +- Nu-Link Driver for IAR。(Optional) +- 终端联机工具，如 Tera Term。 +- RT-Thread 源码。 + +### 硬件需求 +- NuMaker-IoT-M487 开发板。 +- USB Micro 数据传输线 1 条。 + +## 准备工作 + +NuMaker-IoT-M487 板级支持包提供 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-m487 + # menuconfig --generate + # pkgs --update + Cloning into 'C:\rt-thread\bsp\nuvoton\numaker-iot-m487\packages\netutils-latest'... + remote: Enumerating objects: 442, done. + remote: Total 442 (delta 0), reused 0 (delta 0), pack-reused 442R + Receiving objects: 100% (442/442), 8.15 MiB | 36.00 KiB/s, done. + Resolving deltas: 100% (237/237), done. + ==============================> FAL v0.4.0 is downloaded successfully. + ==============================> netutils update done + Operation completed successfully. +``` + +- GCC 编译项目 + + 执行下列指令进行 gcc 编译工程，生成的文件为 rtthread.bin。 + +```bash + # cd rt-thread + # cd bsp/nuvoton/numaker-iot-m487 + # 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 + 245020 4556 10260 259836 3f6fc rtthread.elf + scons: done building targets. + + \bsp\nuvoton\numaker-iot-m487\rtthread.bin +``` + +- MDK5 编译项目 + + 通过下列指令选译生成 MDK5 项目工程文件。MDK 项目工程产生在这个目录内，文件名为 project.uvprojx。 + +```bash + # cd rt-thread + # cd bsp/nuvoton/numaker-iot-m487 + # scons --target=mdk5 –s + + \bsp\nuvoton\numaker-iot-m487\project.uvprojx +``` + +- IAR 编译项目 + + 可以通过下列指令生成 IAR 项目工程文件。IAR 项目工程产生在这个目录内，文件名为 project.ewp 和 project.eww。(注意: 编译 IAR 项目工程需使用 8.2 以上的版本。) + +```bash + # cd rt-thread + # cd bsp/nuvoton/numaker-iot-m487 + # scons --target=iar –s + + \bsp\nuvoton\numaker-iot-m487\project.eww + \bsp\nuvoton\numaker-iot-m487\project.ewp +``` + +- 固件下载 + + 简易的下载方法: 通过拖拉文档到 NuMicro MCU 虚拟磁盘或是使用传送到 NuMicro MCU 虚拟磁盘的方式，即可完成固件下载。 + + ![numicro_mcu](figures/numicro_mcu.png) + + 首先，配置 NuMaker-IoT-M487 上的 ISW1，将四个开关拨到 ‘ON’ 的位置。 + + ![isw](figures/nulinkme_isw.png) + + 配置完成后，将开发板使用 Micro USB 连接线连接计算机，我的计算机将出现一个 NuMicro MCU 虚拟磁盘。接下来，我们将使用这个虚拟磁盘来进行固件下载。(注意：若需要进行 IAR/MDK 源码除错功能，需要将第 4 个指拨开关切换回到 OFF 的位置。) + +- 运行 + + 使用 Tera Term 终端软件操作 rt-thread finsh/msh 命令行功能。串口的配置如图所示。(注意: Nuvoton Virtual Com Port 对应的串口编号可在设备管理器内找到。例如: 串口编号为 COM30, 115200N81。) + + ![console](figures/console.png) + + 在 console 操作 ifconfig 指令打印取得的 IP 地址, 并使用 ping 指令，进行测试网关连接。 + + ![run](figures/run.gif) + +## 继续学习 +已完成 RT-Thread 快速上手！点击这里进行 [内核学习](../../kernel/kernel-video.md) 。 diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m2354/figures/board.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m2354/figures/board.png new file mode 100644 index 0000000000000000000000000000000000000000..bc67542722e7f82b81194a5b71177f7b68910644 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m2354/figures/board.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m2354/figures/console.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m2354/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-m2354/figures/console.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m2354/figures/nulinkme_isw.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m2354/figures/nulinkme_isw.png new file mode 100644 index 0000000000000000000000000000000000000000..8b7c360955b6354ec6ebb52d12ae752edd231e86 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m2354/figures/nulinkme_isw.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m2354/figures/numicro_mcu.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m2354/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-m2354/figures/numicro_mcu.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m2354/figures/run.gif b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m2354/figures/run.gif new file mode 100644 index 0000000000000000000000000000000000000000..d3b409e798970c58a16593fa785a96df917f52d2 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m2354/figures/run.gif differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m2354/quick-start.md b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m2354/quick-start.md new file mode 100644 index 0000000000000000000000000000000000000000..54211a2a0c628391f2dd9a86968913ad0fe96970 --- /dev/null +++ b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m2354/quick-start.md @@ -0,0 +1,157 @@ +# NuMaker-M2354 上手指南 + +## 简介 + +NuMaker-M2354 由两部分组成，采用 NuMicro® M2354KJFAE 微控制器的主控板，与 Nu-Link2-Me 除错烧录器。使用者只需使用此开发板就可以开始进行开发、烧录并验证应用程序。NuMaker-2354 可作为安全项目评估、开发、验证以及功耗监控的平台。 + +NuMaker-M2354 平台带有 NuMicro® M2354KJFAE 微控制器以及完整的脚位扩展接口，提供兼容于 Arduino UNO 的接口，方便搭配各式接口设备或 Arduino 模块，该平台提供多种的电源供应设计，让项目的开发更加灵活。NuMaker-M2354 平台具备电流量测接口可以随时监控功耗，协助项目开发与评估。NuMaker-M2354 还带有 Wi-Fi 模块以及支持 COM/SEG LCD，让使用者能快速进行项目开发。 + +NuMaker-M2354 的另一部分为 Nu-Link2-Me 除错烧录器。Nu-Link2-Me 可通过 SW 接口对新唐微控制器进行在线 ICP 烧录与除错，也可以进行脱机 ICP 烧录，烧录的状态会显示在状态 LED 上。Nu-Link2-Me 也支持虚拟串口（VCOM）功能，可输出讯息至终端机窗口。Nu-Link2-Me 还可以与开发板分离，成为独立的批量生产烧录器。 + +开发板外观如下图所示： + +![board](figures/board.png) + +该开发板常用 **板载资源** 如下： + +- MCU：M2354KJFAE，主频 96 MHz，1MB Dual Bank FLASH ，256kB RAM +- 外部装置：ESP8266 Wi-Fi、COM/SEG LCD +- 常用外设 + * LED：3 个 + * 按键：2 个 +- 常用接口：USB 转串口、USB 1.1 OTG +- 调试接口，板载的 Nu-Link2-Me 下载 + +开发板更多详细信息请参考 [Nuvoton Direct](https://direct.nuvoton.com/tw/numaker-m2354)。 + +## 软硬件需求 + +### 软件需求 +- Window 10 操作系统。 +- Env RT-Thread 开发辅助工具。 +- IAR-8.3 以上版本或是 Arm MDK v5 – 工程编译软件。(Optional) +- Nu-Link Driver for Keil MDK。(Optional) +- Nu-Link Driver for IAR。(Optional) +- 终端联机工具，如 Tera Term。 +- RT-Thread 源码。 + +### 硬件需求 +- NuMaker-M2354 开发板。 +- USB Micro 数据传输线 1 条。 + +## 准备工作 + +NuMaker-M2354 板级支持包提供 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.32 | + | GCC | GCC 6.3.1 20170620 (Need update env) | + + 注意: 开发前，请先安装 [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-m2354 + # menuconfig --generate + # pkgs --update + Cloning into 'C:\rt-thread\bsp\nuvoton\numaker-m2354\packages\netutils-latest'... + remote: Enumerating objects: 442, done. + remote: Total 442 (delta 0), reused 0 (delta 0), pack-reused 442R + Receiving objects: 100% (442/442), 8.15 MiB | 36.00 KiB/s, done. + Resolving deltas: 100% (237/237), done. + ==============================> FAL v0.4.0 is downloaded successfully. + ==============================> netutils update done + Operation completed successfully. +``` + +- GCC 编译项目 + + 执行下列指令进行 gcc 编译工程，生成的文件为 rtthread.bin。 + +```bash + # cd rt-thread + # cd bsp/nuvoton/numaker-m2354 + # 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 + 245020 4556 10260 259836 3f6fc rtthread.elf + scons: done building targets. + + \bsp\nuvoton\numaker-m2354\rtthread.bin +``` + +- MDK5 编译项目 + + 通过下列指令选译生成 MDK5 项目工程文件。MDK 项目工程产生在这个目录内，文件名为 project.uvprojx。 + +```bash + # cd rt-thread + # cd bsp/nuvoton/numaker-m2354 + # scons --target=mdk5 –s + + \bsp\nuvoton\numaker-m2354\project.uvprojx +``` + +- IAR 编译项目 + + 可以通过下列指令生成 IAR 项目工程文件。IAR 项目工程产生在这个目录内，文件名为 project.ewp 和 project.eww。(注意: 编译 IAR 项目工程需使用 8.3 以上的版本。) + +```bash + # cd rt-thread + # cd bsp/nuvoton/numaker-m2354 + # scons --target=iar –s + + \bsp\nuvoton\numaker-m2354\project.eww + \bsp\nuvoton\numaker-m2354\project.ewp +``` + +- 固件下载 + + 简易的下载方法: 通过拖拉文档到 NuMicro MCU 虚拟磁盘或是使用传送到 NuMicro MCU 虚拟磁盘的方式，即可完成固件下载。 + + ![numicro_mcu](figures/numicro_mcu.png) + + 首先，配置 Nu-Link2-Me 上的指拨开关，将四个开关拨到 ‘ON’ 的位置。 + + ![isw](figures/nulinkme_isw.png) + + 配置完成后，将开发板使用 Micro USB 连接线连接计算机，我的计算机将出现一个 NuMicro MCU 虚拟磁盘。接下来，我们将使用这个虚拟磁盘来进行固件下载。 + +- 运行 + + 使用 Tera Term 终端软件操作 rt-thread finsh/msh 命令行功能。串口的配置如图所示。(注意: Nuvoton Virtual Com Port 对应的串口编号可在设备管理器内找到。例如: 串口编号为 COM30, 115200N81。) + + ![console](figures/console.png) + + 在 console 操作 ifconfig 指令打印取得的 IP 地址, 并使用 ping 指令，进行测试网关连接。 + + ![run](figures/run.gif) + +## 继续学习 +已完成 RT-Thread 快速上手！点击这里进行 [内核学习](../../kernel/kernel-video.md) 。 diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-pfm-m487/figures/board.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-pfm-m487/figures/board.png new file mode 100644 index 0000000000000000000000000000000000000000..56d200321f0f567426b1951d1cdb4ba46c709fc2 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-pfm-m487/figures/board.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-pfm-m487/figures/console.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-pfm-m487/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-pfm-m487/figures/console.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-pfm-m487/figures/nulinkme_isw.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-pfm-m487/figures/nulinkme_isw.png new file mode 100644 index 0000000000000000000000000000000000000000..8b7c360955b6354ec6ebb52d12ae752edd231e86 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-pfm-m487/figures/nulinkme_isw.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-pfm-m487/figures/numicro_mcu.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-pfm-m487/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-pfm-m487/figures/numicro_mcu.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-pfm-m487/figures/run.gif b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-pfm-m487/figures/run.gif new file mode 100644 index 0000000000000000000000000000000000000000..c07dc0831a72a43002a9290c5545f980ba9a435c Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-pfm-m487/figures/run.gif differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-pfm-m487/quick-start.md b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-pfm-m487/quick-start.md new file mode 100644 index 0000000000000000000000000000000000000000..4c731c3ad26fabf92b0f6c91eae25ac65a5b3621 --- /dev/null +++ b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-pfm-m487/quick-start.md @@ -0,0 +1,152 @@ +# NuMaker-PFM-M487 上手指南 + +## 简介 + +NuMaker-PFM-M487 的主控板采用通用接口设计，提供兼容于 Arduino UNO 的接口，用户可搭配任何 Arduino 模块进行开发。除了扩展接口外、主控板本身亦内建丰富的接口设备，如、三色 LED、按键、麦克风、耳机、USB 1.1/2.0 OTG、心率感测等完整的传感器群。模拟周边部分含有 1 个 12 位，多达 16 通道 5 MSPS SAR ADC、2 个 12 位 1 MSPS DAC，通讯接口包含 2 个 CAN 2.0B 接口、2 个 SD 卡控制器等。 + +开发板外观如下图所示： + +![board](figures/board.png) + +该开发板常用 **板载资源** 如下： + +- MCU：M487JIDAE，主频 192MHz，512KB FLASH ，160KB RAM +- 外部 FLASH：W25Q32（SPI，4MB）、NAU88L25 Audio Codec +- 常用外设 + * LED：3 个 + * 按键：3 个 +- 常用接口：USB 转串口、RJ-45 接口、USB 1.1 OTG、USB 2.0 OTG +- 调试接口，板载的 NuLinkMe 下载 + +开发板更多详细信息请参考 [Nuvoton Direct](https://direct.nuvoton.com/tw/numaker-pfm-m487)。 + +## 软硬件需求 +### 软件需求 +- Window 10 操作系统。 +- Env RT-Thread 开发辅助工具。 +- IAR-8.2 以上版本或是 Arm MDK v5(或是 v4) – 工程编译软件。(Optional) +- Nu-Link Driver for Keil MDK。(Optional) +- Nu-Link Driver for IAR。(Optional) +- 终端联机工具，如 Tera Term。 +- RT-Thread 源码。 + +### 硬件需求 +- NuMaker-PFM-M487 开发板。 +- USB Micro 数据传输线 1 条。 + +## 准备工作 + +NuMaker-PFM-M487 板级支持包提供 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-pfm-m487 + # menuconfig --generate + # pkgs --update + Cloning into 'C:\rt-thread\bsp\nuvoton\numaker-pfm-m487\packages\netutils-latest'... + remote: Enumerating objects: 442, done. + remote: Total 442 (delta 0), reused 0 (delta 0), pack-reused 442R + Receiving objects: 100% (442/442), 8.15 MiB | 36.00 KiB/s, done. + Resolving deltas: 100% (237/237), done. + ==============================> FAL v0.4.0 is downloaded successfully. + ==============================> netutils update done + Operation completed successfully. +``` + +- GCC 编译项目 + + 执行下列指令进行 gcc 编译工程，生成的文件为 rtthread.bin。 + +```bash + # cd rt-thread + # cd bsp/nuvoton/numaker-pfm-m487 + # 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 + 245020 4556 10260 259836 3f6fc rtthread.elf + scons: done building targets. + + \bsp\nuvoton\numaker-pfm-m487\rtthread.bin +``` + +- MDK5 编译项目 + + 通过下列指令选译生成 MDK4 或是 MDK5 项目工程文件。MDK 项目工程产生在这个目录内，文件名为 project.uvprojx。 + +```bash + # cd rt-thread + # cd bsp/nuvoton/numaker-pfm-m487 + # scons --target=mdk5 –s + + \bsp\nuvoton\numaker-pfm-m487\project.uvprojx +``` + +- IAR 编译项目 + + 可以通过下列指令生成 IAR 项目工程文件。IAR 项目工程产生在这个目录内，文件名为 project.ewp 和 project.eww。(注意: 编译 IAR 项目工程需使用 8.2 以上的版本。) + +```bash + # cd rt-thread + # cd bsp/nuvoton/numaker-pfm-m487 + # scons --target=iar –s + + \bsp\nuvoton\numaker-pfm-m487\project.eww + \bsp\nuvoton\numaker-pfm-m487\project.ewp +``` + +- 固件下载 + + 简易的下载方法: 通过拖拉文档到 NuMicro MCU 虚拟磁盘或是使用传送到 NuMicro MCU 虚拟磁盘的方式，即可完成固件下载。 + + ![numicro_mcu](figures/numicro_mcu.png) + + 首先，配置 NuMaker-PFM-M487 上的 ISW1，将四个开关拨到 ‘ON’ 的位置。 + + ![isw](figures/nulinkme_isw.png) + + 配置完成后，将开发板使用 Micro USB 连接线连接计算机，我的计算机将出现一个 NuMicro MCU 虚拟磁盘。接下来，我们将使用这个虚拟磁盘来进行固件下载。(注意：若需要进行 IAR/MDK 源码除错功能，需要将第 4 个指拨开关切换回到 OFF 的位置。) + +- 运行 + + 使用 Tera Term 终端软件操作 rt-thread finsh/msh 命令行功能。串口的配置如图所示。(注意: Nuvoton Virtual Com Port 对应的串口编号可在设备管理器内找到。例如: 串口编号为 COM30, 115200N81。) + + ![console](figures/console.png) + + 在 console 操作 ifconfig 指令打印取得的 IP 地址, 并使用 ping 指令，进行测试网关连接。 + + ![run](figures/run.gif) + +## 继续学习 +已完成 RT-Thread 快速上手！点击这里进行 [内核学习](../../kernel/kernel-video.md) 。