
* e.g. to e.g., and proper case for Home Assistant * Instructions how to -> Instructions on how to
2.7 KiB
layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release
layout | title | description | date | sidebar | comments | sharing | footer | logo | ha_category | ha_release |
---|---|---|---|---|---|---|---|---|---|---|
page | Tomato | Instructions on how to integrate Tomato routers into Home Assistant. | 2015-03-23 19:59 | true | false | true | true | tomato.png | Presence Detection | pre 0.7 |
The tomato
platform requires an extra config 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: false
type: string
port:
description: "The port number of your router, e.g., 443
."
required: false
type: int
default: 80/443 (automatically detected)
ssl:
description: "Whether to connect via https
."
required: false
type: bool
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, bool]
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 component 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