Home Assistant Nexia 恒温器湿度设定nexia.set_dehumidify_setpoint动作实战指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本篇技术指南围绕 Home Assistant 文档仓库中的动作参考文档 nexia.set_dehumidify_setpoint 展开讲解如何通过 UI 与 YAML 两种方式为 Nexia、American Standard美标或 Trane特灵智能恒温器设置除湿设定点dehumidify setpoint。读完本文你将掌握该动作的完整字段定义、取值范围、目标Target选择机制以及它与其他 Nexia 湿度/净化类动作的配合方式可直接在自动化与脚本中落地使用。动作概述一个动作控制整台恒温器的除湿目标nexia.set_dehumidify_setpoint是 Home Assistant 的 Nexia 集成hub 类型集成域名为nexia对应 Nexia/American Standard/Trane 集成文档提供的一个动作action。它用于设置恒温器上的除湿设定点即当室内湿度高于该百分比时空调系统启动除湿模式的目标湿度值。使用该动作时有一个关键行为需要牢记该设置会同时影响同一台恒温器上的所有分区zone并非只作用于当前目标实体所在的分区。这与其姊妹动作nexia.set_humidify_setpoint加湿设定点范围 10–45的行为一致参见 nexia.set_humidify_setpoint。该动作的典型应用场景包括在潮湿季节根据户外湿度传感器或天气预测自动调整除湿目标夜间降低除湿设定点避免空调长时间高负荷运转离家/回家场景中联动调整湿度控制策略。在 UI 中配置该动作无需 YAML如果你习惯使用 Home Assistant 的图形化界面可以完全通过 UI 完成配置。官方文档给出了如下步骤进入设置Settings 自动化与场景Automations scenes。打开一个现有的自动化或脚本也可以选择创建自动化Create automation 创建新自动化Create new automation新建一个。如果是新建自动化需要在When何时区域添加一个触发器脚本则不需要触发器——脚本由其他自动化或服务调用时执行。在Then do然后执行区域选择添加动作Add action。选择要控制的设备在By target按目标下详见下文 动作的目标Targets选择你要控制的恒温器。在该目标可用的动作列表中选择Nexia: Set dehumidify setpoint。设置Humidity湿度数值。点击保存Save。UI 中的选项在 UI 中该动作只有一个必填选项选项说明Humidity除湿设定点以百分比表示取值范围为 35 到 65。必填。在 YAML 中使用该动作完整参考如果你直接编写 YAML或希望精确掌握 Home Assistant 在底层执行的内容可以直接以nexia.set_dehumidify_setpoint作为action字段值来调用。文档给出的基础示例如下action: nexia.set_dehumidify_setpoint target: entity_id: climate.downstairs data: humidity: 45上述示例将climate.downstairs的除湿设定点设置为45%。YAML 字段说明字段类型必填说明actionstring是固定为nexia.set_dehumidify_setpointtargetobject是动作的目标用于指定作用对象见下文 Targets 小节data.humidityinteger是除湿设定点百分比取值范围 35–65需要特别说明的是humidity字段的类型为integer整数因此请避免传入 45.5 这类浮点值。同时它也是必填项缺少该字段时动作无法正确执行。动作的目标Targets与所有 Home Assistant 动作一样该动作必须指定目标target。目标即动作的作用对象你可以将动作指向单个实体、设备、区域、楼层或标签Home Assistant 会对匹配到的每一个climate实体执行该动作。可用的目标类型包括实体Entity单个具体的climate实体例如climate.living_room设备Device属于某台设备的所有climate实体区域Area某个房间/区域内的所有climate实体楼层Floor某个楼层上的所有climate实体标签Label共享某个标签的所有climate实体。你还可以在同一个动作中混合选择不同类型的目标。例如将某个具体实体与某个区域同时加入目标动作就会对这两者一并执行。需要提醒的是由于该动作的设置会影响整个恒温器的所有分区即使你的目标仅指定了其中一个分区实体其余分区的除湿行为也会一并改变。这是 Nexia 恒温器硬件层面的联动特性。与其他 Nexia 动作的配合使用该动作在官方文档中与其他三个 Nexia 动作互为相关动作见 related actions 配置 中的related_actions字段它们共同构成了完整的室内空气质量与舒适度控制方案相关动作作用取值范围nexia.set_humidify_setpoint设置加湿设定点10–45百分比nexia.set_aircleaner_mode设置空气净化模式auto、quick、allergynexia.set_hvac_run_mode设置 HVAC 运行模式视设备支持的模式而定这些动作同样作用于整个恒温器影响所有分区且都属于 climate 域实体的控制动作可以放在同一个自动化中按季节或时段组合调度。例如在冬季调用nexia.set_humidify_setpoint将加湿目标设为 35%在夏季调用nexia.set_dehumidify_setpoint将除湿目标设为 50%并配合nexia.set_aircleaner_mode切换到allergy模式应对过敏季节。集成背景与底层要点从 Nexia/American Standard/Trane 集成文档 可以看到该动作所依托的集成环境集成类型hub 类型通过云轮询Cloud Polling与制造商网络服务通信ha_release为 0.108支持通过 DHCP 自动发现。气候平台该集成通过climate平台暴露恒温器控制能力本文所述动作正是围绕 climate 实体如climate.downstairs提供的扩展控制。支持的型号Trane 的XL1050、XL850、XL824官方支持American Standard 的AZONE1050、AZONE850、ACONT824已有报告可用XL624、XL950、AZONE950、AZEMT500、AZEMT400B等型号不受支持其他型号未经过测试。相关传感器集成会为每台恒温器提供 Relative Humidity相对湿度传感器可作为自动化中判断何时调整除湿设定点的输入同时还提供 Air Cleaner Mode、System Status 等传感器帮助你确认动作是否按预期生效。此外从版本发布说明见 2022.6 发布说明可知该集成后续移除了非标准的humidify_supported和dehumidify_supported属性因为设备是否支持这些功能可以通过dehumidify_setpoint等属性是否存在来推断。这一实现细节意味着如果你的恒温器不支持除湿功能相关实体上不会暴露dehumidify_setpoint属性调用本动作自然也不会生效因此在自动化中建议先通过属性存在性判断设备能力。常见注意点全分区生效设置影响同一台恒温器的所有分区即使目标只指向其中一个分区实体。取值范围humidity必须为 35–65 之间的整数百分比超出范围的值可能被设备拒绝或忽略。必填字段target与humidity均为必填项。设备能力限制仅支持除湿功能的恒温器型号才可使用本动作不支持时请先检查实体是否具备dehumidify_setpoint相关属性。以上要点均可在 动作参考文档 及其配套的 UI/YAML 文档片段UI 使用说明、YAML 使用说明、目标说明中找到依据。配置完成后建议在自动化中先以单个分区实体为目标测试取值再逐步推广到区域或设备级目标确保除湿策略符合整屋的舒适度预期。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考