简介面向使用雅特力AT32F421系列MCU的嵌入式开发者这套Demo资料提供了从硬件设计到软件开发的完整参考。内容涵盖开发板原理图、PCB版图与BOM清单配套用户手册以及AT32F421固件库BSP与Pack应用指南同时集成FreeRTOS例程并预置at32_ide、eclipse_gcc、IAR、mdk_v5多种开发环境的示例工程便于在不同工具链间快速迁移。包体共1684个文件以C/H源码、uvprojx工程文件、PDF文档和TXT说明为主另有原理图/PCB源文件与编译脚本整体约42.13MB。已有502人学习下载适合正在选型或调试AT32F421的软硬件工程师参考能显著缩短环境搭建与驱动移植时间。1. 先搞清这套 Demo 资料是什么、解决哪类问题手上拿到一套“雅特力 M4 内核 AT32F421 开发 Demo 资料”多数人是想把这颗芯片当成 STM32F030/F031 的高性价比替代半天内点亮第一块板子。AT32F421 是雅特力的 Cortex-M4F 产品线主频 120MHz带 FPU定时器和模拟外设比较全定价却落在传统 M0/M3 档位。官方 Demo 包把外设例程、板级支持、时钟配置、评估板原理图放在一起常见做法是在 Keil 里直接编译下载有一套相对完整的参考流程。这篇内容适合刚接触雅特力、或者从 ST 生态转过来想少走弯路的固件工程师我按自己拿到同类资料时的处理顺序来写。2. AT32F421 的资源边界与 M4 内核使用要点2.1 先看内核M4 不是白给的Cortex-M4F 和 F031 这类 M0 内核的区别不只是主频高一点。AT32F421 带单周期硬件乘法、除法、DSP 指令和单精度 FPU这意味着 PID、滤波、FFT 这类计算密集型代码可以放到这颗芯片上跑而不是非要换更高成本的器件。实际使用中要留意MDK 默认可能没开 FPU 编译选项浮点计算会被软浮点兜底代码能跑但效率打折扣在编译选项里加上-mfpufpv4-sp-d16 -mfloat-abihard才能吃到硬件的红利。另一个容易被忽略的点是 M4 的中断控制器是 NVIC优先级可配 16 级不像 M0 只有固定 4 级。Demo 资料里不少例程只写了外设初始化没有显式设抢占优先级迁到复杂应用时自己加一行nvic_irq_enable()是常态。2.2 资源清单开始前先核对这些数字项目AT32F421 典型值使用注意内核Cortex-M4F 120MHz带 FPU可跑 DSP 指令集Flash16KB 至 64KB按型号区分C8T7 为 64KBSRAM4KB 至 16KB高配型号 16KB规划 buffer 时先看型号工作电压2.6V 至 3.6V3.3V 系统直接供电即可工作温度-40℃ 至 105℃以具体型号数据手册为准封装TSSOP20 / QFN32 / LQFP32 / LQFP48Demo 板常用 LQFP48外设数量按细分型号有差异尤其是 USART、SPI、TMR 通道数和 ADC 通道数不能假设所有封装都一样。我一般会在开工前把所用型号的数据手册第 1 页的 feature 表截图存到需求文档里避免后面把某个型号的 DMA 请求映射照抄到另一个型号上。2.3 从 STM32F0 迁过来的三个习惯变化第一外设库风格接近 ST 标准库函数名透明但寄存器和中断号完全独立不能直接替换头文件。第二BOOT 引脚和复位电路有差别AT32F421 的 BOOT0 上拉或下拉处理不当会导致进不了用户程序。第三也是最容易翻车的内部高速 RC 是 48MHz不是 F0 的 8MHz。用内部时钟时SysTick 定时、串口波特率、PWM 分频全部要按 48MHz 重新算拿 F0 的延时函数直接抄过来串口输出全乱码就是这么来的。2.4 系统时钟路径怎么配先看一段最简示意代码理解 AT32F421 的时钟路径/* 示意代码寄存器名和函数名以手头 SDK 头文件为准 */ /* 场景外部 8MHz 晶振HEXT作为 PLL 输入升到 120MHz */ // 1. 使能外部晶振并等待稳定 // crm_clock_source_enable(CRM_CLOCK_SOURCE_HEXT, TRUE); // // 2. 配置 PLL输入 8MHz经过分频/倍频得到 120MHz // crm_pll_config(PLL_CLOCK_SOURCE_HEXT, 8, 15); // // 3. 切换到 PLL 输出作为系统时钟 // crm_sysclk_switch(CRM_SCLK_PLL);代码里我只写逻辑骨架是因为雅特力不同版本的库在函数命名上略有出入但三步顺序不变开晶振、配 PLL、切换系统时钟。实际工程中官方 Demo 在at32f421_clock.c这类文件里已经封装好120MHz HEXT和120MHz 内部 RC两套配置多数情况你不用改只需要确认评估板上晶振焊的是 8MHz 还是 12MHz。内部 RC 模式下没有外部晶振起振失败的问题但精度一般对外通信要求高的场合建议上外部晶振。2.5 主频定了外设时钟树也要跟着定AT32F421 的 APB 分频会影响定时器时钟和串口时钟。看门狗、SysTick、TMR 全部挂在 APB 总线上PLL 输出 120MHz 后APB1 分频系数如果配成 2定时器时钟会再翻倍成 120MHzPWM 频率和占空比计算全部依赖这个数字。我建议每次点灯前先在 main 函数里用调试器读一下CRM-cfg寄存器确认系统时钟、AHB、APB 的实际值再继续往下写。这一步看起来多余但能过滤掉一大半“Demo 跑得好好的我的板子怎么频率不对”的问题。3. 把 Demo 资料在本地跑通先看目录再编译3.1 资料包结构怎么看从官网下载的 AT32F421 资料通常会拆成两个包一个是外设固件库Firmware Library一个是示例工程Demo。常见目录结构如下AT32F421_Firmware_Library/ ├─ cortex_m4/ 启动文件、内核和system文件 ├─ doc/ 库使用说明和应用笔记 ├─ firmware/ │ ├─ at32f421/ 外设头文件与源文件 │ └─ cmsis/ CMSIS 核心头文件 └─ project/ ├─ at32f421_demo/ 官方示例工程 └─ at32f421_template/ 空工程模板Demo 工程常见做法是只维护一个顶层工程通过宏开关决定编译哪个外设例程。在main.c或顶层头文件里可以看到类似#define AT32F421_ADC_DEMO、#define AT32F421_TMR_DEMO这样的编译开关你当前编译哪个例程就把对应的宏注释掉或打开。这个机制对查问题很有用现象不符合预期时先切回 GPIO 例程确认最小系统没问题再切回目标外设。3.2 用 Keil 打开工程前先装 Pack直接双击.uvprojx打开工程再装 Pack 会看到一整片头文件路径报红原因是 MDK 找不到器件描述文件。正确顺序是先在官网下载 AT32F421 的器件 Pack后缀是.pack然后在 MDK 的 Pack Installer 里选择本地导入安装完成后新建工程列表里才能找到 AT32F421 系列。MDK 版本建议 5.27 以上AC5 和 AC6 两个编译器的工程在 Demo 包里都有如果打开工程后没有编译列表或编译按钮灰掉检查工程文件里有没有keil_arm5、keil_arm6两个目录选择与你本机编译器一致的子工程即可。3.3 命令行编译快速验证环境是否可用图形界面编译没问题但想批量确认十几个例程能否通过编译时命令行更高效# UV4.exe 是 Keil 的命令行入口路径按本机安装位置调整 C:\Keil_v5\UV4\UV4.exe -b at32f421_demo.uvprojx -j0 -o build_info.log参数作用-b以批处理模式编译工程不弹出界面-j0自动检测本机 CPU 核心数并行编译-o把编译输出写入指定日志文件-z编译结束后返回错误码0 表示通过编译完成后打开build_info.log搜Error和Warning。如果命令行找不到UV4.exe检查 Keil 安装目录是否包含空格路径整体加引号即可。3.4 烧录和串口验证Demo 板默认的调试器是雅特力自家的 AT-Link插上 USB 后 MDK 的 Debug 设置里选择 CMSIS-DAP 接口即可。如果你的仿真器是 J-Link需要在 MDK 里把 Debugger 换成 J-Link并把 Flash Download 里的算法改成 AT32F421 对应的算法。多数 Demo 例程会通过串口输出运行信息。我一般会打开串口助手波特率设置成 1152008 数据位、1 停止位、无校验。如果输出是乱码第一优先检查系统时钟配置因为串口波特率寄存器按 120MHz 计算调试器暂停在main函数入口读时钟寄存器确认当前系统频率到底是 120MHz 还是 48MHz 没切上去。3.5 下载后按例程现象表核对例程预期现象现象不对时先查GPIO 翻转LED 以固定频率闪GPIO 时钟和引脚模式TMR PWM示波器看到方波定时器分频和极性问题USART 发送串口助手周期性收到字符串波特率计算和时钟源ADC 采样电压值随输入变化ADC 采样通道和参考电压DMA 搬运内存数据持续刷新DMA 外设地址和字节宽度现象表对新手特别有用因为它把“是否跑通”从“我觉得没问题”变成“客观可见的结果”。4. 参考官方 Demo 改一套最小应用4.1 从哪个例程开始抄把官方 Demo 当作基础模板而不是从零搭工程。我建议先找一个包含 GPIO 和 TMR 的例程作为底子比如 PWM 输出例程因为它同时涉及 GPIO 复用配置、外设时钟和定时器参数三件事跑通它等于打通了最小系统加外设框架。之后加 ADC、串口、DMA 都是在这个框架上做加法。看官方例程时重点看三处主函数前的系统初始化、外设初始化函数里的参数结构体、注释里写明的引脚复用。很多移植改动都发生在这三处其他地方可以保持原样。4.2 把 PWM 例程改成自己的引脚和频率/* 把官方 PWM 例程从默认引脚改到 PA8 输出 20kHz PWM */ /* 函数名和宏定义以 SDK 头文件为准这里展示配置思路 */ // 1. 使能 GPIOA 和 TMR1 外设时钟 crm_periph_clock_enable(CRM_GPIOA_PERIPH_CLOCK, TRUE); crm_periph_clock_enable(CRM_TMR1_PERIPH_CLOCK, TRUE); // 2. 配置 PA8 为定时器复用功能 gpio_init_type gp; gp.pin GPIO_PINS_8; gp.mode GPIO_MODE_MUX; gp.pull_up FALSE; gp.pull_down FALSE; gpio_init(GPIOA, gp); // 3. 配置 TMR 输出频率 tmr_base_init_type base; base.period 1200; /* 120MHz / 1200 100kHz */ base.prescaler 5; /* 100kHz / 5 20kHz */ base.repetition_cnt 0; base.clk_div 0; tmr_base_init(TMR1, base); // 4. 配置 PWM 占空比和输出极性 tmr_pwm_init_type pwm; pwm.duty_ratio 50; /* 占空比 50% */ pwm.channel TMR_SELECT_CHANNEL_1; tmr_pwm_init(TMR1, pwm); // 5. 启动 TMR tmr_counter_enable(TMR1, TRUE);这段代码的精髓在参数计算定时器时钟是 120MHzPWM 频率 定时器时钟 /(prescaler 1) / (period 1)我这里写成 1200 和 5实际输出约 20kHz。注意雅特力的period字段是否要加 1不同版本库有差异最稳妥的办法是改完后用频率计或逻辑分析仪实测而不是只靠算。PWM 例程里常见的坑是极性配置反了高电平有效变成低电平有效导致电机或电源调试时行为完全相反。4.3 加一路 ADC 采样并用 DMA 搬运数字电源和电机控制场景必然要采集电压电流。官方 ADC 例程一般只演示查询模式我习惯改成 ADC 连续采样加 DMA 自动搬运减少 CPU 介入。/* 单通道 ADC 连续采样DMA 循环搬运到内存数组 */ /* 函数名和寄存器名以手头 SDK 版本为准 */ adc_base_config_type adc_cfg; adc_cfg.sequence_mode TRUE; /* 序列模式支持多通道 */ adc_cfg.repeat_mode TRUE; /* 连续转换 */ adc_cfg.data_align ADC_RIGHT_ALIGN; adc_cfg.ordinary_trigger ADC_TRIGGER_NONE; /* 软件触发即可 */ adc_base_config_init(ADC1, adc_cfg); /* 使能 ADC1 通道对应 GPIO 为模拟输入 */ gpio_init_type gp; gp.pin GPIO_PINS_0; gp.mode GPIO_MODE_ANALOG; gpio_init(GPIOA, gp); /* 配置 DMA 从 ADC 数据寄存器搬到内存 */ dma_init_type dma_cfg; dma_cfg.peripheral_base_addr (uint32_t)ADC1-odt; dma_cfg.memory_base_addr (uint32_t)adc_buffer; dma_cfg.direction DMA_DIR_PERIPHERAL_TO_MEMORY; dma_cfg.buffer_size 32; dma_cfg.peripheral_inc_enable FALSE; dma_cfg.memory_inc_enable TRUE; dma_cfg.loop_mode_enable TRUE; /* 循环模式 */ dma_init(DMA1_CHANNEL1, dma_cfg); dma_channel_enable(DMA1_CHANNEL1, TRUE); adc_ordinary_conversion_dma_enable(ADC1, TRUE); adc_ordinary_conversion_enable(ADC1, TRUE);参数我的设置说明sequence_modeTRUE后续加多通道时不需要改结构体框架repeat_modeTRUE连续采样省掉每次手动触发loop_mode_enableTRUEDMA 搬运一圈后自动回卷buffer_size32越大滤波效果越稳但内存占用随之上升peripheral_inc_enableFALSEADC 数据寄存器地址固定不需要自增这段配置里最容易踩的坑是 DMA 通道号选错。AT32F421 的 ADC1 请求映射到哪个 DMA 通道以数据手册 DMA 请求映射表为准不同封装和型号可能有差异。通道写错的现象是编译能过内存数组一动不动。4.4 中断优先级和外设开关别乱调把官方例程改成多外设应用时中断优先级是最容易被忽视的。Demo 例程通常只在main里开一个全局中断你加上串口接收、定时器中断、DMA 完成中断后就要显式配置分组和抢占优先级。M4 内核支持优先级分组一般工程全部用抢占优先级即可不需要组内子优先级。我的习惯是ADC DMA 完成中断优先级最高因为数据不及时拿走会影响控制周期串口接收中断其次定时器中断再次。优先级分配完用调试器在HardFault_Handler打断点很多故障其实是中断优先级配置越界或未初始化。4.5 移植完做的最小验证清单改完外设后不要直接接负载。我先做三件事拿万用表量电源引脚电压、拿示波器看 PWM 输出频率、拿串口助手看初始化完成后有没有打印。物理现象全部符合预期后再接执行器。这个顺序能帮你区分“代码问题”和“硬件问题”尤其在做电机控制或电源这类高压环境时等于给自己留了一到安全缓冲。5. 让官方 Demo 资料少埋坑的 4 个技巧技巧一先核对库版本再开干。官网下载的固件库和 Demo 包都可能更新片内 Flash 算法和头文件随之变化。拿到资料后先看release_note或版本号确认与你手上的芯片批次匹配。老批次芯片配新版库外设初始化顺序可能不兼容新批次芯片配旧库烧录算法可能识别不了 Flash 型号。版本不匹配的问题在论坛里经常出现表现是“下载一半卡死”或“能编译但运行异常”。技巧二外部晶振和内部 RC 要明确选一条路。官方的时钟配置文件里通常同时保留 HEXT 和内部 RC 两套宏。我见过不少工程整理者把两套都打开结果 PLL 输入源冲突代码在 while 等待晶振稳定的循环里出不来。处理方式很简单用外部晶振就把内部 RC 配置注释掉用内部 RC 就把外部晶振相关代码注释掉两条路径同时活跃没有任何好处。技巧三J-Link 认不到芯片时换 AT-Link 或 DAP-Link。J-Link 对雅特力的支持依赖具体驱动版本有时即使装了设备包也识别失败。手头没有 AT-Link 时用任意一个 CMSIS-DAP 调试器都能烧录。如果你的产品交给产线烧录建议在开发阶段就固定用和产线一致的烧录器避免开发用 J-Link、产线用 DAP 导致烧录算法配置不一致。技巧四把 Demo 现象录下来当回归基线。每次改完代码不要只确认“能编译”我把例程对应现象录成短视频或者记录成表格GPIO 例程 LED 闪烁频率、PWM 例程输出频率、串口例程发送内容。后续改动任何底层配置先跑一遍这套基线能立刻看出哪次修改影响了无关外设。这个方法成本很低但比调试器断点更早暴露问题。本文还有配套的精品资源点击获取 AT32F421开发Demo资料详解：M4内核与STM32F030替代实践
简介面向使用雅特力AT32F421系列MCU的嵌入式开发者这套Demo资料提供了从硬件设计到软件开发的完整参考。内容涵盖开发板原理图、PCB版图与BOM清单配套用户手册以及AT32F421固件库BSP与Pack应用指南同时集成FreeRTOS例程并预置at32_ide、eclipse_gcc、IAR、mdk_v5多种开发环境的示例工程便于在不同工具链间快速迁移。包体共1684个文件以C/H源码、uvprojx工程文件、PDF文档和TXT说明为主另有原理图/PCB源文件与编译脚本整体约42.13MB。已有502人学习下载适合正在选型或调试AT32F421的软硬件工程师参考能显著缩短环境搭建与驱动移植时间。1. 先搞清这套 Demo 资料是什么、解决哪类问题手上拿到一套“雅特力 M4 内核 AT32F421 开发 Demo 资料”多数人是想把这颗芯片当成 STM32F030/F031 的高性价比替代半天内点亮第一块板子。AT32F421 是雅特力的 Cortex-M4F 产品线主频 120MHz带 FPU定时器和模拟外设比较全定价却落在传统 M0/M3 档位。官方 Demo 包把外设例程、板级支持、时钟配置、评估板原理图放在一起常见做法是在 Keil 里直接编译下载有一套相对完整的参考流程。这篇内容适合刚接触雅特力、或者从 ST 生态转过来想少走弯路的固件工程师我按自己拿到同类资料时的处理顺序来写。2. AT32F421 的资源边界与 M4 内核使用要点2.1 先看内核M4 不是白给的Cortex-M4F 和 F031 这类 M0 内核的区别不只是主频高一点。AT32F421 带单周期硬件乘法、除法、DSP 指令和单精度 FPU这意味着 PID、滤波、FFT 这类计算密集型代码可以放到这颗芯片上跑而不是非要换更高成本的器件。实际使用中要留意MDK 默认可能没开 FPU 编译选项浮点计算会被软浮点兜底代码能跑但效率打折扣在编译选项里加上-mfpufpv4-sp-d16 -mfloat-abihard才能吃到硬件的红利。另一个容易被忽略的点是 M4 的中断控制器是 NVIC优先级可配 16 级不像 M0 只有固定 4 级。Demo 资料里不少例程只写了外设初始化没有显式设抢占优先级迁到复杂应用时自己加一行nvic_irq_enable()是常态。2.2 资源清单开始前先核对这些数字项目AT32F421 典型值使用注意内核Cortex-M4F 120MHz带 FPU可跑 DSP 指令集Flash16KB 至 64KB按型号区分C8T7 为 64KBSRAM4KB 至 16KB高配型号 16KB规划 buffer 时先看型号工作电压2.6V 至 3.6V3.3V 系统直接供电即可工作温度-40℃ 至 105℃以具体型号数据手册为准封装TSSOP20 / QFN32 / LQFP32 / LQFP48Demo 板常用 LQFP48外设数量按细分型号有差异尤其是 USART、SPI、TMR 通道数和 ADC 通道数不能假设所有封装都一样。我一般会在开工前把所用型号的数据手册第 1 页的 feature 表截图存到需求文档里避免后面把某个型号的 DMA 请求映射照抄到另一个型号上。2.3 从 STM32F0 迁过来的三个习惯变化第一外设库风格接近 ST 标准库函数名透明但寄存器和中断号完全独立不能直接替换头文件。第二BOOT 引脚和复位电路有差别AT32F421 的 BOOT0 上拉或下拉处理不当会导致进不了用户程序。第三也是最容易翻车的内部高速 RC 是 48MHz不是 F0 的 8MHz。用内部时钟时SysTick 定时、串口波特率、PWM 分频全部要按 48MHz 重新算拿 F0 的延时函数直接抄过来串口输出全乱码就是这么来的。2.4 系统时钟路径怎么配先看一段最简示意代码理解 AT32F421 的时钟路径/* 示意代码寄存器名和函数名以手头 SDK 头文件为准 */ /* 场景外部 8MHz 晶振HEXT作为 PLL 输入升到 120MHz */ // 1. 使能外部晶振并等待稳定 // crm_clock_source_enable(CRM_CLOCK_SOURCE_HEXT, TRUE); // // 2. 配置 PLL输入 8MHz经过分频/倍频得到 120MHz // crm_pll_config(PLL_CLOCK_SOURCE_HEXT, 8, 15); // // 3. 切换到 PLL 输出作为系统时钟 // crm_sysclk_switch(CRM_SCLK_PLL);代码里我只写逻辑骨架是因为雅特力不同版本的库在函数命名上略有出入但三步顺序不变开晶振、配 PLL、切换系统时钟。实际工程中官方 Demo 在at32f421_clock.c这类文件里已经封装好120MHz HEXT和120MHz 内部 RC两套配置多数情况你不用改只需要确认评估板上晶振焊的是 8MHz 还是 12MHz。内部 RC 模式下没有外部晶振起振失败的问题但精度一般对外通信要求高的场合建议上外部晶振。2.5 主频定了外设时钟树也要跟着定AT32F421 的 APB 分频会影响定时器时钟和串口时钟。看门狗、SysTick、TMR 全部挂在 APB 总线上PLL 输出 120MHz 后APB1 分频系数如果配成 2定时器时钟会再翻倍成 120MHzPWM 频率和占空比计算全部依赖这个数字。我建议每次点灯前先在 main 函数里用调试器读一下CRM-cfg寄存器确认系统时钟、AHB、APB 的实际值再继续往下写。这一步看起来多余但能过滤掉一大半“Demo 跑得好好的我的板子怎么频率不对”的问题。3. 把 Demo 资料在本地跑通先看目录再编译3.1 资料包结构怎么看从官网下载的 AT32F421 资料通常会拆成两个包一个是外设固件库Firmware Library一个是示例工程Demo。常见目录结构如下AT32F421_Firmware_Library/ ├─ cortex_m4/ 启动文件、内核和system文件 ├─ doc/ 库使用说明和应用笔记 ├─ firmware/ │ ├─ at32f421/ 外设头文件与源文件 │ └─ cmsis/ CMSIS 核心头文件 └─ project/ ├─ at32f421_demo/ 官方示例工程 └─ at32f421_template/ 空工程模板Demo 工程常见做法是只维护一个顶层工程通过宏开关决定编译哪个外设例程。在main.c或顶层头文件里可以看到类似#define AT32F421_ADC_DEMO、#define AT32F421_TMR_DEMO这样的编译开关你当前编译哪个例程就把对应的宏注释掉或打开。这个机制对查问题很有用现象不符合预期时先切回 GPIO 例程确认最小系统没问题再切回目标外设。3.2 用 Keil 打开工程前先装 Pack直接双击.uvprojx打开工程再装 Pack 会看到一整片头文件路径报红原因是 MDK 找不到器件描述文件。正确顺序是先在官网下载 AT32F421 的器件 Pack后缀是.pack然后在 MDK 的 Pack Installer 里选择本地导入安装完成后新建工程列表里才能找到 AT32F421 系列。MDK 版本建议 5.27 以上AC5 和 AC6 两个编译器的工程在 Demo 包里都有如果打开工程后没有编译列表或编译按钮灰掉检查工程文件里有没有keil_arm5、keil_arm6两个目录选择与你本机编译器一致的子工程即可。3.3 命令行编译快速验证环境是否可用图形界面编译没问题但想批量确认十几个例程能否通过编译时命令行更高效# UV4.exe 是 Keil 的命令行入口路径按本机安装位置调整 C:\Keil_v5\UV4\UV4.exe -b at32f421_demo.uvprojx -j0 -o build_info.log参数作用-b以批处理模式编译工程不弹出界面-j0自动检测本机 CPU 核心数并行编译-o把编译输出写入指定日志文件-z编译结束后返回错误码0 表示通过编译完成后打开build_info.log搜Error和Warning。如果命令行找不到UV4.exe检查 Keil 安装目录是否包含空格路径整体加引号即可。3.4 烧录和串口验证Demo 板默认的调试器是雅特力自家的 AT-Link插上 USB 后 MDK 的 Debug 设置里选择 CMSIS-DAP 接口即可。如果你的仿真器是 J-Link需要在 MDK 里把 Debugger 换成 J-Link并把 Flash Download 里的算法改成 AT32F421 对应的算法。多数 Demo 例程会通过串口输出运行信息。我一般会打开串口助手波特率设置成 1152008 数据位、1 停止位、无校验。如果输出是乱码第一优先检查系统时钟配置因为串口波特率寄存器按 120MHz 计算调试器暂停在main函数入口读时钟寄存器确认当前系统频率到底是 120MHz 还是 48MHz 没切上去。3.5 下载后按例程现象表核对例程预期现象现象不对时先查GPIO 翻转LED 以固定频率闪GPIO 时钟和引脚模式TMR PWM示波器看到方波定时器分频和极性问题USART 发送串口助手周期性收到字符串波特率计算和时钟源ADC 采样电压值随输入变化ADC 采样通道和参考电压DMA 搬运内存数据持续刷新DMA 外设地址和字节宽度现象表对新手特别有用因为它把“是否跑通”从“我觉得没问题”变成“客观可见的结果”。4. 参考官方 Demo 改一套最小应用4.1 从哪个例程开始抄把官方 Demo 当作基础模板而不是从零搭工程。我建议先找一个包含 GPIO 和 TMR 的例程作为底子比如 PWM 输出例程因为它同时涉及 GPIO 复用配置、外设时钟和定时器参数三件事跑通它等于打通了最小系统加外设框架。之后加 ADC、串口、DMA 都是在这个框架上做加法。看官方例程时重点看三处主函数前的系统初始化、外设初始化函数里的参数结构体、注释里写明的引脚复用。很多移植改动都发生在这三处其他地方可以保持原样。4.2 把 PWM 例程改成自己的引脚和频率/* 把官方 PWM 例程从默认引脚改到 PA8 输出 20kHz PWM */ /* 函数名和宏定义以 SDK 头文件为准这里展示配置思路 */ // 1. 使能 GPIOA 和 TMR1 外设时钟 crm_periph_clock_enable(CRM_GPIOA_PERIPH_CLOCK, TRUE); crm_periph_clock_enable(CRM_TMR1_PERIPH_CLOCK, TRUE); // 2. 配置 PA8 为定时器复用功能 gpio_init_type gp; gp.pin GPIO_PINS_8; gp.mode GPIO_MODE_MUX; gp.pull_up FALSE; gp.pull_down FALSE; gpio_init(GPIOA, gp); // 3. 配置 TMR 输出频率 tmr_base_init_type base; base.period 1200; /* 120MHz / 1200 100kHz */ base.prescaler 5; /* 100kHz / 5 20kHz */ base.repetition_cnt 0; base.clk_div 0; tmr_base_init(TMR1, base); // 4. 配置 PWM 占空比和输出极性 tmr_pwm_init_type pwm; pwm.duty_ratio 50; /* 占空比 50% */ pwm.channel TMR_SELECT_CHANNEL_1; tmr_pwm_init(TMR1, pwm); // 5. 启动 TMR tmr_counter_enable(TMR1, TRUE);这段代码的精髓在参数计算定时器时钟是 120MHzPWM 频率 定时器时钟 /(prescaler 1) / (period 1)我这里写成 1200 和 5实际输出约 20kHz。注意雅特力的period字段是否要加 1不同版本库有差异最稳妥的办法是改完后用频率计或逻辑分析仪实测而不是只靠算。PWM 例程里常见的坑是极性配置反了高电平有效变成低电平有效导致电机或电源调试时行为完全相反。4.3 加一路 ADC 采样并用 DMA 搬运数字电源和电机控制场景必然要采集电压电流。官方 ADC 例程一般只演示查询模式我习惯改成 ADC 连续采样加 DMA 自动搬运减少 CPU 介入。/* 单通道 ADC 连续采样DMA 循环搬运到内存数组 */ /* 函数名和寄存器名以手头 SDK 版本为准 */ adc_base_config_type adc_cfg; adc_cfg.sequence_mode TRUE; /* 序列模式支持多通道 */ adc_cfg.repeat_mode TRUE; /* 连续转换 */ adc_cfg.data_align ADC_RIGHT_ALIGN; adc_cfg.ordinary_trigger ADC_TRIGGER_NONE; /* 软件触发即可 */ adc_base_config_init(ADC1, adc_cfg); /* 使能 ADC1 通道对应 GPIO 为模拟输入 */ gpio_init_type gp; gp.pin GPIO_PINS_0; gp.mode GPIO_MODE_ANALOG; gpio_init(GPIOA, gp); /* 配置 DMA 从 ADC 数据寄存器搬到内存 */ dma_init_type dma_cfg; dma_cfg.peripheral_base_addr (uint32_t)ADC1-odt; dma_cfg.memory_base_addr (uint32_t)adc_buffer; dma_cfg.direction DMA_DIR_PERIPHERAL_TO_MEMORY; dma_cfg.buffer_size 32; dma_cfg.peripheral_inc_enable FALSE; dma_cfg.memory_inc_enable TRUE; dma_cfg.loop_mode_enable TRUE; /* 循环模式 */ dma_init(DMA1_CHANNEL1, dma_cfg); dma_channel_enable(DMA1_CHANNEL1, TRUE); adc_ordinary_conversion_dma_enable(ADC1, TRUE); adc_ordinary_conversion_enable(ADC1, TRUE);参数我的设置说明sequence_modeTRUE后续加多通道时不需要改结构体框架repeat_modeTRUE连续采样省掉每次手动触发loop_mode_enableTRUEDMA 搬运一圈后自动回卷buffer_size32越大滤波效果越稳但内存占用随之上升peripheral_inc_enableFALSEADC 数据寄存器地址固定不需要自增这段配置里最容易踩的坑是 DMA 通道号选错。AT32F421 的 ADC1 请求映射到哪个 DMA 通道以数据手册 DMA 请求映射表为准不同封装和型号可能有差异。通道写错的现象是编译能过内存数组一动不动。4.4 中断优先级和外设开关别乱调把官方例程改成多外设应用时中断优先级是最容易被忽视的。Demo 例程通常只在main里开一个全局中断你加上串口接收、定时器中断、DMA 完成中断后就要显式配置分组和抢占优先级。M4 内核支持优先级分组一般工程全部用抢占优先级即可不需要组内子优先级。我的习惯是ADC DMA 完成中断优先级最高因为数据不及时拿走会影响控制周期串口接收中断其次定时器中断再次。优先级分配完用调试器在HardFault_Handler打断点很多故障其实是中断优先级配置越界或未初始化。4.5 移植完做的最小验证清单改完外设后不要直接接负载。我先做三件事拿万用表量电源引脚电压、拿示波器看 PWM 输出频率、拿串口助手看初始化完成后有没有打印。物理现象全部符合预期后再接执行器。这个顺序能帮你区分“代码问题”和“硬件问题”尤其在做电机控制或电源这类高压环境时等于给自己留了一到安全缓冲。5. 让官方 Demo 资料少埋坑的 4 个技巧技巧一先核对库版本再开干。官网下载的固件库和 Demo 包都可能更新片内 Flash 算法和头文件随之变化。拿到资料后先看release_note或版本号确认与你手上的芯片批次匹配。老批次芯片配新版库外设初始化顺序可能不兼容新批次芯片配旧库烧录算法可能识别不了 Flash 型号。版本不匹配的问题在论坛里经常出现表现是“下载一半卡死”或“能编译但运行异常”。技巧二外部晶振和内部 RC 要明确选一条路。官方的时钟配置文件里通常同时保留 HEXT 和内部 RC 两套宏。我见过不少工程整理者把两套都打开结果 PLL 输入源冲突代码在 while 等待晶振稳定的循环里出不来。处理方式很简单用外部晶振就把内部 RC 配置注释掉用内部 RC 就把外部晶振相关代码注释掉两条路径同时活跃没有任何好处。技巧三J-Link 认不到芯片时换 AT-Link 或 DAP-Link。J-Link 对雅特力的支持依赖具体驱动版本有时即使装了设备包也识别失败。手头没有 AT-Link 时用任意一个 CMSIS-DAP 调试器都能烧录。如果你的产品交给产线烧录建议在开发阶段就固定用和产线一致的烧录器避免开发用 J-Link、产线用 DAP 导致烧录算法配置不一致。技巧四把 Demo 现象录下来当回归基线。每次改完代码不要只确认“能编译”我把例程对应现象录成短视频或者记录成表格GPIO 例程 LED 闪烁频率、PWM 例程输出频率、串口例程发送内容。后续改动任何底层配置先跑一遍这套基线能立刻看出哪次修改影响了无关外设。这个方法成本很低但比调试器断点更早暴露问题。本文还有配套的精品资源点击获取