KDec-300
Protocol of the telemetry commands
Interface parameters:
-
Baud rate: 300 to 19200 Bd
-
Parity bit: Space (logical 0)
-
Start bit: 1
-
Stop bit: 1
-
Data bits: 7
-
Handshake: None
The telemetry commands are transmitted in plain text using ASCII characters.
Complete command set = [command] + CR + LF
Meaning of the command short forms and variables within the table:
• SN = Command short form for camera telemetry control
• PP = Command short form "Program camera pre-position / fixed position"
• kkk = Camera number (000 - 999)
• vvv = Variable speed for pan/tilt (000 - 255)
• pp = Camera pre-position / fixed position (01 - 99)
The meanings of the remaining short forms may be seen from context.
|
Command |
Function |
Command |
Function |
|---|---|---|---|
|
SNkkkS- |
Pan (fast/normal) right |
SNkkkB0 |
Iris stop |
|
SNkkkS+ |
Pan (fast/normal) left |
SNkkkL1 |
Switch on illumination (light on) |
|
SNkkkS0 |
Pan stop |
SNkkkL0 |
Switch off illumination (light off) |
|
SNkkkS-vvv |
Pan (with variable speed) right* |
SNkkkK1 |
Switch on camera |
|
SNkkkS+vvv |
Pan (with variable speed) left * |
SNkkkK0 |
Switch off camera |
|
SNkkkN- |
Tilt (fast/normal) downwards |
SNkkkW1 |
Switch on wiper motor (wash/wipe) |
|
SNkkkN+ |
Tilt (fast/normal) upwards |
SNkkkW0 |
Switch off wiper motor (wash/wipe) |
|
SNkkkN0 |
Tilt stop |
SNkkkP1 |
Switch on water pump (wash/wipe) |
|
SNkkkN-vvv |
Tilt (with variable speed) downwards* |
SNkkkP0 |
Switch off water pump (wash/wipe) |
|
SNkkkN+vvv |
Tilt (with variable speed) upwards* |
SNkkkX1 |
Activate auxiliary function X |
|
SNkkk++ |
Switch on fast mode for P/T head |
SNkkkX0 |
De-activate auxiliary function X |
|
SNkkk-- |
Switch on normal (slow) mode for P/T head |
SNkkkY1 |
Activate auxiliary function Y |
|
SNkkkF- |
Focus near |
SNkkkY0 |
De-activate auxiliary function Y |
|
SNkkkF+ |
Focus far |
SNkkkU1 |
Activate auxiliary function U * |
|
SNkkkF0 |
Focus stop |
SNkkkU0 |
De-activate auxiliary function U * |
|
SNkkkZ- |
Zoom wide |
SNkkkV1 |
Activate auxiliary function V * |
|
SNkkkZ+ |
Zoom tele |
SNkkkV0 |
De-activate auxiliary function V * |
|
SNkkkZ0 |
Zoom stop |
SNkkk.pp |
Recall camera fixed position ** |
|
SNkkkB- |
Iris open |
PPkkk.pp |
Program camera fixed position ** |
|
SNkkkB+ |
Iris close |
SNkkkGP |
Recall home position |
* These functions cannot be carried out via MBeg.
** Camera fixed positions 01 to 40 may also be programmed and recalled via MBeg.
Example
SN012S-= Pan camera 12 to the right
SN012S0 = Stop pan of camera 12
SN012S-075 = Pan camera 12 to the right with speed value 75
PP003.05 = Store actual position of camera 3 as fixed position No 5
KDec-300 Version 3.x
Current status: V3.3
The new KDec-300 firmware makes the following new features available:
-
The KDec can run 1 tour
-
The KDec's parameterisation can be carried out remotely
-
Other detailed improvements
Features 3.x:
|
Firmware |
3.x |
|---|---|
|
Changes to hardware required |
No |
|
Number of tours |
1 |
|
Maximum number of stops in each tour |
16 |
|
Number of fixed positions |
99 |
|
Maximum baud rate |
19200 |
Existing KDecs fitted with firmware version 2.x can be upgraded to version 3.x by exchanging the existing processor for a new one. Upgrading to version 3.x does not require any other changes to the hardware.
Using the Windows registry keyHKLM\SOFTWARE\Geutebrueck\GeViScope\Telecontrol\ClientData\KDec300ExDWORD
orHKLM\SOFTWARE\Geutebrueck\Gng\Telecontrol\ClientData\KDec300ExDWORD
(on the machine on which Telecontrol is running) the fixed position commands (save/call) can be switched to another range.
Normally the KDec driver only supports fixed positions up to 99. If the value of KDec300Ex is set to 1, fixed positions up to 255 can be used. These are needed, for instance, when controlling Argus using the KDec 300 protocol from Telecontrol.
Summary of the KDec-300 Version 3.3 Commands
Commands must be given using upper-case letters. Lowercase letters in the following tables indicate variables.
All commands are concluded with cr (0x0D); lf (0x0A) is ignored.
All responses are concluded with cr lf (0x0D 0x0A).
Commands already found in version 2.x:
|
Command |
Function |
|---|---|
|
SNcccS- |
Pan right slow |
|
SNcccS-spd |
Pan right variable |
|
SNcccS+ |
Pan left slow |
|
SNcccS+spd |
Pan left variable |
|
SNcccS0 |
Pan stop |
|
SNcccN- |
Tilt down slow |
|
SNcccN-spd |
Tilt down variable |
|
SNcccN+ |
Tilt up slow |
|
SNcccN+spd |
Tilt up variable |
|
SNcccN0 |
Tilt stop |
|
SNccc++ |
Pan / Tilt fast |
|
SNccc-- |
Pan / Tilt slow |
|
SNcccF- |
Focus near |
|
SNcccF-spd |
Focus near variable* |
|
SNcccF+ |
Focus far |
|
SNcccF+spd |
Focus far variable* |
|
SNcccF0 |
Focus stop |
|
SNcccZ- |
Zoom wide |
|
SNcccZ-spd |
Zoom wide variable* |
|
SNcccZ+ |
Zoom tele |
|
SNcccZ+spd |
Zoom tele variable* |
|
SNcccZ0 |
Zoom stop |
|
SNcccB- |
Iris open |
|
SNcccB+ |
Iris close |
|
SNcccB0 |
Iris stop |
|
SNcccL0 |
Light off |
|
SNcccL1 |
Light on |
|
SNcccK0 |
Camera off |
|
SNcccK1 |
Camera on |
|
SNcccW0 |
Wiper off |
|
SNcccW1 |
Wiper on |
|
SNcccP0 |
Washer off |
|
SNcccP1 |
Washer on |
|
SNcccX0 |
Function X off |
|
SNcccX1 |
Function X on |
|
SNcccY0 |
Function Y off |
|
SNcccY1 |
Function Y on |
|
SNcccU0 |
Function U off |
|
SNcccU1 |
Function U on |
|
SNcccV0 |
Function V off |
|
SNcccV1 |
Function V on |
|
SNcccPT |
Motor/Pot. Test |
|
SNcccGP |
Goto Homeposition |
|
SNkkk.pos |
Goto Position |
|
PPkkk.pos |
Save Position |
* The "Focus variable" and "Zoom variable" commands are available in versions 3.3 onwards. They are interpreted in such a way that speeds >= 100 cause the motor to run, while speeds < 100 make it stop.
New commands and functions in version 3.x:
|
Command |
Function |
Response from KDec |
|---|---|---|
|
SNcccQV |
Query Version |
SNccc=QV KDEC-300 Vv.r PP |
|
SNcccQS |
Query Status |
SNccc=QSptfziww1234 |
|
SNcccQA |
Query Alarm |
SNccc=QAa |
|
SNcccQPpos |
Query Position / ADC |
SNccc=QPpos,pan,tlt,foc,zom |
|
SNcccQTtour,stop |
Query Tour |
SNccc=QTtour,stop,pos,spd,tim |
|
SNcccGPpos |
GotoPosition |
|
|
SNcccSPpos |
Save Position |
SNcccACK |
|
SNcccPPpos,pan,tlt,foc,zom |
Program Position |
SNcccACK |
|
SNcccGCpan,tlt,foc,zom |
Goto Coordinates |
|
|
SNcccSA |
Start Tour Nr. 1 |
|
|
SNcccTStour |
Tour Start |
|
|
SNcccTPtour,stop,pos,spd,tim |
Tour Program |
SNcccACK |
|
SNccc!xxyyy |
Set Parameter |
SNcccACK |
|
SNccc?xx |
Query Parameter |
SNccc=xxyyy |
|
RESTART |
Restart KDec-300 |
|
Explanation of the Variables
Variables can be quoted at any length, with or without leading zeros.
|
Variable |
Description |
|---|---|
|
ccc |
KDec address, numerical, 0 - 999 (0: global) |
|
kkk |
KDec address, 3-figure, 000 - 999 (000:global) |
|
spd |
Motor speed, numerical, 0 - 255 |
|
v,r |
Version and revision numbers, two digits separated by a comma |
|
ptfziww1234 |
Motor running directions PTFZ (0, +, -) and the statuses of the Wipe, Wash and Aux1..4 (0, 1) relays |
|
a |
Alarm:0: no alarm is pending at present1: an alarm is currently pending2: an alarm is not pending at present, but has occurred since the last interrogation3: an alarm is currently pending, and has also occurred since the last interrogation |
|
pos |
Number of position, numerical, 1 to 99. Can also be 0 in the following special cases:With SNcccGP0 (go to home position): as SNcccGPWith SNcccTPtour,stop,0,spd,tim (tour program): end of the tourWith SNcccQP0 (query position / ADC): output the current ADC value |
|
pan |
Co-ordinates (ADC value) pan, numerical, 0 - 4095 |
|
tlt |
Co-ordinates (ADC value) tilt, numerical, 0 - 4095 |
|
foc |
Co-ordinates (ADC value) focus, numerical, 0 - 4095 |
|
zom |
Co-ordinates (ADC value) zoom, numerical, 0 - 4095 |
|
tour |
Number of a tour, numerical, 1 under version 3.xAlso 0 in the following special case:With SNcccTS0 (tour start 0): stop the tour that is in progress |
|
xx |
Represents an adjustable parameter, 2 characters |
|
yyy |
Setting, numerical, value range depends on the parameter concerned |
For further information see KDec manual.