The
supports playing announcements, tones, and collecting digits.
Tone and Announcement Profile
Tones and announcements are configured by allocating a percentage of DSP cores to tones/announcements. If no transcoding is used, you may allocate up to 100% toward tones/announcements.
Announcements are customized by provisioning announcement packages using Media Profile on the
. An announcement package supports provisioning of up to 16 announcement names to segment ID mapping. For more information on configuring Media Profiles, see
Media Profile - CLI or
Profile Management - Media Profiles.
When using an external PSX, the PSX returns the tones/announcement profile and announcement or tone to be played in policy/trigger response. The
plays out the specified announcement/tone using the specified profile.
Announcement files are stored in the directory: /var/log/sonus/evlog/announcements
For more information on configuring tones and announcements, see following:
| Note |
|---|
When the SBC is configured to use an external PSX, there may be instances when hunt groups, or Automatic Call Distribution (ACD) groups, do not always operate as expected when the Tone and Announcement profile is used. A call can remain on-hold even after answering the call. PSX 09.02.01R000 and later can be configured using the parameters End To End Ack and No CDR Change In End To End Ack to resolve this. End To End Ack must be enabled before enabling No CDR Change In End To End Ack flag. See PSX Manager User Guide for configuration details. |
Tone Profile
The
supports a default tone package with a package ID of “1”. The default package contains the following default tone profile definitions.
- defBusy
- defCallWaiting1
- defCallWaiting2
- defCallWaiting3
- defCallWaiting4
- defCpeAlerting
- defDial
- defReorder
- defRing
- defSit1
- defSit2
- defSit3
- fccBusy
- fccDial
- fccRingback
Tones are customized by provisioning tone packages and tone profiles. The tone profile feature supports tone generation methods as described in Table 1.
For details to configure tone profiles, see below:
| Caption |
|---|
| 0 | Table |
|---|
| 1 | Tone Profile Generation Methods |
|---|
|
Tone Type | Tones | Frequency | Power | Details |
|---|
Single Tone | 1 | 0-3999 Hertz | (-50 to +3) dBm | | Dual Tone | 1, 2 | 0-3999 Hertz | (-50 to +3) dBm | | Composite Tone | 1, 2, 3, 4 | | N/A | N/A | - Cadences to which each tone is applied
- Decay time constant in milliseconds
- Decay frequency delta in Hz/second
- Decay tone bit map of tones against which decay/frequency rate change are applied
| Modulated Tone | N/A | - Carrier Frequency
- Signal Frequency
- Carrier Power
- Signal Modulation Index
| N/A | |
|
Local Ring Back Tones (LRBT)
The
is configurable to support
Local Ring Back Tones LRBT as described below
.:The
generates LRBT in the following conditions:
- Start LRBT upon receipt of 180 without SDP, the .
- Halt LRBT upon receipt of any18x with SDP or any final response.
- Stop LRBT without waiting for media packet arrival.
The
supports the following dynamic LRBT functionality related to RFC 3960:
- Do not generate local ringing unless a 180 (ringing) response is received.
- Generate local ringing if a 180 (ringing) is received but no incoming packets are present.
- If a 180 (ringing) is received and incoming packets are present, play incoming packets but do not generate local ringing.
When configured to operate with an external PSX, local ring back tones are provisioned on the PSX on a per-trunk group basis. The PSX returns this information in a policy response.
Playing Tones as Announcements
The SBC Core supports playing announcements that are stored in G.711ULaw format. The SBC Core is enhanced to support playing compressed tones directly without allocating DSP resources by playing the tones from the pre-encoded files with various combinations of tones and codec types. The tone files are created for the required tone types with different codec combinations and stored as .wav files in the SBC. All these tones are stored with a ptime of 20 milliseconds.
The SBC Core is enhanced in this release with a new media profile, tonesAsAnnouncement, which includes the following parameters to configure the announcement file to play LRBT for each codec entry:
toneTypecodecTypesegmentId
The existing Tone Profile references the toneType in the tonesAsAnnouncement profile, whereas the new object toneCodecEntry references the codecType. With this enhancement, the user can associate default Tone Profile or can create a customized Tone Profile and assign it to the toneType of the toneAsAnnouncementProfile. The flag announcementBasedTones is included in toneAndAnnouncementProfile configuration to play LRBT without using DSP resources.
The SBC supports playing tones for three groups of codecs. If the required tone playback falls under one of the following codecs and the flag annoucementBasedTones is enabled, the SBC must avoid allocating DSP resources and play a tone as an announcement. If the required tone playback does not fall under one of the following codecs and the flag annoucementBasedTones is enabled, the SBC does not fall back to the DSP mode and continues the call without playing the tones.
- G.711 (G.711ALaw and G.711ULaw)
- EVRC (EVRC, EVRC0, EVRCB, and EVRCB0)
- AMR-WB-BWE (9 variants)
| Note |
|---|
The SBC supports playing default ringtones with 15 different types of codec variants. |
The compressed tone files are stored in the standard .wav file format. The SBC uses the same naming convention for the compressed tone files as the announcement files. For example, in a sDDDDD.wav file, where DDDDD is a decimal number from 1 to 65,535, the decimal number represents the segment ID of the file.
The announcement and the tone files share the 5-bit segment ID space, and thus, every file name must have a unique segment ID. The compressed tone files are stored in the same directory path as the announcement files (/var/log/sonus/sbx/announcements). The tone file is played continuously until the tone is stopped due to a trigger.
The following table provides the .wav file mapping information for the application announcements:
| Caption |
|---|
| 0 | Table |
|---|
| 1 | Application Announcements |
|---|
| 3 | Application Announcements |
|---|
|
| File Name | Announcement ID | RBT | Audio Message |
|---|
s20001.wav | 20001 | RBT_MULAW | US Ring Back Tone | | s20002.wav | 20002 | RBT_ALAW | US Ring Back Tone | | s20003.wav | 20003 | RBT_EVRC (interleaved mode) | US Ring Back Tone | | s20004.wav | 20004 | RBT_EVRCB (interleaved mode) | US Ring Back Tone | | s20005.wav | 20005 | RBT_AMRWBBE_6_6K | US Ring Back Tone | | s20006.wav | 20006 | RBT_AMRWBBE_8_85K | US Ring Back Tone | | s20007.wav | 20007 | RBT_AMRWBBE_12_65K | US Ring Back Tone | | s20008.wav | 20008 | RBT_AMRWBBE_14_25K | US Ring Back Tone | | s20009.wav | 20009 | RBT_AMRWBBE_15_85K | US Ring Back Tone | | s20010.wav | 20010 | RBT_AMRWBBE_18_25K | US Ring Back Tone | | s20011.wav | 20011 | RBT_AMRWBBE_19_85K | US Ring Back Tone | | s20012.wav | 20012 | RBT_AMRWBBE_23_05K | US Ring Back Tone | | s20013.wav | 20013 | RBT_AMRWBBE_23_85K | US Ring Back Tone | | s20014.wav | 20014 | RBT_EVRC0 (Header free packet mode) | US Ring Back Tone | | s20015.wav | 20015 | RBT_EVRCB0 (Header free packet mode) | US Ring Back Tone |
|
| Note |
|---|
The .wav files for tones other than g711 a and u law are in Sonus proprietary format. |
LMSD - Tone Play Support
The SBC supports playing tones when an Alert-Info header is received in the Legacy Mobile Station Domain (LMSD) format (Alert-Info: <http:/LMSD/tone?sig-id=rt>). The SBC is enhanced to play the LRBT without using DSP resources whenever it receives 180 with Session Description Protocol (SDP) answer with Alert-Info header (Alert-Info: <http:/LMSD/tone?sig-id=rt>). The Alert-Info header, present in the 180 ringing with SDP, carries the tone package information required by the SBC to play LRBT. To support this feature, the existing LRBT framework is enhanced.
The SBC supports generating LRBT when:
- The flag
acceptAlertInfo is enabled on the egress TG. - The provisional response is 180 ringing with SDP and the tone flavor is normal.
- The P-Com.DropEarlyMedia header is not present in the original INVITE.
- The SDP answer is received in 180 or in a previous provisional response (183).
- The 180 contains an Alert-Info header having sig-id = “rt” only (bt/ct does not play tone).
- The flag
announcementBasedTone in the toneAndAnnouncementProfile associated with the ingress TG is enabled.
| Note |
|---|
|
The SBC supports fallback to LMSD inter-working state, if the flag acceptAlertInfo is enabled and the playing tone is failed. If the flag acceptAlertInfo is not enabled, the SBC continues to process the call without playing a tone.
|
LMSD - Playing Tones Using Lock Down Preferred Codec
The SBC plays tones using the “lock down" preferred codec when the following flags are enabled:
sendOnlyPreferredCodec (IPSP)
honorRemotePrecedence (PSP)announcementBasedTones
The codec that is used for playing tone towards the ingress leg is based on whether the session is established as pass-through or transcoded. If the SBC receives SDP answer from the egress peer, the selected codec is the egress peer's preferred codec. However, the ingress peer's preferred codec is used to play the tone, if the session outcome is transcoding.
| Note |
|---|
The SBC plays tones when it receives 180 responses with SDP for the egress peer preferred codec. When the 180 response is received without SDP from the egress peer, the SBC plays LRBT based on the existing LRBT implementation using the ingress peer preferred codec.
|
LMSD - Handling UPDATEs for the Tones
The SBC is enhanced to stop playing LRBT upon receipt of any of the following messages:
- UPDATE message with different SDP
- subsequent 183 with different SDP
- 200 OK with or without SDP
For more information on Tone and Announcement feature, refer to: