Page History

Multiexcerpt include

MultiExcerptName	Codec Entry Warning
PageWithExcerpt	Media Profiles - Codec Entry

Add_workflow_for_techpubs

AUTH1	UserResourceIdentifier{userKey=8a00a0c85fd202bb0160132c449a0026, userName='null'}
REV5	UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cd5909df, userName='null'}
REV6	UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cd5909df, userName='null'}
REV3	UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cc2a0770, userName='null'}
REV4	UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cbee06ac, userName='null'}
REV1	UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26ca3103e5, userName='null'}

Panel

In this section:

Table of Contents

maxLevel	3

Audio codecs are associated with a Packet Service Profile. Some codecs are used in pass-through or direct media mode only (that is, special DSP treatments and transcoding are not applicable to the calls using these audio codecs).

All audio codecs used by video calls are also used only in pass-through or direct media mode. Audio codec relay is supported in SIP-SIP, H.323-H.323 as well as SIP-H.323 interworking calls.

For a list of supported audio codecs, see

Link_in_new_tab

Text	Audio Codecs
URL	Audio Codecs

page.

Command Syntax

The syntax is categorized into different groups according to applicable codecs.

Group 1 Syntax

Code Block

language	none

% set profiles media codecEntry <name> codec <codec type> 
    activeCodecSet <AMR-value-kbps>
	dtmf 
        relay <relay_type> 
        removeDigits <disable | enable> 
    fax 
        failureHandling <continue | disconnect>
        toneTreatment <treatment_type> 
    fecRedundancy <0 | 1 | 2>
	initialCodecMode <disable | enable>
	modeChangeNeighbor <disable | enable>
    modem 
        failureHandling <continue | disconnect> 
        toneTreatment <treatment_type> 
    packetSize <packetSize> 
    preferredRtpPayloadType <0-128>
    silentSuppression <disable | enable>

Expand

title	Click here to view codecs applicable to above syntax...

The above syntax applies to following codecs:

amrBandwidthEfficient
amrCrc
amrCrcInterleaving
amrCrcRobustSorting
amrInterleaving
amrInterleavingRobustSorting
amrIuUp
amrOctetAligned
amrRobustSorting

Noprint
Back To Top

Group 2 Syntax

Code Block

language	none

% set profiles media codecEntry <name> codec <codec type> 
	dtmf 
		relay <relay_type> 
		removeDigits <disable | enable> 
	fax 
		failureHandling <continue | disconnect>
		toneTreatment <treatment_type>
	initialCodecMode <disable | enable>
	modeChangeNeighbor <disable | enable>
	modeSet <AMR-modeSet#>
	modem 
		failureHandling <continue | disconnect> 
		toneTreatment <treatment_type> 
	packetSize <packetSize> 
	preferredRtpPayloadType <0-128>
	silentSuppression <disable | enable>

Expand

title	Click here to view codecs applicable to above syntax...

The above syntax applies to following codecs:

amrwbBandwidthEfficient
amrwbCrc
amrwbCrcInterleaving
amrwbCrcInterleavingRobustSorting
amrwbCrcRobustSorting
amrwbInterleaving
amrwbInterleavingRobustSorting
amrwbOctetAligned

Noprint
Back To Top

Group 3 Syntax

Code Block

language	none

% set profiles media codecEntry <name> codec <codec type> 
    dtmf 
        relay <relay_type> 
        removeDigits <disable | enable> 
    fax 
        failureHandling <continue | disconnect>
        toneTreatment <treatment_type> 
    modem 
        failureHandling <continue | disconnect> 
        toneTreatment <treatment_type> 
    packetSize <packetSize> 
    preferredRtpPayloadType <0-128>

Expand

title	Click here to view codecs applicable to above syntax...

The above syntax applies to following codecs:

bv16
bv32
bv32Fec
evrcb1Fr
g7221-32
g728
g7291
g729a
g729ab
gsm
isac
l16-16
msrta8
msrta16
speex8
speex8Fec
speex16
speex16Fec
speex32

Noprint
Back To Top

Group 4 Syntax

Code Block

language	none

% set profiles media codecEntry <name> codec <codec type> 
    dtmf 
        relay <relay_type> 
        removeDigits <disable | enable> 
    fax 
        failureHandling <continue | disconnect>
        toneTreatment <treatment_type> 
    modem 
        failureHandling <continue | disconnect> 
        toneTreatment <treatment_type> 
    packetSize <packetSize> 
    preferredRtpPayloadType <0-128>
	silenceSuppression <disable | enable>

Expand

title	Click here to view codecs applicable to above syntax...

The above syntax applies to following codecs:

efr
evrc
evrc0
evrc1
evrc1Fr
evrcb1

Noprint
Back To Top

Group 5 Syntax

Code Block

language	none

% set profiles media codecEntry <name> codec g711         
    dtmf 
		relay <relay_type> 
		removeDigits <disable | enable> 
	fax 
		failureHandling <continue | disconnect> 
		honorToneDetection <disable | enable>
        toneTreatment <treatment_type> 
	law <ALaw | ULaw | deriveFromOtherLeg> 
	modem 
		failureHandling <continue | disconnect> 
		honorToneDetection <disable | enable>
        toneTreatment <treatment_type> 
	packetSize <packetSize>

The above syntax applies to following codec:

g711

Noprint
Back To Top

Group 6 Syntax

Code Block

language	none

% set profiles media codecEntry <name> codec g711ss 
    dtmf 
        relay <relay_type> 
        removeDigits <disable | enable> 
    fax 
        failureHandling <continue | disconnect> 
        toneTreatment <treatment_type> 
    law <ALaw | ULaw | deriveFromOtherLeg> 
    modem 
        failureHandling <continue | disconnect> 
        toneTreatment <treatment_type> 
    packetSize <packetSize> 
	sendSid <disable | enable>

The above syntax applies to following codec:

g711ss

Noprint
Back To Top

Group 7 Syntax

Code Block

language	none

% set profiles media codecEntry <name> codec <codec type> 
	codingRate <codingRate> 
	dtmf 
		relay <relay_type> 
		removeDigits <disable | enable> 
	fax 
		failureHandling <continue | disconnect> 
		toneTreatment <treatment_type> 
	modem 
		failureHandling <continue | disconnect> 
		toneTreatment <treatment_type> 
	packetSize <packetSize> 
	preferredRtpPayloadType <0-128>

Expand

title	Click here to view codecs applicable to above syntax...

The above syntax applies to following codecs:

evrcb
evrcb0
g722
g7221
g7221ss
g726
g726ss
g7231
g7231a
ilbc
ilbcss

Noprint
Back To Top

Group 8 Syntax

Code Block

language	none

% set profiles media codecEntry <name> codec g728ss 
    dtmf 
        relay <relay_type> 
        removeDigits <disable | enable> 
    fax 
        failureHandling <continue | disconnect> 
        toneTreatment <treatment_type> 
    modem 
        failureHandling <continue | disconnect> 
        toneTreatment <treatment_type> 
    preferredRtpPayloadType <0-128>

The above syntax applies to following codec:

g728ss

Noprint
Back To Top

Group 9 Syntax

Code Block

language	none

% set profiles media codecEntry <name> codec opus 
    dtmf 
        relay <relay_type> 
        removeDigits <disable | enable> 
    fax 
        failureHandling <continue | disconnect> 
        toneTreatment <treatment_type> 
    maxAverageBitRate (6000-510000 bits/sec)
    modem 
        failureHandling <continue | disconnect> 
        toneTreatment <treatment_type> 
    packetSize <packetSize> 
    preferredRtpPayloadType <0-128>
    useCbr (0 | 1)
    useDtx (0 | 1)
    useFec (0 | 1)

The above syntax applies to following codec:

opus

Noprint
Back To Top

Group 10 Syntax

Code Block

% set profiles media codecEntry <name> codec evs
    dtmf
        relay <relay_type>
        removeDigits <disable | enable>
    maxBitRate <5.9 | 7.2 | 8 | 9.6 | 13.2 | 16.4 | 24.4 | 32 | 48 | 64 | 96 | 128>  
    minBitRate <5.9 | 7.2 | 8 | 9.6 | 13.2 | 16.4 | 24.4 | 32 | 48 | 64 | 96 | 128>
    packetSize <20 | 40 | 60 | 80 | 100>
    preferredRtpPayloadType <0-127>

The above syntax applies to the following codec:

EVS

Noprint
Back To Top

Group 11 Syntax

Code Block

% set profiles media codecEntry <name> codec <silk8|silk12|silk16|silk24>
    dtmf
        relay <relay_type>
        removeDigits <disable | enable>
    fax
        failureHandling <continue | disconnect>
        toneTreatment <treatment_type>
    maxAverageBitRate <silk8:6000-20000|silk12:7000-25000|silk16:8000-36000|silk24:12000-40000>   
    modem
        failureHandling <continue | disconnect>
        toneTreatment <treatment_type>
    packetSize <packetSize>
    preferredRtpPayloadType <0-128>
    silenceSuppression <disable | enable>
    useSilkDTX <0 | 1>

The above syntax applies to following codec:

Silk

