Motorola T720 CDMA Instruction Manual

Technical Manual
Version 1.0
Motorola T720 Handset
Developer Guide

2
Table of Contents
INTRODUCTION ............................................................................................................................ 4
DOCUMENT HISTORY .....................................................................................................................4
OVERVIEW ....................................................................................................................................5
GLOSSARY....................................................................................................................................5
REFERENCES ................................................................................................................................6
HARDWARE ENVIRONMENT ....................................................................................................... 7
HARDWARE OVERVIEW ..................................................................................................................7
SUPPORTED NETWORKS ................................................................................................................7
CONNECTIVITY ..............................................................................................................................8
DISPLAY INFO................................................................................................................................8
BATTERY LIFE ...............................................................................................................................9
SOFTWARE ENVIRONMENT...................................................................................................... 10
AVA™ SUPPORT........................................................................................................................10
BREW SUPPORT ........................................................................................................................11
WAP SUPPORT...........................................................................................................................11
DISPLAY LANGUAGE SUPPORT .....................................................................................................11
FONT SUPPORT...........................................................................................................................13
MEDIA SUPPORT .........................................................................................................................13
DEVELOPMENT TOOLS ............................................................................................................. 14
DEVELOPMENT TOOLS .................................................................................................................14
DEVELOPER TRAINING .................................................................................................................16
DEVELOPING FOR THE MOTOROLA T720 HANDSET ............................................................ 17
DEVELOPING PROGRAMS .............................................................................................................17
Resources Available..............................................................................................................17
Key Mapping Information.......................................................................................................18
CREATING PROGRAMS.................................................................................................................21
Using MIDlet Stationery to reate a Project ..........................................................................21
Using the MIDlet Wizard to reate a Project .........................................................................24
Preverifying a MIDlet .............................................................................................................29
Selecting a VM and Simulator ...............................................................................................30
Running a MIDlet ...................................................................................................................31
DEBUGGING PROGRAMS ..............................................................................................................31
MIDlet Debugging Setup........................................................................................................32
Debugging a MIDlet ...............................................................................................................32
DOWNLOADING PROGRAMS..........................................................................................................33
INSTALLING PROGRAMS ...............................................................................................................34
PACKAGING PROGRAMS...............................................................................................................36
TROUBLESHOOTING .....................................................................................................................37

Table of Contents
3
CODING EXAMPLE ..................................................................................................................... 40
BUTTON OVERVIEW .....................................................................................................................40
CHARACTERISTICS OF LWT BUTTONS ..........................................................................................40
ROUNDBUTTON CLASS CODE TOUR .............................................................................................44
MODIFY A BUTTON’S CHARACTERISTICS........................................................................................50
MODIFY A BUTTON’S LOCATION ....................................................................................................52
INDEX........................................................................................................................................... 55

4
Introduction
Welcome to the Motorola T720 Handset Developer’s Guide. This manual contains all the
information you need to get started developing software that operates on the Motorola
T720 handset.
The Motorola T720 handset information covers the following areas:
• Hardware specifications like displays, processors, memory, and more
• Software specifications like languages, fonts, audio, and more
• Development tools information
• Software development references, guidelines, and instructions
This document assumes that the developer is familiar with the basic principles of
programming, the wireless infrastructure, and wireless specifications.
Document History
Version Date Author Comments
Draft (1.0) 9 Dec, 2002 MW MDP First draft
Draft (1.0) 29 Jan, 2003 MW MDP Second draft
Final (1.0) 10 Feb, 2003 MW MDP FC-1
Final (1.0) 27 Feb, 2003 MW MDP Final release

Introduction
5
Overview
The chapters in this manual cover all aspects of developing programs that operate on the
Motorola T720 handset. These include:
• Hardware Environment–learn the hardware that is available and the capabilities of the
processor, memory, networks, and more
• Software Environment–learn the software environment in which your programs will
operate on the device
• Development Tools–learn which development tools are available to make your
program happen
• Developing for the Motorola T720 Handset –provides the information you need in
order to create, debug, download, and package programs
• Coding Example–learn how to customize the LWT Button class on the Motorola T720
in this extended code example.
Glossary
Here are definitions of common terms used in this manual:
Term Definition
AMR Adaptive Multi Rate
API Application Programming Interface
BREW Binary Runtime Environment for Wireless
CDMA Code Division Multiple Access
EMS Enhanced Messaging Service
GPRS General Packet Radio Services
GSM Global System for Mobile Communications
MMS Multimedia Messaging Service
SMIL Synchronized Multimedia Integration Language
WAP Wireless Application Protocol

