Home Assistant KEF 集成 DSP 刷新指南：kef.update_dsp 动作的完整用法与底层原理

Home Assistant KEF 集成 DSP 刷新指南kef.update_dsp 动作的完整用法与底层原理【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文是 Home Assistant 官方用户文档中 kef.update_dsp 动作文档 的技术解读与实践指南。该动作用于从 KEF LS50 Wireless 与 KEF LSX 音箱上手动刷新全部数字信号处理DSP设置解决刚改完 DSP 参数却拿不到最新值的场景。读完本文你将掌握该动作在自动化与脚本中的 UI 操作步骤、YAML 写法、目标target机制以及它与 kef.set_mode 等 DSP 设置动作之间的协作关系。动作概述什么时候需要手动刷新 DSP在 KEF 集成中音箱的 DSP 设置模式、低频/高频分频点、各频段增益等默认每小时自动刷新一次并且在每次执行 DSP 相关动作之后也会自动同步。这意味着绝大多数情况下Home Assistant 中的状态与音箱实际配置是保持一致的无需人工干预。kef.update_dsp动作存在的意义只有一个当你希望立刻拿到音箱上最新的 DSP 值而不是等待下一次自动刷新时。典型场景包括你在 KEF Control 官方 App 中手动调整了 DSP 参数想立即在 Home Assistant 中看到同步结果自动化流程中紧跟在kef.set_mode、kef.set_desk_db等动作之后需要读取新值作为后续判断依据排查音箱状态与 Home Assistant 状态不一致的问题时用它强制重新同步。从官方文档kef.update_dsp.markdown的描述看这个动作没有任何额外参数只接受目标target是一个纯粹的触发式刷新动作。在自动化与脚本中使用UI 操作步骤官方文档给出的 UI 操作路径见 kef.update_dsp.markdown如下进入SettingsAutomations scenes自动化与场景。打开一个已有的自动化或脚本或者选择Create automationCreate new automation新建。如果是新建自动化在When何时部分添加触发器脚本不需要触发器它们在被其他东西调用时才运行。在Then do然后执行部分选择Add action添加动作。选择要控制的设备在By target按目标选择下选择 KEF 音箱详见下文目标Targets机制。在该目标对应的动作列表中选择KEF: Update DSP。点击Save保存。UI 中的选项Options in the UI官方文档明确说明该动作在目标之外没有其他附加选项。你不需要填写任何参数选中目标、点保存即可。YAML 用法最小的动作配置在 YAML 中该动作的名字是kef.update_dsp。官方文档给出的基础示例见 kef.update_dsp.markdown如下action: kef.update_dsp target: entity_id: media_player.kef_ls50YAML 中的选项Options in YAML与 UI 一致该动作在目标之外没有任何额外 YAML 选项。目标Targets机制详解kef.update_dsp要求一个目标target目标即动作的作用对象。根据仓库中的 targets.md 定义你可以将动作指向单个实体、设备、区域、楼层或标签Home Assistant 会对目标背后所有匹配的media_player实体执行该动作实体Entity一个具体的media_player实体例如media_player.living_room设备Device属于某设备的所有media_player实体区域Area某个房间/区域内的所有media_player实体楼层Floor某一楼层上的所有media_player实体标签Label共享同一标签的所有media_player实体。同一个动作中还可以混用不同类型的目标例如同时指定一个具体实体和一个区域动作会同时对两者执行。对于 KEF 集成最常见的目标写法就是直接指定音箱对应的media_player实体如media_player.kef_ls50。在自动化中的完整示例设置 DSP 后立即刷新单独使用kef.update_dsp的意义有限它更多是作为 DSP 操作链的一环。下面给出一个将设置 刷新结合的自动化示例改完模式后立刻刷新确保后续读取到的状态是最新的alias: Sync KEF DSP after mode change triggers: - trigger: state entity_id: input_boolean.kef_dsp_sync to: on actions: - action: kef.set_mode target: entity_id: media_player.kef_ls50 data: desk_mode: true bass_extension: Standard - action: kef.update_dsp target: entity_id: media_player.kef_ls50 - action: input_boolean.turn_off target: entity_id: input_boolean.kef_dsp_sync其中kef.set_mode的选项来自 kef.set_mode.markdown包括desk_mode、wall_mode、phase_correction、high_pass布尔开关以及sub_polarity-或、bass_extensionLess、Standard或Extra。凡是在该动作中留空的选项音箱会保持当前值不变——这正是随后立即执行kef.update_dsp的价值所在把音箱端完整的 DSP 状态重新拉取同步到 Home Assistant。DSP 动作家族update_dsp 与各设置动作的关系kef.update_dsp在官方文档的 related_actions 中关联了kef.set_mode。而整个 KEF 集成实际提供了一整套与 KEF Control App 中滑杆一一对应的 DSP 设置动作均在 source/_actions 目录下它们共同构成改参数 刷新的完整闭环动作作用取值范围kef.set_mode设置 DSP 模式桌面/墙面模式、相位校正、高通、低音炮极性、低音扩展布尔开关及枚举值kef.set_desk_db桌面模式增益滑杆-6 到 0 dB步进 0.5kef.set_wall_db墙面模式增益滑杆-6 到 0 dB步进 0.5kef.set_sub_db低音炮增益滑杆-10 到 10 dBkef.set_treble_db高音微调滑杆-2 到 2 dB步进 0.5kef.set_low_hz低音炮输出低通频率滑杆40 到 250 Hz步进 5kef.set_high_hz高通模式频率滑杆50 到 120 Hz步进 5kef.update_dsp手动刷新全部 DSP 设置无附加参数可以看到kef.update_dsp与设置类动作配合使用时遵循设置动作自动刷新 手动刷新兜底的机制每个 DSP 设置动作执行后音箱会自动同步一次所以常规场景下并不需要显式调用kef.update_dsp只有当你需要绕过等待周期立即获取最新值例如在 KEF Control App 中手动改过参数时才需要显式触发它。使用前提KEF 集成配置要使用kef.update_dsp动作前提是先在configuration.yaml中配置好 KEF 集成参考 kef.markdown# Example configuration.yaml entry media_player: - platform: kef host: IP_ADDRESS type: LS50可选配置项还包括name设备名称默认KEFport设备端口默认50001maximum_volume允许的最大音量0 到 1 之间默认0.5volume_step音量增加时的步进默认0.05inverse_speaker_mode是否交换左右声道默认falsestandby_time自动待机时间20或60分钟留空表示永不待机supports_on是否支持通过网络唤醒音箱序列号低于 LS50W13074K24L/R2G 的旧款 LS50 Wireless 不支持默认true。完成配置后KEF 音箱会以media_player实体如media_player.kef_ls50出现在 Home Assistant 中成为kef.update_dsp的目标。集成自身属于Local Polling本地轮询类型的media_player平台见 kef.markdown 的 front matter这正与每小时自动刷新 DSP的机制吻合。小结kef.update_dsp用于立即刷新KEF 音箱的全部 DSP 设置而默认情况下这些设置每小时自动同步、且每个 DSP 动作执行后也会同步该动作没有附加参数只需指定目标单个实体、设备、区域、楼层或标签UI 路径为SettingsAutomations scenes中的KEF: Update DSP动作YAML 中写作action: kef.update_dsptarget它与 kef.set_mode 等 7 个 DSP 设置动作配合形成改参—自动刷新—手动兜底刷新的完整 DSP 管理闭环使用前提是完成 KEF 集成配置设备需为 KEF LS50 Wireless 或 KEF LSX。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考