19.3. Sending Alarm through a call to APOTS

19.3. Sending Alarm through a call to APOTS
	Chapter 19. APOTS

Suppose you have an IOBOX connected to the Abilis and you want to receive a call with a announcement when the gate will open. A digital sensor from the gate is connected at the Abilis in the Digital Input Line number 2. The alarm must be sent if the Digital Input 2 becomes ON. A loudspeaker is connected to the APOTS (DEVICE:CITO) to play the voice message.

The first step to follow is to prepare the sound file to be played by DISA. More information are in the section Section 62.8, “Message files”.

19.3.1. Configuring the CTIDISA resource

	Note
	The CTIDISA requires a separate licence in CPX

Add the CTIDISA resource:

[09:08:14] ABILIS_CPX:a res:ctidisa

RES:CTIDISA ALREADY EXISTS

The CTIDISA resource may already exist in the system, but may not yet be active: set it active with the command:

[09:10:00] ABILIS_CPX:s act res:ctidisa

COMMAND EXECUTED

	Caution
	After adding or setting the CTIDISA active, you must restart the Abilis to make the resource running (use the command warm start to reboot the Abilis).

[11:01:39] ABILIS_CPX:s p ctidisa act:yes

COMMAND EXECUTED

[11:01:39] ABILIS_CPX:d p ctidisa

RES:CtiDisa - Not Saved (SAVE CONF), Not Refreshed (INIT) ---------------------
       ------------------------------------------------------------------------
Run    DESCR:Direct_Inward_System_Access
       LOG:NO          ACT:YES        sesnum:10       RESTRICTED-CALLING:YES
       PROVIDE-SG:NO   CALL-ABORT:**  CALL-REPEAT:**  PIN-START:*  PIN-END:#
       NPOO-CT:SYS     CTIP-TYPE:NET-PRIVATE          BUSY-NOCHAN:YES
       WDIR:C:\APP\DISA\

	Caution
	To activate the changes made on the upper case parameters, execute the initialization command init res:ctidisa; while to set act the changes made on the lowercase parameters a save conf and an Abilis restart are required (i.e. With warm start command).

Configuring the CTIDISA Service:

[11:27:01] ABILIS_CPX:a ctidisa service:alarm     

COMMAND EXECUTED 

[11:27:44] ABILIS_CPX:s ctidisa service:alarm cb:yes initdial:alarmmsg

COMMAND EXECUTED 

[11:28:33] ABILIS_CPX:d ctidisa service:alarm

- Not Saved (SAVE CONF) -------------------------------------------------------
Total number of services:2

-------------------------------------------------------------------------------
SERVICE:alarm             DESCR:
  MODE:        DISA                   |INTRO-STATE:   CREQ  |INTRO:    
  ROUTING:     PREFIX                 |CONN-DELAY:    6     |WELCOME:  
  MAX-CALLS:   NOMAX                  |PC-OFFER:      *     |INITDIAL: alarmmsg
  BC:          Speech                 |TRANSFER:      NO    |AFTERPIN: #
  CB:          YES                    |                     |LOOPDIAL: 
  CB-DELAY:    5                      |DIAL-TOUT:     30    |IDENFAIL: 
  CB-NRTY:     1                      |PIN-TOUT:      15    |CALLNA:   
  CB-UNK-CDO:  'CGI'                  |NUM-TOUT:      15    |ALERT:    
  CB-NAT-CDO:  0'CGI'                 |BUSYDISC:      4     |BUSY:     
  CB-INT-CDO:  00'CGI'                |LOOP-BUSY:     YES   |NOANSWER: 
  CB-CGO:      #                      |LOOP-NOANSWER: YES   |DISC:     
  CTIP-TYPE-O: *                      |LOOP-DENIED:   YES   |HOLD:     
  AUTO-CDO:    #                      |LOOP-OTHER:    YES   |BYE:      #
  TOUT-CDO:    #                      |MAX-LOOPS:     0     
  END-CDO:     #                      
  PERMIT:      *                      
  CDI:         DISABLED               
  CGI:         #
  SUB-SERVICE: #
-------------------------------------------------------------------------------

Configuring the CTIDISA user:

[11:29:05] ABILIS_CPX:a ctidisa user:alarm

COMMAND EXECUTED 

[11:31:01] ABILIS_CPX:s ctidisa user:alarm cb:yes pin:4321

COMMAND EXECUTED

[11:32:11] ABILIS_CPX:d ctidisa user:alarm

- Not Saved (SAVE CONF) -------------------------------------------------------
Total number of users:2

-------------------------------------------------------------------------------
USER:alarm
  PIN:     4321             |MAX-CALLS: 1     |PERMIT: SERVICE
  SERVICE: AUTO             |CB:        YES   |DENY:   #
  CGI:   #
-------------------------------------------------------------------------------

	Tip
	The “(SAVE CONF)” message is displayed every time the configuration is modified but not saved with the save conf command.

19.3.1.1. Uploading the audio file

The message file must be recorded on a PC and saved in WAV format. The message file must be renamed to initdial.wav.

Add the specified message set directory, in our case "alarmmsg".

[12:12:56] ABILIS_CPX:msg add disa alarmmsg

MESSAGE SET 'C:\APP\DISA\MSG\alarmmsg' ADDED.

Audio file must be loaded, using either FTP, WEB interface or FILE PUT commands.

	Note
	To load the audio files through WEB interface, please refert to: Section 72.12.7, “Managing messages sets”.

Example with FILE PUT command:

[12:24:59] ABILIS_CPX:file put z C:\APP\DISA\MSG\alarmmsg\initdial.wav

READY TO RECEIVE FILE...

Starting zmodem transfer.  Press Ctrl+C to cancel.
Transferring initdial.wav...
Transferring initdial.wav, errors 0...
  100%     187 KB     187 KB/sec    00:00:01       1 Errors  


