pulse code modulation (pcm) audio capture · pulse code modulation (pcm) audio capture...

6
Pulse Code Modulation (PCM) Audio Capture The Pulse Code Modulation (PCM) Audio capture feature is used for debugging audio quality issues. PCM capture refers to an existing Digital Signal Processor (DSP) feature by which the digital audio signal at various nodes in the audio signal processing path of a voice channel may be intercepted and uploaded to the host router using specialized DSP-to-host message packets. Cisco IOS file services allow a file containing interleaved audio and debug data (.dat) to be created in the local file system or a remote TFTP server. This .dat file is then decoded and deinterleaved into separate, synchronized .wav files for each of the signal interception nodes. This feature is typically employed for capture of audio test signals in troubleshooting specific voice issues such as echo. Signals may be captured at any or all of the defined nodes, including the input-output nodes of an echo canceller (Rin, Sin, Sout), the Acoustic Shock Protection circuit, and the Noise Reduction module. Additional nodes of interest will be added as new signal processing features are introduced. Finding Feature Information, page 1 Information about PCM Audio Capture, page 2 How to Configure PCM Audio Capture, page 2 Additional References for Cisco UBE Serviceability, page 5 Feature Information for Pulse Code Modulation (PCM) Audio Capture, page 6 Finding Feature Information Your software release may not support all the features documented in this module. For the latest caveats and feature information, see Bug Search Tool and the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the feature information table at the end of this module. Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required. Cisco Unified Border Element Management Configuration Guide, Cisco IOS Release 15M&T 1

Upload: others

Post on 19-Apr-2020

101 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Pulse Code Modulation (PCM) Audio Capture · Pulse Code Modulation (PCM) Audio Capture ThePulseCodeModulation(PCM)Audiocapturefeatureisusedfordebuggingaudioqualityissues.PCM

Pulse Code Modulation (PCM) Audio Capture

The Pulse Code Modulation (PCM) Audio capture feature is used for debugging audio quality issues. PCMcapture refers to an existing Digital Signal Processor (DSP) feature by which the digital audio signal atvarious nodes in the audio signal processing path of a voice channel may be intercepted and uploaded to thehost router using specialized DSP-to-host message packets. Cisco IOS file services allow a file containinginterleaved audio and debug data (.dat) to be created in the local file system or a remote TFTP server. This.dat file is then decoded and deinterleaved into separate, synchronized .wav files for each of the signalinterception nodes. This feature is typically employed for capture of audio test signals in troubleshootingspecific voice issues such as echo. Signals may be captured at any or all of the defined nodes, including theinput-output nodes of an echo canceller (Rin, Sin, Sout), the Acoustic Shock Protection circuit, and the NoiseReductionmodule. Additional nodes of interest will be added as new signal processing features are introduced.

• Finding Feature Information, page 1

• Information about PCM Audio Capture, page 2

• How to Configure PCM Audio Capture, page 2

• Additional References for Cisco UBE Serviceability, page 5

• Feature Information for Pulse Code Modulation (PCM) Audio Capture, page 6

Finding Feature InformationYour software release may not support all the features documented in this module. For the latest caveats andfeature information, see Bug Search Tool and the release notes for your platform and software release. Tofind information about the features documented in this module, and to see a list of the releases in which eachfeature is supported, see the feature information table at the end of this module.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support.To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.

Cisco Unified Border Element Management Configuration Guide, Cisco IOS Release 15M&T 1

Page 2: Pulse Code Modulation (PCM) Audio Capture · Pulse Code Modulation (PCM) Audio Capture ThePulseCodeModulation(PCM)Audiocapturefeatureisusedfordebuggingaudioqualityissues.PCM

Information about PCM Audio Capture

PCM Audio CaptureThe following are the enhancements to the PCM Audio Capture feature:

• Separate PCM capture and Banjo logger feature so that they do not share the same data (.dat) file; theyhave their own data file.

• One PCM call per data file is generated dynamically. The filename contains information such as voiceport type and number, call ID, calling and called number, GUID, DSP channel number, and time stamp.

• A user on the TDM-TDM or TDM-VoIP call can dynamically enable and disable PCM capture byentering predefined start and stop Dual Tone Multi-Frequency (DTMF) digits.

• More test points or streams can be captured.

PCM capture is a CPU-intensive feature, and you must not enable several PCM capture sessions whilerunning heavy traffic.

Note

How to Configure PCM Audio Capture

Configuring PCM Audio Capture

SUMMARY STEPS

1. enable2. configure terminal3. voice pcm capture buffer number4. voice pcm capture destination url5. voice pcm capture on-demand-trigger6. voice pcm capture user-trigger-string start-string stop-string stream bitmap duration call-duration7. end

DETAILED STEPS

PurposeCommand or Action

Enables privileged EXEC mode.enableStep 1

Cisco Unified Border Element Management Configuration Guide, Cisco IOS Release 15M&T2

Pulse Code Modulation (PCM) Audio CaptureInformation about PCM Audio Capture

Page 3: Pulse Code Modulation (PCM) Audio Capture · Pulse Code Modulation (PCM) Audio Capture ThePulseCodeModulation(PCM)Audiocapturefeatureisusedfordebuggingaudioqualityissues.PCM

PurposeCommand or Action

Example:

Router> enable

• Enter your password if prompted.

Enters global configuration mode.configure terminal

Example:Router# configure terminal

Step 2

Configures the number of PCM capture buffers. The Range is from0 to 200000. To change the PCM capture buffer size, you must firstconfigure it with 0 and then configure it with the desired number.

voice pcm capture buffer number

