home-assistant.io/source/_components/device_tracker.meraki.markdown
Louis Orleans b3288f13cd Add specific instructions for Meraki device tracker (#5297)
* 📝 add specific instructions for Meraki device tracker

The current instructions aren't really complete, and require you to have both an understanding of how the Home Assistant API works, as well as be able to read through the code for the Meraki component to find the API endpoint you're supposed to use.

* Update formatting
2018-05-03 21:00:02 +02:00

1.5 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 Meraki Instructions on how to integrate Meraki-based presence detection into Home Assistant. 2017-11-22 08:00 true false true true meraki.png Presence Detection 0.60

Use your Meraki AP as device tracker. Note that Meraki will see all devices, not only connected to the network.

{% linkable_title Prerequisites %}

  1. Go to Network-wide/General page, and find the Location and scanning section.
  2. Make sure analytics and Scanning API are both enabled.
  3. Make note of the Validator string, which will be used in the device_tracker configuration.
  4. Click Add a Post URL:
  5. Set the Post URL to https://YOUR_HOSTNAME/api/meraki?api_password=YOUR_HASS_PASSWORD
  6. Set the Secret to a randomly generated string, and make note of it for the device_tracker configuration.
  7. Make sure the API Version is set to 2.0.
  8. Hit Save in the bottom right of the page.

{% linkable_title Configuration %}

After you configure access to the Meraki CMX API, add the following to your configuration.yaml file:

# Example configuration.yaml entry
device_tracker:
  - platform: meraki
    secret: your_secret
    validator: meraki_validator

{% configuration %} secret: description: Secret code added in Meraki. required: true type: string validator: description: Validation string from Meraki. required: true type: string {% endconfiguration %}