Thanks to visit codestin.com
Credit goes to www.scribd.com

Scribd
Upload
10 views14 pages

At HDVS Cam - Api

The document provides the application programming interface (API) for the AT-HDVS-CAM PTZ camera, detailing the Visca, Pelco-D, and Pelco-P protocol command lists. It includes commands for camera control, inquiry commands, and error messages, along with specific command packets and functions. The document is intended for developers to facilitate communication with the camera using TCP port 1259.

Uploaded by

svorobovicp
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
10 views14 pages

At HDVS Cam - Api

The document provides the application programming interface (API) for the AT-HDVS-CAM PTZ camera, detailing the Visca, Pelco-D, and Pelco-P protocol command lists. It includes commands for camera control, inquiry commands, and error messages, along with specific command packets and functions. The document is intended for developers to facilitate communication with the camera using TCP port 1259.

Uploaded by

svorobovicp
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 14

PTZ Camera

Application Programming Interface

AT-HDVS-CAM Atlona Manuals


Accessories
Version Information
Version Release Date Notes
1 4/18 Initial release

AT-HDVS-CAM 2
Table of Contents
Visca Protocol List 4
Camera Return Command 4
Camera Control Command 4
Inquiry Command 8
Pelco-D Protocol Command List 12
Pelco-P Protocol Command List 13

AT-HDVS-CAM 3
Visca Protocol List
The following tables provide a list of commands available for AT-HDVS-CAM. Use TCP port 1259 for communication
with the AT-HDVS-CAM. There should be at least a 500 millisecond delay between each command sent to the unit.

Camera Return Command

ACK/Completion Message Command packet Note


ACK z0 41 FF Returned when the command is accepted
Completion z0 51 FF Returned when the command has been executed
z = camera address +8

Error Messages Command packet Note


Syntax Error z0 60 02 FF Returned when the command format is different or when a
command with illegal command parameters is accepted
Command Not Executable z0 61 41 FF Returned when a command cannot be executed due
to current conditions. For example, when commands
controlling the focus manually are received during auto
focus.

Camera Control Command


Command Function Command Packet Note
AddressSet Broadcast 88 30 0p FF p: Address setting
IF_Clear Broadcast 88 01 00 01 FF I/F Clear
CommandCancel 8x 21 FF
CAM_Power On 8x 01 04 00 02 FF Power ON/OFF
Off 8x 01 04 00 03 FF
CAM_Zoom Stop 8x 01 04 07 00 FF
Tele(Standard) 8x 01 04 07 02 FF
Wide(Standard) 8x 01 04 07 03 FF
Tele(Variable) 8x 01 04 07 2p FF p = 0(low) - F(high)
Wide(Variable) 8x 01 04 07 3p FF p = 0(low) - F(high)
Direct 8x 01 04 47 0p 0q pqrs: Zoom Position
0r 0s FF
CAM_Focus Stop 8x 01 04 08 00 FF
Far(Standard) 8x 01 04 08 02 FF
Near(Standard) 8x 01 04 08 03 FF
Far(Variable) 8x 01 04 08 2p FF p = 0(low) - F(high)
Near(Variable) 8x 01 04 08 3p FF p = 0(low) - F(high)
Direct 8x 01 04 48 0p 0q pqrs: Focus Position
0r 0s FF
Auto Focus 8x 01 04 38 02 FF
Manual Focus 8x 01 04 38 03 FF
CAM_Zoom Focus Direct 8x 01 04 47 0p 0q pqrs: Zoom Position
0r 0s 0t 0u 0v 0w tuvw: Focus Position
FF

AT-HDVS-CAM 4
Visca Protocol List

Command Function Command Packet Note


