= Foscam IP Camera Plugin =

This plugin offers support for pan, tilt, patrol, presets* and motion detection.

''^*^ Presets are supported starting with MiOS firmware version 1.5.390.''

== Setting up motion detection ==

The plugin needs to know a couple of things to setup motion detection:
1. The camera's IP address and port or URL (e.g. camera.myserver.com)
2. The camera's username and password
3. The Vera IP address or URL (e.g. vera.myserver.com)

The plugin will attempt to find the Vera's IP address automatically based on the camera's IP address. This attempt will be successful only if the camera is on the same network as Vera. In all other cases the Vera's IP address (or URL) must be specified by the user.

'''On firmwares older than 1.5.390 arming and bypassing the motion sensor won't work unless you upload [http://code.mios.com/trac/mios_foscam-camera/raw-attachment/wiki/WikiStart/D_DigitalSecurityCamera1.xml this] file on Vera.''' After you upload the file, you must reload the Luup engine.

{{{
#!html
<p style="font-weight:bold; color:red">
WARNING: the plugin will overwrite the alarm notification URL!
</p>
}}}

== Configurable parameters ==

* These parameters can be modified in the '''camera''''s control panel, in the ''Advanced'' tab:
||'''!StepSize'''||How much the camera will rotate when you send a ''pan'' or ''tilt'' command. Must be a natural number greater than 0.||
||'''!ReverseControls'''||When this parameter is ''1'' the camera controls will be reversed. Useful when you have the camera upside down. Can be ''0'' or ''1''.||
||'''!VeraAddress'''||Enter here the IP address or URL of the Vera.||
[[Image(camera_params.png)]]
----
* This parameter 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).||
[[Image(sensor_params.png)]]

== Getting presets support in post 1.5.390 firmwares ==

All the Foscam camera devices created in pre 1.5.390 firmwares use the device file ''D_DigitalSecurityCamera1.xml'', which doesn't support presets. In firmware 1.5.390 another device file for the camera has been added: ''D_DigitalSecurityCamera2.xml''. To set your camera to use this device file instead of the old one:
1. Open the camera's control panel, ''Advanced'' tab.
2. Find the ''device_file'' field and change it from ''D_DigitalSecurityCamera'''1'''.xml'' to ''D_DigitalSecurityCamera'''2'''.xml''.
3. Save.

{{{
#!html
<p style="font-weight:bold; color:red">
WARNING: Do not change the device file for the camera if your MiOS firmware version is older than 1.5.390!
</p>
}}}

If everything worked OK, the Camera control tab should look like this (the number of preset buttons may vary from firmware to firmware):

[[Image(camera_control.png)]]