2.6 KiB
title, description, ha_category, ha_release, ha_domain
title | description | ha_category | ha_release | ha_domain | |
---|---|---|---|---|---|
Tomato | Instructions on how to integrate Tomato routers into Home Assistant. |
|
pre 0.7 | tomato |
The tomato
platform 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 source code.
Because of a limitation in Tomato's API, this platform will only track wireless devices. If tracking wired devices like a Philips Hue Hub is necessary, it is possible to use another platform like Nmap.
To use this device tracker in your installation,
add the following to your 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 an 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 can be obtained by logging in to the Tomato admin interface and search for http_id
in the page source code."
required: true
type: string
{% endconfiguration %}
See the device tracker integration page for instructions how to configure the people to be tracked.
A description of the API s available in this Tomato API blog post.
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