Appendix D

CGI Commands

30

Wireless-N Internet Home Monitoring Camera

If the client player is the QuickTime player, the latency is always approximately 3 second. If there is no audio

content in the streaming, you can use the extension parameter “[?|&]latency=no” to push the QuickTime

player to play the streaming video without any latency, but this method causes the frame rate to be unstable.

Example:

rtsp://<ip>/img/video.sav?latency=no

Note that the camera is able to support the following four RTP protocols, but the user needs to specify the

desired RTP protocol in the player.

•

Unicast RTP

•

Multicast RTP

•

RTP over RTSP (RTP over TCP)

•

RTP over RTSP over HTTP (HTTP tunnel)

Return:

Video and/or audio is returned.

Player Commands

Query

Method:

GET

URL:

http://<ip>/util/query.cgi[?extension=value]

This command retrieves the hardware capability, component setting or current status. For example, you can

query whether the camera has a speaker, I/O port, etc.

Parameter

Value and description

extension

Extension value

fw_ver=V1.0.0 build 01\r\n

ip_addr=192.168.1.12\r\n

netmask=255.255.255.0\r\n

gateway=192.168.1.1\r\n

current_time=07/02/2008 10:12:10\r\n

-> MM/DD/YYYY HH:MM:SS 24-Hour format

timezone=4\r\n

http_port=80\r\n

rtsp_port=554\r\n

Return:

HTTP/1.0 200 OK \r\n

…

content-type: text/plain\r\n

\r\n

<parameter pair>\r\n

<parameter pair>\r\n

......

Appendix D

CGI Commands

31

Wireless-N Internet Home Monitoring Camera

Here are the details of the parameter pairs:

Parameter

Value and description

hostname

Camera name,

example: MyCamera

description

Camera description, example: Hello camera

defname

Camrea default name, example: default name

mac

Camera’s MAC address, example: 00C002123456

company_name

Camera’s comany name, example: Cisco

model_number

Camera’s model number, example: WVC80N

resolutions

The resolutions camera support, valid values: [640*480,320*240,160*120]

mpeg4_resolution

Current MPEG-4 resolution setting, valid values: [640|320|160]

mjpeg_resolution

Current JPEG resolution setting, valid values: [640|320|160]

mic_in

Current MIC in setting, valid values: [on|off]

speaker_out

Current Speaker out setting, valid values: [on|off]

ptctrl

PT HW capability, valid values: [on|off]

ioctrl

IO HW capability, valid values: [on|off]

serial

RS485 capability, valid values: [pelco|off]

privacy_button

Privacy button HW capability, valid values: [on|off]

pir_sensor

PIR sensor HW capability, valid values: [on|off]

wlled

White light LED HW capability, valid values: [on|off]

irled

IR LED HW capability, valid values: [on|off]

wps_pin_code

WPS PIN code value, example: 00000048

wireless

Wireless HW capability, example: [on|off]

URL:

http://<ip>/img/query.cgi

This command retrieves the accessed user’s privilege with some hardware features. For example, the user may

be able to use Speaker Out, but can’t control the I/O ports.

Return:

HTTP/1.0 200 OK \r\n

…

content-type: text/plain\r\n

\r\n

mic_in=[on|off]r\n

speaker_out=[on|off]\r\n

ptctrl=[on|off]\r\n

ioctrl=[on|off]\r\n

Appendix D

CGI Commands

32

Wireless-N Internet Home Monitoring Camera

Admin-Level CGI Commands (Administrator level privilege)

Query FW Version

Method:

GET

URL:

http://<ip>/adm/sysinfo.cgi

Return:

The Camera returns a Web page that contains the following messages:

HTTP/1.0 200 OK \r\n

…

content-type: text/plain\r\n

\r\n

Firmware Version: v1.0.00 build 01 \r\n

Serial Number: SQJ00G100001\r\n

Reboot

Method:

GET

URL:

http://<ip>/adm/reboot.cgi

Return:

HTTP/1.0 200 OK \r\n

…

content-type: text/plain\r\n

\r\n

OK\r\n

Restore to Factory Defaults

Method:

GET

URL:

http://<ip>/adm/reset_to_default.cgi

Return:

HTTP/1.0 200 OK \r\n

…

content-type: text/plain\r\n

\r\n

OK\r\n

Get/Set Group Parameters

Get group parameters

Method:

GET

URL:

http://<ip>/adm/get_group.cgi?<parameter>=<value>[&<value>…]

Appendix D

CGI Commands

33

Wireless-N Internet Home Monitoring Camera

Parameter

Value and description

group

1. To get all group settings

group_name (The group name is not case sensitive.)

2. To get a specific setting from a group

group_name.parameter_name

3. To get the settings from multiple groups

group_name&group_name...

Return:

All group settings or one group setting is returned as follows:

HTTP/1.0 200 OK\r\n

…

content-type: text/plain\r\n

...

\r\n

[group1]\r\n

<parameter pair>\r\n

<parameter pair>\r\n

...\r\n

[group2]\r\n

<parameter pair>\r\n

<parameter pair>\r\n

...\r\n

Where <parameter pair> is <parameter_name>=<parameter_value>.

Set Group Parameters

Method:

GET

URL:

Parameter

Value and description

group

Group name is specified here. (The group name is not case sensitive.)

Return: A successful request returns all group parameters or the specified parameters as below:

HTTP/1.0 200 OK\r\n

…

content-type: text/plain\r\n

...

\r\n

OK\r\n

Appendix D

CGI Commands

34

Wireless-N Internet Home Monitoring Camera

Get/Set System Date and Time

Method:

GET

URL:

http://<ip>/adm/date.cgi?action=<value>[&<parameter pair>…]

Parameter

Value and description

action

Get/Set the system date and time

get=

Get the system date and time

set=

Set the system date and time

time_zone

The index value in time zone table (Read-only)

year

Year (2005~2037)

month

Month (1~12)

day

Day (1~31)

hour

Hour (0~23)

minute

Minute (0~59)

second

Second (0~59)

Return:

A successful request returns all group parameters or the specified parameters as below:

HTTP/1.0 200 OK\r\n

…

content-type: text/plain\r\n

...

\r\n

OK\r\n

<parameter pair>\r\n

<parameter pair>\r\n

...\r\n

Upgrade Firmware

Method:

POST

URL:

http://<ip>/adm/upgrade.cgi

Message body:

…

…

<boundary=...>

…

<FW binary data>

The client must wait at least 5 minutes to make sure the upgrade is complete.

Return:

A Firmware Upgrade Progress window is returned.