CAM_WB Auto 8x 01 04 35 00 FF
3000K 8x 01 04 35 01 FF
4000k 8x 01 04 35 02 FF
One Push mode 8x 01 04 35 03 FF
5000k 8x 01 04 35 04 FF
Manual 8x 01 04 35 05 FF
6500k 8x 01 04 35 06 FF
CAM_RGain Reset 8x 01 04 03 00 FF Manual Control of R Gain
Up 8x 01 04 03 02 FF Manual Control of R Gain
Down 8x 01 04 03 03 FF Manual Control of R Gain
Direct 8x 01 04 43 00 00 pq: R Gain
0p 0q FF
CAM_Bgain Reset 8x 01 04 04 00 FF Manual Control of B Gain
Up 8x 01 04 04 02 FF Manual Control of B Gain
Down 8x 01 04 04 03 FF Manual Control of B Gain
Direct 8x 01 04 44 00 00 pq: B Gain
0p 0q FF
CAM_AE Full Auto 8x 01 04 39 00 FF Automatic Exposure mode
Manual 8x 01 04 39 03 FF Manual Control mode
Shutter priority 8x 01 04 39 0A FF Shutter Priority Automatic Exposure mode
Iris priority 8x 01 04 39 0B FF Iris Priority Automatic Exposure mode
Bright 8x 01 04 39 0D FF Bright mode
CAM_Shutter Reset 8x 01 04 0A 00 FF Shutter Setting
Up 8x 01 04 0A 02 FF Shutter Setting
Down 8x 01 04 0A 03 FF Shutter Setting
Direct 8x 01 04 4A 00 00 pq: Shutter Position
0p 0q FF
CAM_Iris Reset 8x 01 04 0B 00 FF Iris Setting
Up 8x 01 04 0B 02 FF Iris Setting
Down 8x 01 04 0B 03 FF Iris Setting
Direct 8x 01 04 4B 00 00 pq: Iris Position
0p 0q FF
CAM_Gain Reset 8x 01 04 0C 00 FF Gain Setting
Up 8x 01 04 0C 02 FF Gain Setting
Down 8x 01 04 0C 03 FF Gain Setting
Direct 8x 01 04 0C 00 00 pq: Gain Positon
0p 0q FF
GAM_Bright Reset 8x 01 04 0D 00 FF Bright Setting
Up 8x 01 04 0D 02 FF Bright Setting
Down 8x 01 04 0D 03 FF Bright Setting
Direct 8x 01 04 4D 00 00 pq: Bright Position
0p 0q FF

AT-HDVS-CAM 5
Visca Protocol List

Command Function Command Packet Note


CAM_ExpComp On 8x 01 04 3E 02 FF Exposure Compensation ON/OFF
Off 8x 01 04 3E 03 FF Exposure Compensation ON/OFF
Reset 8x 01 04 0E 00 FF Exposure Compensation Amount Settings
Up 8x 01 04 0E 02 FF Exposure Compensation Amount Settings
Down 8x 01 04 0E 03 FF Exposure Compensation Amount Settings
Direct 8x 01 04 4E 00 00 pq: ExpComp Position
0p 0q FF
CAM_Back Light On 8x 01 04 33 02 FF Back Light Compensation
Off 8x 01 04 33 03 FF Back Light Compensation
CAM_NR (2D) 8x 01 04 53 0p FF p = 0-7 0: OFF
CAM_NR (3D) 8x 01 04 54 0p FF p = 0-8 0: OFF
CAM_Gamma 8x 01 04 5B 0p FF p=0-4
0: Default
1: 0.47
2: 0.50
3: 0.52
4: 0.55
CAM_Flicker OFF 8x 01 04 23 00 FF OFF
50HZ 8x 01 04 23 01 FF 50HZ
60HZ 8x 01 04 23 02 FF 60HZ
CAM_Aperature Reset 8x 01 04 02 00 FF Aperture Control
Up 8x 01 04 02 02 FF Aperture Control
Down 8x 01 04 02 03 FF Aperture Control
Direct 8x 01 04 42 00 00 pq: Aperture Gain
0p 0q FF
CAM_Memory Reset 8x 01 04 3F 00 pq pq: Memory Number (=0 to 254)
FF Corresponds to 0 to 9 on the Remote
Commander
Set 8x 01 04 3F 01 pq
FF
Recall 8x 01 04 3F 02 pq
FF
CAM_LR_Reverse On 8x 01 04 61 02 FF Image Flip Horizontal ON/OFF
Off 8x 01 04 61 03 FF Image Flip Horizontal ON/OFF
CAM_PictureFlip On 8x 01 04 66 02 FF Image Flip Vertical ON/OFF
Off 8x 01 04 66 03 FF Image Flip Vertical ON/OFF
CAM_ColorSaturation Direct 8x 01 04 49 00 00 P = 0-7
00 0p FF 0: 60%
1: 70%
2: 80%
3: 90%
4: 100%
5: 110%
6: 120%
7: 130%

