TRBOnet Swift CPS User Guide

Transcription

1 TRBOnet Swift CPS User Guide Version 1.4 World HQ Neocom Software 8th Line 29, Vasilyevsky Ostrov St. Petersburg, , Russia US Office Neocom Software Jog Road, Suite 202 Delray Beach, FL 33446, USA Internet Telephone EMEA: Americas: APAC:

2 Legal Notices Legal Notices This document is for informational purposes only. Neocom Software, Ltd offers no warranties, express or implied, in this document. Neocom and the Neocom logo, TRBOnet and the TRBOnet logo are either registered trademarks or trademarks of Neocom Software, Ltd. MOTOROLA, MOTO, MOTOROLA SOLUTIONS and the Stylized M logo are trademarks or registered trademarks of Motorola Trademark Holdings, LLC. Intellectual property rights protect the voice coding technology embodied in this product including patent rights, copyrights and trade secrets of Digital Voice Systems, Inc. This voice coding technology is licensed solely for use within this communications equipment. U.S. Pat. Nos. 6,199,037, 5,870,405, 5,754,974, 5,664,051, 5,630,011, 5,517,511, 5,491,772, 5,247,579, 5,226,108, 5,226,084, 5,216,747 and 5,081,681. Microsoft, Windows, SQL Server and the.net logo are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other jurisdictions. Other product or company names mentioned herein may be trademarks of their respective owners by Neocom Software, Ltd. All rights reserved. Last revised on 20 November 2015.

3 Contents Contents 1. Introduction About This Guide About TRBOnet Swift Contacts Overview About TRBOnet Swift CPS About Swift Event Logic Software Requirements Compatibility with TRBOnet Swift Firmware Versions Licensing Glossary Installation and Upgrade Firmware Update Device Programming Operations Connection Settings Configuring nrf Connection Configuring GPRS Connection Configuring GSM Connection Configuring RS-232 Serial Port Swift Event Logic Selecting RS-232 Protocol Managing Report Settings Managing Rules Managing Regions TRBOnet Swift CPS 1.4 User Guide 3

4 Introduction 1. Introduction 1.1. About This Guide This document is intended for engineers responsible for building MOTOTRBO radio networks and programming two-way radios for end users About TRBOnet Swift TRBOnet Swift is a family of hardware products by Neocom Software, Ltd designed for use in MOTOTRBO radio networks. The TRBOnet Swift family hardware is presented by IP gateways, the ST001 option board, the DT500 data transfer module, and the TR001 GPS tracker Contacts Region Phone & Support EMEA Americas APAC info@trbonet.com general and commercial inquiries support@trbonet.com technical support online knowledge base 4 TRBOnet Swift CPS 1.4 User Guide

5 Overview 2. Overview 2.1. About TRBOnet Swift CPS TRBOnet Swift CPS is the configuration editor designed for programming MOTOTRBO GOB option boards and the TRBOnet Swift family electronic devices with Swift Event Logic on board. TRBOnet Swift CPS can work with configuration files and with configurations loaded from devices. In addition, it can update the device firmware, read device memory, and program devices with an extended configuration provided by Neocom Software, Ltd by customer request. The intuitive user interface serves to facilitate every step of device programming. Automatic detection of a connected device TRBOnet Swift CPS automatically detects a device connection and informs the user about the type of device and the connection interface. The number of connected devices is only limited by the number of USB ports available on the computer. Device-specific settings only TRBOnet Swift CPS displays the configuration settings specific to a given type of device. Where possible, the recommended settings are set by default. Event Logic defined by rules Rule Editor facilitates the process of building Event Logic rules from configurable components. This tool allows the user to create new rules from copies with minimum effort. Sample configuration files TRBOnet Swift CPS comes with a set of sample configuration files for all supported devices. Sample configurations demonstrate the use of rules for setting up various Event Logic features. Sample files can serve as a starting point for creating device configurations when other configuration sources are not available. TRBOnet Swift CPS 1.4 User Guide 5