Noprint
Back To Top

Group 12 Syntax

Code Block

language	none

% set profiles media codecEntry <name> codec clearmode         
    dtmf 
		relay <relay_type> 
		removeDigits <disable | enable> 
	packetSize <packetSize> 
    preferredRtpPayloadType <0-128>

The above syntax applies to following codec:

clearmode

Noprint
Back To Top

Command Parameters

The Codec Parameters are as shown below:

Caption

0	Table
1	Codec Parameters

Parameter

Length/Range

Description

codecEntry

N/A

Specifies the name of an entity consisting of a codec type along with the set of parameters to use with it. Select a default codec name or enter a custom name. Defaults are:

G711-DEFAULT
G711SS-DEFAULT
G723-DEFAULT
G723A-DEFAULT
G726-DEFAULT
G729A-DEFAULT
G729AB-DEFAULT

codec

N/A

Select a supported codec. (see

Link_in_new_tab

Text	Audio Codecs
URL	Audio Codecs

for the codec list)

activeCodecSet

N/A

The active code set is applicable to certain AMR narrow-band codecs. Multiple rates may be selected using comma (,). Valid values are:

AMR-0-4.75kbps
AMR-1-5.15kbps
AMR-2-5.90kbps
AMR-3-6.70kbps
AMR-4-7.40kbps
AMR-5-7.950kbps
AMR-6-10.20kbps
AMR-7-12.20kbps

codingRate

N/A

The audio coding rate. (see

Link_in_new_tab

Text	Audio Codecs
URL	Audio Codecs

for details)

dtmf

N/A

Use this parameter to describe how to handle DTMF digits in the media stream.

relay – Type of DTMF relay. Select any one of the relay:
- bothOobAnd2833 – Out-of-Band and RFC 2883 are equally received and both can be transmitted. This option would normally be used only in the case where the OOB DTMF signaling is absorbed and not regenerated. For example, the OOB DTMF might go to an application server that needs to detect the DTMF for control purposes but does not process RTP and the 2833 DTMF would go to the destination media address as part of the RTP stream.
- eitherOobOrRfc2833 – Out-of-Band and RFC 2833 are equally received and only one is transmitted. The one transmitted is the one preferred by the peer or RFC 2833 as the default.
- none – Leaves the DTMF tones in-band as encoded audio.
- outOfBand – Carries DTMF in the signaling protocol.
- rfc2833 – Encodes DTMF into RTP using format and payload type distinct from audio encoding.
removeDigits – Enables the removal of DTMF digits from the media stream. This applies only if DTMF relay is configured as outOfBand or rfc2833.
- disable
- enable (default)

fax

N/A

The treatment taken when the fax tone is detected.

failureHandling –The behavior when a fax tone is detected but treatment fails for any reason:
- continue – (default) Continue to process the call.
- disconnect – Release the call.
- honorToneDetection – Enable this flag for G.711 to G.711 transcoded calls to cause the SBC to initiate a fax re-invite upon fax tone detection when the fax toneTreatment configuration is either faxRelayOrFallbackToG711 or fallbackToG711. When disabled, the SBC ignores the fax tone.
- toneTreatment –Treatment taken when the fax tone is detected. Configuration options are:
- disconnect – Disconnect the call when the fax tone is detected.
- fallbackToG711 – Fall back to G.711 when the fax tone is detected.
- fallbackToG711AllowPeerToNegotiateFaxRelay – Upon detecting a fax tone, SBC transitions call to G.711 if current codec is not already G.711. After transiting to G.711, SBC accepts any T.38 reINVITE from the peer.
- faxRelay – Switch to fax relay (T.38) when the fax tone is detected.
- faxRelayOrFallbackToG711 – Switch to fax relay (T.38) if supported or fall back to G.711 when fax tone is detected.
- ignoreDetectionAllowPeerToNegotiateFaxRelay – Accept a T.38 reINVITE (either from a calling party or a called party) and ignore own fax tone detection event..
- none – (default) Do nothing when the fax tone is detected.
- notifyPeer – For SIP signaling, notify the peer when the fax tone is detected and let the peer decide the next action.

Note
For G.711 calls, Notify Peer, Disconnect, Fax Relay, and Fax Relay or Fallback to G.711 require allocation of a compression resource.

fecRedundancy

0-2

Sets the level for Forward-Error-Correction (FEC) Redundancy [AMR only]. The default value of "0" means FEC redundancy is disabled.

initialCodecMode

N/A

Use this flag to determine the initial codec mode of an AMR/AMR-WB transcoded call once the call is established.

disable (default) – AMR/AMR-WB call starts with the highest rate in the active mode set.
enable – AMR/AMR-WB call starts with a rate determined by the following algorithm:

