🧲
霍尔测速
贴一块磁铁，转起来就有数
外接开关型霍尔传感器（线性霍尔不适用），信号线接 GPIO41。每来一个边沿记一次时间戳，缓存最近 48 个边沿；转速取最近 6 个周期的中位数，单个抖动不会把读数带飞。
角度按累计脉冲换算：脉冲数 ÷ PPR × 360°。连续 2 秒没有新边沿即判停、读数归零，而不是停在最后一个值上误导人。PPR（每圈脉冲数）= 磁铁数 × 2——一块磁铁一升一降算两个脉冲，这一项设错，转速会整体差一倍。
Screen
屏幕界面效果
以下是该功能页在 2.41 英寸 AMOLED 屏幕（600 × 450）上的界面还原，实际交互与布局以最新固件为准。
转速1280转/分
角度214度 · 脉冲 1024
周期23.4 毫秒（6 周期中位数）
每圈脉冲2 · 一圈 1 块磁铁
状态转动中 · 刚收到脉冲
边沿缓存 48 条 · 2 秒无脉冲判停
屏幕界面效果 · 第 33 页
与实际界面会有差异，最终以实际设备界面为准。
Highlights
核心能力
🧲
开关霍尔输入
数字量边沿触发，接线一根信号线就够。
⏱
中位数抗抖
最近 6 个周期取中位数，抖动尖峰直接被忽略。
🔢
PPR 可设
磁铁数 × 2，换结构不用改代码。
🛑
自动判停
2 秒没有边沿则归零，不显示过期读数。
Specifications
技术规格
信号脚GPIO41（GPIO40 是屏幕复位，不可占用）
PPR每圈脉冲数 = 磁铁数 × 2
转速算法60,000,000 ÷（周期 µs × PPR）
采样边沿时间环 48 条，取最近 6 周期中位数
Use Cases
典型场景
电机转速
风机、马达贴一块磁铁，屏幕上直接看转速。
线速度换算
知道轮径就能把转速换成传送带/车轮的线速度。
Commands
相关指令
page 33 跳转到霍尔测速 hall 看当前转速、角度与脉冲数 hall ppr 4 设置每圈脉冲数（2 块磁铁） hall deb 2 设置去抖阈值 hall sim 1200 按 1200 转/分注入脉冲（无硬件验收） hall reset 清零脉冲与角度
⚠ 边界与说明
- 只支持开关型（数字输出）霍尔，线性霍尔的模拟量读不出来。
- GPIO40 是 OLED 复位脚，接线时别占用（命令行已硬性拒绝）。
- 仿真按帧补脉冲，主循环 30~80Hz 下高转速读数偏低属正常，实测请接真传感器。