6 Overview 2.2. About Swift Event Logic TRBOnet Swift Event Logic is a unified programmable environment supported by TRBOnet Swift DT500, TRBOnet Swift ST001, and MOTOTRBO GOB. The basic configurable components of Swift Event Logic include events, conditions, and actions. Swift Event Logic extends the capabilities of a standard radio network by implementing special features such as Lone Worker, Man Down, No Movement, Crash Detect, GeoRoaming, and GeoFencing Software Requirements Table 1: TRBOnet Swift 1.4 software requirements Category Requirements CPU Memory Display Intel Core i3 4 GB 1280x1024 minimal resolution, 1600x900 recommended resolution Supported OS Windows 7, Windows 8, Windows 10 Software.NET Framework Compatibility with TRBOnet Swift Firmware Versions The following table describes the compatibility between TRBOnet Swift CPS versions and TRBOnet Swift firmware versions for each type of supported hardware. Table 2: Device firmware versions compatible with TRBOnet Swift CPS TRBOnet Swift Supported hardware CPS version TRBOnet Swift TRBOnet Swift MOTOTRBO DT500 ST001 GOB 1.4 R R R TRBOnet Swift CPS 1.4 User Guide

7 Overview 2.5. Licensing TRBOnet Swift Event Logic features are available on terms of commercial licensing. The following table describes the licenses required by particular features. Note: If a configuration uses commercial features, they do not work on a device until the required license is purchased and activated on that device. Table 3: Licensed features License Description Related features Tracker This license enables getting GNSS data from the radio. Sending GNSS reports to TRBOnet Server, Speed Limit GeoZones This license enables monitoring of the radio s location in the predefined geographical regions. GeoRoaming, GeoFencing Safety This license enables getting data from the accelerometer. Man Down, No Movement, Crash Detect DataPort This license enables data transfer on the RS-232 port. Communication with external devices over the RS-232 interface Note: The Lone Worker feature is enabled on a device when any above license is activated Glossary This section lists all abbreviations used in this document. Table 4: Abbreviations Term Description CAI CPS Common Air Interface Customer Programming Software TRBOnet Swift CPS 1.4 User Guide 7

8 Overview Term Description CPU GNSS GPRS GSM HDD ID OS PDU RFID SMS Central Processing Unit Global Navigation Satellite System General Packet Radio Service Global System for Mobile Communications Hard Disk Drive Identifier Operating System Protocol Data Unit Radio Frequency Identification Short Message Service 8 TRBOnet Swift CPS 1.4 User Guide

9 Installation and Upgrade 3. Installation and Upgrade The following table describes how to install, uninstall, and upgrade your TRBOnet Swift CPS software. Table 5: Installing, uninstalling, and upgrading TRBOnet Swift CPS To do this Install TRBOnet Swift CPS Perform these steps Note: Before installing TRBOnet Swift CPS, make sure that your computer meets the minimum software requirements. For more information, refer to Software Requirements. 1. Double-click the Swift_CPS_<version>.exe file to run the TRBOnet Swift CPS Setup wizard. Click Next. 2. Accept the terms of the license agreement. Click Next. 3. Click Install, then click Finish to exit the setup wizard. Uninstall TRBOnet Swift CPS from your computer 1. Double-click the Swift_CPS_<version>.exe file to run the TRBOnet Swift CPS Setup wizard. Click Next. 2. Select the Remove option. 3. Click Remove, then click Finish to exit the setup wizard. The TRBOnet Swift CPS software is removed from your computer. Upgrade TRBOnet Swift CPS To upgrade TRBOnet Swift SPC to a higher version, just install the new version on your computer as described above. Uninstalling the previous version of the product is not required. TRBOnet Swift CPS 1.4 User Guide 9

10 Firmware Update 4. Firmware Update Before you proceed to device programming, make sure that your device meets the firmware version requirements. Find information about firmware versions for all supported devices in section Compatibility with TRBOnet Swift Firmware Versions. Note: To update the firmware version on MOTOTRBO GOB, use the MOTOTRBO GOB Flasher tool by MOTOROLA. To update the firmware version: 1. Launch TRBOnet Swift CPS and connect your device to the computer. TRBOnet Swift CPS detects the connected device automatically and displays the connection in the status bar. Figure 1: Automatically detecting a connected device Note: If TRBOnet Swift CPS fails to detect the connected device automatically, the cause may be the hardware driver not found on your computer. For details, refer to the user manual provided for your device. 10 TRBOnet Swift CPS 1.4 User Guide

