Home Assistant 中使用 netgear_lte.connect_lte 动作实现有线断网时的 LTE 自动接管【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.ionetgear_lte.connect_lte是 Home Assistant 的NETGEAR LTE集成集成文档提供的一个动作action用于命令 NETGEAR LTE 调制解调器主动建立 LTE 移动网络连接。本指南围绕该动作的完整文档动作文档展开讲解其 UI 操作、YAML 参数、常见自动化场景如有线断网时自动切换 LTE 的故障转移并补充disconnect_lte、set_option、delete_sms等配套动作与netgear_lte_sms事件的使用要点读完即可在自动化或脚本中直接落地。动作概述与适用场景Connect LTE动作的作用是要求 NETGEAR LTE 调制解调器建立 LTE 连接。根据官方文档描述这在调制解调器没有自行建立连接时非常有用典型场景包括作为**故障转移failover**手段当有线宽带中断时通过自动化命令调制解调器切换到移动网络在特定时段或条件下按需拉起移动网络例如仅在离家时启用移动数据配合netgear_lte.set_option动作的autoconnect参数。该动作属于netgear_lte域动作标识符为netgear_lte.connect_lte。它在文档中与以下动作被标记为关联动作可组合使用netgear_lte.disconnect_lte关闭 LTE 连接适合有线网络恢复后切回netgear_lte.set_option设置调制解调器的连接选项failover 模式、auto-connect 模式netgear_lte.delete_sms删除调制解调器收件箱中的短信。前置条件先完成 NETGEAR LTE 集成配置connect_lte动作依赖NETGEAR LTE集成已正确配置。该集成自 Home Assistant 0.72 起提供属于device类型集成支持Config Flow界面化配置IoT 类别为Local Polling本地轮询提供binary_sensor、notify、sensor三类平台详见集成文档。集成支持的能力包括通过 SMS 发送通知长短信自动拆分不支持普通消息最多 70 字符使用精简 GSM-7 字符集的消息最多 160 字符大多数 emoji 不支持通过netgear_lte_sms事件上报收到的短信通过多个 sensor 与 binary sensor 上报调制解调器与连接状态。配置完成后集成会创建一个notify动作名称与集成条目名一致默认是设备型号名。调制解调器的连接控制即connect_lte系列动作从版本 0.93 开始加入见 2019-05-16 release-93 发布说明disconnect_lte动作则在 0.98 中加入见 2019-08-28 release-98 发布说明。从用户界面调用动作按官方文档的操作步骤从自动化或脚本中连接调制解调器进入设置自动化与场景打开一个现有的自动化或脚本新建则选择创建自动化创建新自动化如果是新建自动化在When何时部分添加触发器脚本不需要触发器它们由其他内容调用时运行在Then do怎么做部分选择添加动作在搜索框中搜索并选择NETGEAR LTE: Connect LTE如果配置了多台调制解调器在Host字段中输入需要建立连接的那台主机的地址选择保存。需要注意该动作不支持 targets目标选择器。在 UI 中通过Host字段选择调制解调器而不是通过选择区域、设备、实体或标签。当只配置了一台调制解调器时Host 可以留空。UI 选项选项说明是否必填Host需要建立连接的调制解调器仅配置一台时可省略否在 YAML 中使用该动作如果直接编写 YAML动作引用名称为netgear_lte.connect_lte。基础示例如下action: netgear_lte.connect_lte data: host: 192.168.5.1上面的示例请求指定主机192.168.5.1上的调制解调器建立 LTE 连接。YAML 参数字段类型必填说明hoststring否需要建立连接的调制解调器仅配置一台调制解调器时可省略实战自动化有线网络中断时自动拉起 LTE官方文档给出了一个完整的故障转移自动化示例当连接状态传感器报告有线网络断开时命令调制解调器通过 LTE 建立连接。触发器连接状态传感器关闭binary_sensor.internet_connection变为off动作NETGEAR LTE: Connect LTE完整 YAML 如下automation: alias: LTE failover on internet loss triggers: - trigger: state entity_id: binary_sensor.internet_connection to: off actions: - action: netgear_lte.connect_lte data: host: 192.168.5.1entity_id此处为binary_sensor.internet_connection需要替换为你实际的有线连接状态传感器实体。如果只配置了一台调制解调器data.host可以省略。配套动作完整的有线/LTE 自动切换方案单靠connect_lte只能建立连接。结合配套动作可以构成完整的双向切换方案。有线恢复后断开 LTEnetgear_lte.disconnect_lte动作文档用于要求调制解调器关闭 LTE 连接例如在有线网络恢复后切回。其参数与connect_lte完全一致host可选automation: alias: Drop LTE when internet returns triggers: - trigger: state entity_id: binary_sensor.internet_connection to: on actions: - action: netgear_lte.disconnect_lte data: host: 192.168.5.1按场景调整调制解调器连接策略netgear_lte.set_option动作文档可以修改调制解调器的连接选项等价于在调制解调器 Web 管理界面中配置。它支持两个参数至少设置其中一个failover故障转移模式取值wire仅有线、mobile仅移动网络、auto有线连接故障时转移至移动网络autoconnect自动连接模式取值never从不自动连接、home仅不在漫游时连接、always始终连接。例如离家时让调制解调器始终连接automation: alias: Mobile data only while away triggers: - trigger: state entity_id: person.me to: not_home actions: - action: netgear_lte.set_option data: host: 192.168.5.1 autoconnect: always收到短信后的联动集成文档还提供了通过netgear_lte_sms事件处理来电短信的示例事件数据包含host接收短信的调制解调器、sms_id收件箱 ID、from发送者、message短信内容可结合conversation.process处理内容并用netgear_lte.delete_sms删除短信集成文档示例。验证动作与排查无需编写 YAML 即可验证动作效果进入设置工具动作Actions搜索netgear_lte.connect_lte填写字段后点击执行动作Perform action即可在真实实体上观察连接是否建立。该方式同样适用于disconnect_lte与set_option便于在写自动化之前先确认调制解调器的响应行为。需要留意的前提与限制动作通过本地轮询与调制解调器交互ha_iot_class: Local Polling因此调制解调器必须处于 Home Assistant 可达的网络中且地址与配置时一致本动作只负责发起连接请求最终是否连接成功取决于调制解调器本身的状态与网络环境如是否处于漫游、是否有可用信号多调制解调器场景下host必须显式指定否则无法确定目标设备单调制解调器场景下省略host即可。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考