6
References
The following references provide information related to developing software for wireless
devices in general.
Organization URL
3GPP www.3gpp.org
Brew Development www.qualcomm.com/brew
Infrared Data Association www.irda.org
JPEG Organization www.jpeg.org
Motorola Developer Program www.motocoder.com
Open Mobile Alliance www.openmobilealliance.org
Qualcomm www.qualcomm.com
Sun Microsystems wireless.java.sun.com
WAP Forum www.wapforum.org
World Wide Web Consortium www.w3.org

Hardware Environment
7
Hardware Environment
This chapter describes the hardware characteristics of the Motorola T720 handset. Use it
to understand the hardware environment in which your software will operate.
Hardware Overview
The Motorola T720 mobile phone represents the latest generation of 2.5G capable mobile
phones from Motorola. For domestic USA and European markets, the Motorola T720 uses
GSM/GPRS wireless communications. The Motorola T720’s built-in J2ME™ environment
executes the Java™ applications that you write and customers download to the phone.
For Asian and South American markets, a version using CDMA is available that uses
BREW to write and support applications.
Supported Networks
The Motorola T720 handset supports these networks:
• GSM 900/1800 (EMEA)
• GSM 850/1900 (Americas)
• GPRS (General Packet Radio Service) packet data
• CDMA 800/1900 and 800 AMPS TriMode (Asia, S. America)
• CDMA 1XRTT
GSM Networks
The Motorola T720 uses GPRS wireless technology (in the US and European Union
versions) to manage voice calls and transfer data. Four channels are allocated for
downstream data, and one channel is dedicated to upstream data. This gives the
Motorola T720 a theoretical download rate of 54 Kbps and a theoretical upload rate of
13.4 Kbps. These rates will vary according to the network operator's channel allocation
and the signal quality.

8
CDMA Networks
The Motorola T720 uses CDMA wireless technology (in the Asian and S. American
versions) to manage voice calls and transfer data. Two channels are allocated for
downstream data, and one channel is dedicated to upstream data. This gives the
Motorola T720 a theoretical download rate of 153 Kbps. This rate will vary according to
the network operator's channel allocation and the signal quality.
Connectivity
The Motorola T720 handset contains the following connectors:
• USB 1.0
• RS232 serial connection (P2K connector)
The consumer can use these ports to perform synchronization of the phone's contact lists
and other personal information to a database on a desktop PC.
Display Info
The physical display characteristics of this Motorola T720 handset are:
Item External Internal
Screen resolution 96 x 32 pixels 120 x 160 pixels
Screen dimensions 28 mm x 38 mm
Pixel pitch 0.237 mm
Color depth Black and White 12-bit pixels
Maximum Colors 2 4096
The resolution of the interior color screen on the Motorola T720 is 120 by 160 pixels. The
interior color screen displays nine lines of text, plus one line of color icons. A “zoom
mode” has the screen present 7 lines of enlarged text for easy reading. The Motorola
T720 has a second, 96- by 32-pixel black-and-white screen on the outer case. This
external screen displays a line of text and status icons, as shown in Figure 1. It allows the
user to check on call information without opening the phone.

Hardware Environment
9
Figure 1. The Motorola T720 internal display.
The Motorola T720’s display hardware supports a 12-bit pixel depth, with a screen
capable of producing up to 4096 colors. With the larger color range, images on the
Motorola T720 appear at a much higher quality than on devices whose display hardware
limits the palette to 256 colors.
The Motorola T720 generates a 12-bit color by taking a 24-bit RGB color value and
truncating the four least significant bits in the byte that represents each color component.
That is, if a 24-bit RGB color has a value of 0xFEE3CE (red: 0xFE, green; 0xE3, blue:
0xCE), the conversion process zeros the bits in each component so that the value
becomes 0xF0E0C0 (red: 0xF0, green; 0xE0, blue: 0xC0).
Battery Life
The battery characteristics of the Motorola T720 handset include:
Item Description
Type Li Ion battery
Size (slim battery) 80cc, 106g
Slim battery Type: 550 mAhr
Talk Time: up to 156-270 minutes
Standby Time: up to 90-170 hours
Standard battery Type: 750 mAhr
Talk Time: up to 210-390 minutes
Standby Time: up to 120-230 hours
Extended battery Type: 1100 mAhr
Talk Time: up to 318-540 minutes
Standby Time: up to 180-340 hours

