= 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 this file: [http://code.mios.com/svn/mios_vistacam/tags/1.0/I_VistaCamMS.xml I_VistaCamMS.xml]
2. Upload the file on Vera:
 1. On the Vera UI, in the ''Toolbox'' section, open ''MiOS Developers'' >> ''Luup Files''.
 2. Upload the file.
 3. Uncheck ''Restart Luup after upload''.
 4. Click ''GO''.
3. Set the camera to use that 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''' file field enter ''I_VistaCamMS.xml''
 3. Close the control panel.
4. Save.

=== UI5 ===

1. Install the !VistaCam Motion Detection plugin.
2. Set the camera to use that 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''' file field enter ''I_VistaCamMS.xml''
 3. Close the control panel.
3. Save.

== 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). ||
|| '''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)

* '''ERROR''': Missing MiOS unit 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 '''!MiosUnitAddress''' field in the camera's ''Advanced'' tab.

* '''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.
}}}