11 Firmware Update 2. (Optional) If your device is already configured, the configuration will be cleared from device memory after firmware update. To keep the current configuration, save it to a file by selecting Read and then Save as in the Device menu. Use this file to restore the current configuration on your device after firmware update. 3. Select Update in the Device menu. The current firmware version of your device appears in the Info about device section of the Firmware update window. Figure 2: Updating the device firmware version 4. Select the required firmware version in the Firmware menu. Click Update. 5. Write a configuration to your device. TRBOnet Swift CPS 1.4 User Guide 11

12 5. Device Programming This section describes how to create Swift Event Logic configuration, how to work with configuration files, and how to perform read and write operations on a device Operations To start your work, read a configuration from memory of a device or open a configuration file. Table 6: Opening a configuration in TRBOnet Swift CPS To do this Read a configuration from a device Perform these steps 1. Connect your device to a computer. TRBOnet Swift CPS automatically detects USB connections and displays the number of connected devices in the status bar. Note: If TRBOnet Swift CPS fails to detect the connected device automatically, the cause may be a hardware driver not found on your computer. For details, refer to the user manual provided for your device. 2. Select Read in the Device menu. 3. (Optional) If more than one connected device is detected, select the required device in the dialog box and click Ok. The opened configuration appears in a separate tab. Open a configuration file 1. Select Open file from the Device menu. 2. In the system window, navigate to the required folder and select the SWR configuration file. Confirm the choice. Note: As an option, use a sample configuration file for creating a new configuration. Find the samples for all types of supported devices in the <Swift CPS installation path>\samples folder. The opened configuration appears in the <file name> tab. 12 TRBOnet Swift CPS 1.4 User Guide

13 TRBOnet Swift CPS opens each configuration in a separate tab. If you open a configuration file, the tab displays the file name. If you read a device configuration, the tab displays the type of device and the interface. You can open multiple configurations and work with them in parallel. Figure 3: Working with multiple configurations Note: When you open a configuration file, the device information and the license information apply to the device whose configuration has been saved to the file. A configuration includes the definition of connection settings, Event Logic rules, report settings, and regions. Sections Connection Settings and Swift Event Logic of this document describe in detail how to define all these settings and objects in TRBOnet Swift CPS. When you finish, you can save your configuration to a selected file or write it to memory of a selected device. If you just close the configuration tab or the application, your changes are canceled without a prompt rather than saved automatically. TRBOnet Swift CPS 1.4 User Guide 13

14 Table 7: Saving a configuration To do this Write a configuration to a connected device Perform these steps 1. Select the tab with the required configuration in TRBOnet Swift CPS. 2. Select Write in the Device menu. 3. (Optional) If multiple connected devices are detected, select the device in the dialog box and click Ok. 4. (Optional) If you try to write your configuration to a different type of device, confirm the operation in the dialog box. Note: A configuration written to a different type of device includes all definitions from the Logic section of the navigation panel rules, regions, report settings, and general settings. Connection settings are not written to a different type of device. Save a configuration to a file 1. Select Save as in the Device menu. 2. In the system dialog box, navigate to a target folder. Select an existing SWR file to be updated, or specify the name of a new configuration file to be created. Confirm the operation. 14 TRBOnet Swift CPS 1.4 User Guide

