Skip to content

Commit 9b25eb8

Browse files
committed
Add binary_sensor and mode explanations
1 parent 3c328f8 commit 9b25eb8

File tree

1 file changed

+37
-4
lines changed

1 file changed

+37
-4
lines changed

source/_integrations/airos.markdown

Lines changed: 37 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,7 @@ A common use-case is establishing wireless point-to-point (PtP) or multi-point-t
2121

2222
There is currently support for the following plaforms within Home Assistant:
2323

24+
- [Binary sensor](#binary-sensor)
2425
- [Sensor](#sensor)
2526

2627
This integration allows users to pull network metrics and statuses directly into their Home Assistant dashboards, enabling advanced automation, notifications, and comprehensive network oversight within their smart home ecosystem.
@@ -35,18 +36,50 @@ This integration only supports devices running airOS 8 and already configured us
3536

3637
{% include integrations/config_flow.md %}
3738

39+
## Operating roles
40+
41+
Depending on the device's placement, it will be configured as either an 'Access Point' (AP) acting as the central device or a 'Station' connecting as a client. An AP can have multiple stations connected to it, whereas a station will only connect to a single AP.
42+
43+
For stations in particular, they can operate in either a 'Bridge' or 'Router' role:
44+
45+
- In 'Bridge' mode, which is the default and most common configuration, the airOS device simply bridges the wireless and Ethernet connections. In simplistic terms, it functions as a transparent network cable, making it invisible to the devices on both the station and AP sides.
46+
47+
- In 'Router' mode, the airOS device acts as a small router, performing Network Address Translation (NAT) as well as providing DHCP services for devices connected to its LAN port. The airOS device in this mode can also operate as a PPPoE client, authenticating with a central PPPoE server to receive its IP address, gateway, and other network settings.
48+
3849
## Supported devices
3950

40-
### airOS 8
51+
### airOS firmware 8
4152

42-
While there is no known limitation to which devices running airOS 8 are supported, success has been reported on:
53+
While there is no known limitation to which devices running airOS firmware version 8 are supported, success has been reported on:
4354

4455
- PowerBeam 5AC gen2
4556
- Nanostation 5AC (LOCO5AC)
4657

47-
## Sensor
58+
Do you have a device that works? We’d love to hear [your experience](#feedback_section) so we can add it to this list!
59+
60+
## Binary Sensor
61+
62+
### Port Forwarding
63+
64+
Active if any port forwarding is enabled when operating in 'router' mode.
4865

49-
This integration exposes the following sensor entities for your airOS devices:
66+
### DHCP Client
67+
68+
Active if the device configured to use DHCP for it's network settings, inactive if IP address is statically assigned.
69+
70+
### DHCP Server
71+
72+
Active if the device itself is configured as a DHCP server.
73+
74+
### DHCPv6 Server
75+
76+
Active if the device itself is configured as a DHCP server for IPv6.
77+
78+
### PPPoE
79+
80+
Active if the device is configured for PPPoE.
81+
82+
## Sensor
5083

5184
### Network Role
5285

0 commit comments

Comments
 (0)