xiamiaofang-longcheertel.com2008.05.27 at 01:34:27...

AMSS Overview

80-VH700-1 B

Qualcomm Confidential and ProprietaryRestricted Distribution. Not to be distributed to anyone who is not an employee of either Qualcomm or a subsidiary of Qualcomm without the express approval of Qualcomm’s Configuration Management.

Not to 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.

Qualcomm reserves the right to make changes to the product(s) or information contained herein without notice. No liability is assumed for any damages arising directly or indirectly by their use or application. The information provided in this document is provided on an “as is” basis.

This document contains Qualcomm confidential and proprietary information and must be shredded when discarded.

QUALCOMM is a registered trademark of QUALCOMM Incorporated in the United States and may be registered in other countries. Other product and brand names may be trademarks or registered trademarks of their respective owners. CDMA2000 is a registered certification mark of the Telecommunications Industry Association, used under license. ARM is a registered trademark of ARM Limited. QDSP is a registered trademark of QUALCOMM Incorporated in the United States and other countries.

This technical data may be subject to U.S. and international export, re-export, or transfer (“export”) laws. Diversion contrary to U.S. and international law is strictly prohibited.

QUALCOMM Incorporated5775 Morehouse Drive

San Diego, CA 92121-1714U.S.A.

Copyright © 2008 QUALCOMM Incorporated. All rights reserved.

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT

Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION

80-VH700-1 B Mar 2008

Terms and Conditions of Usage

This document contains descriptions of parts whose manufacture, use, sale, offer for sale, or importation into the United States is limited or prohibited by the February 5th, 2008 injunction against QUALCOMM Incorporated. This document should not be construed as an offer to sell such parts for use or importation into the U.S., nor should it be construed as assistance in making, using, selling, offering to sell, or the importation of any product in the U.S. containing such parts. This document is intended solely to provide information for those products that are outside the scope of the injunction. Recipient’s download and/or use of the information in this document constitutes agreement with these terms.

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Revision History

Version Date Description

A Feb 2008 Initial release B Mar 2008 Updated AMSS specifications; OS and Common

Software slide

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Contents

IntroductionAPI ExamplesSome Examples – CMSome Example APIs – WMSReferencesQuestions?

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Introduction~

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Introduction

Advanced Mobile Subscriber Software (AMSS) is comprised of software components, such as OS, drivers, protocol stacks, and applications

All AMSS similar but configured differently for different MSM™ chipsets– Air interface protocols differ depending on MSM– Multimedia software differs depending on MSM capability and software build– Hardware-specific components, e.g., drivers, vary based on MSMAMSS is currently based on the following specifications:– 3GPP Release 6 WCDMA– 3GPP Release 99 for GERAN– Some selected GERAN features from Rel 4 and Rel 6 – GERAN feature

pack-1 (NACC, extended UL TBF) and E-DTMxiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Architecture

HARDWARE(ARM®, DSP, peripherals, etc.)

Boot loader

AMSS

REX