10
Software Environment
This chapter describes the environment of the Motorola T720 handset. Use it to
understand the operating system and software environment in which your software will
operate.
Java™ Support
This device supports the following Java™ technologies and their respective APIs:
• Java 2 Standard, Micro Edition
• MIDP™ 1.0
• CLDC™ 1.0
Devices that support J2ME development are available for the GSM and GPRS networks.
Java™ 2 Standard, Micro Edition
The Java™ 2 Standard, Micro Edition (J2ME™) is a highly optimized runtime environment
targeting a wide range of consumer products, including pagers, cellular phones,
screenphones, digital set-top boxes and car navigation systems.
For information and documentation, visit: wireless.java.sun.com/j2me/
CLDC 1.0
The J2ME Connected Limited Device Configuration (CLDC) specification consists of the K
virtual machine and a core set of class libraries appropriate for use within an industry-
defined profile. This configuration is intended for small wireless devices with simplified
user interfaces, minimum memory budgets starting at about 128 kilobytes, and
intermittent network connections with lower bandwidth.
For information and documentation, visit: wireless.java.sun.com/
configurations/

Software Environment
11
MIDP 1.0
The J2ME™ Mobile Information Device Profile (MIDP) lets you write downloadable
applications and services for network-connectable, battery-operated mobile handheld
devices.
For information and documentation, visit: wireless.java.sun.com/midp/
BREW Support
The Binary Runtime Environment for Wireless (BREW) is an open-source on-line
application development platform for wireless CDMA devices. BREW is designed to allow
developers to write in whatever language they choose. Most native BREW applications
are written using C or C++, but BREW supports other programming languages too, such
as Java. Using BREW, developers can create portable applications that will work on
CDMA devices.
For information and documentation, visit: www.qualcomm.com/brew/
WAP Support
The Wireless Application Protocol (WAP) is an open industry standard technology that
allows mobile users to access and to interact with information and services easily. WAP
makes it possible to link wireless devices (such as mobile phones) to the Internet by
translating Internet information so it can be displayed on the display screen of a mobile
telephone or other portable device.
The Motorola T720 handset supports:
• WAP specification–WAP 1.2.1
• WML 1.3, xHTML, WTLS Class 2
For information on WAP, visit: www.wapforum.org
Display Language Support
The following languages bundles are supported by the Motorola T720 handset:
Bundle ID Language Bundle
0001 US English
0002 UK English
0003 US English, French Canadian, Spanish Col. Port. Brazil
0004 UK English, French, German, Italian

12
Bundle ID Language Bundle
0005 UK English, French, German, Dutch
0006 n/a
0007 n/a
0008 n/a
000A UK English, Spanish, Portuguese, Greek
000B UK English, Norwegian, Danish, Swedish
000C UK English, Swedish, Finnish, Estonian
000D UK English, Lithuanian, Latvian, Russian
000E UK English, Polish, Czech, Slovak
000F UK English, Hungarian, Turkish, Bulgarian
0010 UK English, Serbian, Slovenian, Croatian
0011 UK English, Russian, Ukranian, Romanian
0012 UK English, Arabic, Hebrew, Russian
0014 UK English, Complex Chinese (lite)
0015 US English, Simplified Chinese
0016 US English, Complex Chinese (lite)
0017 US English, French Canadian
0018 US English, Spanish Columbian
0019 US English, Portuguese Brazil
001A US English, Spanish Columbian, Portuguese Brazil
001B US English, French Canadian, Spanish Columbian
0020 UK English, French, Arabic, Turkish
0021 UK English, Thai, Vietnamese
0022 n/a
0023 n/a
0024 UK English, Simplified Chinese

Software Environment
13
Application Language Checking
The Motorola T720 supports the ISO-639A language standard. When writing programs
that use a specific language, use these guidelines.
Upon startup, a MIDlet that supports multiple languages should query the handset to
determine which display language is supported by that model. If the language is
supported, the MIDlet can then use the language; otherwise, it should use the default
language (normally English).
NOTE: Due to the ISO language assignments, a query for Traditional Chinese will only
return Chinese as a supported language, not the subgroups of Traditional or Simplified
Chinese. The program itself must then determine which version of Chinese to use.
Media Support
See the Creating Media for the Motorola T720 Handset manual for information on
supported media types, which include:
• Messaging support (SMS, EMS 5.0, POP)
• Graphic support (JPEG, GIF, WBMP)
• Ring Tone support (iMelody, MIDI)
If you are creating programs that use any of these media, download the Creating Media
for the Motorola T720 Handset manual from: www.motorola.com/
developers/wireless.

