Custom Integration: ZyXEL routers

arobaZ · April 23, 2025, 7:20pm

Hi

I just made an integration for ZyXEL devices. If you don’t know, they make network hardware like routers, switches etc.

The integration was built for, and tested on, a ZyXEL NR7101 which is a 5G modem/router. It will likely work on other devices if they share the same API.

ddaniel · April 23, 2025, 7:22pm

I don’t use this router or their firmware, but I just want to say thank you for making this.

KameDomotics · May 1, 2025, 2:33pm

Hi!
I would like to ask you a question to you who use this router.

You can send SMS from Home Assistant via shell_command.

I have a Teltonika router, and from Home Assistant via a shell command I can send an SMS from the 4G router to my smart phone (for example if Alarmo is triggered, Home Assistant tells the router to send an SMS to me)

Thanks

arobaZ · May 4, 2025, 10:05am

Hi! Sorry, what is the question? You want to know if it is possible to send SMS with this brand/model of router?
I don’t know, but I don’t think so. I don’t see this option anywhere in the router’s interface.

KameDomotics · May 4, 2025, 11:41am

Yes, I wanted to know if the router could send SMS message, and if there was a command from Home Assistant to send SMS from the router.

davideciarmiello · May 26, 2025, 10:19am

You can send and receive sms, but with SSH directly on router.
Read this, point 7

gist.github.com

https://gist.github.com/theodric/c8f280ead3b5ae1b4b1d6c4cf2d9420e?permalink_comment_id=4667388

zyxel_nr7101_setup_hacks_tips_and_tweaks.txt

0. Don't have a SIM card in when you're updating radio firmware or it will bomb out partway through as it changes from internal IP to IP passthrough

1. Disable external IP passthrough mode: Network Setting -> Broadband -> Cellular APN -> #1 -> Modify icon -> "IP Passthrough" slider to off

2. Use "management" Wi-Fi AP as general Wi-Fi AP (with limitations) -> Network Setting -> Bridge1 -> Modify icon -> Move the Wi-Fi AP interface to the pane on the right alongside LAN1
NOTE: by default, once you do the above, the router will happily pass traffic from devices on the Wi-Fi AP to other devices on the LAN1 subnet, but will block traffic originating from the Wi-Fi AP from exiting to the Internet via the LTE side of the device. You can clumsily hack around this by setting another device, e.g. another Wi-Fi AP or Raspberry Pi or Cray supercomputer, as the default gateway for the LAN1 subnet in your DHCP server config, and pointing *that* device at the Zyxel as *its* default GW. This adds additional hops, but enables general use of the Zyxel's inbuilt Wi-Fi AP.

3. Supervisor password allows Linux shell login & additional functions.
cf. https://openwrt.org/toh/zyxel/nr7101 "Supervisor password"
summary: get this https://get.dyn.mork.no/zyxel_pwgen.tar.gz [mirror: https://github.com/theodric/pastebin/blob/master/zyxel_pwgen.tar.gz] and run it under qemu with the getsupervisor.sh script and the system serial number. Login ssh [email protected]; password is the string generated by the tool

This file has been truncated. show original

Greek · October 6, 2025, 12:40pm

Nice work, thank you!
Works well.

Greek · October 6, 2025, 2:45pm

You can find the slightly overwhelming list of 465 entities of the FWA710 here:

github.com/zulufoxtrot/ha-zyxel

Wrong list of entities (duplicates)

opened 02:28PM - 06 Oct 25 UTC

closed 02:39PM - 06 Oct 25 UTC

Greentreegarden

bug

**Zyxel device model** FWA710 **Integration version** 0.2.7 **Describe the bug…** Integration shows 465 entities. Are there really this many? If yes, please close the ticket. Some keys come in double pairs, e.g., Zyxel Bytes Received (see screenshot). Maybe, due to the network adaptor? sensor.zyxel_bytes_received sensor.zyxel_bytes_received_2 sensor.zyxel_bytes_received_3 sensor.zyxel_bytes_received_4 Some keys are different, but show the same value (I am a 80% expert in mobile networks: The value makes total sense): Zyxel cardpage.CellIntfInfo.NetworkInUse Zyxel cellular.INTF_Network_In_Use Zyxel device.CellIntfInfo.NetworkInUse Again, if this is correct, please close the ticket. **Expected behavior** The example on https://github.com/pkorpine/nr7101 shows less than 100 entities (even with 3 network adaptors, which also show pairs of values for bytes received and bytes sent). I expect fewer parameters (keys, entities). **To Reproduce** I deleted the integration. Restarted. Installed the integration and provided router credentials again. Samesame. <img width="1011" height="331" alt="Image" src="https://github.com/user-attachments/assets/17c0e751-2fb9-4ac7-a681-0ae7c15cfba3" /> <img width="323" height="440" alt="Image" src="https://github.com/user-attachments/assets/1387657f-934b-4343-a924-9e4ff7196708" /> Thanks!

Greek · October 6, 2025, 5:20pm

In case someone wants to get playful with RSRP, RSRQ, and SINR:

I found these 4 entities useful (there are more RSRP, RSRQ, etc. but they don’t show values). Use this HA “Statistics graph card” to visualize them:

chart_type: line
period: 5minute
title: RSRP, RSRQ and SINR (de-select 3 of 4 for useful viewing!)
type: statistics-graph
entities:
  - sensor.zyxel_cellular_reference_signal_received_power
  - sensor.zyxel_cellular_reference_signal_received_quality
  - sensor.zyxel_cellular_signal_to_noise_ratio
  - sensor.zyxel_nsa_signal_to_noise_ratio
stat_types:
  - mean
  - min
  - max
days_to_show: 1
grid_options:
  columns: 36
  rows: auto

The 2 SINR seem to tell different stories.

Use these 2 HA Gauge cards to visualise RSRP and RSRQ:
My source: RSRP and RSRQ - Teltonika Networks Wiki

type: gauge
entity: sensor.zyxel_cellular_reference_signal_received_power
needle: true
segments:
  - from: -120
    color: red
  - from: -100
    color: orange
  - from: -90
    color: yellow
  - from: -80
    color: green
max: -70
min: -120

type: gauge
needle: true
segments:
  - from: -25
    color: red
  - from: -20
    color: orange
  - from: -15
    color: yellow
  - from: -10
    color: green
max: -5
min: -25
entity: sensor.zyxel_cellular_reference_signal_received_quality

Jerry71 · November 11, 2025, 7:35am

Hi,

I’m just a beginner at ha and would like to ask a question. I use 5 Zyxel Access Points, they are configured with nebula cloud (control center). So I have a login for the cloud, but not an IP oder Login for a host. How can I use the integration?

Help very much appeciated,
Gerd

arobaZ · November 11, 2025, 8:07am

It won’t work with Nebula credentials.
I don’t know how Nebula works, but surely there is a way to connect locally?
What is written on the back of your devices?

Greek · December 21, 2025, 12:13pm

Hi Gerd,

Finding IP addresses in your network: Try SoftPerfect Network Scanner : fast, flexible, advanced

As arobaZ says: The default local login is on the backside of the device.
Pray that someone else did not change them.

When you set up the account at Nebula, you choose to either keep this local login or use the Nebula cloud credentials.

I am using Nebula cloud, the cloud credentials, and HA Zyxel integration. It works.

As I understand it, if local credentials are used and someone changed them, you will have to hard-reset the device to make the backside-printed admin/passwd re-appear.

Hard-resetting will reset any DHCP and whatever other settings. To be avoided, if you can. Installing my Zyxel FW710 antenna with router is a nightmare.

Greek