Momentum Firmware Sub-GHz Remote 插件指南：配置 UniRF 自定义方向键遥控映射
Momentum Firmware Sub-GHz Remote 插件指南配置 UniRF 自定义方向键遥控映射【免费下载链接】Momentum-Firmware Feature-rich, stable and customizable Flipper Firmware项目地址: https://gitcode.com/GitHub_Trending/mo/Momentum-FirmwareSub-GHz RemoteUniRF Remix是 Momentum Firmware 内置的 Sub-GHz 遥控应用允许用户把已捕获的.sub信号文件映射到方向键UP/DOWN/LEFT/RIGHT/OK上形成一键发送的快捷遥控面板。本文以 SubGHzRemotePlugin.md 为核心完整讲解 map 文件.txt的目录位置、配置格式、错误排查与使用注意事项并结合仓库内置的Tesla_Remote.txt示例与文件浏览器集成源码进行佐证让读者能够直接在设备上创建并运行属于自己的 Sub-GHz 遥控映射。前置条件自定义 map 文件必须存在且配置正确SubGHz Remote 工具强制要求在 SD 卡的subghz/remote文件夹下创建自定义的 map 文件扩展名为.txt目录位置/ext/subghz/remote/即 SD 卡上的subghz/remote目录文件数量可以添加任意多个.txtmap 文件文件名不限配置要求文件内容必须按下方格式正确配置否则工具无法运行。Momentum 固件在出厂资源中已经内置了一个可直接参考的 map 文件示例Tesla_Remote.txt其内容为Filetype: Flipper SubRem Map file Version: 1 UP: /ext/subghz/Tesla/Tesla_EU_AM270.sub DOWN: /ext/subghz/Tesla/Tesla_EU_AM650.sub LEFT: /ext/subghz/Tesla/Tesla_US_AM270.sub RIGHT: /ext/subghz/Tesla/Tesla_US_AM650.sub ULABEL: EU AM270 DLABEL: EU AM650 LLABEL: US AM270 RLABEL: US AM650从该内置示例可以看出map 文件头部的Filetype与Version行用于声明文件类型与格式版本随后才是方向键的映射配置。配置错误的报错信息与排查如果.txt文件不存在、未配置或配置不正确运行 UniRF Remix 应用时会抛出如下错误Config is incorrect. Please configure map Press Back to Exit出现该提示时请按以下顺序排查确认subghz/remote目录存在于 SD 卡的subghz文件夹下确认目录中存在至少一个.txtmap 文件确认 map 文件中的每一行都严格遵循KEY: value格式且每个.sub文件路径真实存在确认文件路径不含空格或非法特殊字符见下文「注意事项」。map 文件完整配置格式以仓库文档中的subghz/remote/example.txt为例标准配置模板如下UP: /ext/subghz/Up.sub DOWN: /ext/subghz/Down.sub LEFT: /ext/subghz/Left.sub RIGHT: /ext/subghz/Right.sub OK: /ext/subghz/Ok.sub ULABEL: Up Label DLABEL: Down Label LLABEL: Left Label RLABEL: Right Label OKLABEL: Ok Label键位KEY字段含义字段含义UP上方向键对应的.sub信号文件路径DOWN下方向键对应的.sub信号文件路径LEFT左方向键对应的.sub信号文件路径RIGHT右方向键对应的.sub信号文件路径OKOK 确认键对应的.sub信号文件路径ULABEL上方向键在屏幕上显示的文本标签DLABEL下方向键在屏幕上显示的文本标签LLABEL左方向键在屏幕上显示的文本标签RLABEL右方向键在屏幕上显示的文本标签OKLABELOK 键在屏幕上显示的文本标签其中UP/DOWN/LEFT/RIGHT/OK五个文件位置字段必须指向你希望映射到对应方向键的.sub捕获文件绝对路径ULABEL/DLABEL/LLABEL/RLABEL/OKLABEL五个标签字段用于设置屏幕上为每个已映射文件显示的文本。完整实战示例将门铃、风扇与车库门遥控组合为一个万能遥控面板的示例UP: /ext/subghz/Fan1.sub DOWN: /ext/subghz/Fan2.sub LEFT: /ext/subghz/Door.sub RIGHT: /ext/subghz/Garage3.sub OK: /ext/subghz/Garage3l.sub ULABEL: Fan ON DLABEL: Fan OFF LLABEL: Doorbell RLABEL: Garage OPEN OKLABEL: Garage CLOSE这样配置后在应用中按下「上」即发送Fan1.sub风扇开按下「下」即发送Fan2.sub风扇关其余按键依此类推屏幕对应位置会显示各自标签。在设备端直接创建与编辑 map 文件文档特别强调现在可以直接在 Flipper 设备上创建和编辑 map 文件。操作方式为进入 Sub-GHz Remote 应用按下Back返回按钮即可进入 map 文件的创建/编辑界面在设备上完成 map 文件的增删改后保存即可生效无需借助电脑修改 SD 卡。这意味着从捕获.sub信号、编写 map 映射到实际运行整个流程都可以在设备端独立完成。应用使用方式与注意事项App 使用说明发送信号按下任意方向键即可发送该按键对应配置的.sub捕获文件退出应用按下Back按钮退出。Sub-GHz Remote Map 文件规则路径限制文件路径中不应包含空格或特殊字符-与_除外否则可能导致配置解析失败标签长度限制标签Label内容限制为16 个字符以内。原因是屏幕空间有限过长的标签会导致屏幕元素相互重叠例如将标签设置为WWWWWWWWWWWWWWW17 个字符就会超出屏幕显示边界。与文件浏览器的集成map 文件在 Archive 中的识别在 Momentum 固件中subghz/remote目录下的 map 文件不仅供 Sub-GHz Remote 应用使用还会被系统文件浏览器Archive识别为独立文件类型。相关实现位于 archive_files.c当 Archive 检测到扩展名为.txt的文件时会进一步比对文件所在目录路径若文件位于SUBREM_APP_FOLDER即subghz/remote下则将其归类为ArchiveFileTypeSubghzRemote同理位于subghz/playlist目录下的.txt会被识别为播放列表类型ArchiveFileTypeSubghzPlaylist位于红外遥控目录下的则识别为红外遥控类型ArchiveFileTypeInfraredRemote。同时archive_browser.c 中针对subghz/remote目录做了专门的处理分支确保该目录在文件浏览界面中能够被正确展示与导航。小结Sub-GHz Remote 插件的核心使用链路非常清晰先捕获.sub信号文件 → 在subghz/remote目录编写 map 映射可直接在设备端完成→ 启动 UniRF Remix 按方向键一键发送。只要 map 文件路径真实、格式正确、标签不超长即可把最多五个常用射频遥控操作整合到一个界面中显著提升日常使用效率。若运行时报出Config is incorrect请优先检查 map 文件是否存在、路径是否含空格以及.sub文件是否就位。【免费下载链接】Momentum-Firmware Feature-rich, stable and customizable Flipper Firmware项目地址: https://gitcode.com/GitHub_Trending/mo/Momentum-Firmware创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考