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.
Presence Detection
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