2.7 KiB
| title | description | ha_category | ha_release | ha_domain | ha_iot_class | ha_platforms | ha_integration_type | ha_quality_scale | ||
|---|---|---|---|---|---|---|---|---|---|---|
| Tomato | Instructions on how to integrate Tomato routers into Home Assistant. |
|
pre 0.7 | tomato | Local Polling |
|
integration | legacy |
The tomato device tracker integration allows one to tracker devices which are
connected to a wireless router that is running Tomato
as firmware.
Because of a limitation in Tomato's API, this integration will only track wireless devices.
This integration is confirmed to be working with FreshTomato 2020.8 and may also be working with AdvancedTomato.
Setup
The integration requires an extra configuration variable called http_id. The
value can be obtained by logging in to the Tomato admin interface and search for
http_id in the page's source code.
Configuration
To use this device tracker in your installation,
add the following to your {% term "configuration.yaml" %} file:
# Example configuration.yaml entry
device_tracker:
- platform: tomato
host: YOUR_ROUTER_IP_ADDRESS
username: YOUR_ADMIN_USERNAME
password: YOUR_ADMIN_PASSWORD
http_id: YOUR_HTTP_ID
{% configuration %}
host:
description: "The IP address or hostname of your router, e.g., 192.168.1.1 or rt-ac68u."
required: true
type: string
port:
description: "The port number of your router, e.g., 443."
required: false
type: integer
default: 80/443 (automatically detected)
ssl:
description: "Whether to connect via https."
required: false
type: boolean
default: false
verify_ssl:
description: "If SSL verification for HTTPS resources needs to be turned off (for self-signed certs, etc.) this can take on boolean values false or true or you can pass a location on the device where a certificate can be used for verification e.g., /mnt/NAS/router_cert.pem."
required: false
type: [string, boolean]
default: true
username:
description: "The username of a user with administrative privileges, usually admin."
required: true
type: string
password:
description: "The password for your given admin account."
required: true
type: string
http_id:
description: "The value of http_id."
required: true
type: string
{% endconfiguration %}
See the device tracker integration page for instructions how to configure the people to be tracked.
SSL Certificate
Gathering the SSL Certificate of your router can be accomplished with this (or a similar) command:
openssl s_client -showcerts -connect 172.10.10.1:443 </dev/null 2>/dev/null | openssl x509 -outform PEM > router_cert.pem