ATI Wonder II 无线遥控器 Sub-GHz 信号捕获实战:Flipper Zero RAW 信号库与 SubRem 按键映射全解析
【免费下载链接】FlipperPlayground (and dump) of stuff I make or modify for the Flipper Zero项目地址: https://gitcode.com/GitHub_Trending/fl/Flipper
本文基于 Sub-GHz/Multimedia/ATI_Wonder_II/README.md 及同目录下 55 份
.sub原始捕获文件和 4 份 SubRem 映射文件,系统讲解如何将 ATI Wonder II(ATI Remote Wonder 系列)RF 无线遥控器复刻到 Flipper Zero:从 RAW 捕获文件的字段含义、频率校准,到 Sub-GHz Remote 应用的按键映射与 SD 卡部署,再到桌面端 Linux 内核驱动联调验证的完整流程。读完本文,你将掌握"读懂 Flipper 原生 RAW 信号文件 + 编写 SubRem 遥控映射 + 正确部署与实测"这一套可复用的 Sub-GHz 遥控复刻方法论。
一、背景:这是一台什么样的设备
ATI Wonder II 是一套通过Sub-GHz 射频与接收站(receiver station)通信的无线遥控方案,典型形态是"RF 遥控器 + USB 接收器":遥控器按键以射频方式发送指令,接收器把射频信号翻译成桌面系统可识别的 HID 键鼠/媒体事件。正因遥控器与接收器之间跑的是射频链路而非红外,使用 Flipper Zero 的 Sub-GHz 模块即可在 433 MHz 附近直接捕获、保存并回放这些按键信号。
该目录的作者明确说明(见 README.md):
- 这是一份自认为接近完整("complete (I think)")的原始(RAW)信号捕获,收录了遥控器上绝大多数按键;
- 作者在普通桌面机上用 Linux 内核驱动做了力所能及的实测(具体能测到什么程度取决于环境与按键分配),未在 Windows 上测试,且并非所有按键都能测到;
- 由于难以锁定精确载频,作者承认频率可能不准确,信号可能需要重新校准。
这些诚实标注的局限,恰恰是使用本信号库时最需要留意的地方,后文会逐一给出应对方法。
二、信号库全景:目录结构与文件清单
完整目录位于 Sub-GHz/Multimedia/ATI_Wonder_II/,结构如下:
Sub-GHz/Multimedia/ATI_Wonder_II/ ├── README.md # 使用说明 ├── remotes/ # Sub-GHz Remote 应用的按键映射(4 份) │ ├── Ati_arrows.txt │ ├── Ati_media.txt │ ├── Ati_media_alt.txt │ └── Ati_mouse.txt └── *.sub # 55 份 RAW 原始信号捕获*.sub覆盖的按键包括:数字键0–9、字母键A–F、方向键Up/Down/Left/Right/Ok、媒体键Vol+/Vol-/Mute/Play/Pause/Rew/Ff/Stop/Rec、功能键Power/Menu/Enter/Fullscreen/Lock_screen、设备切换键Pc/Tv/Dvd/Ati/Aux1–Aux4/Hand、鼠标相关Mouse_up/Mouse_down/Mouse_left/Mouse_right/Click/Doubleclick/Rclick,以及Ch+/Ch-、Help、Hookthing等杂项按键,例如 0.sub、Vol+.sub、Click.sub。其中Doubleclick(双击)、Rclick(右键)等信号也已被捕获,供后续自定义映射使用。
三、RAW 捕获文件格式深度解析
所有.sub文件都是 Flipper 固件的原生 RAW 格式,以 0.sub 为例:
Filetype: Flipper SubGhz RAW File Version: 1 Frequency: 433920000 Preset: FuriHalSubGhzPresetOok650Async Protocol: RAW RAW_Data: 199 -696 65 -594 65 -132 ...各字段含义如下:
| 字段 | 值 | 说明 |
|---|---|---|
Filetype | Flipper SubGhz RAW File | Flipper 固件 Sub-GHz 模块的标准 RAW 文件头,标识文件类型 |
Version | 1 | 文件格式版本 |
Frequency | 433920000 | 载波频率,单位 Hz,即 433.92 MHz(ISM 免执照频段) |
Preset | FuriHalSubGhzPresetOok650Async | 调制方式预设:OOK(On-Off Keying,开关键控)调制、650 kHz 带宽、异步收发;与 AM650 是同一物理链路的不同命名 |
Protocol | RAW | 未使用内置协议解码器,直接以"原始脉冲时序"保存信号 |
RAW_Data | 成对的整数序列 | 交替记录"载波开/关"时长,正值 = 脉冲(载波开启),负值 = 静默(载波关闭),单位微秒(µs) |
RAW 数据的解读方式是"每个数代表一段时长":例如199 -696 65 -594表示先发射 199 µs、静默 696 µs、再发射 65 µs、再静默 594 µs……信号按此节奏串行展开,Flipper 回放时严格按该时序打开发射器。这也解释了为什么这份信号库不依赖任何协议破解——它直接以时间域波形"照抄"遥控器,属于最通用、兼容性最好的捕获方式。
一个值得注意的细节:目录内绝大多数文件(如 Pause.sub、Mute.sub、Power.sub)频率均为433920000,但个别文件(如 Play.sub、Click.sub)被保存为434075000。这正是 README 中所说"频率难以锁定"的直接证据——捕获过程发生在不同时间/环境下,载频出现约 155 kHz 的漂移。
四、频率校准:让信号真正"发得出去"
由于上述频率不一致,部署前建议先校准。做法如下:
- 在 Flipper Zero 上使用Sub-GHz → Frequency Analyzer(频率分析仪),对着 ATI Wonder II 遥控器按下目标按键,观察实际载频峰值;
- 将测得频率写入
.sub文件的Frequency:行(如把434075000改为433920000),保持其余字段不动; - 若接收端无响应,可尝试在
Frequency:附近微调(如 ±100 kHz),并配合 Flipper 的频率微调(Hopper/手动微调)功能逐档测试。
五、SubRem 按键映射:四套遥控布局
remotes/下 4 份.txt是Flipper SubRem Map file(Sub-GHz Remote 应用的遥控映射),格式以 remotes/Ati_media.txt 为例:
Filetype: Flipper SubRem Map file Version: 1 UP: /ext/subghz/ATI_Wonder_II/Vol+.sub DOWN: /ext/subghz/ATI_Wonder_II/Vol-.sub LEFT: /ext/subghz/ATI_Wonder_II/Rew.sub RIGHT: /ext/subghz/ATI_Wonder_II/Ff.sub OK: /ext/subghz/ATI_Wonder_II/Pause.sub ULABEL: Vol+ DLABEL: Vol- LLABEL: Rew RLABEL: Ff OKLABEL: Play映射语法非常直观:UP/DOWN/LEFT/RIGHT/OK指定 Flipper 五向键按下时回放哪个.sub文件,路径统一使用 SD 卡挂载点/ext/subghz/...;ULABEL/DLABEL/LLABEL/RLABEL/OKLABEL定义屏幕上对应按键的显示名。四套映射的完整布局如下:
Ati_media —— 媒体控制(remotes/Ati_media.txt)
| 方向键 | 回放信号 | 显示名 |
|---|---|---|
| UP | Vol+.sub | Vol+ |
| DOWN | Vol-.sub | Vol- |
| LEFT | Rew.sub | Rew |
| RIGHT | Ff.sub | Ff |
| OK | Pause.sub | Play |
覆盖音量增减、播放/暂停、快退、快进。由于映射只有 5 个键位,没有多余位置放 Mute(静音),README 也明确指出了这一取舍;如需静音,可基于已有的 Mute.sub 自行替换某一键位。
Ati_media_alt —— 桌面视频场景(remotes/Ati_media_alt.txt)
| 方向键 | 回放信号 | 显示名 |
|---|---|---|
| UP | F.sub | Fullscreen |
| DOWN | Pause.sub | Play |
| LEFT | Left.sub | Left |
| RIGHT | Right.sub | Right |
| OK | Play.sub | Pl |
作者评价其"在桌面端看 YouTube 时更有用":全屏切换、播放、左右方向键一步到位。
Ati_mouse —— 鼠标模拟(remotes/Ati_mouse.txt)
| 方向键 | 回放信号 | 显示名 |
|---|---|---|
| UP | Mouse_up.sub | Up |
| DOWN | Mouse_down.sub | Down |
| LEFT | Mouse_left.sub | Left |
| RIGHT | Mouse_right.sub | Right |
| OK | Click.sub | Click |
这是四套里作者评价最低的一套:"几乎无用,因为鼠标移动速度很难在捕获中还原正确,且遥控布局不允许右键"。原因在于:鼠标移动信号本质是"持续位移"语义而非"点按",而 RAW 回放是固定时长的一次性脉冲序列,难以模拟连续移动的速度曲线;同时五向键布局天然没有右键位置(Rclick.sub虽已捕获,但 SubRem 单屏只有 5 个键位)。
Ati_arrows —— 纯方向键(remotes/Ati_arrows.txt)
| 方向键 | 回放信号 | 显示名 |
|---|---|---|
| UP | Up.sub | Up |
| DOWN | Down.sub | Down |
| LEFT | Left.sub | Left |
| RIGHT | Right.sub | Right |
| OK | Ok.sub | Ok |
最精简的一套:仅映射方向箭头与 OK 确认,适合菜单导航类场景。
六、部署到 Flipper Zero:SD 卡路径与目录布局
README 给出的部署指引为:把信号文件放入subghz/ATI_Wonder_II/,把映射.txt放入subghz/remote/。需要说明的是,原文档中写的/etc/subghz/ATI_Wonder_II/与/etc/subhgz/remote存在笔误(前者应为 SD 卡挂载点/ext,后者应为/ext/subghz/remote)——以映射文件内部实际使用的/ext/subghz/ATI_Wonder_II/路径为准。完整步骤:
- 用 qFlipper(USB 连接)或手机 App(蓝牙连接)挂载 Flipper Zero 的 SD 卡;
- 在 SD 卡根目录创建
subghz/ATI_Wonder_II/文件夹,把目录下全部 55 个.sub文件拷入; - 在 SD 卡创建
subghz/remote/文件夹(如不存在),把remotes/下 4 个.txt拷入; - 弹出并断开连接,进入 Flipper Zero 的Sub-GHz → Remote(遥控)应用,即可看到
Ati_media、Ati_media_alt、Ati_mouse、Ati_arrows四个遥控器,选择后按 Flipper 五向键即可回放对应信号。
如果日后要新增自定义映射,只需复制任一.txt模板,改写 5 行XXX.sub路径与对应 LABEL 即可,Flipper 会自动在 Remote 应用中识别新文件。
七、验证与已知限制
- 桌面端实测:作者在普通桌面机上通过Linux 内核驱动对接 ATI Wonder II 接收站完成了部分按键验证。这类 RF 接收器在 Linux 下由
ati_remote/ati_remote2系列内核驱动识别,将 RF 按键翻译为键盘/媒体键 HID 事件;因此实测效果"很大程度上取决于你的系统环境,以及每个按键被分配给了哪个动作"(README 原文)。 - 未覆盖的场景:未在 Windows 上测试;并非所有按键都被实测过——若某个
.sub回放无效,优先怀疑频率偏差(见第四节)而非信号本身损坏。 - 功能受限的映射:
Ati_media无静音位、Ati_mouse移动速度与右键受限,均受 SubRem 五键布局约束,属于结构性问题而非信号缺失。
八、小结:一条可复用的 RF 遥控复刻路径
通过这份信号库可以提炼出完整的复刻方法论:频率分析锁定载频 → RAW 捕获波形 → 校对频率一致性 → 编写 SubRem 五键映射 → 按/ext/subghz/<Device>/与/ext/subghz/remote/布局部署 → 接收端实测迭代。其中"频率校准"与"按键语义适配"是决定成败的两个关键点,本文信号库的局限性记录(频率漂移、鼠标速度难还原、布局无右键)正是这两点的最好注脚。读者可直接以 README.md、remotes/ 与 55 份.sub信号为蓝本,迁移到其他 433 MHz OOK RF 遥控设备的复刻项目中。
【免费下载链接】FlipperPlayground (and dump) of stuff I make or modify for the Flipper Zero项目地址: https://gitcode.com/GitHub_Trending/fl/Flipper
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考