Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 17 additions & 11 deletions source/_integrations/tomato.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,22 @@ ha_release: pre 0.7
ha_domain: tomato
---

The `tomato` platform requires an extra configuration variable called `http_id`. The
The `tomato` device tracker integration allows one to tracker devices which are
connected to a wireless router that is running [Tomato](https://tomato.groov.pl/)
as firmware.

Because of a limitation in Tomato's API, this integration will only track wireless devices.

It could be that the integration is also working with [AdvancedTomato](https://advancedtomato.com/)
but this was never tested.

## 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 source code.
`http_id` in the page's 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](/integrations/nmap_tracker).
## Configuration

To use this device tracker in your installation,
add the following to your `configuration.yaml` file:
Expand Down Expand Up @@ -57,22 +66,19 @@ password:
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."
description: "The value of `http_id`."
required: true
type: string
{% endconfiguration %}

See the [device tracker integration page](/integrations/device_tracker/) for
instructions how to configure the people to be tracked.

A description of the API s available in this
[Tomato API](https://paulusschoutsen.nl/blog/2013/10/tomato-api-documentation/)
blog post.

SSL Certificate:
## SSL Certificate

Gathering the SSL Certificate of your router can be accomplished with this (or
a similar) command:

```bash
openssl s_client -showcerts -connect 172.10.10.1:443 </dev/null 2>/dev/null | openssl x509 -outform PEM > router_cert.pem
```