Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry AtHoc
  3. BlackBerry AtHoc Integrations
  4. American Signal Giant Voice System Installation and Configuration Guide
  5. Configure IIM IP connectivity
  6. Configure the SirenCommandMap.txt file

Configure the SirenCommandMap.txt file

The American Signal Giant Voice - V2 IIM has a feature that allows macro sets of Keys to be created, either to fill a new request or use existing macros as a template. This command map enables the creation of more complex siren content with multiple recordings or interrupted tones with pauses in between each step. These macros can then be added to the Giant Voice Key User ATHOC-GV-KEYS attribute configuration list, starting with hexadecimal #31.
Templates for existing macro functions in the American Signal CompuLert™ software configuration file (.cfg) are found in the 
C:/WINAPPS/ASC2/data
 folder. Any existing macros with polling functions cannot be replicated as the polling and re-polling steps are not activated by the IIM. To operate this correctly, the 
C:/Program Files/capnode/SirenCommandMap.txt
 file must be populated with a list of siren addresses.
Edit the file with Notepad so that there is one macro per line as shown:
31=^^^,01:FF:FF:FF:FF 33000 ^^^,17:FF:FF:FF:FF 3000 
^^^,07:FF:FF:FF:FF 13000 3C=T04,08:FF:FF:FF:FF 18000
T04,17:FF:FF:FF:FF 3000 T04,09:FF:FF:FF:FF 13000 T04,1F:FF:FF:FF:FF 10
In the example above, macro #31 initiates an Attack tone, delays for approximately 33 seconds, sends a cancel tone, delays for approximately 3 seconds, sends a Chime tone and then delays for approximately 13 seconds.
Once the macro list has been made, save the file and restart the CapCon service to apply the changes.
To add the macros to the ATHOC-GV-KEYS configuration, append a key section as follows:
<key
id = "31|FF|FF|FF|FF"
messageIdRef = "MSG-TARGETING-REQUIRED"
targetingRule = "TargetingRequired">
<name>Attack and Chime Tone Test</name>
<description>Attack and Chime Tone Test</description>
</key>
The string 
“^^^”
 indicates that the user-selected target address(es) should be used. Alternately, a fixed 3-character address can be used to target a fixed address.
If a fixed address is used, the 
messageIdRef
 and 
targetingRule
 parameters should be changed to “MSG-TARGET-NOT-ALLOWED” and “TargetingNotAllowed” in the key section.
Example:
<key id = "3C|FF|FF|FF|FF" messageIdRef = "MSG-TARGETING-NOT-ALLOWED"
targetingRule = "TargetingNotAllowed"><name>Scream Chime Wail Test to Pole T04 Only</name><description>Scream Chime Wail Test to Pole T04 Only</description>
</key>