Go to documentation repository
The TELEMETRY object corresponds to the Telemetry controller system PTZ device system object.
The TELEMETRY object sends events presented in the table . Procedure is started below. The procedure starts when the corresponding event appears.
Format of events procedure for the Telemetry controller object:
| Code Block |
|---|
OnEvent("TELEMETRY","_id_","_event_") |
Description of events of the TELEMETRY objectoccurs.
Event | Description | Comment |
LOCKED | Locked | Event is received after the LOCK command (see the following commandtable below) |
UNLOCKED | Unlocked | Event is received after the UNLOCK command (see the following command) |
Operator format to describe actions with the short message service is:
...
table below) |
List of commands and parameters for the the TELEMETRY object is presented given in the following table:
Command – —command description | Parameters | Description | ||
"AUTOFOCUS_ON" – —enable autofocus | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"AUTOPAN_END_P" – —specify the end point of autopan | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"AUTOPAN_START" – —start autopan | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"AUTOPAN_START_P" – —specify the start point of autopan | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"AUTOPAN_STOP" – —stop autopan | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"CLEAR_PRESET" – —clear the selected preset | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
preset<> | Preset | |||
"D2OFF" – —disable the additional dynamic settings for Panasonic ptz video cameras designed PTZ cameras used to increase the quality of analog video signal | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"D2ON" – —enable the additional dynamic settings for Panasonic ptz video cameras designed PTZ cameras used to increase the quality of analog video signal | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"DOWN" – rotate video camera objective DOWN—rotate camera lens down | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"FOCUS_IN" – zoom in—focus camera lens on the image | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"FOCUS_OUT" – zoom out—defocus camera lens | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"FOCUS_STOP—stop focus/defocus | tel_prior<> | Priority (1—low, 2—medium, 3—high) | ||
ZOOM_IN—zooming in the image | tel_prior<> | Priority (1—low, 2—medium, 3—high) | ||
ZOOM_OUT—zooming out the image | tel_prior<> | Priority (1—low, 2—medium, 3—high) | ||
ZOOM_STOP—stop " – stop zooming in/out of the image | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"GO_PRESET" – rotate video camera to —rotate camera to the position specified on in the preset | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
preset<> | Preset | |||
"HOME" – rotate video camera to HOME—rotate camera to the initial (home) position | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"IRIS_CLOSE" – —close diaphragm | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"IRIS_OPEN" – —open diaphragm | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"IRIS_STOP" – —stop diaphragm | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"LEFT" – rotate video camera objective LEFT—rotate camera lens to the left | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"LEFT_DOWN" – rotate video camera objective —rotate camera lens to the left and down | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"LEFT_UP" – rotate video camera objective —rotate camera lens to the left and up | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high)" | ||
PATROL_LEARN | " – —start procedure of patrol programming performed by | record of video recording the camera actions | tel_prior<> | Priority (1– 1—low, 2 – —medium, 3 – high)—high) |
point<> | Point number | |||
preset<> | Preset number (tour) | |||
dwell<> | Dwell time in a point in seconds | |||
speed<> | Speed of movement to a point | |||
flush_tour<> | 1—flush tour 0—don't flush tour | |||
PATROL_PLAY—"PATROL_PLAY" – start patrolling | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"PATROL_STOP" – —stop patrolling | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"RIGHT" – rotate video camera objective RIGHT—rotate camera lens to the right | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"RIGHT_DOWN" – rotate video camera objective —rotate camera lens to the right and down | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"RIGHT_UP" – rotate video camera objective —rotate camera lens to the right and up | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"SET_PRESET" – —record the current position of video camera of camera to the selected preset | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
preset<> | Preset | |||
"STOP" – stop video camera STOP—stop camera lens rotation | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"UP" – rotate video camera objective UP—rotate camera lens up | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high) | ||
"SETUP" – —set up ptz PTZ device | address<> | Device address | ||
cam<> | Camera ID to for control | |||
flags<> | Flag of object operating (0 – ON—enabled, 1 – OFF—disabled) | |||
name<> | Object name of ptz PTZ device | |||
speed<> | Speed | |||
"SEND_BUFFER" – —send command to the COM port in the hexadecimal format | buffer<> | Command in the hexadecimal format | ||
parent_id<> | ID Number of the Telemetry controllerController parent object. Required Mandatory parameter | |||
tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high). Value The value of the parameter is to must be more greater than 0 | |||
LOCK – —lock. Switch over the telemetry to the LOCKED state for a specified time | tel_prior<> | Priority (1 – —low, 2 – —medium, 3 – —high). Value The value of the parameter is to must be more greater than 0. It is forbidden to perform control commands with a lower priority than the specified one during the blocking lock time | ||
duration<> | Locking Lock duration. Locking in force until UNLOCK command performing if parameter is not specifiedIf the parameter isn't specified, the lock is valid until the UNLOCK command is executed | |||
UNLOCK—unlock. Switch the UNLOCK – unlock. Switch over telemetry to the UNLOCKED state for specified time | - | NA | NA | |
| AUTOFOCUS_OFF—disable autofocus | tel_prior<> | Priority (1—low, 2—medium, 3—high). To use this command, you must add it to the Reactions tab for the TELEMETRY object in ddi.exe (see The Reactions tab) |
Properties of the TELEMETRY object are shown in the table.
Properties of the TELEMETRY object | Description of the object properties |
ID<> | Object ID of the PTZ device |
PARENT_ID<> | Parent object ID |
...
State of the TELEMETRY object | Description of the object state |
LOCKED – —locked | Control of telemetry Telemetry control is locked with some priority. It is forbidden to control telemetry with a priority higher lower than specified while locking the specified one during the lock time (see the table belowabove) |
UNLOCKED – —unlocked | It is allowed to control telemetry with any priority |
Examples of using events and reactions of the TELEMETRY object:
Set autofocus when video camera is armed.
| Code Block |
|---|
OnEvent("CAM","1","ARM")
{
DoReact("TELEMETRY","1", "AUTOFOCUS_ON");
} |
Rotate video camera to position specified in the first preset while enabling relay.
| Code Block |
|---|
OnEvent("GRELE","1","ON")
{
telemetry_id= GetObjectParam("CAM","1","parent_id");
DoReact("TELEMETRY","telemetry_id","SETUP","GO_preset<1>");
} |
Record the patrol route for Camera 1 corresponding to the PTZ device 1.1. The route consists of two points, such that to go from point 1 to point 2, you need to rotate the camera to the left at speed of 6 for 2 seconds. Patrolling must be performed at speed of 10. The time at each point of the route is 25 seconds. It is supposed that when the program is started, the camera is set to the position corresponding to the first point of the route.
...