From 2539c93783e94f5c00e35d96a94df231b7276a3a Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Mon, 11 May 2015 18:05:46 +0200 Subject: [PATCH] update header --- .../components/device_tracker/luci.py | 37 ++++++++++++++++++- 1 file changed, 36 insertions(+), 1 deletion(-) diff --git a/homeassistant/components/device_tracker/luci.py b/homeassistant/components/device_tracker/luci.py index 637c48ddf26..6ff3d996a47 100644 --- a/homeassistant/components/device_tracker/luci.py +++ b/homeassistant/components/device_tracker/luci.py @@ -1,4 +1,39 @@ -""" Supports scanning a OpenWRT router. """ +""" +homeassistant.components.device_tracker.luci +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Device tracker platform that supports scanning a OpenWRT router for device +presence. + + +It's required that the luci RPC package is installed on the OpenWRT router: +# opkg install luci-mod-rpc + +Configuration: + +To use the Luci tracker you will need to add something like the following +to your config/configuration.yaml + +device_tracker: + platform: luci + host: YOUR_ROUTER_IP + username: YOUR_ADMIN_USERNAME + password: YOUR_ADMIN_PASSWORD + +Variables: + +host +*Required +The IP address of your router, e.g. 192.168.1.1. + +username +*Required +The username of an user with administrative privileges, usually 'admin'. + +password +*Required +The password for your given admin account. +""" import logging import json from datetime import timedelta