Go to documentation repository
...
The TELEMETRY object sends events presented in the table below. The procedure is started starts when the corresponding event occurs.
Format of the events procedure for the PTZ device object:
| Code Block |
|---|
OnEvent("TELEMETRY","_id_","_event_") |
Description of the events from the TELEMETRY object.
Event | Description | Comment |
LOCKED | Locked | Event is received after the LOCK command (see the table below) |
UNLOCKED | Unlocked | Event is received after the UNLOCK command (see the table below) |
Operator format to describe actions with the PTZ devices is:
| Code Block |
|---|
DoReact("TELEMETRY","_id_","_command_" [,"_parameters_"]); |
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 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 PTZ cameras used to increase the quality of analog video signal | tel_prior<> | Priority (1—low, 2—medium, 3—high) | |
DOWN—rotate video camera 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 zooming in/out of the image | tel_prior<> | Priority (1—low, 2—medium, 3—high) | |
GO_PRESET—rotate video camera 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 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 rotate camera lens to the left | tel_prior<> | Priority (1—low, 2—medium, 3—high) | |
LEFT_DOWN—rotate video camera rotate camera lens to the left and down | tel_prior<> | Priority (1—low, 2—medium, 3—high) | |
LEFT_UP—rotate video camera 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 recording the | video camera actions | tel_prior<> | Priority (1—low, 2—medium, 3—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—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 rotate camera lens to the right | tel_prior<> | Priority (1—low, 2—medium, 3—high) | |
RIGHT_DOWN—rotate video camera rotate camera lens to the right and down | tel_prior<> | Priority (1—low, 2—medium, 3—high) | |
RIGHT_UP—rotate video camera 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 camera lens rotation | tel_prior<> | Priority (1—low, 2—medium, 3—high) | |
UP—rotate video camera rotate camera lens up | tel_prior<> | Priority (1—low, 2—medium, 3—high) | |
SETUP—set up 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 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 Controller parent object. The required Mandatory parameter | ||
tel_prior<> | Priority (1—low, 2—medium, 3—high). The value of the parameter must be greater than 0 | ||
LOCK—lock. Switch the telemetry over to the LOCKED state for a specified time | tel_prior<> | Priority (1—low, 2—medium, 3—high). The value of the parameter must be greater than 0. It is forbidden to perform control commands with a lower priority than the specified one during the lock time | |
duration<> | Lock duration. If the parameter is not isn't specified, the lock is valid until the UNLOCK command is executed | ||
UNLOCK—unlock. Switch the telemetry over to the UNLOCKED state for a 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.
...
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 lower than the specified when locking one during the lock time (see the table above) |
UNLOCKED—unlocked | It is allowed to control telemetry with any priority |
Examples of using 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 the position specified in the first preset with the relay enabled.
| 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.
...