Huawei LTE Routers


The Huawei LTE router integration for Home Assistant allows you to observe and control Huawei LTE routers.

There is currently support for the following device types within Home Assistant:

All platform requires you to have set up the Huawei LTE component.

Configuration

To enable the component, add the following lines to your configuration.yaml file:

# Example configuration.yaml entry
huawei_lte:
  - url: http://192.168.100.1/
    username: YOUR_USERNAME
    password: YOUR_PASSWORD

Configuration Variables

url

(string)(Required)

URL of the router web interface.

username

(string)(Required)

The username used for the router web interface.

password

(string)(Required)

The password used for the router web interface.

Tested routers

Routers we know to be working with this integration based on the documentation of used libraries and reports by users:

  • Huawei B310s-22
  • Huawei B525s-23a
  • Huawei E5186s-22a
  • Huawei B618

This is not a complete list. The integration can probably connect to other Huawei LTE routers running similar firmware.

Presence Detection

This platform offers presence detection by looking at connected devices to a Huawei LTE router.

To enable the sensor, add the following lines to your configuration.yaml file:

# Example configuration.yaml entry
device_tracker:
  - platform: huawei_lte

See the device tracker integration page for instructions how to configure the people to be tracked.

Notifications

The huawei_lte platform allows you to use a Huawei LTE router for notifications from Home Assistant. The messages will be sent as SMS text messages.

# Example configuration.yaml entry
notify:
  - platform: huawei_lte
    recipient: "+15105550123"

Configuration Variables

recipient

(string | list)(Required)

The phone number of a default recipient or a list with multiple recipients.

name

(string)(Optional)

Setting the optional parameter name allows multiple notifiers to be created. The notifier will bind to the service notify.NOTIFIER_NAME.

Default value:

notify

url

(string)(Optional)

The router to use. Not needed if you only have one.

To use notifications, please see the getting started with automation page.

Sensor

The huawei_lte sensor platform allows you to monitor Huawei LTE routers.

The names for the item you want to monitor are dot separated paths to information returned by the router. The data set varies by router model. To see what your router provides, set logging level to debug and watch homeassistant.components.huawei_lte debug entries. The configuration variable description contains a few example paths just to illustrate the syntax. These may not be available on all routers or their semantics may differ, and there are quite likely many more that are not listed here.

To enable the sensor, add the following lines to your configuration.yaml file:

# Example configuration.yaml entry
sensor:
  - platform: huawei_lte
    monitored_conditions:
      - device_information.SoftwareVersion
      - device_signal.rssi
      - monitoring_traffic_statistics.CurrentDownloadRate
      - monitoring_traffic_statistics.TotalConnectTime

Configuration Variables

monitored_conditions

(list)(Optional)

Defines the data to monitor as sensors. Defaults to a few generally available data items expected to be available on most boxes.

Default value:

Below is indicated which conditions are the default.

device_information.SoftwareVersion

Software version.

device_information.WanIPAddress

WAN interface IPv4 address.

Default value:

default

device_information.WanIPv6Address

WAN interface IPv6 address.

device_signal.rsrq

The signal RSRQ value.

Default value:

default

device_signal.rsrp

The signal RSRP value.

Default value:

default

device_signal.rssi

The signal RSSI value.

Default value:

default

device_signal.sinr

The signal SINR value.

Default value:

default

monitoring_traffic_statistics.CurrentDownloadRate

Current download rate, bytes/sec.

monitoring_traffic_statistics.CurrentUploadRate

Current upload rate, bytes/sec.

monitoring_traffic_statistics.TotalUpload

Total bytes uploaded since last reset.

monitoring_traffic_statistics.TotalDownload

Total bytes downloaded since last reset.

monitoring_traffic_statistics.TotalConnectTime

Total time connected since last reset.