Example:Router(config)# voice pcm capture buffer10

Step 3

Configures or changes the destination URL for storing captureddata.

voice pcm capture destination url

Example:Router(config)# voice pcm capturedestination tftp://10.10.1.2/acphan/

Step 4

Configures user-triggered PCM capture.voice pcm capture on-demand-trigger

Example:Router(config)# voice pcm captureon-demand-trigger

Step 5

Changes the default user trigger PCM capture start and stop string,stream, and duration.

voice pcm capture user-trigger-string start-stringstop-string stream bitmap duration call-duration

Step 6

Example:Router(config)# voice pcm capture #132 #543stream ff duration 230

• The start and stop string must have different values.

• PCM stream bitmap is in hexadecimal. The range is from 1to FFFFFFF.

• The stream bitmap definitions are as follows:

• bit 0—Rin

• bit 1—Sin

• bit 2—Sout

• bit 3—nonNLP Sout

• bit 4—fax modem in

• bit 5—fax modem out

Cisco Unified Border Element Management Configuration Guide, Cisco IOS Release 15M&T 3

Pulse Code Modulation (PCM) Audio CaptureConfiguring PCM Audio Capture

Page 4: Pulse Code Modulation (PCM) Audio Capture · Pulse Code Modulation (PCM) Audio Capture ThePulseCodeModulation(PCM)Audiocapturefeatureisusedfordebuggingaudioqualityissues.PCM

PurposeCommand or Action

• bit 6—from IP network to TDM earpiece direction: ASPinput

• bit 7—from IP network to TDM earpiece direction: ASPoutput

• bit 8—NR in

• bit 9—NR out

• bit 10—from TDM mic to IP network: ASP in

• bit 11—from TDM mic to IP network: ASP out

Returns to privileged EXEC mode.end

Example:Router(config)# end

Step 7

Verifying PCM Audio CapturePerform this task to verify the configuration for the PCM Audio Capture feature.

SUMMARY STEPS

1. enable2. show voice pcm capture

DETAILED STEPS

Step 1 enable

Example:Router> enable

Enables privileged EXEC mode.

Step 2 show voice pcm capture

Example:Router# show voice pcm capture

PCM Capture is on and is logging to URL tftp://10.10.1.2/acphan/50198 messages sent to URL, 0 messages droppedMessage Buffer (total:inuse:free) 200000:0:200000

Cisco Unified Border Element Management Configuration Guide, Cisco IOS Release 15M&T4

Pulse Code Modulation (PCM) Audio CaptureVerifying PCM Audio Capture

Page 5: Pulse Code Modulation (PCM) Audio Capture · Pulse Code Modulation (PCM) Audio Capture ThePulseCodeModulation(PCM)Audiocapturefeatureisusedfordebuggingaudioqualityissues.PCM

Buffer Memory: 68000000 bytes, Message size: 340 bytes

Displays the configured PCM capture buffer and destination, number of saved messages/packets, number of droppedmessages/packets, and number of buffers allocated, both used and free.

Additional References for Cisco UBE ServiceabilityRelated Documents

Document TitleRelated Topic

Cisco IOS Master Command List,All Releases

Cisco IOS commands

• Cisco IOS Voice CommandReference - A through C

• Cisco IOS Voice CommandReference - D through I

• Cisco IOS Voice CommandReference - K through R

• Cisco IOS Voice CommandReference - S Commands

• Cisco IOS Voice CommandReference - T through ZCommands

Voice commands

Technical Assistance

LinkDescription

http://www.cisco.com/cisco/web/support/index.htmlThe Cisco Support and Documentation websiteprovides online resources to download documentation,software, and tools. Use these resources to install andconfigure the software and to troubleshoot and resolvetechnical issues with Cisco products and technologies.Access to most tools on the Cisco Support andDocumentation website requires a Cisco.com user IDand password.

Cisco Unified Border Element Management Configuration Guide, Cisco IOS Release 15M&T 5

Pulse Code Modulation (PCM) Audio CaptureAdditional References for Cisco UBE Serviceability

Page 6: Pulse Code Modulation (PCM) Audio Capture · Pulse Code Modulation (PCM) Audio Capture ThePulseCodeModulation(PCM)Audiocapturefeatureisusedfordebuggingaudioqualityissues.PCM

Feature Information for Pulse Code Modulation (PCM) AudioCapture

The following table provides release information about the feature or features described in this module. Thistable lists only the software release that introduced support for a given feature in a given software releasetrain. Unless noted otherwise, subsequent releases of that software release train also support that feature.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support.To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.

Table 1: Feature Information for Pulse Code Modulation (PCM) Audio Capture

Feature InformationReleasesFeature Name

The PCM Capture feature is usedfor debugging audio quality issues.

In Cisco IOSRelease 15.2(2)T, thisfeature was implemented on theCisco Unified Border Element .

The following commands wereintroduced ormodified: show voicepcm capture, voice pcm capture.

15.2(2)TPulse Code Modulation (PCM)Audio Capture

The PCM Capture feature is usedfor debugging audio quality issues.

In Cisco IOSXERelease 3.6S, thisfeature was implemented on theCisco Unified Border Element(Enterprise)

The following commands wereintroduced ormodified: show voicepcm capture, voice pcm capture.

Cisco IOS XE Release 3.6SPulse Code Modulation (PCM)Audio Capture

Cisco Unified Border Element Management Configuration Guide, Cisco IOS Release 15M&T6

Pulse Code Modulation (PCM) Audio CaptureFeature Information for Pulse Code Modulation (PCM) Audio Capture