1. STM32F103 DAC 波形输出到底能做什么：从寄存器到耳机口的完整链路
STM32F103 的 DAC 外设经常被初学者忽略，大家更熟悉 ADC 采样，却很少主动去用它的数模转换能力。简单说，DAC 就是把程序里的数字量变成引脚上真实电压的模块。STM32F103 有 2 个独立 DAC 通道，分辨率可配 8 位或 12 位，支持外部触发、DMA 搬运、噪声波和三角波生成。你往 DHR 寄存器写一个数，PA4 或 PA5 上就会输出对应比例的模拟电压，参考电压来自 VREF+。
这件事的实际价值在于：你可以用一块十几块钱的蓝板子，输出正弦波、锯齿波、三角波，甚至把一段音频的采样数据直接推出来，接上耳机就能听到声音。对嵌入式初学者来说，这是理解「数字世界如何变成模拟世界」最直观的实验；对做音频调试的人来说，它又是一个低成本信号源，可以拿来验证功放、滤波器或者扬声器是否正常工作。
我试过用 STM32F103C8T6 最小系统板直接驱动耳机，音量偏小但能听清，加一级三极管或者运放缓冲后效果明显改善。整个实验涉及三块内容：DAC 初始化、波形数据表生成、定时器触发配合 DMA 输出。调试阶段如果遇到编译环境配置、依赖下载、模型辅助排查代码逻辑这类问题，可以用 TaoToken 统一 Key 通道来辅助，把精力集中在硬件和波形本身。
适合谁跟做：有 Keil 或 STM32CubeIDE 基础、会点 C 语言、手上有 F103 板子和示波器（没有示波器用耳机也能判断）的嵌入式初学者。下面从工程配置开始，一步步把波形推到引脚上。
2. TaoToken 前置准备：统一 Key 与 API 通道辅助调试配置
做这个实验时，真正卡人的往往不是 DAC 本身，而是外围琐事：Keil 的 pack 下载慢、CubeMX 生成代码后某个宏没开、DMA 中断优先级配错导致波形断续、编译报错看不懂。这些环节如果有一个统一的模型通道帮你解释报错、生成配置片段，效率会高很多。TaoToken 在这里扮演的就是这个角色——它提供统一的 API Key 和兼容主流协议的中转地址，让你在命令行工具、编辑器插件或者自建脚本里都能用同一套凭证调用模型。
先拿到凭证。打开官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，注册后在控制台创建 API Key。控制台地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，Key 只在创建时完整显示一次，复制后存到本地环境变量里，别直接写进代码提交到仓库。
API 的基础地址是 https://taotoken.net/api ，注意这个地址不带任何查询参数。如果你用的是 OpenAI 兼容的客户端，Base URL 填这个；如果是 Claude Code 这类走 Anthropic 协议的工具，接入点单独配置。模型对话入口在 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite ，可以在这里先测试 Key 是否可用，确认能正常返回再往下走。
对于长期做嵌入式开发、经常需要模型辅助读数据手册、改配置、排查编译错误的人，Coding Plan 更划算，入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。它适合高频调用场景，不用每次单独计费。
配置方式上，如果你用 Cline 或者类似的编辑器插件，需要在设置里填三样东西：Base URL 填 https://taotoken.net/api ，API Key 填你创建的那串，Model ID 填你计划使用的模型标识。这三件套缺一不可，很多人只填了 Key 忘了 Base URL，结果请求打到默认端点直接 401。如果你用 Claude Code，接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，里面有 Anthropic 协议的完整配置说明，ClaudeCodeAnthropic 专用入口是 https://taotoken.net/ClaudeCodeAnthropic?utm_source=taotoken_aicg_blog_end&utm_content=ClaudeCodeAnthropic&utm_campaign=rewrite 。
这一步的目标不是让你把模型接进 STM32 工程里跑，那不现实。目标是当你在配 DAC、调 DMA、看编译日志时，有一个稳定的通道帮你快速定位问题。凭证配好之后，回到硬件实验本身。
3. 可复制配置：DAC 初始化、波形表与定时器触发完整代码
这一节给出可以直接粘贴进工程的配置。以 STM32F103C8T6、标准外设库为例，假设你用 CubeMX 生成了基础工程，时钟 72MHz，PA4 作为 DAC 输出通道 1。
先看 CubeMX 里的关键配置。DAC 部分：Mode 选 DAC_OUT1，Output Buffer 使能，Trigger 选 TIM2 TRGO。DMA 部分：添加 DAC_CH1 的 DMA 请求，方向 Memory to Peripheral，模式 Circular，数据宽度 Half Word。TIM2 部分：Prescaler 设为 0，Counter Period 设为 89，这样触发频率是 72MHz/(89+1)=800kHz，配合 100 个采样点的正弦表，输出频率约 8kHz，人耳可闻。
生成的代码里，DAC 初始化大致如下：
static void MX_DAC_Init(void) { DAC_ChannelConfTypeDef sConfig = {0}; hdac.Instance = DAC; if (HAL_DAC_Init(&hdac) != HAL_OK) { Error_Handler(); } sConfig.DAC_Trigger = DAC_TRIGGER_T2_TRGO; sConfig.DAC_OutputBuffer = DAC_OUTPUTBUFFER_ENABLE; if (HAL_DAC_ConfigChannel(&hdac, &sConfig, DAC_CHANNEL_1) != HAL_OK) { Error_Handler(); } }正弦波数据表用 12 位右对齐，100 个点，幅值取 0 到 4095 的中段，避免削顶：
const uint16_t sine_table[100] = { 2048,2170,2291,2410,2526,2638,2745,2846,2940,3027, 3106,3177,3239,3292,3335,3369,3393,3407,3411,3405, 3389,3363,3328,3283,3229,3166,3095,3016,2929,2835, 2735,2629,2518,2403,2285,2164,2042,1919,1796,1674, 1554,1437,1324,1216,1114,1019,932,854,785,726, 678,641,616,603,601,611,632,664,707,760, 823,895,976,1065,1161,1263,1371,1483,1599,1717, 1837,1957,2076,2193,2307,2416,2519,2615,2703,2782, 2851,2910,2958,2995,3021,3036,3040,3033,3015,2987, 2949,2902,2846,2782,2711,2633,2549,2461,2369,2274 };启动 DAC 和 DMA 的代码：
HAL_DAC_Start(&hdac, DAC_CHANNEL_1); HAL_DAC_Start_DMA(&hdac, DAC_CHANNEL_1, (uint32_t *)sine_table, 100, DAC_ALIGN_12B_R); HAL_TIM_Base_Start(&htim2);如果你要输出音频，把 sine_table 换成从音频文件提取的 16 位采样数据，采样率控制在 8kHz 到 16kHz 之间，F103 的 DAC 和 DMA 带宽足够。注意音频数据要转成 12 位右对齐，否则会溢出或者声音失真。
配置片段用 JSON 形式记录一下关键参数，方便你对照检查：
{ "mcu": "STM32F103C8T6", "dac_channel": "DAC_CHANNEL_1", "dac_pin": "PA4", "resolution": "12bit_right", "trigger": "TIM2_TRGO", "tim_prescaler": 0, "tim_period": 89, "dma_mode": "circular", "dma_width": "halfword", "sample_count": 100 }这套配置实测下来，PA4 上能稳定输出约 8kHz 正弦波，接示波器可以看到干净的波形，接耳机能听到对应音调的声音。如果波形有台阶感，说明采样点太少，把表加到 200 或 360 个点会明显改善。
4. 验证请求与成功结果：示波器波形与耳机听感确认
代码烧录之后，先别急着接耳机，用示波器确认波形正确。探头接 PA4，地夹接板子 GND，时基调到 50us/div 左右，应该能看到一个周期约 125us 的正弦波。如果看到的是锯齿或者方波，检查 sine_table 是否被正确搬运，以及 DMA 是否真的在循环模式。
没有示波器的话，用万用表直流档测 PA4 对地电压，正常应该在 1.65V 附近波动，因为正弦波均值接近 VREF/2。如果电压固定在 0 或者 3.3V，说明 DAC 没启动或者 DMA 没触发。
确认波形后接耳机。PA4 直接驱动耳机声音很小，建议串一个 100 欧姆电阻再并一个 10uF 隔直电容，或者用 LM386 做一级放大。接法是从 PA4 引出信号，经过隔直电容到耳机一端，耳机另一端接地。注意不要直接把耳机接在 PA4 和 GND 之间长时间大音量输出，DAC 引脚驱动能力有限。
成功的结果是：示波器上看到稳定正弦波，耳机里听到对应频率的纯音。如果你烧的是音频数据，应该能听到一段旋律或者人声片段。这时候可以打开模型对话入口 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite ，把示波器截图或者波形异常的描述发给模型，让它帮你判断是采样率问题还是数据对齐问题。
验证阶段还有一个实用技巧：用定时器触发的好处是输出频率只取决于定时器周期和采样点数，公式是 f_out = f_tim / N。f_tim 是触发频率，N 是采样点数。你想改输出频率，只需要改定时器的 Period 或者换一张不同点数的表，不用动 DAC 配置。这个关系在调音频播放时特别有用，采样率必须和音频文件一致，否则声音会变调。
5. 本篇常见错误排查：401、local proxy failed、reading choices 与 OAuth 报错
调试过程中会遇到几类典型报错，这里逐一对照。
第一类是 401 Unauthorized。如果你在用模型辅助排查时遇到这个，说明 API Key 无效或者没带上。检查三件事：Key 是否复制完整、Base URL 是否填了 https://taotoken.net/api 、请求头里的 Authorization 格式是否为 Bearer 加空格加 Key。很多人把 Key 写进代码时多了换行或者空格，也会导致 401。
第二类是 local proxy failed。这个通常出现在本地客户端配置了代理但代理没启动，或者代理地址填错。如果你没有使用任何本地代理服务，就把客户端里的代理选项关掉，直连 https://taotoken.net/api 。注意这里说的是客户端自身的网络设置，不是让你去搞什么网络工具，只是把多余的代理配置清掉。
第三类是 reading choices 相关报错，一般出现在流式响应解析阶段。表现是请求发出去了，但客户端读不到 choices 字段。原因可能是模型 ID 填错，或者客户端版本太旧不兼容返回格式。解决办法是确认 Model ID 和文档一致，升级客户端到最新版。如果还不行，先用模型对话入口单独测试，确认 Key 和模型都正常，再回到编辑器插件里排查。
第四类是 OAuth 报错。Claude Code 这类工具走 Anthropic 协议时，如果 OAuth 流程没走通，会提示认证失败。这时候不要反复重试，直接改用 API Key 方式接入，参考 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 里的说明，把 Base URL 和 Key 配对填好。ClaudeCodeAnthropic 专用入口 https://taotoken.net/ClaudeCodeAnthropic?utm_source=taotoken_aicg_blog_end&utm_content=ClaudeCodeAnthropic&utm_campaign=rewrite 里有针对性的配置示例。
硬件侧的常见错误则是波形不动或者只有直流。先查 DMA 是否使能了 Circular 模式，再查 TIM2 是否真的在跑，最后查 DAC 的 Trigger 是否选对了。这三个环节任意一个没配好，PA4 都只会输出一个固定电压。用调试器看 DMA 的 CNDTR 寄存器，如果数值在递减，说明搬运正常；如果一直是初始值，说明触发没来。
6. 语义一致 CTA：把调试通道固定下来，专注波形本身
DAC 波形输出这个实验，硬件部分其实不复杂，复杂的是环境配置和报错排查。把 TaoToken 的 Key 和 API 通道配好之后，你遇到编译错误、配置疑问、数据手册看不懂的地方，都可以快速拿到解释，不用在搜索引擎里翻半天。
需要创建或管理 Key 的，去控制台 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite 。想先验证模型能不能正常返回的，用模型对话 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 。长期做嵌入式编码和 Agent 辅助的，看 Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。接入文档和 API Key 管理入口分别是 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 和 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。
回到实验本身，最后给你一个实用建议：把 sine_table 换成三角波或者锯齿波的表，只需要改数据，不用动任何配置，就能听到不同音色。这是 DAC 实验最有趣的地方——数字数组的形状，直接决定你耳朵听到的声音。示波器上看到的波形，和耳机里听到的音调，是同一件事的两种呈现。把这两者对应起来，你对数模转换的理解就落地了。
