Actions

Difference between revisions of "Multicast Paging (SIP)"

From Zenitel Wiki

(Stream from FFMPEG)
 
(8 intermediate revisions by 2 users not shown)
Line 8: Line 8:
 
To configure a station to receive Multicast Paging, [[Logging into an IP Station|log into the IP Station]] and select '''SIP Configuration''' > '''Multicast Paging''':
 
To configure a station to receive Multicast Paging, [[Logging into an IP Station|log into the IP Station]] and select '''SIP Configuration''' > '''Multicast Paging''':
  
[[File:SIP Multicast.PNG|thumb|left|500px|Configuration page for Multicast Paging]]
+
<table style="max-width:80%; border-style: double; border-color: #c7c7c7;">
<br style="clear:both;" />
+
<tr style="rowspan:2;">
 +
<td style="display: block; vertical-align: bottom;">[[Image:SIP Multicast.PNG|500px]]</td>
 +
</tr>
 +
<tr>
 +
<td style='background-color:#efefef;'>Configuration page for Multicast Paging</td>
 +
</tr>
 +
</table>
  
 
* '''Enable Multicast paging''': When enabled, the station is capable of playing audio received as Multicast
 
* '''Enable Multicast paging''': When enabled, the station is capable of playing audio received as Multicast
Line 18: Line 24:
 
* '''Label''': Any descriptive text
 
* '''Label''': Any descriptive text
 
* '''Listening Address''': The multicast IP address that the station shall listen to, e.g. 239.195.124.240. Multicast IP addresses are in the range from 224.0.0.0 to 239.255.255.255.
 
* '''Listening Address''': The multicast IP address that the station shall listen to, e.g. 239.195.124.240. Multicast IP addresses are in the range from 224.0.0.0 to 239.255.255.255.
* '''Port''': The port number must be within the port range 61020-61250, recommended range is 61080-61250. Using odd number for port is not recommended.  
+
* '''Port''': The ports must be within the VoIP port firewall range, recommended range is 61080-61250 to avoid conflict with normal audio operation. Using odd numbers is not recommended for ports as that is normally used for RTCP. Listening address and port must be defined, and the port must be unique in the list.
 
* '''Codec''': Select between codecs G.711a, G.711u, G.722 and G.729
 
* '''Codec''': Select between codecs G.711a, G.711u, G.722 and G.729
 
* '''Priority''': Select which priority mechanism should apply to this multicast VoIP stream. Options are LOW, NORMAL, HIGH (default), and EMERGENCY. See more details below.
 
* '''Priority''': Select which priority mechanism should apply to this multicast VoIP stream. Options are LOW, NORMAL, HIGH (default), and EMERGENCY. See more details below.
Line 34: Line 40:
 
** During emergency page the station will queue all incoming calls. When emergency page ends, the station will accept calls again.  
 
** During emergency page the station will queue all incoming calls. When emergency page ends, the station will accept calls again.  
 
** If a station sends a busy override to a station listening on emergency page, then emergency page will stop
 
** If a station sends a busy override to a station listening on emergency page, then emergency page will stop
* If a station is in a regular point-to-point call when receiving a page of defined priority:
+
 
 +
* If a station is in a regular point-to-point call when receiving a multicast paging of defined priority:
 
** '''LOW / NORMAL''' priority: The paging audio is not played
 
** '''LOW / NORMAL''' priority: The paging audio is not played
 
** '''HIGH''' priority: The paging audio is mixed with the normal call
 
** '''HIGH''' priority: The paging audio is mixed with the normal call
Line 42: Line 49:
 
=== Stream from FFMPEG ===
 
=== Stream from FFMPEG ===
 
Stream radio source in g722:
 
