diff --git a/rt-thread-version/rt-thread-standard/_sidebar.md b/rt-thread-version/rt-thread-standard/_sidebar.md index ce1bf86e78aed27d5017109ecd447a00f3865c6a..cc755a6f9267da56b2785170e52755c0665f6c9b 100644 --- a/rt-thread-version/rt-thread-standard/_sidebar.md +++ b/rt-thread-version/rt-thread-standard/_sidebar.md @@ -16,6 +16,7 @@ - [RT-Thread Vision-Board](/rt-thread-version/rt-thread-standard/hw-board/ra8d1-vision-board/ra8d1-vision-board.md) - [RT-Thread EtherKit](/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/rzn2l-etherkit.md) - [英飞凌PSOC62评板](/rt-thread-version/rt-thread-standard/hw-board/ifx-eval-kit/ifx-eval-kit.md) + - [NXP FRDM-MCXA346](/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/quick-start.md) - [NXP FRDM-MCXN947](/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxn947/quick-start.md) - [NXP FRDM-MCXA156](/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa156/quick-start.md) - [Keil模拟器STM32F103](/rt-thread-version/rt-thread-standard/tutorial/quick-start/stm32f103-simulator/stm32f103-simulator.md) diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/figures/board.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/figures/board.png new file mode 100644 index 0000000000000000000000000000000000000000..7ff92f752b428fe710ad699968748cf24820fde8 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/figures/board.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/figures/board_block_diagram.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/figures/board_block_diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..4959545c0cf4b825e54bc0517862fe8c6b79ecab Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/figures/board_block_diagram.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/figures/dir.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/figures/dir.png new file mode 100644 index 0000000000000000000000000000000000000000..12b5ffa0f0fd3695a6eceeb7c64c873c5cedfda9 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/figures/dir.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/figures/project.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/figures/project.png new file mode 100644 index 0000000000000000000000000000000000000000..48b9dbabf25c9a5728f1d6b49f24020741ac6b79 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/figures/project.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/figures/run.gif b/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/figures/run.gif new file mode 100644 index 0000000000000000000000000000000000000000..1021b3bc69b0034a62214491b2003249bbb833d2 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/figures/run.gif differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/figures/scons.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/figures/scons.png new file mode 100644 index 0000000000000000000000000000000000000000..7a664d520ae0bc1c4ae8dd72eaf9f131032263dd Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/figures/scons.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/figures/usb_pc.png b/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/figures/usb_pc.png new file mode 100644 index 0000000000000000000000000000000000000000..04b0d1c2df0dda0e5e1f2b629869b120883819bf Binary files /dev/null and b/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/figures/usb_pc.png differ diff --git a/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/quick-start.md b/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/quick-start.md new file mode 100644 index 0000000000000000000000000000000000000000..54d6c07d4bf9ea5096bfc6dd919db018bf595556 --- /dev/null +++ b/rt-thread-version/rt-thread-standard/tutorial/quick-start/frdm_mcxa346/quick-start.md @@ -0,0 +1,114 @@ +# NXP FRDM-MCXA346 上手指南 + +## 简介 + +FRDM-MCXA346 是基于 NXP MCX A346 微控制器的设计和评估平台。MCX A346 MCU 是一款面向工业和消费物联网(IoT)应用的低功耗微控制器,搭载 Arm Cortex-M33 内核,运行频率高达 180 MHz。该芯片支持工业通信协议、无刷直流(BLDC)电机/永磁同步电机(PMSM)控制,以及集成传感器接口(MIPI-I3C、I2C 和 SPI)。 该开发板兼容 Arduino 板(Arduino UNO R3 和 Arduino A4/A5)、电机控制板(FRDM-MC-LVBLDC 和 FRDM-MC-LVPMSM)、Mikroe click 板和 Pmod 板。可与多种开发工具配合使用,包括 NXP MCUXpresso IDE、IAR Embedded Workbench 和 Arm Keil MDK。该开发板符合无铅和 RoHS 标准。 + +### 主要特性 + +- **目标MCU**: NXP MCX A346 (MCXA346VLQ),基于 Arm Cortex-M33 内核,最高运行频率 180 MHz +- **调试接口**: 板载 MCU-Link 调试探针,基于 LPC55S16 MCU +- **通信接口**: + - FlexCAN 接口:支持高速 CAN FD 收发器 + - LPUART 接口:支持多个 UART 连接 + - LPSPI 接口:支持 SPI 通信 + - LPI2C 接口:支持 I2C 通信 + - 摄像头接口:支持基于 SmartDMA 的并行摄像头接口 +- **模拟功能**: + - 4个 16位 ADC 模块 (ADC0-ADC3) + - 4个运算放大器模块 (OPAMP0-OPAMP3) +- **扩展接口**: + - Arduino 插座:4个连接器 (J1-J4) + - mikroBUS 插座:2个连接器 (J5-J6) + - Pmod 连接器:J7 (可选) + - GPIO 扩展连接器 +- **电源供电**: + - 通过 USB Type-C 连接器 J15 提供 5V 电源 + - 通过 CAN0 连接器 J16 提供 5V 电源(默认选项) + - 支持 5-9V 外部电源输入 +- **时钟**: + - MCX A346 MCU:8 MHz 时钟 + - LPC55S16 MCU:16 MHz 时钟 +- **指示灯**: + - 电源指示灯 (绿色) + - 复位指示灯 (红色) + - RGB LED (用户可控) + - MCU-Link 状态指示灯 +- **按键**: + - 复位按键 (SW1) + - 唤醒按键 (SW2) + - ISP 按键 (SW3) + +开发板外观如下图所示: + +![board](figures/board.png) + + + +该开发板常用 板载资源 如下: + +![board](figures/board_block_diagram.png) + + + +开发板更多详细信息请参考 [NXP官方网站](https://www.nxp.com/design/design-center/development-boards-and-designs/FRDM-MCXA346)。 + +## 准备工作 + +目前FRDM-MCXA346板级支持包提供MDK5/GCC ,并且支持 GCC 开发环境,面以 MDK5 开发环境为例,介绍如何将示例程序运行起来。运行示例程序前需要做如下准备工作: + +> NXP官方的FRDM-MCXA346的上手教程,可以参考[这里](https://www.nxp.com/document/guide/getting-started-with-frdm-mcxA346:GS-FRDM-MCXA346) + + 1. MDK 开发环境 + + 需要安装 MDK-ARM 5.38 (或以上版本均可)。安装方法可以参考 [Keil MDK安装](../keil/keil.md)。 + + 2. 源码获取 + + ,在 Assets 中下载压缩包获取最新稳定版代码。 + + [源码目录说明](../src_code_introduction/rtthread_dir.md) + + 3. 使用 USB 线连接开发板的 USB 转串口 到 PC 机。 + + ![连接到 PC](figures/usb_pc.png) + +## 运行第一个示例程序 + +### 编译下载 + +进入到 `rt-thread\bsp\nxp\mcxa\frdm-mcxa346` 文件夹中,打开RT-Thread的env工具,输入`scons --target=mdk5`来重新生成Keil工程. + +![工程目录](figures/scons.png) + +生成Keil工程文件名为 project.uvprojx, 双击 project.uvprojx 文件,打开 MDK5 工程。 + +![工程目录](figures/dir.png) + +执行编译,编译完成后,点击下载按钮将固件下载至开发板,下载完成后,程序会自动开始运行,观察程序运行状况。 + +> 提示:工程默认配置使用 CMSIS-DAP下载程序,点击下载按钮即可下载程序到开发板 + +![编译下载方法](figures/project.png) + +### 运行 + +如没有自动运行,按下复位按键重启开发板, 连接开发板对应串口到 PC , 在串口工具里打开相应的串口(115200-8-1-N) ,复位设备后,可以看到 RT-Thread 的输出信息: + +```bash + \ | / +- RT - Thread Operating System + / | \ 5.2.1 build Aug 21 2025 10:49:50 + 2006 - 2024 Copyright by RT-Thread team +using armclang, version: 6230001 +FRDM-MCXA346 +msh > +``` + +板子上的红色LED会以1Hz的频率闪烁,按下板子上的 SW2按键,串口控制台会打印`SW2 pressed` 代表GPIO中断功能已经实现. + +![编译下载方法](figures/run.gif) + +## 继续学习 + +已完成 RT-Thread 快速上手!点击这里进行 [内核学习](../../kernel/kernel-video.md) 。