= Motion Sensor Plugin for the !VistaCam =

This plugin adds support for the !VistaCam motion detection, creating a motion sensor that is tripped when the !VistaCam sends a 'motion detected' notification.

== UI Compatibility ==

This plugin is compatible with both UI4 and UI5.

== Installation ==

=== UI4 ===

1. Download these files:
 * [http://code.mios.com/trac/mios_vistacam/export/15/tags/1.21/I_VistaCamMS.xml I_VistaCamMS.xml]
 * [http://code.mios.com/trac/mios_vistacam/raw-attachment/wiki/WikiStart/D_DigitalSecurityCamera1.xml D_DigitalSecurityCamera1.xml]
2. Upload both files on Vera:
 1. On the Vera UI, in the ''Toolbox'' section, open ''MiOS Developers'' >> ''Luup Files''.
 2. Upload the files.
 3. Uncheck ''Restart Luup after upload''.
 4. Click ''GO''.
3. Set the camera to use the '''I_VistaCamMS.xml''' file as the implementation file:
 1. On the Vera UI open the camera's control panel (click on the wrench).
 2. On the ''Advanced'' tab, in the '''impl_file''' field enter ''I_VistaCamMS.xml''
 3. Close the control panel.
4. Save.
5. '''Motion detection is disabled by default.''' To enable it open the ''Advanced'' tab of the camera device and scroll down to the ''State'' field. ''-1'' means that it's disabled. To enable it set it to ''0''.

=== UI5 ===

1. Install the !VistaCam Motion Sensor plugin.
2. On the Vera UI open the camera's control panel (click on the wrench).
3. On the ''Advanced'' tab:
 * In the '''impl_file''' file field enter ''I_VistaCamMS.xml''
 * In the '''device_file''' field change the value from ''D_DigitalSecurityCamera'''1'''.xml'' to ''D_DigitalSecurityCamera'''2'''.xml'' (newer plugin versions do this automatically)
4. Close the control panel.
5. Save.
6. '''IMPORTANT''': Motion detection is disabled by default. To enable it, open the ''Advanced'' tab of the camera device and scroll down to the ''State'' field. ''-1'' means that it's disabled. To enable it set it to ''0''.

== Configuration ==

These parameters can be modified in the '''motion sensor''''s control panel, in the ''Advanced'' tab: 

|| '''!OnTime''' || The number of seconds the plugin hasn't received any notification from the camera after which the device will become ''Untripped''. The default is 1200 seconds (20 minutes). The reason for this big value is to prevent sending too many notifications. With this value, there will be '''at most''' one notification every 20 minutes. ||
|| '''embedded''' || By default this checkbox is checked, which means that moving the camera to a different room will also move the motion sensor, so the motion sensor will always be in the same room as the camera. To prevent this from happening uncheck this checkbox and save. ||

== Troubleshooting ==

* '''ERROR''': Missing camera IP address
 * '''SOLUTION''': Enter the correct camera IP address and port (or the camera's URL if it's not in the same network as Vera, in the '''ip''' field in the camera's ''Advanced'' tab. (e.g. ''192.168.81.24:8080'' or ''www.myserver.com/myipcam:8080'')

* '''ERROR''': Missing Gateway IP address
 * '''SOLUTION''': Enter the Vera IP address and port (or the URL if it's not in the same network as the camera) in the '''!GatewayAddress''' field in the camera's ''Advanced'' tab. (e.g. ''192.168.81.1'' or ''www.myserver.com/myvera'')

* '''ERROR''': Failed to configure the camera.
 * '''SOLUTION''': This error can occur for several reasons:
 1. The camera's IP address and port (or URL) is not correct.
 2. The camera's username and/or password are not correct.
 3. The camera's username and password are not of an admin account.
{{{
#!div style="font-weight: bold; color: red"
The plugin requires an admin account to configure the camera.
}}}