Ping Sensor Plugin

From MiOS
(Difference between revisions)
Jump to: navigation, search
m
 
(14 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
[[Category:Plugins]]
 +
[[Category:3rd Party]]
 
= 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  =
  
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 "RepetitionDelay" 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.  
  
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.
+
Use the Arm / Bypass buttons to activate/deactivate your sensor
  
The "Present" field shows to you, if the pinged device is reachable ("1") or not ("0")
+
The field "Tripped" and the red/green circle shows you, if your observed network device is reachable or not.
  
 
= Installation  =
 
= Installation  =
Line 15: Line 17:
 
To install and configure the sensor do the following steps:  
 
To install and configure the sensor do the following steps:  
  
#Download the ZIP file containing the device definitions from [http://forum.micasaverde.com/index.php?action=dlattach;topic=1997.0;attach=205 here]  
+
#Download the ZIP file containing the device definitions from [http://forum.micasaverde.com/index.php?action=dlattach;topic=1997.0;attach=274 here]  
#Unzip the file to harddisk. The following files are contained:<br><sub>D_PingSensor.xml</sub><br><sub>I_PingSensor.xml<br>S_PingConfig.xml<br>S_AwarenessSensor.xml</sub>  
+
#Unzip the file to harddisk. The following files are contained:<br><sub>D_PingSensor.xml</sub><br><sub>D_PingSensor_Invert.xml</sub><br><sub>I_PingSensor.xml<br>S_PingSensor.xml<br>S_AwarenessSensor.xml<br>I_AwarenessSensor.xml</sub>  
 
#Goto&nbsp;''Devices''&nbsp;--&gt;&nbsp;''Luup plugins''&nbsp;--&gt;&nbsp;''Luup files''  
 
#Goto&nbsp;''Devices''&nbsp;--&gt;&nbsp;''Luup plugins''&nbsp;--&gt;&nbsp;''Luup files''  
#click the '''(Browse)''' buttons on the right, and enter the 4 filenames references above.  
+
#click the '''(Browse)''' buttons on the right, and enter the 6 filenames referenced above.  
 
#Select the checkbox "[x] Restart Luup after upload" and click '''(Go)'''  
 
#Select the checkbox "[x] Restart Luup after upload" and click '''(Go)'''  
 
#... wait whilst it uploads and restarts the Lua engine ...  
 
#... wait whilst it uploads and restarts the Lua engine ...  
#If successful, you'll see the 4x files listed in the system.  
+
#If successful, you'll see the 6x files listed in the system.  
 
#Navigate to ''Devices --&gt; Luup plugins'', scroll to the bottom at the Add device form.  
 
#Navigate to ''Devices --&gt; Luup plugins'', scroll to the bottom at the Add device form.  
#Type "<sub>D_PingSensor.xml</sub>", and click (Add Device), type in a name of your choice against the device then click '''(Save)'''  
+
#Type "<sub>D_PingSensor.xml</sub>" if you're going to use the normal mode or type&nbsp;"<sub>D_PingSensor_Invert.xml</sub>" if you plan to use the inverted mode, afterwards click '''(Add Device)''', type in a name of your choice against the device then click '''(Save)'''  
 
#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 "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 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 "Present" can you see, if your remote device is available ("1") or not ("0")  
+
#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 =
 +
 
 +
== Version 1.4 ==
 +
 
 +
*Removed some inconsistency in I_AwarenessSensor.xml
 +
 
 +
== Version 1.3  ==
 +
 
 +
*invert red/green circle by configuration
 +
*renamed scene events and result description ("Got response?" -&gt; "Device responded") to describe the actions more appropriate
 +
 
 +
== 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)  
 
*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  
 
*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")  
 
*Active / Inactive Buttons (even this should work similar to the motion sensors "Armed" and "Bypass")  
*Show up as a sensor in the scene-events.  
+
*Show up as a sensor in the scene-events.<br>
*A custom icon should be displayed instead of the na.gif<br>
+
 
 +
*Device is now completely controlable via UPnP function calls
 +
 
 +
<br>  
 +
 
 +
== Version 1.0  ==
 +
 
 +
*a new device was born
 +
*this version was quite unusable in practice. It could be used to learn from&nbsp;;)
 +
 
 +
= Known issues  =
  
*Invoked UPnP functions have no effect.
+
*A custom icon should be displayed instead of the na.gif -&gt; No chance at the moment (Luup .939). The standard motion sensor icon will show up.
  
 
= Discussion  =
 
= Discussion  =

Latest revision as of 20:55, 17 April 2010

Contents

[edit] 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.

[edit] 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.

[edit] 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
    D_PingSensor_Invert.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 6 filenames referenced 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 6x 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" if you're going to use the normal mode or type "D_PingSensor_Invert.xml" if you plan to use the inverted mode, afterwards 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! :)

[edit] Changelog

[edit] Version 1.4

  • Removed some inconsistency in I_AwarenessSensor.xml

[edit] Version 1.3

  • invert red/green circle by configuration
  • renamed scene events and result description ("Got response?" -> "Device responded") to describe the actions more appropriate

[edit] 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.

[edit] 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


[edit] Version 1.0

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

[edit] Known issues

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

[edit] 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