= Foscam IP Camera Plugin =

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

__Note__: Presets are supported starting with MiOS firmware version 1.5.390.

'''__Note__: The motion detection part of the plugin works only with the Foscam cameras.''' If you use the plugin with other cameras only for the pan and tilt functionality, follow the instructions below to disable the motion sensor.

== Installation ==

=== UI5 ===
1. Go to ''Apps'' >> ''Install Apps'' and install the plugin. Alternatively, you can install it from apps.mios.com.
2. In the camera's ''Advanced'' tab enter ''I_FoscamPTZ.xml'' in the '''impl_file''' field.
3. Save.

=== UI4 ===
1. Download [http://code.mios.com/trac/mios_foscam-camera/changeset/12/tags/2.2?old_path=%2F&format=zip this] file on your computer and extract ''I_FoscamPTZ.xml'' from the archive.
2. Upload ''I_FoscamPTZ.xml'' on Vera from ''MiOS Developers'' >> ''Luup files''.
3. In the camera's ''Advanced'' tab enter ''I_FoscamPTZ.xml'' in the '''impl_file''' field.
4. Save.

== 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. ''192.168.81.123:8001'' or ''camera.myserver.com'')
2. The camera's username and password
3. The Vera IP address or URL (e.g. ''192.168.81.1'' or ''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>
}}}

=== To disable the motion detection feature of the plugin ===

1. Open the ''Advanced'' tab in the camera's control panel.
2. Scroll to the bottom to find the ''ConfiguredMD'' variable.
3. Set this variable to '''-1'''.
4. Save.

== 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)]]
----
* 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.||
[[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)]]