Netgear: doc for tracking devices on APs, URL support and autodetection (#4958)

This commit is contained in:
Mathieu Velten 2018-05-05 19:06:35 +02:00 committed by Paulus Schoutsen
parent 8187c4aebe
commit 496150eeae

View File

@ -13,7 +13,6 @@ ha_iot_class: "Local Polling"
ha_release: pre 0.7 ha_release: pre 0.7
--- ---
This platform allows you to detect presence by looking at connected devices to a [Netgear](http://www.netgear.com/) device. This platform allows you to detect presence by looking at connected devices to a [Netgear](http://www.netgear.com/) device.
To use this device tracker in your installation, add the following to your `configuration.yaml` file: To use this device tracker in your installation, add the following to your `configuration.yaml` file:
@ -29,10 +28,18 @@ device_tracker:
Configuration variables: Configuration variables:
- **host** (*Optional*): The IP address of your router, e.g., `192.168.1.1`. If not provided `routerlogin.net` will be used. - **url** (*Optional*): The base URL, e.g., `http://routerlogin.com:5000` for example. If not provided `host` and `port` are used. If none provided autodetection of the URL will be used.
- **username** (*Optional*): The username of an user with administrative privileges. If not provided `admin` will be used. - **host** (*Optional*): The IP address of your router, e.g., `192.168.1.1`.
- **port** (*Optional*): The port your router communicates with (defaults to `5000`, but `80` is also known to be used on some models). - **port** (*Optional*): The port your router communicates with.
- **username** (*Optional*): The username of a user with administrative privileges. If not provided `admin` will be used.
- **password** (*Required*): The password for your given admin account. - **password** (*Required*): The password for your given admin account.
- **devices** (*Optional*): If provided only specified devices will be reported. Can be MAC address or the device name as reported in the Netgear UI.
- **exclude** (*Optional*): Devices to exclude from the scan.
- **accesspoints** (*Optional*): Also track devices on the specified APs. Only supports MAC address.
When `accesspoints` is specified an extra device will be reported for each device connected to the APs specified here, as `MY-LAPTOP on RBS40`. `Router` will be reported as AP name for the main AP. Only tested with Orbi.
The use of `devices` or `exclude` is recommended when using `accesspoints` to avoid having a lot of entries.
List of models that are known to use port 80: List of models that are known to use port 80:
- Nighthawk X4S - AC2600 (R7800) - Nighthawk X4S - AC2600 (R7800)