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.