4.2 KiB
title, description, ha_release, ha_category, ha_iot_class, ha_config_flow, ha_domain, ha_platforms, ha_codeowners, ha_integration_type
title | description | ha_release | ha_category | ha_iot_class | ha_config_flow | ha_domain | ha_platforms | ha_codeowners | ha_integration_type | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NETGEAR LTE | Instructions on how to integrate your NETGEAR LTE modem within Home Assistant. | 0.72 |
|
Local Polling | true | netgear_lte |
|
|
integration |
The NETGEAR LTE integration for Home Assistant allows you to observe and control NETGEAR LTE modems.
There is currently support for the following device types within Home Assistant:
- Notifications
- Sensors
- Binary sensors
The integration supports sending notifications with SMS, reporting incoming SMS with events and reporting the modem and connection state in a number of sensors and binary sensors.
Splitting of long SMS messages is not supported so notifications can contain a maximum of 70 characters. Simple messages using the reduced GSM-7 alphabet can contain up to 160 characters. Most emojis are not supported.
{% include integrations/config_flow.md %}
Notification Service
The integration will create a notify
service matching the name of the integration entry. This is the model name of the device by default.
Events
Event netgear_lte_sms
Messages arriving in the modem inbox are sent as events of type netgear_lte_sms
with the following content.
Event data attribute | Description |
---|---|
host |
The modem that received the message. |
sms_id |
The inbox ID of the received message. |
from |
The sender of the message. |
message |
The SMS message content. |
Services
Service netgear_lte.connect_lte
This service asks the modem to establish its LTE connection, useful if the modem does not autoconnect.
Service data attribute | Optional | Description |
---|---|---|
host |
yes | The modem that should connect (optional when just one modem is configured). |
Service netgear_lte.disconnect_lte
This service asks the modem to close its LTE connection.
Service data attribute | Optional | Description |
---|---|---|
host |
yes | The modem that should disconnect (optional when just one modem is configured). |
Service netgear_lte.delete_sms
The integration makes a service available to delete messages from the modem inbox. This can be used to clean up after incoming SMS events.
Service data attribute | Optional | Description |
---|---|---|
host |
yes | The modem that should have a message deleted (optional when just one modem is configured). |
sms_id |
no | Integer or list of integers with inbox IDs of messages to delete. |
Service netgear_lte.set_option
This service can set modem configuration options (otherwise available in the modem web UI).
Service data attribute | Optional | Description |
---|---|---|
host |
yes | The modem to set options on (optional when just one modem is configured). |
autoconnect |
yes | Autoconnect value: never /home /always , with home meaning "not roaming". |
failover |
yes | Failover mode: wire (wired connection only), mobile (mobile connection only), auto (wired connection with failover to mobile connection). |
Examples
The following automation example processes incoming SMS messages with the Conversation integration and then deletes the message from the inbox.
{% raw %}
automation:
- alias: "SMS conversation"
trigger:
- platform: event
event_type: netgear_lte_sms
action:
- service: conversation.process
data:
text: "{{ trigger.event.data.message }}"
- service: netgear_lte.delete_sms
data:
host: "{{ trigger.event.data.host }}"
sms_id: "{{ trigger.event.data.sms_id }}"
{% endraw %}