QUALCOMM Incorporated

5775 Morehouse Drive

San Diego, CA. 92121-1714
U.S.A.
This manual was written for use with the BREW SDKTM for Windows, software version 1.1.0. This
manual and the BREW SDK software described in it are copyrighted, with all rights reserved. This
manual and the BREW SDK software may not be copied, except as otherwise provided in your software
license or as expressly permitted in writing by QUALCOMM Incorporated.

Copyright  2001 QUALCOMM Incorporated

All Rights Reserved
Printed in the United States of America.
All data and information contained in or disclosed by this document are confidential and proprietary
information of QUALCOMM Incorporated, and all rights therein are expressly reserved. By accepting
this material, the recipient agrees that this material and the information contained therein are held in
confidence and in trust and will not be used, copied, reproduced in whole or in part, nor its contents
revealed in any manner to others without the express written permission of QUALCOMM Incorporated.
Export of this technology may be controlled by the United States Government. Diversion contrary to
U.S. law prohibited.
Binary Runtime Environment for Wireless, BREW, BREW SDK, TRUE BREW, BREWStone,
MobileShop, Eudora, and PureVoice are trademarks of QUALCOMM Incorporated.
QUALCOMM is a registered trademark and registered service mark of QUALCOMM Incorporated.
Microsoft, Windows, Visual Studio, and Sound Recorder are either registered trademarks or trademarks
of Microsoft Corporation in the United States and/or other countries.
Macintosh is a registered trademark of Apple Computer, Inc.
UNIX and X-Windows are trademarks of The Open Group.
Adobe, Acrobat, and Photoshop are trademarks of Adobe Systems Incorporated.
All trademarks and registered trademarks referenced herein are the property of their respective owners.

BREW SDK Utilities Guide

November 26, 2001
 Contents
Introducing the BREW SDK Utilities Guide, 4
BREW documentation, 4
Requesting new BREW features, 5
For more information, 5

Using the PureVoice Converter, 6

Converting files using the PureVoice Converter, 6
Converting WAV files to mono, 8 kilohertz, 16 bit format, 7

Index, 10

iii
 Introducing the BREW SDK
Utilities Guide

This guide provides an overview of the utilities included with the Binary Runtime Environment
for Wireless ™ (BREW ™) Software Development Kit (BREW SDK™). This guide includes the
following sections:

Using the PureVoice Converter
Describes how to use this utility to convert pulse code modulation
(PCM) waveform (WAV) files to PureVoice QCP files (and vice
versa) that can be played on the BREW Emulator, subsequently
referred to as the Emulator, and on BREW-enabled devices that
support PureVoice.

BREW documentation
This guide is part of an information set that includes the following documents:

BREW SDK User’s Guide Introduces the components of the BREW SDK and their
relationship to one another. The document also contains
general instructions for developing BREW applications and for
using the Emulator.

BREW API Reference Provides information about BREW functions and data
structures needed to develop applications for BREW-enabled
mobile platforms.

BREW Device Configurator Guide Describes how to use the BREW Device Configurator to
create effective wireless devices for emulation by the Emulator.

BREW Resource Editor Guide Describes how to use the BREW Resource Editor to create the
text strings, images, and dialogs used by BREW applications.

BREW MIF Editor Guide Describes how to use the BREW MIF Editor to create and
modify Module Information Files (MIF)—a special type of
BREW resource file that contains information about the
classes and applets supported by particular BREW modules.

4
 Introducing the BREW SDK Utilities Guide

BREW SDK Utilities Guide Describes how to use the utilities, such as the PureVoice
Converter, included with the BREW SDK.

BREW Compressed Image Describes how to use the BREW Compressed Image
Authoring Guide Authoring Tool to create files for displaying and animating
images in your applications.

Requesting new BREW features

Do you have ideas for features that would make the BREW SDK more valuable and useful to
you? If so, send us email at brew-request@qualcomm.com. Each request is evaluated, and a
member of the New Features Response Team will respond to your email.

For more information

Online information and support is available for BREW application developers. Please visit the
BREW web site for details: www.qualcomm.com/brew/developer.