14
Development Tools
This chapter describes the development tools and associated software development kits,
and application program interfaces required to create programs that operate on the
Motorola T720 handset.
NOTE: There are two different development paths for the Motorola T720 depending upon
which network the phone is deployed on. For GSM and GPRS networks, the path to use
is J2ME. For CDMA networks, the required path is BREW. This manualonly covers the
creation of J2ME applications and the development tools available on the MOTOCODER
web site.
Development Tools
Use these development tools and software development kits to write programs for the
Motorola T720 handset used on GSM or GPRS networks:
• Motorola SDK for J2ME™
• Metrowerks’ CodeWarrior™ Wireless Studio, 7.0
• Lightweight Windowing Toolkit
• Sun One Studio, Mobile Edition
• Java™ 2 Standard, Micro Edition Wireless Toolkit
For more information on all of these tools, visit: www.motorola.com/
developers/wireless
Motorola SDKfor J2ME™
The Motorola Software Development Kit (SDK) for the J2ME platform is the tool used for
developing and testing programs written in the Java programming language. The SDK
includes applications that make it easy to launch MIDlets (J2ME programs) using the
Motorola J2ME device emulator. Together these tools allow you to develop and debug
your J2ME programs in emulation before downloading them to a target device. The
Motorola SDK can be integrated into Metrowerks’ CodeWarrior Wireless Studio 7.0 as
well as other development environments

Development Tools
15
Licensee Open Class APIs
The Motorola Software Development Kit includes several Licensee Open Class (LOC)
API packages that make programming specific functionality easier. Just because an LOC
is included does not mean it will work on all devices. Always refer to the documentation to
find out which mobile devices are supported by a particular LOC.
The table below lists each LOC API and provides a brief description.
Package Description
com.mot.tcc.media The Media package provides classes to control a phone’s
backlight, media player, and vibration.
com.motorola.game The Gaming package provides classes essential for
writing exciting games that run on mobile devices and
includes classes for working with screens, sprites, music,
sound effects, and much more.
com.motorola.lwt LWT provides basic interface components that make
writing smaller and more powerful user interface easier.
com.motorola.messaging The Messaging package provides the base interfaces
containing functionality common to all messages for
implementing derived messaging interfaces.
NOTE: The Motorola T720 only supports the com.motorola.lwt API package.
For more information on the various LOCs; see the JavaDoc documentation that
accompanies the Motorola SDK for J2ME.
CodeWarrior Wireless Studio 7.0
Use CodeWarrior Wireless Studio as the development tool for creating world-class
applications targeting the J2ME™ and Personal Java™ platforms for smartphones, PDAs,
set-top boxes and other Java technology enabled devices.
CodeWarrior Wireless Studio provides an open and customizable Integrated Development
Environment (IDE), a state-of-the art project manager and build system, class browser
and code navigation system, text editor with code completion, debugger, emulators,
support for team collaboration and WYSIWYG -drag and drop application development.
Registered developers can download a copy of CodeWarrior Wireless Studio from
www.motorola.com/developers/wireless/.
Lightweight Windowing Toolkit (LWT)
The Lightweight Windowing Toolkit (LWT) is a J2ME™ Licensee Open Class (LOC)
designed by Motorola to enhance the capabilities of the Mobile Information Device Profile
(MIDP). It defines new J2ME classes to implement Buttons, Checkboxes, Sliders, and
other user interface widgets. These widgets let application programmers produce
applications that are more powerful and more intuitive user interfaces while still keeping
the size of the application as small as possible. They also reduce the amount of time

16
needed to write these applications by providing a powerful set of extensible classes ready
for use.
Registered developers can download a copy of LWT from www.motorola.com/
developers/wireless/.
Java™ 2 Standard, Micro Edition Wireless Toolkit
The Java™2 Platform Micro Edition, (J2ME™) Wireless Toolkit is a set of tools that
provides application developers with the emulation environment, documentation and
examples needed to develop Java technology applications targeted at CLDC/MIDP
compliant mobile phones and entry level PDAs.
The J2ME Wireless Toolkit is normally bundled with development toolsets like
CodeWarrior Wirelss Studio and Sun One Mobile, but if not, you can download it from:
java.sun.com/products/j2mewtoolkit/.
Sun One Studio, Mobile Edition
Sun One Studio, Mobile Edition is Sun’s integrated development environment (IDE),
which provides support for developing mobile applications and comes bundled with the
J2ME Wireless Toolkit.
For more info on Sun One Studio, Mobile Edition, visit: java.sun.com/products
/j2mewtoolkit/.
Developer Training
Online, instructor led courses are available at the Motorola Developer Learning Center for
members of the Motorola Developer Program. These courses provide a faster and easier
way for you to get up to speed in developing applications that operate on Motorola Java
technology enabled devices.
Some of the courses currently available cover the CodeWarrior Wireless Studio
development tools as well as Programming the Motorola T720. These courses are
available at www.motocoder.com.