15 5.2. Connection Settings This section describes how to configure connections between your device and external hardware. To configure connections, open a configuration in TRBOnet Swift CPS and select the required settings in the Device section of the navigation panel Configuring nrf Connection Note: This tab is only available if you configure TRBOnet Swift TR001. Configure wireless connection between a device and the TRBOnet Swift ST001 option board installed in the connected radio. Both parties have the Nordic RF transceiver on board. Table 8: nrf connection settings Parameter Data transfer rate Description The data transfer rate for wireless communication. Values: 1 Mbps, 2 Mbps. Default: 2 Mbps. Note: Configure TRBOnet Swift ST001 to use the same rate. Channel The channel for wireless communication with the radio. Range: 0 to 125. Note: Configure TRBOnet Swift ST001 to use the same channel. Power The power of the device. Values: 20, 60, 250, 1000 µw. Default: 1000 µw Receiver sensitivity The receiver sensitivity. Values: Low, High. Default: Low Configuring GPRS Connection Note: This tab is only available if you configure TRBOnet Swift TR001. Specify GPRS connection settings for data transfer on the standby GSM channel. TRBOnet Swift CPS 1.4 User Guide 15

16 Table 9: GPRS connection settings Parameter Radio ID Access Point Name Login Password TRBOnet Server IP Description The unique ID of the radio in the MOTOTRBO network. Specify the value configured in MOTOTRBO CPS. The GPRS gateway identity. Provided by the mobile operator. The login required to access the GPRS gateway. Provided by the mobile operator. The password required to access the GPRS gateway. Provided by the mobile operator. The IP address of TRBOnet Server that receives data over GPRS. Default: TRBOnet Server port The local port of TRBOnet Server. Default: Configuring GSM Connection Note: This tab is only available if you configure TRBOnet Swift TR001. Specify the mobile phone numbers for SMS and voice calls. Table 10: GSM connection settings Parameter Phone number for SMS Description The phone number for SMS communication between TRBOnet Dispatch Center and the radio. Phone number format: 11 to 18 digits preceded by +. Example: Phone number for voice calls The phone numbers for voice communication between TRBOnet Dispatch Center and the radio. Phone number format: 11 to 18 digits preceded by TRBOnet Swift CPS 1.4 User Guide

17 Configuring RS-232 Serial Port Specify the serial parameters of the RS-232 port located on a device. Note: Depending on the type of device, some of the RS-232 settings or the entire tab can be unavailable. Table 11: RS-232 serial port settings Parameter Baud rate Description The speed (bits per second) of the serial link. The default value depends on the type of device: DT500: 9600 bps TR001: bps Parity type The number and interpretation of parity bits. Values: EvenParity: One bit of even parity OddParity: One bit of odd parity SpaceParity: One bit, always set to 0 MarkParity: One bit, always set to 1 NoParity: No bit for parity Default: NoParity. Using no parity bit and eight data bits is recommended. If parity is used, even parity is recommended. Stop bits The duration of a stop bit. Values: 1 bit, 1.5 bit, 2 bit. Default: 1. One stop bit-time is recommended. Character length The number of data bits per character. Values: 5, 6, 7, 8. Default: 8. Eight data bits are recommended. Timeout, sec The timeout (in seconds) after a stop bit before sending the next package. The default value depends on the type of device: DT500: 96 TR001: 64 Time guard The guard time. Default: 0. Maximum PDU size, bytes The maximum size (bytes) of PDU. Default: TRBOnet Swift CPS 1.4 User Guide 17

18 5.3. Swift Event Logic This section describes how to define all settings and objects of the configurable device logic Selecting RS-232 Protocol To configure the RS-232 port for communication with a particular type of external hardware, open a configuration in TRBOnet Swift CPS and select General in the Logic section of the navigation panel. Select the type of hardware to be connected to the RS-232 port: None: RS-232 port is not connected. RFID: RS-232 is connected to RFID. Can-Log: RS-232 is connected to the CAN-LOG module through the external adapter. Raw Data: RS-232 is configured to communicate raw data with connected hardware. The type of hardware is not relevant Managing Report Settings If configured accordingly, a device can collect incoming information in memory, create data sequences (reports), and send them to TRBOnet Server on the radio channel. Reports typically include the current location of a connected radio and telemetry from input pins. Rules for creating and sending reports are defined in a report settings profile. You can define as many profiles as necessary. One profile must be indicated as default. The default report settings are loaded to device memory at startup. To configure report settings, open a configuration in TRBOnet Swift CPS and select General in the Logic section of the navigation panel. 18 TRBOnet Swift CPS 1.4 User Guide