5
 Using the PureVoice Converter

PureVoice voice coding technology, developed by QUALCOMM and a standard in CDMA

cellular technology, allows your applications to play back incoming speech signals on the
Emulator and BREW-enabled devices that support PureVoice. Also included in QUALCOMM
Mobile Station Modem (MSM) chipsets and with QUALCOMM’s Eudora software, PureVoice
compresses an incoming speech signal to its most compact digital format. It can reduce file
size and transmission time by more than a factor of 10, compared to other common formats,
such as the WAV format. For more information on PureVoice, see
http://www.cdmatech.com/solutions/products/purevoice.html.

BREW supports PureVoice files, with the .qcp extension, encoded in IS-733 (13 kilobits per
second, variable rate) format. The ISoundPlayer interface can play QCP files, in addition to
MIDI and MP3 formats. For more information on the QCP format support by ISoundPlayer, see
the BREW API Reference.

The Emulator also supports the playback of QCP files. The MIDI sample application, included
in the BREW SDK, plays QCP files, in addition to MIDI and MP3 files. You can use the
PureVoice Converter, shipped with the BREW SDK, to convert WAV files to QCP files (and vice
versa). The QCP files can be tested on the Emulator, and you can play them on BREW-
enabled handsets using the BREW APIs.

Converting files using the PureVoice Converter

The PureVoice Converter converts PCM (mono, 8 Kilohertz, 16 bit) WAV files to PureVoice
QCP files (and vice versa) using different encoding modes (variable rate, full fixed, half max
variable, and half fixed). If you intend to convert a WAV file that is not already in the mono,
8 kilohertz, 16 bit format, you must first convert it to that format. See Converting WAV files to
mono, 8 kilohertz, 16 bit format on page 7 for instructions.

NOTE: BREW supports only IS-733 (13 kilobits per second, variable rate) encoding only.

To convert a WAV file to QCP (or vice versa)

1. Open the Windows command prompt.

6
 Using the PureVoice Converter

2. Access the directory where the WAV or QCP file to be converted resides.

NOTE: The <BREW\Bin\DataFiles> directory contains several WAV and QCP files
with which you can experiment.

3. Type the following command:

Usage:pvconv [-e {0..3}] infile [outfile]

Where

• infile is the WAV or QCP file to be converted.

• outfile is the name of the WAV or QCP file after the conversion (optional).
• -e (0..3) is the encoding mode for the conversion (-e is optional). The encoding
mode options are:

- 0: variable rate (default)

- 1: full fixed

- 2: half max variable

- 3: half fixed

4. Press Enter to execute the command and convert the file.

The converted file is stored in the same directory as the original file.

Converting WAV files to mono, 8 kilohertz, 16 bit format

Before you can use the PureVoice Converter to convert WAV files to the QCP format, you must
first convert them to mono, 8 kilohertz, 16 bit format using the Windows Sound Recorder
application.

To convert a WAV file to mono, 8 kilohertz, 16 bit format

1. Choose Start > Programs > Accessories and navigate to the Sound Recorder
application. The location of this application is different depending on the Windows
operating system you run.

7
 Using the PureVoice Converter

The Sound Recorder window opens.

2. Choose File > Open, navigate to the directory where you store your WAV files, and
open the WAV file you want to convert.

3. Choose File > Properties.

The Properties dialog box for the selected sound file opens.

4. Check the Audio Format field. If the audio format is anything besides PCM 8 KHz,
16 Bit, Mono, click Convert Now.

8
 Using the PureVoice Converter

The Sound Selection dialog box opens.

5. Make the entries shown above, and click Save As.

The Save As window opens.

6. Type BREW QCP, and click OK

The Save As window closes and BREW QCP is added to the list of sounds
available in the Sound Selection dialog box.

7. Click OK.

The file is now ready to be converted to QCP format with the PureVoice Converter.

9
 Index

C
Converting sound files, 6

F
Features, requesting new, 5

P
PureVoice technology, 6
PVConv utility, using, 6

R
Requesting new BREW features, 5

S
Sound Recorder, 7

W
WAV files, converting, 7
Web site, BREW, 5

10