Actions

Difference between revisions of "Dynamic group call"

From Zenitel Wiki

(Event Handler configuration)
 
(74 intermediate revisions by 4 users not shown)
Line 1: Line 1:
==Operation (CRM IV and CRM V)==
+
{{AI}}
*Press a dedicated "Group Config." [[DAK]] key. The red led in key starts flashing
+
==Operation ==
*Select subscribers to be included/excluded (toggle function) by pressing the assosiated [[DAK]] keys. A flashing green led in the keys indicates that the stations are included
+
For best performance it is recommended to use [[CRM_V_-_Control_Room_Master|CRM V station]] or [[ECPIR-3P|ECPIR-3P panel]], as these devices have buttons with LEDs showing status.
*Press the "Group Config." button again, the [[Groups#Group_Call.2FAnnouncements|group call]] is now activated. The red led in the [[DAK]] key stops flashing. Now the group call is activated (the ding-dong chime is played) and pressing the `M`-key opens the microphone.
 
*The green leds continue to flash during the [[Groups#Group_Call.2FAnnouncements|group call]]
 
*Cancel the [[Groups#Group_Call.2FAnnouncements|group call]] by pressing the `C`-key. All members will be removed from the group, and the green leds stop flashing.
 
  
It is not neccessary to use [[Control Room Master IV|CRM-IV]] or [[IP Flush Master - 1008031000|CRM V]] stations, but with regular stations you will not get LED feedback on [[Groups#Group_Call.2FAnnouncements|group call]] inclusion/exclusion.
+
*Press a dedicated "Group Configuration" [[DAK]] key. The red led in key starts flashing, and the Dynamic Group is emptied.
 +
*Select stations or local groups to be included by pressing the associated [[DAK]] keys. A steady green led in the keys indicates that the stations/groups are included
 +
*Press the "Group Configuration" button again, and the group call is activated (the ding-dong chime is played). Pressing the `M`-key opens the microphone.
 +
*The green leds continue to be lit during the [[Groups#Group_Call.2FAnnouncements|group call]]
 +
*Cancel the [[Groups#Group_Call.2FAnnouncements|group call]] by pressing the `C`-key. The green LEDs are turned off.
  
LIMITATION: You can only include subscribers, you cannot include groups!
+
{{note|One can only include, not remove, stations/groups into the dynamic group. If a wrong selection is made, press the C-key, and start the selection over again.}}
  
==Programming==
+
== Software requirements==
*Software requirement: AMC 8.26 or later
+
* ICX: Any version
 +
* AlphaCom: 13.0.3.0 or later
  
*In [[AlphaPro]], [[Directory_%26_Features_%28AlphaPro%29|Directory & Features]], create a directory number, feature 95/0. Directory number [[Event Trigger w/User Parameter|9535]] is included by default. Program the "Group Config." DAK button to 9535.
+
==Configuration==
 +
*Assign directory number 9535 to DAK 1 of the operator station. This is the '''Group Configuration''' button. Directory number [[Event Trigger w/User Parameter|9535]] is included in a default database.
  
*Each CRM station must be assigned its own [[Groups#Group_Call.2FAnnouncements|group call]] that nobody else uses. The directory number of the [[Groups#Group_Call.2FAnnouncements|group call]] must be changed so that the two last digits are identical to the group index number. Example:
+
[[File:DynGrp DAK.PNG|thumb|left|500px|"Group Configuration" button]]
**Group '''2''' = 85'''02'''
+
<br style="clear:both;" />
**Group '''3''' = 85'''03'''
+
 
**Group '''4''' = 85'''04'''
+
*Each operator station is assigned its own Dynamic Group Call by entering the directory number of the Dynamic Group Call in the User Defined Parameter (%1.EXP) field of the operator.
**Group '''10''' = 85'''10'''
+
*Include operator stations in [[UDP]] group 1. Name the [[UDP]] group e.g. "Operators".
So if you have 3 CRM stations, you need to program 3 [[Groups#Group_Call.2FAnnouncements|group calls]] (e.g. 8502, 8503 and 8504).
+
 
 +
[[File:DynGrp UDP.PNG|thumb|left|500px|Include the operator station in UDP Group 1, and enter the directory number of the Dynamic Group used by this operator (Here: 899)]]
 +
<br style="clear:both;" />
  
*Enter the [[Groups#Group_Call.2FAnnouncements|group call]] directory number in the User Defined Parameter (%1.EXP) field of each [[Control Room Master IV|CRM-IV]]. In AlphaPro, [[Users_%26_Stations_%28AlphaPro%29#UDP|Users & Stations -> UDP -> User Defined Parameter (%1.EXP)]]. For the above example, CRM station 1 will have (%1.EXP)=8502, CRM station 2 will have (%1.EXP)=8503 and CRM station 3 will have (%1.EXP)=8504.
 
*Put all CRM’s that should have [[Dynamic group call]] feature in [[UDP]] group 1. Name this [[UDP]] group : "The CRM stations".
 
  
 
===Event Handler configuration===
 
===Event Handler configuration===
  
In [[AlphaPro]], go to [[Exchange_%26_System_%28AlphaPro%29#Events|Exchange and System -> Events]], press Insert and create the following events:
+
In [[AlphaPro]], go to [[Exchange_%26_System_%28AlphaPro%29#Events|Exchange and System -> Events]], press '''Insert''' and create the following events (Simply '''copy/paste''' the action strings below into AlphaPro):
------------
+
 
'''Event 1'''
+
'''Event 1: Start/stop Group Configuration'''
 +
*When the "Group Configuration" button is pressed, empty the Dynamic Group and turn on red LED in the button.
 +
*When leaving the Group Configuration mode, start a 1 sec timer. If the Dynamic Group is not activated within this time, the LEDs will be cleared.
 +
 
 +
[[File:DynGrp Event1.PNG|thumb|left|500px|Start/stop Group Configuration]]
 +
<br style="clear:both;" />
 +
 
 +
{{Code2|
 +
IF %chg(1,0)
 +
$GRM LV L%1.exp U3
 +
IND %1.phy %1.dak(I%2.dir) 1 3 ON
 +
stop
 +
ENDIF
 +
$ST L%1.dir W10 L%1.exp
 +
}}
  
-> This event will be triggered when the "Group Config." button is pressed for the first time.
+
'''Event 2: Include members'''
{|
+
*When DAK keys are pressed during Group Configuration mode, turn on the green LED, and include the station or local group to the dynamic group
|-
+
*If the DAK key pressed is the "Group Configuration" button (9535), disconnect the station from configuration mode, turn off the red LED, and dispatch the dynamic group call
|width="100pt"|'''Event Owner''':
 
|width="400pt"|Stations w/ UDP Id: 1 (The CRM stations)
 
|-
 
|'''Event type''': || [[Event Trigger (Event Type)|15 – Event Trigger]]
 
|-
 
|'''Subevent''': || 0
 
|-
 
|'''When change to''': || ON or OFF
 
|-
 
|'''When related to''': || Directory Number, Id: 9535
 
|-
 
|'''Action''': || [[IND]] %1.phy [[%1.dak]](I%2.dir) 1 3  || Turn ON + flash the red LED of the Group Config. button
 
|-
 
|}
 
  
------------
+
[[File:DynGrp Event2.PNG|thumb|left|500px|Include members]]
'''Event 2'''
+
<br style="clear:both;" />
  
-> This event will be triggered each time a match is found in the directory table (after the "Group Config." button has been pressed for the first time.)
+
{{Code2|
 +
IND %1.phy %1.dak(I%2.dir) 2 1 ON
 +
$GRM L%2.dir L%1.exp U1
 +
IF %op(%2.dir,<nowiki>=</nowiki>,9535)
 +
$DISCON_ST L%1.dir 0
 +
IND %1.phy %1.dak(I%2.dir) 1 3 OFF
 +
PAUSE
 +
PAUSE
 +
PAUSE
 +
$DD L%1.dir L%1.exp
 +
}}
  
-> E.g. pressing a DAK-key with a directorynumber stored in it, will call this event (%2 will contain the directory number of the DAK key).
+
'''Event 3: Reset LEDs when Dynamic Group Call ends'''
 +
*When the operator calls the dynamic group, stop the timer that resets all LEDs
 +
*When the call to the dynamic group call ends, reset all LEDs
  
-> This event keeps being triggered until disconnected.
+
[[File:DynGrp Event3.PNG|thumb|left|500px|Reset LEDs]]
{|
+
<br style="clear:both;" />
|-
 
|width="100pt"|'''Event Owner''':
 
|width="400pt"|Stations w/ UDP, Id: 1 (The CRM stations)
 
|-
 
|'''Event type''': || [[Event Trigger with parameter (Event Type)|25 – Event trigger with parameter]]
 
|-
 
|'''Subevent''': || 0
 
|-
 
|'''When change to''': || ON or OFF
 
|-
 
|'''When related to''': || All
 
|-
 
|'''Action''': || [[IF/ENDIF|IF]] [[%sgm]](%2.phy,%1.exp(2))|| If station is already member of this group, execute next lines.
 
|-
 
|| || || sgm = Station Group Member, %2.phy = station phys addr., %1.exp(2) = last 2 digits of UDP %1.exp value.
 
|-
 
| &nbsp; || [[IND]] %1.phy [[%1.dak]](I%2.dir) 2 3 OFF || Station was member and will be removed from group, so switch OFF green flashing LED.
 
|-
 
| &nbsp; || [[IF/ENDIF|ENDIF]]
 
|-
 
| &nbsp; || [[IF/ENDIF|IF]] [[%op]]([[%sgm]](%2.phy,%1.exp(2)),=,0)|| If station is not yet a member of this group, execute next lines.
 
|-
 
|| || || sgm = Station Group Member, %2.phy = station phys addr., %1.exp(2) = last 2 digits of UDP %1.exp value.
 
|-
 
| &nbsp; || [[IND]] %1.phy [[%1.dak]](I%2.dir) 2 3 ON || Station was not a member and will be added to the group, so switch ON green flashing LED.
 
  
|-
+
{{Code2|
| &nbsp; || [[IF/ENDIF|ENDIF]]
+
IF %op(%2.dir,<nowiki>=</nowiki>,%1.exp)
|-
+
IF %chg(1,0)
| &nbsp; || [[GROUP MEMBERSHIP|$GRM]] L%2.dir NG%1.exp(2) U2 || Group Membership Toggle (this will add/remove the station to the group)
+
$ST L%1.dir W0 L%1.exp
|-
+
stop
| &nbsp; || [[IF/ENDIF|IF]] [[%op]](%2.dir,=,9535)|| If the Group Config button is pressed, execute next lines (this is the 2nd time that the Group Config. button is pressed, so stop with the station selection phase and start the Group Call phase)
+
ENDIF
|-
+
IND %1.phy 0 0 0 OFF
| &nbsp; || [[DISCON ST|$DISCON_ST]] L%1.dir 0
+
ENDIF
|-
+
}}
| &nbsp; || [[IND]] %1.phy [[%1.dak]](I%2.dir) 2 3 OFF
 
|-
 
| &nbsp; || [[PAUSE]]
 
|-
 
| &nbsp; || [[PAUSE]]
 
|-
 
| &nbsp; || [[PAUSE]]
 
|-
 
| &nbsp; || [[DIAL DIGITS|$DD]] L%1.dir L%1.exp
 
|-
 
| &nbsp; || [[IF/ENDIF|ENDIF]]
 
|-
 
|}
 
  
------------
 
'''Event 3'''
 
{|
 
|-
 
|width="100pt"|'''Event Owner''':
 
|width="400pt"|Stations w/ UDP, Id: 1 (The CRM stations)
 
|-
 
|'''Event type''': || [[Conversation Outgoing (Event Type)|08 – Conversation - Outgoing]]
 
|-
 
|'''Subevent''': || 0
 
|-
 
|'''When change to''': || OFF
 
|-
 
|'''When related to''': || All
 
|-
 
|'''Action''': || [[IF/ENDIF|IF]] [[%op]](%2.dir,=,%1.exp)
 
|-
 
| &nbsp; || [[IF/ENDIF|IF]] [[%gns]](%1.exp(2),0)
 
|-
 
| &nbsp; || [[EVENT_REPORT|$ER]] U15 U1 U1 U1 N[[%gns]](%1.exp(2),0) U3 %1.ref
 
|-
 
| &nbsp; || [[IF/ENDIF|ENDIF]]
 
|-
 
| &nbsp; || [[IF/ENDIF|ENDIF]]
 
|-
 
|}
 
  
------------
+
'''Event 4: Reset LEDs on timeout'''
'''Event 4'''
+
*If the operator exit the "Group Configuration" mode without starting the dynamic group call within set time, resets all LEDs
{|
 
|-
 
|width="100pt"|'''Event Owner''':
 
|width="400pt"|Stations w/ UDP, Id: 8 (All stations)
 
|-
 
|'''Event type''': || [[Event Trigger (Event Type)|15 – Event Trigger]]
 
|-
 
|'''Subevent''': || 1  ''(NOTE: Subtype 1, NOT 0)''
 
|-
 
|'''When change to''': || ON
 
|-
 
|'''When related to''': || All
 
|-
 
|'''Action''': || [[GROUP MEMBERSHIP|$GRM]] N[[%gns]](%2.exp(2),0) NG %2.exp(2) U0
 
|-
 
| &nbsp; || [[IND]] %2.phy %2.dak(I%1.dir) 2 3 OFF
 
|-
 
| &nbsp; || PAUSE
 
|-
 
| &nbsp; || [[IF/ENDIF|IF]] [[%gns]](%2.exp(2),0)
 
|-
 
| &nbsp; || [[EVENT_REPORT|$ER]] U15 U1 U1 U1 N[[%gns]](%2.exp(2),0) U3 %2.ref
 
|-
 
| &nbsp; || [[IF/ENDIF|ENDIF]]
 
|-
 
|}
 
  
------------
+
[[File:DynGrp Event4.PNG|thumb|left|500px|"Group Configuration" button]]
 +
<br style="clear:both;" />
  
 +
{{Code2|
 +
IF %op(%2.dir,<nowiki>=</nowiki>,%1.exp)
 +
IND %1.phy 0 0 0 OFF
 +
ENDIF
 +
}}
  
[[Category:Applications]]
+
[[Category:AlphaCom Applications]]
[[Category: Control Room Stations - CRM]]
+
[[Category:ICX-AlphaCom Applications]]
 +
[[Category: Control Room Applications]]
 +
[[Category:Applications using Event Handler]]

Latest revision as of 11:13, 8 July 2022

AI.png

Operation

For best performance it is recommended to use CRM V station or ECPIR-3P panel, as these devices have buttons with LEDs showing status.

  • Press a dedicated "Group Configuration" DAK key. The red led in key starts flashing, and the Dynamic Group is emptied.
  • Select stations or local groups to be included by pressing the associated DAK keys. A steady green led in the keys indicates that the stations/groups are included
  • Press the "Group Configuration" button again, and the group call is activated (the ding-dong chime is played). Pressing the `M`-key opens the microphone.
  • The green leds continue to be lit during the group call
  • Cancel the group call by pressing the `C`-key. The green LEDs are turned off.
Note icon One can only include, not remove, stations/groups into the dynamic group. If a wrong selection is made, press the C-key, and start the selection over again.


Software requirements

  • ICX: Any version
  • AlphaCom: 13.0.3.0 or later

Configuration

  • Assign directory number 9535 to DAK 1 of the operator station. This is the Group Configuration button. Directory number 9535 is included in a default database.
"Group Configuration" button


  • Each operator station is assigned its own Dynamic Group Call by entering the directory number of the Dynamic Group Call in the User Defined Parameter (%1.EXP) field of the operator.
  • Include operator stations in UDP group 1. Name the UDP group e.g. "Operators".
Include the operator station in UDP Group 1, and enter the directory number of the Dynamic Group used by this operator (Here: 899)



Event Handler configuration

In AlphaPro, go to Exchange and System -> Events, press Insert and create the following events (Simply copy/paste the action strings below into AlphaPro):

Event 1: Start/stop Group Configuration

  • When the "Group Configuration" button is pressed, empty the Dynamic Group and turn on red LED in the button.
  • When leaving the Group Configuration mode, start a 1 sec timer. If the Dynamic Group is not activated within this time, the LEDs will be cleared.
Start/stop Group Configuration


Action commands:

IF %chg(1,0)
$GRM LV L%1.exp U3
IND %1.phy %1.dak(I%2.dir) 1 3 ON
stop
ENDIF
$ST L%1.dir W10 L%1.exp


Event 2: Include members

  • When DAK keys are pressed during Group Configuration mode, turn on the green LED, and include the station or local group to the dynamic group
  • If the DAK key pressed is the "Group Configuration" button (9535), disconnect the station from configuration mode, turn off the red LED, and dispatch the dynamic group call
Include members


Action commands:

IND %1.phy %1.dak(I%2.dir) 2 1 ON 
$GRM L%2.dir L%1.exp U1
IF %op(%2.dir,=,9535)
$DISCON_ST L%1.dir 0
IND %1.phy %1.dak(I%2.dir) 1 3 OFF
PAUSE
PAUSE
PAUSE
$DD L%1.dir L%1.exp


Event 3: Reset LEDs when Dynamic Group Call ends

  • When the operator calls the dynamic group, stop the timer that resets all LEDs
  • When the call to the dynamic group call ends, reset all LEDs
Reset LEDs


Action commands:

IF %op(%2.dir,=,%1.exp)
IF %chg(1,0)
$ST L%1.dir W0 L%1.exp
stop
ENDIF
IND %1.phy 0 0 0 OFF
ENDIF



Event 4: Reset LEDs on timeout

  • If the operator exit the "Group Configuration" mode without starting the dynamic group call within set time, resets all LEDs
"Group Configuration" button


Action commands:

IF %op(%2.dir,=,%1.exp)
IND %1.phy 0 0 0 OFF
ENDIF