Flipper Zero 万能遥控器库扩展指南为电视、音响、投影仪与空调录制并提交 IR 信号【免费下载链接】flipperzero-firmwareFlipper Zero firmware source code项目地址: https://gitcode.com/GitHub_Trending/fl/flipperzero-firmware本文以 Flipper Zero 固件仓库中的 UniversalRemotes.md 为骨架讲解如何将你自己的电视、音响音频播放器、投影仪和空调遥控器信号录入 Flipper Zero 的万能遥控器Universal Remote库。读完本文你将掌握每一类设备的标准信号命名规范、逐键录制流程、空调这类状态型设备的特殊录制手法以及如何把录制结果追加到.ir资产文件并提交 Pull Request让固件内置的 Universal Remote 界面能直接驱动你的家电。背景什么是 Flipper Zero 的 Universal RemoteFlipper Zero 的红外IR应用内置了一个万能遥控器入口它不是一个单一的学习遥控器而是一个信号库 暴力遍历brute force发送器库中按设备类别存放了大量品牌型号的红外信号界面以按钮面板Button Panel呈现逐个尝试库中的信号直到命中。固件侧每个类别对应一个场景文件例如 infrared_scene_universal_tv.c、infrared_scene_universal_ac.c 等场景通过infrared_brute_force_set_db_filename()指向对应的资产文件例如EXT_PATH(infrared/assets/tv.ir)见 infrared_scene_universal_tv.c随后通过多次infrared_brute_force_add_record(brute_force, i, Power)之类的调用按固定顺序注册按钮面板上的信号名同一文件内可见Power、Mute、Vol_up、Ch_next等。因此本文介绍的工作流的本质是用 Flipper 的学习功能录下你家设备的信号把结果以规定的格式追加到对应类别的.ir库文件中从而扩充固件内置的万能遥控库。资产文件位于 applications/main/infrared/resources/infrared/assets/ 目录共四类设备类别资产文件电视 TVtv.ir音频播放器 Audioaudio.ir投影仪 Projectorprojector.ir空调 A/Cac.ir通用录制流程与信号命名规则无论哪种设备录制的基本操作都是一致的对应学习场景的实现见 infrared_scene_learn.c其中通过infrared_worker_rx_start()启动红外接收、弹出提示 Point the remote at IR port and push the button拿起原装遥控器将其发射窗口对准 Flipper 的 IR 接收口若是录制的第一个按键选择开始学习新遥控器否则按添加新按键按下遥控器上的目标按键并在弹出的命名界面中将其保存为规定的信号名如Power重复第 2、3 步直到全部所需信号录制完毕。信号名是见名知义的且每个信号都必须实测验证——确认按下 Flipper 上对应按钮后家电确实执行了该动作开机、静音、换台……再继续下一步。全部验证通过后将这批信号追加到对应类别资产文件的末尾追加而非插入顺序无关紧要详见后文最终提交步骤。从库文件格式上看信号有两种保存形态两种都会被 Universal Remote 正常加载parsed已解析记录protocol如NEC、SIRC、Samsung32、RC5、RC6、Kaseikyo、NECext等、address与command体积小、可重复发射raw原始时序记录frequency、duty_cycle和一段data脉冲序列用于无法匹配已知协议的信号。以 tv.ir 开头部分为例典型的 parsed 条目如下# name: Power type: parsed protocol: SIRC address: 01 00 00 00 command: 15 00 00 00raw 条目则形如# name: Power type: raw frequency: 38000 duty_cycle: 0.330000 data: 634 2571 505 519 ...两类条目均由#分隔文件头部固定为Filetype: IR library file Version: 1提示如果你只是临时测试也可以完全不碰文件——用 CLI 的ir rx直接看 Flipper 能否识别信号。详见文末用 CLI 辅助验证一节。电视Televisions6 个标准信号给电视添加万能遥控信号非常简单直接。最多可以录制 6 个信号其中任一信号在电视不支持时都可以省略信号名含义Power电源开关Mute静音Vol_up音量加Vol_dn音量减Ch_next频道下一个Ch_prev频道上一个按通用流程录完后把信号追加到 tv.ir 文件末尾。从源码看这个 6 键布局与场景实现完全对应infrared_scene_universal_tv.c 中依次注册了Power、Mute、Vol_up、Ch_next、Vol_dn、Ch_prev六个记录名见该文件的infrared_brute_force_add_record调用界面采用 2 行 × 3 列的按钮面板布局。也就是说你追加到库里的每个命名信号都会被绑定到 Universal Remote 电视界面上的固定位置。音频播放器Audio Players8 个标准信号音频播放器功放、回音壁、CD 机等的录制方法与电视完全相同最多 8 个信号任一不支持时均可省略信号名含义Power电源开关Play播放Pause暂停Vol_up音量加Vol_dn音量减Next下一曲Prev上一曲Mute静音这里有一个常见的实际场景很多遥控器的Play键同时兼任Pause播放/暂停二合一。文档明确要求此时只录成Play省略Pause不要重复录制同一个物理按键。源码中infrared_scene_universal_audio.c 注册的顺序为Power、Mute、Play、Pause、Prev、Next、Vol_dn、Vol_up。库文件里也确实能看到大量同键兼任的注释例如 audio.ir 中某型号注释为# Also PausePlay与Pause共用同一组address/command另一处 Panasonic 型号的注释为# CD play/pause, tape play also exists but probably less commonly usedPlay与Pause使用了完全相同的 Kaseikyo 协议地址命令对。这说明播放/暂停合并是真实存在的普遍现象录制时遵循录Play、略Pause即可。同样验证每个信号的实际功能后将信号追加到 audio.ir 文件末尾。投影仪Projectors4 个标准信号投影仪更简单最多 4 个信号任一不支持时均可省略信号名含义Power电源开关Mute静音Vol_up音量加Vol_dn音量减文档特别提醒请确保每个录制信号都已按规范命名以节省后续排查时间而对于只提供上述 4 键的投影仪省略其中不支持的按键一般不会带来问题。录制完成后追加到 projector.ir 末尾。场景侧 infrared_scene_universal_projector.c 注册的顺序即Power、Mute、Vol_up、Vol_dn。空调Air Conditioners状态型设备的特殊录制空调与大多数红外设备有一个本质区别它的运行状态由遥控器自身维护。大多数空调遥控器带有一块小显示屏显示当前模式、设定温度等参数用户每按一次键遥控器会把一整组参数打包发射给室内机这些参数必须整体录制、整体使用不能只录单个键码。因此空调的录制流程完全不同需要先摆好状态再按下 POWER 让遥控器把整组状态发射出来。要加入万能空调遥控需录制 6 个信号Off、Dh、Cool_hi、Cool_lo、Heat_hi、Heat_lo。除Off外的 5 个信号按模式逐项录制对每个信号除Off按下述算法操作拿起遥控器先按POWER键使遥控器显示屏显示空调处于开机ON状态将空调设置到下表对应的模式其余参数如风速、导风板若可调则保持在AUTO自动按POWER键将空调切换到关机OFF状态在 Flipper 上开始学习新信号第一个按键时或按添加新按键按提示将遥控器对准 Flipper 的 IR 接收口再次按下POWER键将捕获到的信号保存为下表中对应的名称对下表中每个信号重复步骤 2–6。信号名模式温度备注Dh除湿 Dehumidify不适用 N/ACool_hi制冷 Cooling见备注制冷模式下可设的最低温度Cool_lo制冷 Cooling23°CHeat_hi制热 Heating见备注制热模式下可设的最高温度Heat_lo制热 Heating23°C要点解释为什么按 POWER 而不按其他键因为状态型遥控器只有发射瞬间才会把当前显示屏上整组状态打包发出POWER 键是在保持状态不变的情况下触发一次完整发射的最便捷方式。步骤 3 先关机、步骤 5 再开机是为了让 Flipper 接收到的正是目标状态对应的那组参数。温度基准Cool_hi/Heat_hi分别取制冷最低温、制热最高温从而与强制冷/强制热的语义对应Cool_lo/Heat_lo统一用 23°C 作为基准温度。最后的Off信号完成上表后再单独录制Off信号确认遥控器显示屏显示空调为开机ON状态在 Flipper 上开始学习新信号将遥控器对准 IR 接收口按下POWER键使遥控器切换到关机OFF状态将捕获到的信号保存为Off。收尾6 信号齐备后的验证录制完毕后该遥控器在库中应包含6 个信号。你可以省略其中任意一个但省略后对应功能将无法通过 Flipper 的万能遥控界面使用。请务必对着真实设备逐一测试确认每个信号都执行了预期动作全部通过后将这些信号追加到 ac.ir 文件末尾。从源码结构看空调场景 infrared_scene_universal_ac.c 注册的顺序是Off、Dh、Cool_hi、Heat_hi、Cool_lo、Heat_lo与文档列出的 6 个信号完全一致而 ac.ir 中每个型号也是以Off、Dh、Cool_hi、Cool_lo、Heat_hi、Heat_lo为一组个别型号可能缺Dh且大量条目以 raw 形式保存——这正印证了空调遥控器发射的是整组参数包多数情况下无法被简单解析成单一协议码只能以原始时序存储。最终提交步骤注释、追加与 Pull Request当四类设备中任何一类录制验证完毕按以下步骤将信号并入固件库信号顺序不重要但每组信号必须用一行注释打头注明设备型号以便库保持条理# Model: 你的设备型号例如 audio.ir 中就有# Model: Yamaha RAV15 and NoName Unknown Audio remote、# Model: Samsung HW-K450 Soundbar、# Model: Panasonic SA-PM193等注释projector.ir 中也有# Model: Smart、# Model: Epson、# Model: Hitatchi等。注意注释行应紧跟该型号的第一条信号之前形成型号注释 一组信号的组织单元。将录得的信号追加到对应类别资产文件的末尾电视 → tv.ir音频播放器 → audio.ir投影仪 → projector.ir空调 → ac.ir打开一个包含该变更文件的 Pull Request提交给固件仓库。需要说明的是这些.ir资产文件在固件构建期会被打包进 Flipper 的存储镜像红外应用还通过fap_libs[assets, infrared]依赖资产库见 application.fam随固件刷写后位于设备存储的infrared/assets/目录下场景代码中统一使用EXT_PATH(infrared/assets/xxx.ir)引用。因此提交 PR 后你的设备型号会出现在后续固件版本的 Universal Remote 中供所有用户直接使用。用 CLI 辅助验证与排查除了图形界面固件还提供了ir命令行工具实现于 infrared_cli.c可在录制前后快速验证信号帮助你完成文档要求确认每个信号做了该做的事的步骤ir rx # 接收并尝试解码信号输出解析结果 ir rx raw # 接收原始脉冲时序不进行解码 ir decode input_file [output_file] # 把 raw 信号文件解码为 parsed 信号 ir universal remote_name signal_name # 在指定万能遥控库中遍历发送某个信号 ir universal list remote_name # 列出指定库文件中存在的全部信号名ir rx内部通过InfraredWorker接收信号默认启用解码加raw参数则关闭解码直接输出原始时序见 infrared_cli.cir universal list会打开EXT_PATH(infrared/assets)/remote_name.irINFRARED_ASSETS_FOLDER宏定义见 infrared_cli.c统计并列出其中所有出现过的name字段——用它可以快速核对你的库文件中是否缺少某个规定信号名ir decode要求输入文件头为IR且Version: 1校验逻辑见 infrared_cli.c与资产文件的头格式一致。借助ir universal list tv之类的命令你可以在提交 PR 前确认tv.ir中确实包含新追加的型号注释与信号条目避免把格式错误的文件合入仓库。附录制前需要注意的实践要点命名严格一致追加到库文件中的name字段必须与文档规定的信号名完全一致如Vol_up不能写成Volume_up因为 Universal Remote 场景代码通过infrared_brute_force_add_record()以这些名字为键来遍历库文件名字对不上信号将永远不会被发送。格式字段完整parsed 条目需同时给出protocol、address、commandraw 条目需给出frequency、duty_cycle、data。Flipper 的库加载器依赖这些字段缺失或拼写错误会导致条目被跳过。实测优先文档反复强调make sure that every signal does what its supposed to因为部分遥控器按键存在复用如 Play/Pause 合一或伪按键如某些 A/C 遥控器的灯效键与状态无关仅凭录制成功不能保证功能正确。遵循以上流程你就能为 Flipper Zero 的万能遥控器持续贡献新的设备型号让电视、音响、投影仪与空调的通用遥控覆盖越来越广。【免费下载链接】flipperzero-firmwareFlipper Zero firmware source code项目地址: https://gitcode.com/GitHub_Trending/fl/flipperzero-firmware创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考