Home Assistant LCN 集成lcn.output_abs动作完全指南输出端口绝对亮度控制【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读lcn.output_abs是 Home Assistant LCN 集成提供的一个动作Action用于将 LCN 模块上某个输出端口的亮度直接设定为一个固定的百分比值。本文围绕该动作完整讲解其功能定位、UI 与 YAML 两种配置方式、全部参数设备、输出端口、亮度、渐变时间的取值范围与含义并结合output_rel、output_toggle、pck等相关动作及 LCN 集成源码级文档说明如何在自动化与脚本中精准驱动可调光输出例如把一盏灯精确调到 60%。读完本文你将掌握在 Home Assistant 中通过 UI 或 YAML 使用lcn.output_abs的完整方法以及它与相对亮度、切换、裸 PCK 命令等动作的搭配策略。动作概述绝对亮度 vs 相对亮度LCNLocal Control Network是一套楼宇自动化总线系统其硬件模块提供多个输出端口output port可驱动可调光负载如调光灯具。在 Home Assistant 中LCN 集成把模块的输出端口抽象为实体并提供了一系列**动作actions**用于在自动化与脚本中直接操控这些端口。lcn.output_abs的作用是把某个输出端口的亮度设定为固定的百分比而不是在现有亮度基础上增减。这种绝对设定语义非常适合以下场景将灯光精确设定到某个亮度例如恰好 60%用同一个动作实现开灯到指定亮度、调光、关灯亮度 0等多种效果在场景、日程或条件自动化中保证输出最终处于一个可预期的确定状态。与之相对的是lcn.output_rel相对亮度它在当前亮度上做增减正值调亮、负值调暗例如把灯再调亮 30%。lcn.output_rel.markdown 文档明确指出其 brightness 取值范围为 -100 到 100。而lcn.output_toggle则只做开关切换端口当前为关则开为开则关见 lcn.output_toggle.markdown。三个动作在 front matter 的related_actions中互相引用官方将其视为同一组输出端口控制动作族实际编排自动化时可根据需求自由组合。前提LCN 集成与模块配置lcn.output_abs面向的对象是 LCN 模块或组group的输出端口。在使用该动作前需要先完成 LCN 集成的配置硬件连接集成需要 LCN-PCHK版本 2.8耦合软件的一个未使用许可证及一个 LCN 硬件耦合器或者使用提供至少两个 PCHK 许可证的 LCN-VISU / LCN-PKE 耦合器详见 LCN 集成前提。添加集成条目在设置 → 设备与服务中添加 LCN 集成提供名称、PCHK 服务器 IP、端口、用户名、密码等信息。每个硬件耦合器需要单独创建一个集成条目。配置模块/组在 LCN 配置面板选择集成条目旁的Configure按钮进入中通过Scan Modules扫描总线上的模块或手动Create Module/Group创建模块与组。这些模块/组在 Home Assistant 中表现为设备其外围设备输出端口、继电器、变量等表现为实体。配置面板相关界面截图可在 source/images/integrations/lcn 目录中查看如lcn_integration_configuration.png、lcn_device_page.png。注意lcn.output_abs动作直接面向模块/组设备本身因此即使你没有为输出端口创建 Light 实体也可以通过该动作直接控制端口。这也正是 LCN 集成文档所说已实现的平台并未覆盖 LCN 系统的全部功能因此集成提供了大量事件、设备触发器和动作非常适合在自动化脚本中使用的场景。在自动化 UI 中使用lcn.output_abslcn.output_abs不依赖目标targets机制——它不像light.turn_on那样通过实体目标选择对象而是通过Device设备字段直接指定 LCN 模块或组。这意味着它可以在没有对应实体的情况下工作也意味着调用时必须显式选择设备。在自动化编辑器中配置该动作的完整步骤与 lcn.output_abs.markdown 文档一致进入设置 → 自动化与场景Settings Automations scenes。打开现有自动化或脚本或选择创建自动化 → 创建新自动化。如果是新建自动化在When何时部分添加触发器脚本无需触发器它们在被其他内容调用时运行。在Then do然后执行部分选择添加动作Add action。在搜索框中搜索并选择LCN: Output absolute brightness。在Device字段中选择 LCN 模块或组选择Output端口并设置Brightness亮度。选择保存Save。UI 中的选项说明选项说明必填Device要向其发送命令的 LCN 模块或组是Output模块的输出端口取值为output1、output2、output3、output4是Brightness绝对亮度百分比取值范围 0 到 100是Transition渐变ramp时间单位秒取值范围 0 到 486否其中Transition渐变时间是该动作的特色参数它让亮度不是瞬间跳变而是在指定秒数内平滑过渡到目标值非常适合营造呼吸灯式或日落式的调光体验。官方给出的上限为 486 秒约 8 分钟足以覆盖绝大多数缓变场景。在 YAML 中使用lcn.output_abs在自动化、脚本或蓝图等 YAML 配置中该动作的服务名为lcn.output_abs。官方文档给出的基本示例action: lcn.output_abs data: device_id: 91aa039a2fb6e0b9f9ec7eb219a6b7d2 output: output1 brightness: 100该示例将所选模块的输出端口 1 设为满亮度100%。YAML 参数详解参数类型必填默认值说明device_idstring是—LCN 模块或组的设备 IDoutputstring是—模块的输出端口见 Ports端口 常量表brightnessinteger是—绝对亮度百分比0 到 100transitionfloat否0渐变ramp时间单位秒0 到 486各参数要点device_id即 LCN 模块/组在 Home Assistant 中作为设备的内部 ID。如何获取LCN 集成文档给出了一个非常实用的技巧——在自动化或脚本中使用模板函数device_id()根据前端显示的模块名称或 LCN-PRO 软件中配置的名称动态解析设备 ID。官方示例来自 LCN 集成文档action: lcn.pck data: device_id: {{ device_id(Module name) }} pck: PIN4同样的思路完全适用于lcn.output_abs的device_id字段这样即使设备 ID 变化自动化也无需手工维护。output取值限定为output1、output2、output3、output4四个端口常量之一。LCN 集成文档的 LCN constants → Ports 部分明确了OUTPUT_PORT常量的取值为这四项。brightness目标亮度的绝对值0 表示关断全暗100 表示满亮度。该参数的类型为 integer与 UI 中的取值范围一致0 到 100。transition渐变时间秒类型为 float默认 0即瞬间切换。范围为 0 到 486。设置为大于 0 的值时模块会在该时间段内将输出平滑渐变到目标亮度。更完整的实战示例结合渐变时间与模板函数一个黄昏时在 10 分钟内把客厅输出 1 从 0 平滑调亮到 80%的自动化可以这样写alias: Living room evening ramp triggers: - trigger: time at: 21:00:00 actions: - action: lcn.output_abs data: device_id: {{ device_id(Living room module) }} output: output1 brightness: 80 transition: 600如果你更偏好使用已有的 Light 实体LCN 集成同样提供 Light 平台可控制可调光输出端口与继电器但lcn.output_abs的优势在于无需实体即可按绝对亮度精确驱动端口并直接暴露渐变时间参数。与相关动作的搭配使用lcn.output_abs的 front matter 声明了三个相关动作官方在 actions/related.md 中将其展示为与本文动作配合良好的动作族动作作用与output_abs的区别lcn.output_rel相对亮度增减-100 到 100不设定绝对值而是在当前亮度基础上加减负值调暗lcn.output_toggle切换输出端口开关状态只做开/关翻转不涉及亮度值同样支持可选transitionlcn.pck发送任意 PCK 命令不含地址头用于覆盖其他动作未涵盖的裸命令如PIN4一个典型的组合用法是用output_rel做每按一次调亮 10%的步进控制用output_toggle做快速开/关用output_abs做一键回到 100%或一键入睡模式 20%这样的绝对定位。当上述三个动作都无法满足需求时例如某些 LCN 专有命令再用lcn.pck发送原始 PCK 命令兜底。直接测试开发者工具中的 Actions在不写任何 YAML 的情况下你可以通过开发者工具直接验证lcn.output_abs的效果进入设置 → 工具 → 操作Actions即 Developer Tools 的服务调用界面。搜索lcn.output_abs。填写 Device或device_id、Output、Brightness 等字段。选择执行操作Perform action观察真实模块输出端口的变化。这个即时测试流程来自官方文档统一引用的 actions/try_it.md适用于所有 LCN 动作也是排查参数配置问题的最快途径。常见问题与排障提示看不到模块或组设备先确认 LCN 集成条目已正确添加PCHK 服务器连接正常并在配置面板中完成模块扫描或手动创建。集成文档提示若未识别出全部段耦合器可增大Segment coupler scan attempts参数若现场没有段耦合器该值保持 0。动作报设备无效device_id必须对应真实的 LCN 模块/组设备。推荐用device_id(模块名)模板动态获取避免硬编码。渐变时间不生效确认transition取值范围在 0 到 486 秒之间0 表示瞬间切换。注意 LCN 模块的调光步数由集成配置项Dimming mode决定该设置是系统相关的取决于现场 LCN 模块的能力见 LCN 集成配置。端口亮度值不符预期output仅接受output1~output4四个端口常量若需控制其他外围设备如继电器、电机应改用lcn.relays、lcn.cover等对应动作或平台。如果以上排查仍无法解决问题可携带具体动作调用与预期行为到 Home Assistant 社区寻求帮助官方文档的 actions/stuck.md 给出了 Discord、社区论坛等渠道。小结lcn.output_abs是 LCN 输出端口控制动作族中语义最确定的一个它把输出端口的亮度直接设定为 0 到 100 之间的某个绝对百分比支持 0 到 486 秒的可选渐变时间且不依赖目标实体、直接面向模块/组设备工作。无论你是通过自动化 UI 的图形化表单还是在 YAML 中手写action: lcn.output_abs都可以快速实现精确调光这一楼宇自动化中最常见也最实用的控制需求。结合device_id()模板函数与transition渐变参数你可以在不创建任何额外实体的前提下写出健壮、可平滑过渡的 LCN 调光自动化。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Home Assistant LCN 集成 `lcn.output_abs` 动作完全指南：输出端口绝对亮度控制
Home Assistant LCN 集成lcn.output_abs动作完全指南输出端口绝对亮度控制【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读lcn.output_abs是 Home Assistant LCN 集成提供的一个动作Action用于将 LCN 模块上某个输出端口的亮度直接设定为一个固定的百分比值。本文围绕该动作完整讲解其功能定位、UI 与 YAML 两种配置方式、全部参数设备、输出端口、亮度、渐变时间的取值范围与含义并结合output_rel、output_toggle、pck等相关动作及 LCN 集成源码级文档说明如何在自动化与脚本中精准驱动可调光输出例如把一盏灯精确调到 60%。读完本文你将掌握在 Home Assistant 中通过 UI 或 YAML 使用lcn.output_abs的完整方法以及它与相对亮度、切换、裸 PCK 命令等动作的搭配策略。动作概述绝对亮度 vs 相对亮度LCNLocal Control Network是一套楼宇自动化总线系统其硬件模块提供多个输出端口output port可驱动可调光负载如调光灯具。在 Home Assistant 中LCN 集成把模块的输出端口抽象为实体并提供了一系列**动作actions**用于在自动化与脚本中直接操控这些端口。lcn.output_abs的作用是把某个输出端口的亮度设定为固定的百分比而不是在现有亮度基础上增减。这种绝对设定语义非常适合以下场景将灯光精确设定到某个亮度例如恰好 60%用同一个动作实现开灯到指定亮度、调光、关灯亮度 0等多种效果在场景、日程或条件自动化中保证输出最终处于一个可预期的确定状态。与之相对的是lcn.output_rel相对亮度它在当前亮度上做增减正值调亮、负值调暗例如把灯再调亮 30%。lcn.output_rel.markdown 文档明确指出其 brightness 取值范围为 -100 到 100。而lcn.output_toggle则只做开关切换端口当前为关则开为开则关见 lcn.output_toggle.markdown。三个动作在 front matter 的related_actions中互相引用官方将其视为同一组输出端口控制动作族实际编排自动化时可根据需求自由组合。前提LCN 集成与模块配置lcn.output_abs面向的对象是 LCN 模块或组group的输出端口。在使用该动作前需要先完成 LCN 集成的配置硬件连接集成需要 LCN-PCHK版本 2.8耦合软件的一个未使用许可证及一个 LCN 硬件耦合器或者使用提供至少两个 PCHK 许可证的 LCN-VISU / LCN-PKE 耦合器详见 LCN 集成前提。添加集成条目在设置 → 设备与服务中添加 LCN 集成提供名称、PCHK 服务器 IP、端口、用户名、密码等信息。每个硬件耦合器需要单独创建一个集成条目。配置模块/组在 LCN 配置面板选择集成条目旁的Configure按钮进入中通过Scan Modules扫描总线上的模块或手动Create Module/Group创建模块与组。这些模块/组在 Home Assistant 中表现为设备其外围设备输出端口、继电器、变量等表现为实体。配置面板相关界面截图可在 source/images/integrations/lcn 目录中查看如lcn_integration_configuration.png、lcn_device_page.png。注意lcn.output_abs动作直接面向模块/组设备本身因此即使你没有为输出端口创建 Light 实体也可以通过该动作直接控制端口。这也正是 LCN 集成文档所说已实现的平台并未覆盖 LCN 系统的全部功能因此集成提供了大量事件、设备触发器和动作非常适合在自动化脚本中使用的场景。在自动化 UI 中使用lcn.output_abslcn.output_abs不依赖目标targets机制——它不像light.turn_on那样通过实体目标选择对象而是通过Device设备字段直接指定 LCN 模块或组。这意味着它可以在没有对应实体的情况下工作也意味着调用时必须显式选择设备。在自动化编辑器中配置该动作的完整步骤与 lcn.output_abs.markdown 文档一致进入设置 → 自动化与场景Settings Automations scenes。打开现有自动化或脚本或选择创建自动化 → 创建新自动化。如果是新建自动化在When何时部分添加触发器脚本无需触发器它们在被其他内容调用时运行。在Then do然后执行部分选择添加动作Add action。在搜索框中搜索并选择LCN: Output absolute brightness。在Device字段中选择 LCN 模块或组选择Output端口并设置Brightness亮度。选择保存Save。UI 中的选项说明选项说明必填Device要向其发送命令的 LCN 模块或组是Output模块的输出端口取值为output1、output2、output3、output4是Brightness绝对亮度百分比取值范围 0 到 100是Transition渐变ramp时间单位秒取值范围 0 到 486否其中Transition渐变时间是该动作的特色参数它让亮度不是瞬间跳变而是在指定秒数内平滑过渡到目标值非常适合营造呼吸灯式或日落式的调光体验。官方给出的上限为 486 秒约 8 分钟足以覆盖绝大多数缓变场景。在 YAML 中使用lcn.output_abs在自动化、脚本或蓝图等 YAML 配置中该动作的服务名为lcn.output_abs。官方文档给出的基本示例action: lcn.output_abs data: device_id: 91aa039a2fb6e0b9f9ec7eb219a6b7d2 output: output1 brightness: 100该示例将所选模块的输出端口 1 设为满亮度100%。YAML 参数详解参数类型必填默认值说明device_idstring是—LCN 模块或组的设备 IDoutputstring是—模块的输出端口见 Ports端口 常量表brightnessinteger是—绝对亮度百分比0 到 100transitionfloat否0渐变ramp时间单位秒0 到 486各参数要点device_id即 LCN 模块/组在 Home Assistant 中作为设备的内部 ID。如何获取LCN 集成文档给出了一个非常实用的技巧——在自动化或脚本中使用模板函数device_id()根据前端显示的模块名称或 LCN-PRO 软件中配置的名称动态解析设备 ID。官方示例来自 LCN 集成文档action: lcn.pck data: device_id: {{ device_id(Module name) }} pck: PIN4同样的思路完全适用于lcn.output_abs的device_id字段这样即使设备 ID 变化自动化也无需手工维护。output取值限定为output1、output2、output3、output4四个端口常量之一。LCN 集成文档的 LCN constants → Ports 部分明确了OUTPUT_PORT常量的取值为这四项。brightness目标亮度的绝对值0 表示关断全暗100 表示满亮度。该参数的类型为 integer与 UI 中的取值范围一致0 到 100。transition渐变时间秒类型为 float默认 0即瞬间切换。范围为 0 到 486。设置为大于 0 的值时模块会在该时间段内将输出平滑渐变到目标亮度。更完整的实战示例结合渐变时间与模板函数一个黄昏时在 10 分钟内把客厅输出 1 从 0 平滑调亮到 80%的自动化可以这样写alias: Living room evening ramp triggers: - trigger: time at: 21:00:00 actions: - action: lcn.output_abs data: device_id: {{ device_id(Living room module) }} output: output1 brightness: 80 transition: 600如果你更偏好使用已有的 Light 实体LCN 集成同样提供 Light 平台可控制可调光输出端口与继电器但lcn.output_abs的优势在于无需实体即可按绝对亮度精确驱动端口并直接暴露渐变时间参数。与相关动作的搭配使用lcn.output_abs的 front matter 声明了三个相关动作官方在 actions/related.md 中将其展示为与本文动作配合良好的动作族动作作用与output_abs的区别lcn.output_rel相对亮度增减-100 到 100不设定绝对值而是在当前亮度基础上加减负值调暗lcn.output_toggle切换输出端口开关状态只做开/关翻转不涉及亮度值同样支持可选transitionlcn.pck发送任意 PCK 命令不含地址头用于覆盖其他动作未涵盖的裸命令如PIN4一个典型的组合用法是用output_rel做每按一次调亮 10%的步进控制用output_toggle做快速开/关用output_abs做一键回到 100%或一键入睡模式 20%这样的绝对定位。当上述三个动作都无法满足需求时例如某些 LCN 专有命令再用lcn.pck发送原始 PCK 命令兜底。直接测试开发者工具中的 Actions在不写任何 YAML 的情况下你可以通过开发者工具直接验证lcn.output_abs的效果进入设置 → 工具 → 操作Actions即 Developer Tools 的服务调用界面。搜索lcn.output_abs。填写 Device或device_id、Output、Brightness 等字段。选择执行操作Perform action观察真实模块输出端口的变化。这个即时测试流程来自官方文档统一引用的 actions/try_it.md适用于所有 LCN 动作也是排查参数配置问题的最快途径。常见问题与排障提示看不到模块或组设备先确认 LCN 集成条目已正确添加PCHK 服务器连接正常并在配置面板中完成模块扫描或手动创建。集成文档提示若未识别出全部段耦合器可增大Segment coupler scan attempts参数若现场没有段耦合器该值保持 0。动作报设备无效device_id必须对应真实的 LCN 模块/组设备。推荐用device_id(模块名)模板动态获取避免硬编码。渐变时间不生效确认transition取值范围在 0 到 486 秒之间0 表示瞬间切换。注意 LCN 模块的调光步数由集成配置项Dimming mode决定该设置是系统相关的取决于现场 LCN 模块的能力见 LCN 集成配置。端口亮度值不符预期output仅接受output1~output4四个端口常量若需控制其他外围设备如继电器、电机应改用lcn.relays、lcn.cover等对应动作或平台。如果以上排查仍无法解决问题可携带具体动作调用与预期行为到 Home Assistant 社区寻求帮助官方文档的 actions/stuck.md 给出了 Discord、社区论坛等渠道。小结lcn.output_abs是 LCN 输出端口控制动作族中语义最确定的一个它把输出端口的亮度直接设定为 0 到 100 之间的某个绝对百分比支持 0 到 486 秒的可选渐变时间且不依赖目标实体、直接面向模块/组设备工作。无论你是通过自动化 UI 的图形化表单还是在 YAML 中手写action: lcn.output_abs都可以快速实现精确调光这一楼宇自动化中最常见也最实用的控制需求。结合device_id()模板函数与transition渐变参数你可以在不创建任何额外实体的前提下写出健壮、可平滑过渡的 LCN 调光自动化。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
