The Media Technology Guide provides information necessary to work with media, one of the basic Brew^® Mobile Platform (Brew MP^™) components. This component is used for

• Playback of audio-only files (e.g., ring tones, tones, beeps, and MP3/AAC/MIDI/WMA/PCM files)
• Playback of audio and video files or video-only files (e.g., 3gp, 3g2, MP4)
• Image decoding
• Device and volume control

This guide describes Brew MP media interfaces on different Qualcomm MSMs. This guide also explains how Brew MP handles media system concurrency. Almost all interfaces defined are largely target independent and OS independent.

CAL is a new way of communicating with targets. It supports both simulated and physical targets interchangeably, communicating over Gateway, BTIL, and/or Diag (physical devices only). Once a target is configured in Brew MP Target Manager, CAL automatically handles connections and communication, using the best available technology (Gateway/BTIL/Diag) and abstracting away the need for the user to know which technology should be used for a given operation. For advanced users who want to use a particular technology, CAL provides the means to get a handle for the device that allows the user to use Gateway, BTIL or Diag directly.

CAL APIs are "flat c" and can be invoked by any language/environment. Test applications have been written in C/C++, .NET, Python and Java. Unlike ConnectGW and BTIL, there is no static library to link in. While this could change in the future (depending on demand), the hope was that installation and removal of Brew MP toolsets would not silently switch the version of CAL being used.

This technology guide describes a mechanism by which applications can be restored to the factory state. Factory reset is used to clear user data and restore the pre-installed Brew^® Mobile Platform (Brew MP^™) applications in a module to factory state.

The dbc Technology Guide explains how to use and work with Brew^® MP's embedded database interfaces. It covers Brew MP-specific datbase features, recommended best practices and gives use cases for some basic database functions.

dbc is the interface in Brew MP for managing persistent data on a device. At its core is the SQLite database engine, which supports the SQL Query language.

For device manufacturers, this document also describes device integration for dbc.

Brew^® Mobile Platform (Brew MP) has four core software layers:

• OS Services
• Platform Services
• Application Environment
• Applications

MMS service is implemented on top of the Brew MP platform service as shown in this diagram.

Brew MP's MMS APIs expose the following capabilities for use in MMS Client applications:

• Parsing and encapsulation of MMS messages
• Viewing MMS messages
• Sending/receiving MMS transactions
• Monitoring MMS transactions
• Application directed MMS--A third party application can use MMS transport for sending and receiving application-specific contents.

This technology guide describes the following parsers available in Brew Mobile Platform (Brew MP):

• JSON (JavaScript Object Notation) parser: Used to to build or parse JSON data.
• XML parser: Used to build or parse an XML document.

This document contains design or implementation recommendations for software developers who wish to get the best performance from the Brew ^® MP builds. Best engineering judgement must be applied, as any given recommendation may not lead to optimal performance within the constraints of a given system implementation. Many of these recommendations are not Brew MP specific but general to any programming practice.

Base version:	Brew MP 1.0.2
Document number:	HT80-VT500-180 Rev. B HT80-VT500-181 Rev. A
Date published:	June 8, 2011

Brew^® Mobile Platform (Brew MP) has four core software layers:

• OS Services
• Platform Services
• Application Environment
• Applications

Telephony is part of the Platform Services software layer under Modem Services, as shown in the following figure:

Telephony provides interfaces for these services:

• Telephony

  The telephony interfaces provide functions to create and manage calls, register for and receive telephony events, retrieve phone information, and modify phone behavior.

• SMS

  The SMS interfaces provide functions to register for and receive SMS notifications, send and receive messages, save and read saved messages, and configure the SMS broadcast service.

• Dual SIM/Dual Standby

  Starting with Brew MP 1.0.3, telephony supports the Dual SIM Dual Standby (DS/DS) feature.

The Telephony Technology Guide contains a section, which describes the architecture of each service, the interfaces that provide the service, and use cases for each of these services.

This document provides a discussion of the Brew ^® Mobile Platform (Brew MP) programming model.

For introductions to development environments and setup specific to languages, see the Brew MP Primers on the Brew MP website. This document is meant to provide a more in-depth exploration of programming for the Brew MP platform, to bridge the Brew MP Primers and Technology Guides.

This document provides information on the following:

• Creating a simple Brew MP application
• Brew MP programming concepts and terminology
• Key interfaces

Brew^® Mobile Platform (Brew MP) provides Wireless LAN (WLAN) connectivity. This technology guide covers the WLAN interfaces used to manage WLAN connections, scan for access points, configure WLAN parameters, and enable the WPS protocol.

WLAN networks may contain multiple access points. An application can manage the connection from one access point to another within a network without informing the user.