AT-HDVS-CAM 6
Visca Protocol List

Command Function Command Packet Note


CAM_IDWrite 8x 01 04 22 0p 0q pqrs: Camera ID (=0000 to FFF)
0r 0s FF
SYS_Menu ON 8x 01 04 06 06 02 Turn on the menu screen
FF
OFF 8x 01 04 06 06 03 Turn off the menu screen
FF
IR_Receive ON 8x 01 06 08 02 FF IR (remote commander) receive On/Off
OFF 8x 01 06 08 03 FF
IR_ReceiveReturn On 8x 01 7D 01 03 00 IR (remote commander) receive message
00 FF
Off 8x 01 7D 01 13 00 via the VISCA communication ON/OFF
00 FF
CAM_SettingReset Reset 8x 01 04 A0 10 FF Reset Factory Setting
CAM_Brightness Direct 8x 01 04 A1 00 00 pq: Brightness Position
0p 0q FF
CAM_Contrast Direct 8x 01 04 A2 00 00 pq: Contrast Position
0p 0q FF
CAM_Flip OFF 8x 01 04 A4 00 FF Single Command For Video Flip
Flip-H 8x 01 04 A4 01 FF Single Command For Video Flip
Flip-V 8x 01 04 A4 02 FF Single Command For Video Flip
Flip-HV 8x 01 04 A4 03 FF Single Command For Video Flip
CAM_VideoSystem Set camera video 8x 01 06 35 00 0p P: 0-E Video format
system FF 0: 1080P60
1: 1080P50
2: 1080i60
3: 1080i50
4: 720P60
5: 720P50
6: 1080P30
7: 1080P25
8: 720P30
9: 720P25
A: 1080P59.94
B: 1080i59.94
C: 720P59.94
D: 1080P29.97
E: 720P29.97

AT-HDVS-CAM 7
Visca Protocol List

Command Function Command Packet Note


Pan_tiltDrive Up 8x 01 06 01 VV VV: Pan Speed 0x01 (low speed) to 0x18
WW 03 01 FF (high speed)
Down 8x 01 06 01 VV WW: Tilt speed 0x01 (low speed) to 0x14
WW 03 02 FF (high speed)
Left 8x 01 06 01 VV
WW 01 03 FF
Right 8x 01 06 01 VV
WW 02 03 FF
Upleft 8x 01 06 01 VV
WW 01 01 FF
Upright 8x 01 06 01 VV
WW 02 01 FF
DownLeft 8x 01 06 01 VV
WW 01 02 FF
DownRight 8x 01 06 01 VV
WW 02 02 FF
Stop 8x 01 06 01 VV
WW 03 03 FF
AbsolutePosition 8x 01 06 02 VV YYYY: Pan Position
WW 0Y 0Y 0Y 0Y ZZZ: Tilt Position
0Z 0Z 0Z 0Z FF
RelativePosition 8x 01 06 03 VV YYYY: Pan Position
WW 0Y 0Y 0Y 0Y ZZZ: Tilt Position
0Z 0Z 0Z 0Z FF
Home 8x 01 06 04 FF
Reset 8x 01 06 05 FF
Pan-tiltLimitSet Set 8x 01 06 07 00 0W W:1 UpRight
0Y 0Y 0Y 0Y 0Z 0Z 0:DownLeft
0Z 0Z FF YYYY: Pan Limit Position (TBD)
Clear 8x 01 06 07 01 0W ZZZZ: Tilt Limit Position (TBD)
07 0F 0F 0F 07 0F
0F 0F FF