FILE TRANSFER ENDED, PRESS <ENTER> TO CONTINUE...

FILE TRANSFER SUCCESSFULLY COMPLETED

RECEIVED FILE 'C:\APP\DISA\MSG\alarmmsg\initdial.wav' FORMAT IS UNKNOWN.
NO CHECK DONE.

Once WAV files are loaded, they must be converted in the CPM (CPX Packed Messages) format (i.e. The format that allows Abilis to play the messages with any coder supported).

[12:31:08] ABILIS_CPX:msg rebuild disa alarmmsg

YOU ASKED TO REBUILD DISA alarmmsg 
PROCEED (N/Y)?y

MSG REBUILD IN PROGRESS ON DISA alarmmsg 
THIS MAY TAKE SOME TIME (Type CTRL+C + ENTER to stop)...

Converting C:\APP\DISA\MSG\alarmmsg\initdial.wav
Converting to G711A/64k   .......... END
Converting to G729A/8k    .......... END
Converting to Spirit/6.4k .......... END

COMMAND COMPLETED

19.3.2. Configuring the ALARM resource

Add the ALARM resource:

[17:32:07] ABILIS_CPX:a res:alarm

COMMAND EXECUTED

The ALARM resource may already exist in the system, but may not yet be active; set it active with the following command.

[17:34:00] ABILIS_CPX:s act res:alarm

COMMAND EXECUTED

	Caution
	You must save the configuration and restart the Abilis to make the resource running (use the command warm start to reboot the Abilis) after adding or setting the ALARM active.

[17:35:45] ABILIS_CPX:s p alarm act:yes

COMMAND EXECUTED

[17:35:51] ABILIS_CPX:d p alarm

RES:Alarm - Not Saved (SAVE CONF), Not Refreshed (INIT) -----------------------
Run    DESCR:Alarms_manager
       LOG:NO        ACT:YES            fifo-size:100    
       MAIL-FROM:AUTO (alarm@abilis_cpx)
       MAIL-TO:
       MAIL-TO-LIST:SYS (#)
       MAIL-BODY:STANDARD
       -- SMS -----------------------------------------------------------------
       SMS-SENDER:CP-PI                  SMS-CDO:#
       -- Disa Voice Call -----------------------------------------------------
       DISA-USER:#                       DISA-SERVICE:#
       DISA-CDO:#                        DISA-CGO:#

	Caution
	Execute the initialization command init alarm to activate the changes made on the upper case parameters; use save conf and warm start commands to set active the changes made on the lowercase parameters.

Add a alarm what will make a call (CTIDISA Call Back) when the Digital Input 2 becomes ON (Command for the RIO resource):

[11:45:21] ABILIS_CPX:a alarm id:0 enabled:yes res:rio-1 io:d-in-2 trigger:on action:disa-cb

COMMAND EXECUTED 

[11:45:23] ABILIS_CPX:s alarm id:0 disa-user:alarm disa-service:alarm disa-cdo:98 disa-cgo:777

COMMAND EXECUTED 

[11:45:42] ABILIS_CPX:d alarm

- Not Saved (SAVE CONF), Not Refreshed (INIT) ---------------------------------
-------------------------------------------------------------------------------
ID: |[DESCR:]
    |ENABLED:|RES:              |IO:         |TRIGGER: |ACTION:
     - Mail -------------------------------------------------------------------
    |MAIL-TO:
    |MAIL-TO-LIST:
    |MAIL-BODY:
     - SMS --------------------------------------------------------------------
    |SMS-CDO:
     - Disa Voice Call --------------------------------------------------------
    |DISA-USER:                 |DISA-SERVICE:
    |DISA-CDO:                  |DISA-CGO:
-------------------------------------------------------------------------------
0    YES      Rio-1              DI-2         ON        DISA-CB
     - Disa Voice Call --------------------------------------------------------
     alarm                       alarm
     98                          777
-------------------------------------------------------------------------------

	Caution
	To activate the changes, execute the initialization command init alarm and save conf.

19.3.3. CTI routing configuration

Add a CTI rule to route a call from DISA to a APOTS:

[11:51:48] ABILIS_CPX:a ctir pr:0 poi:disa out:491 cdi:98 sp:64000

COMMAND EXECUTED 

[12:03:17] ABILIS_CPX:d ctir pr:0

- Not Saved (SAVE CONF), Not Refreshed (INIT) ---------------------------------
Last change: 17/08/2022 12:03:17

---+------+-----------------+---------+--------------------+--------------------
PR |[DESCR]
   |BCI   |POI |SR      |GI |OUT      |CDI                 |CDO
ACT|NEXT        |LAST       |EEC |T301|CGI                 |CGO
EDT|SP    |SC   |DJ   |MJ   |FMDJ|FMMJ|SDI                 |SDO
   |SPOUT |SCOUT|DJOUT|MJOUT|LCS |LCST|SGI                 |SGO
   |                        |BCO      |RGI                 |RGO
   |FMRLY |FAXSP|MODSP|FMLVL|ECM |UDT |IG  |OG  |SG        |DL  |DH
   |CODERS
   |CODERSOUT
   |TI1 .. TI5
--------------------------------------------------------------------------------
0   VOICE  Disa #        #   491       98                   *                   
    NO           ANY         NO   Dft  *                    *                   
    64000  Sys   Sys   Sys   Sys  Sys  *                    *                   
--------------------------------------------------------------------------------

	Warning
	Changes made on the CTI routing table aren't immediately active. To activate them, execute the initialization command init ctir.

	Tip
	The “(SAVE CONF)” message is displayed every time the configuration is modified but not saved with the save conf command.


19.2. APOTS as a public address		Chapter 20. IOBOX