企业官网建设流程全解析

Home Assistant 中使用 netgear_lte.connect_lte 动作实现有线断网时的 LTE 自动接管

【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io

netgear_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 发布说明）。

从用户界面调用动作

按官方文档的操作步骤，从自动化或脚本中连接调制解调器：

1. 进入设置>自动化与场景；
2. 打开一个现有的自动化或脚本；新建则选择创建自动化>创建新自动化；
3. 如果是新建自动化，在When（何时）部分添加触发器；脚本不需要触发器，它们由其他内容调用时运行；
4. 在Then do（怎么做）部分选择添加动作；
5. 在搜索框中搜索并选择NETGEAR LTE: Connect LTE；
6. 如果配置了多台调制解调器，在Host字段中输入需要建立连接的那台主机的地址；
7. 选择保存。

需要注意：该动作不支持 targets（目标选择器）。在 UI 中，通过Host字段选择调制解调器，而不是通过选择区域、设备、实体或标签。当只配置了一台调制解调器时，Host 可以留空。

UI 选项

在 YAML 中使用该动作

如果直接编写 YAML，动作引用名称为netgear_lte.connect_lte。基础示例如下：

action: netgear_lte.connect_lte data: host: 192.168.5.1

上面的示例请求指定主机（192.168.5.1）上的调制解调器建立 LTE 连接。

YAML 参数

实战自动化：有线网络中断时自动拉起 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.1

entity_id（此处为binary_sensor.internet_connection）需要替换为你实际的有线连接状态传感器实体。如果只配置了一台调制解调器，data.host可以省略。

配套动作：完整的有线/LTE 自动切换方案

单靠connect_lte只能建立连接。结合配套动作，可以构成完整的双向切换方案。

有线恢复后断开 LTE

netgear_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