Inquiry Command
Command Function Command Packet Note
CAM_PowerInq 8x 09 04 00 FF y0 50 02 FF On
y0 50 03 FF Off(Standby)
CAM_ZoomPosInq 8x 09 04 47 FF y0 50 0p 0q 0r 0s pqrs: Zoom Position
FF
CAM_FocusAFModeInq 8x 09 04 38 FF y0 50 02 FF Auto Focus
y0 50 03 FF Manual Focus
CAM_FocusPosInq 8x 09 04 48 FF y0 50 0p 0q 0r 0s pqrs: Focus Position
FF

AT-HDVS-CAM 8
Visca Protocol List

Command Function Command Packet Note


CAM_WBModeInq 8x 09 04 35 FF y0 50 00 FF Auto
y0 50 01 FF 3000K
y0 50 02 FF 4000K
y0 50 03 FF One Push Mode
y0 50 04 FF 5000K
y0 50 05 FF Manual
y0 50 00 FF 6500K
CAM_RGainInq 8x 09 04 43 FF y0 50 00 00 0p 0q pq: R Gain
FF
CAM_BGainInq 8x 09 04 44 FF y0 50 00 00 0p 0q pq: B Gain
FF
CAM_AEModeInq 8x 09 04 39 FF y0 50 00 FF Full Auto
y0 50 03 FF Manual
y0 50 0A FF Shutter priority
y0 50 0B FF Iris priority
y0 50 0D FF Bright
CAM_ShutterPosInq 8x 09 04 4A FF y0 50 00 00 0p 0q pq: Shutter Position
FF
CAM_IrisPosInq 8x 09 04 4B FF y0 50 00 00 0p 0q pq: Iris Position
FF
CAM_BrightPosiInq 8x 09 04 4D FF y0 50 00 00 0p 0q pq: Bright Position
FF
CAM_ExpCompModeInq 8x 09 04 3E FF y0 50 02 FF On
y0 50 03 FF Off
CAM_ExpCompPosInq 8x 09 04 4E FF y0 50 00 00 0p 0q pq: ExpComp Position
FF
CAM_BacklightModeInq 8x 09 04 33 FF y0 50 02 FF On
y0 50 03 FF Off
CAM_NRLevel(2D) Inq 8x 09 04 53 FF y0 50 0p FF P: 2DNRLevel
CAM_NRLevel(3D) Inq 8x 09 04 54 FF y0 50 0p FF P:3D NRLevel
CAM_FlickerModeInq 8x 09 04 55 FF y0 50 0p FF p: Flicker Settings
0: OFF
1: 50Hz
2: 60Hz
CAM_ApertureInq 8x 09 04 42 FF y0 50 00 00 0p 0q pq: Aperture Gain
FF
CAM_PictureEffectModeInq 8x 09 04 63 FF y0 50 00 FF Off
y0 50 04 FF B&W
CAM_MemoryInq 8x 09 04 3F FF y0 50 0p FF p: Memory number last operated
SYS_MenuModeInq 8x 09 06 06 FF y0 50 02 FF On
y0 50 03 FF Off
CAM_LR_ReverseInq 8x 09 04 61 FF y0 50 02 FF On
y0 50 03 FF Off
CAM_PictureFlipInq 8x 09 04 66 FF y0 50 02 FF On
y0 50 03 FF Off