19 Figure 4: Managing report settings The Report Settings area displays all report settings defined in the opened configuration. You can manage report settings profiles as described below. Table 12: Managing report settings To do this Create a new report settings profile Edit report settings Perform these steps 1. Click Add. 2. Specify the report settings in the Report Settings window as described in Configuring Report Settings. Click Apply. 1. Double-click a required report settings profile in the grid. 2. Edit the settings in the Report Settings window as described in Configuring Report Settings. 3. Click Apply. TRBOnet Swift CPS 1.4 User Guide 19

20 To do this Delete report settings Perform these steps You can delete any report settings profile, except the last remaining one. 1. Click the Delete icon against the report settings you want to delete. 2. Confirm the deletion in the prompt dialog box. Note: Make sure that the selected profile is not used in any rule. Deletion of such a profile may cause the configuration to work improperly. Select default report settings In the Default field, indicate the profile whose report settings shall be loaded to a device at startup Configuring Report Settings To configure report settings, specify the following parameters in the Report Settings window. Table 13: Report settings Parameter Profile name Description The descriptive name of the report settings. Radio Network Settings Specify the settings for sending all kinds of reports to TRBOnet Server. These settings are mandatory even if the profile is not configured to send any reports. MOTOTRBO network CAI +1 The MOTOTRBO network identity (CAI) incremented by 1. Increment is required to send data to TRBOnet Server. Example: If MOTOTRBO CPS defines the network CAI as 12, enter 13. TRBOnet Server ID TRBOnet Server port The unique ID of TRBOnet Server in the MOTOTRBO network. The local port of TRBOnet Server. 20 TRBOnet Swift CPS 1.4 User Guide

21 Parameter Description GNSS Data Storage Specify GNSS data to be stored in memory of a device. Save coordinates every meters Save speed and direction The distance (in meters) in which the device stores coordinates of the connected radio. The flag that enables the device to store speed and direction of the radio in addition to its coordinates. GNSS Report Creation Specify criteria for adding GNSS data to a report. Send a report with GNSS data The radio channel for sending reports to TRBOnet Server. Options: On the selected channel: The radio sends reports on the currently selected channel. On the data channel: The radio sends reports on the data channel. Do not send: Creating and sending GNSS reports is disabled. Add GNSS data every meters Add data at minimum direction change, Add GNSS data every seconds The covered distance (in meters) in which GNSS data is added to the report. The minimum direction change (in degrees) at which GNSS data is added to the report. The time interval (in seconds) in which GNSS data is added to the report. Report Sending Specify the rules for sending reports to TRBOnet Server. Send report every meters Send report every seconds The covered distance (in meters) in which the radio sends a report. The time interval (in seconds) in which the radio sends a report. TRBOnet Swift CPS 1.4 User Guide 21

22 Parameter Number of retries Retry interval, sec Description The number of retries for sending a report on the radio channel. The time interval (in seconds) between retries Managing Rules A rule describes a specific event to which a programmed device will respond with a predefined sequence of actions, such as playing back tone or displaying text on the radio display, sending text to other radios, changing the radio channel, sending alarms, and other. To define rules, open a configuration in TRBOnet Swift CPS and select Rules in the Logic section of the navigation panel. Figure 5: Rules The Rules tab displays all rules defined in the opened configuration. You can manage rules as described below. 22 TRBOnet Swift CPS 1.4 User Guide

23 Table 14: Managing rules To do this Create a new rule Create a copy of an existing rule Perform these steps 1. Click Add. 2. In Rule Editor, define a new rule as described in Building a Rule. Clone an existing rule and quickly modify the required settings only. 1. Select a rule in the grid and click Copy. A copy of the selected rule appears in the grid. 2. Double-click the copied rule in the grid. 3. In Rule Editor, modify the rule settings as described in Building a Rule. Edit a rule Delete a rule Enable a rule 1. Double-click a required rule in the grid. 2. In Rule Editor, modify the rule settings as described in Building a Rule. 1. Click the Delete icon against the rule that you want to delete. 2. Confirm the deletion in the prompt dialog box. By default, all rules appear in the grid with the Enabled flag not set. A disabled rule is not processed at runtime. To enable a rule, click the Enabled checkbox Building a Rule The Rule Editor window serves for building and editing Event Logic rules. TRBOnet Swift CPS 1.4 User Guide 23