Stream radio source in g722:
ffmpeg -re -i "http://lyd.nrk.no/nrk_radio_p13_mp3_h" -filter_complex aresample=16000,asetnsamples=n=160 -ac 1 -acodec adpcm_g722 -f rtp rtp://239.1.20.5:61111
+
{{Code|<nowiki> ffmpeg -re -i "http://lyd.nrk.no/nrk_radio_p13_mp3_h" -filter_complex aresample=16000,asetnsamples=n=160 -ac 1 -acodec adpcm_g722 -f rtp rtp://239.1.20.5:61111</nowiki>}}
<br>
+
 
 
    
 
    
 
Stream radio source in g711u/pcmu:
 
Stream radio source in g711u/pcmu:
ffmpeg -re -i "http://lyd.nrk.no/nrk_radio_p13_mp3_h" -filter_complex aresample=8000,asetnsamples=n=160 -ac 1 -acodec pcm_mulaw -f rtp rtp://239.1.20.4:61110
+
{{Code|<nowiki>ffmpeg -re -i "http://lyd.nrk.no/nrk_radio_p13_mp3_h" -filter_complex aresample=8000,asetnsamples=n=160 -ac 1 -acodec pcm_mulaw -f rtp rtp://239.1.20.4:61110</nowiki>}}
<br><br>
 
  
 
=== Stream from VLC===
 
=== Stream from VLC===
Line 56: Line 62:
 
=== Listen to Edge Group Call===
 
=== Listen to Edge Group Call===
 
Go to [[Group_Call_(Edge)#Configuration_of_group_calls|Edge Controller -> Group Calls]] and use the multicast address/port written in each group call. Note that the clients making the group call must use same codec as chosen for multicast paging.
 
Go to [[Group_Call_(Edge)#Configuration_of_group_calls|Edge Controller -> Group Calls]] and use the multicast address/port written in each group call. Note that the clients making the group call must use same codec as chosen for multicast paging.
 +
 +
<br>
  
 
=== Listen to Pulse Group Call===
 
=== Listen to Pulse Group Call===
Line 64: Line 72:
 
=== Use Multicast Paging with Asterisk===
 
=== Use Multicast Paging with Asterisk===
 
Call 8998 to speak on multicast address:
 
Call 8998 to speak on multicast address:
exten => 8998,1,Dial(MulticastRTP/basic/239.1.2.4:61101//c/g722))
+
{{Code|<nowiki>exten => 8998,1,Dial(MulticastRTP/basic/239.1.2.4:61101//c/g722))</nowiki>}}
<br><br>
 
  
 
=== Use Multicast Paging with Freeswitch iPBX===  
 
=== Use Multicast Paging with Freeswitch iPBX===  
  
<extension name="rtp_multicast_page">
+
{{Code|<nowiki><extension name="rtp_multicast_page">
 
   <condition field="destination_number" expression="^pagegroup$|^7243$">
 
   <condition field="destination_number" expression="^pagegroup$|^7243$">
     <action application="answer"/>
+
     &#60;action application="answer"/&#62;
     <action application="esf_page_group" data="239.1.20.5 61082"/>
+
     &#60;action application="esf_page_group" data="239.1.20.5 61082"/&#62;
     <action application="esf_multicast_write_codec" data="G722"/>
+
     &#60;action application="esf_multicast_write_codec" data="G722"/&#62;
 
   </condition>
 
   </condition>
  </extension>
+
  </extension></nowiki>}}
  
 
[[Category: SIP intercom - Configuration]]
 
[[Category: SIP intercom - Configuration]]
 +
[[Category: Audio Settings and Audio Features]]

Latest revision as of 15:49, 25 October 2023

SIP Icon 300px.png

Multicast Paging enables IP intercom stations in SIP mode to receive VoIP audio as multicast paging from 3rd party iPBX (e.g. Asterisk). The feature is supported by both INCA stations and Turbine stations. Up to 10 different Multicast paging groups can be defined.

Note icon
  • Multicast Paging is supported in SIP mode only
  • Required software: Turbine 4.9 or newer. INCA 2.8 or newer


Configuration

To configure a station to receive Multicast Paging, log into the IP Station and select SIP Configuration > Multicast Paging:

SIP Multicast.PNG
Configuration page for Multicast Paging
  • Enable Multicast paging: When enabled, the station is capable of playing audio received as Multicast
  • Enable Order Priority:
    • Enabled: If the station is exposed to two (or more) multicast VoIP streams at the same time, and the VoIP streams have the same "Priority", the VoIP stream with the lowest "Order" priority number will be played.
    • Disabled: The "Order" will be ignored. If the station is exposed to two (or more) multicast VoIP streams at the same time, and the VoIP streams have the same priority, the first received VoIP stream will be played. Subsequent VoIP streams will not be played.
  • Label: Any descriptive text
  • Listening Address: The multicast IP address that the station shall listen to, e.g. 239.195.124.240. Multicast IP addresses are in the range from 224.0.0.0 to 239.255.255.255.
  • Port: The ports must be within the VoIP port firewall range, recommended range is 61080-61250 to avoid conflict with normal audio operation. Using odd numbers is not recommended for ports as that is normally used for RTCP. Listening address and port must be defined, and the port must be unique in the list.
  • Codec: Select between codecs G.711a, G.711u, G.722 and G.729
  • Priority: Select which priority mechanism should apply to this multicast VoIP stream. Options are LOW, NORMAL, HIGH (default), and EMERGENCY. See more details below.
  • Order: If the station is exposed to two (or more) multicast VoIP streams at the same time, and the VoIP streams have the same "Priority", the VoIP stream with the lowest "Order" priority number will be played. Requires that the "Enable Order Priority" option is enabled.
Note icon Order number 1 has the highest priority, 10 has the lowest priority.


Paging priority

Multicast paging uses 4 different priorities: LOW, NORMAL, HIGH, and EMERGENCY.

The priority mechanism has the following properties:

  • A multicast page will terminate any ongoing page with lower priority. If two paging calls have same priority, then the one with lowest order number gets priority.
  • EMERGENCY priority includes a Volume and handset override feature:
    • The volume is turned to maximum level on all receiving stations, and the audio is played on the loudspeaker, even if the handset is off-hook.
    • During emergency page the station will queue all incoming calls. When emergency page ends, the station will accept calls again.
    • If a station sends a busy override to a station listening on emergency page, then emergency page will stop
  • If a station is in a regular point-to-point call when receiving a multicast paging of defined priority:
    • LOW / NORMAL priority: The paging audio is not played
    • HIGH priority: The paging audio is mixed with the normal call
    • EMERGENCY priority: The regular call is muted

Configuration of Multicast streaming sources

Stream from FFMPEG

Stream radio source in g722:

ffmpeg -re -i "http://lyd.nrk.no/nrk_radio_p13_mp3_h" -filter_complex aresample=16000,asetnsamples=n=160 -ac 1 -acodec adpcm_g722 -f rtp rtp://239.1.20.5:61111



Stream radio source in g711u/pcmu:

ffmpeg -re -i "http://lyd.nrk.no/nrk_radio_p13_mp3_h" -filter_complex aresample=8000,asetnsamples=n=160 -ac 1 -acodec pcm_mulaw -f rtp rtp://239.1.20.4:61110


Stream from VLC

To stream from VLC does not work due to variable payload size, same problem as on SNOM (Not possible to fix this). http://wiki.snom.com/Category:HowTo:Multicast_Audio#Multicast_via_VLC


Listen to Edge Group Call

Go to Edge Controller -> Group Calls and use the multicast address/port written in each group call. Note that the clients making the group call must use same codec as chosen for multicast paging.


Listen to Pulse Group Call

Go to Pulse Server -> Group Call and use the multicast address/port written in each group call. Note that the clients making the group call must use same codec as chosen for multicast paging.


Use Multicast Paging with Asterisk

Call 8998 to speak on multicast address:

exten => 8998,1,Dial(MulticastRTP/basic/239.1.2.4:61101//c/g722))


Use Multicast Paging with Freeswitch iPBX

<extension name="rtp_multicast_page"> <condition field="destination_number" expression="^pagegroup$|^7243$"> <action application="answer"/> <action application="esf_page_group" data="239.1.20.5 61082"/> <action application="esf_multicast_write_codec" data="G722"/> </condition> </extension>