1. If one codec mode is included in the mode-set, it is the initial codec mode.
2. If two or three codec modes are included in the mode-set, the initial codec mode is the codec mode with the lowest rate.
3. If four or more codec modes are included in the mode-set, the initial codec mode is the codec mode with the second lowest rate.

Include Page

	initialCodecMode_limitation
	initialCodecMode_limitation

law

N/A

Use this parameter to specify the G.711 law to use.

ALaw
ULaw
deriveFromOtherLeg (default)

Include Page

	DeriveFromOtherLeg limitation
	DeriveFromOtherLeg limitation

maxAverageBitRate

6000-510000

Maximum average bit rate in bits/second. Applies to the following codecs:

Opus - 6000-510000 (default = 20000)
silk8 - 6000-20000 (default: 20000)
silk12 - 7000-25000 (default: 25000)
silk16 - 8000-36000 (default: 36000)
silk24 - 12000-40000 (default: 40000)

maxBitRate

5.9, 7.2, 8, 9.6, 13.2, 16.4, 24.4, 32, 48, 64, 96, or 128

Specifies the maximum bit rate for the EVS codec. Default is 128 Kbps. This value must be greater than or equal to minBitRate.

minBitRate

5.9, 7.2, 8, 9.6, 13.2, 16.4, 24.4, 32, 48, 64, 96, or 128

Specifies the minimum bit rate for the EVS codec. Default is 5.9 Kbps. This value must be less than or equal to maxBitRate.

maxInterleaveDepth

0-7

Use this parameter to specify the maximum interleave depth value to apply to an endpoint (default = 0).

Note
This parameter only applies to EVRC and EVRCB calls.

Note

maxInterleaveDepth is only visible under following conditions:

codec is set to "evrc" or "evrcb"
packetSize is set to "40" or "60"

modeChangeNeighbor

N/A

Enable to force mode change to neighboring modes in active codec set as per RFC4867 (applies to AMR and AMRWB).

disable (default)
enable

modem

N/A

Specifies the treatment taken when the modem tone is detected, which can be:

failureHandling – The behavior when a modem tone is detected but the treatment fails for any reason. The behavior can be:
- continue (default) – Continue to process the call.
- disconnect – Release the call.
honorToneDetection – Enable this flag for G.711 to G.711 transcoded calls to cause the SBC to initiate a re-invite upon modem tone detection when the modem toneTreatment configuration is fallbackToG711. When disabled, the SBC ignores the modem tone.
toneTreatment – Treatment taken when the modem tone is detected, which can be:
- applyFaxTreatment – Treat the modem tone as a fax tone, and apply the fax treatment for the selected codec.
- disconnect – Disconnect the call when the modem tone is detected.
- fallbackToG711 – Fall back to G.711 when the modem tone is detected.
- none (default) – Do nothing when the modem tone is detected.
- notifyPeer – Notify the peer when the modem tone is detected and let the peer decide the next action.

Note
`applyFaxTreatment` is not supported for Gateway Links.

modeSet

N/A

The AMR mode set is applicable to certain AMR wide-band codecs. The possible values are:

AMR-0-6.6
AMR-1-8.85
AMR-2-12.65
AMR-3-14.25
AMR-4-15.85
AMR-5-18.25
AMR-6-19.85
AMR-7-23.05
AMR-8-23.85

packetSize

N/A

The packet size in milliseconds (ms). Options are based on the type of codec chosen. (See

Link_in_new_tab

Text	Audio Codecs
URL	Audio Codecs

for details.) Possible completions:

20
40
60
80
100

preferredRtpPayloadType

0-128

Specifies the preferred Real Time Protocol (RTP) payload type to be included in the RTP header of the data packet. Enter a value in the range 0-128. Default is 128.

sendSid

N/A

Enable or disable for sending SIDs.

silenceSuppression

N/A

Enable/disable Silence Suppression mode.

disable (default)
enable

useCbr

0, 1

Use this flag to specify either Constant Bit Rate (CBR) or Variable Bit Rate (VBR) for OPUS codec (default = 0).

0 – Variable Bit Rate
1 – Constant Bit Rate

Note
Configuring an Opus profile using a very low `maxAverageBitRate` with `useCbr` set to "`1`" may result in degraded voice quality.

useDtx

0, 1

Set flag to "1" to use Discontinuous Transmission (DTX) For the OPUS codec (default = 0).

0 – Do not use DTX
1 – Use DTX

useFec

0, 1

Set flag to "1" to use Forward Error Correction (FEC) for the OPUS codec (default = 0).