24 Figure 6: Rule Editor To define a rule: 1. In the Name field, enter the descriptive name of the rule. 2. In the Event panel, select the type of event and specify the event settings as described in Using Events. For quick help, read the information at the bottom of the Event panel. 3. (Optional) In the Conditions panel, add as many conditions as required. Configure each condition as described in Using Conditions. 4. In the Actions panel, add as many actions as needed to handle the event. Configure each action as described in Using Actions. 5. Click Ok to save the rule Using Events In the Event panel of the Rule Editor window, select the type of event and specify the event settings. Figure 7: Adding an event to a rule 24 TRBOnet Swift CPS 1.4 User Guide

25 The following table summarizes the information about all supported events and their configurable parameters. Table 15: Supported events Event Region Border Crossed Description The event occurs after the radio has crossed the border of a designated region and the pause has elapsed. The list of parameters includes: Name: The name of the event. Region: One, several, or all regions whose borders are monitored. Expand the menu and click the checkbox to select the region. Condition: The direction in which the radio crosses the border of any selected region. Values: Entering, Leaving. Pause, sec: The timeout (in seconds) after crossing the border. For the triggered event, the rule executes all actions in the predefined sequence. After that, the event is finished. Speed Limit The event occurs after the measured speed rises above/falls below the specified value. The list of parameters includes: Name: The name of the event. Speed: The operator for speed comparison. Values: greater than, less than. Threshold value, km/h: The maximum or minimum allowed speed (in kilometers per hour). Note: The percent error of speed measurement may be as high as 5 to 10%, depending on the type of a two-way radio (less for mobile, higher for portable) and on the satellite signal reception quality. For the triggered event, the rule executes all actions in the predefined sequence. After that, the event is finished. Man Down The event occurs after the radio tilt has exceeded the threshold angle and the pause has elapsed. TRBOnet Swift CPS 1.4 User Guide 25

26 Event Description The list of parameters includes: Name: The name of the event. Threshold angle, : The minimum vertical angle (in degrees) at which the radio is still considered up. Pause, sec: The timeout (in seconds) after detecting the radio tilt. For the triggered event, the rule executes actions in the predefined sequence. The Man Down state is re-checked after every action. If not confirmed, the event is finished and the remaining actions are ignored. If confirmed, the next action is executed. After the last action, the event is finished. Crash Detect The event occurs if the normal speed mode has not been restored during the control time after a sudden acceleration boost (possibly indicating a car crash). The list of parameters includes: Name: The name of the event. Acceleration threshold: The maximum acceleration that shall be exceeded to suspect a car crash. Wait time, sec: The timeout (in seconds) that starts after the suspected car crash and during which no acceleration measurements are taken. Minimum expected acceleration: The minimum acceleration that must be gained during the control time to confirm the normal speed mode. Control time, sec: The timeout (in seconds) that starts after the wait time. For the triggered event, the rule executes actions in the predefined sequence. The Crash Detected state is re-checked after every action. If not confirmed, the event is finished and the remaining actions are ignored. If confirmed, the next action is executed. After the last action, the event is finished. 26 TRBOnet Swift CPS 1.4 User Guide

