home-assistant.io/source/_components/device_tracker.tomato.markdown
Alok Saboo 1aca7b08cf Misc fixes: e.g. -> e.g., and proper case for Home Assistant (#4942)
* e.g. to e.g., and proper case for Home Assistant

* Instructions how to -> Instructions on how to
2018-03-17 20:20:37 +01:00

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