前阵子碰到一个挺典型的改板需求：一块小家电控制板，外壳和面板早就定了型，6 个按键必须原样保留，可 MCU 上能用的引脚已经被数码管驱动、传感器和通信口吃得干干净净，翻遍原理图只剩一个带 ADC 的引脚还空着。当时第一反应是加个 IO 扩展芯片，但板子面积和成本都不允许；第二反应是砍按键，可结构件开模费比板子还贵。最后的解决办法很朴素——把这 6 个按键全挂在那一个引脚上，靠一串电阻把"哪个键被按下"翻译成"引脚上是多少伏电压"，软件读一次 ADC 就知道按的是谁。这套东西在行业里叫法不少，有人叫 AD 键盘，有人叫电阻分压键盘，本质上就是题目里说的那种"一个 IO 口也能实现的矩阵键盘"。它既不是独立按键那种一个键吃一个引脚的路子，也不是矩阵扫描那种行线列线轮流拉低的玩法，而是走了第三条路：把数字量的通断，转换成模拟量的台阶。这篇就把独立按键、矩阵扫描、单 IO 模拟键盘这三条路的取舍逻辑、电路怎么搭、阻值怎么算、代码怎么写、以及我在实际项目里踩过的几个坑，完整摊开讲一遍。不管你是刚上手单片机的新手，还是画了多年板子的老手，看完应该都能判断自己手上这个项目到底该用哪一种。
1. 三条按键输入路线的真实成本账
按键输入这件事，教科书上通常只讲两种：独立按键和矩阵键盘。但真到了项目里，尤其是在引脚捉襟见肘、成本卡到分位的场合，你会发现还有第三种选择经常被忽略。这三种方案没有绝对优劣，只有适用边界的差别，而这个边界往往不是"引脚够不够"这么简单，还牵扯到引脚类型、扫描开销、可靠性要求和后期维护成本。先把这三条路的账算清楚，后面再看具体怎么落地。
1.1 独立按键省的是开发时间，不是引脚
独立按键的接法最直白：一个按键一端接地，另一端接 GPIO，GPIO 开内部上拉，平时读到高电平，按下读到低电平。n 个按键就占 n 个引脚，代码里一个循环读一遍端口就够了，连消抖都好写。
它的真正优势不在硬件，而在软件和调试。每个按键的状态完全独立，互不干扰，多键同时按下也能正确识别；出问题时用万用表一量就知道是按键坏了还是线断了；换按键、加按键、改功能都不用动扫描逻辑。对于按键数在 3 个以内、引脚又不紧张的项目，这是性价比最高的方案，没什么好犹豫的。
问题在于引脚消耗是线性的。到了 6 个、8 个按键，普通 GPIO 就开始吃紧了，尤其是那种引脚本来就不多的 8 位小封装 MCU，往往还要兼顾显示、采样、通信。这时候要么换更大的封装（成本上去了），要么就得考虑别的路子。我见过一些项目为了省引脚，把按键接到了复用功能引脚上，结果一不小心就和调试口或者晶振脚冲突，量产时才发现没法在线烧录，返工代价极大。
1.2 矩阵扫描用时间换引脚，代价藏在时序里
矩阵键盘的思路是把按键排成 m 行 n 列，行线做输出、列线做输入（或者反过来），总共 m+n 个引脚就能撑起 m×n 个按键。4×4 的矩阵用 8 个引脚搞定 16 个键，引脚利用率确实高。
但省下来的引脚是要用别的东西换的。第一是扫描时序：行线必须逐行拉低，每拉低一行读一次列线，一轮扫完才算完成一次采样。这个扫描要么放在定时器中断里跑，要么放在主循环里轮询，前者占用中断资源，后者要求主循环不能被长任务阻塞。第二是鬼键问题：不加二极管的矩阵，同时按下三个键时会出现"幽灵键"，本来没按的键被读成按下。要彻底解决就得每个按键串一个二极管，16 个键就是 16 个二极管，BOM 成本和贴片工时都上去了。第三是 EMI：扫描线在面板排线上跑来跑去，频率不高但沿很陡，遇到长排线或者没做好地平面，很容易耦合到旁边的模拟采样通道上。
所以矩阵键盘真正划算的场景是"按键多且必须支持组合键"，比如薄膜面板上的数字键盘、工业控制面板。如果只是 6 个功能键，用矩阵反而是杀鸡用牛刀，还平白引入一堆时序和鬼键的麻烦。
1.3 单 IO 方案的本质：把通断翻译成电压台阶
第三条路的核心思想很简单：既然引脚不够，那就别让每个按键都占用一个独立的检测通道，而是让所有按键共用同一个检测通道，靠"按下不同按键时该通道呈现不同的电气特性"来区分。最常见的实现就是电阻分压——每个按键串一个阻值不同的电阻到地，公共端接一个上拉电阻到电源，同时接 ADC 引脚。按下哪个键，分压比就变一次，ADC 读到的码值就跳一个台阶。
这个方案的引脚成本是 1 个（还得是带 ADC 的引脚），元件成本是 n+1 个电阻，加起来可能还不到一分钱。而且它有个隐藏优点：未按下时电路里几乎没有电流（上拉电阻下面悬空），静态功耗接近于零，天生适合电池供电的产品。
代价也很明确。第一，它需要 ADC，而 ADC 引脚在很多 MCU 上属于稀缺资源，往往和比较器、运放输入复用，你占了它就等于放弃了别的模拟功能。第二，它天然不支持任意多键同时按下——两个键一起按，等效电阻变成并联，电压落到一个谁都不对应的位置，读出来是"幽灵键"。第三，判定靠电压窗口，抗干扰能力比数字电平弱，长线、强干扰环境要格外小心。
把这三条路并排放在一起看，结论其实很清楚：按键少、引脚宽裕，选独立按键；按键多、必须支持组合，选矩阵扫描；按键中等数量、只需要单键触发、且能腾出一个 ADC 引脚，单 IO 电阻分压是最划算的。那个小家电项目正好落在第三种情况里。
顺便说一句，市面上确实存在"一个 IO 口驱动一大堆按键"的其他路径，比如挂一颗 I2C 或 SPI 的键盘扩展芯片，但那至少要占两个引脚；再比如用移位寄存器，也要两三个引脚做时钟和数据。真正意义上只吃一个引脚的，只有模拟量这条路。所以标题里那句"一个 IO 口也能实现矩阵键盘"，严格说不是矩阵，是分压，但它实现的功能效果和矩阵键盘是一样的。
2. 电阻分压键盘的电路骨架与阻值反推
确定走模拟路线之后，接下来最关键的一步就是电路怎么搭、阻值怎么定。这一步如果拍脑袋，后面软件怎么写都救不回来。我见过不少方案直接拿"1k、2k、3k、4k"这样等差排下去，结果低端的几个键电压挤在一起，ADC 稍微有点噪声就误判。正确的做法是从 ADC 的分辨率和噪声容限反推电压间隔，再反推阻值，而不是先定电阻再看效果。
2.1 两种拓扑：并联到地与串联抽头
电阻分压键盘有两种常见拓扑，选错了会在功耗上吃大亏。
第一种是"每键独立电阻到地 + 公共上拉"。电源经一个上拉电阻 Rp 到节点 N，N 接 ADC，同时 N 经每个按键各自串一个电阻 Rk 到地。没按键时 N 被拉到电源电压，没有电流通路；按下第 k 个键时，N 的电压是 VCC × Rk / (Rp + Rk)。这种拓扑静态零功耗，按下时的电流也只有几十微安，非常适合电池设备。
第二种是"电阻串分压抽头"。电源和地之间串一长串电阻，形成若干个分压点，每个按键把对应的分压点短接到 ADC 引脚。这种拓扑按键可以做得很多，但致命问题是：没按键的时候，这串电阻依然从电源直通到地，持续耗流。如果是 3.3V 下串 10 个 10k 电阻，静态电流就是 33µA，对一颗纽扣电池供电的产品来说是灾难。除非你能用另一个 GPIO 给这串电阻供电、平时关断，但那就变成两个引脚了。
所以除非有特殊需求，我一律推荐第一种。它唯一的不便是按键数增加时最大阻值会变得比较大，这一点后面会算。
2.2 从 ADC 量化误差倒推最小电压间隔
阻值不能随便定，得先确定"两个相邻按键之间至少要隔多少电压"。
假设用 12 位 ADC、参考电压 3.3V，一个 LSB 就是 3.3/4096 ≈ 0.806mV。理论上间隔几个 mV 就能区分，但实际工程里要考虑三样东西：ADC 自身的噪声（通常 ±2~3 LSB）、电阻精度带来的分压比偏差、以及电源纹波耦合进来的干扰。保守一点，我给每个按键留出至少 60~80 个码值的窗口，相邻中心点之间留 3 倍以上的窗口宽度，这样判定时才有余量。
换算成电压，80 个码值约 65mV，3 倍就是 200mV 左右。也就是说相邻按键的电压差至少要 0.2V。如果你的电源是 3.3V，那最多能塞进去的按键数大约是 3.3 / 0.2 ≈ 16 个，扣掉上下两端各留一点余量，实际 10 个左右比较稳妥。如果 ADC 只有 10 位，LSB 变成 3.2mV，同样的码值窗口对应电压翻四倍，能塞的按键数就要砍到 4~6 个。
我一般按这个经验值来定：12 位 ADC 配 3.3V 电源，按键数控制在 8 个以内很舒服；10 位 ADC 建议不超过 5 个；如果是 8 位 ADC，老老实实回去用独立按键吧。
2.3 等电压间隔的阻值递推公式
确定了按键数 n 和电压间隔之后，阻值就有了唯一解。我们希望第 k 个按键按下时的电压是 VCC × k / (n+1)，这样 n 个按键把 0 到 VCC 均匀切成 n+1 段，每段等宽。
由分压公式 VCC × Rk / (Rp + Rk) = VCC × k / (n+1)，两边约掉 VCC，解出：
Rk = Rp × k / (n + 1 − k)
这个式子很好记，也很好用。取 Rp = 10kΩ、n = 6，算出来是：
| 按键 | k | 计算式 | 阻值 | 按下时电压 | 12 位码值 |
|---|---|---|---|---|---|
| K1 | 1 | 10k×1/6 | 1.67kΩ | 0.471V | 585 |
| K2 | 2 | 10k×2/5 | 4.0kΩ | 0.943V | 1170 |
| K3 | 3 | 10k×3/4 | 7.5kΩ | 1.414V | 1755 |
| K4 | 4 | 10k×4/3 | 13.3kΩ | 1.886V | 2340 |
| K5 | 5 | 10k×5/2 | 25kΩ | 2.357V | 2925 |
| K6 | 6 | 10k×6/1 | 60kΩ | 2.829V | 3510 |
可以看到码值间隔稳定在 585 左右，非常均匀，每个键都有接近 300 个码值的容差余量，抗噪能力很强。实际选型时不用严格按算出来的值，用 E24 系列里最接近的就行，比如 1.6k、3.9k、7.5k、13k、24k、62k，误差在 3% 以内，完全够用。
这里有个细节值得强调：最大那个阻值（60kΩ）决定了整个电路的最坏源阻抗。按键按下时，从 ADC 引脚看进去的阻抗是 Rp 与 Rk 并联，最大也就是 Rp 本身（10kΩ）；没按键时就是 10kΩ。这个阻抗不算高，但已经足够让很多 MCU 的默认 ADC 采样时间不够用了，后面代码那节会细说。
如果按键数增加到 8 个，最大阻值变成 Rp×8/1 = 80kΩ，同时电压间隔压缩到 3.3/9 = 0.367V，码值间隔 455，依然宽裕。再往上到 10 个键，间隔 372 码值，最大阻值 100kΩ，这时候 ADC 采样时间就必须认真配置了。
2.4 没有 ADC 时的替代路径：测 RC 充电时间
有些场景下 ADC 引脚被别的模拟通道占了，或者手上这颗 MCU 干脆没有 ADC，那是不是就彻底没戏了？不是，还有一条路：测 RC 充电时间。
做法是把引脚先配成推挽输出、输出低电平，把节点上的电容放电到底；然后把引脚切成高阻输入（内部上拉关掉），此时电容通过一个固定的上拉电阻 Rp 朝 VCC 充电；程序同时启动定时器，用输入捕获或者轮询方式记录引脚电平从低翻到高所花的时间。这个时间 t 约等于 Rp × C × ln(VCC / (VCC − Vth))，其中 Vth 是 GPIO 输入的高电平阈值。按下不同按键时，并联进去的电阻不同，等效充电电阻就不同，测出来的时间自然不同。
这条路的优点是完全不需要 ADC 外设，纯数字引脚就能干。缺点也很明显：一是测量窗口长，如果 C 取 10nF、等效电阻几十 k，时间常数就是几百微秒，最坏情况要测到毫秒级，比 ADC 一次转换慢一个数量级；二是精度受电源电压、输入阈值温漂和定时器分辨率三重影响，能做到 8 个键区分就不错了；三是放电阶段要占用引脚输出低电平，这段时间内按键是"失明"的，没法做快速连按。
我的建议是：能上 ADC 就上 ADC，RC 法只作为没有别的选择时的兜底方案。真要用，电容取 10nF 比较合适，太小抗干扰差，太大测量时间拖沓，而且放电时间要留够 5 个时间常数以上，否则会有残余电荷导致读数漂移。
3. 代码落地：采样、判定、消抖的三层结构
硬件搭好之后，软件其实不复杂，但结构必须分层清楚，否则后期加个长按、加个组合键就会乱成一锅粥。我把这部分拆成三层：底层负责采样和平均，中间层负责把码值翻译成键值，上层负责消抖和按键事件。三层之间通过一个"原始键值"的数据结构衔接，任何一层改动都不影响另外两层。
3.1 ADC 采样的平均策略与采样时间配置
先说要命的采样时间。前面算过，最坏情况下 ADC 引脚看进去的源阻抗是 10kΩ 量级。多数 MCU 的 ADC 内部采样保持电容在 5~10pF，要充到 12 位精度需要大约 8.3 个时间常数，也就是 10kΩ × 8pF × 8.3 ≈ 660ns。很多外设库的默认采样时间只有 1.5 个 ADC 时钟周期，14MHz 下才 107ns，差了一个数量级，读数会系统性偏低几十个码值，而且不同按键偏低程度还不一样，标定出来的中心值换一块板子就失效。
解决办法有两条，任选其一或叠加使用：把 ADC 的采样时间配置到 8~15 个 ADC 时钟周期（具体看手册的选项），或者在 ADC 引脚对地并一颗 1~10nF 电容。并电容还有个额外好处，等于做了一个硬件低通，能把面板排线引入的高频干扰滤掉。但电容不能太大，10nF 配 10kΩ 的时间常数是 100µs，按键按下后要等 500µs 才稳定，连按速度快的场合会有延迟感。我用 4.7nF 比较多，兼顾滤波和响应。
采样平均方面，我一般一次连续读 8 次再右移 3 位。这里有个容易忽略的坑：如果按键正在切换的瞬间做平均，会得到一个介于两个台阶之间的值，落在容差带外面，被判成无效键。处理办法是在中间层把"无效键"当作一次异常，交给上层的状态机去计数，连续几次无效才认为是真的异常，偶尔一次直接忽略。这样既不影响响应速度，也不会误报。
#define KEY_ADC_CH 3 #define KEY_SAMPLE_TIMES 8U static uint16_t key_adc_filtered(void) { uint32_t sum = 0; for (uint8_t i = 0; i < KEY_SAMPLE_TIMES; i++) { sum += adc_read_once(KEY_ADC_CH); } return (uint16_t)(sum / KEY_SAMPLE_TIMES); }3.2 用容差带判定，而不是找最接近的中心值
把码值翻译成键值这一步，最常见的错误写法是"遍历所有中心值，找差值最小的那个"。这个写法在噪声小的时候没问题，一旦读数落在两个台阶中间（比如按键切换瞬间或者被干扰），它会硬生生地把一个无效值分配给最近的键，产生误触发。
正确做法是给每个键定义一个容差带，只有读数落在带内才算命中，落在带外一律判为无效。带宽度取相邻中心间隔的三分之一左右比较合适，既留足了噪声余量，又不会让相邻两个带重叠。
#define KEY_NUM 6U #define KEY_NONE 0xF0U #define KEY_INVALID 0xFFU #define KEY_TOL 200 /* 相邻间隔 585，取 1/3 左右 */ /* 中心值必须实测标定，不能直接用理论值 */ static const uint16_t key_center[KEY_NUM] = { 585, 1170, 1755, 2340, 2925, 3510 }; static uint8_t key_decode(uint16_t code) { /* 上限附近：没有任何按键按下 */ if (code > 3950U) { return KEY_NONE; } /* 下限附近：可能对地短路，判无效 */ if (code < 200U) { return KEY_INVALID; } for (uint8_t i = 0; i < KEY_NUM; i++) { int32_t diff = (int32_t)code - (int32_t)key_center[i]; if (diff > -(int32_t)KEY_TOL && diff < (int32_t)KEY_TOL) { return (uint8_t)(i + 1U); } } return KEY_INVALID; }这里的上下限判断很重要。上限那一刀是判断"空闲"，因为没按键时引脚被上拉到接近 VCC，码值接近 4095；如果这一刀切得太低，会跟 K6 的容差带冲突。下限那一刀是防御性的，万一按键线被压到地或者元件短路，读数贴近 0，这时候应该报异常而不是当成某个键，方便上层做故障提示。
中心值那一列，我在注释里特意写了"必须实测标定"。理论算出来的码值和实际读到的码值往往差 1%~3%，来源包括电阻精度、上拉电阻的实际值、ADC 的增益误差和偏移误差。批量生产时这个偏差还会在板子之间波动，所以容差带要按最坏情况留够，不能贴着理论值卡。
3.3 消抖状态机：把机械抖动和 ADC 噪声一起处理
按键的机械抖动通常在 5~20ms，ADC 读数本身也有几个码值的随机跳动。这两件事可以合并处理：用一个 10ms 周期的定时器去调用扫描函数，连续三次读到同一个键值才认为状态稳定。这样等效消抖时间是 20~30ms，手感上几乎察觉不到延迟。
状态机里我维护四个东西：当前稳定键值、候选键值、候选计数、按下持续计数。稳定键值只在候选连续命中时才更新；按下持续计数用来做长按判断，超过 800ms 触发长按事件，之后每 120ms 触发一次连发。
typedef struct { uint8_t stable; /* 稳定键值 */ uint8_t cand; /* 候选键值 */ uint8_t cnt; /* 候选连续计数 */ uint16_t hold_ms; /* 按下持续毫秒 */ uint16_t repeat_ms; /* 连发计时 */ uint8_t long_fired; /* 长按已触发标志 */ } key_fsm_t; static key_fsm_t g_key; void key_tick_10ms(void) /* 定时器里每 10ms 调一次 */ { uint8_t raw = key_decode(key_adc_filtered()); if (raw == KEY_INVALID) { return; /* 无效值不参与状态机，直接丢弃 */ } if (raw != g_key.cand) { g_key.cand = raw; g_key.cnt = 1; return; } if (g_key.cnt < 3U) { g_key.cnt++; return; } /* 候选已稳定，更新状态 */ if (raw != g_key.stable) { uint8_t old = g_key.stable; g_key.stable = raw; g_key.hold_ms = 0; g_key.repeat_ms = 0; g_key.long_fired = 0; if (old != KEY_NONE && raw == KEY_NONE) { key_event_release(old); } else if (raw != KEY_NONE) { key_event_press(raw); } return; } /* 稳定按住，处理长按与连发 */ if (g_key.stable != KEY_NONE) { g_key.hold_ms += 10; if (!g_key.long_fired && g_key.hold_ms >= 800U) { g_key.long_fired = 1; g_key.repeat_ms = 0; key_event_long(g_key.stable); } else if (g_key.long_fired) { g_key.repeat_ms += 10; if (g_key.repeat_ms >= 120U) { g_key.repeat_ms = 0; key_event_repeat(g_key.stable); } } } }这套结构的好处是：消抖、长按、连发都在同一个状态机里完成，不需要额外的定时器和标志位；key_decode返回的无效值被直接丢弃，不会污染状态；上层只关心key_event_press这类事件回调，换实现方式时上层代码不用改。
有个小细节：key_event_press只在稳定键值从"无键"变成"某键"时触发一次，不会重复触发。这个语义一定要定义清楚，否则上层做菜单切换时会一次按键跳好几级，排查起来非常费劲。
4. 多键同时按下绕不过去的三个现实问题
单 IO 电阻分压键盘最被人诟病的就是多键问题，这一点必须正面回答，含糊过去只会让用的人踩更大的坑。除了多键，还有两个容易被忽视的问题：电阻容差的累积效应，以及电源电压变化对判定的影响。这三件事如果不在设计阶段想清楚，量产时会非常被动。
4.1 幽灵键：两个键按下时电压落到哪里
前面说过，按下两个键时，两个电阻并联，等效阻值变小，电压会比单独按下任何一个键都低。举个具体例子：Rp = 10k，K2 是 4k，K5 是 25k。单独按下 K2 电压是 0.943V，单独按下 K5 是 2.357V。两个一起按下，并联阻值 4k×25k/(4k+25k) = 3.45k，电压变成 3.3 × 3.45/(10+3.45) = 0.846V，码值约 1050，落在 K2 的容差带（970~1370）里面。
也就是说，K2+K5 同时按下，会被识别成 K2。这不算误动作，只是识别不了组合键。但更麻烦的情况是落在两个键之间：比如 K1 和 K6 同时按下，等效阻值 1.67k×60k/(1.67k+60k) = 1.62k，电压 0.458V，码值 568，刚好还在 K1 的带内。而有些组合会落在带外，直接变成无效键，此时如果上层没有做"保持上一次状态"的处理，会出现按键卡住或者突然松开的诡异现象。
我的处理原则是：明确声明这个方案只支持单键输入，在key_decode里只要发现读数落在两个带之间就返回无效，上层把它当成"按键抖动"丢弃，维持上一次稳定状态。这样最坏情况是两个键一起按的时候，系统认为按的是先按下的那个键，松开后恢复正常，不会出现乱跳。
如果项目确实需要组合键（比如"上+下"进入工厂模式），那就在标定阶段把常用的两个键组合的码值也测出来，作为"组合键"条目单独加进查找表。6 个键两两组合有 15 种，加上 6 个单键一共 21 个条目，理论上有地方塞，但实际上码值会挤得很近，抗噪能力急剧下降。我的经验是最多加两三种固定组合，再多就不要勉强了。
4.2 电阻容差与上拉电阻的非理想性
第一版板子我图省事用了 5% 精度的电阻，结果 5 块样机里有 2 块在 K5、K6 附近出现偶发误判。用示波器量了分压点，发现理论 2.829V 的 K6 实际落在 2.76V~2.89V 之间波动，码值漂移超过 150。原因是 5% 电阻配 10% 精度的上拉（上拉当时用的是内部上拉，偏差更大），分压比误差被放大了。
改法很简单：所有分压电阻和上拉电阻统一换 1% 精度，上拉必须用外部电阻，绝不能依赖内部上拉。内部上拉的标称值在 20k~50k 之间飘，不同批次、不同温度都不一样，用它做分压基准等于给自己埋雷。
换 1% 之后，实测量到的最坏偏差是这样的：
| 按键 | 理论码值 | 实测最小值 | 实测最大值 | 偏差范围 |
|---|---|---|---|---|
| K1 | 585 | 571 | 599 | ±1.4% |
| K2 | 1170 | 1148 | 1192 | ±1.9% |
| K3 | 1755 | 1719 | 1790 | ±2.0% |
| K4 | 2340 | 2292 | 2387 | ±2.0% |
| K5 | 2925 | 2861 | 2988 | ±2.2% |
| K6 | 3510 | 3428 | 3592 | ±2.3% |
偏差随按键序号增大而增大，这符合预期：k 越大，分压比越接近 1，对上拉电阻误差的敏感度越高。所以容差带宽度应该按最大偏差来取，而不是统一取一个值。我后来改成按相邻间隔的 28% 动态计算容差，比固定值稳得多。
4.3 电源电压变化：比例式测量才是解药
第三个问题是电源。产品的供电可能是电池，从 4.2V 一路掉到 3.0V；也可能是适配器，标称 5V 实际在 4.7V~5.3V 之间晃。
这里有一个非常关键的判断依据：ADC 的参考电压和分压网络的供电是不是同一个源。如果是同一个源（比如都用 VDD 做参考），那么 VCC 变化时，分子分母同比例变化，读到的码值几乎不变，这叫比例式测量，是天然免疫电源波动的。如果 ADC 用的是内部基准（比如 1.2V 或 2.5V），而分压网络挂在 VDD 上，那 VDD 一变，码值就整体平移，原本的判定窗口全部错位。
这一点我在下一个章节会用一个真实的排查过程详细说。设计阶段的结论是：能选 VDD 做参考就一定选 VDD，它带来的稳定性远超那一点点绝对精度。如果 MCU 的 ADC 参考只能是内部基准，那就要么在软件里做归一化补偿（用一个已知分压点或者另一个 ADC 通道测 VDD，再算出实际比例），要么在外围加一颗低压差的基准源给分压网络供电，成本会上升。
5. 一次"电量低了按键就乱跳"的排查全过程
这个坑印象很深，因为它暴露的是设计阶段的思维盲区，而不是某个元件选错。把排查过程完整写出来，是因为我觉得这套"先分离硬件和软件、再看原始数据、最后定位根因"的流程，比结论本身更有价值。
5.1 症状描述与第一轮假设
产品是一块电池供电的小面板，4 节干电池，实测满电 6.2V，用到快没电时 4.4V。现象是：满电时 6 个按键全部正常，用到电池电压掉到 5V 以下之后，按 K3 有时候会识别成 K2，按 K5 有时候会识别成 K6 或者直接无响应。换了新电池立刻恢复正常。
第一轮我先列了几个假设：
- 电池内阻增大导致 ADC 采样瞬间电压跌落，读数偏低；
- 分压电阻的温漂；
- ADC 参考电压是内部基准，而分压网络挂 VDD，两者不同步；
- 按键触点氧化导致接触电阻变大。
假设 1 和 4 都跟硬件老化有关，在一台新样机上复现不出来，所以先用可调电源做实验：把供电从 6.5V 慢慢往下降，观察哪个电压点开始出问题。
5.2 把原始码值打到串口上看趋势
实验结果是：供电降到 5.2V 左右开始出现误判，降到 4.8V 时误判率明显上升。这已经排除了内阻和触点氧化，因为用的是稳压电源，内阻极小、按键也是新的。
接下来做的是最朴素也最有效的一件事：在key_decode之前把key_adc_filtered()的原始码值通过串口打出来，每个按键各按 10 次，记录码值。测量结果和理论值对比：
| 按键 | 6.2V 时码值 | 4.8V 时码值 | 理论码值 | 4.8V 时偏差 |
|---|---|---|---|---|
| K1 | 588 | 452 | 585 | −136 |
| K2 | 1172 | 901 | 1170 | −271 |
| K3 | 1758 | 1352 | 1755 | −406 |
| K4 | 2345 | 1803 | 2340 | −542 |
| K5 | 2930 | 2253 | 2925 | −677 |
| K6 | 3518 | 2705 | 3510 | −813 |
规律非常明显：所有按键的码值都按同一个比例缩小，比例大约是 4.8/6.2 = 0.774。136/588 = 0.231，正好是 1 − 0.774。也就是说，读数完全正比于电源电压。
5.3 根因定位：参考电压和分压电源不是同一个源
这个比例关系一出来，根因基本就锁定了：ADC 的参考用的是内部固定基准，而分压网络挂在 VDD 上。供电从 6.2V 掉到 4.8V，分压点的绝对电压按比例下降，但 ADC 的量化刻度没变，所以码值整体按比例缩小。
回头看设计文档，当初选内部基准的理由是"内部基准更准"。这个理由在测绝对电压时成立，在测比例时完全站不住脚——分压键盘测的从来不是绝对电压，而是"当前电压占电源电压的比例"，这个比例才是按键的身份标识。
顺带还发现第二个问题：key_decode里的容差带是固定 200。在 6.2V 时，相邻键的码值间隔是 585，200 的容差带很安全；但在 4.8V 时，相邻间隔被压缩到 585 × 0.774 = 453，200 的容差带已经占了间隔的 44%，再叠加噪声，误判就成了必然。
5.4 两种修复路径与回归验证
修复有两条路。彻底一点的是改硬件：把分压网络从 VDD 供电改成由基准源供电，或者把 ADC 参考切到 VDD。前者要加元件，后者要看 MCU 是否支持。查了手册，这颗 MCU 支持把 VDD 作为参考，改一行初始化配置就搞定，成本为零。
另一条是纯软件：在标定阶段记录一个"参考码值"（比如把某一个固定分压点或者内部参考通道读出来），运行时按实测值做归一化。这条路不用改硬件，但引入了额外的采样通道和计算量，而且归一化的精度受参考通道本身的误差限制。
我选了第一条，改动最小。同时把容差带改成动态计算：每次上电初始化时，先把所有按键的理论间隔算出来，容差带取相邻间隔的 28%，并且在运行时如果发现相邻两个键的码值间隔小于预期值的 80%，就置一个"标定异常"标志，方便产线检测。
改完之后做了回归：供电从 6.5V 扫到 4.0V，步进 0.1V，每个电压点每个按键按 30 次，统计误判率。修复前在 4.8V 以下误判率超过 5%，修复后全电压范围内误判率为 0。温度方面做了 0℃ 和 50℃ 两个点的抽测，码值漂移在 ±1.5% 以内，容差带覆盖得住。
这次排查给我的教训是：模拟量方案的设计文档里，必须明确写清楚"参考源是什么、被测量是什么、两者的关系是什么"，这三个问题任何一个含糊，量产时都会以最难受的方式暴露出来。
6. 选型决策：什么情况下别碰单 IO 键盘
讲完了原理和实现，最后回到最实际的问题：手上这个项目到底该用哪种方案。我整理了一张横向对比表，再加上几个明确的反例，希望能帮你在设计评审阶段就做对判断，而不是画完板子再返工。
6.1 三种方案的横向对比
| 维度 | 独立按键 | 矩阵扫描 | 单 IO 分压键盘 |
|---|---|---|---|
| 引脚占用 | n 个普通 GPIO | m+n 个普通 GPIO | 1 个 ADC 引脚 |
| 外围元件 | 无（可用内部上拉） | 可选 n×m 个二极管 | n+1 个 1% 电阻 |
| 多键同时按下 | 完全支持 | 支持，无二极管时有鬼键 | 不支持，仅单键 |
| 静态功耗 | 接近零 | 接近零 | 接近零（并联拓扑） |
| 软件复杂度 | 低 | 中（扫描时序） | 中（标定与判定） |
| 抗干扰能力 | 强 | 中（扫描线辐射） | 弱（模拟量易受扰） |
| 量产一致性 | 好 | 好 | 需要逐板标定或留足容差 |
| 按键数弹性 | 线性增加引脚 | 引脚按平方根增长 | 受 ADC 位数限制 |
从表里能看出，单 IO 分压键盘的优势集中在"引脚极省 + 成本极低"，劣势集中在"只能单键 + 抗扰弱 + 需要标定"。选型的核心就是判断这三条劣势你的项目能不能接受。
6.2 几个明确的反例
第一种不要用的场景是需要组合键的产品。游戏手柄、乐器控制器、需要"Ctrl+某键"的输入设备，这些场景对多键的要求是刚性的，硬用分压方案会得到一个极其难用的产品。这种场合矩阵扫描加二极管才是正解，或者直接上专用的键盘扫描芯片。
第二种是面板到主板走线很长、电磁环境恶劣的产品。分压键盘的检测节点是高阻抗的模拟节点，一条 30cm 的排线就足以把变频器、继电器、电机的干扰耦合进来，读数乱跳。如果结构上没法缩短走线，那就必须在检测节点加 RC 滤波和 TVS，而且软件上要把采样平均次数提高、把判定窗口放宽，这样一来响应速度和按键数都要打折，性价比就不如矩阵了。
第三种是按键数量超过 10 个的产品。虽然理论上 12 位 ADC 能区分更多，但阻值会拉得很大（100kΩ 以上），高阻抗节点对漏电、湿气、PCB 表面污染都极其敏感，南方梅雨季节或者面板进水之后误触发概率陡增。超过 10 个键，我宁可用矩阵或者加一颗扩展芯片。
反过来，单 IO 分压键盘最适合的场景画像是这样的：按键数 4~8 个，只需要单键触发，MCU 引脚紧张但有一个空闲 ADC 通道，产品是电池供电或者对静态功耗敏感，面板走线短，成本压力大。小家电、玩具、遥控器、简单的仪表面板，全都落在这个画像里，这也是为什么你在拆开各种小家电时，经常能在按键板背面看到一排阻值各异的贴片电阻——那大概率就是一套分压键盘。
最后补充一个实操建议：无论选哪种方案，都留一个可测点。分压键盘的检测节点一定要引出一个测试焊盘，产线标定和售后排查全靠它。我吃过一次亏，板子画得太密没留测试点，客户反馈按键不灵，只能把整机拆开飞到芯片引脚上量，那滋味不太好受。同样，固件里留一个"输出所有按键原始码值"的调试命令，成本几乎为零，关键时刻能救命。这个命令我现在的每个项目都会加，用串口发一个字符就能把当前 ADC 读数打出来，比示波器还方便。