Drivers (Flash, RF, etc.

Modem and protocols Launchpad™

Common software

BREW OEM layerBREW® OEM native

QVM

Extension(s)App(s)

File systemNV, Diag,

etc.

Extension App

Static “C” APIsImmutable interface Direct hardware access (HWIO)

Virtual hardware access (HAL)

Key

Device driver (DAL)xia

miao

fang-lo

ngchee

rtel.c

om

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

AMSS for UMTS

BREWapi + QCT extensions

WCDMA Voice

Services(WVS)

Audio and Vocoder Services

(AVS)

MDSP

NAS

Broadcast services

WCDMA L1

WCDMA RLC

RRC

MM (MM/GMM)

GSDI

CNM(SS/CC/SMS)

Call Manager (CM)

SM

MNREG

ADSP

BMC

Data Services (DS)

CSdata

PSdata

RABM

RR(RR/GRR)

DL

GSM L1

LLC

GPRS RLC

GPRS MAC

GPRS L1

WMS

CBTC

WCDMA MAC

GSMMDSP

WCDMAMDSP

GSTK

General services

UIM support(UIM)

Operating system (REX)

Download support (DLOAD)

Diagnostic services (DIAG)

Buffer management (DSM)

NV and File System (NV/EFS)

Bluetooth®

Interrupt services (TRAMP)

DSP services(QDSP)

Task and Mode Controller (TMC)

USB services

Drivers

Serial I/O drivers(SIO)

Bit Input/Output(BIO)

BOOT

Time services(CLOCK)

ADC drivers (ADC)

MSM drivers(CLKREGIM, HW)

Serial Bus Interface drivers (SBI)

THERM

Battery drivers(VBATT)

RF drivers(RF)

I2C drivers(I2C)

Watchdog services(DOG)

Handset Services(HS)

Audio/voice services

Core UI Phonebook SMS PureVoice®BTGPS Media

Player™ CAT MMSBrowserCamera/camcorderDialer Video

phone

Sound Sockets EFS/NV PBM PD (GPS)CMX® API Voice API

GSM – MAP protocols

GSM GPRS WCDMA

Qcamera™/Qcamcorder™

services

HW accelerator

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

OS and Common Software


WVS

AVS

MDSP

NAS

Broadcast services

WCDMA L1

WCDMA RLC

RRC

MM (MM/GMM)

GSDI

CNM(SS/CC/SMS)

CM

SM

MNREG

ADSP

BMC

DS

CSdata

PSdata

RABM

RR(RR/GRR)

DL

GSM L1

LLC

GPRS RLC

GPRS MAC

GPRS L1

WMS

CBTC

WCDMA MAC

GSMMDSP

WCDMAMDSP

GSTK

General services

UIM


DLOAD

DIAG


Bluetooth


DSP services(QDSP)

TMC

USB services

Drivers

SIO

BIO

BOOT


ADC


SBI

THERM


RF

I2C

HS


Core UI Phone book SMS Pure

VoiceBTGPS MediaPlayer CAT MMSBrowserCamera/

camcorderDialer Videophone

Sound Sockets EFS/NV PBM PD (GPS)CMX API Voice API


GSM GPRS WCDMA

Qcamera/Qcamcorder

services

HW accelerator


DOG

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

OS and Common Software (cont.)

Module DescriptionREX Provides OS services to AMSS including task creation and management, task

scheduling, timer services, mutex/interrupt locking and signaling

EFS, NV EFS provides embedded file system services; NV provides item parameter read/write service useful for storing phone configuration data

Tramp Interrupt services

DIAG Diagnostic services subsystem – Provides logging and control services; responds to QXDM and QPST™

TMC Task that provides nonprotocol-specific power-up initialization (task startup) and task-related operation, such as, task definition, start, offline and stop; requires FEATURE_MULTIMODE_ARCH

DOG Watchdog service monitors the other software tasks to make sure that they execute properly and prevents the watchdog timer from resetting the microprocessor

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

OS and Common Software (cont.)

Module DescriptionDLOAD Download services handle the asynchronous download protocol using the UART to

retrieve new software into the phone; also used for the software upgrade of the internal phone flash ROM

DSM Data Service Memory – Used in protocol stacks for efficient buffer management and flow control

HS Handset services provide an interface between the handset and the other software tasks; services process input received from the handset keypad and display information on the handset display

QDSP® Controls the QUALCOMM® DSP (initialization and loading of the various DSP images)

ANSIC_API ANSI C functions

Common Common files used across the entire code base

Mobile Software’s main procedure that is called after the processor boots successfullyxiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Drivers


WVS

AVS

MDSP

NAS

Broadcast services

WCDMA L1

WCDMA RLC

RRC

MM (MM/GMM)

GSDI

CNM(SS/CC/SMS)

CM

SM

MNREG

ADSP

BMC

DS

CSdata

PSdata

RABM

RR(RR/GRR)

DL

GSM L1

LLC

GPRS RLC

GPRS MAC

GPRS L1

WMS

CBTC

WCDMA MAC

GSMMDSP

WCDMAMDSP

GSTK

General Services

UIM


DLOAD

DIAG



Bluetooth


DSP services(QDSP)

TMC

USB services

Drivers

SIO

BIO

BOOT


ADC


SBI

THERM


RF

I2C

DOG

HS







GSM GPRS WCDMA

Qcamera/Qcamcorder

services

HW accelerator

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Drivers (cont.)

Module Description

ADC Analog to Digital Converter; there are usually several of these available for use. They are commonly used for measuring ADC channels; this includes measuring battery power, and measuring thermal properties so that temp. compensation can be done for RF Tx/Rx.

ADIE Device driver for the MSM analog die

ADSP QDSP4™ firmware images for the MSM application DSP

ATMR Action timer services

Audfmt Audio formats module provides high-quality audio playback of supported sound files

AVS Audio, Vocoder, and Sound drivers

BIO Basic I/O services includes macros to toggle GPIO signals

Camera Camera hardware drivers

CHG Battery charger software driver

Clock Clock services provide system time as well as time stamps, clock callbacks, timers, and various interfaces for updating the system time

Clock Regime Clock Regime services deal with sourcing the various regimes with the appropriate clocks; they control the source clocks to the ARM, DSPs, chipxN clocks, codec, etc.

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Drivers (cont.)

Module DescriptionDFM DFM provides support for Digital FM (DFM)

FS AMSS Flash file system has the functionality of a disk file system using a programmable-flash data storage device

HW AMSS hardware services provide general hardware functions such as MSM initialization, MSM version identification, reset, power off, and register mapping

I2C Communication drivers to control I2C buses and perform IO on slave devices

KPD This module performs low-level initialization and operation of the keypad

LCD Performs low-level initialization and operation of the LCD controller

NV Non-Volatile memory services driver

PMIC PMIC drivers used to control various functions of our PMIC; the drivers usually interface with sleep and power control of many hardware blocks; communication is via SBI interface

QDSP services Control the QUALCOMM DSP (initialization and loading of the various DSP images)

RF Set of drivers for interfacing MSM to various Tx/RF chipsets; they define control of the RF (tuning, Tx, etc.); they also support FTM mode for RF calibration and use of calibrated information (temp calibration, freq range calibration)

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Drivers (cont.)

Module DescriptionSBI Serial Bus Interface – Proprietary bus used for communicating between ARM and

external components such as PMIC, RFR, RTR chipsets

SDAC SDAC module provides low-level drivers to control Stereo DAC

SIO Used as a higher level interface between AMSS and USB/serial/Bluetooth®

interfaces; often interfaces with data protocol stack and DIAG services

SRCH CDMA searcher and demodulator control; includes sleep – Microprocessor and CDMA sleep control

Therm Thermistor driver services

USB Universal Serial Bus device driver services

VBATT Used for battery charging to read the battery level; uses ADC channel

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

APIs and Services


WVS

AVS

MDSP

NAS

Broadcast services

WCDMA L1

WCDMA RLC

RRC

MM (MM/GMM)

GSDI

CNM(SS/CC/SMS)

CM

SM

MNREG

ADSP

BMC

DS

CSdata

PSdata

RABM

RR(RR/GRR)

DL

GSM L1

LLC

GPRS RLC

GPRS MAC

GPRS L1

WMS

CBTC

WCDMA MAC

GSMMDSP

WCDMAMDSP

GSTK

General services

UIM


DLOAD

DIAG



Bluetooth


DSP services(QDSP)

TMC

USB services

Drivers

SIO

Bit Input/Output(BIO)

BOOT


ADC drivers (ADC)


SBI

THERM


RF

I2C

DOG

HS







GSM GPRS WCDMA

Qcamera/Qcamcorder

services

HW accelerator

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

APIs and Services (cont.)

Module Description

PBM API Phone Book Manager API

CM Call Manager services are the middle layer between the application software (such as UI, data services, diagnostic monitor, and SMS) and MC; CM services provide call control, phone control and management, serving-system change notification, number classification, in-band services, and SMS control APIs for client applications to use

PD API gpsOne® Position Determination API for location-based services

SEC Enables users to make secure data connections between the handset and a secure web server

System Determination (SD) Executes rules that govern system acquisition steps

UI User interface that is used to access the phone’s hardware

UIM User Identity Module

CMX Compact Multimedia Extension

Sockets Data services socket API (low- and high-speed packet data, async, fax, and other services)

Graphic services Graphics services task software handles the core image decoders in the software

MDSP services MDSP services handles startup, firmware downloading, and shutdown of the modem DSP

MMoC Multimode Controller (MMoC) is a REX task responsible for facilitating the switch between different protocol modes

VS/VM/VR Voice Services/Voice Memo/Voice Recognition

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Protocols


WVS

AVS

MDSP

NAS

Broadcast services

WCDMA L1

WCDMA RLC

RRC

MM (MM/GMM)

GSDI

CNM(SS/CC/SMS)

CM

SM

MNREG

ADSP

BMC

DS

CSdata

PSdata

RABM

RR(RR/GRR)

DL

GSM L1

LLC

GPRS RLC

GPRS MAC

GPRS L1

WMS

CBTC

WCDMA MAC

GSMMDSP

WCDMAMDSP

GSTK

General services

UIM

Operating System (REX)

DLOAD

DIAG



Bluetooth


DSP services(QDSP)

TMC

USB services

Drivers

SIO

BIO

BOOT


ADC


SBI

THERM

Battery Drivers(VBATT)

RF

I2C

DOG

HS







GSM GPRS WCDMA

Qcamera/Qcamcorder

services

HW accelerator

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Air Interface Protocols

GSM

RR/GRR GERAN Radio Resource

LLC Logical Link Control (GPRS)

GPRS RLC Radio Link Control (GPRS)

GPRS L1 GPRS physical layer

GPRS MAC Medium Access Control (GPRS)

L2 Data link layer

L1 GSM physical layer

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Air Interface Protocols (cont.)

WCDMARRC Radio Resource Controller

L2 Comprised of RLC and MAC

L1 Physical layer (ENC/MOD/SRCH/DECOD/DMOD)

UMTS NAS

MN Mobile Network

CNM (SS/CC/SMS) Connection Manager (Supplementary Services, Call Control and Short Message Service)

REG Registration

SM Session Management

RABM Radio Access Bearer Manager

MM (MM/GMM) Mobility Management/GPRS Mobility Management

GSDI Generic SIM Driver Interface

GSTK Generic SIM Toolkitxia

miao

fang-lo

ngchee

rtel.c

om

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Multimedia and Audio/Voice Services


WVS

AVS

MDSP

NAS

Broadcast services

WCDMA L1

WCDMA RLC

RRC

MM (MM/GMM)

GSDI

CNM(SS/CC/SMS)

CM

SM

MNREG

ADSP

BMC

DS

CSdata

PSdata

RABM

RR(RR/GRR)

DL

GSM L1

LLC

GPRS RLC

GPRS MAC

GPRS L1

WMS

CBTC

WCDMA MAC

GSMMDSP

WCDMAMDSP

GSTK

General Services

UI<


DLOAD

DIAG



Bluetooth


DSP services(QDSP)

TMC

USB services

Drivers

SIO

BIO

BOOT


ADC


SBI

THERM


RF

I2C

DOG

HS







GSM GPRS WCDMA

Qcamera/Qcamcorder

services

HW accelerator

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Multimedia and Audio/Voice Services (cont.)

Modules DescriptionQcamera™ Camera services

Qcamcorder™ Camcorder services

Qtv™ MediaPlayer™

QVT Voice Telephony

Graphics (2D/3D) 2D/3D Graphics

AVS/sound server Audio and Vocoder Services

CMX Compact Multimedia Extension

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

BREW/JAVA


WVS

AVS

MDSP

NAS

Broadcast services

WCDMA L1

WCDMA RLC

RRC

MM (MM/GMM)

GSDI

CNM(SS/CC/SMS)

CM

SM

MNREG

ADSP

BMC

DS

CSdata

PSdata

RABM

RR(RR/GRR)

DL

GSM L1

LLC

GPRS RLC

GPRS MAC

GPRS L1

WMS

CBTC

WCDMA MAC

GSMMDSP

WCDMAMDSP

GSTK

General Services

UIM


DLOAd

DIAG



Bluetooth


DSP services(QDSP)

TMC

USB services

Drivers

SIO

BIO

BOOT


ADC


SBI

THERM


RF

I2C

DOG

HS







GSM GPRS WCDMA

Qcamera/Qcamcorder

services

HW accelerator

QVM

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

3GUI and Applications Architecture

Applicationexecutionenvironment(BREW +QCT extensions)

OEM layer

DMSS/AMSS API

DMSS/AMSS SW

IGraphicsIDisplay ISoundICM IVR IBT IPosDet INetMgr/

ISocket

IMedia/IMediaMgr

IDBMgr/IDBRecord

IControl

ISTK IFile/IFileMgr

IAddrBook

ITAPI

IMenuCtl ...IDialog

IShell

Applications

BREW OEM

Core PB SMS PureVoice

BTGPS MediaPlayer CAT

MMS Browser

Camera/camcorder

DMSS/AMSS software

CM WMS PDSM SND NV . . .

IWMS

Dialer Videophone

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

BREW

BREW is an application execution environment – Generic framework for developing applications

Developed specifically for wireless devicesUsable with other devices (not limited to AMSS)

Application – Self-executable binary, dynamically loaded (in EFS) or statically linked (within device software)

For example: MediaPlayer, camera, dialer, etc.Standard BREW interfaces (“AEE level interfaces”) offer services to applications

For example: IShell, IApplet, IMenuCtl, IDisplay, IGraphics, IFont, etc.

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

BREW Extensions

Extensions are nonstandard custom interfaces.QCT extensions are additional interfaces (that are not a part of BREW), developed by QCT. QCT extensions consist of interfaces that enable OEM software to invoke AMSS APIs that are not exposed by BREW, e.g., ICard, ICM, IWMS, IVideophone, etc.Customers can add their own interfaces or add extensions to existing interfaces.

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

BREW OEM Layer

Device-independent calls from BREW are mapped to device-dependent calls in the OEM layer, i.e., the implementation of OEM_Malloc() calls the heap manager functions

Reference implementations of these functions are provided by QUALCOMMAll files can be modified; for AMSS releases, BREW is already integrated and tested, so normally ~20% needs to be changed (e.g., file system, heap, display, etc.)

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

REX (Real Time Executive)

REX is a simple, efficient, pre-emptible, multitasking real-time operating system, that provides all necessary features.REX uses less than 5 K of ROM.REX RAM usage is based on the number of tasks running in the system plus a few kilobytes of state data and stack space.Single-process, multiple-threaded model; everything runs in Supervisor mode.

Compact and efficientEverything is implementable and all optimizations are possibleNo clean separation – Tight couplingLimited scalabilitySecurity issues

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

L4 Microkernel and Iguana

Multiple-process, multiple-threaded modelOnly kernel runs in Supervisor mode; everything else runs in User mode

Better scalability than REXBetter security than both REX and monolithic kernel

Iguana extends L4 to provide a set of building blocks that offer a minimal operating system personality

Address space layoutInternal and external spacesThread managementProtection domains (PD)Memory sections

REX emulation layer is supported on L4/Iguanaxia

miao

fang-lo

ngchee

rtel.c

om

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Diagnostics

DIAG provides a server-client mechanism for exchanging diagnostic information with AMSS.Services provided by DIAG include:

Transport service for diagnostic packetsGeneral purpose loggingprintf style debuggingStatic event reporting

DIAG is a REX task that handles requests from an external client, typically over serial port or over USB.Whenever a client wants to get data from DIAG, it sends a request to DIAG. Some packets, such as logs, are streamed out without the client explicitly requesting them.Tools like QPST, QXDM, CAIT all communicate through DIAG services.

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Multi-image and Secure Boot

Secure boot refers to a startup sequence in the processor that:Is immutableValidates the source of the code image via cryptographic authenticationInitializes the chip into a known security state

Secure boot protects against reflashing attacksSecure boot is based on a multiple-stage process

Immutable Primary Boot Loader (PBL)More complex/device-specific Secondary Boot Loader (SBL)PBL→QCSBL→OEMSBL→AMSS

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Data Services Architecture

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

AMSS Operation – Idle and Sleep

During Idle mode, a timeline is followed depending on the page monitoring method used for a specific technology (1X follows SCIsetting, UMTS follows the DRX Cycle, and GSM follows BS_PA_MFRMS setting). If no other tasks require the ARM (a voting mechanism is utilized), it will turn portions of the MSM off and switch to a slow clock to operate in Low Power mode. The slower clock has enough resolution to power on at the right time to enable the clock to switch back to TCXO and perform page monitoring as needed.Deep Sleep – If no system is acquired, a mode called Deep Sleep is entered. In this mode, the mobile wakes up occasionally (in the order of tens of minutes) in between system acquisition attempts. This is controlled by SD module.

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Licensee Responsibility


WVS

AVS

MDSP

NAS

Broadcast services

WCDMA L1

WCDMA RLC

RRC

MM (MM/GMM)

GSDI

CNM(SS/CC/SMS)

CM

SM

MNREG

ADSP

BMC

DS

CSdata

PSdata

RABM

RR(RR/GRR)

DL

GSM L1

LLC

GPRS RLC

GPRS MAC

GPRS L1

WMS

CBTC

WCDMA MAC

GSMMDSP

WCDMAMDSP

GSTK

General Services

UIM


DLOAD

DIAG



Bluetooth


DSP services(QDSP)

TMC

USB services

Drivers

SIO

BIO

BOOT


ADC


SBI

THERM


RF

I2C

DOG

HS







GSM GPRS WCDMA

Qcamera/Qcamcorder

services

HW accelerator

QVM

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Licensee Responsibility (cont.)

UI/applications development Drivers – Related to customer-specific hardware components (LCDs, keypad, Flash, RAM, EFS, camera sensor, other peripherals and GPIOs, RF – Antenna switch control, RF init, audio paths)Tools – QPST configuration toolCarrier customizationIntegration testingProduct testGCF/PTCRB testingInteroperability testField test xia

miao

fang-lo

ngchee

rtel.c

om

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

API Examples~

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

General Theory of Operation

Interfaces can be divided into two categoriesRequest – Provided by the API and called by client applications; there are two types of requests– Synchronous – AsynchronousCallback – Provided by clients and called by API; the different types of callback functions are:– Command callback– Other clients’ command-error callback– Event callback– User-function callback

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Synchronous RequestGeneral Theory of Operation (cont.)

The client task blocks until the processing of the request is complete. The function returns with the result of the request and error codes, if any.

Client calls synchronous API function

Client application

User API library

API

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Asynchronous Request

The client passes parameters (callback function pointer and user_data) to the request. The function returns a Boolean, which indicates whether or not the request was sent to CM.After the request is processed, the callback function is called and a status code is returned, indicating whether or not the request was completed successfully.

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Some Examples – CM~

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

CM

CM provides a set of stable APIs for client applications to access services provided by DMSS and AMSS software.CM provides interfaces for client applications to:

Set up and take down a callChange phone settings Notify client applications regarding:– Call and phone state/status change information – Messages received from the base station

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Example APIs – CM

Client (DS) Client (UI) Client (DIAG)Client (SMS) Client (SAT)

cdma2000® 1xEV CallP

CM

SoundNV/GSDISearcher

DB services

WCDMA/GSM/GPRS CallP

MMOC

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

CM – Client Initialization, Registration, and Activation

CMCommanding client

Registeredclients

Client initialization

Callback and event registration

for call group

Callback and event registration for phone group

cm_client_init( )

client_id_ptr = &ui_client_idclient_type = CM_CLIENT_TYPE_UI

cm_mm_client_call_reg( )client_id = ui_client_id

call_event_func = ui_cm_call_event_func

event_reg_type = CM_CLIENT_EVENT_REGfrom_call_event = CM_CALL_EVENT_ORIG

to_call_event = CM_CALL_EVENT_INFOcall_cmd_err_func = ui_cm_call_cmd_err_cb

cm_client_ph_reg( )client_id = ui_client_id

ph_event_func = ui_cm_ph_event_func

event_reg_type = CM_CLIENT_EVENT_REGfrom_ph_event = CM_PH_EVENT_OPRT_MODE

to_ph_event = CM_PH_EVENT_INFOph_cmd_err_func = ui_cm_ph_cmd_err_cb

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

CM – Client Initialization, Registration and Activation (cont.)

Clients Commanding client CM

cm_ph_cmd_subscription_available()

ui_cm_ph_event_func( )

event=CM_PH_EVENT_SUBSCRIPTION_AVAILABLE

If SIM verification

passes

Activation of callbacks

cm_client_act( )client_id = ui_client_id

Registered commanding

client

ui_cm_ph_event_func( )event=CM_PH_EVENT_INFO_AVAIL

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Example – Mobile Originated Call – Accepted

Registeredclients

Commandingclient CM

ph_event_func ( )event = CM_PH_EVENT_IN_USE_STATE

info-> is_in_use = TRUE

cm_mm_call_cmd_orig(...)callback = cmd_cb_func

call_id = &Call_ID

cmd_cb_func ( )cmd = CM_CALL_CMD_ORIG

status = CM_CALL_CMD_ERR_NOERR

mm_call_event_func ( )event = CM_CALL_EVENT_ORIGinfo->call_type= CM_CALL_TYPE_VOICE

event = CM_CALL_EVENT_CONNECT

*call_id = Call_ID used for this call

mm_call_event_func ( )


mm_call_event_func ( )event = CM_CALL_EVENT_CALL_CONF

event = CM_CALL_EVENT_PROGRESS_INFO_IND

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Example – Call Hold/Call Wait

event = CM_CALL_EVENT_SETUP_IND

cm_mm_call_cmd_setup_res()accept = TRUE

event = CM_CALL_EVENT_INCOM

cm_mm_call_cmd_sups()

event = CM_CALL_EVENT_MNG_CALLS_CONF

event = CM_CALL_EVENT_CONNECT

Place active call A-B on hold,

accept incoming call C

sups_type = CM_CALL_SUPS_TYPE_HOLD_CALL

Call-established state, A-B call active

CMRegistered

clientsCommanding

clients





xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Example – ActivateSS

cm_sups_cmd_activate()

sups_event_cb_func

CMRegistered clients

Commanding clients

event = CM_SUPS_EVENT_ACTIVATE

sups_event_cb_funcevent = CM_SUPS_EVENT_ACTIVATE_CONF

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Some Example APIs – WMS~

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

WMS

Wireless Messaging Service (WMS) provides APIs for multiple clients/applications to access SMS, EMS, and broadcast messagingservices

Register clients and callback functionsSend, receive, and acknowledge SMS/EMS messagesManage messages in memory storesManage message settingsReceive cell broadcast messagesManage cell broadcast filtering settingsTranslate messages between various formatsIssue debug commands and receive debug events

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

WMS Overview Diagram

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

WMS Initialization and Configuration

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

WMS – SMS Message Receive

Client WMS API

msg_event_cb( )event=WMS_MSG_EVENT_ACK

transaction_id=2

cmd_cb( )cmd_err=WMS_CMD_ERR_NONE

wms_msg_ack( )transaction_id=2cmd_cb=cmd_cb

msg_event_cb(event, &msg_event_info)event=WMS_MSG_EVENT_ACK

transaction_id=1

cmd_err=WMS_CMD_ERR_NONEcmd_cb( )

wms_msg_ack( )transaction_id=1cmd_cb=cmd_cb

msg_event_cb( )

event=WMS_MSG_EVENT_RECEIVED_MESSAGEtransaction_id=2

memory_store=NONE

msg_event_cb( )

event=WMS_MSG_EVENT_RECEIVED_MESSAGEtransaction_id=1

memory_store=NONE

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

WMS – SMS Message Send

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

SMS CB Reception (GERAN)

WMS CB L2 GSM L1WMSAPP GERAN

SKIP Request

Remaining 3 CB Blocks

CB uses the pgaeheader in the firstblock to check forduplicate page andMessage Identifernot in Search List

1

2

3

4

5

If Duplicate Page is recieved orMessage ID not present in Search List

Delivers the SMS-CB Message toWMSAPP to notify the user

CB assembles anSMS-CB pagefrom 4 blocks

SMS-CB Block

Base Station sends a SMS Cell Broadcast Page

SMS-CB Block

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

References

Ref. Document

Qualcomm

Q1 Application Note: Software Glossary for Customers CL93-V3077-1

xiam

iaofa

ng-longch

eerte

l.com

2008

.05.27

at 01

:34:

27 P

DT


80-VH700-1 B Mar 2008

Questions?

https://support.cdmatech.comxia

miao

fang-lo

ngchee

rtel.c

om

2008

.05.27

at 01

:34:

27 P

DT

https://support.cdmatech.com/

https://support.cdmatech.com/

xiamiaofang-longcheertel.com2008.05.27 at 01:34:27...

Documents