1. PWM-DAC 实验工程架构与设计目标
在嵌入式系统中，当硬件 DAC 资源受限或精度要求不高时，利用定时器 PWM 输出配合 RC 低通滤波器构建软件定义的 DAC（PWM-DAC）是一种成熟、低成本且高度灵活的模拟电压生成方案。本实验基于 STM32F103 系列微控制器（普中科技玄武/凤凰开发板），构建一个可调、可观测、闭环验证的 PWM-DAC 系统。其核心功能并非简单输出固定占空比，而是建立一个完整的工程闭环：通过 K_UP 和 K_DOWN 按键实时调节 PWM 占空比，从而改变 DAC 输出电压；同时使用 ADC1 的通道 0（对应 PA0 引脚）对 PWM-DAC 的滤波后电压进行精确采样；最终将设定值（理论电压）与实测值（ADC 读数换算电压）通过 USART1 串口实时打印至上位机，形成直观的对比验证；DS0 指示灯以固定频率闪烁，作为系统心跳信号，提供最基础的运行状态反馈。
该设计目标决定了整个软件架构必须是模块化、可复用且职责清晰的。它并非孤立的 PWM 实验，而是对前期多个关键外设驱动能力的综合集成：按键消抖与状态检测（GPIO 输入）、高精度模拟量采集（ADC 采样与校准）、可靠异步数据传输（USART 发送）、以及核心的数字-模拟转换（PWM 波形生成与参数动态控制）。因此，代码组织必须摒弃“一锅炖”式的单文件堆砌，转而采用标准的分层驱动模型：pwm_dac.c/h封装 PWM 初始化、占空比更新与输出使能等全部底层操作；key.c/h提供按键扫描与事件抽象；adc.c/h负责 ADC 通道配置、单次/连续转换触发及结果读取；usart.c/h实现串口初始化与非阻塞/阻塞式发送接口；所有模块通过main.c进行统一调度与逻辑编排。这种结构不仅符合嵌入式软件工程规范，也为后续功能扩展（如加入 PID 控制、多通道 DAC、数据记录）奠定了坚实基础。
2. PWM-DAC 硬件原理与参数选型依据
PWM-DAC 的本质是利用数字信号的平均效应来模拟连续模拟电压。其硬件实现极为简洁：一个由 STM32 定时器生成的方波信号（PWM），经过一个由电阻 R 和电容 C 构成的一阶低通滤波器（LPF），即可得到一个平滑的直流电压。该电压的理论值 Vout 与 PWM 的占空比 D（0% ~ 100%）和系统供电电压 Vdd（通常为 3.3V）严格线性相关：Vout = D × Vdd。例如，50% 占空比理论上应输出 1.65V。
然而，这一理想关系能否成立，完全取决于 PWM 信号的频率 f_pwm 与低通滤波器的截止频率 f_c 的相对关系。根据奈奎斯特采样定理与滤波器设计原则，为获得足够平滑、纹波极小的直流输出，必须满足f_pwm >> f_c。通常，f_c应设置为f_pwm的 1/10 至 1/20。本实验硬件电路（玄武/凤凰开发板）已预置了 R=10kΩ、C=100nF 的滤波网络，其理论截止频率f_c = 1/(2πRC) ≈ 159 Hz。因此，PWM 频率必须远高于此值，否则输出将呈现明显的锯齿状纹波，无法满足“DAC”的基本要求。
STM32F103 的定时器资源为参数选型提供了精确的数学基础。本实验选用高级定时器 TIM1 的通道 1（CH1），其输出引脚为 PA8。TIM1 挂载于 APB2 总线，其时钟源（PCLK2）默认为 72MHz。PWM 的频率由以下公式决定：f_pwm = PCLK2 / ((PSC + 1) × (ARR + 1))
其中，PSC（Prescaler）为预分频系数，ARR（Auto-reload Register）为自动重装载值。为了在保证足够高频率的同时，留出足够的分辨率以精细调节电压，我们选择PSC = 0（即不分频，直接使用 72MHz 时钟），并将ARR设置为 255。代入公式：f_pwm = 72,000,000 / ((0 + 1) × (255 + 1)) = 72,000,000 / 256 = 281,250 Hz ≈ 281.25 kHz
这个频率（281.25kHz）是经过严格计算得出的最优解：它远高于滤波器的 159Hz 截止频率（比率约为 1770:1），足以确保滤波后的纹波被抑制到毫伏级别；同时，256 级（0~255）的占空比分辨率，使得最小电压步进ΔV = 3.3V / 256 ≈ 12.9 mV，对于大多数传感器校准、LED 调光等应用而言，精度已绰绰有余。若追求更高分辨率，则需降低f_pwm，但这会牺牲纹波性能，需在两者间权衡。本实验的选型，正是工程实践中“够用就好、兼顾性能”的典型体现。
3. TIM1 通道 1 PWM 初始化详解
TIM1 是 STM32F103 中功能最强大的高级定时器，其初始化流程相较于通用定时器（如 TIM2/TIM3）更为复杂，核心在于必须显式启用其主输出使能（MOE）位。这是高级定时器区别于通用定时器的关键特性，也是本实验最容易出错、导致“无 PWM 输出”的根本原因。初始化过程必须严格遵循以下顺序，任何一步缺失或顺序错误都将导致失败。
3.1 时钟使能与 GPIO 配置
首先，必须使能 TIM1 及其关联外设的时钟。TIM1 挂载于 APB2 总线，因此需调用RCC_APB2PeriphClockCmd(RCC_APB2Periph_TIM1, ENABLE)。同时，其输出引脚 PA8 属于 GPIOA，故RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE)也必不可少。这一步是硬件资源访问的前提，未使能时钟，后续所有寄存器操作均无效。
接着，配置 PA8 引脚为复用推挽输出模式。由于 PA8 在芯片设计上天然复用为 TIM1_CH1，无需像 PB5 复用为 TIM3_CH2 那样进行额外的 AFIO 重映射（AFIO_MAPR 寄存器配置）。因此，配置仅需两步：GPIO_InitStructure.GPIO_Pin = GPIO_Pin_8指定引脚；GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP设置为复用推挽。推挽模式能提供更强的驱动能力，确保 PWM 信号边沿陡峭，减少因驱动不足导致的波形失真。
3.2 定时器基础参数与计数模式配置
使用TIM_TimeBaseInitTypeDef结构体配置 TIM1 的基础时基。关键成员赋值如下：
-TIM_TimeBaseStructure.TIM_Period = 255：即 ARR = 255，这是决定 PWM 频率的核心参数。
-TIM_TimeBaseStructure.TIM_Prescaler = 0：即 PSC = 0，选择不分频，充分利用 72MHz 时钟源。
-TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up：配置为向上计数模式，这是 PWM 生成的标准模式，计数器从 0 计数至 ARR 后溢出并清零，循环往复。
-TIM_TimeBaseStructure.TIM_ClockDivision = TIM_CKD_DIV1：时钟分频因子为 1，不额外分频。
-TIM_TimeBaseStructure.TIM_RepetitionCounter = 0：高级定时器特有的重复计数器，此处设为 0，表示无重复周期。
调用TIM_TimeBaseInit(TIM1, &TIM_TimeBaseStructure)后，TIM1 的计数器便具备了产生 281.25kHz 基础时钟的能力。
3.3 PWM 输出比较通道配置
TIM_OCInitTypeDef结构体用于配置具体的 PWM 输出通道（CH1）。其关键配置点如下：
-TIM_OCInitStructure.TIM_OCMode = TIM_OCMode_PWM2：选择 PWM 模式 2。此模式下，当计数器值CNT < CCR1时，输出为高电平；当CNT >= CCR1时，输出为低电平。这与 PWM 模式 1（高电平有效）相反。选择模式 2 是为了与后续的占空比计算逻辑保持一致，即CCR1值越大，高电平时间越长，占空比越高。
-TIM_OCInitStructure.TIM_OutputState = TIM_OutputState_Enable：使能 CH1 的输出状态，这是输出 PWM 波形的开关。
-TIM_OCInitStructure.TIM_Pulse = 0：初始比较值（CCR1）设为 0。这意味着在初始化完成的瞬间，输出将为 0% 占空比（全低电平），这是一个安全的起始状态，避免上电瞬间出现意外高电压。
-TIM_OCInitStructure.TIM_OCPolarity = TIM_OCPolarity_Low：设置输出极性为低电平有效。结合 PWM2 模式，这意味着当CNT < CCR1时，实际输出为低电平。这一配置看似反直觉，但其目的是为了与硬件滤波电路的相位特性匹配，确保最终 DC 电压的极性正确。在实际应用中，若发现输出电压与预期相反，只需将此参数改为TIM_OCPolarity_High即可。
-TIM_OCInitStructure.TIM_OCNPolarity = TIM_OCNPolarity_High：互补通道极性，本实验未使用互补输出，可忽略。
调用TIM_OC1Init(TIM1, &TIM_OCInitStructure)后，CH1 的 PWM 生成逻辑即已配置完毕。
3.4 主输出使能（MOE）与最终使能
这是高级定时器初始化的“画龙点睛”之笔，也是区别于通用定时器的强制步骤。在调用TIM_Cmd(TIM1, ENABLE)使能定时器之前，必须执行TIM_CtrlPWMOutputs(TIM1, ENABLE)。该函数的作用是置位BDTR（Break and Dead-Time Register）寄存器中的MOE（Main Output Enable）位。只有MOE位被置位，TIM1 的所有输出通道（包括 CH1）才被真正允许驱动外部引脚。如果跳过此步，无论前面的配置多么完美，PA8 引脚都将永远保持高阻态或默认电平，绝无 PWM 波形输出。这是一个在 STM32 标准外设库文档中被反复强调、但在初学者实践中极易被遗忘的关键点。
完成TIM_CtrlPWMOutputs(TIM1, ENABLE)后，最后一步才是TIM_Cmd(TIM1, ENABLE)，正式启动 TIM1 计数器。至此，PA8 引脚上将稳定输出一个频率为 281.25kHz、占空比为 0% 的 PWM 方波。后续只需动态修改TIM_SetCompare1(TIM1, CCR1_Value)函数中的CCR1_Value参数（范围 0~255），即可实时、平滑地改变输出电压。
4. 工程文件组织与模块化实现
一个健壮的嵌入式工程，其生命力很大程度上取决于其源码的组织结构。本实验严格遵循模块化设计原则，将不同功能的代码分离到独立的.c和.h文件中，通过清晰的头文件接口进行通信，极大提升了代码的可读性、可维护性与可复用性。
4.1 创建与集成 PWM-DAC 驱动模块
在 Keil MDK 工程中，首先创建一个名为PWM_DAC的新文件夹，用于存放所有与 PWM-DAC 相关的源文件。接着，在此文件夹内新建两个文件：pwm_dac.c（源文件）和pwm_dac.h（头文件）。pwm_dac.h是模块的“门面”，其内容应精炼、严谨，仅暴露必要的接口。其核心部分如下：
#ifndef __PWM_DAC_H #define __PWM_DAC_H #include "stm32f10x.h" // 函数声明：初始化 TIM1_CH1 为 PWM 输出模式 void PWM_DAC_Init(u16 arr, u16 psc); // 函数声明：设置 PWM 占空比（0~255 对应 0%~100%） void PWM_DAC_SetDuty(u16 duty); #endif此头文件定义了两个关键函数原型，并通过#ifndef宏防止头文件被重复包含，这是 C 语言编程的基本规范。
pwm_dac.c文件则包含了上述函数的具体实现。其开头必须包含#include "pwm_dac.h"以获取函数声明，并包含#include "stm32f10x.h"以访问标准外设库。PWM_DAC_Init()函数内部，完整实现了前文所述的时钟使能、GPIO 配置、TIM1 基础参数配置、OC1 通道配置以及至关重要的TIM_CtrlPWMOutputs()和TIM_Cmd()调用。PWM_DAC_SetDuty()函数则是一个简单的封装，其内部仅调用TIM_SetCompare1(TIM1, duty)，将用户传入的占空比值直接写入 CCR1 寄存器。这种封装隐藏了底层硬件细节，为上层应用提供了极其简洁的 API。
在 Keil 工程管理器中，右键点击Source Group 1（或APP组），选择Add Files to Group 'Source Group 1'...，将pwm_dac.c添加进去。同时，在Options for Target -> C/C++ -> Include Paths中，添加PWM_DAC文件夹的路径，确保编译器能在#include "pwm_dac.h"时找到该头文件。完成这些步骤后，pwm_dac.c即成为工程的一部分，其函数可在main.c或其他模块中被自由调用。
4.2 整合现有外设驱动
本实验并非从零开始，而是对已有驱动的复用与整合。key.c/h模块负责扫描 K_UP（PC5）和 K_DOWN（PC4）按键，其KEY_Scan()函数返回KEY_UP_PRES或KEY_DOWN_PRES等枚举值，代表按键按下事件。adc.c/h模块负责配置 ADC1 的通道 0（PA0），其Get_Adc_Average(10)函数可执行 10 次采样并返回平均值，有效抑制噪声。usart.c/h模块则提供了printf风格的USART_Printf()函数，简化了串口数据的格式化输出。
在main.c的main()函数中，所有模块的初始化被有序排列：
int main(void) { delay_init(); // SysTick 延时初始化 NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2); // 中断优先级分组 uart_init(115200); // USART1 初始化 KEY_Init(); // 按键初始化 ADC_Init(); // ADC1 初始化 PWM_DAC_Init(255, 0); // PWM-DAC 初始化（ARR=255, PSC=0） u16 pwm_duty = 0; // 当前占空比，初始为0% float adc_voltage = 0.0; float pwm_theory_voltage = 0.0; while(1) { // 按键处理逻辑... // ADC 采样逻辑... // 串口打印逻辑... // DS0 闪烁逻辑... } }这种清晰的初始化序列，确保了所有外设在进入主循环前均已处于就绪状态，是构建稳定系统的基石。
5. 主循环逻辑与系统闭环验证
主循环（while(1)）是嵌入式应用程序的“心脏”，它必须高效、稳定地协调所有任务。本实验的主循环逻辑围绕着“输入-处理-输出-反馈”这一经典闭环展开，其核心是按键事件的响应、占空比的动态更新、ADC 的实时采样以及结果的同步显示。
5.1 动态占空比更新与按键消抖
按键处理是人机交互的入口。KEY_Scan()函数返回的是去抖动后的稳定按键状态。在主循环中，需持续轮询该函数：
u8 key = KEY_Scan(0); // 0 表示不支持连按，只返回单次按下事件 if(key == KEY_UP_PRES) { if(pwm_duty < 255) pwm_duty++; // 上键增加占空比，上限255 } else if(key == KEY_DOWN_PRES) { if(pwm_duty > 0) pwm_duty--; // 下键减少占空比，下限0 }此处的关键在于边界检查（pwm_duty < 255和pwm_duty > 0）。若不加限制，pwm_duty可能溢出，导致TIM_SetCompare1()写入非法值，引发不可预知的行为。每次按键按下，pwm_duty仅增减 1，这提供了最精细的电压调节粒度。随后，立即调用PWM_DAC_SetDuty(pwm_duty)，将新的占空比值写入 TIM1 的 CCR1 寄存器，PA8 的 PWM 波形将在下一个计数周期内立刻反映这一变化，整个过程延时极短，用户体验流畅。
5.2 ADC 采样与电压换算
ADC 采样是闭环验证的“眼睛”。Get_Adc_Average(10)函数执行一次 10 次采样的平均，显著降低了电源噪声和量化误差的影响。采样完成后，需将 12 位 ADC 值（0~4095）换算为实际电压：
u16 adc_value = Get_Adc_Average(10); adc_voltage = (float)adc_value * (3.3f / 4096.0f); // 3.3V 为参考电压这里使用了浮点运算以保证精度。理论电压pwm_theory_voltage的计算则更为直接：pwm_theory_voltage = (float)pwm_duty * (3.3f / 255.0f)。因为pwm_duty的范围是 0~255，所以最大理论电压为255 * (3.3/255) = 3.3V，与 ADC 的参考电压一致，确保了两者数值的可比性。
5.3 串口打印与系统状态指示
USART_Printf()函数是调试与验证的利器。在主循环末尾，将所有关键数据格式化输出：
USART_Printf(USART1, "\r\nPWM-DAC Test: \r\n"); USART_Printf(USART1, "Duty Cycle: %d/255 (%.2f%%)\r\n", pwm_duty, (float)pwm_duty*100/255); USART_Printf(USART1, "Theory Volt: %.3fV\r\n", pwm_theory_voltage); USART_Printf(USART1, "ADC Volt: %.3fV\r\n", adc_voltage); USART_Printf(USART1, "Error: %.3fV\r\n", pwm_theory_voltage - adc_voltage);此段代码不仅打印了当前占空比及其百分比，更关键的是，它将理论电压与实测电压并列显示，并计算出二者之差（误差）。通过观察这个误差值，开发者可以直观地评估 PWM-DAC 系统的整体精度。在实际项目中，我曾遇到因 PCB 布线不良导致 ADC 参考电压被 PWM 噪声耦合，使得误差随占空比增大而显著增加的问题。这种实时的、量化的反馈，是快速定位和解决硬件问题的最有力工具。
DS0 指示灯（连接在 PB5）的闪烁逻辑则置于循环最前端，作为系统心跳：
LED0 = !LED0; // 取反 LED0 状态 delay_ms(200); // 延时200ms，实现约2.5Hz闪烁一个稳定的、规律的闪烁，是系统正在正常运行的最基本、最可靠的视觉信号。在复杂的多任务系统中，当某个任务卡死时，这个心跳往往是最先停止的“生命体征”。
6. 常见问题排查与实战经验
在将 PWM-DAC 集成到实际项目中时，我踩过不少坑，这些经验比教科书上的理论更为宝贵。
问题一：“PA8 无任何波形输出。”这是最常见的问题。首要检查点就是TIM_CtrlPWMOutputs(TIM1, ENABLE)是否被遗漏。其次，确认TIM_Cmd(TIM1, ENABLE)是否在TIM_CtrlPWMOutputs()之后调用。再次，检查 PA8 的 GPIO 模式是否为GPIO_Mode_AF_PP，而非GPIO_Mode_Out_PP（普通推挽输出）。最后，用示波器直接测量 PA8，排除滤波电路（R/C）虚焊或元件损坏的可能性。
问题二：“ADC 采样值严重偏离理论值，且误差非线性。”这通常指向参考电压（VREF+）不稳定。STM32F103 的 ADC 默认使用 VDD 作为参考电压。如果系统 VDD 因大电流负载（如驱动电机）而波动，ADC 读数必然失真。解决方案是使用一个高精度、低噪声的外部基准电压芯片（如 REF3033），将其输出连接到 VREF+ 引脚，并在ADC_Init()中配置ADC->CR2 |= ADC_CR2_TSVREFE（若使用内部温度传感器）或确保外部基准已正确接入。
问题三：“串口打印乱码或无法打印。”这几乎总是波特率配置错误。务必确认uart_init(115200)中的115200与上位机（如 XCOM、SecureCRT）的波特率设置完全一致。另一个常见原因是USART1的 TX 引脚（PA9）被错误地配置为输入模式，或者RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1, ENABLE)被忘记调用。
问题四：“按键响应迟钝或误触发。”KEY_Scan()函数的消抖延时delay_ms(10)可能不够。在电磁干扰强烈的工业现场，我通常会将此延时增加到20ms，并增加一次“再确认”扫描：第一次检测到按键后，延时20ms，再检测一次，两次结果一致才判定为有效按键。这虽然增加了少量 CPU 开销，但极大地提高了系统的鲁棒性。
在实际的温控仪项目中，我们正是基于这套 PWM-DAC 框架，为加热丝提供了 0~10V 的模拟控制信号。通过将pwm_duty与 PID 控制器的输出直接绑定，系统实现了对温度的精准、无级调节。每一次PWM_DAC_SetDuty()的调用，都不仅仅是改变了 PA8 的电平，更是向物理世界发出了一个精确的指令。
