Ping Sensor Plugin

From MiOS
(Difference between revisions)
Jump to: navigation, search
(Updated the download link to 1.2)
Line 1: Line 1:
 
= Introduction  =
 
= Introduction  =
  
This Luup-device can ping different IP-based network devices like routers, computers, iPhones, network-printers, even internet sites and so on. [[Image:Ping_sensor.png|thumb|right]]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.<br>
+
This Luup-device can ping different IP-based network devices like routers, computers, iPhones, network-printers, even internet sites and so on. [[Image:Ping sensor.png|thumb|right]]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.<br>  
  
 
= How does it work  =
 
= How does it work  =
Line 7: Line 7:
 
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 [http://en.wikipedia.org/wiki/FQDN FQDN]&nbsp;in the "Address" field and a delay time in seconds when a ping should occur has to be put in the "Period" field.  
 
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 [http://en.wikipedia.org/wiki/FQDN FQDN]&nbsp;in the "Address" field and a delay time in seconds when a ping should occur has to be put in the "Period" field.  
  
Use the Arm / Bypass buttons to activate/deactivate your sensor
+
Use the Arm / Bypass buttons to activate/deactivate your sensor  
  
The field "Tripped" and the red/green circle shows you, if your observed network device is reachable or not.
+
The field "Tripped" and the red/green circle shows you, if your observed network device is reachable or not.  
  
 
= Installation  =
 
= Installation  =
Line 26: Line 26:
 
#After that is done, return again Devices --&gt; Luup plugins and click '''(+)''' Insert the IP or domain name of the device you want to observe in the field "Address"  
 
#After that is done, return again Devices --&gt; Luup plugins and click '''(+)''' Insert the IP or domain name of the device you want to observe in the field "Address"  
 
#Change the value in the field "Period" 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 the value 60)  
 
#Change the value in the field "Period" 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 the value 60)  
#click (Save) in the field "Tripped" can you see, if your remote device is available ("1") or not ("0") or you have a look at the red/green circle.
+
#click (Save) in the field "Tripped" can you see, if your remote device is available ("1") or not ("0") or you have a look at the red/green circle.  
#enjoy!&nbsp;:)<br>
+
#enjoy!&nbsp;:)
  
= Known issues  =
+
= Changelog =
  
*Update the UI on state-change (device becomes visible or unvisible to the plugin) -&gt;solved
+
== Version 1.3 ==
*Display a red / green circle (similar to motion sensors) to indicate the presence of a device -&gt; solved
+
 
*Active / Inactive Buttons (even this should work similar to the motion sensors "Armed" and "Bypass") -&gt; solved
+
*coming soon: invert red/green circle by configuration
*Show up as a sensor in the scene-events. -&gt; solved
+
 
*A custom icon should be displayed instead of the na.gif -&gt; No chance at the moment. The standard motion sensor icon will show up.<br>
+
== Version 1.2 ==
 +
 
 +
*Changed file I_PingSensor.xml
 +
*Now that device acts less "aggressive" when no state change occurs. Formerly it triggered the scene event after every ping. E.g. if you turn a lamp out by hand which is also controlled by the ping sensor It was turned on after every ping again. Now only state changes from "ping -&gt; no ping"&nbsp;''or''&nbsp;"no ping -&gt; ping" fire events.
 +
 
 +
== Version 1.1 ==
 +
 
 +
 
 +
 
 +
*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.<br>
 +
 
 +
*Device is now completely controlable via UPnP function calls
 +
 
 +
 
 +
 
 +
== Version 1.0 ==
 +
 
 +
*a new device was born
 +
*this version was quite unusable in practice. It could be used to learn from ;)
 +
 
 +
= Known issues  =
  
*Invoked UPnP functions have no effect. -&gt; solved (completely controlable by UPnP)
+
*A custom icon should be displayed instead of the na.gif -&gt; No chance at the moment. The standard motion sensor icon will show up.
  
 
= Discussion  =
 
= Discussion  =

Revision as of 20:35, 30 September 2009

Contents

Introduction

This Luup-device can ping different IP-based network devices like routers, computers, iPhones, network-printers, even internet sites and so on.
Ping sensor.png
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 "Period" field.

Use the Arm / Bypass buttons to activate/deactivate your sensor

The field "Tripped" and the red/green circle shows you, if your observed network device is reachable or not.

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_PingSensor.xml
    S_AwarenessSensor.xml
    I_AwarenessSensor.xml
  3. Goto Devices --> Luup plugins --> Luup files
  4. click the (Browse) buttons on the right, and enter the 4 filenames references above.
  5. Select the checkbox "[x] Restart Luup after upload" and click (Go)
  6. ... wait whilst it uploads and restarts the Lua engine ...
  7. If successful, you'll see the 5x files listed in the system.
  8. Navigate to Devices --> Luup plugins, scroll to the bottom at the Add device form.
  9. Type "D_PingSensor.xml", and click (Add Device), type in a name of your choice against the device then click (Save)
  10. After that is done, return again Devices --> Luup plugins and click (+) Insert the IP or domain name of the device you want to observe in the field "Address"
  11. Change the value in the field "Period" 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 the value 60)
  12. click (Save) in the field "Tripped" can you see, if your remote device is available ("1") or not ("0") or you have a look at the red/green circle.
  13. enjoy! :)

Changelog

Version 1.3

  • coming soon: invert red/green circle by configuration

Version 1.2

  • Changed file I_PingSensor.xml
  • Now that device acts less "aggressive" when no state change occurs. Formerly it triggered the scene event after every ping. E.g. if you turn a lamp out by hand which is also controlled by the ping sensor It was turned on after every ping again. Now only state changes from "ping -> no ping" or "no ping -> ping" fire events.

Version 1.1

  • 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.
  • Device is now completely controlable via UPnP function calls


Version 1.0

  • a new device was born
  • this version was quite unusable in practice. It could be used to learn from ;)

Known issues

  • A custom icon should be displayed instead of the na.gif -> No chance at the moment. The standard motion sensor icon will show up.

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.

Personal tools