AT-HDVS-CAM 9
Visca Protocol List

Command Function Command Packet Note


CAM_ColorSaturationInq 8x 09 04 49 FF y0 50 00 00 00 0p p: Color Gain setting 0h (60%) to
FF Eh (130%)
CAM_IDInq 8x 09 04 22 FF y0 50 0p FF p: Gamma ID
IR_ReceiveInq 8x 09 06 08 FF y0 50 02 FF On
y0 50 03 FF Off
IR_ReceiveReturn y0 07 7D 01 04 00 Power ON/OFF
FF
y0 07 7D 01 04 07 Zoom tele/wide
FF
y0 07 7D 01 04 38 AF ON/OFF
FF
y0 07 7D 01 04 33 Camera _Backlight
FF
y0 07 7D 01 04 3F Camera _Memery
FF
y0 07 7D 01 06 01 Pan_titleDriver
FF
CAM_BrightnessInq 8x 09 04 A1 FF y0 50 00 00 0p 0q pq: Brightness Position
FF
CAM_ContrastInq 8x 09 04 A2 FF y0 50 00 00 0p 0q pq: Contrast Position
FF
CAM_FlipInq 8x 09 04 A4 FF y0 50 00 FF Off
y0 50 01 FF Flip-H
y0 50 02 FF Flip-V
y0 50 03 FF Flip-HV
CAM_GammaInq 8x 09 04 5B FF y0 50 0p FF p: Gamma setting
CAM_VersionInq 8x 09 00 02 FF y0 50 ab cd mn pq ab cd : vender ID ( 0220 )
rs tu vw FF mn pq : model ID ST ( 0950 ) U3 (3950)
rs tu : ARM Version
vw : reserve
VideoSystemInq 8x 09 06 23 FF y0 50 0p FF P: 0 ~E Video format
0: 1080P60
1: 1080P50
2: 1080i60
3: 1080i50
4: 720P60
5: 720P50
6: 1080P30
7: 1080P25
8: 720P30
9: 720P25
A: 1080P59.94
B: 1080i59.94
C: 720P59.94
D: 1080P29.97
E: 720P29.97

AT-HDVS-CAM 10
Visca Protocol List

Command Function Command Packet Note


Pan-tiltMaxSpeedInq 8x 09 06 11 FF y0 50 ww zz FF ww: Pan Max Speed
zz: Tilt Max Speed
Pan-tiltPosInq 8x 09 06 12 FF y0 50 0w 0w 0w wwww: Pan Position
0w 0z 0z 0z 0z FF zzzz: Tilt Position

NOTE: [X] in the above table indicates the camera address to be operated, [y] = [x+8].

AT-HDVS-CAM 11
Pelco-D Protocol Command List
The following tables provide a list of commands available for AT-HDVS-CAM. Use TCP port 1258 for communication
with the AT-HDVS-CAM. There should be at least a 500 millisecond delay between each command sent to the unit.

Function Byte 1 Byte 2 Byte 3 Byte 4 Byte 5 Byte 6 Byte 7


