Documentation for Monitoring PSIM 2.0 (english)

Previous page Next page

On the page:

Example of a macro for the Disarm action

If you want to track the Disarmed event for all server cameras, do the following:

  1. Select Settings.
  2. On the Programming tab, create the macro in which the Disarmed event must be specified as the start condition.
  3. Create the Run external application on server reaction to this event.

    1. Select the AgentHelper file as the executable one.

      Note

      On Linux OS, you must first copy the AgentHelper.sh file from the AgentOfControl/System folder to the corresponding Axxon One /opt/AxxonSoft/Axxon One/UserScripts folder manually. When you use Windows OS, the file is copied automatically.

    2. In the Launch parameters field, specify:
      1. The number of the TCP port on which the Agent of Control module awaits the data from the AgentHelper executable file. The allowable values are in the range 8889–9900 (in the current example—8889). The number of the used port is specified in the TCP port (UPS) field on the Communication tab of the Agent of Control module settings.
      2. The number of alarm groups on the Server of Control module to which the given alarm gets. The allowable values are in the range 1–6 (in the current example—1), where:
        • 1—Hardware,
        • 2—ACS,
        • 3—SFA,
        • 4—Detections,
        • 5—Extra 1,
        • 6—Extra 2.
      3. The attached video data to alarms. The allowable values are >=0. If you set the 0 value, the video data isn't transferred. When you transfer JPG frames or videos, specify the serial camera number in the list on the Cameras tab from which an image is received (in the current example—1).
      4. The type of the transferred video data. The allowable values are jpg and avi (in the current example—jpg). When you select jpg, one or several JPG frames are transferred, avi—small video.
      5. The first setting parameter for the video data. For the jpg type, that is the number of the transferred frames in the range from 1 to 10 (in the current example—1), for avi, it is the length of the video fragment in seconds in the range from 5 to 10.
      6. The second setting parameter for the video data. For the jpg type, that is the interval between frames in seconds in the range from 1 to 99 (in the current example—1), for avi, it is the bit rate in Kbit/s (0—without rate limitation).
      7. The list of ports to connect to the Event source objects that are used for overlaying captions separated by a space. If you don't want the captions overlay, then specify the double empty quotation marks "", if you want it, specify the ports of all Event source objects within the double empty quotation marks separated by a space (in the current example—"2555 2556").

        Note

        First, you must create one or several Event source objects where, from the Vendor drop-down list, you must select PosXml, and, in the Template file field, specify the file that is located in the /home/{user}/AgentOfControl/System/xml_titles.txt (Linux) or C:\Program Files (x86)\AgentOfControl\System\xml_titles.txt (Windows) default path.
        Example of configuring the Event source object:

      8. The alarm message as a string with 1–120 characters. If there are spaces, you must put a message in the quotation marks (in the current example—"Disarmed").
      9. The additional information as a string with 1–30 characters. This is the optional parameter (absent in the current example) that is used if you want to receive the additional information about the alarm using the text templates (Text templates in the action settings).

Creating the additional reaction to the Camera : Start recording alarm

If a camera isn't in the continuous recording mode, then to attach the JPG frame from it, you must ensure recording at the alarm situation by creating the additional reaction to the Camera: Start recording alarm.

Macro generates an event

When you disarm any camera, the reaction on the Server of Control module includes the Disarmed alarm message and the attached JPG frame from the camera with the overlaid captions.

If you specify the {cameraLabel} text template as additional information to the launch parameter, the Camera 1 camera name is added to the alarm name as additional information (for more details, see Text templates in the action settings).


This version supports the transmission of the deferred alarms. That is, if there is no connection with the Server of Control module at the moment when an alarm occurs, this alarm is saved in the AgentOfControl/Cfg/deferred.sys file. When you restore the connection, the deferred alarms are transferred to the Server of Control module.

Tracking alarms using macros is complete.

  • No labels