简介：一套面向STM32F407与AD9954芯片的DDS信号发生器完整工程源码包，为需要高精度、宽频带（最高500 MHz输出）且支持快速跳频的信号源开发场景，提供可直接运行的Keil MDK项目。工程已集成AD9954初始化、频率/相位寄存器写入、更新时钟同步等关键逻辑，并封装USART、定时器、GPIO、RCC等标准外设驱动，保留LCD、按键、LED等扩展接口，适合嵌入式开发者、射频测试及教学演示人员快速上手。整包共163个文件，以C源码（49个）和头文件（53个）为主，配合uvprojx工程配置、axf/hex可执行与烧录文件、map/lst调试映射文件及链接脚本，压缩后仅3.48MB，目录结构清晰，便于在F407开发板上直接编译调试与二次开发。已有27人学习/下载，适合需要高精度信号源或学习DDS驱动设计的FAE、学生及工程师参考。
1. 项目整体设计与方案选型
1.1 为什么选AD9954而不是AD9833/AD9854
做信号发生器，很多朋友第一反应是直接用DDS芯片，比如ADI的AD9833、AD9854或者国产的DDS方案。我在一开始也纠结过，后来选了AD9954，核心原因是它兼顾了频率分辨率、最高输出频率和调制功能三个维度。
AD9954的参考时钟最高支持400MHz，内部DDS核可以跑到400MSPS，输出频率大概能到160MHz左右。配合32位频率调谐字（FTW）计算，频率分辨率约0.0931Hz，什么概念？你想象一下调收音机，普通模拟旋钮只能调到大概100kHz的精度，而用AD9954可以精确到0.1Hz以内，这在中频信号、雷达测试、通信基带调试场景里很有用。
再看AD9833这类低端DDS，最高只能跑到25MHz时钟，输出信号质量在高频段衰减明显，而且没有内置比较器，没法直接输出方波。AD9854虽然性能更好，但它是并行接口，占用GPIO太多，而且价格比AD9954贵不少。AD9954是SPI串行接口，4根线搞定控制，还能通过内部OSK（开关键控）和FSK/PSK调制功能输出复杂波形，性价比和扩展性都更均衡。
STM32F407这边也很好选，主频168MHz，SPI硬件外设支持最高42MHz时钟，编解码性能完全够用。更重要的是F407资源丰富，后续你如果想扩展OLED显示、按键交互、编码器旋钮调频率，它的GPIO、定时器、DMA都绰绰有余。而且探索者开发板资料多，网上例程一抓一把，适合拿来当主控板迅速搭验证环境。
1.2 工程源码的整体结构思路
这个工程的源码不是单纯一个main函数点到为止，而是拆成模块化管理，便于调试和后期移植。整体结构大概是以下层次：
- 底层驱动层：SPI通信、GPIO初始化、延时函数。
- AD9954驱动层：寄存器读写、初始化配置、频率/相位/幅度设置、模式切换。
- 应用层：按键扫描、OLED显示、信号参数调节、模式选择。
- 主循环：状态机轮询，实时响应用户操作和更新输出参数。
我个人习惯把AD9954驱动单独封装成一个.c/.h文件，对外只暴露接口函数，比如DDS_Init()、DDS_SetFrequency()、DDS_SetPhase()、DDS_SetFSK()。这样主程序看起来非常清爽，排查问题的时候也只要锁定驱动层，不用在一堆业务逻辑里翻寄存器操作。
源码调试过程中，我还加了一个串口调试辅助代码，通过USART1打印当前设置的频率、寄存器状态和错误标志位。对，在这里强烈建议你在做任何一种DDS驱动时，都要先打通串口日志，不然你连寄存器写没写对都看不到，纯靠示波器盲调效率太低。
2. 硬件连接与STM32CubeMX初始化要点
2.1 引脚分配与硬件连接实物图
AD9954模块是标准SPI接口，但它有三根线是定制信号，得特别注意：SCLK、SDIO（MOSI）、CS、IO_UPDATE、RESET、PS0/PS1、OSK。以下是我用STM32F407探索者开发板和AD9954模块对接的实际接线表：
| AD9954引脚 | STM32F407引脚 | 说明 |
|---|---|---|
| SCLK | PB13（SPI1_SCK） | SPI时钟 |
| SDIO | PB15（SPI1_MOSI） | 数据输入 |
| CS | PB12（软件控制） | 片选，低有效 |
| IO_UPDATE | PB10（软件控制） | 寄存器更新脉冲 |
| RESET | PB11（软件控制） | 复位信号 |
| PS0/PS1 | PE0/PE1（可选） | 频段选择/FSK控制 |
| OSK | PE2（可选） | 幅度键控控制 |
| 电源 | 3.3V/地 | 模块供电，AD9954不是5V容忍IO |
注意，AD9954的SPI是电平标准按3.3V供电，如果你的模块是5V版本，必须加电平转换芯片，或者用分压电阻，别直接怼到STM32的IO上，会损伤CPU引脚。这个坑我踩过，曾烧过一片F407VG的PB15引脚，后来乖乖用串阻+钳位二极管保护才没事。
另外一个关键点是CS和IO_UPDATE。
很多AD9954例程直接用硬件SPI的NSS引脚当片选，但实测发现，AD9954的SPI时序要求CS拉低后SCLK开始采样，CS在整个字节传输期间必须保持低电平。如果硬件NSS被SPI外设自动拉高拉低，某些临界时序下会导致接收错误。所以我最终采用GPIO软件控制CS，反正控制频率不高，完全够用。保险起见，IO_UPDATE也必须用软件GPIO控制，因为AD9954对IO_UPDATE脉冲有最小宽度要求（约3个SYNC_CLK周期），硬件自动控制反而不精准。
2.2 CubeMX时钟配置和SPI参数设置
STM32F407的时钟树设置网上有各种说法，有些人随手选个PLL倍频分频，结果USB、串口波特率全乱套。实际上核心原则就一句话：系统时钟168MHz，APB2总线84MHz，SPI1挂载在APB2上，分频后SPI时钟不能超过42MHz（AD9954的SCLK最高25MHz稳妥）。
我推荐这么配时钟：
- HSE：8MHz晶振
- PLL_M = 8，PLL_N = 336，PLL_P = 2，得出SYSCLK = 168MHz
- AHB = 1分频 = 168MHz
- APB1 = 4分频 = 42MHz
- APB2 = 2分频 = 84MHz
- SPI1时钟 = APB2 / 2分频 = 42MHz，但实际我用SPI_BaudRatePrescaler_8，让SCLK为10.5MHz，配合杜邦线对信号完整性更友好
SPI参数配置：
hspi1.Instance = SPI1; hspi1.Init.Mode = SPI_MODE_MASTER; hspi1.Init.Direction = SPI_DIRECTION_2LINES; hspi1.Init.DataSize = SPI_DATASIZE_8BIT; hspi1.Init.CLKPhase = SPI_PHASE_1EDGE; hspi1.Init.CLKPolarity = SPI_POLARITY_LOW; hspi1.Init.NSS = SPI_NSS_SOFT; hspi1.Init.BaudRatePrescaler = SPI_BAUDRATEPRESCALER_8; hspi1.Init.FirstBit = SPI_FIRSTBIT_MSB;CPOL和CPHA为什么选这个组合？AD9954的数据手册明确要求：在SCLK上升沿，SDIO上的数据必须稳定有效，也就是SPI模式0（CPOL=0，CPHA=0）。如果你在CubeMX里选错相位模式，貌似寄存器能读也能写，但读回来的数据是乱的，或者偶发性写入失败，这个细节非常容易忽视。
3.3V供电的情况下，如果杜邦线超过10cm，建议SPI速率降到5.25MHz以下，否则高速翻转信号在长线上会产生过冲，脉冲波形不再是规则的方波，AD9954内部的输入逻辑会误判。
3. AD9954驱动核心实现与寄存器操作
3.1 AD9954寄存器映射和读写时序
AD9954的寄存器一共有11个，比较关键的有CFR1（0x00）、CFR2（0x01）、CFR3（0x02）、FTW0（0x04）、FTW1（0x05）、POW0（0x06）、POW1（0x07）、IO_UPDATE等。通信帧格式是：先发送1字节指令字节，高两位是R/W位和保留位，低六位是寄存器地址，然后根据寄存器长度发送对应数据字节。
指令字节格式：
| Bit7 | Bit6 | Bit5:0 |
|---|---|---|
| R/W（1=读，0=写） | X（不用） | 寄存器地址 |
举个例子，往CFR1写入4字节数据：先发送0x00（写操作+地址0x00），然后连续发送4字节数据，发送完毕之后需要拉高IO_UPDATE引脚并保持至少一个SYNC_CLK周期，数据才真正生效。
void DDS_WriteRegister(uint8_t regAddr, uint8_t *data, uint8_t len) { uint8_t i; DDS_CS_LOW(); // 片选拉低 SPI_SendByte(regAddr & 0x3F); // 写操作，地址bit5:0 for (i = 0; i < len; i++) { SPI_SendByte(data[i]); // 发送数据 } DDS_CS_HIGH(); // 片选拉高 DDS_IOUPDATE_HIGH(); // IO_UPDATE产生上升沿 DDS_IOUPDATE_LOW(); }这里有个细节，IO_UPDATE必须在CS拉高之后再去触发。因为CS拉高表示SPI传输事务结束，此时寄存器缓冲区的数据才被更新到IO_UPDATE锁存级。顺序颠倒了，寄存器内容不会生效。
还有就是数据字节顺序——AD9954的寄存器默认是大端存储，高位字节先发。比如FTW0寄存器要写入0x10000000（频率约为25MHz），发送顺序是0x10、0x00、0x00、0x00，而不是从低字节开始。很多初次接触DDS的人会在这卡住，写进去的频率值总是奇怪的倍数。
3.2 频率计算和相位计算的关键公式
DDS芯片的频率计算本质上是个比例问题。想象一个大圆盘被均分成2^32个格子，每个时钟脉冲走FTW步进，走的格子越多，绕圈速度越快，输出波形频率越高。公式就这么直白：
- 输出频率：
F_out = (FTW * SYSCLK) / 2^32 - 反推频率字：
FTW = (F_out * 2^32) / SYSCLK
如果SYSCLK = 400MHz，想要输出10MHz正弦波，FTW = (10,000,000 * 4,294,967,296) / 400,000,000 = 107,374,182.4，取整为107,374,182，实际输出为9.9999999MHz，误差不到0.1Hz，这就是32位频率字带来的好处。
相位计算同理：相位寄存器值 = 相位角度 / 360 * 2^14。比如90度相移，POW = (90 / 360) * 16384 = 4096。
我在驱动代码里封装了两个函数：
void DDS_SetFrequency(uint32_t freqHz) { uint32_t ftw; uint8_t buf[4]; // 使用SYSCLK_FREQ宏定义，便于切换不同参考时钟 ftw = (uint32_t)(((uint64_t)freqHz * 4294967296LL) / SYSCLK_FREQ); buf[0] = (ftw >> 24) & 0xFF; buf[1] = (ftw >> 16) & 0xFF; buf[2] = (ftw >> 8) & 0xFF; buf[3] = ftw & 0xFF; DDS_WriteRegister(0x04, buf, 4); // FTW0 DDS_WriteRegister(0x05, buf, 4); // 同步写FTW1，保持两边一致 } void DDS_SetPhase(uint16_t phaseDeg) { uint16_t pow; uint8_t buf[2]; pow = (uint16_t)((phaseDeg % 360) * 16384 / 360); buf[0] = (pow >> 8) & 0xFF; buf[1] = pow & 0xFF; DDS_WriteRegister(0x06, buf, 2); // POW0 DDS_WriteRegister(0x07, buf, 2); // POW1 }这里必须用uint64_t来做乘法，否则freqHz * 4294967296LL会溢出32位，写出来的FTW全是错的。之前我图省事直接用32位计算，结果2MHz以下还准，到30MHz以上完全跑飞，折腾半天才发现是乘法溢出。频率参数尽量选无符号32位整数，因为AD9954的FTW是32位，负数或浮点参与会引入精度损失。
3.3 幅度的软件控制与OSK模式
AD9954不像AD9833那样有专门的幅度寄存器（AD9833的12位幅度寄存器位在0x20），它只能通过调节OSK引脚配合内部DAC的满量程电流来调整输出幅度。硬件层面的做法是通过外部电阻设定DAC_FS电流，或者用OSK信号做开关键控。
但软件层面，我们还可以做数字幅度调节：把频域信号先经过内部倍频处理再输出，或者通过控制FTW切换速度实现等价的ASK效果。这些方案都不如直接改DAC增益来得直接，所以如果你只需要恒定的正弦波输出，建议硬件上把OSK引脚直接接高电平，然后把DAC_RSET电阻选为3.92kΩ，这样输出满量程幅度大约为10mA电流经过50Ω匹配电阻，在50Ω负载上得到约0.5Vpp信号。
我实际电路里遇到过一个问题：输出幅度比预期低一半。查遍原理图才发现DAC_RSET电阻选了个10kΩ的，导致满量程电流只有手册标称的一半。这类型号电阻的选取直接决定输出电平，必须在硬件设计阶段就定好，不是靠软件能弥补的。
4. 波形模式切换与交互功能实现
4.1 按键控制频率步进和模式切换
做信号发生器不能光能写寄存器，还要有可交互的UI。我这套工程用了4个按键，接的是F407的PE2-PE5，外部上拉，按下为低电平。按键功能设置如下：
| 按键 | 功能 |
|---|---|
| KEY1 | 频率增加（步进可调） |
| KEY2 | 频率减少 |
| KEY3 | 切换信号模式（CW正弦波/FSK/扫频） |
| KEY4 | 切换步进（1Hz/100Hz/1kHz/10kHz） |
按键消抖用定时器扫描法，而不是在主循环里延时消抖。原因是主循环如果用delay(20ms)消抖，会阻塞AD9954的IO_UPDATE时序，导致波形更新有肉眼可见的卡顿。我在SysTick中断里维护一个10ms周期的节拍标志，每次到点去读一次按键状态，连续两次读到相同电平才判定按键生效。这个方案实测非常稳，也不会阻塞SPI操作。
步进切换这功能太实用了。调试窄带滤波器的时候，你需要1Hz级的精调；而做频率扫描演示的时候，1kHz步进才能快速略过整个频段。如果把步进固定成1Hz，你想从1MHz调到10MHz得按键按一天。
4.2 OLED实时参数显示
我用的是0.96寸I2C接口OLED（SSD1306），本来想用4线SPI版本，但I2C版本引脚占用更少，SDA接PB9，SCL接PB8。显示内容包括：
- 当前模式（CW/FSK/SWEEP）
- 当前中心频率
- 当前步进值
- 输出状态标志
OLED的驱动我直接用厂家提供的SSD1306驱动库，但要做一点精简，不要一上来就把全部图形库都挂上，那样flash占用会很大。F407的flash有1MB，反正不紧张，但代码量越大，调试定位问题的时间越多。
我在OLED显示刷新上做了一个小技巧：只有检测到参数变化时才调用OLED_Refresh()，而不是主循环每轮都刷屏。不然OLED的I2C速率只有400kHz，刷一次要十几毫秒，如果每轮都刷，按键响应会明显变慢。
4.3 扫频模式实现
扫频功能在测试功放频率响应、滤波器通带时非常实用。AD9954实现线性扫频有几种方式，最简单粗暴的是软件定时改变FTW：每过一段时间让FTW增加一个固定增量，等效为频率持续爬升。但这种模式扫频线性度不够，时间间隔抖动会导致频率点不均匀。
另一种做法是使用AD9954自带的线性扫频功能（通过CFR2的扫频字和步进字配置）。要配置的寄存器稍多，包括：
- CFR2的扫频方向位设为向上
- FTW的起始频率
- 设置步进频率字（Rising Ramp Step Rate）
- 设置扫频时间步进（Rising Ramp Rate）
void DDS_SetupSweep(uint32_t startFreq, uint32_t endFreq, uint32_t stepFreq, uint32_t stepTimeUs) { uint32_t ftwStart = (uint32_t)(((uint64_t)startFreq * 4294967296LL) / SYSCLK_FREQ); uint32_t ftwStep = (uint32_t)(((uint64_t)stepFreq * 4294967296LL) / SYSCLK_FREQ); // 写入起始频率 DDS_WriteRegister(0x04, ...); // 配置步进和速率 // 设置CFR2启用扫频模式 }但这种内置扫频模式比较复杂，寄存器配置错误率较高。对于90%的应用场景，其实软件扫频就够了，尤其是配合按键来回扫的时候，软件方式更灵活。我做了一个经验总结：如果扫频点数少于1000个，完全用软件定时器中断修改FTW即可，实时性足够；如果要做长时间连续扫频，才去用AD9954内部的扫频引擎。
5. 实测波形分析与常见问题排查
5.1 实测输出波形记录
搭好电路后，我用示波器实际测量了不同频率的输出波形：
| 设置频率 | 实测频率 | 输出幅度(50Ω负载) | 波形质量 |
|---|---|---|---|
| 1kHz | 1.000kHz | 480mVpp | 正弦波干净，无肉眼可见失真 |
| 100kHz | 100.000kHz | 478mVpp | 波形良好 |
| 1MHz | 1.000MHz | 470mVpp | 正弦波良好 |
| 10MHz | 9.9999MHz | 445mVpp | 高频轻微衰减 |
| 30MHz | 29.998MHz | 380mVpp | 波形边缘略圆 |
高频段幅度衰减主要是因为AD9954内部DAC的sinc滚降特性——DDS输出本质上是采样重构，高频时采样点变少，经过重建滤波器的幅度响应自然下降。这不属于硬件故障，而是DDS原理决定的固有特性。如果需要在输出端获得平坦响应，可以加一级AD8367之类的AGC放大器，或者在软件里对高频段做幅度预补偿，但预补偿在时域上操作比较麻烦，我一般更推荐硬件自动增益控制方案。
正弦波输出时别忘了加一阶低通滤波器。AD9954的输出除了有用频率，还会在参考时钟的镜像频率处产生杂散，比如400MHz时钟下输出10MHz，那么在390MHz、410MHz等位置会有杂散分量。简单的做法是接一个截止频率为50MHz左右的7阶椭圆低通滤波器，但新手直接从LC滤波器开始搭会比较难调，更实用的方案是买一个成品低通滤波模块（比如Mini-Circuits的SLP系列），直接串在输出端，省时省力。
5.2 常见问题速查表
我整理了一下实际操作中最容易踩的坑，你对照排查基本能解决80%的问题：
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
| 输出始终为0 | RESET引脚未正确释放 | 检查RESET是否为低电平，拉低后延时再拉高并保持大于10个SYNC_CLK周期 |
| 频率值差固定倍数 | FTW字节序写反 | 确认大端发送顺序，先用1MHz校准看FTW是否为规定的0x0666_6666左右 |
| 偶发性写失败 | SPI速率过高/线太长 | 降SPI分频至5.25MHz以下，缩短杜邦线或改用排线 |
| 输出方波有毛刺 | OSK引脚悬空 | OSK必须接固定电平（VCC或GND），不能悬空 |
| 扫频模式不工作 | CFR2配置步进寄存器未写入 | 确认扫频步进寄存器和速率寄存器都写入，且使能位正确 |
| 信号频率上不去 | 参考时钟配置错误 | 检查PLL倍频寄存器，确认SYSCLK真为400MHz，用示波器测REFCLK引脚 |
| OLED显示乱码 | I2C地址错误 | SSD1306一般地址为0x78或0x7A（7位地址0x3C/0x3D） |
| 频率步进按键异常 | 没有加消抖 | 必须用定时器消抖，不能用阻塞延时 |
5.3 调试工具和流程建议
调试这类项目，工具优先级排序是：示波器 > 逻辑分析仪 > 串口助手 > 万用表。没有示波器，你想观察DDS输出波形是否正常，几乎无从下手。逻辑分析仪主要用于抓SPI时序，看CS、SCLK、SDIO三者之间的时序关系是否正确。我调试时截获过一段SPI数据，发现SCLK出现了毛刺，排查下来是供电电压不稳导致SPI引脚电平翻转异常，后来在STM32的VDD附近加了一颗100nF去耦电容和10μF钽电容解决。
调试顺序建议：
- 先用GPIO翻转法测试SPI底层是否通，写一个往某寄存器随便写值、再读回来校验的环节。
- 再初始化AD9954，读取寄存器里的出厂ID（虽然AD9954没有专门的ID寄存器，但可以读CFR寄存器看默认值是否与手册一致）。
- 设置一个固定频率（比如1MHz）输出，用示波器确认波形。
- 最后再加上按键和OLED，实现完整交互。
我见过太多人一上来就烧录整个工程，按键也好、OLED也好，屏幕亮了但波形是错的，结果不知道是驱动问题还是硬件问题。先打通最小系统、再逐步加外设，这是调嵌入式系统永远适用的原则。
根据个人的实操经验，我还总结出一条额外建议：AD9954的参考时钟源非常关键，如果只是用无源晶振直接做REFCLK，相位噪声会比较大，在频谱仪上看起来杂散底噪偏高。如果对信号纯净度有要求，有条件的话建议用TCXO或者恒温晶振模块给AD9954提供参考时钟，输出频谱质量会明显上一个台阶。当然，普通学习和基础测试场景下，板载有源晶振已经够用，不必过度追求。
这套工程源码拿回去后，你如果想扩展成真正好用的DIY信号发生器，下一步可以做三件事：一是加一个高速DA或模拟开关做输出幅度程控衰减，二是增加AD9954的外部锁相环倍频配置（把REFCLK倍频到400MHz），三是用编码器旋钮替代按键调节频率，手感会好很多。整个系统硬件通路我已经验证过，软件驱动层面也预留了接口，照着扩展应该不会踩什么大坑。
本文还有配套的精品资源，点击获取
