ii Table of Contents
PDA Personal Portable System Manager
Programmer’s Manual
3.1 PPSM Initialization and Applications Integration . . . . . . . . . . . . . . . .3-1
PPSM Initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-1
Task Registration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
3.2 PPSM Application Programming . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Active Area Registration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
Messages fr om PPSM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
3.3 Data Representation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
3.4 Naming Convention . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
Constants and La bels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
Local Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
Global Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3- 6
Local Pointer Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
Global Pointer Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-6
Part II
Writing
PPSM
Applications
Chapter 4 Pen Input Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-1
4.1 Active Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
Icon Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
Input Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
4.2 Creating an Active Area. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
4.3 Removing an Active Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
4.4 Suspending an Active Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
4.5 Acti v e Area Enquiry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
4.6 Put Active Area to Front of List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
4.7 Pen Echoing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
4.8 Pen Color and Pe n Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4- 4
4.9 Creating a Control Active Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
4.10 Removing a Control Active Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6
4.11 Push Active Area List into Background . . . . . . . . . . . . . . . . . . . . . . . 4-6
4.12 Pop Active Area List to Foreground . . . . . . . . . . . . . . . . . . . . . . . . . .4-6
Personal
Portable
System
Manager
Motorola Semiconductor Products Sector
Freescale Semiconductor, I
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
nc...
Copyright 1995-1999 by Motorola, Inc.
Produced by DragonBall Operation, WSSG, Motorola
Fax: (852) 2666-6551
Email: portable@email.sps.mot.com
Website: http://www.apspg.com/products/ppsm/ppsm.html
Document Number PPSM Version Release Date Comment
PDAPSM01U18-10 2.0 November 15, 1995
PDAPSM01U18-11 2.1 May 13, 1996 Addendum to PPSM V2.0
PDAPSM03SPM1-10 3.0 March 5, 1997
PDAPSM03SPM1-11 3.1 November 15, 1998
PDAPSM03SPM1-12 3.11 Apirl 20, 1999
Motorol a reserves the r ight to mak e any modific ations or updates to this p roduct or any c omponent
thereof for any reason whatsoever without fur ther notice to anyon e. Motorola does not as sume any
liability arising out of the application or use of this product nor any component thereof; neither does it
convey no r license un der its patent rights or c opyrights nor the patent rights or copy rights of oth ers
all or any portion of this product. Motorola products are not designed, intended, or authorized for use
as compo nen ts in sy st ems in tend ed for s urgic al imp la nt in to the body, other applic ations in tend ed to
suppor t or sustain life, or for any other applic ation in which the failure of the Mo torola prod uct could
create a situation where personal injury or death may occur. Should Buyer purchase or use Motorola
products for such unintended or unauthorized application, Buyer shall indemnify and hold M otorola
and its officers, employees, subsidiaries, affiliates, and distributors harmless against all claims,
costs, damages, and expenses, and reasonable attorney fees arising out of, directly or indirectly , any
claim of personal injury o r death ass ociated wi th such uni ntended or unau thorize d use, even i f such
claims alleges that Motorola was negligent regarding the design or manufacture of the part. Motorola
and are registered trademarks of Motorola, Inc. All Rights Reserved.
PDA Personal Portable System Manager
Programmer’s Manual
Table of Contents i
Table of Cont ents
Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . i
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xvii
Part I
PPSM
Architecture
Chapter 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
1.1 What is PPSM? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-1
1.2 Strengt hs and Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1- 2
1.3 Software Deve lopment Environment . . . . . . . . . . . . . . . . . . . . . . . . .1-3
1.4 Hardware Developm ent Environme n t . . . . . . . . . . . . . . . . . . . . . . . . .1-3
Chapter 2 PPSM System Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
2.1 Interrupt Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-1
2.2 Error Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-2
2.3 I/O Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-2
Pen Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-3
Screen Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-4
Hardware Curs or . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2- 4
2.4 Data Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-4
2.5 Font Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-5
2.6 Memory Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-5
2.7 Power Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-5
Direct Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-6
Automatic Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-6
2.8 Task Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-6
PPSM Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-6
Application State Transition . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-7
Task Swapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-8
2.9 Timer Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-8
Chapter 3 PPSM Programming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Freescale Semiconductor, I
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
nc...
vi Table of Contents
PDA Personal Portable System Manager
Programmer’s Manual
11.2 Power Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-2
11.3 System Internal Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-2
Initialization Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-3
System Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-3
Wake-up Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-3
11.4 Appli cation Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-3
Normal Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-4
Doze Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-4
Sleep Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-5
11.5 Power Management Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-6
Setting Duty Cycle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-6
Setting Doze Period . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-6
Setting Sleep Period . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-6
Going Into Doze Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-7
Going Into Sleep Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-7
11.6 I/O Ports Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-7
Disabli ng I/O Port Before Doze Mode . . . . . . . . . . . . . . . . . . . . 11-7
Enabling I/O Port After Doze Mode . . . . . . . . . . . . . . . . . . . . . . 11-7
Disabli ng I/O Port Before Sleep Mode . . . . . . . . . . . . . . . . . . . .11-7
Enabling I/ O Port Af ter Sleep Mode . . . . . . . . . . . . . . . . . . . . . . 11-8
Chapter 12 12-1
Chapter 13 UART Communication Support . . . . . . . . . . . . . . . . . . . . . .12-3
13.1 UART Communication Architecture . . . . . . . . . . . . . . . . . . . . . . . . .12-3
UART hardware flow control . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-3
UART Interface Constraints . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-4
UART Interface Interrupt Message . . . . . . . . . . . . . . . . . . . . . . . 12-9
13.2 UART Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-9
Configuring the UART . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-10
Inquiri ng the UART Configurations . . . . . . . . . . . . . . . . . . . . . . 12-11
Setting Data Transmission Time Out . . . . . . . . . . . . . . . . . . . . 12-11
Setting Data Transmission Delay . . . . . . . . . . . . . . . . . . . . . . . 12-11
13.3 Sending Data to the UART . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12-12
Initiating a Send Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12-12
Terminating a Send Request . . . . . . . . . . . . . . . . . . . . . . . . . . 12-13
13.4 Receiving Data from the UART . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-13
Initi a ting a Receive Request . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-14
Reading Received Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-14
Terminating a Receive Request . . . . . . . . . . . . . . . . . . . . . . . . 12-14
Setting Data Reception Time Out . . . . . . . . . . . . . . . . . . . . . . . 12-15
PDA Personal Portable System Manager
Programmer’s Manual
Table of Contents iii
Chapter 5 Character Input Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1
5.1 Soft Keyboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-1
Starting Soft Keyboard Charact e r Input . . . . . . . . . . . . . . . . . . . .5-2
Auto-Key -Repeat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-3
Terminating Soft Keyboard Charac ter Input . . . . . . . . . . . . . . . . .5-3
Suspend Soft Keyboard Character Input . . . . . . . . . . . . . . . . . . .5-3
5.2 Handwriting Recognition Input Pad . . . . . . . . . . . . . . . . . . . . . . . . . .5-4
The Input Pad Mechanism . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-5
Starting Handwriting Character Input . . . . . . . . . . . . . . . . . . . . . .5-5
Terminating Handwriting Character Input . . . . . . . . . . . . . . . . . . .5-6
Chapter 6 Using Graphics Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1
6.1 Displ ay Screen Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-2
LCD Display Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6- 2
Panning Disp lay Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-3
6.2 Screen Ini tiali z ation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-3
LCD Display Screen in rel ation to the Touch Panel . . . . . . . . . . .6-3
Screen Resolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-4
6.3 Sample LCD Display Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-4
6.4 1 bit-per-pixel Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-5
Drawing Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-6
6.5 2 bits- per-pixel Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-7
Drawing Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-7
6.6 Graphics Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-10
6.7 Get LCD Display Screen Width . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-11
6.8 Get LCD Display Screen Height . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-11
6.9 Get Panning Scre en Width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-12
6.10 Get Panning Screen Height . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-12
6.11 Set Pattern Fill . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-12
6.12 Set Dot Width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-13
6.13 DisplayMove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-13
6.14 Direct All Gr aphics Output to off-screen memory . . . . . . . . . . . . . . .6- 1 3
6.15 Change Panning Scree n Parameters . . . . . . . . . . . . . . . . . . . . . . . .6-14
6.16 Fill the whole Panning Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-17
6.17 Draw a Dot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-17
6.18 Draw a Horizontal Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-19
6.19 Draw a Vertical Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6- 2 0
Freescale Semiconductor, I
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
nc...
iv Table of Contents
PDA Personal Portable System Manager
Programmer’s Manual
6.20 Draw a Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-22
6.21 Draw a Rectangle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-23
6.22 Draw a Circle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-25
6.23 Draw an Ellipse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-26
6.24 Draw an Arc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-27
6.25 Draw a Vector from a List of Points . . . . . . . . . . . . . . . . . . . . . . . . . 6-30
6.26 Put a Rectangular Area on Panning Screen . . . . . . . . . . . . . . . . . . 6-30
Special cases of PutRec() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-31
6.27 Save a Rectangular Area from Panning Screen . . . . . . . . . . . . . . . 6-33
6.28 Exchange a Rectangular area with memory . . . . . . . . . . . . . . . . . . 6-33
6.29 Fill a Rectangular Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-34
6.30 Inverse a Rectangular Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-34
6.31 Hardware Cursor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-35
Set Hardware Cursor Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-35
Set Hardware Cursor Position . . . . . . . . . . . . . . . . . . . . . . . . . . 6-36
Set Hardware Cursor Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-36
Get Hardware Cursor Status . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-36
Set Hardware Cursor Blinking Frequency . . . . . . . . . . . . . . . . .6-37
Turn Hardware Cursor Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-37
6.32 Display Other Region of Panning Screen . . . . . . . . . . . . . . . . . . . . .6-37
6.33 Get LCD Display Origin on Panning Screen . . . . . . . . . . . . . . . . . .6-37
6.34 Allocate memory for Panning Screen . . . . . . . . . . . . . . . . . . . . . . . . 6-38
Chapter 7 Database Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-1
7.1 Data Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1
Formatted Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1
Unformatted Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2
7.2 The Database Manipul ation Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2
7.3 Creating and Editing a Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3
7.4 Searching and Retri e ving Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7- 4
7.5 Navigating along a Record List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4
Chapter 8 Text Display Management . . . . . . . . . . . . . . . . . . . . . . . . . . .8-1
8.1 Text Representation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1
8.2 Text Display Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1
8.3 Text Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2
PDA Personal Portable System Manager
Programmer’s Manual
Table of Contents v
Creating text templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-2
Deleting text templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-3
8.4 Text Proper ties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-3
Setting Text Display Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-3
Setting Text Outlook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-3
Setting Font Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-4
8.5 Text Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-7
Displaying text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-7
Removing text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-7
8.6 Text char acter cursor position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-8
Setting the character cursor position . . . . . . . . . . . . . . . . . . . . . .8-8
Reading the character cursor position . . . . . . . . . . . . . . . . . . . . .8-8
Chapter 9 Timer Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-1
9.1 Reading System Date and Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-1
9.2 Setting System Date and Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-1
9.3 Reading Clock Alarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-1
9.4 Setti ng Clock Alarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-2
9.5 Cleari ng Clock Alarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-2
9.6 Setti ng Periodic Alarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-2
9.7 Setti ng Timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9- 3
9.8 Setti ng Input Timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9- 3
9.9 Continuous Reference Ti mer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-4
9.10 Read The Reference Timer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-4
9.11 Set Reference Timer Alarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-4
9.12 Compute Reference Times Differences . . . . . . . . . . . . . . . . . . . . . . .9-4
Chapter 10 Memory Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1
10.1 Allocating Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-1
10.2 Freeing Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-1
10.3 Reall o cating Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-2
10.4 Copying Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-2
10.5 Inquiring Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-2
Chapter 11 Power Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1
11.1 Power Control Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-1
Freescale Semiconductor, I
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
nc...
xTable of Contents
PDA Personal Portable System Manager
Programmer’s Manual
21.3 ClearRec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-4
21.4 ClearScreen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-5
21.5 CursorGetOrigin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20-5
21.6 CursorGetPos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-6
21.7 CursorGetStatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-7
21.8 CursorInit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-7
21.9 CursorOff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-8
21.10 CursorSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-8
21.11 CursorSetBlink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-9
21.12 CursorSetOrigin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-10
21.13 CursorSetPos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-10
21.14 CursorSetStatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20-11
21.15 DisplayMove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-12
21.16 DrawArc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-13
21.17 DrawCircle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-13
21.18 DrawDot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-14
21.19 DrawEllipse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-15
21.20 DrawHorz . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-16
21.21 DrawLine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-17
21.22 DrawRec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-18
21.23 DrawVector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-19
21.24 DrawVert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-20
21.25 ExchangeRec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-21
21.26 GetDisplayX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-22
21.27 GetDisplayY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-23
21.28 GetLogicalX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20-23
21.29 GetLogicalY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20-24
21.30 GetScreenMem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-24
21.31 InvRec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-25
21.32 LCDContrast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-26
21.33 LCDRefresh Rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20-27
21.34 LCDScreenMove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-27
PDA Personal Portable System Manager
Programmer’s Manual
Table of Contents vii
13.5 UART hardware flow control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12-15
Enabling RTS/CTS hardware flow control . . . . . . . . . . . . . . . .12-15
Disabling RTS/CTS hardware flow control . . . . . . . . . . . . . . . .12-15
13.6 Data reception with hardware flow control . . . . . . . . . . . . . . . . . . .12-16
Pause data reception . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12-16
Continue data reception . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12-16
13.7 Data tran smission with hardware flow control . . . . . . . . . . . . . . . .12-16
Pause data transmission . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12-16
Continue data transmission . . . . . . . . . . . . . . . . . . . . . . . . . . .12-17
Chapter 14 Task Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1
14.1 Main Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-1
System Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-1
14.2 Sub-task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-2
Sub-task Manag ement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-3
14.3 Task Switching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-3
14.4 Message Broadcasting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-4
14.5 Task Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-4
14.6 Task Swapping Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-5
14.7 Creating a Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-6
14.8 Creating a Task with Specific Task Parameters . . . . . . . . . . . . . . . .13-6
14.9 Creating a Sub Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-7
14.10 Starting a Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-7
14.11 Terminati on of a Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-8
14.12 Task Reinitialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-8
14.13 Task Hook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-8
14.14 Stop task swapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-9
Chapter 15 Inter-Task Messaging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-1
15.1 Message Passing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14-1
With Delayed Task Swapping . . . . . . . . . . . . . . . . . . . . . . . . . . .14-2
With Immedia te Task Swapping . . . . . . . . . . . . . . . . . . . . . . . . .14-2
With Immediate Task Swapping and Delayed Swap Back . . . . .14-2
Message Passing without Task Swapping . . . . . . . . . . . . . . . . .14-3
15.2 Message Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14-3
15.3 Sending Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14-3
15.4 Advanced Sending Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14-4
Freescale Semiconductor, I
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
nc...
viii Tabl e of Contents
PDA Personal Portable System Manager
Programmer’s Manual
15.5 Deleting Message for Current Task . . . . . . . . . . . . . . . . . . . . . . . . . 14-4
15.6 Deleting Message for any Task . . . . . . . . . . . . . . . . . . . . . . . . . . . .14-4
15.7 Receiving Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14-4
Chapter 16 Interrupt Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15-1
16.1 System Interrupts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1
IRPT_AUDIO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-2
IRPT_PEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-2
IRPT_INPUT_STATUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15-2
IRPT_ICON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-3
IRPT_KEY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-4
IRPT_RTC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-5
IRPT_TIMER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-5
IRPT_HWR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-5
IRPT_UART . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-5
16.2 Device Interrupts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-5
User Defined Interrupt Handlers . . . . . . . . . . . . . . . . . . . . . . . . .15-6
Device In terrupt Ident ifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15-7
Application Access to Handlers . . . . . . . . . . . . . . . . . . . . . . . . . 15-7
Request and Release Interrupt Handl er Service . . . . . . . . . . . .15-7
16.3 Message Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-8
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-9
Chapter 17 Using System Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16-1
17.1 PPSM Initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16-1
Motorola Logo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-2
Chapter 18 Audio Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17-151
18.1 Audio Playing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-151
18.2 Tone playi ng . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17-151
18.3 Wave playing (DragonBa ll-EZ only) . . . . . . . . . . . . . . . . . . . . . . .17-152
18.4 Stop the audio playi ng . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17-153
Part III
API Toolset
Chapter 19 Pen Input Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18-1
19.1 ActiveAreaDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1
PDA Personal Portable System Manager
Programmer’s Manual
Table of Contents ix
19.2 ActiveAreaEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18-1
19.3 ActiveAreaRead . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18-2
19.4 Acti v eAreaSuspend . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18- 3
19.5 Acti v eAreaToFront . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18-4
19.6 ActiveListPop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18-4
19.7 ActiveListPush . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18-5
19.8 AreaEchoDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18-6
19.9 AreaEchoEnabl e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18-6
19.10 ActiveAreaPosition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18-7
19.11 CtrlIconDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18-7
19.12 CtrlIconEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18-8
19.13 IconScanOff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18-9
19.14 IconScanOn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18-10
19.15 PenCalibration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18-10
19.16 PenEchoParam . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18-11
19.17 PenGetInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18-11
19.18 PenSetInputMax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18-12
19.19 PenSetInputOrg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18-13
19.20 PenSetRate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18-13
19.21 ScanningOff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18-14
19.22 ScanningOn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18-14
Chapter 20 Character Input Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1
20.1 AdvOpenInputPad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19-1
20.2 AdvOpenSoftKey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19-2
20.3 CloseInputPad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19-3
20.4 CloseSoftKey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19-4
20.5 OpenInputPad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19-5
20.6 OpenSoftKey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19-6
Chapter 21 Graphics Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-1
21.1 ChangePanning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20-1
21.2 ChangeWi ndow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20-3
Freescale Semiconductor, I
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
nc...
xiv Tabl e of Contents
PDA Personal Portable System Manager
Programmer’s Manual
28.4 TaskCreate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-4
28.5 TaskHook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-5
28.6 TaskReInit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-5
28.7 TaskStart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-6
28.8 TaskTerminate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-7
Chapter 29 Inter-Task Messaging Tools . . . . . . . . . . . . . . . . . . . . . . . . .28-1
29.1 AdvMessageDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28-1
29.2 AdvSend Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28-1
29.3 MessageDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28-3
29.4 SendMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28-3
Chapter 30 Interrupt Handling Tools . . . . . . . . . . . . . . . . . . . . . . . . . . .29-1
30.1 IrptGetData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29-1
30.2 IrptRelease . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29-3
30.3 IrptRequest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29-4
30.4 IrptSendData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29-6
Chapter 31 System Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30-1
31.1 PPSMInit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30-1
31.2 ReadSMVersion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30-3
Chapter 32 Audio Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31-1
32.1 AdvAudioPla yWave (DragonBall-EZ only) . . . . . . . . . . . . . . . . . . . .31-1
32.2 AudioInUse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31-2
32.3 AudioPl a yTone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31-2
32.4 AudioPlayWave (DragonBall-EZ only) . . . . . . . . . . . . . . . . . . . . . . . 31-3
32.5 AudioSt opTone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31-4
32.6 AudioStopWav e (D ragonBall-EZ onl y) . . . . . . . . . . . . . . . . . . . . . . .31-4
Part IV
System
Integrator’s
PDA Personal Portable System Manager
Programmer’s Manual
Table of Contents xi
21.35 PutChar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20-28
21.36 PutRec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20-29
21.37 SaveRec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20-30
21.38 SetDotWidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20-31
21.39 SetPatternFill . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20-31
Chapter 22 Database Management Tools . . . . . . . . . . . . . . . . . . . . . . . 21-1
22.1 DBAdd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-1
22.2 DBAddRecord . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-1
22.3 DBAddRecToTop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-2
22.4 DBAppendRecord . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-3
22.5 DBChangeStdData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-4
22.6 DBChangeUnfData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-5
22.7 DBDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-6
22.8 DBDeleteRecord . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-6
22.9 DBGetFirstRecID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-7
22.10 DBGetNextRecID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-8
22.11 DBGetPrevRecID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-8
22.12 DBReadData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-9
22.13 DBReadTotalNumbe r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-10
22.14 DBReadTotalNumbe rRecords . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-11
22.15 DBReadUnfData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-11
22.16 DBRecordSecr et . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-12
22.17 DBSearchData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-13
22.18 DBSecretFlag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-14
22.19 DBSetRecordSe cretFlag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-15
22.20 DBSetSecretFlag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-15
Chapter 23 Text Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-1
23.1 TextCreate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22-1
23.2 TextDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22-1
23.3 TextMap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22-2
23.4 TextReadCur sor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22-2
Freescale Semiconductor, I
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
nc...
xii Tabl e of Contents
PDA Personal Portable System Manager
Programmer’s Manual
23.5 TextSet Cursor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-3
23.6 TextSetDisplay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-4
23.7 TextSet Font . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22-5
23.8 TextSet Outlook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22-6
23.9 TextSetup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-7
23.10 TextUnmap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-9
Chapter 24 Timer Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23-1
24.1 AlarmClear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-1
24.2 AlarmClearId . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-1
24.3 AlarmRead . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-2
24.4 AlarmReadId . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-2
24.5 AlarmSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-3
24.6 AlarmSetId . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-4
24.7 DateTimeRead . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-5
24.8 DateTimeSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-6
24.9 DeleteTimer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-7
24.10 InputTimeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-7
24.11 RefFineTimeAlarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-8
24.12 RefFineTimeAlarmId . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-8
24.13 RefFineTimeDiff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-9
24.14 RefFineTimeRead . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-10
24.15 RefTimeAlarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-10
24.16 RefTimeAlarmId . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23-11
24.17 RefTimeDiff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-11
24.18 RefTimeRead . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23-12
24.19 SetPeriod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-12
24.20 SetPeriodId . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-13
24.21 Timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23-14
24.22 TimeoutId . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-15
Chapter 25 Memory Management Tools . . . . . . . . . . . . . . . . . . . . . . . . .24-1
25.1 Lcalloc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1
PDA Personal Portable System Manager
Programmer’s Manual
Table of Contents xiii
25.2 Lfree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24-1
25.3 Lmalloc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24-2
25.4 Lrealloc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24-3
25.5 MoveBlock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24-3
25.6 TaskMemUsed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24-4
25.7 TaskStackAvail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24-4
25.8 TotalMemSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24-5
25.9 TotalMemUsed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24-5
Chapter 26 Power Management Tools . . . . . . . . . . . . . . . . . . . . . . . . . . 25-1
26.1 SetDozeMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25-1
26.2 SetDozePeriod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25-1
26.3 SetDutyCycle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25-2
26.4 SetSleepMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25-3
26.5 SetSleepPeriod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25-3
Chapter 27 UART Communication Tools . . . . . . . . . . . . . . . . . . . . . . . 26-1
27.1 UARTConfigure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26-1
27.2 UARTFlowCtrl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26-3
27.3 UARTInquire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26-3
27.4 UARTRcvCtrl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26-4
27.5 UARTReadData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26-6
27.6 UARTReceive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26-6
27.7 UARTSend . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26-7
27.8 UARTSendAbort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26-8
27.9 UARTSendCtrl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26-9
27.10 UARTSetDelay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26-10
27.11 UARTTimeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26-11
Chapter 28 Task Handling Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-1
28.1 AdvTaskCreate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27-1
28.2 AppSwap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27-2
28.3 SubTaskCreate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27-3
Freescale Semiconductor, I
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
nc...
xviii
Personal Portable System Manager
Programmer’s Manual
PDA Personal Portable System Manager
Programmer’s Manual
Table of Contents xv
Guide
Chapter 33 How to make ROM? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32-1
33.1 Boot Strap Code (boot.s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32-1
68K Start-up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32-1
Chip Selects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32-3
Peripheral Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32-3
33.2 Linker Supplications File for ROM . . . . . . . . . . . . . . . . . . . . . . . . . .32-3
33.3 Generating S-Record Fil e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32-4
Loader Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32-4
Loader Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32-5
Chapter 34 Device Drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33-1
34.1 System Configuration Drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33-1
Boot Strap Driver (boot.s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33-1
User Interrupt Handler Installation Driver (irptdev.c) . . . . . . . . .33-1
34.2 Pen Inpu t Device Driver (pendev.c) . . . . . . . . . . . . . . . . . . . . . . . . .33-3
Pen Initializat ion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33-4
Pen Interrupt Enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33-5
Pen Interrupt Disable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33-6
Pen Read Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33-7
34.3 Pen Calibration(PenInit.c) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33-8
34.4 LCD Device Drivers (lcddev.s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33-8
1 bit/pixel Initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33-8
2 bits/pixel Initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33-9
34.5 Handwriting Recognition Engine Driver (hwr .c) . . . . . . . . . . . . . . . .33-9
Handwriting Recognition Engine Reset . . . . . . . . . . . . . . . . . . .33-9
Handwriti ng Recognition Engine Initia lization . . . . . . . . . . . . . .33-10
Process One Stroke o f Handwriting Input Data . . . . . . . . . . . .33-10
Initi a te Character Recogni tion for the Handwrit ing Input . . . . .33-11
34.6 Font Dri ver (font.c) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33-11
Font Library Informati on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33-12
Font Library or Font Generation Engine Initialization . . . . . . . .33-12
Font Accessi ng . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33-13
34.7 UART Device Driver (uartdev.c) . . . . . . . . . . . . . . . . . . . . . . . . . . .33-14
Sending the BREAK Character . . . . . . . . . . . . . . . . . . . . . . . . .33-14
34.8 Power Management Driver (i odev.c) . . . . . . . . . . . . . . . . . . . . . . .33-14
Enabling I/O ports when leaving from doze mode . . . . . . . . . .33-15
Disabling I/O port s when going to doze mode . . . . . . . . . . . . .33-15
Enabling I/O ports when leaving from sleep mode . . . . . . . . . .33-15
Freescale Semiconductor, I
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
nc...
xvi Tabl e of Contents
PDA Personal Portable System Manager
Programmer’s Manual
Disabling I/O port s when going to sleep mode . . . . . . . . . . . . . 33-16
Chapter 35 Linker Specification File . . . . . . . . . . . . . . . . . . . . . . . . . . . .34-1
35.1 .SPC File for a RAM-only System . . . . . . . . . . . . . . . . . . . . . . . . . .34-1
35.2 .SPC File for a ROM-RAM System . . . . . . . . . . . . . . . . . . . . . . . . . 34-2
35.3 For SingleStep Debugging System (SDS) user . . . . . . . . . . . . . . . . 34-2
Chapter 36 Trap Usage in PPSM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
36.1 PPSM Tools Calling Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
36.2 TRAP Implementation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Stub Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
TRAP Service Handler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Appendices
A Error Code Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1
B List of References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1
C Index of PPSM Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1
Personal Portable System Manager
Programmer’s Manual
xvii
What is PPSM?
Audience & Purpose
Part I
Part II
Part III
Part IV
Appendices
Preface
Personal Portable System Manager (PPSM) is a compact operating system
designed specifically for the DragonBallTM family of the micro-controllers. This
operating system enables most handheld electronic products with LCD displays
such as advanced pagers, advanced cellular phones, game machines, GPS,
instruments, organizers, and Personal Digital Assistants (PDA).
The first three parts of this manual are oriented to those software engineers want-
ing to learn the important "rules" of PPSM programming. Each chapter concen-
trates on a specific aspect of the PPSM Application Programming Interface (API).
The forth part of this manual is oriented to system integrators who are responsible
for building and configuring PPSM systems.
"PPSM Architecture" describes the PPSM environment and architecture.
"Writing PPSM Applications" concentrates on the features supported by PPSM for
application development. Examples are given to better illustrate the methodology.
This part is targeted particularly to beginners who are exploring the use of PPSM
tools. Therefore, the tools in each chapter are arranged in the suggested order of
tools for writing PPSM applications.
"API Toolset" details the usage of each of the tools. This part is targeted particu-
larly to those experienced engineers who are familiar with the PPSM program-
ming methodology. Therefore, the tools in each chapters are arranged in
alphabetical order for quick referencing.
"System Integrator’s Guide" focuses on assisting the system integrators to build
and configure PPSM system by providing the necessary background information.
At the end of the manual, "Appendices" is included to supple