Cpplus - Unc - Unp - HTTP - Api - For - Ipc-V1 37 PDF
Cpplus - Unc - Unp - HTTP - Api - For - Ipc-V1 37 PDF
Cpplus - Unc - Unp - HTTP - Api - For - Ipc-V1 37 PDF
Version 1.37
Document History
No
Release Notes
Date
Version
Author
draft
2007-1-18
1.10
Haifeng Wang
2012-8-18
1.20
Weijun Li
2012-9-11
1.21
Weijun Li
2012-9-29
1.22
Wei Chen
1.22
Wei Chen
2012-10-17
1.23
Wei Chen
1.24
Wei Chen
2012-11-12
1.25
WeiChen
6
7
2013-1-14
1.26
WeiChen
10
2013-1-18
1.27
WeiChen
11
2013-1-19
1.28
WeiChen
12
2013-5-9
1.29
WeiChen
1.30
WeiChen
2013-10-26
1.31
WeiChen
1.32
WeiChen
1.33
WeiChen
13
14
15
16
chapter 8.3.
Add holiday description in chapter 8.4 and chater 8.1 and 2013-10-26
8.2.
17
2013-11-10
1.34
WeiChen
18
2013-11-14
1.35
WeiChen
19
2013-11-15
1.36
WeiChen
1.37
WeiChen
20
1.Preface
This document details the API of CPPLUS video products. Programmers can access and configure CPPLUS video products follows the API.
This document with version 1.10 is available with firmware version 2.0 and above. This document with version 1.20, 1.21, 1.22, 1.23,
1.24,1,25,1,26,1,27,1,28 is available with firmware 2.210 and above.This document with version 1. 29 , 1.30, 1.31, 1.32, 1.33, 1.34, 1.35,
1.36 is available with firmware 2.210 and above.This document with version 1.37 is available with firmware 2.212, 2.4 and above.
2.Catalog
Document History ......................................................................................................................................................................................................2
1.Preface ....................................................................................................................................................................................................................3
2.Catalog ....................................................................................................................................................................................................................3
3.HTTP API Transaction ..............................................................................................................................................................................................9
3.1Transaction ...................................................................................................................................................................................................9
3.2Authentication ............................................................................................................................................................................................10
4.Camera..................................................................................................................................................................................................................10
4.1Stream ........................................................................................................................................................................................................10
4.1.1 GetStream .......................................................................................................................................................................................10
4.1.2 GetMaxExtraStreamCounts .............................................................................................................................................................11
4.1.3 GetSnapshot ...................................................................................................................................................................................11
4.1.4 GetVideo .........................................................................................................................................................................................11
4.1.5 PlayBack ..........................................................................................................................................................................................12
4.1.6 LoadFile...........................................................................................................................................................................................12
4.1.7 GetStream By Http ..........................................................................................................................................................................12
4.1.8 Playback By Http .............................................................................................................................................................................12
4.2VideoColor ..................................................................................................................................................................................................13
4.2.1 GetVideoColorConfig ......................................................................................................................................................................13
4.2.2 SetVideoColorConfig .......................................................................................................................................................................14
4.3VideoInOptions ...........................................................................................................................................................................................14
4.3.1 GetVideoInputCaps .........................................................................................................................................................................14
4.3.2 GetVideoInOptionsConfig ...............................................................................................................................................................16
4.3.3 SetVideoInOptionsConfig ................................................................................................................................................................19
4.4VideoEncode...............................................................................................................................................................................................23
4.4.1 GetVideoConfigCaps .......................................................................................................................................................................23
4.4.2 Resolution .......................................................................................................................................................................................24
4.4.3 GetVideoEncodeConfig ...................................................................................................................................................................25
4.4.4 SetVideoEncodeConfig ...................................................................................................................................................................25
4.5AudioEncode ............................................................................................................................................................................................... 27
4.5.1 GetAudioConfigCaps ....................................................................................................................................................................... 27
4.5.2 GetAudioEncodeConfig ................................................................................................................................................................... 27
4.5.3 SetAudioEncodeConfig....................................................................................................................................................................28
4.6 SnapEncode ...............................................................................................................................................................................................29
4.6.1 GetSnapConfigCaps .........................................................................................................................................................................29
4.6.2 GetSnapEncodeConfig ....................................................................................................................................................................29
4.6.3 SetSnapEncodeConfig .....................................................................................................................................................................30
4.7ChannelTitle ...............................................................................................................................................................................................31
4.7.1 GetChannelTitleConfig ....................................................................................................................................................................31
4.7.2 SetChannelTitleConfig ....................................................................................................................................................................31
4.8VideoStandard ............................................................................................................................................................................................31
4.8.1 GetVideoStandardConfig ................................................................................................................................................................31
4.8.2 SetVideoStandardConfig .................................................................................................................................................................31
4.9VideoWidget...............................................................................................................................................................................................32
4.9.1 GetVideoWidgetConfig ...................................................................................................................................................................32
4.9.2 SetVideoWidgetConfig ...................................................................................................................................................................33
4.10VideoOut ..................................................................................................................................................................................................35
4.10.1 GetVideoOutConfig.......................................................................................................................................................................35
4.10.2 SetVideoOutConfig .......................................................................................................................................................................35
4.11FlashLight ..................................................................................................................................................................................................36
4.11.1 GetFlashLightConfig ......................................................................................................................................................................36
4.11.2 SetFlashLightConfig .......................................................................................................................................................................36
5.NetWork ............................................................................................................................................................................................................... 37
5.1NetInterfaces .............................................................................................................................................................................................. 37
5.1.1 GetInterfaces................................................................................................................................................................................... 37
5.2BasicConfig.................................................................................................................................................................................................. 37
5.2.1 GetBasicConfig ................................................................................................................................................................................ 37
5.2.2 SetBasicConfig .................................................................................................................................................................................38
5.3PPPoE ..........................................................................................................................................................................................................39
5.3.1 GetPPPoEConfig ..............................................................................................................................................................................39
5.3.2 SetPPPoEConfig ...............................................................................................................................................................................39
5.4DDNS ...........................................................................................................................................................................................................39
5.4.1 GetDDNSConfig ...............................................................................................................................................................................39
5.4.2 SetDDNSConfig................................................................................................................................................................................40
5.5Email ...........................................................................................................................................................................................................40
5.5.1 GetEmailConfig ...............................................................................................................................................................................40
5.5.2 SetEmailConfig ................................................................................................................................................................................41
5.6Wlan ...........................................................................................................................................................................................................41
5.6.1 GetWlanConfig ................................................................................................................................................................................41
5.6.2 SetWlanConfig ................................................................................................................................................................................42
5.7UPnP ...........................................................................................................................................................................................................43
5.7.1 GetUPnPConfig ...............................................................................................................................................................................43
5.7.2 SetUPnPConfig ................................................................................................................................................................................43
5.7.3 GetUPnPStatus ................................................................................................................................................................................44
5.8NTP .............................................................................................................................................................................................................44
5.8.1 GetNTPConfig..................................................................................................................................................................................44
5.8.2 SetNTPConfig ..................................................................................................................................................................................44
5.9RTSP ............................................................................................................................................................................................................45
5.9.1 GetRTSPConfig ................................................................................................................................................................................45
5.9.2 SetRTSPConfig .................................................................................................................................................................................46
6.Events ...................................................................................................................................................................................................................46
6.1EventHandler ..............................................................................................................................................................................................46
6.1.1 GetEventHandler.............................................................................................................................................................................46
6.1.2 SetEventHandler ............................................................................................................................................................................. 47
6.2Alarm ..........................................................................................................................................................................................................49
6.2.1 GetAlarmConfig ..............................................................................................................................................................................49
6.2.2 SetAlarmConfig ...............................................................................................................................................................................49
6.2.3 GetAlarmOutConfig.........................................................................................................................................................................50
6.2.4 SetAlarmOutConfig .........................................................................................................................................................................50
6.2.5 GetInSlots ........................................................................................................................................................................................50
6.2.6 GetOutSlots .....................................................................................................................................................................................51
6.2.7 GetInState .......................................................................................................................................................................................51
6.2.8 GetOutState ....................................................................................................................................................................................51
6.2.9 GetChannelInState ..........................................................................................................................................................................51
6.2.10 GetChannelOutState .....................................................................................................................................................................51
6.3MotionDetect ............................................................................................................................................................................................. 52
6.3.1 GetMotionDetectConfig .................................................................................................................................................................. 52
6.3.2 SetMotionDetectConfig .................................................................................................................................................................. 52
6.4BlindDetect .................................................................................................................................................................................................53
6.4.1 GetBlindDetectConfig .....................................................................................................................................................................53
6.4.2 SetBlindDetectConfig ......................................................................................................................................................................54
6.5LossDetect ..................................................................................................................................................................................................54
6.5.1 GetLossDetectConfig .......................................................................................................................................................................54
6.5.2 SetLossDetectConfig .......................................................................................................................................................................54
6.6LoginFailureAlarm .......................................................................................................................................................................................55
6.6.1 GetLoginFailureAlarmConfig ...........................................................................................................................................................55
6.6.2 SetLoginFailureAlarmConfig ............................................................................................................................................................55
6.7 StorageAbnormal .......................................................................................................................................................................................55
6.7.1 GetStorageNotExistConfig ...............................................................................................................................................................55
6.7.2 SetStorageNotExistConfig ...............................................................................................................................................................55
6.7.3 Get StorageFailureConfig ................................................................................................................................................................56
6.7.4 Set StorageFailureConfig .................................................................................................................................................................56
6.7.5 GetStorageLowSpaceConfig ............................................................................................................................................................56
6.7.6 SetStorageLowSpaceConfig .............................................................................................................................................................56
6.8 NetAbnormal ............................................................................................................................................................................................. 57
6.8.1 GetNetAbortConfig ......................................................................................................................................................................... 57
6.8.2 SetNetAbortConfig .......................................................................................................................................................................... 57
6.8.3 GetIPConflictConfig ......................................................................................................................................................................... 57
6.8.4 SetIPConflictConfig ......................................................................................................................................................................... 57
6.9 GetEventIndexes ........................................................................................................................................................................................58
6.10 Attach.......................................................................................................................................................................................................58
7.PTZ ........................................................................................................................................................................................................................59
7.1PTZConfig ....................................................................................................................................................................................................59
7.1.1 GetPTZConfig ..................................................................................................................................................................................59
7.1.2 SetPTZConfig ...................................................................................................................................................................................60
7.2PTZControl ..................................................................................................................................................................................................61
7.2.1 GetProtocolList................................................................................................................................................................................61
7.2.2 GetCurrentProtocolCaps .................................................................................................................................................................61
7.2.3 PTZ control commands ................................................................................................................................................................... 62
7.3PTZStatus ....................................................................................................................................................................................................65
7.3.1 PTZ GetStatus ..................................................................................................................................................................................65
8.Record&Snap ........................................................................................................................................................................................................65
8.1Record .........................................................................................................................................................................................................65
8.1.1 GetRecordConfig .............................................................................................................................................................................65
8.1.2 SetRecordConfig..............................................................................................................................................................................66
8.1.3 GetRecordModeConfig ...................................................................................................................................................................66
8.1.4 SetRecordModeConfig ....................................................................................................................................................................66
8.2Snap ............................................................................................................................................................................................................ 67
8.2.1 GetSnapConfig ................................................................................................................................................................................ 67
8.2.2 SetSnapConfig ................................................................................................................................................................................. 67
8.3MediaGlobal ...............................................................................................................................................................................................68
8.3.1 GetMediaGlobalConfig....................................................................................................................................................................68
8.3.2 SetMediaGlobalConfig ....................................................................................................................................................................68
8.4Holiday ........................................................................................................................................................................................................68
8.4.1 GetHolidayConfig ............................................................................................................................................................................68
8.4.2 SetHolidayConfig .............................................................................................................................................................................69
9.System ..................................................................................................................................................................................................................69
9.1General .......................................................................................................................................................................................................69
9.1.1 GetGeneralConfig............................................................................................................................................................................69
9.1.2 SetGeneralConfig ............................................................................................................................................................................69
9.2SystemTime ................................................................................................................................................................................................ 70
9.2.1 GetCurrentTime .............................................................................................................................................................................. 70
9.2.2 SetCurrentTime............................................................................................................................................................................... 70
9.3Locales ........................................................................................................................................................................................................ 70
9.3.1 GetLocalesConfig ............................................................................................................................................................................ 70
9.3.2 SetLocalesConfig .............................................................................................................................................................................71
9.4Language ..................................................................................................................................................................................................... 72
9.4.1 GetLanguageCaps ........................................................................................................................................................................... 72
9.4.2 GetLanguageConfig ......................................................................................................................................................................... 72
9.4.3 SetLanguageConfig..........................................................................................................................................................................73
9.5AccessFilter .................................................................................................................................................................................................73
9.5.1 GetAccessFilterConfig .....................................................................................................................................................................73
9.5.2 SetAccessFilterConfig ......................................................................................................................................................................73
9.6AutoMaintain .............................................................................................................................................................................................. 74
9.6.1 GetAutoMaintainConfig .................................................................................................................................................................. 74
9.6.2 SetAutoMaintainConfig ................................................................................................................................................................... 74
9.7UserManager ..............................................................................................................................................................................................75
10.6.4 SetStorageGroupConfig.................................................................................................................................................................86
11.Audio ..................................................................................................................................................................................................................86
11.1 Audio MIME type .....................................................................................................................................................................................86
11.2 Post Audio ................................................................................................................................................................................................ 87
11.2.1 Example for singlepart .................................................................................................................................................................. 87
11.2.2 Example for multipart ................................................................................................................................................................... 87
11.3 Get Audio .................................................................................................................................................................................................88
11.3.1 Example for singlepart ..................................................................................................................................................................88
11.3.2 Example for multipart ...................................................................................................................................................................88
12.Appendix.............................................................................................................................................................................................................89
12.1 Stream Format .........................................................................................................................................................................................89
13.VedioInput ..........................................................................................................................................................................................................91
13.1 AdjustFocus ..............................................................................................................................................................................................91
13.2 AdjustFocusContinuously .........................................................................................................................................................................91
13.3 AutoFocus ................................................................................................................................................................................................ 92
13.4 GetFocusStatus ........................................................................................................................................................................................ 92
14. SD Camera ......................................................................................................................................................................................................... 92
14.1 VideoInWhiteBalance .............................................................................................................................................................................. 92
14.1.1 GetVideoInWhiteBalance ............................................................................................................................................................. 92
14.2.2 SetVideoInWhiteBalance ..............................................................................................................................................................93
14.2 VideoInExposure ......................................................................................................................................................................................93
14.2.1 GetVideoInExposure .....................................................................................................................................................................93
14.2.2 SetVideoInExposure ......................................................................................................................................................................95
14.3 VideoInDenoise ....................................................................................................................................................................................96
14.3.1 GetVideoInDenoise .......................................................................................................................................................................96
14.3.2 SetVideoInDenoise ....................................................................................................................................................................... 97
14.4 VideoInDayNight .................................................................................................................................................................................. 97
14.4.1 GetVideoInDayNight ..................................................................................................................................................................... 97
14.4.2 SetVideoInDayNight ......................................................................................................................................................................98
14.5 VideoInFocus ..........................................................................................................................................................................................98
14.5.1 GetVideoInFocus...........................................................................................................................................................................98
14.5.2 SetVideoInFocus ...........................................................................................................................................................................99
14.6 VideoInZoom ..........................................................................................................................................................................................99
14.6.1 GetVideoInZoom...........................................................................................................................................................................99
14.6.2 SetVideoInZoom .........................................................................................................................................................................100
14.7 VideoInSharpness ..............................................................................................................................................................................100
14.7.1 GetVideoInSharpness .................................................................................................................................................................100
14.7.2 SetVideoInSharpness ..................................................................................................................................................................100
14.8 VideoInColor .........................................................................................................................................................................................101
14.8.1 GetVideoInColor .........................................................................................................................................................................101
14.8.2 SetVideoInColor .......................................................................................................................................................................... 102
14.9 VideoInRotate ....................................................................................................................................................................................... 102
14.9.1 GetVideoInRotate ....................................................................................................................................................................... 102
14.9.2 SetVideoInRotate ........................................................................................................................................................................103
14.10 VideoInMode ......................................................................................................................................................................................103
The italics and bold will be replaced by the value behind the symbol =.
2.
The URL must follow the standard way of writing a URL.(RFC_3986:Uniform Resource Identifiers (URI) Generic Syntax);that is ,spaces
and other reserved characters (;, /, ?, :, @, =, +, , and $) within a <paramName> or a <paramValue> must be replaced
with %<ASCII hex>.For example ,the blank must be instead with %20.
3.
To describe the range of the configuration, we use some symbols such as [], {} and so on. For example :[0-100] denotes a
integer not less than 0 and not larger than 100. {0,1,2,3} denotes the valid value of a integer among 0,1,2 and 3.
4.
In the request and response, we use [] to denote an array. The index is usually a integer and start form 0.
5.
The parameter value has several types: string, integer, bool and float.Integer is 32 bits.The range of bool is true and false.
GET http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoColor
Description
Response
HTTP/1.1 200 OK
Content-Type:text/plain
head.Brightness=50
head.Contrast=50
head.Hue=50
head.Saturation=50
head.TimeSection=1 00:00:00-24:00:00
Comment
HTTP/1.1 200 OK
Content-Type:text/plain
table.VideoColor[0][0].Brightness=50
3.2Authentication
The CPPLUS video product supplies two authentication ways: basic authentication and digest authentication. If the http request does not
have
Authorization , the CPPLUS video product returns 401, utill the http request has a legal authentication .
For example:
1. When basic authentication, the CPPLUS video product response:
401 Unauthorized
WWW-Authenticate: Basic realm=XXXXXX
Then the client encode the username and password with base64, send the following request:
Authorization: Basic VXZVXZ.
2. When digest authentication, the CPPLUS video product response:
WWW-Authenticate: Digest realm="DH_00408CA5EA04", nonce="000562fdY631973ef04f77a3ede7c1832ff48720ef95ad",
stale=FALSE, qop="auth";
The client calculates the digest using username, password, nonce, realm and URI with MD5, then send the following request:
Authorization: Digest username="admin", realm="DH_00408CA5EA04", nc=00000001,cnonce="0a4f113b",qop="auth"
nonce="000562fdY631973ef04f77a3ede7c1832ff48720ef95ad",uri="cgi-bin/global.login?userName=admin",
response="65002de02df697e946b750590b44f8bf"
4.Camera
Camera API allows application to configure and view CPPLUS video product settings.
4.1Stream
4.1.1 GetStream
URL Syntax
rtsp://<username>:<password>@<ip>:<port>/cam/realmonitor?channel=<channelNo>&subtype=<typeNo>
Comment
head.VideoEnable
to
4.1.2 GetMaxExtraStreamCounts
URL Syntax
http://<ip>/cgi-bin/magicBox.cgi?action=getProductDefinition&name=MaxExtraStream
Response
table.MaxExtraStream=1
Comment
4.1.3 GetSnapshot
URL Syntax
http://<ip>/cgi-bin/snapshot.cgi? [channel=<channelNo>]
Response
Comment
The channel number is default 0 if the request is not carried the param.
4.1.4 GetVideo
URL Syntax
http://<ip>/cgi-bin/mjpg/video.cgi?[channel=<channelNo>]
Response
Comment
The channel number is default 0 if the request is not carried the param.
4.1.5 PlayBack
URL Syntax
rtsp://<username>:<password>@<ip>:<port>/<filename>
Response
4.1.6 LoadFile
URL Syntax
http://<ip>/cgi-bin/RPC_Loadfile/<filename>
Response
http://<ip>/cgi-bin/realmonitor.cgi?action=getStream&channel=<channelNo>&subtype=<typeNo>
Response
Comment
Compared to 4.1.1 GetStream using RTSP, it is another way of get stream. This is a way to use http
protocol to get realmonitor stream. The data format is shown in appendix.
http://<ip>/cgi-bin/playBack.cgi?action=getStream&channel=<channelNo>&subtype=<typeNo>&startTime=<startTime>&
endTime=<endTime>
Response
<data>
<data>
Comment
Compared to 4.1.5 Playback using RTSP, it is another way of get playback stream. This is a way to use
http protocol to get playback stream. The data format is shown in appendix.
URL Syntax
http://<ip>/cgi-bin/playBack.cgi?action=control&streamId=<streamId>&cmd=<cmd>&<paramName>=<paramValue>[&<
paramName>=<paramValue>...]
Response
OK or ERROR
Comment
4.2VideoColor
4.2.1 GetVideoColorConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoColor
Response
head.Brightness=50
head.Contrast=50
head.Hue=50
head.Saturation=50
head.TimeSection=1 00:00:00-24:00:00
Comment
4.2.2 SetVideoColorConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Response
OK or ERROR
Comment
ParamName
ParamValue type
Description
head.Brightness
integer
head.Contrast
integer
head.Hue
integer
Hue
head.Saturation
integer
Saturation
head.TimeSection
string
4.3VideoInOptions
4.3.1 GetVideoInputCaps
URL Syntax
http://<ip>/cgi-bin/devVideoInput.cgi?action=getCaps&channel=<channelNo>
Description
Response
caps.Backlight=true
caps.ChipID=0
caps.CoverCount=0
caps.CoverType=0
caps.CustomManualExposure=true
caps.DayNightColor=true
caps.DownScaling=true
caps.Exposure=9
caps.ExternalSyncInput=true
caps.FlashAdjust=true
caps.Flip=true
caps.Gain=true
caps.GainAuto=true
caps.HorizontalBinning=1
caps.InfraRed=false
caps.Iris=false
caps.IrisAuto=false
caps.LadenBitrate=750000
caps.LimitedAutoExposure=true
caps.MaxHeight=1200
caps.MaxWidth=1600
caps.Mirror=false
caps.NightOptions=false
caps.ReferenceLevel=false
caps.Rotate90=false
caps.SetColor=true
caps.SignalFormats=Inside,720p,1080p
caps.SyncChipChannels=false
caps.TitleCount=0
caps.UpScaling=false
caps.VerticalBinning=1
caps.WhiteBalance=2
Field in response
Value type
Description
Backlight
bool
ChipID
String
CoverCount
integer
CoverType
integer
CustomManualExposure
bool,
DayNightColor
bool
DownScaling
bool
Exposure
integer
ExternalSyncInput
bool
FlashAdjust
bool
Flip
bool
Gain
bool
GainAuto
bool
HorizontalBinning
integer
VerticalBinning
integer
bool
Iris
bool
IrisAuto
bool
LadenBitrate
integer
Unit is Kbps.
Maximum value of video stream bitrate, 16bpp, not in binning mode.
LimitedAutoExposure
bool
MaxHeight
integer
MaxWidth
integer
Mirror
bool
NightOptions
bool
ReferenceLevel
bool
Rotate90
bool
SetColor
bool
SignalFormats
string
Its a string contains supported video input signal formats for this channel. Signal formats
are separated by comma.
Range is {Inside, BT656, 720p,1080p, 1080i, 1080sF, 1_3M}
Inside inside input.
1_3M - 1280*960
SyncChipChannels
bool
True: channels in same chip should be synchronized. Synchronized means video resolution
of these channels should be the same.
TitleCount
integer
UpScaling
bool
WhiteBalance
integer
Range is {0, 1, 2, 3}
0 dont support white balance.
1 support auto white balance
2 - support auto and pre defined white balance.
3 - support auto, pre defined and user defined white balance
4.3.2 GetVideoInOptionsConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoInOptions
Description
Video in options contain Backlight, ExposureSpeed, DayNightColor. DayOptions, NightOptions, NormalOptions and so on
Response
head.Backlight=0
head.DayNightColor=false
head.ExposureSpeed=0
head.ExposureValue1=0.100000
head.ExposureValue2=80.000000
head.ExternalSync=0
head.ExternalSyncPhase=0
head.FlashControl.Mode=0
head.FlashControl.Pole=0
head.FlashControl.Value=0
head.FlashControl.PreValue=0
head.Flip=false
head.Gain=50
head.GainAuto=true
head.IrisAuto=false
head.Mirror=false
head.NightOptions.AntiFlicker=0
head.NightOptions.Backlight=0
head.NightOptions.BacklightRegion[0]=3096
head.NightOptions.BacklightRegion[1]=3096
head.NightOptions.BacklightRegion[2]=5096
head.NightOptions.BacklightRegion[3]=5096
head.NightOptions.BrightnessThreshold=50
head.NightOptions.DayNightColor=2
head.NightOptions.ExposureMode=0
head.NightOptions.ExposureSpeed=0
head.NightOptions.ExposureValue1=0
head.NightOptions.ExposureValue2=40
head.NightOptions.ExternalSyncPhase=125
head.NightOptions.Flip=false
head.NightOptions.Gain=50
head.NightOptions.GainAuto=true
head.NightOptions.GainBlue=50
head.NightOptions.GainGreen=50
head.NightOptions.GainMax=50
head.NightOptions.GainMin=0
head.NightOptions.GainRed=50
head.NightOptions.GlareInhibition=0
head.NightOptions.IrisAuto=true
head.NightOptions.Mirror=false
head.NightOptions.Profile=3
head.NightOptions.ReferenceLevel=50
head.NightOptions.Rotate90=0
head.NightOptions.SunriseHour=0
head.NightOptions.SunriseMinute=0
head.NightOptions.SunriseSecond=0
head.NightOptions.SunsetHour=23
head.NightOptions.SunsetMinute=59
head.NightOptions.SunsetSecond=59
head.NightOptions.SwitchMode=4
head.NightOptions.WhiteBalance=Auto
head.NightOptions.WideDynamicRange=0
head.NightOptions.WideDynamicRangeMode=0
head.NormalOptions.AntiFlicker=0
head.NormalOptions.Backlight=0
head.NormalOptions.BacklightRegion[0]=3096
head.NormalOptions.BacklightRegion[1]=3096
head.NormalOptions.BacklightRegion[2]=5096
head.NormalOptions.BacklightRegion[3]=5096
head.NormalOptions.BrightnessThreshold=50
head.NormalOptions.DayNightColor=1
head.NormalOptions.ExposureMode=0
head.NormalOptions.ExposureSpeed=0
head.NormalOptions.ExposureValue1=0
head.NormalOptions.ExposureValue2=40
head.NormalOptions.ExternalSyncPhase=125
head.NormalOptions.Flip=false
head.NormalOptions.Gain=50
head.NormalOptions.GainAuto=true
head.NormalOptions.GainBlue=50
head.NormalOptions.GainGreen=50
head.NormalOptions.GainMax=50
head.NormalOptions.GainMin=0
head.NormalOptions.GainRed=50
head.NormalOptions.GlareInhibition=0
head.NormalOptions.IrisAuto=true
head.NormalOptions.Mirror=false
head.NormalOptions.Profile=0
head.NormalOptions.ReferenceLevel=50
head.NormalOptions.Rotate90=0
head.NormalOptions.SunriseHour=0
head.NormalOptions.SunriseMinute=0
head.NormalOptions.SunriseSecond=0
head.NormalOptions.SunsetHour=23
head.NormalOptions.SunsetMinute=59
head.NormalOptions.SunsetSecond=59
head.NormalOptions.SwitchMode=0
head.ReferenceLevel=50
head.ReferenceLevelEnable=false
head.Rotate90=0
head.SignalFormat=BT656
head.WhiteBalance=Disable
Comment
4.3.3 SetVideoInOptionsConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue
Description
type
head.Backlight
integer
Range is [0-n]
n depends on capability in 4.3.1 GetVideoInputCaps
0 backlight closed.
1 backlight grade 1
n backlight grade n
head.DayNightColor
integer
Range is {0,1,2}
0: always multicolor
1: autoswitch along with brightness
2: always monochrome
head.ExposureMode
integer
Range is {0,1,2, 4}
0: AutoExposure
1: Gain first
2: Exposure first
4:Manual.
head.ExposureSpeed
integer
Range is [0-n+1]
n depends on capability in 4.3.1 GetVideoInputCaps
0: AutoExposure
1-n-1: manual Exposure grade
n: AutoExposure with time limit.
n+1:manualExposure with user-defined time
(n is supported maximum exposure grade )
head.ExposureValue1
float
head.ExposureValue2
float
head.ExternalSync
integer
Range is {0,1}
External Synchronous
0: Internal Synchronization
1: External Synchronous
head.ExternalSyncPhase
integer
Range is [0-360]
External Synchronous Signal Phase
head.FlashControl.Mode
integer
Range is {0,1,2}
0:forbid flash
1:always flash
2:auto flash
head.FlashControl.Pole
integer
Range is {0,1, 2, 3}
Trigger mode:
0:low level
1:high level
2: rising-edge
3:falling-edge
head.FlashControl.Value
integer
Range is [0-15]
Flashlight time-unit:
0 - 0us,
1 - 64us,
2 - 128us,
3 192us
...
15 - 960us
head.FlashControl.PreValue
integer
Range is [0-100]
Its threshold of brightness value, if brightness is less than this value, flash light
begin to work.
head.Flip
bool
head.Gain
integer
Range is [0-100]
If GainAuto is true, its upper limit of auto gain, else its the fixed gain adjust
value.
head.GainBlue
integer
Range is [0-100]
Gain for blue value, Value is effective when WhiteBalance is Custom.
head.GainRed
integer
Range is [0-100]
Gain for red value, Value is effective when WhiteBalance is Custom.
head.GainGreen
integer
Range is [0-100]
Gain for green value, Value is effective when WhiteBalance is Custom.
head.GainAuto
bool
true: GainAuto
false: No GainAuto
head.IrisAuto
bool
true: IrisAuto
false: No IrisAuto
head.Mirror
bool
head.WhiteBalance
String
head.ReferenceLevel
integer
Range is [0-100]
integer
Range is {0,1,2}
Video rotation:
0: No rotate
1: clockwise rotate 90
2: anticlockwise rotate 90
head.SignalFormat
String
head.AntiFlicker
integer
Range is {0,1,2}
AntiFlicker mode:
0: Outdoor
1: 50 Hz AntiFlicker
2: 60 Hz AntiFlicker
head.GlareInhibition
integer
Range is [0-100]
GlareInhibition:
0: Close GlareInhibition.
head.NightOptions.BrightnessThreshold
integer
head.NightOptions.IrisAuto
bool
true: IrisAuto
false: No IrisAuto
head.NightOptions.SunriseHour
integer
Range is [00-23]
Sunrise hour.
head.NightOptions.SunriseMinute
integer
Range is [00-59]
Sunrise minute
head.NightOptions.SunriseSecond
integer
Range is [00-59]
Sunrise second
head.NightOptions.SunsetHour
integer
head.NightOptions.SunsetMinute
integer
Sunset time. Its range is same with sunrise time, and it should be after sunrise
time.
head.NightOptions.SunsetSecond
integer
NightOptions are used if time is after sunset time and before sunrise time.
head.NightOptions.SwitchMode
integer
Range is {0,1,2}
0: NoSwitch,always use day options
1: Switch depends on brightness
2: Switch depends on time, switch to NightOptions when time is after sunset
time and before sunrise.
3: NoSwitch,always use NightOptions
4:No switch,always use NormalOptions.
head.NightOptions.Profile
integer
Range is {0,1,2,3}
0: use temporary day options
1: use temporary NightOptions
2: use temporary NormalOptions
3:depends on head.NightOptions.SwitchMode.
head.NightOptions.ExposureSpeed
integer
head.NightOptions.ExposureValue1
float
Example:
head.NightOptions.ExposureValue2
float
head.NightOptions.Gain
integer
head. ExposureSpeed
head.NightOptions.GainAuto
bool
head.NightOptions.GainBlue
integer
head.NightOptions.GainGreen
integer
head.NightOptions.GainRed
integer
head.NightOptions.WhiteBalance
String
head.NightOptions.ReferenceLevel
integer
head.NightOptions.ExternalSyncPhase
integer
head.NightOptions.AntiFlicker
integer
head.NightOptions.Backlight
integer
head.NightOptions.DayNightColor
integer
head.NightOptions.ExposureMode
integer
head.NightOptions.GlareInhibition
integer
head.NightOptions.Mirror
integer
head.NightOptions.Flip
integer
head.NightOptions.Rotate90
integer
head.NomalOptions.BrightnessThreshold
integer
head.NormalOptions.IrisAuto
bool
head.NormalOptions.SunriseHour
integer
head.NormalOptions.SunriseMinute
integer
head.NormalOptions.SunriseSecond
integer
head.NormalOptions.SunsetHour
integer
head.NormalOptions.SunsetMinute
integer
head.NormalOptions.SunsetSecond
integer
head.NormalOptions.ExposureSpeed
integer
Head.NormalOptions.ExposureValue1
float
head.NormalOptions.ExposureValue2
float
head.NormalOptions.Gain
integer
head.NormalOptions.GainAuto
bool
head.NormalOptions.GainBlue
integer
head.NormalOptions.GainGreen
integer
head.NormalOptions.GainRed
integer
head.NormalOptions.WhiteBalance
String
head.NormalOptions.ReferenceLevel
integer
head.NormalOptions.ExternalSyncPhase
integer
head.NormalOptions.AntiFlicker
integer
head.NormalOptions.Backlight
integer
head.NormalOptions.DayNightColor
integer
head.NormalOptions.ExposureMode
integer
head.NormalOptions.GlareInhibition
integer
head.NormalOptions.Mirror
integer
head.NormalOptions.Flip
integer
head.NormalOptions.Rotate90
integer
4.4VideoEncode
4.4.1 GetVideoConfigCaps
URL Syntax
http://<ip>/cgi-bin/encode.cgi?action=getConfigCaps
Description
Response
headMain.Video.BitRateOptions=448,2560
headMain.Video.CompressionTypes=H.264,MJPG
headMain.Video.FPSMax=25
headMain.Video.ResolutionTypes=2048 x 1536,1080,SXGA, 1280 x 960,720,D1,CIF
headExtra.Video.BitRateOptions=80,448
headExtra.Video.CompressionTypes=H.264,MJPG
headExtra.Video.FPSMax=25
headExtra.Video.ResolutionTypes=D1,CIF
headSnap.Video.CompressionTypes=H.264,MJPG
headSnap.Video.ResolutionTypes=2048 x 1536,1080,SXGA, 1280 x 960,720,D1,CIF
Comment
In above table:
Channel: video channel index
RecordType:
0 = regular record
1 = motion detection record
2 = alarm record
ExtraStream:
0 = extra stream 1
1 = extra stream 2
2 = extra stream 3
SnapType:
0 = regular snapshot
1 = motion detection snapshot
2 = alarm snapshot
Abbreviations in below table:
headMain= caps[Channel].MainFormat[RecordType]
headExtra = caps[Channel].ExtraFormat[ExtraStream]
headSnap = caps[Channel].SnapFormat[SnapType]
Field in respons
Value range
Description
BitRateOptions
string
Before comma is minimum bit rate. (kbps), after comma is maximum bit rate.(kbps)
BitRateOptions=80,448
FPSMax
ResolutionTypes
string
integer
string
4.4.2 Resolution
Fixed Resolution Name
Size in PAL
Size in NTSC
"D1"
704 x 576
704 x 480
"HD1"
352 x 576
352 x 480
"BCIF"
704 x 288
704 x 240
"CIF"
352 x 288
352 x 240
"QCIF"
176 x 144
176 x 120
"VGA"
640 x 480
"QVGA"
320 x 240
"SVCD"
480 x 480
"QQVGA"
160 x 128
"SVGA"
800 x 592
"XVGA"
1024 x 768
"WXGA"
1280 x 800
"SXGA"
1280 x 1024
"WSXGA"
1600 x 1024
"UXGA"
1600 x 1200
"WUXGA"
1920 x 1200
"ND1"
240 x 192
"720"
1280 x 720
"1080"
1920 x 1080
"1280x960"
"1872x1408"
"3744x1408"
"2048x1536"
"2432x2048"
"1216x1024"
"1408x1024"
"3296x2472"
"2560x1920"
"960H",
960 x 576
"DV720P"
960 x 720
960 x 480
4.4.3 GetVideoEncodeConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=Encode
Response
headMain.Video.BitRate=8192
headMain.Video.BitRateControl=CBR
headMain.Video.Compression=H.264
headMain.Video.FPS=25
headMain.Video.GOP=50
headMain.Video.Height=1200
headMain.Video.Profile=Main
headMain.Video.Quality=4
headMain.Video.Width=1600
headMain.VideoEnable=true
headExtra.Video.BitRate=8192
headExtra.Video.BitRateControl=CBR
headExtra.Video.Compression=H.264
headExtra.Video.FPS=25
headExtra.Video.GOP=50
headExtra.Video.Height=1200
headExtra.Video.Profile=Main
headExtra.Video.Quality=4
headExtra.Video.Width=1600
headExtra.VideoEnable=true
Comment
4.4.4 SetVideoEncodeConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
RecordType:
0 = regular record
1 = motion detection record
2 = alarm record
ExtraStream:
0 = extra stream 1
1 = extra stream 2
2 = extra stream 3
Abbreviation in below table:
head=Encode[Channel].MainFormat[RecordType] (or)
Encode[Channel].ExtraFormat[ExtraStream]
Response
OK or ERROR
ParamName
ParamValue type
Description
head.Video.BitRate
integer
Unit is Kbps
Range depends on capability in 4.4.1 GetVideoConfigCaps
head.Video.BitRateControl
string
Range is {CBR,VBR}
CBR: constant bitrate
VBR: variable bitrate, available when Video.Compression=H264
head.Video.Compression
String
head.Video.FPS
float
head.Video.GOP
integer
Range is [1-100].
Group of picture, its the interval of I Frame,
Example: GOP=50, means there is one I frame every 49 P or B frames
head.Video.Height
integer
Video height
head.Video.Width
integer
Video Width
head.Video.Profile
String
head.Video.Quality
integer
Range is [1-6].
Image Quality, available when Video.BitRateControl=VBR
1: worst quality
6: best quality
head.VideoEnable
bool
4.5AudioEncode
4.5.1 GetAudioConfigCaps
URL Syntax
http://<ip>/cgi-bin/encode.cgi?action=getConfigCaps
Comment
Response
caps[0].ExtraFormat[0].Audio.CompressionTypes=PCM,G.711A,G.711Mu
caps[0].ExtraFormat[1].
caps[0].MainFormat[0].Audio.CompressionTypes=PCM,G.711A,G.711Mu
caps[0].MainFormat[1]
Field in respons
Value range
CompressionTypes
string
Description
It contains all supported audio compression types, separated by comma.
Range is {PCM, ADPCM, G.711A, G.711Mu, G.726, G.729, MPEG2, AMR}
4.5.2 GetAudioEncodeConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=Encode
Response
headMain.Audio.Bitrate=64
headMain.Audio.Compression=G.711A
headMain.Audio.Depth=16
headMain.Audio.Frequency=44000
headMain.Audio.Mode=0
headMain.AudioEnable=false
headExtra.Audio.Bitrate=64
headExtra.Audio.Compression=G.711A
headExtra.Audio.Depth=16
headExtra.Audio.Frequency=44000
headExtra.Audio.Mode=0
headExtra.AudioEnable=false
Comment
2 = extra stream 3
Abbreviations in above table:
headMain=table.Encode[Channel].MainFormat[RecordType]
headExtra=table.Encode[Channel].ExtraFormat[ExtraStream]
4.5.3 SetAudioEncodeConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
head.Audio.Bitrate
integer
Unit is kbps
Range depends on capacity in 4.5.1 GetAudioConfigCaps
head.Audio.Compression
string
head.Audio.Depth
integer
head.Audio.Frequency
integer
head.Audio.Mode
integer
Range is {0,1,2,3,4,5,6,7}
Audio encode mode.
0: 4.75kbps,
1: 5.15 kbps,
2: 5.9 kbps,
3: 6.7 kbps,
4: 7.4 kbps,
5: 7.95 kbps,
6: 10.2 kbps,
7: 12.2 kbps,
head.AudioEnable
bool
Enable/Disable audio
4.6 SnapEncode
4.6.1 GetSnapConfigCaps
URL Syntax
http://<ip>/cgi-bin/encode.cgi?action=getConfigCaps
Comment
Response
caps[Channel].SnapFormat[SnapType].Video.CompressionTypes=H.264,MJPG
caps[Channel].SnapFormat[SnapType].Video.ResolutionTypes=3M,1080,SXGA,1_3M,720,D1,CIF
Field in respons
Value range
CompressionTypes
string
ResolutionTypes
Description
It contains all supported video compression types separated by comma.
Range is {MPEG4, MPEG2, MPEG1, MJPG, H.263, H.264}
It contains all supported video resolutions, separated by comma.
string
Range is {D1, HD1, BCIF, CIF, QCIF, VGA, QVGA, SVGA, XVGA, WXGA, SXGA, WSXGA, UXGA,
WUXGA, ND1,720, 1080, 1_3M, 2_5M, 3M, 5M}.
4.6.2 GetSnapEncodeConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=Encode [Channel].SnapFormat
Response
headSnap.Video.BitRate=384
headSnap.Video.BitRateControl=VBR
headSnap.Video.Compression=H.264
headSnap.Video.FPS=1
headSnap.Video.GOP=50
headSnap.Video.Height=576
headSnap.Video.Quality=4
headSnap.Video.Width=704
headSnap.VideoEnable=true
Comment
4.6.3 SetSnapEncodeConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
head.Video.BitRate
integer
Unit is Kbps
Range depends on capability in 4.3.1 GetVideoInputCaps
head.Video.BitRateControl
string
Range is {CBR,VBR}
CBR: constant bitrate
VBR: variable bitrate
head.Video.Compression
String
head.Video.FPS
float
Range is [0.2-30]. The lower limit can be reached 0.00002 with firmware 2.4 and
above.
Frames per second.
< 1.0: several seconds/frame, FPS=0.3333: 3 seconds per frame.
>1.0: several frames/second. FPS=3: 3 frames per second.
head.Video.GOP
integer
Range is [1-100].
Group of picture, its the interval of I Frame,
Example: GOP=50, means there is one I frame every 49 P or B frames
head.Video.Height
integer
Video height
head.Video.Width
integer
Video Width
head.Video.Quality
integer
Range is [1-6].
Image Quality, available when Video.BitRateControl=VBR
1: worst quality
6: best quality
head.VideoEnable
bool
4.7ChannelTitle
4.7.1 GetChannelTitleConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=ChannelTitle
Comment
Response
table.ChannelTitle[Channel].Name=CAM1
4.7.2 SetChannelTitleConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
ChannelTitle[Channel].Name
String
Channel Name
4.8VideoStandard
4.8.1 GetVideoStandardConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoStandard
Comment
Response
table.VideoStandard=PAL
4.8.2 SetVideoStandardConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
VideoStandard
string
Range is {PALNTSC}
Video Standard
4.9VideoWidget
4.9.1 GetVideoWidgetConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoWidget
Description
VideoWidget config contains ChannelTitle, Covers and TimeTitle parameters, defines the background color, front color and
positions of channel title and time title, and defines the regions which are not visible (cover).
Response
head.BackColor[0]=0
head.BackColor[1]=0
head.BackColor[2]=0
head.BackColor[3]=128
head.EncodeBlend=true
head.FrontColor[0]=255
head.FrontColor[1]=255
head.FrontColor[2]=255
head.FrontColor[3]=0
head.Rect[0]=0
head.Rect[1]=8191
head.Rect[2]=0
head.Rect[3]=8191
Comment
4.9.2 SetVideoWidgetConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
= VideoWidget[Channel].Covers[CoReg]
headTimeTitle
= VideoWidget[Channel].TimeTitle
headCustomTitle = VideoWidget[Channel].CustomTitle
VideoWidgetConfig contains cover region settings, channel title settings and time title settings.
The italics below will be replaced by the above abbreviations.
Response
OK or ERROR
ParamName
ParamValue type
Description
headCover.BackColor[0]
integer
Range is [0-255].
headCover.BackColor[1]
BackColor[0]:red value
headCover.BackColor[2]
BackColor[1]:green value
headCover.BackColor[3]
BackColor[2]:blue value
BackColor[3]: alpha value
headCover.EncodeBlend
bool
headCover.FrontColor[0]
integer
Range is [0-255].
headCover.FrontColor[1]
FrontColor[0]:red value
headCover.FrontColor[2]
FrontColor[1]:green value
headCover.FrontColor[3]
FrontColor[2]:blue value
FrontColor[3]: alpha value
headCover.Rect[0]
integer
Range is [0-8191].
headCover.Rect[1]
headCover.Rect[2]
headCover.Rect[3]
headChannelTitle.BackColor[0]
integer
headChannelTitle.BackColor[1]
headChannelTitle.BackColor[2]
headChannelTitle.BackColor[3]
headChannelTitle.EncodeBlend
bool
headChannelTitle.FrontColor[0]
integer
headChannelTitle.FrontColor[1]
headChannelTitle.FrontColor[2]
headChannelTitle.FrontColor[3]
headChannelTitle.Rect[0]
integer
headChannelTitle.Rect[1]
as (left,top)
headChannelTitle.Rect[2]
Rect[0], Rect[1] are used, and Rect[2] must be same with Rect[0],
headChannelTitle.Rect[3]
headTimeTitle.BackColor[0]
integer
headTimeTitle.BackColor[1]
headTimeTitle.BackColor[2]
headTimeTitle.BackColor[3]
headTimeTitle.EncodeBlend
bool
headTimeTitle.FrontColor[0]
integer
headTimeTitle.FrontColor[1]
headTimeTitle.FrontColor[2]
headTimeTitle.FrontColor[3]
headTimeTitle.Rect[0]
integer
headTimeTitle.Rect[1]
headTimeTitle.Rect[2]
headTimeTitle.Rect[3]
headTimeTitle.ShowWeek
bool
headCustomTitle.BackColor[0]
integer
headCustomTitle.BackColor[1]
headCustomTitle.BackColor[2]
headCustomTitle.BackColor[3]
headCustomTitle.EncodeBlend
bool
headCustomTitle.FrontColor[0]
integer
headCustomTitle.FrontColor[1]
headCustomTitle.FrontColor[2]
headCustomTitle.FrontColor[3]
headCustomTitle.Rect[0]
integer
Range is [0-8191].
headCustomTitle.Rect[1]
headCustomTitle.Rect[2]
headCustomTitle.Rect[3]
PTZPreset.BackColor[0]
integer
PTZPreset.BackColor[1]
PTZPreset.BackColor[2]
PTZPreset.BackColor[3]
PTZPreset.EncodeBlend
bool
PTZPreset.FrontColor[0]
integer
PTZPreset.FrontColor[1]
PTZPreset.FrontColor[2]
PTZPreset.FrontColor[3]
PTZPreset.Rect[0]
integer
Range is [0-8191].
PTZPreset.Rect[1]
PTZPreset.Rect[2]
PTZPreset.Rect[3]
4.10VideoOut
4.10.1 GetVideoOutConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoOut
Description
Response
head.Margin[0]=0
head.Margin[1]=0
head.Margin[2]=0
head.Margin[3]=0
head.Color.Brightness=50
head.Color. Contrast =50
head.Color. Satuation =50
head.Color. Hue =50
head.Mode. Width =800
head.Mode. Height=600
head.Mode. BPP =16
head.Mode. Format =Auto
head.Mode. RefreshRate =60
Comment
head = table.VideoOut[channel].
4.10.2 SetVideoOutConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
head.Margin[0]
integer
Margin
head.Color.Brightness
integer
Brightness
head.Color.Contrast =50
integer
Contrast
head.Color.Satuation =50
integer
Satuation
head.Margin[1]
head.Margin[2]
head.Margin[3]
head.Color.Hue =50
integer
Hue
head.Mode.Width =800
integer
Resolution
head.Mode.Height=600
head.Mode.BPP =16
integer
head.Mode.Format =Auto
string
head.Mode.RefreshRate =60
integer
Refresh rate.
4.11FlashLight
4.11.1 GetFlashLightConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=FlashLight
Description
Response
head .Brightness=50
head.Enable=false
head.TimeSection[0][0]=1 00:00:00-23:59:59
head.TimeSection[0][1]=0 00:00:00-23:59:59
head.TimeSection[6][5]=0 00:00:00-23:59:59
Comment
head = table.FlashLight
4.11.2 SetFlashLightConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
FlashLight.Enable
bool
Enable
FlashLight.Brightness
integer
Brightness
FlashLight.TimeSection[wd][ts]
string
Its table contains effective time period for flash light everyday.
wd (week day) range is [0-6] (Sunday-Staurday)
ts (time section) range is [0-23], its index of timesection table.
Format: mask hh:mm:ss-hh:mm:ss
Mask: {0,1}, hh: [0-24], mm: [00-59], ss: [00-59]
Mask 0: this time section is not used.
Mask 1: this time section is used.
Example:
TimeSection[1][0]=1 12:00:00-18:00:00
Means flash light is effective between 12:00:00 and 18:00:00 at
Monday.
5.NetWork
5.1NetInterfaces
5.1.1 GetInterfaces
URL Syntax
http://<ip>/cgi-bin/netApp.cgi?action=getInterfaces
Comment
- 3G network interface
netInterface[0].Name=eth0
netInterface[0].Type=Normal
netInterface[0].Valid=true
netInterface[1].
5.2BasicConfig
5.2.1 GetBasicConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=Network
Comment
Basic config contains basic network parameters (Default interface, domain name, host name), and configuration of each
network interface.
interface in below table is network interface name, such as eth0, eth2
Response
table.Network.DefaultInterface=eth0
table.Network.Domain=CPPLUS
table.Network.Hostname=badak
table.Network.interface.DefaultGateway=10.7.0.1
table.Network.interface.DhcpEnable=false
table.Network.interface.DnsServers[0]=221.123.33.228
table.Network.interface.DnsServers[1]=221.12.1.228
table.Network.interface.IPAddress=10.7.2.3
table.Network.interface.MTU=1500
table.Network.interface.PhysicalAddress=00:10:5c:f2:1c:b4
table.Network.interface.SubnetMask=255.255.0.0
5.2.2 SetBasicConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
NetWork.DefaultInterface
string
NetWork.Domain
string
Domain name.
NetWork.Hostname
string
Network.interface.DefaultGateway
string
IP address
Network.interface.DhcpEnable
bool
Enable/Disable DHCP.
Network.interface.DnsServers[0]
string
Network.interface.DnsServers[1]
string
Network.interface.IPAddress
string
Interface IP address.
Network.interface.MTU
integer
Interface MTU.
Network.interface.PhysicalAddress
string
Network.interface.SubnetMask
string
5.3PPPoE
5.3.1 GetPPPoEConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=PPPoE
Comment
Response
table.PPPoE.Enable=false
table.PPPoE.Password=123456
table.PPPoE.UserName=123456
5.3.2 SetPPPoEConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
PPPoE.Enable
bool
Enable/Disable PPPoE.
PPPoE.UserName
string
PPPoE.Password
string
5.4DDNS
5.4.1 GetDDNSConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=DDNS
Comment
Response
table.DDNS[index].Address=www.cpplusworld.com
table.DDNS[index].Enable=true
table.DDNS[index].HostName=www.cpplusworld.com
table.DDNS[index].KeepAlive=10
table.DDNS[index].Password=none
table.DDNS[index].Port=5050
table.DDNS[index].Protocol=CPPLUS
table.DDNS[index].UserName=user1
5.4.2 SetDDNSConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
DDNS[index].Address
string
DDNS[index].Enable
bool
DDNS[index].HostName
String
DDNS[index].KeepAlive
integer
Range is [1-65535].
Unit is minutes.
DDNS[index].Password
string
DDNS[index].Port
integer
Range is [1-65535].
Port of DDSN server
DDNS[index].Protocol
string
DDNS[index].UserName
string
5.5Email
5.5.1 GetEmailConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=Email
Comment
Response
table.Email.Address=www.cpplusworld.com
table.Email.Anonymous=true
table.Email.AttachEnable=true
table.Email.AttachmentEnable=true
table.Email.Enable=true
table.Email.HealthReport.Enable=false
table.Email.HealthReport.Interval=61
table.Email.Password=123456
table.Email.Port=26
table.Email.Receivers[0]=x@cpplusworld.com.com
table.Email.Receivers[1]=y@cpplusworld.com.com
table.Email.Receivers[2]=z@cpplusworld.com.com
table.Email.SendAddress=x@cpplusworld.com.com
table.Email.SslEnable=false
table.Email.Title=DVRMessage
table.Email.UserName=anonymitty
5.5.2 SetEmailConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
Email.Address
string
Email.Anonymous
bool
Email.AttachEnable
bool
Email.AttachmentEnable
bool
Email.Enable
bool
Email.HealthReport.Enable
bool
Email.HealthReport.Interval
integer
Range is [30-1440].
Unit is minutes
Email.Password
string
Email.Port
integer
Range is [1-65535]
Email.Receivers[0]
string
Email.Receivers[1]
string
Email.Receivers[2]
string
Email.SendAddress
string
Email.SslEnable
bool
Email.Title
string
Title of email.
Email.UserName
string
5.6Wlan
5.6.1 GetWlanConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=WLan
Comment
Response
table.WLan.eth2.Enable=true
table.WLan.eth2.Encryption=off
table.WLan.eth2.KeyFlag=false
table.WLan.eth2.KeyID=0
table.WLan.eth2.KeyType=Hex
table.WLan.eth2.Keys[0]=password1
table.WLan.eth2.Keys[1]=password2
table.WLan.eth2.Keys[2]=password3
table.WLan.eth2.Keys[3]=password4
table.WLan.eth2.LinkMode=Auto
table.WLan.eth2.SSID=CPPLUS
5.6.2 SetWlanConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
interface is name of wireless interface, to get all the network interfaces and their properties, refer to 5.1:NetInterfaces.
Response
OK or ERROR
ParamName
ParamValue type
Description
WLan.interface.Enable
bool
WLan.interface.Encryption
string
WLan.interface.KeyFlag
bool
WLan.interface.KeyID
integer
Range is [0-3]
Indicates which key is used.
0 : WLan.interface.Keys[0] is used.
WLan.interface.KeyType
string
WLan.interface.Keys[0]
string
WLan.interface.Keys[1]
string
WLan.interface.Keys[2]
string
a-z, A-Z]
WLan.interface.Keys[3]
string
For HEX key type: 64bits encryption key length is 10,
128bits encryption key length is 26, consists of [0-9,
a-z, A-Z]
WLan.interface.LinkMode
string
string
5.7UPnP
5.7.1 GetUPnPConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=UPnP
Comment
Response
table.UPnP.Enable=true
table.UPnP.MapTable[index].Enable=true
table.UPnP.MapTable[index].InnerPort=80
table.UPnP.MapTable[index].OuterPort=8080
table.UPnP.MapTable[index].Protocol=TCP
table.UPnP.MapTable[index].ServiceName=HTTP
5.7.2 SetUPnPConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
UPnP.Enable
bool
UPnP.MapTable[index].Enable
bool
UPnP.MapTable[index].InnerPort
integer
Range is [1-65535].
Inner port number
UPnP.MapTable[index].OuterPort
integer
Range is [1-65535].
Outer port number.
UPnP.MapTable[index].Protocol
string
UPnP.MapTable[index].ServiceName
string
5.7.3 GetUPnPStatus
URL Syntax
http://<ip>/cgi-bin/netApp.cgi?action=getUPnPStatus
Comment
Response
rsult=1
5.8NTP
5.8.1 GetNTPConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=NTP
Comment
Response
table.NTP.Address=clock.isc.org
table.NTP.Enable=false
table.NTP.Port=38
table.NTP.TimeZone=9
table.NTP.UpdatePeriod=31
5.8.2 SetNTPConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
NTP.Address
string
NTP.Enable
bool
NTP.Port
integer
Range is [1-65535].
Port of NTP server.
NTP.TimeZone
integer
Range is [0-32].
0:
"GMT+00:00"
1:
"GMT+01:00"
2:
"GMT+02:00"
3:
"GMT+03:00"
4:
"GMT+03:30"
NTP.UpdatePeriod
integer
5:
"GMT+04:00"
6:
"GMT+04:30"
7:
"GMT+05:00"
8:
"GMT+05:30"
9:
"GMT+05:45"
10:
"GMT+06:00"
11:
"GMT+06:30"
12:
"GMT+07:00"
13:
"GMT+08:00"
14:
"GMT+09:00"
15:
"GMT+09:30"
16:
"GMT+10:00"
17:
"GMT+11:00"
18:
"GMT+12:00"
19:
"GMT+13:00"
20:
"GMT-01:00"
21:
"GMT-02:00"
22:
"GMT-03:00"
23:
"GMT-03:30"
24:
"GMT-04:00"
25:
"GMT-05:00"
26:
"GMT-06:00"
27:
"GMT-07:00"
28:
"GMT-08:00"
29:
"GMT-09:00"
30:
"GMT-10:00"
31:
"GMT-11:00"
32:
"GMT-12:00"
5.9RTSP
5.9.1 GetRTSPConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=RTSP
Comment
Response
table.RTSP.Enable=true
table.RTSP.Port=554
table.RTSP.RTP.EndPort=40000
table.RTSP.RTP.StartPort=20000
5.9.2 SetRTSPConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
RTSP.Enable
bool
Enable/Disable RTSP.
RTSP.Port
integer
RTSP port.
RTSP.RTP.StartPort
integer
RTSP.RTP.EndPort
integer
6.Events
6.1EventHandler
EventHandler is used in alarm and event config in following sections. It contains settings for actions linked with alarm and events. Actions
include record, snapshot, PTZ action, log, mail, alarm out and so on.When alarm or event happen, actions defined in alarm EventHandler and
event EventHandler are executed.
6.1.1 GetEventHandler
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=<handlerName>
Comment
Response
handlerName.EventHandler.AlarmOutChannels[0]=1
handlerName.EventHandler.AlarmOutChannels[1]=1
handlerName.EventHandler.AlarmOutEnable=false
handlerName.EventHandler.AlarmOutLatch=10
handlerName.EventHandler.BeepEnable=true
handlerName.EventHandler.Dejitter=0
handlerName.EventHandler.Delay=30
handlerName.EventHandler.LogEnable=true
handlerName.EventHandler.MailEnable=true
handlerName.EventHandler.PtzLink[0][0]=None
handlerName.EventHandler.PtzLink[0][1]=0
handlerName.EventHandler.PtzLink[1][0]=None
handlerName.EventHandler.PtzLink[1][1]=0
handlerName.EventHandler.PtzLinkEnable=false
handlerName.EventHandler.RecordChannels[0]=1
handlerName.EventHandler.RecordChannels[1]=1
handlerName.EventHandler.RecordEnable=true
handlerName.EventHandler.RecordLatch=10
handlerName.EventHandler.SnapshotChannels[0]=1
handlerName.EventHandler.SnapshotChannels[1]=1
handlerName.EventHandler.SnapshotEnable=false
handlerName.EventHandler.SnapshotPeriod=3
handlerName.EventHandler.SnapshotTimes=0
handlerName.EventHandler.TimeSection[0][0]=1 01:00:00-24:00:00
handlerName.EventHandler.TimeSection[0][1]=1 01:00:00-24:00:00
handlerName.EventHandler.TimeSection[6][5]=1 01:00:00-24:00:00
handlerName.EventHandler.TipEnable=true
handlerName.EventHandler. ExAlarmOutEnable=true
handlerName. ExAlarmOutChannels[0] =2
handlerName.ExAlarmOutChannels[1]=3
6.1.2 SetEventHandler
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
paramName
paramValue
Description
type
handlerName.EventHandler.AlarmOutChannels[ch]
integer
handlerName.EventHandler.AlarmOutEnable
bool
handlerName.EventHandler.AlarmOutLatch
Integer
Range is [10-300].
Unit is seconds, indicates the time to output alarm after input alarm is
cleared.
handlerName.EventHandler.BeepEnable
bool
Enable/Disable beep.
handlerName.EventHandler.Dejitter
integer
Range is [0-255].
Alarm signal dejitter seconds. Alarm signal change during this period is
ignored.
handlerName.EventHandler.Delay
integer
Range is [0-300].
Delay seconds before setting take effect.
handlerName.EventHandler.LogEnable
bool
handlerName.EventHandler.MailEnable
bool
handlerName.EventHandler.PtzLink[ch][0]
string
handlerName.EventHandler.PtzLink[ch][1]
integer
handlerName.EventHandler.PtzLinkEnable
Bool
handlerName.EventHandler.RecordChannels[ch]
Integer
Range is {0, 1}
0 do not record on video channel ch
1 record. on video channel ch
handlerName.EventHandler.RecordEnable
bool
handlerName.EventHandler.RecordLatch
integer
Range is [10-300].
Unit is seconds, indicates the time to record after input alarm is cleared..
handlerName.EventHandler.SnapshotChannels[ch]
integer
Range is {0, 1}
0 do not snapshot on video channel ch
1 snapshot on video channel ch
handlerName.EventHandler.SnapshotEnable
bool
handlerName.EventHandler.SnapshotPeriod
integer
Range is [0-255].
Frames between snapshot.
0 means continuously snapshot for every frame.
handlerName.EventHandler.SnapshotTimes
integer
Range is [0-65535]
Snapshot times before stop, 0 means dont stop snapshot.
handlerName.EventHandler.TimeSection[wd][ts]
String
handlerName.EventHandler.TipEnable
bool
handlerName.EventHandler. ExAlarmOutEnable
bool
handlerName. ExAlarmOutChannels[channels]
integer
6.2Alarm
6.2.1 GetAlarmConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=Alarm
Comment
Response
table.Alarm[0].Enable=false
table.Alarm[0].EventHandler.(output of EventHandler is described in 6.1.1 GetEventHandler)
table.Alarm[0].Name=Door1
table.Alarm[0].SensorType=NC
table.Alarm[1].
6.2.2 SetAlarmConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
In below table, input is external alarm input channel, ch is channel number, wd is weekday index, ts is timesection index.
EventHandler defines parameter of relevant actions when alarm or event happens. Its also used in following sections about
events.
Response
OK or ERROR
ParamName
ParamValue type
Description
Alarm[input].Enable
bool
Alarm[input].EventHandler
Alarm[input].Name
string
Alarm[input].SensorType
string
6.2.3 GetAlarmOutConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=AlarmOut
Comment
Response
table.AlarmOut[alarmOutChannel].Mode=0
table.AlarmOut[alarmOutChannel].Name=Beep
6.2.4 SetAlarmOutConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
AlarmOut[port].Mode
integer
Range is {0, 1, 2}
0: automatically alarm
1: force alarm
2: close alarm
AlarmOut[port].Name
string
6.2.5 GetInSlots
URL Syntax
http://<ip>/cgi-bin/alarm.cgi?action=getInSlots
Comment
Response
result=2
6.2.6 GetOutSlots
URL Syntax
http://<ip>/cgi-bin/alarm.cgi?action=getOutSlots
Comment
Response
result=1
6.2.7 GetInState
URL Syntax
http://<ip>/cgi-bin/alarm.cgi?action=getInStates
Comment
Response
result=3
6.2.8 GetOutState
URL Syntax
http://<ip>/cgi-bin/alarm.cgi?action=getOutStates
Comment
Response
result=0
6.2.9 GetChannelInState
URL Syntax
http://<ip>/cgi-bin/alarm.cgi?action=getInStates&channel=<channelNo>
Comment
Get alarm input state for channelNo. channelNo starts from 0, and must be less than alarm input channels obtained from
6.2.5 GetInSlots.
Result 1 means alarm is present. Result 0 means alarm is not present.
Response
result=1
6.2.10 GetChannelOutState
URL Syntax
http://<ip>/cgi-bin/alarm.cgi?action=getOutStates&channel=<channelNo>
Comment
Get alarm output state for channelNo. channelNo starts from 0, and must be less than alarm output channels obtained
from 6.2.6 GetOutSlots .
Result 1 means alarm is present. Result 0 means alarm is not present.
Response
result=0
6.3MotionDetect
6.3.1 GetMotionDetectConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=MotionDetect
Comment
MotionDetect config of a video channel contains Enable, Level, Region and EventHandler.
Response
table.MotionDetect[0].Enable=false
table.MotionDetect[0].EventHandler (output of EventHandler is described in 6.1.1 GetEventHandler)
table.MotionDetect[0].Level=3
table.MotionDetect[0].Region[0]=3932160
table.MotionDetect[0].Region[1]=3932160
table.MotionDetect[0].MotionDetectWindow[0].Id=0
table.MotionDetect[0].MotionDetectWindow[0].Name=Region0
table.MotionDetect[0].MotionDetectWindow[0].Sensitive=58
table.MotionDetect[0].MotionDetectWindow[0].Threshold=4
table.MotionDetect[0].MotionDetectWindow[0].Region[0]=3932160
table.MotionDetect[0].MotionDetectWindow[0].Region[1]=3932160
table.MotionDetect[1]
6.3.2 SetMotionDetectConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
WinNum
Index of detect window, there are 4 detect windows at present. Each window is divided into 18 lines and 22 blocks/line.
MotionDetectWindow is available with firmware 2.212 and above.
RegionIndex
It is similar with LineNum,but is beyond to a detect window.
Head = MotionDetect[Channel]
The italics below will be replaced by the above abbreviations.
Response
OK or ERROR
ParamName
ParamValue type
Description
head.Enable
bool
head.EventHandler
head.Level
Range is [1-6].
Sensitivity of motion detection.
1: lowest sensitivity.
6: highest sensitivity.
head.Region[LineNum]
integer
head.MotionDetectWindow
integer
string
integer
Range is [0-100].
[WinNum].Id
head.MotionDetectWindow
[WinNum].Name
head.MotionDetectWindow
[WinNum].Sensitive
head.MotionDetectWindow
[WinNum]. Threshold
head.MotionDetectWindow
Range is [0-100].
It presents the threshold value when trigger motion detect.
integer
[WinNum]. Region[RegionIndex]
6.4BlindDetect
6.4.1 GetBlindDetectConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=BlindDetect
Comment
Response
head.Enable=false
6.4.2 SetBlindDetectConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
head.Enable
bool
head.EventHandler
head.Level
Range is [1-6].
Sensitivity of blind detection.
1: lowest sensitivity.
6: highest sensitivity.
6.5LossDetect
6.5.1 GetLossDetectConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=LossDetect
Comment
Response
head.Enable=false
head.EventHandler= (output of EventHandler is described in 6.1.1 GetEventHandler)
6.5.2 SetLossDetectConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
head.Enable
bool
head.EventHandler
6.6LoginFailureAlarm
6.6.1 GetLoginFailureAlarmConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=LoginFailureAlarm
Comment
Response
head.Enable=false
head.EventHandler= (output of EventHandler is described in 6.1.1 GetEventHandler)
6.6.2 SetLoginFailureAlarmConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Head=LoginFailureAlarm
Response
OK or ERROR
ParamName
ParamValue type
Description
head.Enable
bool
head.EventHandler
6.7 StorageAbnormal
6.7.1 GetStorageNotExistConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=StorageNotExist
Comment
Response
StorageNotExist.Enable=false
StorageNotExist.EventHandler= (output of EventHandler is described in 6.1.1 GetEventHandler)
6.7.2 SetStorageNotExistConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
StorageNotExist.Enable
bool
StorageNotExist.EventHandler
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name= StorageFailure
Comment
Response
StorageFailure.Enable=false
StorageFailure.EventHandler= (output of EventHandler is described in 6.1.1 GetEventHandler)
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
StorageFailure.Enable
bool
StorageFailure.EventHandler
6.7.5 GetStorageLowSpaceConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name= StorageLowSpace
Comment
Response
StorageLowSpace.Enable=false
StorageLowSpace.EventHandler= (output of EventHandler is described in 6.1.1 GetEventHandler)
6.7.6 SetStorageLowSpaceConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
StorageLowSpace.Enable
bool
StorageLowSpace.EventHandler
6.8 NetAbnormal
6.8.1 GetNetAbortConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name= NetAbort
Comment
Response
NetAbort.Enable=false
NetAbort.EventHandler= (output of EventHandler is described in 6.1.1 GetEventHandler)
6.8.2 SetNetAbortConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
NetAbort.Enable
bool
NetAbort.EventHandler
6.8.3 GetIPConflictConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name= IPConflict
Comment
Response
IPConflict.Enable=false
IPConflict.EventHandler= (output of EventHandler is described in 6.1.1 GetEventHandler)
6.8.4 SetIPConflictConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
IPConflict.Enable
bool
IPConflict.EventHandler
6.9 GetEventIndexes
URL Syntax
http://<ip>/cgi-bin/eventManager.cgi?action=getEventIndexes&code=<eventCode>
Comment
Response
VideoMotion:
VideoLoss:
VideoBlind:
AlarmLocal:
channels[0]=0
channels[1]=2
channels[2]=3
(This response means event happened on channel 0, channel 2, and channel 3.)
6.10 Attach
URL Syntax
http://<ip>/cgi-bin/eventManager.cgi?action=attach&codes=[<eventCode>,<eventCode> ,]
Comment
VideoBlind:
AlarmLocal:
MDResult:
motion detection data reporting event. The motion detect window contains 18 rows and 22 columns. The
event info contains motion detect data with mask of every row.
Response
For example:
HTTP Code: 200 OK\r\n
Cache-Control: no-cache\r\n
Pragma: no-cache\r\n
Expires: Thu, 01 Dec 2099 16:00:00 GMT\r\n
Connection: close\r\n
Content-Type: multipart/x-mixed-replace; boundary=myboundary\r\n\r\n
Body:
-- myboundary \r\n
Content-Type: text/plain\r\n
Content-Length: 39\r\n
Code=VideoMotion;action=Start;index=0\r\n\r\n
-- myboundary \r\n
Content-Type: text/plain\r\n
Content-Length: 38\r\n
Code=VideoBlind;action=Start;index=0\r\n\r\n
-- myboundary \r\n
Content-Type: text/plain\r\n
Content-Length: 38\r\n
Code= AlarmLocal;action=Start;index=0\r\n\r\n
-- myboundary \r\n
Content-Type: text/plain\r\n
Content-Length: 38\r\n
Code= MDResult;action=Pulse;index=0;data=61708863,61708863\r\n\r\n
-- myboundary \r\n
7.PTZ
7.1PTZConfig
7.1.1 GetPTZConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=Ptz
Comment
Response
table.Ptz[port].Address=8
table.Ptz[port].Attribute[0]=115200
table.Ptz[port].Attribute[1]=8
table.Ptz[port].Attribute[2]=Even
table.Ptz[port].Attribute[3]=1
table.Ptz[port].Homing[0]=0
table.Ptz[port].Homing[1]=30
table.Ptz[port].NumberInMatrixs=0
table.Ptz[port].ProtocolName=NONE
7.1.2 SetPTZConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
Ptz[port].Address
integer
Range is [0-255].
Device address, if there are more than one device connected to
this port, distinguish them by this address.
Ptz[port].Attribute[0]
integer
Ptz[port].Attribute[1]
integer
Ptz[port].Attribute[2]
string
Ptz[port].Attribute[3]
float
Ptz[port].Homing[0]
integer
Range is {-1,0-255}
-1: homing is disabled.
[0-255]: preset point number
Ptz[port].Homing[1]
integer
Range is [0-65535].
No operation timeout, unit is seconds.
After no operation timeout, PTZ go to preset point set in
Ptz[port].Homing[0].
Ptz[port].ProtocolName
string
7.2PTZControl
7.2.1 GetProtocolList
URL Syntax
http://<ip>/cgi-bin/ptz.cgi?action=getProtocolList
Comment
Response
result=NONE,AD1641M,ADMATRIX,BANKNOTE,DH-CC440,DH-MATRIX,DH-SD1,DH-SD2,HAIYU,HY,LILIN,PANASONIC
7.2.2 GetCurrentProtocolCaps
URL Syntax
http://<ip>/cgi-bin/ptz.cgi?action=getCurrentProtocolCaps&channel=<channelNo>
Comment
Response
caps.AlarmLen=0
caps.AuxMax=8
caps.AuxMin=1
caps.CamAddrMax=255
caps.CamAddrMin=1
caps.Interval=200
caps.Menu=false
caps.MonAddrMax=255
caps.MonAddrMin=0
caps.Name=DH-SD1
caps.PanSpeedMax=255
caps.PanSpeedMin=1
caps.PatternMax=5
caps.PatternMin=1
caps.PresetMax=80
caps.PresetMin=1
caps.TileSpeedMax=255
caps.TileSpeedMin=1
caps.TourMax=7
caps.TourMin=0
caps.Type=1
Field in response
Description
AlarmLen
AuxMax
AuxMin
CamAddrMax
CamAddrMin
Menu
MonAddrMax
MonAddrMin
Name
PanSpeedMax
PanSpeedMin
PatternMax
PatternMin
PresetMax
PresetMin
TileSpeedMax
TileSpeedMin
TourMax
TourMin
Type
http://<ip>/cgi-bin/ptz.cgi?action=[action]&channel=[ch]&code=[code]&arg1=[argstr]& arg2=[argstr]&arg3=[argstr]
Comment
Response
OK or ERROR
Code
Code description
arg1
arg2
arg3
arg4
Up
Tile up
Vertical speed,
range is [1-8]
Down
Tile down
Vertical speed,
range is [1-8]
Left
Pan left
Vertical speed,
range is [1-8]
Right
Pan right
Vertical speed,
range is [1-8]
ZoomWide
Zoom out
multiple
ZoomTele
Zoom in
multiple
FocusNear
Focus near
multiple
FocusFar
Focus far
multiple
IrisLarge
Aperture larger
multiple
IrisSmall
Aperture smaller
multiple
GotoPreset
Preset point
1: start
number
SetPreset
Preset point
number
ClearPreset
Preset point
number
LampWaterClear
1: open
2: close
StartTour
Tour path
number
2: automatically
3: stop
LeftUp
RightUp
LeftDown
RightDown
AddTour
DelTour
ClearTour
Vertical speed,
Horizontal speed,
range is [1-8]
range is [1-8]
Vertical speed,
Horizontal speed,
range is [1-8]
range is [1-8]
Vertical speed,
Horizontal speed,
range is [1-8]
range is [1-8]
Vertical speed,
Horizontal speed,
range is [1-8]
range is [1-8]
Tour path
Preset point
number
number
Tour path
Preset point
path
number
number
Tour path
number
AutoPanOn
AutoPanOff
SetLeftLimit
SetRightLimit
AutoScanOn
AutoScanOff
SetPatternBegin
Pattern number
SetPatternEnd
Pattern number
StartPattern
Pattern number
StopPattern
Pattern number
ClearPattern
Pattern number
AlarmSearch
Search alarm.
Position
Go to position
Horizontal
Vertical position
Zoom change
position
AuxOn
AuxOff
Menu
Exit
Enter
Esc
MenuUp
MenuDown
MenuLeft
MenuRight
Preset point
External alarm
Link type
Argument of link
input channel.
1: go to preset
type:
point
Link type = 1,
2: auto scan
3: tour
number
Reset
SetPresetName
number (1 byte)
AlarmPtz
Link type = 2,
this is auto scan
path
Link type = 3,
this is tour path
LightController
Address of light
Light number
switch
Horizontal angle:
Vertical
Zoom in mutiple
Speed[1-8], not
0-360
angle :0-90
controller
PositionABS
PositionReset
Go to ABS position
must
reference.
UpTele
up + TELE
Speed [1-8]
DownTele
down + TELE
Speed [1-8]
LeftTele
left + TELE
Speed [1-8]
RightTele
right + TELE
Speed [1-8]
LeftUpTele
leftup + TELE
Speed [1-8]
LeftDownTele
leftdown + TELE
Speed [1-8]
RigjtUpTele
rightup + TELE
Speed [1-8]
RightDownTele
rightdown + TELE
Speed [1-8]
UpWide
up + WIDE
Speed [1-8]
DownWide
down + WIDE
Speed [1-8]
LeftWide
left + WIDE
Speed [1-8]
RightWide
right + WIDE
Speed [1-8]
LeftUpWide
leftup + WIDE
Speed [1-8]
LeftDownWide
leftdown + WIDE
Speed [1-8]
RightUpWide
rightup + WIDE
Speed [1-8]
RightDownWide
rightdown + WIDE
Speed [1-8]
Continuously
Move Continuously
Horizontal Speed
Vertical Speed
Timeout
Relatively
Move Relatively
[-8-8]
[-8-8]
Relatively angle:
Relatively
0-360
angle :0-90
Relatively
Zoom
7.3PTZStatus
7.3.1 PTZ GetStatus
URL Syntax
http://<ip>/cgi-bin/ptz.cgi?action=getStatus
Comment
Response
status.UTC=6538920
status.MoveStatus=Idle
status.ZoomStatus=Idle
status.PresetID=10
status.Position=120,12,2
8.Record&Snap
8.1Record
8.1.1 GetRecordConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=Record
Comment
Channel in below table is video channel number, weekday range is [0-6] (Sunday - Saturday).
Record config contains pre record time and record time sections of every day.
Response
table.Record[channel].PreRecord=6
table.Record[channel].HolidayEnable=true
table.Record[channel].TimeSection[weekday][0]=1 00:00:00-24:00:00
table.Record[channel].TimeSection[weekday][1]=0 02:00:00-24:00:00
table.Record[channel].TimeSection[weekday][2]=0 03:00:00-24:00:00
table.Record[channel].TimeSection[weekday][3]=0 04:00:00-24:00:00
table.Record[channel].TimeSection[weekday][4]=0 05:00:00-24:00:00
table.Record[channel].TimeSection[weekday][5]=0 06:00:00-24:00:00
8.1.2 SetRecordConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
In below table: ch = channel index, wd = week day index, ts = time section index
Response
OK or ERROR
ParamName
ParamValue type
Description
Record[ch].PreRecord
integer
Range is [0-300].
Prerecord seconds, 0 means no prerecord.
ch (Channel number) starts form 0
Record[ch]. HolidayEnable
bool
Record[ch].TimeSection[wd][ts]
string
Example:
Set record time to every Sunday all day. Record type is motion detection and alarm.
URL should be:
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&name=Record[0].TimeSection[0][0]&table=6 00:00:00-24:00:00
In this example, 6 00:00:00-24:00:00 means motion detection and alarm record all day (6 = 4 & 2, alarm is 4, motion detection is 2.).
8.1.3 GetRecordModeConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=RecordMode
Comment
Get record mode for video channels. channel in below table is video channel number.
Response
table.RecordMode[channel].Mode=0
8.1.4 SetRecordModeConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
RecordMode[channel].Mode
integer
8.2Snap
8.2.1 GetSnapConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=Snap
Comment
Channel in below table is video channel number, weekday range is [0-6] (Sunday - Saturday).
Response
table.Snap [channel].HolidayEnable=true
table.Snap[channel].TimeSection[weekday][0]=1 00:00:00-24:00:00
table.Snap[channel].TimeSection[weekday][1]=0 02:00:00-24:00:00
table.Snap[channel].TimeSection[weekday][2]=0 03:00:00-24:00:00
table.Snap[channel].TimeSection[weekday][3]=0 04:00:00-24:00:00
table.Snap[channel].TimeSection[weekday][4]=0 05:00:00-24:00:00
table.Snap[channel].TimeSection[weekday][5]=0 06:00:00-24:00:00
8.2.2 SetSnapConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
In below table: ch = channel index, wd = week day index, ts = time section index
Response
OK or ERROR
ParamName
ParamValue type
Description
Snap [ch].HolidayEnable
bool
Snap[ch].TimeSection[wd][ts]
string
8.3MediaGlobal
8.3.1 GetMediaGlobalConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=MediaGlobal
Description
Response
table.MediaGlobal.SnapFormatAs=MainFormat
8.3.2 SetMediaGlobalConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
MediaGlobal.SnapFormatAs
string
8.4Holiday
8.4.1 GetHolidayConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=Holiday
Description
Response
table.Holiday.MonthMask[0]=3
table.Holiday.MonthMask[1]=0
table.Holiday.MonthMask[2]=0
table.Holiday.MonthMask[3]=0
table.Holiday.MonthMask[4]=0
table.Holiday.MonthMask[5]=0
table.Holiday.MonthMask[6]=0
table.Holiday.MonthMask[7]=0
table.Holiday.MonthMask[8]=0
table.Holiday.MonthMask[9]= 1610612739
table.Holiday.MonthMask[10]=0
table.Holiday.MonthMask[11]=0
8.4.2 SetHolidayConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
monthIndex presents the index of a month. 0 presents January, 1 presents February, 11 presents December.
Response
OK or ERROR
ParamName
ParamValue type
Description
Holiday.MonthMask[monthIndex]
integer
9.System
9.1General
9.1.1 GetGeneralConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=General
Comment
Response
table.General.MachineName=CPPLUS001
table.General. LocalNo=8
table.General. MachineAddress=binjiangqv jiangnandadao weiyelu
table.General. MachineGroup=jiaojing yidui
table.General.LockLoginEnable=true
table.General.LockLoginTimes=3
table.General.LoginFailLockTime=1800
9.1.2 SetGeneralConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
General.MachineName
string
General. LocalNo
integer
General. MachineAddress
string
General. MachineGroup
string
General. LockLoginEnable
bool
General. LockLoginTimes
integer
General. LoginFailLockTime
integer
9.2SystemTime
9.2.1 GetCurrentTime
URL Syntax
http://<ip>/cgi-bin/global.cgi?action=getCurrentTime
Comment
The time format is "Y-M-D H-m-S". Its not be effected by Locales.TimeFormat in 9.3.2 SetLocalesConfig.
Response
9.2.2 SetCurrentTime
URL Syntax
http://<ip>/cgi-bin/global.cgi?action=setCurrentTime&time=2011-7-3%2021:02:32
Comment
The time format is "Y-M-D H-m-S". Its not be effected by Locales.TimeFormat in 9.3.2 SetLocalesConfig.
Response
OK or ERROR
9.3Locales
9.3.1 GetLocalesConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=Locales
Comment
Response
table.Locales.DSTEnable=false
table.Locales.DSTEnd.Day=1
table.Locales.DSTEnd.Hour=0
table.Locales.DSTEnd.Minute=0
table.Locales.DSTEnd.Month=1
table.Locales.DSTEnd.Week=2
table.Locales.DSTEnd.Year=2011
table.Locales.DSTStart.Day=0
table.Locales.DSTStart.Hour=0
table.Locales.DSTStart.Minute=0
table.Locales.DSTStart.Month=1
table.Locales.DSTStart.Week=1
table.Locales.DSTStart.Year=2011
table.Locales.TimeFormat=yyyy-MM-dd HH:mm:ss
9.3.2 SetLocalesConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue
Description
type
Locales.DSTEnable
bool
Locales.DSTEnd.Day
integer
Locales.DSTEnd.Hour
integer
Range is [0-23]
Locales.DSTEnd.Minute
integer
Range is [0-59]
Locales.DSTEnd.Month
integer
Range is [1-12]
Locales.DSTEnd.Week
Integer
Range is {1,2,3,4,-1,0}.
0 = Use month day
[1,2,3,4,-1]: use week day.
1 = first week, 2 = second, 3 = third, 4 = fourth, -1 = last.
Locales.DSTEnd.Year
Integer
Range is [2000-2038]
Locales.DSTStart.Day
Locales.DSTStart.Hour
Locales.DSTStart.Minute
Locales.DSTStart.Month
Locales.DSTStart.Week
Locales.DSTStart.Year
Locales.TimeFormat
string
9.4Language
9.4.1 GetLanguageCaps
URL Syntax
http://<ip>/cgi-bin/magicBox.cgi?action=getLanguageCaps
Comment
Get the list of supported languages, response is a string contains languages with comma separated.
Languages include
{English, SimpChinese, TradChinese, Italian, Spanish, Japanese, Russian, French, German]
Response
Languages=SimpChinese,English,French
9.4.2 GetLanguageConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=Language
Comment
Response
table.Language=SimpChinese
9.4.3 SetLanguageConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
Language
string
9.5AccessFilter
9.5.1 GetAccessFilterConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=AccessFilter
Comment
Response
table.AccessFilter.BannedList[bannedIndex]=10.6.10.1
table.AccessFilter. TrustList[trustIndex]=1.2.3.4
table.AccessFilter.Enable=false
table.AccessFilter.Type=BannedList
9.5.2 SetAccessFilterConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
AccessFilter.BannedList[index]
string
AccessFilter.TrustList[index]
string
AccessFilter.Enable
bool
AccessFilter.Type
string
9.6AutoMaintain
9.6.1 GetAutoMaintainConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=AutoMaintain
Comment
Response
table.AutoMaintain. AutoRebootDay=3
table.AutoMaintain. AutoRebootHour=0
table.AutoMaintain. AutoRebootMinute=0
table.AutoMaintain. AutoShutdownDay=1
table.AutoMaintain. AutoShutdownHour=0
table.AutoMaintain. AutoShutdownMinute=0
table.AutoMaintain. AutoStartUpDay=1
table.AutoMaintain. AutoStartUpHour=2
table.AutoMaintain. AutoStartUpMinute=0
9.6.2 SetAutoMaintainConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue
Description
type
AutoMaintain. AutoRebootDay
integer
Range is [-1-7].
Auto restart day.
-1 = never auto restart
0- 6 = Sunday-Saturday
7 = restart every day
AutoMaintain. AutoRebootHour
integer
Range is [0-23].
Auto restart hour
AutoMaintain. AutoRebootMinute
integer
Range is [0-59].
Auto restart minute
AutoMaintain. AutoShutdownDay
integer
AutoMaintain. AutoShutdownHour
AutoMaintain. AutoShutdownMinute
AutoMaintain. AutoStartUpDay
integer
AutoMaintain. AutoStartUpHour
AutoMaintain. AutoStartUpMinute
9.7UserManager
9.7.1 Group
There are two user groups: admin and user. The admin group has all the authorities of operating the IP Camera. The user group
only has monitor and replay authorities.
9.7.2 GetGroupInfo
URL Syntax
http://<ip>/cgi-bin/userManager.cgi?action=getGroupInfo&name=<groupName>
Comment
Response
group.Name=admin
group.Memo=administrator group
goup. AuthorityList=<authList>
9.7.3 GetGroupInfoAll
URL Syntax
http://<ip>/cgi-bin/userManager.cgi?action=getGroupInfoAll
Comment
Response
group[0].Name=admin
group[0].Memo=administrator group
group[0]. AuthorityList=<authList>
group[1].Name=user
group[1].Memo=user group
group[1]. AuthorityList=<authList>
group[2].
9.7.4 AddUser
URL Syntax
http://<ip>/cgi-bin/userManager.cgi?action=addUser&
user.Name=<userName>&
user.Password=<userPassword>&
user.Memo=<userMemo>&
user.Group=<userGroup>&
user.Reserved=<userReserved>&
user.Sharable=<userSharable>
user.AuthList=<authList>
Comment
user.Group: string, the range is admin and user. In different group, the user has different authorities.
user.Sharable: bool, true means allow multi-point login.
User.Reserved: bool, true means this user cant be deleted.
User.AuthList;.
For example:
Add a user of name operator, password 123456, belongs to group user, and allow multi-point login.
http://<ip>/cgi-bin/userManager.cgi?action=addUser&user.Name=operator&user.Password=123456&user.Group=user&us
er.Sharable=true&user.Reserved=false&user.AuthList= CtrlPanel,ShutDown, Record,Backup
Response
OK or ERROR
9.7.5 DeleteUser
URL Syntax
http://<ip>/cgi-bin/userManager.cgi?action=deleteUser&name=<userName>
Comment
Response
OK or ERROR
9.7.6 ModifyUser
URL Syntax
http://<ip>/cgi-bin/userManager.cgi?action=modifyUser&
name=<oldUserName>&
user.Name=<userName>&
user.Password=<userPassword>&
user.Memo=<userMemo>&
user.Group=<userGroup>&
user.Reserved=<userReserved>&
user.Sharable=<userSharable>
user.AuthList=<authList>
Comment
Response
OK or ERROR
9.7.7 ModifyPassword
URL Syntax
http://<ip>/cgi-bin/userManager.cgi?action=modifyPassword&name=<username>&pwd=<newPwd>&pwdOld=<oldPwd>
Comment
Modify user password, old password oldPwd should be supplied, new password is newPwd.
Response
OK or ERROR
9.7.8 GetUserInfo
URL Syntax
http://<ip>/cgi-bin/userManager.cgi?action=getUserInfo&name=<userName>
Comment
Response
user.Name=admin
user.Memo=admin 's account
user.Group=admin
user.Reserved=true
user.Sharable=true
user. AuthList=<authList>
9.7.9 GetUserInfoAll
URL Syntax
http://<ip>/cgi-bin/userManager.cgi?action=getUserInfoAll
Comment
Response
users[0].Group=admin
users[0].Id=1
users[0].Memo=admin 's account
users[0].Name=admin
users[0].Reserved=true
users[0].Sharable=true
users[0]. AuthList=<authList>
users[1].Group=admin
9.7.10 GetActiveUserInfoAll
URL Syntax
http://<ip>/cgi-bin/userManager.cgi?action=getActiveUserInfoAll
Comment
Response
users[0].name=admin
users[0].ip=10.43.2.16
users[0].group=admin
users[0].clienttype=web3.0
users[0].logintime=2011-11-08 09:51:03
9.8System Operation
9.8.1 Reboot
URL Syntax
http://<ip>/cgi-bin/magicBox.cgi?action=reboot
Comment
Response
OK or ERROR
9.8.2 Shutdown
URL Syntax
http://<ip>/cgi-bin/magicBox.cgi?action=shutdown
Comment
Response
OK or ERROR
9.8.3 GetDeviceType
URL Syntax
http://<ip>/cgi-bin/magicBox.cgi?action=getDeviceType
Comment
Response
type=CP-UNC-BY20C
9.8.4 GetHardwareVersion
URL Syntax
http://<ip>/cgi-bin/magicBox.cgi?action=getHardwareVersion
Comment
Response
version=1.00
9.8.5 GetSerialNo
URL Syntax
http://<ip> /cgi-bin/magicBox.cgi?action=getSerialNo
Comment
Response
sn=YZC0GZ05100020
9.8.6 GetMachineName
URL Syntax
http://<ip>/cgi-bin/magicBox.cgi?action=getMachineName
Comment
Response
name=YZC0GZ05100020
9.8.7 GetSystemInfo
URL Syntax
http://<ip>/cgi-bin/magicBox.cgi?action=getSystemInfo
Comment
Response
serialNumber=YZC0GZ05100020
deviceType=CP-UNC-BY20
hardwareVersion=1.00
9.8.8 GetVendor
URL Syntax
http://<ip>/cgi-bin/magicBox.cgi?action=getVendor
Comment
Response
vendor=CPPLUS
9.8.9 GetSoftwareVersion
URL Syntax
http://<ip>/cgi-bin/magicBox.cgi?action=getSoftwareVersion
Comment
Response
version=2.212.0000.0.R,build:2013-11-14
9.9 Log
9.9.1 StartFind
URL Syntax
http://<ip>/cgi-bin/log.cgi?action=startFind&condition.StartTime=<start>&condition.EndTime=<end>
Comment
Start to find log, in response, there is a token for further log finding process.
start/end: the start/end time of log. Format is: yyyy-mm-dd hh:mm:ss.
Example:
Find log between 2011-1-1 12:00:00 and 2011-1-10 12:00:00, URL is:
http://<ip>/cgi-bin/log.cgi?action=startFind&condition.StartTime=2011-1-1 12:00:00
&condition.EndTime=2011-1-10 12:00:00
Response
token=1
9.9.2 DoFind
URL Syntax
http://<ip>/cgi-bin/log.cgi?action=doFind&token=<tokenValue>&count=<logCount>
Comment
Response
found=2
items[0].RecNo=789
items[0].Time=2011-05-20 11:59:10
items[0].Type=ClearLog
items[0].User=admin
items[1].Detail.Compression=H.264->MJPG
items[1].Detail.Data=Encode
items[1].RecNo=790
items[1].Time=2011-05-20 11:59:21
items[1].Type=SaveConfig
items[1].User=System
Field in Response
Description
found
User
User name
Type
Log type
Time
RecNo
Log number.
Detail
Log details.
9.9.3 StopFind
URL Syntax
http://<ip>/cgi-bin/log.cgi?action=stopFind&token=<tokenValue>
Comment
Response
OK or ERROR
9.9.4 Clear
URL Syntax
http://<ip>/cgi-bin/log.cgi?action=clear
Comment
Response
OK or ERROR
10.Storage
10.1 File Finding
10.1.1 Create
URL Syntax
http://<ip>/cgi-bin/mediaFileFind.cgi?action=factory.create
Comment
Response
result=08137
10.1.2 StartFind
URL Syntax
http://<ip>/cgi-bin/mediaFileFind.cgi?action=findFile&object=<objectId>&condition.Channel=<channel>&condition.StartTime=
<start>&condition.EndTime=<end>&condition.Dirs[0]=<dir>&condition.Types[0]=<type>&condition.Flag[0]=<flag>&condition.E
vents[0]=<event>
Comment
Start to find file wth the above condition. If start successfully, return true, else return false.
object : The object Id is got from interface in 10.1.1 Create
condition.Channel: in which channel you want to find the file .
condition.StartTime/condition.EndTime: the start/end time when recording.
condition.Dirs: in which directories you want to find the file. It is an array. The index starts from 0. The range of dir is
{/mnt/dvr/sda0, /mnt/dvr/sda1}. This condition can be omitted. If omitted, find files in all the directories.
condition.Types: which types of the file you want to find. It is an array. The index starts from 0. The range of type is {dav,
jpg, mp4}. If omitted, find files with all the types.
condition.Flags: which flags of the file you want to find. It is an array. The index starts from 0. The range of flag is {Timing,
Manual, Marker, Event, Mosaic, Cutout}. If omitted, find files with all the flags.
condition.Event: by which event the record file is triggered. It is an array. The index starts from 0. The range of event is
{AlarmLocal, VideoMotion, VideoLoss, VideoBlind, Traffic*}. This condition can be omitted. If omitted, find files of all
the events.
Example:
Find file in channel 1, in directory /mnt/dvr/sda0",event type is "AlarmLocal" or "VideoMotion", file type is dav, and time
between 2011-1-1 12:00:00 and 2011-1-10 12:00:00 , URL is:
http://<ip>/cgi-bin/mediaFileFind.cgi?action=findFile&object=08137&condition.Channel=1&conditon.Dir[0]=/mnt/dvr/sda0&
conditon.Event[0]=AlarmLocal&conditon.Event[1]=VideoMotion&condition.StartTime=2011-1-1%2012:00:00&condition.EndTi
me=2011-1-10%2012:00:00
Response
OK or Error
10.1.3 FindNextFile
URL Syntax
http://<ip>/cgi-bin/mediaFileFind.cgi?action=findNextFile&object=<objectId>&count=<fileCount>
Comment
Response
found=1
items[0]. Channel =1
items[0]. StartTime =2011-1-1 12:00:00
items[0]. EndTime =2011-1-1 13:00:00
items[0]. Type =dav
items[0]. Events[0]=AlarmLocal
items[0]. FilePath =/mnt/dvr/sda0/2010/8/11/dav/15:40:50.jpg
items[0]. Length =790
items[0]. Duration = 3600
items[0].SummaryOffset=2354
tems[0].Repeat=0
items[0].WorkDir=/mnt/dvr/sda0
items[0]. Overwrites=5
items[0]. WorkDirSN=0
Field in Response
Description
found
Channel
Channel
StartTime
Start Time
EndTime
End time
Type
File type
Events
Event type.
FilePath
filepath.
Length
File length
Duration
Duration time
SummaryOffset
Summary offset
Repeat
WorkDir
Overwrites
WorkDirSN
Workdir No
10.1.4 Close
URL Syntax
http://<ip>/cgi-bin/mediaFileFind.cgi?action=close&object=<objectId>
Comment
Stop find.
Response
OK or ERROR
10.1.5 Destroy
URL Syntax
http://<ip>/cgi-bin/mediaFileFind.cgi?action=destroy&object=<objectId>
Comment
Response
OK or ERROR
http://<ip>/cgi-bin/storageDevice.cgi?action=factory.getCollect
Comment
Response
http://<ip>/cgi-bin/workGroup.cgi?action=factory.getCollect
Comment
Response
http://<ip>/cgi-bin/workDirectory.cgi?action=factory.getCollect
Comment
Response
list [2]=dir3
10.5 NAS
10.5.1 GetNASConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=NAS
Comment
Response
table.NAS[0].Name= FTP1
table.NAS[0].Enable = true
table.NAS[0].Protocol =FTP
table.NAS[0].Address =www.cpplusworld.com
table.NAS[0].Port =21
table.NAS[0].UserName =anonymity
table.NAS[0].Password =none
table.NAS[0].Directory =share
10.5.2 SetNASConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
In below table:
Head =NAS[index]
Index: The index of the NAS Server
Response
OK or ERROR
ParamName
ParamValue type
Description
Head.Name
string
NAS name.
Head .Enable
bool
Head. Protocol
string
Head. Address
string
Head .Port
integer
NAS port.
Head.UserName
string
NAS username.
Head .Password
string
NAS password.
Head .Directory
string
Directory name.
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=RecordStoragePoint
Comment
Response
10.6.2 SetRecordStoragePointConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
In below table:
ch = channel index,
recType :The range is {TimingRecord, VideoDetectRecord, AlarmRecord, EventRecord, TimingSnapShot,
VideoDetectSnapShot, AlarmSnapShot, EventSnapShot}
Response
OK or Error
ParamName
ParamValue type
Description
RecordStoragePoint [ch].[recType].Local
string
string
string
bool
integer
bool
integer
10.6.3 GetStorageGroupConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=StorageGroup
Comment
Response
table.StorageGroup[0]. Name=ReadWrite
table.StorageGroup[0]. Memo = For Reading & Writing Files
table.StorageGroup[0]. FileHoldTime =0
table.StorageGroup[0]. OverWrite =true
table.StorageGroup[0]. Channels[0]. MaxPictures =1000
table.StorageGroup[0]. Channels[0]. Path =/mnt/dvr/sda0
10.6.4 SetStorageGroupConfig
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
In below table:
Index = StorageGroup index
ch = channel index
Response
OK or Error
ParamName
ParamValue type
Description
StorageGroup[Index]. Name
string
StorageGroup[Index]. Memo
string
StorageGroup[Index]. FileHoldTime
integer
StorageGroup[Index]. OverWrite
bool
Integer
The max pictures beyond which the old pictures will be over
written. If it is 0, the old pictures will be not over written.
string
11.Audio
11.1 Audio MIME type
MIME
Description
Audio/PCM
Audio/ADPCM
Audio/G.711A
Audio/G.711Mu
Audio/G.726
Audio/G.729
Audio/MPEG2
Audio/AMR
Audio/AAC
http://<ip>/cgi-bin/audio.cgi?action=postAudio&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
httptype
string
content
type
is
integer
http://<ip>/cgi-bin/audio.cgi?action=getAudio&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue type
Description
httptype
string
content
type
is
integer
Content-Length: 800
<Audio data>
--<boundary>
12.Appendix
12.1 Stream Format
The Stream format is used by 4.1.7 GetStream By Http and 4.1.8 Playback By Http, describes the format of the data stream.
Stream Header
Byte
Order
Key
Flag
Byte
Order
Key
16
Order
Type reserved
10
17
Key
11
18
19
packet length
12
Extend header
length
channel
Byte
13
14
15
Sequence
20
utc
21
utcms
22
23
reserved
Check
sum
Flag=DH;
Type=0x10 means the audio packet;
Type=0x20 means the video packet;
Packet length means the packet total length, contains the packet header, maybe one or more extend header, and the media data;
Extend Header Format
Byte
Order
Key
0
Type
2
length
3
reserved
data
Byte
Order
Key
0x11
reserved
4
Audio
Type
Tracks
Sample
Freq
reserved
Byte
Order
Key
Byte
Order
0x21
Key
16
reserved
10
11
Video
Frame
Type
Type
12
13
I Frame Frame
Interval Rate
Height
Width
14
15
reserved
A video packet must contain the video extend header; Video Type means the video codec type, 1-MPEG4; 2-H.264; Frame Type: 1-I frame;
2-P frame;3-B frame; Width and Height describe the frame width and height by pixel;
Channel Title Extend Header:
Byte
Order
Key
0x22
2
len
Title
reserved
When a stream begin, or the device channel title changes, the video packet must contain the channel title extend header; If the channel
title is Chinese, it only support utf8 format.
TimeZone Extend Header:
Byte
Order
Key
0
0x31
2
8
3
reserved
Time Zone
Daylight reserved
CP Plus GmbH & Co. KG.
90
saving
time
When a stream begin, or the TimeZone changes, the video packet must contain the TimeZone extend header; Time Zone[0]:
[-12,12](west time zone 12 to east time zone 12), Time Zone[1]
modify the time by minutes; Daylight saving time: 1/0, yes or not in daylight
saving time;
Event Flag Extend Header:
Byte
Order
Key
0x23
2
len
reserved
Event Flag
If the video frame contain one or more event flags, the video packet should contain the Event Flag Extend Header. The event flag means
what event had happened by set the bit as 1;
Event Flag: bit0-exterior alarm; bit1-move detect; bit2-video lost.
13.VedioInput
13.1 AdjustFocus
URL Syntax
http://<ip>/cgi-bin/devVideoInput.cgi?action= adjustFocus&focus=<focus>&zoom=<zoom>
Comment
Response
OK or ERROR
13.2 AdjustFocusContinuously
URL Syntax
http://<ip>/cgi-bin/devVideoInput.cgi?action= adjustFocusContinuously&focus=<focus>&zoom=<zoom>
Comment
Example
Response
OK or ERROR
13.3 AutoFocus
URL Syntax
http://<ip>/cgi-bin/devVideoInput.cgi?action= autoFocus
Comment
Response
OK or ERROR
13.4 GetFocusStatus
URL Syntax
http://<ip>/cgi-bin/devVideoInput.cgi?action= getFocusStatus
Comment
The range of status.Status is Normal and Autofocus. This command must be continual executed until status.Status is
Normal.
Response
status.Focus=0.5
status.Zoom=0.5
status.Status=Normal
14. SD Camera
This chapter is only effective with SD Camera.
14.1 VideoInWhiteBalance
14.1.1 GetVideoInWhiteBalance
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoInWhiteBalance
Description
Response
table.VideoInWhiteBalance[0][0].ColorTemperatureLevel=50
table.VideoInWhiteBalance[0][0].GainBlue=50
table.VideoInWhiteBalance[0][0].GainGreen=50
table.VideoInWhiteBalance[0][0].GainRed=50
table.VideoInWhiteBalance[0][0].Mode=ATW
table.VideoInWhiteBalance[0][1].ColorTemperatureLevel=50
table.VideoInWhiteBalance[0][1].GainBlue=50
table.VideoInWhiteBalance[0][1].GainGreen=50
table.VideoInWhiteBalance[0][1].GainRed=50
table.VideoInWhiteBalance[0][1].Mode=Auto
table.VideoInWhiteBalance[0][2].ColorTemperatureLevel=50
table.VideoInWhiteBalance[0][2].GainBlue=50
table.VideoInWhiteBalance[0][2].GainGreen=50
table.VideoInWhiteBalance[0][2].GainRed=50
table.VideoInWhiteBalance[0][2].Mode=Auto
14.2.2 SetVideoInWhiteBalance
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue
Description
type
head. Mode
integer
head. GainRed
integer
Range is 0-100
head. GainBlue
integer
Range is 0-100
14.2 VideoInExposure
14.2.1 GetVideoInExposure
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name= VideoInExposure
Description
Response
table.VideoInExposure[0][0].AutoGainMax=2
table.VideoInExposure[0][0].Backlight=0
table.VideoInExposure[0][0].Compensation=7
table.VideoInExposure[0][0].DoubleExposure=0
table.VideoInExposure[0][0].Gain=1
table.VideoInExposure[0][0].GlareInhibition=0
table.VideoInExposure[0][0].Iris=10
table.VideoInExposure[0][0].Mode=0
table.VideoInExposure[0][0].RecoveryTime=900
table.VideoInExposure[0][0].Rect[0]=0
table.VideoInExposure[0][0].Rect[1]=0
table.VideoInExposure[0][0].Rect[2]=0
table.VideoInExposure[0][0].Rect[3]=0
table.VideoInExposure[0][0].SlowAutoExposure=0
table.VideoInExposure[0][0].SlowShutter=true
table.VideoInExposure[0][0].SlowSpeed=25
table.VideoInExposure[0][0].Speed=50
table.VideoInExposure[0][0].Value1=0.100000
table.VideoInExposure[0][0].Value2=80
table.VideoInExposure[0][0].WideDynamicRange=0
table.VideoInExposure[0][0].WideDynamicRangeMode=0
table.VideoInExposure[0][1].AutoGainMax=2
table.VideoInExposure[0][1].Backlight=0
table.VideoInExposure[0][1].Compensation=14
table.VideoInExposure[0][1].DoubleExposure=0
table.VideoInExposure[0][1].Gain=1
table.VideoInExposure[0][1].GlareInhibition=0
table.VideoInExposure[0][1].Iris=10
table.VideoInExposure[0][1].Mode=2
table.VideoInExposure[0][1].RecoveryTime=900
table.VideoInExposure[0][1].Rect[0]=0
table.VideoInExposure[0][1].Rect[1]=0
table.VideoInExposure[0][1].Rect[2]=0
table.VideoInExposure[0][1].Rect[3]=0
table.VideoInExposure[0][1].SlowAutoExposure=14
table.VideoInExposure[0][1].SlowShutter=true
table.VideoInExposure[0][1].SlowSpeed=25
table.VideoInExposure[0][1].Speed=50
table.VideoInExposure[0][1].Value1=0.100000
table.VideoInExposure[0][1].Value2=80
table.VideoInExposure[0][1].WideDynamicRange=0
table.VideoInExposure[0][1].WideDynamicRangeMode=0
table.VideoInExposure[0][2].AutoGainMax=2
table.VideoInExposure[0][2].Backlight=0
table.VideoInExposure[0][2].Compensation=7
table.VideoInExposure[0][2].DoubleExposure=0
table.VideoInExposure[0][2].Gain=1
table.VideoInExposure[0][2].GlareInhibition=0
table.VideoInExposure[0][2].Iris=10
table.VideoInExposure[0][2].Mode=0
table.VideoInExposure[0][2].RecoveryTime=900
table.VideoInExposure[0][2].Rect[0]=0
table.VideoInExposure[0][2].Rect[1]=0
table.VideoInExposure[0][2].Rect[2]=0
table.VideoInExposure[0][2].Rect[3]=0
table.VideoInExposure[0][2].SlowAutoExposure=0
table.VideoInExposure[0][2].SlowShutter=true
table.VideoInExposure[0][2].SlowSpeed=25
table.VideoInExposure[0][2].Speed=50
table.VideoInExposure[0][2].Value1=0.100000
table.VideoInExposure[0][2].Value2=80
table.VideoInExposure[0][2].WideDynamicRange=0
table.VideoInExposure[0][2].WideDynamicRangeMode=0
Comment
14.2.2 SetVideoInExposure
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue
Description
type
head.Mode
integer
Range is {0,2,3, 4}
0: AutoExposure
2: Gain first
3: Exposure first
4:Manual.
head.Gain
integer
Range is 0-15
Head.Iris
integer
Range is 0-17
head.Speed
integer
Range is [3,,3000]
head.Compensation
float
Range is [0-14],
head.SlowAutoExposure
float
Range is [0-15]
head.AutoGainMax
integer
Range is {0,1,2}
0: low
1: middle
2: high
head.SlowShutter
integer
head.SlowSpeed
integer
Range is {1,2,3,6,12,25}
0:forbid flash
1:always flash
2:auto flash
head.RecoveryTime
integer
head.WideDynamicRangeMode=1
integer
Range is [0,1]
0 disable,
1 enable
head.GlareInhibition
integer
Range is [0,1,2,3]
0disable
1low
2middle
3high
head.Backlight
bool
0: enable Backlight
1: disable Backlight
14.3 VideoInDenoise
14.3.1 GetVideoInDenoise
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoInDenoise
Description
Response
table.VideoInDenoise[0][0].2DEnable=true
table.VideoInDenoise[0][0].2DLevel=8
table.VideoInDenoise[0][0].3DAutoType.AutoLevel=2
table.VideoInDenoise[0][0].3DAutoType.Mod=8
table.VideoInDenoise[0][0].3DManulType.SnfLevel=0
table.VideoInDenoise[0][0].3DManulType.TnfLevel=0
table.VideoInDenoise[0][0].3DType=Auto
table.VideoInDenoise[0][1].2DEnable=true
table.VideoInDenoise[0][1].2DLevel=8
table.VideoInDenoise[0][1].3DAutoType.AutoLevel=2
table.VideoInDenoise[0][1].3DAutoType.Mod=8
table.VideoInDenoise[0][1].3DManulType.SnfLevel=0
table.VideoInDenoise[0][1].3DManulType.TnfLevel=0
table.VideoInDenoise[0][1].3DType=Auto
table.VideoInDenoise[0][2].2DEnable=true
table.VideoInDenoise[0][2].2DLevel=8
table.VideoInDenoise[0][2].3DAutoType.AutoLevel=2
table.VideoInDenoise[0][2].3DAutoType.Mod=8
table.VideoInDenoise[0][2].3DManulType.SnfLevel=0
table.VideoInDenoise[0][2].3DManulType.TnfLevel=0
table.VideoInDenoise[0][2].3DType=Auto
14.3.2 SetVideoInDenoise
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue
Description
type
head.2DEnable
integer
head.2DLevel
integer
Range is 1-5
head.3DType
String
Off
Auto
head .3DAutoType.Mode
integer
Range is 0-1
14.4 VideoInDayNight
14.4.1 GetVideoInDayNight
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoInDayNight
Description
Response
table.VideoInDayNight[0][0].BCRDelay=10
table.VideoInDayNight[0][0].ICRDelay=10
table.VideoInDayNight[0][0].Mode=Brightness
table.VideoInDayNight[0][0].Sensitivity=4
table.VideoInDayNight[0][0].Type=Electron
table.VideoInDayNight[0][1].BCRDelay=10
table.VideoInDayNight[0][1].ICRDelay=10
table.VideoInDayNight[0][1].Mode=BlackWhite
table.VideoInDayNight[0][1].Sensitivity=4
table.VideoInDayNight[0][1].Type=Electron
table.VideoInDayNight[0][2].BCRDelay=10
table.VideoInDayNight[0][2].ICRDelay=10
table.VideoInDayNight[0][2].Mode=BlackWhite
table.VideoInDayNight[0][2].Sensitivity=4
table.VideoInDayNight[0][2].Type=Electron
14.4.2 SetVideoInDayNight
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue
Description
type
head. Type
integer
Electron:
Mechanism:
head. Mode
integer
AutoColorBlackWhite
head. Sensitivity
integer
Range is 0-7
14.5 VideoInFocus
14.5.1 GetVideoInFocus
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoInDayNight
Description
Response
table.VideoInFocus[0][0].FocusLimit=100
table.VideoInFocus[0][0].FocusLimitSelectMode=Manual
table.VideoInFocus[0][0].IRCorrection=0
table.VideoInFocus[0][0].Mode=3
table.VideoInFocus[0][0].Sensitivity=1
table.VideoInFocus[0][1].FocusLimit=100
table.VideoInFocus[0][1].FocusLimitSelectMode=Manual
table.VideoInFocus[0][1].IRCorrection=0
table.VideoInFocus[0][1].Mode=3
table.VideoInFocus[0][1].Sensitivity=1
table.VideoInFocus[0][2].FocusLimit=100
table.VideoInFocus[0][2].FocusLimitSelectMode=Manual
table.VideoInFocus[0][2].IRCorrection=0
table.VideoInFocus[0][2].Mode=3
table.VideoInFocus[0][2].Sensitivity=1
14.5.2 SetVideoInFocus
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue
Description
type
head. Mode
integer
head. FocusLimit
integer
1001000200030005000
head. Sensitivity
integer
Range is 0,1,2
0-high1-default2-low
head. IRCorrection
integer
14.6 VideoInZoom
14.6.1 GetVideoInZoom
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoInZoom
Description
Response
table.VideoInZoom[0][0].DigitalZoom=true
table.VideoInZoom[0][0].Speed=7
table.VideoInZoom[0][0].ZoomLimit=4
table.VideoInZoom[0][1].DigitalZoom=true
table.VideoInZoom[0][1].Speed=0
table.VideoInZoom[0][1].ZoomLimit=4
table.VideoInZoom[0][2].DigitalZoom=false
table.VideoInZoom[0][2].Speed=7
table.VideoInZoom[0][2].ZoomLimit=4
14.6.2 SetVideoInZoom
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue
Description
type
head. DigitalZoom
integer
head. Speed
integer
Range is 0-7
14.7 VideoInSharpness
14.7.1 GetVideoInSharpness
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoInSharpness
Description
Response
table.VideoInSharpness[0][0].Level=4
table.VideoInSharpness[0][0].Mode=1
table.VideoInSharpness[0][0].Sharpness=8
table.VideoInSharpness[0][1].Level=4
table.VideoInSharpness[0][1].Mode=1
table.VideoInSharpness[0][1].Sharpness=8
table.VideoInSharpness[0][2].Level=4
table.VideoInSharpness[0][2].Mode=1
table.VideoInSharpness[0][2].Sharpness=8
14.7.2 SetVideoInSharpness
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue
Description
type
head. Sharpness
integer
Range is 0-15
head. Level
integer
Range is 0-15
14.8 VideoInColor
14.8.1 GetVideoInColor
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoInColor
Description
Response
table.VideoInColor[0][0].Brightness=50
table.VideoInColor[0][0].ChromaSuppress=1
table.VideoInColor[0][0].Contrast=50
table.VideoInColor[0][0].Gamma=0
table.VideoInColor[0][0].Hue=50
table.VideoInColor[0][0].Saturation=50
table.VideoInColor[0][0].Style=Standard
table.VideoInColor[0][1].Brightness=50
table.VideoInColor[0][1].ChromaSuppress=1
table.VideoInColor[0][1].Contrast=50
table.VideoInColor[0][1].Gamma=0
table.VideoInColor[0][1].Hue=50
table.VideoInColor[0][1].Saturation=50
table.VideoInColor[0][1].Style=Standard
table.VideoInColor[0][2].Brightness=50
table.VideoInColor[0][2].ChromaSuppress=1
table.VideoInColor[0][2].Contrast=50
table.VideoInColor[0][2].Gamma=0
table.VideoInColor[0][2].Hue=50
table.VideoInColor[0][2].Saturation=50
table.VideoInColor[0][2].Style=Flamboyant
14.8.2 SetVideoInColor
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue
Description
type
head. Style
integer
Gentle
Standard
Flamboyant
head. Hue
integer
Range is 0-100
head. Brightness
integer
Range is 0-100
head. Saturation
Range is 0-100
head. ChromaSuppress
Range is 0-3
head. Gamma
Range is 0-15
14.9 VideoInRotate
14.9.1 GetVideoInRotate
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoInRotate
Description
Response
table.VideoInRotate[0][0].Flip=false
table.VideoInRotate[0][0].Freeze=false
table.VideoInRotate[0][0].Mirror=false
table.VideoInRotate[0][0].Rotate90=0
table.VideoInRotate[0][0].Stable=false
table.VideoInRotate[0][1].Flip=false
table.VideoInRotate[0][1].Freeze=false
table.VideoInRotate[0][1].Mirror=false
table.VideoInRotate[0][1].Rotate90=0
table.VideoInRotate[0][1].Stable=false
table.VideoInRotate[0][2].Flip=false
table.VideoInRotate[0][2].Freeze=false
table.VideoInRotate[0][2].Mirror=false
table.VideoInRotate[0][2].Rotate90=0
table.VideoInRotate[0][2].Stable=false
14.9.2 SetVideoInRotate
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
OK or ERROR
ParamName
ParamValue
Description
type
head. Flip
integer
14.10 VideoInMode
14.10.1 GetVideoInMode
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoInMode
Description
Response
table.VideoInMode[0].Config[0]=1
table.VideoInMode[0].Mode=0
table.VideoInMode[0].TimeSection[0][0]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[0][1]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[0][2]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[0][3]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[0][4]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[0][5]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[1][0]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[1][1]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[1][2]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[1][3]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[1][4]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[1][5]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[2][0]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[2][1]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[2][2]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[2][3]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[2][4]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[2][5]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[3][0]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[3][1]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[3][2]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[3][3]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[3][4]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[3][5]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[4][0]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[4][1]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[4][2]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[4][3]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[4][4]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[4][5]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[5][0]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[5][1]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[5][2]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[5][3]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[5][4]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[5][5]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[6][0]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[6][1]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[6][2]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[6][3]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[6][4]=0 00:00:00-23:59:59
table.VideoInMode[0].TimeSection[6][5]=0 00:00:00-23:59:59
14.10.2 SetVideoInMode
URL Syntax
http://<ip>/cgi-bin/configManager.cgi?action=setConfig&<paramName>=<paramValue>[&<paramName>=<paramValue>...]
Comment
Response
ParamName
OK or ERROR
ParamValue
Description
type
head. Mode
integer
Range is {0,1}
0: NoSwitch
1: Switch depends on head.TimeSection.
head. Config
integer
Mode=0
Config[0]={01/2}
Mode=1
Config[1]={ 1 }
Config[2]={ 2 }
head.TimeSection[0][0]
integer