27 Event No Movement Description The event occurs after the radio acceleration has fallen below the threshold and the wait time has elapsed. The list of parameters includes: Name: The name of the event. Acceleration threshold: The minimum acceleration at which the radio is still considered to be at normal speed. Wait time, sec: The timeout (in seconds) that starts after the radio acceleration has fallen below the threshold. For the triggered event, the rule executes actions in the predefined sequence. The No Movement state is re-checked after every action. If not confirmed, the event is finished and the remaining actions are ignored. If confirmed, the next action is executed. After the last action, the event is finished. Lone Worker The event occurs if the radio buttons and knobs have not been used for the wait time. The list of parameters includes: Name: The name of the event. Wait time, sec: The timer (in seconds) that re-starts after any action detected on the radio, such as a button push, a talk, or use of the channel selector. For the triggered event, the rule executes actions in the predefined sequence. If the user interrupts the execution of an action by touching any radio control, the event is finished and the timer is reset. If the last action is executed, the event is finished but the timer is not reset, which makes it impossible to trigger the Lone Worker event again. Telemetry The event occurs when the change of state on any I/O pin has been detected. The list of parameters includes: Name: The name of the event. TRBOnet Swift CPS 1.4 User Guide 27

28 Event Description Send report immediately: The flag that forces sending a report to TRBOnet Server at the occurrence of the event. For the triggered event, the rule executes all actions in the predefined sequence. After that, the event is finished. Note: If you choose to send a report immediately, the default report settings are used. The Set Report Settings action is executed after sending the report Using Conditions In the Conditions panel of the Rule Editor window, add one or more conditions for the triggered event to be handled. Note: Adding conditions to a rule is optional. If you add several conditions, notice that all of them must be TRUE for the actions to execute. To add a condition: 1. In the Conditions panel, click Add Condition and select the type of condition in the menu. 2. Specify the condition settings in the popup window and click Ok. Figure 8: Adding conditions to a rule 28 TRBOnet Swift CPS 1.4 User Guide

29 A new condition with the specified name appears in the Conditions panel. To open condition settings for editing, double-click a required condition in the panel. To delete a condition, click the Delete ( red cross ) icon. Note: New conditions are added to the last position in the list. The ordinal number of a condition cannot be changed and does not affect the logic. The following table summarizes the information about conditions and their configurable parameters. Table 16: Conditions Condition Presence in Region Description The condition is TRUE if the radio is located inside any selected region or outside all selected regions at the moment of the event occurrence. The list of parameters includes: Name: The name of the condition. Region: The region(s) in which the presence of the radio is checked. To add a region, select the checkbox in the menu. Radio is currently: in the region: The radio is inside any selected region. out of the region: The radio is outside all selected regions Using Actions In the Actions panel of the Rule Editor window, add one or more actions to execute when the event is triggered and all available conditions are TRUE. To add an action: 1. In the Actions panel, click Add Action and select the type of action in the menu. 2. Specify the action settings in the popup window and click Ok. TRBOnet Swift CPS 1.4 User Guide 29

30 Figure 9: Adding actions to a rule A new action with the specified name appears at the last position in the Actions panel. Use arrows to adjust the execution order of actions. To delete an action, click the Delete ( red cross ) icon. To open action settings for editing, double-click a required action in the panel. Note: The Activate Alarm on Radio action has no settings and cannot be opened for editing. The following table summarizes the information about actions and their configurable parameters. Table 17: Actions Action Set Report Settings Description This action forces a device to use the specified report settings profile until the end of the event. Note: A report settings profile defines the rules for sending regular reports to TRBOnet Server. Learn more in Managing Report Settings. Enter the following settings in the Action window: 30 TRBOnet Swift CPS 1.4 User Guide

31 Action Description Name: The descriptive name of the action that appears in the Actions panel. Report settings: The report settings profile to be used. Send Text This action forces the connected radio to send text to a specified radio or a talk group. Enter the following settings in the Action window: Name: The descriptive name of the action. Send text to: The recipient of the message. Values: radio, radio group. Radio/group ID: The ID of the recipient. Text: The message to be sent. Activate Alarm on Radio Send Alarm to TRBOnet This action activates the alarm mode on the connected radio. The radio responds as specified in its emergency configuration settings. This action forces the connected radio to send a particular alarm to TRBOnet Server. Enter the following settings in the Action window: Name: The descriptive name of the action. TRBOnet alarm: The TRBOnet alarm to be sent. Options: CrashDetected, LoneWorker, ManDown, NoMovement. Set Radio Channel This action forces the connected radio to select a different radio channel. Enter the following settings in the Action window: Name: The descriptive name of the action. Channel: The radio channel to be set. Zone: The zone to be set (if the option is selected). Playback Tone on Radio This action forces the connected radio to play back the specified tone. Enter the following settings in the Action window: Name: The descriptive name of the action. Tone: The tone to be played back. TRBOnet Swift CPS 1.4 User Guide 31