Developing for the
Motorola T720 Handset
17
Developing for the
Motorola T720 Handset
This chapter provides the information you need in order to create, debug, download, and
packaging of programs written for the Motorola T720 handset.
Developing Programs
This section provides the basic resources available and key mapping information needed
to develop applications for the Motorola T720 handset.
Resources Available
This section provides information on the availability of resources for the Motorola T720
handset.
Internal Display
Resolution 160 x 120
Color Depth 12 bit color (up to 4096 colors)
External Display
Resolution 96 x 32
Color Depth Black & white (2 colors)
Networking
Max HTTP Socket connections* 3
UDP Max Socket connections* 10
UDP Max Buffer Size 1500 bytes
UDP Packet Size 1300 bytes
TCP Max Socket connections* 10
File & RMS

18
Max number of Files/RMS* ~500
Java VM
Heap Space 512 KB
Program Space Motorola T720 Motorola T720i
640K 512K
Data Space* Motorola T720 Motorola T720i
384K 512K
Recommended JAR Size 50-100 KB
Maximum JAR Size 200 KB
* These resources are shared with the rest of the phone and there could be less available
to Java at any given time.
Zoom In and Zoom Out Modes
The Motorola T720 supports zoom in and zoom out modes on the display. When zoom in
mode is selected, the display area is enlarged, reducing the number of visible pixels on
the display. The zoom mode is controlled by a user selectable option but is often preset
by region distributors. For example, in Asia, zoom in mode is the default setting, whereas
in the US, zoom out is the default setting.
Developers should note which region they are writing the program for and adjust the
program’s UI accordingly to fit. Just as important, you should test the program under both
zoom conditions to ensure no clipping of the visible portions of the program occur.
If your program requires the use of one zoom mode over another, it should read and store
the current zoom setting, change it as required during execution, and always restore the
original zoom zetting upon exit.
Softkey Character Limits
The softkey area at the bottom of the display is divided into three equal sections of
approximately 40 pixels each. Any text that appears as a softkey selection must fit within
that 40-pixel limit. This limits the number of characters you can use in a softkey to a
maximum of six characters per softkey. Failure to follow this guideline can result in clipped
softkey text displays.

Developing for the
Motorola T720 Handset
19
Key Mapping Information
The key map information for the Motorola T720 handset is as follows:
Key Number (KN) Key Code (KC) Game Action (GA)
# (pound) 35 0
* (asterisk) 42 0
0 48 0
1 49 GAME_A
2 50 0
3 51 GAME_B
4 52 0
5 53 0
6 54 0
7 55 GAME_C
8 56 0
9 57 GAME_D
Down Arrow -11 DOWN
Left Arrow -12 LEFT
Left Soft Key -20 0
Right Arrow -13 RIGHT
Right Soft Key -21 7
Send (Enter) -14 FIRE
Up Arrow -10 UP
- (minus) -22 0
NOTE: Game Action column shows J2ME-defined constants for game actions.

20
KN: UP ARROW
KC:
GA:
KN: LEFT SOFT KEY
KC:
GA:
KN: LEFT ARROW
KC:
GA:
KN: 1
KC:
GA:
KN: 4
KC:
GA:
KN: 7
KC:
GA:
KN: *
KC:
GA:
KN: 2
KC:
GA:
KN: RIGHT SOFT KEY
KC:
GA:
KN: DOWN ARROW
KC:
GA:
KN: RIGHT ARROW
KC:
GA:
KN: 3
KC:
GA:
KN: 9
KC:
GA:
KN: 8
KC:
GA:
KN: 6
KC:
GA:
KN: #
KC:
GA:
KN: 5
KC:
GA:
KN: 0
KC:
GA:
KN: UP ARROW
KC: -10
GA: UP
KN: LEFT SOFT KEY
KC: -20
GA: 0
KN: LEFT ARROW
KC: -12
GA: LEFT
KN: 1
KC: 49
GA: GAME_A
KN: 4
KC: 52
GA: 0
KN: 7
KC: 55
GA: GAME_C
KN: *
KC: 42
GA: 0
KN: 2
KC: 50
GA: 0
KN: RIGHT SOFT KEY
KC: -21
GA: 7
KN: DOWN ARROW
KC: -11
GA: DOWN
KN: RIGHT ARROW
KC: -13
GA: RIGHT
KN: 3
KC: 51
GA: GAME_B
KN: 9
KC: 57
GA: GAME_D
KN: 8
KC: 56
GA: 0
KN: 6
KC: 54
GA: 0
KN: #
KC: 35
GA: 0
KN: 5
KC: 53
GA: 0
KN: 0
KC: 48
GA: 0
Figure 2. Key Mapping information for the Motorola T720 handset.