0 – Do not use FEC
1 – Use FEC

useSilkDTX

0, 1

Set flag to "1" to use discontinuous transmission (DTX) for the Silk codec (default = 0).

Noprint
Back To Top

Command Examples

Code Block

language	none

 % show profiles media
	 codecEntry G711-DEFAULT { 
		codec g711; 
		packetSize 10; 
		preferredRtpPayloadType 128; 
			fax { 
				failureHandling continue; 
				toneTreatment none; 
			} 
			modem { 
				failureHandling continue; 
				toneTreatment none; 
			} 
			law deriveFromOtherLeg; 
			dtmf { 
				relay none; 
				removeDigits enable; 
			}
	 }

Perform the following commands to set up configuration for a transcoded call between G.711 ulaw and G.729.

Code Block

language	none

% set profiles media codecEntry codec_in codec g711 law ULaw 
% set profiles media codecEntry codec_in packetSize 20
% commit
% set profiles media packetServiceProfile profile_in 
% set profiles media packetServiceProfile profile_in codec codecEntry1 codec_in 
% set profiles media packetServiceProfile profile_in packetToPacketControl codecsAllowedForTranscoding thisLeg g711u 
% set profiles media packetServiceProfile profile_in packetToPacketControl codecsAllowedForTranscoding otherLeg g729 
% commit
% set profiles media codecEntry codec_out codec g729a 
% set profiles media codecEntry codec_out packetSize 20 
% commit
% set profiles media packetServiceProfile profile_out_1 
% set profiles media packetServiceProfile profile_outcodec codecEntry1 codec_out 
% set profiles media packetServiceProfile profile_outpacketToPacketControl codecsAllowedForTranscoding thisLeg g729 
% set profiles media packetServiceProfile profile_outpacketToPacketControl codecsAllowedForTranscoding otherLeg g711u

Perform the following commands to set up configuration to allow the SBC to treat clearmode as any other pass-thru codec:

Code Block
% set profiles media codecEntry <CLEARMODE> codec clearmode % set profiles media packetServiceProfile <DEFAULT> codec codecEntry<1 to 12> <CLEARMODE>

Assign the ingress profile to the ingress trunk group and the egress profile on the egress IP peer:

Code Block

language	none

% set addressContext a1 zone INTERNAL sipTrunkGroup EAST_INT policy media packetServiceProfile profile_in  
% set addressContext a1 zone EXTERNAL ipPeer EAST_ext_peer policy packetServiceProfile profile_out
% commit

Get statistics of ongoing calls by executing the following commands. The GCID (Global Call Identifier) for calls are listed.

Code Block

language	none

% show table global callSummaryStatus

Provide GCID for the following command; output shows media type (pass-through or transcode):

Code Block

language	none

% show table global callDetailStatus <GCID>

Output of the following command gives codec details:

Code Block

language	none

% show table global callMediaStatus <GCID>

Output of the following command gives PxPad utilization:

Code Block

language	none

 % show table global callResourceDetailStatus <GCID>

Configure Opus codec:

Code Block

language	none

% set profiles media codecEntry Opus_entry codec opus maxAverageBitRate 10000 useCbr 1 useDtx 1 useFec 0
% commit
 
% show profiles media codecEntry Opus_entry
codec             opus;
maxAverageBitRate 10000;
useCbr            1;
useFec            0;
useDtx            1;

How to set the honorToneDetection flag in the fax parameter.

Code Block
% set profiles media codecEntry G711 codec g711 fax honorToneDetection enable commit

How to set the honorToneDetection flag in the modem parameter.

Code Block
% set profiles media codecEntry G711 codec g711 modem honorToneDetection enable commit

How to view the honorToneDetection flag in the fax and modem parameters.

Code Block

 % show profiles media codecEntry G711
    codec         g711;
    packetSize    10;
    fax {
        failureHandling    continue;
        toneTreatment      none;
        honorToneDetection enable;
    }
    modem {
        failureHandling    continue;
        toneTreatment      none;
        honorToneDetection enable;
    }
    law           deriveFromOtherLeg;
    dtmf {
        relay        none;
        removeDigits enable;
}
[ok][2018-06-13 10:49:36]

Pagebreak

Space shortcuts

Page tree

Versions Compared

Old Version 1

New Version Current

Key

Command Syntax

Group 1 Syntax

Group 2 Syntax

Group 3 Syntax

Group 4 Syntax

Group 5 Syntax

Group 6 Syntax

Group 7 Syntax

Group 8 Syntax

Group 9 Syntax

Group 10 Syntax

Group 11 Syntax

Group 12 Syntax

Command Parameters

Command Examples