Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The TELEMETRY object corresponds to the Telemetry controller system PTZ device system object.

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

Format of the events procedure for the Telemetry controller object PTZ device object:

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

Description of the events of from the TELEMETRY object.

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 commandtable below)

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

Code Block
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 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

PTZ video cameras

designed

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

PTZ video cameras

designed

used to increase the quality of analog video signal

tel_prior<>

Priority (1

low, 2

medium, 3

high)

"

DOWN

" –

rotate video camera

objective

lens 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 the position specified on the preset

tel_prior<>

Priority (1

low, 2

medium, 3

high)

preset<>

Preset

"

HOME

" –

rotate video 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

lens to the left

tel_prior<>

Priority (1

low, 2

medium, 3

high)

"

LEFT_DOWN

" –

rotate video camera

objective

lens to the left and down

tel_prior<>

Priority (1

low, 2

medium, 3

high)

"

LEFT_UP

" –

rotate video camera

objective

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

recording the video camera actions

tel_prior<>

Priority (

1–

1low, 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

lens to the right

tel_prior<>

Priority (1

low, 2

medium, 3

high)

"

RIGHT_DOWN

" –

rotate video camera

objective

lens to the right and down

tel_prior<>

Priority (1

low, 2

medium, 3

high)

"

RIGHT_UP

" –

rotate video camera

objective

lens to the right and up

tel_prior<>

Priority (1

low, 2

medium, 3

high)

"

SET_PRESET

" –

record the current position of video camera to the selected preset

tel_prior<>

Priority (1

low, 2

medium, 3

high)

preset<>

Preset

"

STOP

" –

stop video camera lens rotation

tel_prior<>

Priority (1

low, 2

medium, 3

high)

"

UP

" –

rotate video camera

objective

lens up

tel_prior<>

Priority (1

low, 2

medium, 3

high)

"

SETUP

" –

set up

ptz

PTZ device





address<>

Device address

cam<>

Camera ID to control

flags<>

Flag of object operating (0

ON, 1

OFF)

name<>

Object name of

ptz

PTZ device

speed<>

Speed

"

SEND_BUFFER

" –

send command to COM port in the hexadecimal format



buffer<>

Command in the hexadecimal format

parent_id<>

ID of Telemetry

controller

Сontroller parent object.

Required

The required 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 the telemetry over

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 during the

blocking

lock time

duration<>

Locking

Lock duration.

Locking in force until UNLOCK command performing if parameter is not specified

If the parameter is not specified, the lock is valid until the UNLOCK command is executed

UNLOCKunlock. Switch the telemetry over

UNLOCK – unlock. Switch over telemetry

to the UNLOCKED state for a specified time

-

-

AUTOFOCUS_OFF—disable autofocustel_prior<>

Priority (1low, 2medium, 3high).

(предупреждение)Image AddedTo 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 is locked with some priority. It is forbidden to control telemetry with a priority higher lower than the specified while when locking (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:

  1. Set autofocus when video camera is armed.

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


  2. Rotate video camera to the position specified in the first preset while enabling 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>");
    }


  3. 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.

    Code Block
    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>");
    }