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 f6d5a3f468019721b26a70812a384202d6ef3847..239ac3abf37a34e7097fc112084ebcb4720edcc9 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 @@ -19,6 +19,7 @@ | | 【推荐】[Nuvoton NK-RTU980](../quick-start/nk-rtu980/quick-start.md) | | | 【推荐】[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) | ## 其他开发板及其 BSP diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m467hj/figures/NuLinkMe_SwitchSetting.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m467hj/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-m467hj/figures/NuLinkMe_SwitchSetting.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m467hj/figures/SerialSetting.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m467hj/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-m467hj/figures/SerialSetting.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m467hj/figures/board.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m467hj/figures/board.png new file mode 100644 index 0000000000000000000000000000000000000000..92c58822eb4d244069d2df3e8ad216276690a294 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m467hj/figures/board.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m467hj/figures/console.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m467hj/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-m467hj/figures/console.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m467hj/figures/image_grabber.gif b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m467hj/figures/image_grabber.gif new file mode 100644 index 0000000000000000000000000000000000000000..a9b5eb575855d0cb524fc43326beae91b8c779a3 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m467hj/figures/image_grabber.gif differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m467hj/figures/numicro_mcu.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m467hj/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-m467hj/figures/numicro_mcu.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m467hj/figures/run.gif b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m467hj/figures/run.gif new file mode 100644 index 0000000000000000000000000000000000000000..83689847006564776195e0345bb0ecc55fac66e0 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m467hj/figures/run.gif differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m467hj/figures/sendto.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m467hj/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-m467hj/figures/sendto.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m467hj/quick-start.md b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m467hj/quick-start.md new file mode 100644 index 0000000000000000000000000000000000000000..3a9a709e2f90a310ee7a33023e568ef9c246409b --- /dev/null +++ b/rt-thread-version/rt-thread-standard/tutorial/quick-start/numaker-m467hj/quick-start.md @@ -0,0 +1,192 @@ +# NuMaker-M467HJ 上手指南 + +**此文檔也適用 NuMaker-HMI-M467 型號開發板** + +## 简介 + +NuMaker-M467HJ 目标板带有 NuMicro M467HJHAN 微控制器。NuMaker-M467HJ 目标板提供 M467HJHAN 的脚位扩展接口，与兼容于 Arduino UNO 的接口，方便搭配各式接口设备或 Arduino 模块，并有多种的电源供应设计，让项目的开发更加灵活。NuMaker-M467HJ 目标板还带有电流量测接口可以随时监控功耗，协助项目开发与评估。 + +NuMaker-M467HJ 的另一部分为 Nu-Link2-Me 除错燒錄器。Nu-Link2-Me 可透过 SWD 接口对新唐微控制器进行在线 ICP 燒錄与除错，也可以进行脱机 ICP 燒錄，燒錄的状态会显示在状态 LED 上。Nu-Link2-Me 也支持虚拟串口（VCOM）功能，可输出讯息至终端机窗口。Nu-Link2-Me 还可以与开发板分离，成为独立的批次生产燒錄器。 + +开发板外观如下图所示： + +![board](figures/board.png) + +该开发板常用 **板载资源** 如下： + +- MCU + - M467HJHAN，主频 200MHz，1MB FLASH ，512KB RAM +- 板載裝置 + - SPI NOR FLASH： W25Q32（SPI，4MB） + - HYPERRAM： W956A8MBYA5I（HBI，8MB） + - Audio Codec: NAU8822 Audio Codec + - Thermal sensor: NCT7717U + - 乙太網: RTL8201F +- 常用外设 + - LED：3 个 + - 按键：3 个 +- 常用接口： + - Arduino UNO 相容擴充 + - RJ-45 + - USB 1.1/2.0 OTG + - SD 卡 + - 3.5mm 音源 + - CAN FD 通訊 + - LCD 屏(EBI) + - CMOS 影像 + - USB 转串口 +- 调试接口 + - 板载的 NuLinkMe 下载 +- 扩充板： + - HM1055 摄像头模块 + - NuMaker-M467HJ 适用屏幕模块 ([直接選購 NuMaker-HMI-M467 開發板](https://direct.nuvoton.com/zh/numaker-hmi-m467)) + +开发板更多详细信息请参考 [NuMaker-M467HJ](https://www.nuvoton.com/board/numaker-m467hj) + +## 软硬件需求 + +### 软件需求 + +- 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-M467HJ 开发板。 +- USB Micro 数据传输线 1 条。 + +## 准备工作 + +NuMaker-M467HJ 板级支持包提供 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-m467hj +# menuconfig --generate +# pkgs --update +Cloning into +Cloning into '\bsp\nuvoton\numaker-m467hj\packages\wavplayer-latest'... +remote: Enumerating objects: 98, done. +remote: Counting objects: 100% (40/40), done. +remote: Compressing objects: 100% (40/40), done. +remote: Total 98 (delta 14), reused 0 (delta 0), pack-reused 58 +Unpacking objects: 100% (98/98), 1.64 MiB | 1.24 MiB/s, done. +... +==============================> OPTPARSE latest is downloaded successfully. +==============================> wavplayer update done +==============================> ramdisk update done +==============================> optparse update done +Operation completed successfully. +``` + +- GCC 编译项目 +执行下列指令进行 gcc 编译工程，生成的文件为 rtthread.bin。 + +```bash +# cd rt-thread +# cd bsp/nuvoton/numaker-m467hj +# 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 + 381200 4964 176828 562992 89730 rtthread.elf +scons: done building targets. + +\bsp\nuvoton\numaker-m467hj\rtthread.bin +``` + +- MDK5 编译项目 +通过下列指令选译生成 MDK5 项目工程文件。MDK 项目工程产生在这个目录内，文件名为 project.uvprojx。 + +```bash +# cd rt-thread +# cd bsp/nuvoton/numaker-m467hj +# scons --target=mdk5 –s + +\bsp\nuvoton\numaker-m467hj\project.uvprojx +``` + +- IAR 编译项目 +可以通过下列指令生成 IAR 项目工程文件。IAR 项目工程产生在这个目录内，文件名为 project.ewp 和 project.eww。(注意: 编译 IAR 项目工程需使用 8.2 以上的版本。) + +```bash +# cd rt-thread +# cd bsp/nuvoton/numaker-m467hj +# scons --target=iar –s + +\bsp\nuvoton\numaker-m467hj\project.eww +\bsp\nuvoton\numaker-m467hj\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) + +- 操作 ifconfig 指令打印取得的 IP 地址, 并使用 ping 指令，进行测试网关连接。 +- 读取 NCT7717U 温度传感器。 +- 显示 8MB HYPERRAM as RAMDISK 档案列表。 +- 显示 SD Card 档案列表。 + +![run](figures/run.gif) + +### 其它外围功能演示 + +操作搭配专属屏幕与影像摄像头。 + +![run](figures/image_grabber.gif) + +## 更多开发板信息 + - [NuMaker-M467HJ](https://www.nuvoton.com/board/numaker-m467hj) + - [NuMaker-HMI-M467](https://www.nuvoton.com/products/gui-solution/gui-platform/numaker-hmi-m467/) + +## 继续学习 + +已完成 RT-Thread 快速上手！点击这里进行 [内核学习](../../kernel/kernel-video.md) 。