TELEMETRY

The TELEMETRY object corresponds to the Telemetry controller system object.

The TELEMETRY object sends events presented in the table. Procedure is started when the corresponding event appears.

Format of events procedure for the Telemetry controller object:

OnEvent("TELEMETRY","_id_","_event_")

Description of events of the TELEMETRY object.

Event	Description	Comment
LOCKED	Locked	Event is received after the LOCK command (see the following command)
UNLOCKED	Unlocked	Event is received after the UNLOCK command (see the following command)

Operator format to describe actions with the short message service is:

DoReact("TELEMETRY","_id_","_command_" [,"_parameters_"]);

List of commands and parameters for the TELEMETRY object is presented 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 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 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 selected preset	tel_prior<>	Priority (1 – low, 2 – medium, 3 – high)
"CLEAR_PRESET" – clear selected preset	preset<>	Preset
"D2OFF" – disable additional dynamic settings for Panasonic ptz video cameras designed to increase quality of analog video signal	tel_prior<>	Priority (1 – low, 2 – medium, 3 – high)
"D2ON" – enable additional dynamic settings for Panasonic ptz video cameras designed to increase quality of analog video signal	tel_prior<>	Priority (1 – low, 2 – medium, 3 – high)
"DOWN" – rotate video camera objective down	tel_prior<>	Priority (1 – low, 2 – medium, 3 – high)
"FOCUS_IN" – zoom in	tel_prior<>	Priority (1 – low, 2 – medium, 3 – high)
"FOCUS_OUT" – zoom out	tel_prior<>	Priority (1 – low, 2 – medium, 3 – high)
"FOCUS_STOP" – stop zooming in/out of image	tel_prior<>	Priority (1 – low, 2 – medium, 3 – high)
"GO_PRESET" – rotate video camera to position specified on preset	tel_prior<>	Priority (1 – low, 2 – medium, 3 – high)
	preset<>	Preset
"HOME" – rotate video camera to 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	tel_prior<>	Priority (1 – low, 2 – medium, 3 – high)
"LEFT_DOWN" – rotate video camera objective left and down	tel_prior<>	Priority (1 – low, 2 – medium, 3 – high)
"LEFT_UP" – rotate video camera objective left and up	tel_prior<>	Priority (1 – low, 2 – medium, 3 – high)
"PATROL_LEARN" – start procedure of patrol programming performed by record of video camera actions	tel_prior<>	Priority (1– low, 2 – medium, 3 – high)
"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	tel_prior<>	Priority (1 – low, 2 – medium, 3 – high)
"RIGHT_DOWN" – rotate video camera objective right and down	tel_prior<>	Priority (1 – low, 2 – medium, 3 – high)
"RIGHT_UP" – rotate video camera objective right and up	tel_prior<>	Priority (1 – low, 2 – medium, 3 – high)
"SET_PRESET" – record current position of video camera to the selected preset	tel_prior<>	Priority (1 – low, 2 – medium, 3 – high)
	preset<>	Preset
"STOP" – stop video camera rotation	tel_prior<>	Priority (1 – low, 2 – medium, 3 – high)
"UP" – rotate video camera objective up	tel_prior<>	Priority (1 – low, 2 – medium, 3 – high)
"SETUP" – set up ptz device	address<>	Device address
	cam<>	Camera ID to control
	flags<>	Flag of object operating (0 – ON, 1 – OFF)
	name<>	Object name of ptz device
	speed<>	Speed
"SEND_BUFFER" – send command to COM port in hexadecimal format	buffer<>	Command in hexadecimal format
	parent_id<>	ID of Telemetry controller parent object. Required parameter
	tel_prior<>	Priority (1 – low, 2 – medium, 3 – high). Value of parameter is to be more than 0
LOCK – lock. Switch over telemetry to the LOCKED state for specified time	tel_prior<>	Priority (1 – low, 2 – medium, 3 – high). Value of parameter is to be more than 0. It is forbidden to perform control commands with lower priority than specified during the blocking time
	duration<>	Locking duration. Locking in force until UNLOCK command performing if parameter is not specified
UNLOCK – unlock. Switch over telemetry to the UNLOCKED state for specified time	-	-

Properties of the TELEMETRY object are shown in the table.

Properties of the TELEMETRY object	Description of properties
ID<>	Object ID
PARENT_ID<>	Parent object ID

The TELEMETRY object can be in the following states:

State of the TELEMETRY object	Description
LOCKED – locked	Control of telemetry is locked with some priority. It is forbidden to control telemetry with priority higher than specified while locking (see the table below)
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.

OnEvent("CAM","1","ARM")
{
  DoReact("TELEMETRY","1", "AUTOFOCUS_ON");
}

Rotate video camera to position specified in the first preset while enabling relay.

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.
```
OnEvent("MACRO","1","RUN")
{
  DoReact("TELEMETRY","1.1","PATROL_LEARN","cam<1>,preset<1>,tel_prior<1>,dwell<25>,speed<10>,flush_tour<0>");
  Wait(2);
  DoReact("TELEMETRY","1.1","LEFT","speed<6>,tel_prior<1>");
  Wait(2);
  DoReact("TELEMETRY","1.1","STOP","speed<6>,tel_prior<1>");
  Wait(2);
  DoReact("TELEMETRY","1.1","PATROL_LEARN","cam<1>,preset<2>,tel_prior<1>,dwell<25>,speed<10>,flush_tour<1>");
}
```

Page tree

Documentation for Axxon PSIM 1.0.0-1.0.1.