View
1
Download
0
Category
Preview:
Citation preview
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
Page 280-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 380-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 480-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 580-VH700-1 B Mar 2008
Introduction~
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
Page 680-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 780-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 880-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 980-VH700-1 B Mar 2008
OS and Common Software
BREWapi + QCT extensions
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
Buffer management (DSM)
Bluetooth
Interrupt services (TRAMP)
DSP services(QDSP)
TMC
USB services
Drivers
SIO
BIO
BOOT
Time services(CLOCK)
ADC
MSM drivers(CLKREGIM, HW)
SBI
THERM
Battery drivers(VBATT)
RF
I2C
HS
Audio/voice services
Core UI Phone book SMS Pure
VoiceBTGPS MediaPlayer CAT MMSBrowserCamera/
camcorderDialer Videophone
Sound Sockets EFS/NV PBM PD (GPS)CMX API Voice API
GSM – MAP protocols
GSM GPRS WCDMA
Qcamera/Qcamcorder
services
HW accelerator
NV and File System (NV/EFS)
DOG
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
Page 1080-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 1180-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 1280-VH700-1 B Mar 2008
Drivers
BREWapi + QCT extensions
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
Buffer management (DSM)
NV and File System (NV/EFS)
Bluetooth
Interrupt services (TRAMP)
DSP services(QDSP)
TMC
USB services
Drivers
SIO
BIO
BOOT
Time services(CLOCK)
ADC
MSM drivers(CLKREGIM, HW)
SBI
THERM
Battery drivers(VBATT)
RF
I2C
DOG
HS
Audio/voice services
Core UI Phone book SMS Pure
VoiceBTGPS MediaPlayer CAT MMSBrowserCamera/
camcorderDialer Videophone
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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 1380-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 1480-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 1580-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 1680-VH700-1 B Mar 2008
APIs and Services
BREWapi + QCT extensions
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
Buffer management (DSM)
NV and File System (NV/EFS)
Bluetooth
Interrupt services (TRAMP)
DSP services(QDSP)
TMC
USB services
Drivers
SIO
Bit Input/Output(BIO)
BOOT
Time services(CLOCK)
ADC drivers (ADC)
MSM drivers(CLKREGIM, HW)
SBI
THERM
Battery drivers(VBATT)
RF
I2C
DOG
HS
Audio/voice services
Core UI Phone book SMS Pure
VoiceBTGPS MediaPlayer CAT MMSBrowserCamera/
camcorderDialer Videophone
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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 1780-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 1880-VH700-1 B Mar 2008
Protocols
BREWapi + QCT extensions
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
Buffer management (DSM)
NV and File System (NV/EFS)
Bluetooth
Interrupt services (TRAMP)
DSP services(QDSP)
TMC
USB services
Drivers
SIO
BIO
BOOT
Time services(CLOCK)
ADC
MSM drivers(CLKREGIM, HW)
SBI
THERM
Battery Drivers(VBATT)
RF
I2C
DOG
HS
Audio/voice services
Core UI Phone book SMS Pure
VoiceBTGPS MediaPlayer CAT MMSBrowserCamera/
camcorderDialer Videophone
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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 1980-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 2080-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 2180-VH700-1 B Mar 2008
Multimedia and Audio/Voice Services
BREWapi + QCT extensions
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<
Operating system (REX)
DLOAD
DIAG
Buffer management (DSM)
NV and File System (NV/EFS)
Bluetooth
Interrupt services (TRAMP)
DSP services(QDSP)
TMC
USB services
Drivers
SIO
BIO
BOOT
Time services(CLOCK)
ADC
MSM drivers(CLKREGIM, HW)
SBI
THERM
Battery drivers(VBATT)
RF
I2C
DOG
HS
Audio/voice services
Core UI Phone book SMS Pure
VoiceBTGPS MediaPlayer CAT MMSBrowserCamera/
camcorderDialer Videophone
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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 2280-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 2380-VH700-1 B Mar 2008
BREW/JAVA
BREWapi + QCT extensions
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
Buffer management (DSM)
NV and File System (NV/EFS)
Bluetooth
Interrupt services (TRAMP)
DSP services(QDSP)
TMC
USB services
Drivers
SIO
BIO
BOOT
Time services(CLOCK)
ADC
MSM drivers(CLKREGIM, HW)
SBI
THERM
Battery drivers(VBATT)
RF
I2C
DOG
HS
Audio/voice services
Core UI Phone book SMS Pure
VoiceBTGPS MediaPlayer CAT MMSBrowserCamera/
camcorderDialer Videophone
Sound Sockets EFS/NV PBM PD (GPS)CMX API Voice API
GSM – MAP protocols
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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 2480-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 2580-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 2680-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 2780-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 2880-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 2980-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 3080-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 3180-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 3280-VH700-1 B Mar 2008
Data Services Architecture
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
Page 3380-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 3480-VH700-1 B Mar 2008
Licensee Responsibility
BREWapi + QCT extensions
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
Buffer management (DSM)
NV and File System (NV/EFS)
Bluetooth
Interrupt services (TRAMP)
DSP services(QDSP)
TMC
USB services
Drivers
SIO
BIO
BOOT
Time services(CLOCK)
ADC
MSM drivers(CLKREGIM, HW)
SBI
THERM
Battery drivers(VBATT)
RF
I2C
DOG
HS
Audio/voice services
Core UI Phone book SMS Pure
VoiceBTGPS MediaPlayer CAT MMSBrowserCamera/
camcorderDialer Videophone
Sound Sockets EFS/NV PBM PD (GPS)CMX API Voice API
GSM – MAP protocols
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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 3580-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 3680-VH700-1 B Mar 2008
API Examples~
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
Page 3780-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 3880-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 3980-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 4080-VH700-1 B Mar 2008
Some Examples – CM~
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
Page 4180-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 4280-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 4380-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 4480-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 4580-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 ( )
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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 4680-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
mm_call_event_func ( )
mm_call_event_func ( )
mm_call_event_func ( )
mm_call_event_func ( )
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
Page 4780-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 4880-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 4980-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 5080-VH700-1 B Mar 2008
WMS Overview Diagram
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
Page 5180-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 5280-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 5380-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 5480-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 5580-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
Qualcomm Confidential and ProprietaryMAY CONTAIN U.S. EXPORT CONTROLLED INFORMATION
Page 5680-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
Recommended