NAME

Edimax - Perl extension for managing Edimax IC1500-series network cameras

SYNOPSIS

  use Net::Camera::Edimax::IC1500;
  my $camera = Net::Camera::Edimax::IC1500->new(
    hostname => 'camera.example.com',
    port => '80',
    username => 'admin',
    password => '1234',
  );
  $camera->getImageSettings();
  $camera->imageSettingsResolution(1);
  $camera->setImageSettings();

DESCRIPTION

The Edimax IC1500-series network cameras are managed via a web interface. This module provides methods to control various aspects of the camera's operation.

This module also supports the wireless version (the IC1500Wg), as the interface is essentially identical (insofar as this module was developed using the Wg model)

METHODS

new( hostname => $hostname, port => $port, username => $username, password => $password )

Creates a new Net::Camera::Edimax::IC1500 object.

  my $camera = Net::Camera::Edimax::IC1500->new(
    hostname => 'camera.example.com',
    port => '80',
    username => 'admin',
    password => '1234',
  );

getImageSettings

Gets the current image settings from the camera. This needs to be called before changing any image settings

setImageSettings

Activates the requested image settings.

getSystemSettings

Gets the current system settings. These are currently read-only, so there is no corresponding setSystemSettings.

getStatus

Gets the current status. These are read-only.

getLog

Gets the current entries in the logfile.

getSnapshot

Retrieves a snapshot from the device. The JPEG data is returned directly from this function.

imageSettingsResolution =item imageSettingsResolution( 0|1|2 )

Gets/sets the image resolution. 0 is 640x480, 1 is 320x240 and 2 is 176x144.

imageSettingsQuality =item imageSettingsQuality( 3|6|9|12|15 )

Gets/sets the image quality. 3, 6, 9, 12 and 15 refer to 'Highest', 'High', 'Normal', 'Low' and 'Lowest' respectively.

imageSettingsFrameRate =item imageSettingsFrameRate( 1|3|5|10|15|20|25|30 )

Gets/sets the maximum frame rate for the MJPEG stream.

imageSettingsFrequency =item imageSettingsFrequency( 60|50|0 )

Gets/sets the image frequency. '60' is 60Hz, '50' is 50Hz, and '0' is the 'Outdoor' setting.

imageSettingsBrightness =item imageSettingsBrightness( 0-99 )

Gets/sets the image brightness. Value is an integer between 0 (lowest) and 99 (highest).

imageSettingsContrast =item imageSettingsContrast( 0-99 )

Gets/sets the image contrast. Value is an integer between 0 (lowest) and 99 (highest).

imageSettingsSaturation =item imageSettingsSaturation( 0-99 )

Gets/sets the image saturation. Value is an integer between 0 (lowest) and 99 (highest).

imageSettingsHue =item imageSettingsHue( 0-99 )

Gets/sets the image hue. Value is an integer between 0 (lowest) and 99 (highest).

imageSettingsWhiteness =item imageSettingsWhiteness( 0-30 )

Gets/sets the image hue. Value is an integer between 0 (lowest) and 30 (highest).

imageSettingsAutoExp =item imageSettingsAutoExp( 'ON' )

Sets the image auto exposure. Pass it 'ON' to turn it on, and (predictably) 'OFF' to turn it off.

statusFirmware

Returns the firmware version running on the camera.

statusUptime

Returns the camera's uptime.

statusTime

Returns the device's date and time.

statusIPAddress

Returns the device's IP address.

statusNetmask

Returns the device's netmask.

statusGateway

Returns the device's default gateway.

statusDNSServer

Returns the device's DNS server.

statusMACAddress

Returns the device's MAC address.

statusVideoPort

Returns the TCP port used by the video streaming applet.

statusHTTPPort

Returns the TCP port used for the web front end.

systemSettingsCameraName

Returns the device's name.

systemSettingsPassword

Returns the device's password.

systemSettingsLED

Returns the LED visiblity status.

cycleSystemLED

Turns on/off the LEDs on the front of the device.

reboot()

Reboots the device.

SEE ALSO

http://meh.org.uk/perl/Net-Camera-Edimax-IC1500/

AUTHOR

Andy Smith, <ams@meh.org.uk>

COPYRIGHT AND LICENSE

Copyright (C) 2008, 2009 by Andy Smith

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.