这篇东西的起因很简单我手里攒了两对Switch Joycon的摇杆模块一直躺在零件盒里吃灰。正好那阵子想做一个带摇杆的小工具就顺手把这套供电、识别、采样、校准的流程完整跑了一遍。做完之后回头理了理发现里面可说的东西真不少尤其是引脚识别和ADC采样这两个环节网上资料要么太零散要么直接无视了硬件特性照着做很容易翻车。我不打算把它当成“游戏机配件”来讲更不会教你拆整机。这篇文章只把摇杆模块当作一个标准的双轴模拟量传感器来对待先摸清引脚再接进单片机用ADC把X轴、Y轴的电压变化变成数字量最后滤波、校准让它输出稳定可用的数据。全程不需要游戏机只需要一块常见的MCU开发板、一个万用表和一根电烙铁。适合想认真入门ADC采集的嵌入式新手也适合手里正好有闲置摇杆模块想废物利用的玩家。1. ADC采集链路设计先想清楚信号从哪来、到哪去1.1 一个摇杆模块里到底藏了什么传感器Switch Joycon的摇杆模块市面上一共能见到两种主流类型。一种是早期和大量第三方手柄使用的碳膜电位器摇杆本质就是两个互相垂直的单联电位器加一个按压开关另一种是近年新批次Joycon使用的霍尔摇杆外观上多了一颗霍尔芯片靠磁铁位置变化输出模拟电压。两种模块对MCU来说差别不大都是输出X轴、Y轴两路模拟电压外加一路数字按键信号。但有一个关键差异必须先说清楚碳膜电位器的X/Y输出引脚是从滑动触点上引出来的内阻会随着位置变化一般在几kΩ到几十kΩ之间。霍尔摇杆的输出是芯片内部的放大电路推出来的驱动能力要强不少内阻表现更好。这也是为什么很多人在老式碳膜摇杆上直接接单片机ADC会发现数值明显偏、回中不在中间值上面——信号源阻抗太高把ADC采集端一接上去分压关系就变了。所以在设计整个采集链路之前你要先明确自己手里是哪一种模块。碳膜版本对ADC采样时间更敏感霍尔版本则更省心。这个判断直接影响后面的硬件电路和采样参数配置。1.2 主控选型为什么用STM32F103这类入门MCU整个项目最核心的部分是ADC采样所以主控不需要多复杂的功能。我这次用的是STM32F103C8T6理由很直白12位ADC、内置DMA、便宜、资料多。ADC是12位的摇杆输出0到3.3V映射出来就是0到4095做方向控制精度已经足够。如果用8位单片机比如STC或者老AVR也能做但动态范围会小一截校准时的余量也少。另外一个优势是STM32的ADC支持多通道扫描加DMA循环搬运。摇杆的X轴、Y轴两路信号可以一次性连续采样不需要CPU反复去读状态寄存器主循环可以腾出来处理按键、做滤波、做通讯。这个特性在做高刷新率输出时特别重要比如你要把摇杆数据转成USB鼠标信号每毫秒都得更新数据如果用轮询方式会非常被动。当然如果手头只有Arduino UNO或者树莓派Pico也完全可以做本文后半部分的原理和校准思路都是通用的。差别只在于代码写法不同不影响你对整个流程的理解。1.3 完整信号链路应该怎么规划整个项目的信号链路我习惯画成五段摇杆传感器输出模拟电压这一段可能有高频噪声需要在靠近MCU的地方加一阶RC低通滤波之后电压进入MCU的ADC引脚经过采样、量化变成原始数字量再由DMA把两通道数据自动搬到内存主程序拿到原始数据后做滤波和校准去掉抖动和个体差异最后输出给显示、串口或者USB设备使用。看起来简单但很多人一开始会忽略第一段和第四段。不处理第一段你采到的数据就是带着毛刺的原始值不处理第四段每只摇杆的中值、行程范围都不一样同一份代码换一只摇杆就漂得没法用。这两步恰恰是我自己踩坑最深的地方后面会专门展开讲。2. 引脚定义识别宁可先量20分钟也不要盲焊2.1 常见引脚功能与典型排列摇杆模块的引脚排布不同批次、不同厂商之间确实有差异。我手里这块霍尔摇杆是6脚排线焊盘在模块背面一字排开其中真正用的只有5个功能脚。功能对应关系如下引脚功能方向说明VCC电源正极输入接3.3V不要接5VGND电源地输入接系统地X_OUTX轴模拟输出输出摇杆左右拨动时电压变化Y_OUTY轴模拟输出输出摇杆上下拨动时电压变化KEY按键输出输出按下摇杆时跳到低电平NC未连接-留空不接需要特别说明的是这个排列只是我手头模块的实测结果不代表所有模块都完全一致。我看到过一些第三方摇杆模块把GND和VCC的位置对调了甚至有的把KEY引脚做成了内部上拉、按下接地的低有效形式。所以拿到一个陌生模块第一件事不是找原理图而是用万用表把每个引脚的性质确认一遍。2.2 用万用表三步识别法确认每根线这个方法我总结过很多次不管什么摇杆模块都适用总共三步大概花20分钟。第一步找VCC和GND。把万用表打到电阻档黑表笔固定夹住某个引脚红表笔依次扫其余引脚寻找哪两个引脚之间有一个相对稳定、且不受摇杆方向影响的阻值。这个阻值通常是电位器两端的总阻值一般在几kΩ到几十kΩ之间。找到之后这两个脚就是VCC和GND。如果测得的是二极管压降或者开路就换一个固定引脚继续扫。第二步找X和Y。在已经确认VCC和GND的基础上用电阻档测剩下引脚对GND的电阻。慢慢拨动摇杆左右拨动时电阻值有明显线性变化的那个脚就是X_OUT上下拨动时变化的那个就是Y_OUT。碳膜电位器这样测最直观霍尔摇杆因为芯片隔离X/Y引脚对GND的电阻可能不随拨动变化这时候就直接上电用万用表电压档量各引脚电压拨动时电压变化的就是X/Y输出。第三步确认KEY。给模块接上3.3V和GND万用表打到电压档把剩下的疑似按键脚对GND量电压。如果这个脚在未按下时是3.3V左右按下瞬间变成接近0V那它就不是数字输出脚。有些模块的KEY是高有效未按下是0V按下变3.3V两种都正常在代码里根据自己的接法处理即可。这一步花的时间很值。我见过有人不看引脚直接把模块接到开发板上结果GND和信号接反白烧了一个霍尔片子教训相当惨痛。2.3 硬件接线与一阶RC滤波确认完引脚之后接线就简单了。VCC接开发板的3.3VGND接GNDX_OUT和Y_OUT分别接两个支持ADC的引脚KEY接一个普通输入引脚并开启内部上拉。如果你用的是一个未引出排线的裸模块焊线时注意温度别太高霍尔摇杆的焊盘背面有芯片长时间加热容易把芯片烫坏。在X_OUT、Y_OUT到ADC引脚之间我习惯各串一个100Ω电阻然后在靠近ADC引脚的位置对地接一个0.1μF陶瓷电容构成一个截止频率大约16kHz的低通滤波。这个电路的作用是滤掉摇杆滑动接触产生的高频毛刺和周围环境耦合进来的干扰。实测下来加了这个小电路之后ADC原始数据的跳动幅度能下降一个量级后续软件滤波的压力小很多。这里有个容易忽略的细节采样电容充电时间受信号源内阻影响。如果你用的是碳膜摇杆输出阻抗偏高硬件滤波电阻又不该选太大选1kΩ以上就会明显拖慢电压建立速度。我自己常用的组合是100Ω电阻加0.1μF电容兼顾滤波效果和响应速度。3. ADC采集全流程CubeMX配置、DMA多通道与HAL库代码3.1 引脚分配与CubeMX关键参数硬件连接定了之后代码层面的第一步就是把ADC通道配置好。我这里用PA0接X_OUTPA1接Y_OUTPA2接KEY。PA0和PA1分别对应ADC1的通道0和通道1。如果你用的板子引脚不同只要在CubeMX里重新映射就行。CubeMX里的配置要点如下ADC1开启通道0和通道1两个通道都设为Single-ended输入。勾选“Scan Conversion Mode”让两个通道自动顺序扫描。勾选“Continuous Conversion Mode”让ADC始终不停转换。把“Number Of Conversion”设为2对应通道0和通道1。在DMA Settings里添加ADC1方向设为Peripheral To Memory模式设为Circular数据宽度按需选择。ADC采样时间直接拉到最长的239.5 Cycles。最后这点很多人不理解为什么采样时间是重要参数。原因是单片机的ADC内部有一个采样保持电容外部信号源必须先把这个电容充到和目标电压一致转换结果才准确。摇杆模块的输出阻抗相对较高如果采样时间太短电容来不及充满就开始转换采到的值就会比实际电压低而且随着摇杆位置不同误差还会变化。把采样时间拉到最长的239.5周期可以最大限度减少这个问题。如果条件允许建议在ADC配置里开启“ADC Calibration”。STM32F103带自校准功能启动前跑一次校准能修正芯片内部的偏移误差。3.2 多通道DMA采集代码框架CubeMX生成代码之后核心只需要几段代码。先定义一个存放两通道数据的数组#define ADC_CHANNEL_NUM 2 uint16_t adc_raw[ADC_CHANNEL_NUM] {0};启动ADC和DMAHAL_ADC_Start_DMA(hadc1, (uint32_t *)adc_raw, ADC_CHANNEL_NUM);这行代码执行之后ADC1会按照配置不断扫描通道0和通道1DMA自动把转换结果按顺序写入adc_raw数组。下标0对应X轴下标1对应Y轴无需CPU干预。如果你需要在数据更新时做处理可以重写DMA传输完成回调void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef *hadc) { if (hadc-Instance ADC1) { // 每次两个通道转换完毕在这里读取adc_raw[0]和adc_raw[1] // 注意回调里不要做耗时操作最好只赋值标志位 adc_data_ready 1; } }我在实际项目里是让DMA工作在循环模式然后用定时器每1ms查询数据是否更新再去做滤波和校准。这样既保证了采样不中断又不会让ADC回调占用大量CPU时间。这里提醒一个常见问题DMA的数据宽度。如果ADC分辨率是12位转换结果是用16位长度存储的DMA数据宽度要设置成Half Word。有些初学者把宽度设成Byte结果高低字节错乱数值忽大忽小排查起来非常费劲。3.3 软件滤波和归零校准代码拿到原始ADC数据以后第一件事不是直接用而是做滤波。摇杆输出最常见的噪声是脉冲型毛刺滑动平均滤波对这类噪声抑制效果一般我推荐用“去极值平均”#define FILTER_N 5 uint16_t get_adc_value_filtered(uint8_t channel) { uint16_t samples[FILTER_N]; uint16_t temp; uint8_t i, j; for (i 0; i FILTER_N; i) { samples[i] adc_raw[channel]; HAL_Delay(1); } for (i 0; i FILTER_N - 1; i) { for (j i 1; j FILTER_N; j) { if (samples[j] samples[i]) { temp samples[i]; samples[i] samples[j]; samples[j] temp; } } } return (samples[1] samples[2] samples[3]) / 3; }这个函数每次取5个原始数据排序后去掉最大和最小再把中间3个求平均。对付尖峰毛刺效果很明显。代价是每秒钟能输出的有效数据会少一些但摇杆这种慢变信号完全够用。归零校准是另一个必须做的步骤。因为每只摇杆在机械中位时输出电压都不完全一样代码里要先采集一段静止时间的平均值作为中点int16_t x_center, y_center; void joystick_calibrate_center(void) { uint32_t sum_x 0, sum_y 0; uint8_t i; for (i 0; i 200; i) { sum_x get_adc_value_filtered(0); sum_y get_adc_value_filtered(1); HAL_Delay(2); } x_center sum_x / 200; y_center sum_y / 200; }开机时让用户不要碰摇杆程序跑一下这个函数X轴和Y轴的中心基准点就记录下来了。后面所有方向判断都围绕这个基准点展开。4. 从ADC原始值到可用输出方向映射、死区与按键处理4.1 把原始数值映射成带符号的百分比校准得到中值之后还需要知道摇杆的行程范围。碳膜摇杆因为机械限位的原因不会输出完全的0到4095通常左右行程各只占2000左右而且左右还不一定对称。所以不能简单地把ADC值减去中心值就直接用否则你会看到手感和灵敏度都不对。我的做法是做一个行程动态校准摇动摇杆到四个方向的极限记录下各自的最大值然后分别计算左右行程的范围用较大的一侧作为归一化基准int16_t x_left_max, x_right_max; int16_t y_up_max, y_down_max; int8_t joystick_map_to_int8(int16_t raw, int16_t center, int16_t range_left, int16_t range_right, uint8_t deadzone) { int32_t diff (int32_t)raw - center; int32_t range (diff 0) ? range_right : range_left; int32_t value (diff * 127) / range; if (value 127) value 127; if (value -127) value -127; if (value -deadzone value deadzone) value 0; return (int8_t)value; }调用时传入采样值、中心值、左右行程范围以及一个死区阈值。死区的作用是避免摇杆在中心附近轻微抖动时输出微小非零值导致方向控制不受控。对于12位ADC来说死区设在8到15比较合适对应输出值的5%到10%左右。4.2 按键消抖处理摇杆按键本质上是一个机械开关按下和松开的瞬间会产生数十毫秒的抖动脉冲。如果不做消抖你会看到按键状态在短时间内连续跳变好几次。我常用的消抖方法是状态加确认如果一个电平状态持续超过30ms才认为有效#define KEY_DEBOUNCE_MS 30 uint8_t key_read_debounced(GPIO_TypeDef *port, uint16_t pin) { static uint8_t stable_state 1; static uint8_t last_raw 1; static uint32_t last_change_tick 0; uint8_t current_raw; current_raw HAL_GPIO_ReadPin(port, pin); if (current_raw ! last_raw) { last_raw current_raw; last_change_tick HAL_GetTick(); } else if ((HAL_GetTick() - last_change_tick) KEY_DEBOUNCE_MS) { stable_state current_raw; } return stable_state; }如果你的KEY引脚是低有效返回值0表示按下如果是高有效代码里把逻辑反过来就行。建议把判断逻辑封装成统一的“is_key_pressed()”函数后面改起来方便。4.3 在PC上校准和验证的实用手段模块接好、代码跑通之后怎么确认数据是正常的一个最简单的办法是用串口直接输出滤波后的X轴、Y轴数值。在PC端打开串口助手把波特率设为115200就能看到摇杆在不同位置时的输出。拨到四个极限记录最大最小值正好可以拿前面4.1节算行程范围。如果你做的是USB HID设备比如把STM32模拟成鼠标或手柄Windows自带的“设置 USB 游戏控制器”里也能校准。不过要注意Windows的校准会修改系统层面的偏移如果你的固件端已经做了归零和死区系统端尽量别再重复校准否则反而会出现两个中心。我自己是先在固件里把数据调理干净USB HID层只做数值搬运这样插到任何一台电脑上表现都一致。把摇杆数据映射成鼠标移动时还有一个方向的问题。不同型号的摇杆Y轴电压和拨动方向的关系可能是反的。你在串口助手里往上推一下观察数值是变大还是变小然后在代码里加一个Y轴反转开关实测效果最直观不要根据经验臆断。5. 常见问题排查实录5.1 摇杆松开后回不到中心值这个现象几乎每个玩摇杆模块的人都会遇到。首先确认归零校准是否在电源稳定后执行模块上电瞬间电压还没建立好立刻校准会把一个错误的中点记录下来。我一般在上电后延时500ms再跑校准函数。如果校准之后中心值仍然偏移轻轻敲一下电路板看看数值有没有跟着抖。如果抖说明摇杆内部弹簧归位有机械间隙这是碳膜摇杆的常见问题霍尔摇杆会好很多。这类机械问题软件只能补救一小部分就是把死区设大一点但代价是中心附近的手感变钝。若要求高建议直接换霍尔版。5.2 ADC数值乱跳像得了帕金森这个问题的根源大概率在电源和采样配置上。STM32的ADC参考电压直接来自VDDA如果VDDA纹波大采样值一定会跟着抖。检查一下3.3V电源的退耦电容是不是装反或漏装摇杆供电最好从同一个LDO出来不要和电机、继电器这类大电流设备共用电源。另一个高频原因是采样时间太短这个问题前面已经说过。把采样时间从默认的12周期改成239.5周期大部分跳动能直接消除。最后检查一下有没有把悬浮的ADC通道也开了。CubeMX里如果某个通道没接信号却开着扫描它会采集到随机电压干扰你读到的有效数据。5.3 引脚怎么确认没接错如果你按本文2.2的三步法测量过基本不会接错。但有一个场景很容易翻车有些第三方模块的排线本身就不是VCC在边上而是排线中间某根是电源。如果你参照网上某个图直接焊很容易把VCC接到X_OUT上。最稳的确认手段是上电后量X_OUT对GND电压正常应该在0V到3.3V之间并且随摇杆拨动连续变化。如果量出来始终是3.3V或者0V不变化基本就是引脚接错了赶紧断电检查。另外给模块上电前一定要确认VCC接的是3.3V而不是5V霍尔版本耐压稍好碳膜版本接5V很容易把滑动触点附近电路烧掉。5.4 为什么换上国产摇杆之后手感全变了不同品牌摇杆的行程范围、电阻特性、弹簧力度都有差异。原装霍尔摇杆的线性度高回中精准而国产碳膜摇杆居中区域偶尔会有台阶感行程末端也不完全是线性。代码层面的解决方法是重新跑一次完整的行程校准特别是“最大行程”不能沿用上一只摇杆的数据否则输出很快就会被截到满量程手感变得非常“愣”。如果你打算长期用某一种第三方便宜摇杆建议把校准参数保存到Flash里不用每次开机都重新校准。保存时顺便把Y轴方向反转状态也存进去这能省下不少后来调参的时间。5.5 快速排查速查表现象优先排查项解决办法数值乱跳采样时间、电源纹波采样时间调长VDDA加退耦电容中心漂移机械回中、校准时机上电延时后校准换霍尔模块左右行程不对称行程校准未做记录四个极限按大侧归一化按键误触未消抖加30ms状态确认引脚发热/冒味供电接反立即断电用万用表复查VCC/GND我做这个项目最大的体会是摇杆模块本身并不是难点真正的坑全在接口层面的“阻抗匹配”和“校准思路”上。硬件上多花200元买好一点的霍尔摇杆能帮你省下两个晚上的调软件时间。如果你手里只有碳膜摇杆也完全能玩但采样时间务必拉满校准务必做完整这两个步骤直接决定了手感上限。最后再分享一个小技巧调试时别急着把摇杆数据映射成最终输出。先用串口把X轴、Y轴、按键三个数据显示200组到电脑上观察10秒钟确认每一段变化都符合预期再去做进一步的开发。数据源不干净后面所有逻辑都是空中楼阁。这一套流程跑通之后你会发现ADC采集、滤波、校准这些基本功远比一个具体型号的传感器本身更重要。