Vaddio Vaddio ClearVIEW HD-USB Vaddio ClearVIEW HD-USB Manual - Page 30

Camera Home, Camera Pan

Page 30 highlights

ClearVIEW HD-USB Conferencing Camera APPENDIX 2 - TELNET SERIAL COMMAND API The Vaddio Serial Command protocol is a high level text based command line interface supported via telnet session on the ClearVIEW HD-USB PTZ Camera. The Vaddio Serial Command protocol is not supported on the RS-232 port. The RS-232 port is dedicated for VISCA commands only. The command application protocol interface is intended to allow external device such as AMX and Crestron to control the camera. The protocol is based upon ASCII format following the VT100 terminal emulation standard and uses an intuitive textual command nomenclature for ease of use. The API is accessed by a telnet client on the Ethernet port. All ASCII characters will be echoed to terminal program and appended with VT100 string -ESC[J (HEX- 1B 5B 4A). Vaddio Command lines are terminated on carriage return. After the carriage return, the VT100 appends with - ESC[J. (Note: Most terminal programs automatically strip the VT100 string.) General format usage follows a get/set structure. Usage examples for each type are: Set Example COMMAND: > camera pan right RESPONSE: > OK Get Example COMMAND: > stream mode get RESPONSE: > streaming mode usb Syntax Error Example COMMAND: > camera pan right RESPONSE: > ERROR Additional programming controls associated with the terminal protocol includes:  CTRL 5 - Clears the current serial buffer on the device. Telnet sessions will require access verification and uses the same username and password associated with the Administrator account on the embedded web server. The default Telnet Port is 23. Command lines are terminated with carriage return. Telnet Command List Camera Home  NAME camera home - Move the camera to the home position  SYNOPSIS camera home  DESCRIPTION Method used to move the camera to the home position  EXAMPLES camera home Move the camera back to the home position Camera Pan  NAME camera pan - Pans the camera left or right  SYNOPSIS camera pan {left|right|stop} [1-24]  DESCRIPTION Method used to pan the camera  OPTIONS left Move the camera left right Move the camera right stop Stop the camera movement speed Optional integer from 1-24 that represents the speed (Default: 12)  EXAMPLES camera pan left Pans the camera left at the default speed camera pan right 20 Pans the camera right using a speed of 20 camera pan stop Stops the pan movement of the camera Image: Riveting example of simulated Telnet session ClearVIEW HD-USB PTZ Conferencing Camera Document Number 342-0437 Rev. D Page 30 of 36

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36

ClearVIEW HD-USB Conferencing Camera
ClearVIEW HD-USB PTZ Conferencing Camera Document Number 342-0437 Rev. D
Page 30 of 36
A
PPENDIX
2
-
T
ELNET
S
ERIAL
C
OMMAND
API
The Vaddio Serial Command protocol is a high level text based command line interface supported via telnet
session on the ClearVIEW HD-USB PTZ Camera. The Vaddio Serial Command protocol is not supported on the
RS-232 port.
The RS-232 port is dedicated for VISCA commands only.
The command application protocol
interface is intended to allow external device such as AMX and Crestron to control the camera.
The protocol is
based upon ASCII format following the VT100 terminal emulation standard and uses an intuitive textual
command nomenclature for ease of use.
The API is accessed by a telnet client on the Ethernet port.
All ASCII
characters will be
echoed
to terminal program and appended with VT100 string -
ESC[J
(HEX- 1B 5B 4A).
Vaddio Command lines are terminated on carriage return. After the carriage return, the VT100 appends with –
ESC[J
.
(Note:
Most terminal programs automatically strip the VT100 string.)
General format usage follows a
get/set
structure. Usage examples for each type are:
Set Example
COMMAND:
> camera pan right
RESPONSE: > OK
Get Example
COMMAND:
> stream mode get
RESPONSE:
> streaming mode usb
Syntax Error Example
COMMAND: > camera pan right
RESPONSE:
> ERROR
Additional programming controls associated with the terminal protocol includes:
CTRL 5
- Clears the current serial buffer on the device.
Telnet sessions will require access verification and uses the same username and password associated with the
Administrator account on the embedded web server.
The default Telnet Port is 23.
Command lines are
terminated with carriage return.
Telnet Command List
Camera Home
NAME
camera home
- Move the camera to the home position
SYNOPSIS
camera
home
DESCRIPTION
Method used to move the
camera
to the
home
position
EXAMPLES
camera
home
Move the
camera
back to the
home
position
Camera Pan
NAME
camera pan
- Pans the camera left or right
SYNOPSIS
camera
pan
{left|right|stop} [
1-24
]
DESCRIPTION
Method used to
pan
the
camera
OPTIONS
left
Move the
camera
left
right
Move the
camera
right
stop
Stop the
camera
movement
speed
Optional integer from
1-24
that represents the speed (Default: 12)
EXAMPLES
camera
pan
left
Pans the
camera
left at the default speed
camera
pan
right 20
Pans the
camera
right using a speed of 20
camera
pan stop
Stops the
pan
movement of the
camera
Image:
Riveting example of simulated Telnet session