Revision as of 19:07, 13 September 2009

Introduction

This Luup-device can ping different IP-based network devices like routers, computers, iPhones, network-printers, even internet sites and so on. The result of the ping is being reported to Vera. It's intended to be used as sensor in scenes. So you can trigger scenes if a device (or site) becomes available or unavailable.

How does it work

For every ip you want to observe a own Luup device has to be created. After installation you only have to configure the IP or FQDN in the "Address" field and a delay time in seconds when a ping should occur has to be put in the "RepetitionDelay" field.

The "Active" field is an equivalent to the "Armed" field of motion sensors. It can be used in future releases to let scenes only react on active ping sensors.

The "Present" field shows to you, if the pinged device is reachable ("1") or not ("0")

Installation

To install and configure the sensor do the following steps:

1. Download the ZIP file containing the device definitions from here
2. Unzip the file to harddisk. The following files are contained:
   D_PingSensor.xml
   I_PingSensor.xml
   S_PingConfig.xml
   S_AwarenessSensor.xml
3. Goto Devices --> Luup plugins --> Luup files

Click the (Browse) buttons on the right, and enter the 4 filenames references above.

1. Select the checkbox "[x] Restart Luup after upload" and click (Go)

... wait whilst it uploads and restarts the Lua engine ...

1. If successful, you'll see the 4x files listed in the system.
2. Navigate to Devices --> Luup plugins, scroll to the bottom at the Add device form.
3. Type "D_PingSensor.xml", and click (Add Device), type in a name of your choice against the device then click (Save)
4. After that is done, return again Devices --> Luup plugins and click (+)
5. Insert the IP or domain name of the device you want to observe in the field "Address"
6. Change the value in the field "RepetitionDelay" to change the time in seconds, which Vera waits between two pings. (e.g. you want to ping a host every minute, you would enter 60)
7. click (Save)
8. in the field "Present" can you see, if your remote device is available ("1") or not ("0")
9. enjoy

Technical background

coming soon

Known issues

• Update the UI on state-change (device becomes visible or unvisible to the plugin)
• Display a red / green circle (similar to motion sensors) to indicate the presence of a device
• Active / Inactive Buttons (even this should work similar to the motion sensors "Armed" and "Bypass")
• Show up as a sensor in the scene-events.
• A custom icon should be displayed instead of the na.gif

• Invoked UPnP functions have no effect.<span class="Apple-style-span" style="font-family: verdana, sans-serif; font-size: small; line-height: normal; " />

Discussion

The Ping Sensor plugin is discussed in this forum thread:

http://forum.micasaverde.com/index.php?topic=1997.0

Feel free to ask questions on that thread, as well as make any suggestions & contributions to the future development of the Ping Sensor plugin's functionality.