Up 0xFF Address 0x00 0x08 Pan Speed Tilt Speed SUM
Down 0xFF Address 0x00 0x10 Pan Speed Tilt Speed SUM
Left 0xFF Address 0x00 0x04 Pan Speed Tilt Speed SUM
Right 0xFF Address 0x00 0x02 Pan Speed Tilt Speed SUM
Upleft 0xFF Address 0x00 0x0C Pan Speed Tilt Speed SUM
Upright 0xFF Address 0x00 0x0A Pan Speed Tilt Speed SUM
DownLeft 0xFF Address 0x00 0x14 Pan Speed Tilt Speed SUM
DownRight 0xFF Address 0x00 0x12 Pan Speed Tilt Speed SUM
Zoom In 0xFF Address 0x00 0x20 0x00 0x00 SUM
Zoom Out 0xFF Address 0x00 0x40 0x00 0x00 SUM
Focus Far 0xFF Address 0x00 0x80 0x00 0x00 SUM
Focus Near 0xFF Address 0x01 0x00 0x00 0x00 SUM
Set Preset 0xFF Address 0x00 0x03 0x00 Preset ID SUM
Clear Preset 0xFF Address 0x00 0x05 0x00 Preset ID SUM
Call Preset 0xFF Address 0x00 0x07 0x00 Preset ID SUM
Query Pan Position 0xFF Address 0x00 0x51 0x00 0x00 SUM
Query Pan Position Response 0xFF Address 0x00 0x59 Value High Byte Value Low Byte SUM
Query Tilt Position 0xFF Address 0x00 0x53 0x00 0x00 SUM
Query Tilt Position Response 0xFF Address 0x00 0x5B Value High Byte Value Low Byte SUM
Query Zoom Position 0xFF Address 0x00 0x55 0x00 0x00 SUM
Query Zoom Position Response 0xFF Address 0x00 0x5D Value High Byte Value Low Byte SUM

AT-HDVS-CAM 12
Pelco-P Protocol Command List
Function Byte 1 Byte 2 Byte 3 Byte 4 Byte 5 Byte 6 Byte 7 Byte 8
Up 0xA0 Address 0x00 0x08 Pan Speed Tilt Speed 0xAF XOR
Down 0xA0 Address 0x00 0x10 Pan Speed Tilt Speed 0xAF XOR
Left 0xA0 Address 0x00 0x04 Pan Speed Tilt Speed 0xAF XOR
Right 0xA0 Address 0x00 0x02 Pan Speed Tilt Speed 0xAF XOR
Upleft 0xA0 Address 0x00 0x0C Pan Speed Tilt Speed 0xAF XOR
Upright 0xA0 Address 0x00 0x0A Pan Speed Tilt Speed 0xAF XOR
DownLeft 0xA0 Address 0x00 0x14 Pan Speed Tilt Speed 0xAF XOR
DownRight 0xA0 Address 0x00 0x12 Pan Speed Tilt Speed 0xAF XOR
Zoom In 0xA0 Address 0x00 0x20 0x00 0x00 0xAF XOR
Zoom Out 0xA0 Address 0x00 0x40 0x00 0x00 0xAF XOR
Focus Far 0xA0 Address 0x01 0x00 0x00 0x00 0xAF XOR
Focus Near 0xA0 Address 0x02 0x00 0x00 0x00 0xAF XOR
Set Preset 0xA0 Address 0x00 0x03 0x00 Preset ID 0xAF XOR
Clear Preset 0xA0 Address 0x00 0x05 0x00 Preset ID 0xAF XOR
Call Preset 0xA0 Address 0x00 0x07 0x00 Preset ID 0xAF XOR
Query Pan Position 0xA0 Address 0x00 0x51 0x00 0x00 0xAF XOR
Query Pan Position 0xA0 Address 0x00 0x59 Value High Byte Value Low Byte 0xAF XOR
Response
Query Tilt Position 0xA0 Address 0x00 0x53 0x00 0x00 0xAF XOR
Query Tilt Position 0xA0 Address 0x00 0x5B Value High Byte Value Low Byte 0xAF XOR
Response
Query Zoom Position 0xA0 Address 0x00 0x55 0x00 0x00 0xAF XOR
Query Zoom Position 0xA0 Address 0x00 0x5D Value High Byte Value Low Byte 0xAF XOR
Response

AT-HDVS-CAM 13
Toll free US International
atlona.com • 877.536.3976 • 41.43.508.4321

© 2019 Atlona Inc. All rights reserved. “Atlona” and the Atlona logo are registered trademarks of Atlona Inc. All other brand names and trademarks or registered trademarks are the property of their respective owners. Pricing, specifications and
availability subject to change without notice. Actual products, product images, and online product images may vary from images shown here.

You might also like