32 Action Description Volume Boost: The volume boost (in MOTOROLA units of measure). Wait time, sec: The duration of the tone (in seconds). Display Text on Radio This action forces the connected radio to display text. Enter the following settings in the Action window: Name: The descriptive name of the action. Display text from: The display line from which the text starts. Options: Line 1, Line 2, Line 3, Line 4. Display time, sec: The time (in seconds) during which the text is displayed. Text: The text to display. Pause This action sets the timeout before proceeding to the next action in the Actions panel. Enter the following settings in the Action window: Name: The descriptive name of the action. Wait time, sec: The duration of the pause (in seconds) Managing Regions Event Logic rules can include predefined regions as input parameters. A region is an area selected on the online map and given a unique name. To define regions, open a configuration in TRBOnet Swift CPS and select Regions in the Logic section of the navigation panel. 32 TRBOnet Swift CPS 1.4 User Guide

33 Figure 10: Regions Regions defined in the opened configuration appear as colored areas on the map. The region names are displayed in the right panel under the edit box. The following useful features will help you work with the map: Table 18: Using the map features To do this Pan the map Use automatic pan Adjust the scaling Perform these steps Keep the mouse button pressed and move the mouse cursor over the map to the required direction. Click the region name in the list. The map pans automatically to show the selected region. Scroll the mouse wheel to zoom the map. TRBOnet Swift CPS 1.4 User Guide 33

34 To do this Show and hide the control panel Perform these steps Click the arrow button at the left border of the panel: Figure 11: Hiding and showing the control panel Select the folder for cache In the offline mode, the map is loaded from cache. The folder for cache is selected by the software and unknown to the user. To use a particular folder for cache, click the Select folder for cache button and specify the folder path. You can manage regions in the Regions tab as described below. Table 19: Managing regions To do this Select a region Perform these steps Click inside the region on the map, or select the region in the list. The map pans and zooms automatically to display the selected region. The region name is highlighted in the list. Note: You cannot select a hidden region. Select a region for editing Double-click inside the region on the map or select the region in the list. In the edit mode, the region border displays all existing nodes. 34 TRBOnet Swift CPS 1.4 User Guide

35 To do this Perform these steps Figure 12: A region selected for editing Select an overlapping region Click the area that belongs to multiple regions. The map displays tabs with the region names. Hover over the tab to see the respective region in a colored frame: Figure 13: Selecting an overlapping region Click the tab to select the region for editing. Right-click inside the region on the map to exit the edit mode and keep the region selected. Show or hide a region on the map Select the region and click the Show or hide Region button in the toolbar. The hidden region is marked with the eye icon in the list: Figure 14: A hidden region marked with the eye icon To make the region visible on the map, click the button again. TRBOnet Swift CPS 1.4 User Guide 35

36 To do this Add a region Perform these steps 1. Click the Add Region button. 2. Click on the map where the region border shall start. Draw the shape of the region, clicking where you want to break the line. 3. Right-click to exit the edit mode. When you exit the edit mode, the first node is connected to the last one with a line. The selected area is filled with color. The default region name appears at the last position in the list. 4. Enter a unique descriptive region name in the edit box. Edit the borders of a region Rename a region Delete a region 1. Select the region for editing. 2. Click an existing node, or double-click the border where you want to add a new node. 3. Drag the selected node to the preferred position. 4. To delete a node, click to select it and then rightclick. The node disappears from the map. A line connects two neighbor nodes. 5. To exit the edit mode, right-click or click outside the region. Select the region and enter the preferred name in the edit box. Select the region and click the Delete Region button. The deleted region disappears from the map and from the list. Note: The deleted region cannot be restored with the Undo command. 36 TRBOnet Swift CPS 1.4 User Guide