Siemens MOBILITY TOOLKIT FOR JAVA DEVELOPMENT 1.1 User Manual

Siemens Mobility Toolkit for JavaDevelopment
User's Manual
Version 1.1, 05/2004
Copyright © 2004 Siemens AG
All rights reserved
Information and Communication Mobile
Copyright
This publication is protected by copyright and distributed under licenses restrict-
ing its use, copying and distribution. No part of this publication may be reproduced
in any form by any means without prior written authorization of Siemens AG.
Offenders will be liable for damages. All rights are reserved in the event of the
granting of a patent or the registration of a utility model.
The products and technologies described herein may be protected by one or
more patents or patents pending in the United States or other countries.
Trademarks
Siemens AG is a registered trademark.
Sun, Java™, J2ME™, and all Java™-based marks are trademarks or registered
trademarks of Sun Microsystems, Inc. in the U.S. and other countries. Borland®
and JBuilder® are trademarks or registered trademarks of Borland Software Cor-
poration. All other trademarks, third-party brands and names are the property of
Hyperlinks
Disclaimer
their respective owners.
This publication may contain hyperlinks to the Web pages of third parties. Sie-
mens accepts no liability or responsibility for the contents of such Web pages and
Siemens does not take over such Web pages as its own. The use of such pages
shall be at the sole risk of the User.
This publication is provided "AS IS", without a warranty of any kind. All express or
implied representations and warranties, including any implied warranty of mer-
chantability, fitness for a particular purpose or non-infringement, are hereby ex-
cluded.
Siemens AG may make any improvements or changes in the product(s) or the
program(s) described in this publication at any time.
This document is subject to change without notice.
- 2 -
Information and Communication Mobile
Table of Contents
1 -Introduction.................................................................................................................................. 4
1.1 -Document's Purpose ........................................................................................................ 4
1.2 -Naming Conventions ........................................................................................................ 4
1.3 -Document's Overview....................................................................................................... 4
2 -System Requirements ................................................................................................................. 6
2.4 -Hardware Requirements................................................................................................... 6
2.5 -Software Requirements .................................................................................................... 6
3 -Siemens Mobility Toolkit............................................................................................................. 8
3.1 -Architectural Overview of the Emulator ............................................................................ 9
3.2 -SMTK Contents ..............................................................................................................10
3.2.1 -Launcher & Manager......................................................................................... 10
3.2.2 -SMTK documentation........................................................................................ 11
3.2.3 -J2ME™ API Library........................................................................................... 12
3.2.4 -Preverifier .......................................................................................................... 12
3.2.5 -Siemens Java™-enabled Mobile Phone Emulator Pack ................................... 12
3.3 -Siemens Mobility Toolkit (SMTK) Installation ................................................................. 13
3.3.1 -SMTK Core Package Installation ...................................................................... 13
3.3.2 -SMTK Emulator Pack Installation ...................................................................... 17
3.4 -Launcher Execution........................................................................................................ 20
3.5 -"SMTK Configuration and Management Utility" Execution ............................................. 21
3.5.1 -"Select target emulator" Page ........................................................................... 21
3.5.2 -"SMTK management" Page .............................................................................. 22
3.5.3 -"Integration with IDE’s" Page ............................................................................ 23
3.6 -Application Management System (AMS) on the Emulator ............................................. 23
3.6.1 -Installation of .jar Files Using .jad Files ............................................................. 24
3.7 -Loading an Application onto Siemens Java™-enabled Mobile Phones ......................... 25
3.7.1 -Local Loading of an Application onto the Mobile Phone ................................... 25
3.7.2 -Installing the Siemens Data Suite (SDS)........................................................... 26
3.7.3 -Loading the MIDlet into the Mobile Phone ........................................................ 26
3.7.4 -Over the Air (OTA) Downloading....................................................................... 27
3.7.5 -OTA Connection Scenarios............................................................................... 29
3.7.6 -Using SMS for OTA Download (OTA Push Method) ......................................... 32
3.7.7 -OTA Status Codes ............................................................................................ 33
3.8 -Running an Application on the Emulator ........................................................................ 34
3.8.1 -Via Command Window...................................................................................... 34
3.8.2 -Via Filesystem ................................................................................................... 35
3.8.3 -Via Surf & Fun ................................................................................................... 35
3.8.4 -Other Alternatives.............................................................................................. 36
3.9 -Log Files ......................................................................................................................... 36
3.10 -Command Line Parameters.......................................................................................... 36
3.11 -Differences Between the Mobile Phone and the Emulator ........................................... 39
3.11.1 -Performance Differences................................................................................. 39
3.11.2 -Technical Differences...................................................................................... 40
4 -IDE Integration ........................................................................................................................... 41
4.1 -Sun ONE Studio Integration ........................................................................................... 41
4.1.1 -Installing a new Emulator in Sun ONE Studio ................................................... 41
4.1.2 -Creating a new Project ...................................................................................... 42
4.1.3 -Coding an Application Program......................................................................... 46
4.1.4 -Compiling, Preverifying and Testing.................................................................. 47
4.1.5 -Debugging ......................................................................................................... 50
4.2 -JBuilder Integration......................................................................................................... 53
- 1 -
Information and Communication Mobile
4.2.1 -Setting the Emulator in JBuilder ........................................................................ 53
4.2.2 -Creating a new Project ...................................................................................... 55
4.2.3 -Compiling, Preverifying and Testing.................................................................. 58
4.2.4 -Debugging ......................................................................................................... 60
5 -General Features ....................................................................................................................... 63
5.1 -Emulator Start-up ........................................................................................................... 63
5.1.1 -Setting Up HTTP_PROXY and HTTP Profile .................................................... 65
5.1.2 -Setting Up WAP ................................................................................................ 67
5.2 -Filesystem Structure.......................................................................................................68
5.3 -Hot Keys ......................................................................................................................... 69
5.4 -Commands ..................................................................................................................... 69
5.5 -Additional Emulators Features ....................................................................................... 71
5.5.1 -Change microedition.locale ............................................................................... 71
6 -Specific Features ....................................................................................................................... 73
6.1 -CF62 Emulator ............................................................................................................... 73
6.1.1 -CF62 GUI Use / MMI Display ............................................................................ 73
6.1.2 -Mobile Features................................................................................................. 74
6.2 -C60 Emulator.................................................................................................................. 76
6.2.1 -C60 GUI Use / MMI Display .............................................................................. 76
6.2.2 -Mobile Features................................................................................................. 77
6.3 -MC60 Emulator............................................................................................................... 79
6.3.1 -MC60 GUI Use / MMI Display ........................................................................... 79
6.3.2 -Mobile Features................................................................................................. 80
6.4 -M55 Emulator ................................................................................................................. 82
6.4.1 -M55 GUI Use / MMI Display .............................................................................. 82
6.4.2 -Mobile Features................................................................................................. 83
6.5 -SL55 Emulator................................................................................................................ 85
6.5.1 -SL55 GUI Use / MMI Display ............................................................................ 85
6.5.2 -Mobile Features................................................................................................. 86
6.6 -S55 Emulator.................................................................................................................. 88
6.6.1 -S55 GUI Use / MMI Display .............................................................................. 88
6.6.2 -Mobile Features................................................................................................. 89
6.7 -C55/C(T)56/2128 Emulator ............................................................................................ 91
6.7.1 -C55 GUI Use / MMI Display .............................................................................. 91
6.7.2 -Mobile Features................................................................................................. 92
6.8 -M(T)50/M46/3118 Emulator............................................................................................ 94
6.8.1 -M50 GUI Use / MMI Display .............................................................................. 94
6.8.2 -Mobile Features................................................................................................. 95
6.9 -Sl45i/6688i Emulator ...................................................................................................... 97
6.9.1 -Sl45i GUI Use / MMI Display............................................................................. 97
6.9.2 -Mobile Features................................................................................................. 98
7 -Command Line Debug............................................................................................................. 100
8 -Additional Resources.............................................................................................................. 101
8.1 -Siemens Developer Portal............................................................................................ 101
8.2 -CLDC and MIDP Specification ..................................................................................... 101
8.3 -Sun J2ME™ Wireless Toolkit ....................................................................................... 101
A -Abbreviations ......................................................................................................................... 102
B -Application Source Code ....................................................................................................... 103
- 2 -
Information and Communication Mobile
Table of Figures
Figure 3.1:Siemens Mobility Toolkit architecture .................................................................................... 9
Figure 3.2:Siemens Java™-enabled mobile phone architecture .......................................................... 10
Figure 3.3:SMTK Core Installation Welcome screen ............................................................................ 13
Figure 3.4:Core Installation License Agreement screen ....................................................................... 14
Figure 3.5:SMTK Core Installation JDK Directory screen ..................................................................... 14
Figure 3.6:Core Installation Destination Folder screen......................................................................... 15
Figure 3.7:SMTK Core Installation Start Menu Folder Selection screen .............................................. 15
Figure 3.8:SMTK Core Installation Features Selection screen ............................................................. 16
Figure 3.9:SMTK Core Installation Additional Tasks Selection screen ................................................. 16
Figure 3.10:Core Installation Ready to Install screen ...........................................................................17
Figure 3.11:SMTK Core Installation Information screen ....................................................................... 17
Figure 3.12:SMTK Core Installation Finish screen ............................................................................... 18
Figure 3.13:Emulator Pack Installation Welcome screen ..................................................................... 19
Figure 3.14:SMTK Emulator Pack Installation License Agreement screen .......................................... 19
Figure 3.15:SMTK Emulator Pack Installation Complete screen .......................................................... 20
Figure 3.16:Launcher’s Window ........................................................................................................... 20
Figure 3.17:"Select target emulator" window ........................................................................................ 21
Figure 3.18:"SMTK management" window ........................................................................................... 22
Figure 3.19:"Integration with IDE's" page ............................................................................................. 23
Figure 3.20:Run a MIDlet from Surf&Fun ............................................................................................. 24
Figure 3.21:Download a MIDlet ............................................................................................................ 24
Figure 3.22:Finishing download and running ........................................................................................ 24
Figure 3.23:Reinstall an application...................................................................................................... 25
Figure 3.24:Windows Explorer accessing the Mobile ........................................................................... 26
Figure 3.25:J2ME™ Application download screen ............................................................................... 28
Figure 3.26:Destination Folder selection screen................................................................................... 28
Figure 3.27:Application Name selection ............................................................................................... 28
Figure 3.28:One dial-in number for WAP browsing .............................................................................. 30
Figure 3.29:Two different dial-in number for WAP browsing ................................................................ 31
Figure 3.30:Main screen ....................................................................................................................... 31
Figure 3.31:Menu screen ...................................................................................................................... 31
Figure 3.32:Setup screen...................................................................................................................... 32
Figure 3.33:Connectivity screen ........................................................................................................... 32
Figure 3.34:Data Services screen......................................................................................................... 32
Figure 3.35:MMS, WAP Data service selection .................................................................................... 32
Figure 3.36:MMS, WAP Data service rename ...................................................................................... 32
Figure 3.37:MMS, WAP Data service configuration.............................................................................. 32
Figure 3.38:Rename Confirmation Screen ........................................................................................... 33
Figure 3.39:GPRS settings selection .................................................................................................... 33
Figure 3.40:GPRS settings screen ....................................................................................................... 33
Figure 3.41:Start an Application............................................................................................................ 34
Figure 3.42:Filesystem menu item........................................................................................................ 35
Figure 3.43:JAVA directory ................................................................................................................... 35
Figure 3.44:Open a MIDlet.................................................................................................................... 35
Figure 3.45:Surf&Fun menu item.......................................................................................................... 35
Figure 3.46:Games & Fun..................................................................................................................... 35
Figure 3.47:Open a Folder.................................................................................................................... 36
Figure 4.1:"Runtime" in Explorer window.............................................................................................. 41
Figure 4.2:Add Emulator.." menu.......................................................................................................... 41
Figure 4.3:Emulator path selection screen ........................................................................................... 42
Figure 4.4:Runtime Tab properly set .................................................................................................... 42
Figure 4.5:"Project Manager" selection................................................................................................. 42
Figure 4.6:"Project Manager" window................................................................................................... 43
- 1 -
Information and Communication Mobile
Figure 4.7:New Project name ............................................................................................................... 43
Figure 4.8:Project Configuration screen ............................................................................................... 43
Figure 4.9:Project Selection tab in Explorer window.............................................................................44
Figure 4.10:Filesystem selection .......................................................................................................... 44
Figure 4.11:Select Local Directory screen ............................................................................................ 45
Figure 4.12:Local Directory mounting last screen................................................................................. 45
Figure 4.13:New File selection.............................................................................................................. 46
Figure 4.14:"HelloWorld" Template choosing ....................................................................................... 46
Figure 4.15:Directory choosing ............................................................................................................. 47
Figure 4.16:Main Class menu ............................................................................................................... 47
Figure 4.17:Main Class selection.......................................................................................................... 48
Figure 4.18:Execute Project menu........................................................................................................ 48
Figure 4.19:Emulator window example................................................................................................. 49
Figure 4.20:Add Breakpoint menu ........................................................................................................ 50
Figure 4.21:Add Breakpoint screen ...................................................................................................... 50
Figure 4.22:Breakpoint highlight example............................................................................................. 51
Figure 4.23:Debugging window ............................................................................................................ 51
Figure 4.25:Continue debug menu ....................................................................................................... 52
Figure 4.24:Reached breakpoint example ............................................................................................ 52
Figure 4.26:Configure JDKs menu........................................................................................................ 53
Figure 4.27:Configure JDKs screen...................................................................................................... 54
Figure 4.28:Target emulator screen...................................................................................................... 54
Figure 4.29:New Project menu ............................................................................................................. 55
Figure 4.30:Project Wizard - Project name Screen............................................................................... 55
Figure 4.31:Project Wizard - Project paths Screen...............................................................................56
Figure 4.32:Add Files/Packages menu ................................................................................................. 57
Figure 4.33:Select class files screen .................................................................................................... 57
Figure 4.34:Rebuild Project menu ........................................................................................................ 58
Figure 4.35:Run Project menu .............................................................................................................. 58
Figure 4.36:Set Main Class screen ....................................................................................................... 59
Figure 4.37:Emulator window launched................................................................................................ 59
Figure 4.38:Select breakpoint ............................................................................................................... 60
Figure 4.39:Toggle breakpoint .............................................................................................................. 60
Figure 4.40:Breakpoint marked............................................................................................................. 61
Figure 4.41:Debug Project menu .......................................................................................................... 61
Figure 4.42:Breakpoint highlighted ....................................................................................................... 62
Figure 4.43:Resume Program menu..................................................................................................... 62
Figure 5.1:Lauching Emulator............................................................................................................... 63
Figure 5.2:Selecting a Phone Model..................................................................................................... 63
Figure 5.3:Inserting SIM Card............................................................................................................... 64
Figure 5.4:“Commands” Window .......................................................................................................... 64
Figure 5.5:Set "CSD only mode"........................................................................................................... 65
Figure 5.6:Main Menu ........................................................................................................................... 65
Figure 5.7:Setup screen........................................................................................................................ 65
Figure 5.8:Connectivity screen ............................................................................................................. 66
Figure 5.9:Data Services screen........................................................................................................... 66
Figure 5.10: Mail,Java,Rms screen ...................................................................................................... 66
Figure 5.11:Options screen................................................................................................................... 66
Figure 5.12:Rename screen ................................................................................................................. 66
Figure 5.13:Mail,Java,Rms screen with a HTTP Profile ....................................................................... 66
Figure 5.14:Confirmation screen........................................................................................................... 67
Figure 5.15:HTTP Profile setup screen................................................................................................. 67
Figure 5.16:GPRS Settings screen....................................................................................................... 67
Figure 5.17:Connectivity screen ........................................................................................................... 67
Figure 5.18:Account settings screen..................................................................................................... 67
Figure 5.19:Set Up WAP....................................................................................................................... 68
- 2 -
Information and Communication Mobile
Figure 5.20:Set up WAP Homepage..................................................................................................... 68
Figure 5.21:Launch WAP Browser........................................................................................................ 68
Figure 5.22:Filesystem Structure .......................................................................................................... 68
Figure 5.23:Commands Window........................................................................................................... 69
Figure 5.24:SMS - TPDU Dialog Incoming Message............................................................................ 70
Figure 5.25:Command window - locale................................................................................................. 71
Figure 5.26:Change microedition.locale window .................................................................................. 72
Figure 6.2:C65 Emulator....................................................................................................................... 73
Figure 6.1: C60 Emulator...................................................................................................................... 76
Figure 6.2:MC60 Emulator.................................................................................................................... 79
Figure 6.3:M55 Emulator ...................................................................................................................... 82
Figure 6.4:SL55 Emulator ..................................................................................................................... 85
Figure 6.5:S55 Emulator ....................................................................................................................... 88
Figure 6.6:C55 Emulator....................................................................................................................... 91
Figure 6.7: M50 Emulator ..................................................................................................................... 94
Figure 6.8:Sl45i Emulator ..................................................................................................................... 97
- 3 -
Information and Communication Mobile Introduction

1 - Introduction

1.1 - Document's Purpose

This document is an operation guide for Siemens mobile phone emulators. It de-
scribes the emulators´ functionalities and how to use Siemens Mobility Toolkit.

1.2 - Naming Conventions

This document adopts the following naming conventions:
• File names and directory (folder) names are typed in bold characters.
• Names of user interface components (keys, menu items, specific windows
etc.) are typed in double quotes (" ").
• Some words or phrases may be typed in italic to attract the special attention of
the reader.
• References to books or other printed material are typed in bold and under-
lined.

1.3 - Document's Overview

Chapter 1 - Introduction
This chapter describes this document's structure, as well as its purpose.
Chapter 2 - System Requirements
This chapter describes the requirements in terms of hardware and software re-
quirements needed to run the emulator.
Chapter 3 - Siemens Mobility Toolkit
This chapter contains a description of the SMTK, including its components like
J2ME™ documentation and the emulator itself.
Chapter 4 - IDE Integration
This chapter contains a description of how to integrate SMTK to two of the leading
IDE tools, Sun ONE and JBuilder.
Chapter 5 - General Features
This chapter describes features and functionalities that are common to all Sie-
mens' emulators.
Chapter 6 - Specific Features
This chapter describes each emulators’ specific features.
Chapter 7 - Command Line Debug
This chapter shows how to debug an application without the need of an IDE.
Chapter 8 - Additional Resources
- 4 -
Information and Communication Mobile Introduction
This chapter points to where to obtain more information about J2ME™ develop-
ment tools and to obtain more Siemens mobile information.
Appendix A - Abbreviations
This chapter describe the meaning of the terms used in the document.
Appendix B - Application Source Code
The source code of an example application Hello.java.
- 5 -
Information and Communication Mobile System Requirements

2 - System Requirements

Development configuration comprising only Java 2 SDK and SMTK is intended
for use on Windows™ 95, Windows™ 98 (1st or 2nd edition), Windows™ NT 4.0
(Service Pack 5 or higher), Windows™ 2000 Professional, Windows™ 2000
Server, or Windows™ 2000 Advanced Server operating systems running on Intel
hardware. In non-English locales, only the Professional edition of Windows™
2000 is supported.

2.4 - Hardware Requirements

This configuration is intended for use on Windows™ 98 (1st or 2nd edition), Win-
dows™ NT 4.0 (Service Pack 5 or higher), Windows™ 2000 or Windows™ XP
operating systems running on Intel hardware.
• Intel® Pentium® 166MHz or compatible processor
• 128 MB RAM(minimum requirement)
• 120-240 MB hard disk space
- 50 MB – SMTK
- 70 MB – J2SE™ SDK
- 120 MB – J2SE™ SDK documentation

2.5 - Software Requirements

Software basic requirements are:
• Windows™ 95, Windows™ 98 (1st or 2nd edition), Windows™ NT 4.0 (Service
Pack 5 or higher), Windows™ 2000 Professional, Windows™ 2000 Server, or
Windows™ 2000 Advanced Server
• Sun Java Standard Edition (J2SE) SDK, version 1.3.1 or above
In general it can be used any integrated development environment (IDE) that sup-
ports development of Java applications. To use the debugging capabilities of the
SMTK PC-emulator, the IDE must support remote debugging. Borland™’s JBuild-
er 9 Mobile Edition and Sun Microsystems’ Sun ONE 5 (formely Forte for Java)
Community Edition, both support integration with SMTK.
At Sun Microsystems' Java portal on the URL http://java.sun.com/j2se/1.4.2/
download.html is possible to get the SDK installation files. It is Just download one
(as said, the minimal required version is 1.3.1, but a more stable version of the
J2SE SDK is 1.4.2_04) and execute the installation files.
- 6 -
Information and Communication Mobile System Requirements
At Sun Microsystems' Sun ONE portal on the URL http://forte.sun.com/ffj/down-
loads.html is possible to get the Sun ONE Mobile Edition(release 4, update 1 is
the last stable version, but SUN One Studio 5, early access release is also avail-
able). Download it and install.
Here is described the integration process with an earlier version (version 3), but
the modus operandi of the integration process with version 4 and 5 is the same.
At Siemens Developer Portal on the URL http://www.siemens-mobile.com/devel-
oper, in the session Developer Village, in the topic Tools, it's possible to obtain
the SMTK or a specific model. It's just needed to download the installation files
and execute them.
At Borland™ site on the URL http://www.borland.com/products/downloads/
download_jbuilder.html it's possible to get both Jbuilder Personal Edition and its
extension to J2ME™, called MobileSet. Download and install both. The JBuilder
must be at version higher than 5.
- 7 -
Information and Communication Mobile Siemens Mobility Toolkit

3 - Siemens Mobility Toolkit

Siemens Mobility Toolkit (SMTK) brings several new features, improvements and
documentation(see figure 3.1). These features include:
• Improved SMTK installation structure;
• Easier IDE integration; you no longer need to integrate every single SMTK; just
integrate SMTK once and the rest is handled by the SMTK Manager tool deliv-
ered with SMTK;
• Single entry SMTK Launcher tool for launching the different installed SMTK
Emulator Packs;
• Improved online documentation capabilities supporting Windows Help. Online
Documentation available via Start Menu, SMTK Launcher and SMTK Man-
ager;
• Context help available in Launcher and Manager.
SMTK structure is divided in a basic package, called SMTK Core, and the SMTK
Emulator Packs.
NOTE: To use SMTK you have to download the SMTK Core installation pack-
age, plus at least one SMTK Emulator Pack installation package.
SMTK Core is the basic package. It contains basically integration tools and docs.
SMTK Core comes with the following items:
• The Launcher utility;
• The "SMTK Configuration and Management Utility" called Manager;
• The preverify.exe utility;
• On-line help;
• Documentation, including Siemens API Javadocs.
Each SMTK Emulator Pack contains a Siemens Java™-enabled mobile phone
emulator. Specific emulators are no longer launched directly from the IDE; in-
stead of this, a Launcher utility is activated by the IDE, which then launches the
emulator selected by the user.
The "SMTK Configuration and Management Utility" provides the following func-
tionalities:
1. Select a target device (specific SMTK Emulator Pack) for compilation;
2. Obtain version information about any specific SMTK Emulator Pack installed;
3. Request un-installation of an SMTK Emulator Pack;
4. Obtain the status of the SMTK integration with different IDEs.
- 8 -
Information and Communication Mobile Siemens Mobility Toolkit
Figure 3.1: Siemens Mobility Toolkit architecture

3.1 - Architectural Overview of the Emulator

The main development tool to test MIDlet applications on a J2ME™-enabled mo-
bile phone is the PC/Windows-based emulator (PC emulator). This emulator not
only mimics the behavior of the Java Virtual Machine (JVM) implemented in the
mobile phone, but also the behavior of the mobile phone itself as a cell phone de-
vice - as far as this is possible without the corresponding hardware.
The PC emulator has a carefully designed multi-layer architecture(as shown in
figure 3.2) and a realistic user interface. It offers application developers a behav-
ior and a look-and-feel very close to that of a real Siemens mobile phone, with the
exception of timing characteristics and of execution of some GSM-specific func-
tions.
The emulator is built upon the same code base as that used to build the firmware
of the Siemens mobile phone. To run the emulator on a PC, a hardware abstrac-
tion layer is introduced (i.e. an emulator of the mobile phone's hardware on a PC),
which translates firmware routines of the Mobile Phone into appropriate PC rou-
tines. The abstraction layer also emulates real actions on mobile phones periph-
erals (actions such as pressing a key on the mobile phone, or visualizing a text or
image on the mobile's display) by appropriate PC keyboard and mouse actions
applied to a realistic image of the Siemens mobile phone on the PC monitor.
- 9 -
Information and Communication Mobile Siemens Mobility Toolkit
Figure 3.2: Siemens Java™-enabled mobile phone architecture
One feature of this abstraction layer is the mapping of the file system onto the PC
file system (directory \filesystem of SMTK's installation).

3.2 - SMTK Contents

This section describes the main components of the SMTK. These include the
components of the SMTK Core and the SMTK Emulator Packs, as well as their
purposes and functionalities.

3.2.1 - Launcher & Manager

NOTE: The Launcher utility and the Manager utility are components of the
SMTK Core package.
3.2.1.1 - Launcher
In a PC development context, J2ME™ applications are tested on a Java™-ena-
bled mobile phone emulator. Siemens has an increasing number of mobile phone
models that are Java™-enabled, and the Launcher utility provides a unique em-
ulator launching tool for all the installed SMTK Emulator Packs.
When called, the Launcher calls the default Siemens Java™-enabled mobile
phone emulator (if not specified a specific model), passing the necessary param-
eters.
NOTE: The Launcher executable file (emulator.exe) is located in the <<SMTK
path>>\bin subfolder (replace <<SMTK path>> by the SMTK installation path).
- 10 -
Information and Communication Mobile Siemens Mobility Toolkit
3.2.1.2 - Manager
To manage SMTK configurations, the Manager utility (also called SMTK Config-
uration and Management Utility) performs the following groups of functions, rep-
resented on its graphical window by three tabs:
1. Selecting the target device (target phone emulator) for which applications will be compiled and executed.
2. SMTK management.
3. Display the current status of SMTK integration with IDEs.
NOTE: The Manager executable file (prefs.exe) is located in the <<SMTK
path>>\bin subfolder (replace <<SMTK path>> by the SMTK installation path).

3.2.2 - SMTK documentation

SMTK comes with documents and Java source code of examples of Siemens-
specific API usage. These are useful materials which developers can use to learn
how to develop for Siemens Java™-enabled mobile phones.
NOTE: Siemens J2ME™ API Javadocs are now part of the SMTK Core pack-
age, as well as Siemens J2ME™ examples.
3.2.2.1 - Siemens J2ME™ API Javadocs
Siemens J2ME™ API implements CLDC 1.0 and MIDP 1.0 specifications. Be-
sides the required packages by these specifications, Siemens Java™-enabled
mobile phones also implement additional packages. These packages include bet-
ter support for graphics, sound and communication. All these packages (as well
as their classes and interfaces) are documented in the Javadoc format, and are
shipped together with SMTK Core. This documentation consists of HTML pages
containing the description of each class, with their methods and properties.
3.2.2.2 - Siemens J2ME™ Examples
SMTK delivers together with API documentation a set of J2ME™ examples, in the
form of Java source code. Each example within SMTK implements a different us-
age of API packages and classes. General Siemens API usage examples are de-
livered with SMTK Core, and Siemens Java™-enabled mobile phone's specific
functionality examples are delivered within each SMTK Emulator Pack. Together,
they have the purpose of teaching the developers how to use Siemens API in real-
life applications.
NOTE: Not all API methods and classes are covered with these examples
- 11 -
Information and Communication Mobile Siemens Mobility Toolkit

3.2.3 - J2ME™ API Library

SMTK includes the Siemens J2ME™ API library file. This file is a Java JAR file
(named api.jar and located in <<SMTK path>>\lib path) containing the Java class-
es, interfaces and exceptions of Siemens API. This library is required in the proc-
ess of compilation (both in command mode and by the IDEs) and execution of a
MIDlet.
NOTE: Each individual SMTK Emulator Pack has its own J2ME™ API Library.

3.2.4 - Preverifier

The CLDC specification defines a new Java virtual machine (VM), called the K
Virtual Machine, or KVM for short. The KVM is a complete new implementation of
a Java virtual machine, designed from the start to work on resource-constrained
devices.
For CLDC-based applications, there is a remaining task to be executed after
compiling the Java source code. This task involves changing how classes are ver-
ified, or checked for correctness. Instead of running the complete verification
process on the device itself, KVM assumes that most of the job is done offline.
This offline task is performed by a tool called preverifier.
The preverifier does the actual verification and inserts extra information into the
class files. (Note that the modifications are transparent to non-KVM virtual ma-
chines). When the application is launched, KVM looks for this information and
uses it to perform a much simpler verification, based on the data collected by the
preverifier.
NOTE: The preverifier is a component packed in the SMTK Core package.

3.2.5 - Siemens Java™-enabled Mobile Phone Emulator Pack

SMTK now requires each individual emulator (now called SMTK Emulator Pack)
to be installed separately after installing the SMTK Core. After installing the SMTK
Emulator Pack, the developer can instantly start creating and testing J2ME™ ap-
plications. To have a complete description of the available Siemens Java™-ena-
bled mobile phone emulators, please refer to the document named "SMTK
Emulator's Guide", available for download at Siemens Developer Portal in http://
www.siemens-mobile.com/developer.
- 12 -
Information and Communication Mobile Siemens Mobility Toolkit

3.3 - Siemens Mobility Toolkit (SMTK) Installation

This section describes the installation steps for the SMTK packages, which can
be downloaded at the Siemens Developer's Portal (refer to chapter 8 - Additional
Resources, section 8.1 - Siemens Developer Portal, for additional information).
To use SMTK you have to download the SMTK Core installation package, plus at
least one SMTK Emulator Pack installation package (refer to section 3.2 - SMTK
Contents for additional information on SMTK structure).
NOTE: To run SMTK Core and the SMTK Emulator Pack, Java™ 2 Standard
Edition Software Development Kit (J2SE™ SDK) version 1.3.1 or higher must
be already installed.

3.3.1 - SMTK Core Package Installation

1. Start the SMTK Core installation by clicking "Next":
Figure 3.3: SMTK Core Installation Welcome screen
- 13 -
Information and Communication Mobile Siemens Mobility Toolkit
2. Accept the License Agreement (provided it is accepted):
Figure 3.4: Core Installation License Agreement screen
3. Select the JDK folder:
Figure 3.5: SMTK Core Installation JDK Directory screen
- 14 -
Information and Communication Mobile Siemens Mobility Toolkit
4. Select the destination folder:
Figure 3.6: Core Installation Destination Folder screen
5. Select Start Menu Folder, then click "Next":
Figure 3.7: SMTK Core Installation Start Menu Folder Selection screen
- 15 -
Information and Communication Mobile Siemens Mobility Toolkit
6. Select features to install:
Figure 3.8: SMTK Core Installation Features Selection screen
7. Select Additional Tasks:
Figure 3.9: SMTK Core Installation Additional Tasks Selection screen
- 16 -
Information and Communication Mobile Siemens Mobility Toolkit
8. Check if the installation settings are correct, then click "Next":
Figure 3.10: Core Installation Ready to Install screen
9. SMTK Core Installation tool informs that one emulator add-on (SMTK Emula­tor Pack) must be present before using the SMTK Core features. Click on the button "OK" to proceed:
Figure 3.11: SMTK Core Installation Information screen
10. Finish the SMTK Core Installation:

3.3.2 - SMTK Emulator Pack Installation

NOTE: For this demonstration, it will be assumed that you have obtained at
Siemens Developer Village portal on Web the SMTK M55 Emulator Pack in-
staller, for instance. Any other SMTK Emulator Pack can be used instead.
- 17 -
Information and Communication Mobile Siemens Mobility Toolkit
Figure 3.12: SMTK Core Installation Finish screen
- 18 -
Information and Communication Mobile Siemens Mobility Toolkit
1. Start installing the SMTK Emulator Pack by clicking "Next":
Figure 3.13: Emulator Pack Installation Welcome screen
2. Accept the License Agreement (provided it is accepted):
Figure 3.14: SMTK Emulator Pack Installation License Agreement screen
- 19 -
Information and Communication Mobile Siemens Mobility Toolkit
3. Finish the SMTK Emulator Pack installation:
Figure 3.15: SMTK Emulator Pack Installation Complete screen

3.4 - Launcher Execution

When the Launcher is started without specifying a phone emulator to launch, a
window appears, asking for the user to specify it.
Figure 3.16: Launcher’s Window
This happens only when the two following conditions are both met: the launcher's
command line has no -Xdevice argument, and the launcher had not been instruct-
ed to always use the target emulator as set by the SMTK Configuration and Man-
agement Utility.
- 20 -
Information and Communication Mobile Siemens Mobility Toolkit
The window displayed by the Launcher contains a list of all emulators installed,
and a check-box labeled "Use the current target emulator". Two options are given:
• Select one of the emulators in the list, while leaving the check-box unchecked.
This will result in launching the selected emulator for this execution only. The
target emulator is highlighted in the list as a proposed initial selection, which
may be modified by the user, or;
• Check the "Use the current target emulator" check-box. The current target
emulator will be launched for this execution, and every subsequent invocation
of the Launcher without specifying the "–Xdevice:<device_name>" argument
will perform without displaying this window. Switching off this operation mode
of the Launcher may only be done using the SMTK Configuration and Man-
agement Utility.
Starting the launcher without any installed SMTK Emulator Pack will lead Launch-
er to invoke a warning window, informing that there is no one registered emulator.
In this case, download at least one SMTK Emulator Pack from Siemens Develop-
er Portal and install it.

3.5 - "SMTK Configuration and Management Utility" Execution

Use this dialog for the following tasks:
• to set the target emulator for your applications compilation;
• to manage the SMTK emulators set;
• to manage the SMTK integration with IDEs.

3.5.1 - "Select target emulator" Page

Figure 3.17: "Select target emulator" window
- 21 -
Information and Communication Mobile Siemens Mobility Toolkit
To select the target emulator for your applications compilation select the phone
model from installed models list and press "Set target" button. The current target
emulator is highlighted in the list by green background as shown in figure 3.17.
Use "Device info" button to see the device help information for selected model in
the list.
With the "Use the current target emulator for MIDlet execution" checkbox you can
control whether the current target model will be also used when the emulator is
launched without explicitly specified phone model, or the "Emulator to launch" di-
alog will appear in such case.

3.5.2 - "SMTK management" Page

Figure 3.18: "SMTK management" window
This page contains the installed phone models list with their emulators versions
displayed. The current target emulator is highlighted by green background.
• Use the "About" button to see the release notes for the selected emulator.
• Use the "Remove" button to remove the selected emulator from the SMTK.
- 22 -
Information and Communication Mobile Siemens Mobility Toolkit

3.5.3 - "Integration with IDE’s" Page

Figure 3.19: "Integration with IDE's" page
This page contains the list of all IDEs supported by SMTK. Each list item has the
current integration with IDE status description (IDE is not installed, IDE is installed
but not integrated, IDE is integrated with SMTK). Also each item contains the but-
tons:
• "Info": Use this button to see the information about how to get IDE and about
IDE integration hints.
• "Start": This button appears only when the installation pack for integration with
IDE comes with SMTK. You may use this button to start the integration proce-
dure.

3.6 - Application Management System (AMS) on the Emulator

One of the emulator's features, already mentioned in section 3.1, is a mapping of
the file system of the mobile phone's Flash File System (FFS) into the file system
of the development PC. This means that the emulator's Application Management
System (AMS) "sees" the subdirectory / under the emulator's installation directory
as the "a:" device. This is done to imitate the real mobile phone's AMS, which also
considers the FFS as the "a:" drive. So, if the .jad file contains a line
MIDlet-Jar-URL: file://a:/java/jam/Hello/Hello.jar
the emulator's AMS will look for a "Hello.jar" file in the \java\jam\Hello subdirectory
under the emulator installation directory.
- 23 -
Information and Communication Mobile Siemens Mobility Toolkit

3.6.1 - Installation of .jar Files Using .jad Files

The following steps describe the process of installation of an application JAR (the
.jar file) file, in the situation where only the Descriptor file (the .jad file) is installed
in the mobile device.
NOTE: The "Hello World" example from Appendix B is used here.
1. Create a new directory for the application under the /Java/jam folder in the emulator filesystem's installation directory, e.g. <<Filesystem path>>/Java/ jam/Hello. Copy the "Hello.jad" file into this new directory;
NOTE: Replace <<Filesystem>> for the /filesystem folder inside the emula-
tor's installation path.
2. Start the emulator. Open the folder "Java", by using the right soft key and con­trol keys;
Figure 3.20: Run a MIDlet from Surf&Fun
3. By navigating this screen, an item named Hello is seen marked with an icon (blue filled). This item represents the Hello.jad file inside the Hello folder under /Java/jam. Select it using the right soft key. This is understood as requesting for downloading the application's .jar file (the "Hello.jar" file in our case). The emulator's AMS will ask to confirm the request for download the application. If answered "Yes", AMS will copy the "Hello.jar" file into the / Java/jam/Hello directory.
Figure 3.21: Download a MIDlet
4. After finishing the download, the AMS ask the user if he wants to start running the application. If answered "Yes", the MIDlet starts running.
Figure 3.22: Finishing download and running
5. At this time, the icon displayed at the left of the Hello item will change from the star filled with blue to star not filled. This means that instead of having only downloaded the JAD file, the user accepted to download the JAR file with the application, and this MIDlet is persisted in the FFS.
- 24 -
Information and Communication Mobile Siemens Mobility Toolkit
To ensure correct reinstallation of the application in future, the URL in the appli-
cation's .jad file must point to a correct JAR file URL location. At that location, any
new version of the application will replace the previous one, and will thus be avail-
able for download by all mobile phones, without modifying the initial .jad file.
To reinstall an application, find its .jar file as above described; then open the "Op-
tions" pop-up window using the left soft key. Navigate the option list; select the
"Reinstall" option using the right soft key.
Figure 3.23: Reinstall an application
NOTE: AMS merely copies the application's .jar file into the application's /Java/
jam directory. The same result may be obtained on the emulator by "manually"
copying its .jad file and .jar file into that directory (e.g. by using the "Microsoft
File Explorer" utility). However, doing it with AMS as described above is very
useful as it gives a better idea of how it will be done on a real mobile phone,
and what the user will see on the mobile phone's display.
If a HTTP-URL is specified in the .jad file of an application, AMS can install this
application using an HTTP connection to that URL. To establish this HTTP con-
nection, the emulator uses an existing Internet connection on the PC.

3.7 - Loading an Application onto Siemens Java™-enabled Mobile Phones

3.7.1 - Local Loading of an Application onto the Mobile Phone

To load an application into a Siemens Java™-enabled mobile phone from a local
PC, the following components are needed:
• Siemens Java™-enabled mobile phone (for example, S55) with its communi-
cation port enabled (obtained via Siemens Developer Package);
• Serial data cable (obtained via Siemens Developer Package), IrDA port, USB
or BlueTooth adapter;
• Siemens Data Suite (SDS) installed (obtained via Siemens Developer Pack-
age).
Consider the loading procedure in detail, taking the «Hello, World» application
from Appendix B as an example.
- 25 -
Information and Communication Mobile Siemens Mobility Toolkit
Figure 3.24: Windows Explorer accessing the Mobile

3.7.2 - Installing the Siemens Data Suite (SDS)

The SDS is part of the Siemens Developer Package. This package delivers a Sie-
mens Java™-enabled mobile phone with its serial port enabled, a serial data ca-
ble (for connection between the mobile and the PC station) and a CD-ROM
including SDS, SMTK, Developers Notes, Reference Manuals, White papers,
IDEs and relevant product information. To obtain the Siemens Developer Pack-
age, access the Siemens Developer Portal at http://www.siemens-mobile.com/
developer.
Once obtained Siemens Developer Package, attach the serial data cable to the
serial port of the PC and install the Siemens Data Suite (SDS). Plug in the mobile
phone into the S55 serial data cable. It is possible to use Windows Explorer to
gain access to the mobile's flash file system (FFS). The mobile phone will appear
as a new drive in Windows Explorer, named Mobile. The Java applications are
located under the path /Java/jam of this drive.
NOTE: The /Java/jam folder works as the root directory of the default class-
path. In other words, the KVM will search in this directory for the classes and
resources.

3.7.3 - Loading the MIDlet into the Mobile Phone

If you have used a JAR file to pack your application, just copy your JAR file to
/java/jam/<NewFolder>
- 26 -
Information and Communication Mobile Siemens Mobility Toolkit
, where NewFolder is the new folder created for the MIDlet, named with the same
MIDlet’s name.
NOTE: The "Hello World" application is a very simple one that does not use any
additional resources such as graphics, music or help files. If an application
makes use of such additional resources, copy all .class files of the application
and all the resource files it will use into the application's folder (created on the
Mobile drive as described above).

3.7.4 - Over the Air (OTA) Downloading

The over the air download is a two-step process.
3.7.4.1 - First step: WAP Browsing and .jad File Download
This step consists of browsing through application descriptions using WAP ac-
cess, and loading the .jad-file of a selected one. The following protocols are used
between the mobile phone and the network: WAP / UDP / IPv4 / PPP. The brows-
ing is done by a standard WAP browser on the mobile phone. Application descrip-
tions may have been prepared by standard WAP content generation tools and
stored on a content server. They are accessed by the mobile phone through a di-
alin server and a WAP gateway.
The WAP browser sends an "Accept: */*"-header to the WAP gateway. If a link on
a WAP deck points to a *.jad file, the file will be downloaded into the mobile
phone.
The WAP session will then be terminated and the .jad file will be handed over to
the Application management System (AMS).
Example of a .jad file:
MIDlet-1: BlackJack, /res/Icon.png, blackjack.BlackJack
MIDlet-Description: BlackJack
MIDlet-Jar-Size: 12536
MIDlet-Jar-URL: http://wherever.com/SiemensGames/bj.jar
MIDlet-Name: BlackJack
MIDlet-Vendor: Robby
MIDlet-Version: 1.0.1
MicroEdition-Configuration: CLDC-1.0
MicroEdition-Profile: MIDP-1.0
NOTE: How to configure the web server depends on which specific tool is be-
ing used. For example, if Tomcat is being used, make sure your web.xml file
includes the following lines:
<mime-mapping>
- 27 -
Information and Communication Mobile Siemens Mobility Toolkit
<extension>jad</extension>
<mime-type>text/vnd.sun.j2me.app-descriptor</mime-type>
</mime-mapping>
<mime-mapping>
<extension>jar</extension>
<mime-type>application/java-archive</mime-type>
</mime-mapping>
3.7.4.2 - Second step: downloading a .jar file
The .jar-file of a selected application is then loaded into the mobile phone over an
HTTP connection which is automatically opened by the Siemens Java™-enabled
mobile phone after the user's confirmation. The protocols used in this procedure
are: HTTP / TCP / IPv4 / PPP. The whole procedure consists of the following ac-
tions:
1. The AMS opens the .jad-file and asks the user for a download request confir­mation In addition to the application's name, the user is now informed of the proposed version and the size in KBytes of the .jar-file to be downloaded:
Figure 3.25: J2ME™ Application download screen
If the user confirms with "Yes", the AMS connects the mobile phone to the lo­cation described in MIDlet-Jar-URL.
2. The JAR file is downloaded into the mobile phone and stored on the Flash File System (FFS) in a folder specified by the user (which is created under the \Java directory):
Figure 3.26: Destination Folder selection screen
3. The user specifies the name of the application:
Figure 3.27: Application Name selection
4. The HTTP connection and the GPRS or CSD connection are terminated.
- 28 -
Information and Communication Mobile Siemens Mobility Toolkit
5. The user is informed about successful download, and prompted to run the application.

3.7.5 - OTA Connection Scenarios

There are two download scenarios, which are quite similar; both are supported by
Siemens.
Scenario 2 (see 3.7.5.2) works exactly like Scenario 1 (see 3.7.5.1), but two dial
in numbers and two dial in servers are used instead of one.
Siemens supports both scenarios:
• If the same dial in profile for WAP and HTTP is selected, scenario 1 is active.
• If different dial in profiles are selected, scenario 2 is active.
The Network Operator may decide to use scenario 1 for a number of reasons:
• Simplicity of the configuration;
• Billing based on one dial in number is easier for the end customer to under-
stand when looking at the bill;
• Shorter transmission time for the end user because only one dial in necessary
There are a number of reasons why the Network Operator may decide to use
scenario 2;
• Reuse existing dial in for http and WAP without changing anything in the con-
figuration;
• Some operators have only opened ports 9200 to 9203 in their WAP dial in
server in order to avoid security issues in their WAP environments that come
with opening the http ports;
• Use IVR number for downloading application.
3.7.5.1 - Scenario 1: One Dial-in Number for WAP browsing and for HTTP Content Loading
Routing of both WAP and HTTP packets is done via the same dial-in server:
- 29 -
Information and Communication Mobile Siemens Mobility Toolkit
Figure 3.28: One dial-in number for WAP browsing
- 30 -
Information and Communication Mobile Siemens Mobility Toolkit
3.7.5.2 - Scenario 2: Two Different Dial-in Numbers for WAP and for HTTP
Scenario 2 works exactly in the same way as scenario 1, but two different dial-in
numbers and two dial-in servers are used instead of one (one for WAP, another
for HTTP):
Figure 3.29: Two different dial-in number for WAP browsing
3.7.5.3 - Configuration of the OTA Settings
The following is a step-by-step description on how to configure the OTA settings.
The example shows the settings for the D2-Vodafone operator, with a single dial-
in number for WAP:
1. Select "Menu" and then navigate to the option "Setup" and select it:
Figure 3.30: Main screen
Figure 3.31: Menu screen
- 31 -
Information and Communication Mobile Siemens Mobility Toolkit
2. In the menu that appears, select "Connectivity". Then, select "Data services":
Figure 3.32: Setup screen
Figure 3.33: Connectivity screen
3. Now, configure the WAP services selecting "MMS, Wap" option, and then choose an empty profile. Rename it by selecting "Options" and "Rename". When the new name is set, choose "Save".
Figure 3.34: Data Services screen
Figure 3.35: MMS, WAP Data service selection
Figure 3.36: MMS, WAP Data service rename
Figure 3.37: MMS, WAP Data service configuration
4. Edit the profile, by choosing "Edit". Confirm the changes and select "GPRS
settings". Finally, fill the form with the access point name (APN), login and
password:

3.7.6 - Using SMS for OTA Download (OTA Push Method)

It is possible to send anyone an SMS that contains a notice about new applica-
tions and the URL from where they can be downloaded, e.g.:
- 32 -
Information and Communication Mobile Siemens Mobility Toolkit
Figure 3.38: Rename Confirmation Screen
Figure 3.39: GPRS settings selection
Figure 3.40: GPRS settings screen
"Download the latest application from http://any.server.com/"
If the user reads this SMS, the URL will be highlighted. If the user then presses
the green "Send" key, the URL will be passed over to the WAP browser and will
be opened. The "OTA Push" procedure recognizes the following keywords with
their typing variants, when analyzing an URL received within an SMS:
Http:, http:, HTTP:, www., WWW., wap., Wap.
NOTE: For WAP, HTTP and GPRS settings please visit
http://www.my-siemens.com/customercare

3.7.7 - OTA Status Codes

After downloading a MIDlet, the server is notified about the download status by
using specific numeric codes.
The following OTA Status Codes are supported:
Code Short description Notes
200 Successful installation The user is being asked if he wants to
900 Success Download was successful.
start the downloaded MIDlet.
User is shown a "Do you want to start application xzy" screen.
901 Insufficient Memory Insufficient memory to store the .jar file in
FFS memory. User is shown a "Not enough memory on FFS Card" screen.
- 33 -
Information and Communication Mobile Siemens Mobility Toolkit
902 User Cancelled When user has pressed the red end key
during the download.
904 JAR size mismatch Will be delivered to the server.
Nevertheless the application will be installed and can be started because experience shows that in most cases only the editing of the size in the jad file was wrong.
Not suported are:
Code Short description Notes
903 Loss of service Cannot be transmitted to the server
(Obviously)
905 Attribute mismatch
906 Invalid descriptor
When the errors 905/906 occur, in most cases it is impossible to notify the server
anyway, because it is unclear which server URL should be informed. (The WAP
session is already terminated and the http session cannot be brought up after
analysis of the jad file

3.8 - Running an Application on the Emulator

There are at least three ways to start an application on the emulator.

3.8.1 - Via Command Window

The "Start Java Application" command displays the standard window for selecting
the application file:
Figure 3.41: Start an Application
To start a .jar-packaged application, select the corresponding .jad or .jar file in this
window. To start a non-packaged application, select its main .class file.
- 34 -
Information and Communication Mobile Siemens Mobility Toolkit

3.8.2 - Via Filesystem

By selecting via Filesystem navigation, either an application packed inside a JAR
file or the main class file (the one that extends the class "MIDlet" in its source) can
be selected to start. To do this, follow these steps:
1. Select Filesystem in the "Menu"
Figure 3.42: Filesystem menu item
2. Navigate to the file, opening the necessary folders
3. Finally, select the MIDlet file and press the left soft key or press the right soft

3.8.3 - Via Surf & Fun

It's possible to go directly to the folder /Java/jam, where the MIDlets are located.
This is similar to the filesystem method, only differing that the application is start-
ed from that folder. To do that, follow these steps:
1. Select Surf & Fun in the menu:
Figure 3.43: JAVA directory
key and select Open.
Figure 3.44: Open a MIDlet
Figure 3.45: Surf&Fun menu item
2. Select Games & More:
Figure 3.46: Games & Fun
- 35 -
Information and Communication Mobile Siemens Mobility Toolkit
3. Navigate to the desired folder, and select the MIDlet file and press the left soft key or press the right soft key and select Open:
Figure 3.47: Open a Folder

3.8.4 - Other Alternatives

There are also other ways to start an application as follow:
Via command prompt
The process of starting an application is described in section 3.9, Command Line
Parameters.
Via IDE tool
This starting process is described in Chapter 4 of thisdocument, and alson in the
IDE documentation.

3.9 - Log Files

Every time the virtual machine inside the emulator is running, a java.log file is cre-
ated in the directory where the emulator .exe file is located or in the directory
where the java class file has been started.
The java.log file contains tracing information about the results of the application
execution. Specific categories of data to be recorded in the java.log file by using
"-Xverbose:[<tracing options>]" options when starting the emulator. These op-
tions may also be selected and/or modified when the emulator is already running,
by using its "Debugging/Tracing" menu.
Additionally, the java.log file accumulates informations about uncaught excep-
tions. Refer to this file if unexpected interruptions of the program flow are experi-
enced, because the motivation of this problem can be an uncaught exception.

3.10 - Command Line Parameters

As it has been already stated, launching of a specific Siemens phone emulator is
performed using a special Launcher utility (the "Emulator.exe" file in the <<SMTK
path>>\bin subfolder).
The Launcher can be started from within an IDE. To be directly started, the fol-
lowing command should be entered in the command line console:
emulator [arguments] [<<APPLICATION>>]
- 36 -
Information and Communication Mobile Siemens Mobility Toolkit
The <<APPLICATION>> parameter, if present, specifies an application (a MIDlet)
whose execution will be started by the emulator once it is launched. If this param-
eter is not present, the emulator is launched, but no application execution is start-
ed. An example of usage is shown below:
emulator -Dhttp_proxy=192.168.1.20 -Xdescriptor:"c:\work\Hello.jad"
In the example above, the Hello MIDlet Suite is launched using its JAD file, and a
HTTP proxy is set.
NOTE: Since DOS prompt has a limited screen size, in order to read the dis-
played messages, use a pipe at the end of the emulator call in the prompt. To
do it, add a " | more" string at the end of the emulator call.
Possible values for the optional [arguments] parameter may be the following:
Arguments Function
-help Display a window containing list of available command line arguments.
-Xdevice:<device_name> Launch the emulator specified by <device_name>. If this argument is used jointly with -Xquery, then -Xquery returns the proper­ties of the specified device only.
-version This command is used by the IDE to get the version information. In the standalone mode, it only can be used when the Launcher is started in the DOS-box.
-classpath Set the classpath of the root folder containing the classes of the application.
-Xquery This command is used by the IDE to get infor­mation about all the devices installed, or, when used jointly with the –Xdevice command, about the device specified by the latter. In the stan­dalone mode, it may only be used when the Launcher is started in the DOS-box.
-D<property>=<value> Set <property> to <value>. An available prop­erty is http_proxy=<<address>>[:<<port>>], where <<address>> is a valid IP address of a HTTP proxy and <<port>> is an optional port number.
-Xdebug Enables runtime debugging. -Xrunjdwp must also be specified.
-Xverbose This is identical to specifying -Xverbose:allin the command-line.
- 37 -
Information and Communication Mobile Siemens Mobility Toolkit
-Xverbose:<type1> [,<type2>
.., <typeN>]]
where <type> can be: allocation Generates info about every allocation in the
gc Generates info about every de-allocation in the
gcverbose Generates info about detailed analysis the gar-
class Generates info about class loading, creation
classverbose Generates detailed information as the different
verifier Generates trace info of the KVM's internal
stackmaps Generates trace info of the behavior of stack
bytecodes Generates info about each bytecode as the
methods Generates info about entries and exit of every
methodsverbose Generates info about entry and exit of every
frames Generates info about stack frames when they
stackchunks Generates info about stack and stack chunk
exceptions Generates info about all thrown exceptions,
events Generates info about events (such as PEN-
threading Generates info about status of all threads in
monitors Generates information whenever the program
networking Generates detailed information for every net-
This is a request to the emulator being launched to generate trace info and send it to the java.log file. The trace info will be gener­ated for every <type> of information. The list of possible types is given hereafter. Multiple types may be specified, by separating them by a sin­gle comma without spaces. All trace output can be obtained by using the type all. WARNING: Tracing all information is very ver­bose and the MIDlet will run extremely slow.
Java heap. Also generates overall heap usage statistics.
Java heap.
bage collection process.
and initialization.
parts of a class file are loaded into the KVM.
class verifier.
maps
program executes.
method invoked.
method invoked. Slightly wordier than -Xver­bose:methods.
are pushed and popped.
creation.
even if they are caught.
DOWN) as they are received by the KVM.
the system.
enters or exits a monitor.
work related method.
- 38 -
Information and Communication Mobile Siemens Mobility Toolkit
-Xrunjdwp: <name>=<value> Starts the JDWP debug session with various sub-options. <name> is one of the options in the table below. Appropriate values for <value> are determined by the sub-option name. -Xde­bug must also be specified. This command is used by IDE to set up various debug modes.
where possible < name> values may be: transport The transport mechanism used to communi-
cate with the debugger. The value dt_socket is the only mechanism that is actually supported.
address The transport address for the debugger con-
nection, either in 'host:port' or 'port' formats. In the port-only format, the host is assumed to be localhost.
server Can take "y" and "n" values. When set to "y"
(yes), starts the debug agent as a server. The debugger must connect to the port specified.
suspend Can take "y" and "n" values (default is "y").
Specifies whether or not the application execu­tion should be suspended after establishing a connection with the debugger.
-Xdescriptor:<jad_file> Runs an application using the specified Java Application Descriptor (JAD) file.
All the Boolean options (except "traceall") can also be set or modified during the
emulator's operation. Settings which have been done in this way (from within the
emulator's window) are memorized by the emulator and restored at its next start,
unless explicitly modified in the command line.

3.11 - Differences Between the Mobile Phone and the Emulator

3.11.1 - Performance Differences

The emulator's performance strongly depends on the CPU speed, which in gen-
eral is much higher on a PC workstation than on a real Siemens mobile phone.
Performance characteristics of the emulator are higher than those of the mobile
phones, in particular in the following aspects:
• Higher execution speed;
• More rapid network access;
• Better graphics.
The only way to check the real timing of execution of an application is to run it on
a real mobile phone. It's strongly recommended to do this, at least for the final
testing of time-critical applications.
- 39 -
Information and Communication Mobile Siemens Mobility Toolkit

3.11.2 - Technical Differences

Most of the technical differences between the emulator and the mobile phone re-
sult from the absence of call processing functions on the emulator. Namely:
• An outgoing voice call cannot be done.
• An incoming voice call cannot be received. However, by using the "MSM:
Mobile terminating Call" command you can partly simulate interaction of this
event with normal performance of Java tasks on the mobile phone.
• An SMS message cannot be really sent, but the reception of SMS (text or
voice) message can be emulated by using SMS group of commands on the
emulator.
• TCP/IP/HTTP connections use cellular dial-up on the real mobile phone, while
on the emulator they go along an existing already established LAN/Internet
connection. Remember that if an HTTP proxy is used, then the
“HTTP_PROXY” environment variable must be appropriately set.
• WAP connections also use cellular dial-up on the real mobile phone, while on
the emulator they go along an existing network connection on the PC. This
modem has to support the “X3” AT-command.
Other differences relate to specific hardware components of the mobile phone,
which are either absent or emulated on the emulator, namely:
• The emulator cannot play MP3 files. (SL45i feature).
• The IrDA feature is absent on the emulator.
• The sound feature is only available if a MIDI compatible audio driver is
installed.
• The file system is emulated as a specific folder on the PC file system. There-
fore, the file system can be handled on the emulator in both the mobile phone-
specific manner and as an ordinary folder on a PC.
- 40 -
Information and Communication Mobile IDE Integration

4 - IDE Integration

4.1 - Sun ONE Studio Integration

The main steps of an application development process are reported in this sec-
tion, using a simple example inside Sun ONE Studio (formerly Forte for Java™)
ME. For a detailed description on how to use Sun ONE Studio, please refer to
Sun's documentation. The steps here described will require to create a new
project (e.g. "SiemensTest") and to use the source code of an existing Siemens-
provided application (e.g. "HelloWorld").

4.1.1 - Installing a new Emulator in Sun ONE Studio

1. Install SMTK Emulator, opening "Runtime" tab in "Explorer" folder:
Figure 4.1: "Runtime" in Explorer window
2. Right click "Installed Emulators", and select "Add Emulator":
Figure 4.2: Add Emulator.." menu
- 41 -
Information and Communication Mobile IDE Integration
3. Select the folder where SMTK Core is installed:
Figure 4.3: Emulator path selection screen
4. The SMTK Emulator Packs previously integrated with SMTK Core (in this case, S55) are added:
Figure 4.4: Runtime Tab properly set

4.1.2 - Creating a new Project

1. Select "Project Manager" in the "Project" menu.
Figure 4.5: "Project Manager" selection
- 42 -
Information and Communication Mobile IDE Integration
2. Click "New" in the "Project Manager" window:
Figure 4.6: "Project Manager" window
3. Type a Project name (e.g. SiemensTest) and click "OK:
Figure 4.7: New Project name
4. Select the project configuration and press OK. In this case, select Mobile Information Device Profile (MIDP):
Figure 4.8: Project Configuration screen
- 43 -
Information and Communication Mobile IDE Integration
5. Select Project SiemensTest in the "Explorer" window:
Figure 4.9: Project Selection tab in Explorer window
6. Select "MountFilesystem" in the "File" menu:
Figure 4.10: Filesystem selection
- 44 -
Information and Communication Mobile IDE Integration
7. Select the Local Directory template and click "Next":
Figure 4.11: Select Local Directory screen
8. Navigate to the desired directory (e.g. C:\SiemensTest), select it and press "Finish".
Figure 4.12: Local Directory mounting last screen
- 45 -
Information and Communication Mobile IDE Integration

4.1.3 - Coding an Application Program

1. Select "New" in the "File" menu:
Figure 4.13: New File selection
2. Select "HelloWorld" Template and click "Next":
Figure 4.14: "HelloWorld" Template choosing
- 46 -
Information and Communication Mobile IDE Integration
3. Select a directory (e.g. C:\SiemensTest) and click "Finish":
Figure 4.15: Directory choosing
This completes the process of creating a project and a set of source files.

4.1.4 - Compiling, Preverifying and Testing

1. From the Project menu, select Set Main Class:
Figure 4.16: Main Class menu
- 47 -
Information and Communication Mobile IDE Integration
2. Select "class HelloWorld" and click "OK":
Figure 4.17: Main Class selection
3. From the "Project" menu, select "Execute Project":
Figure 4.18: Execute Project menu
- 48 -
Information and Communication Mobile IDE Integration
4. The application will be loaded into the emulator, and then launched. Now start testing the application on the emulator (in this example, the S55):
Figure 4.19: Emulator window example
- 49 -
Information and Communication Mobile IDE Integration

4.1.5 - Debugging

This subsection aims to illustrate how standard debugging features from Sun
ONE Studio may be used when debugging a Siemens Phone application.
1. After setting application main class select a source code line where to add a breakpoint (in the "Source Editor" window). From the "Debug" menu, select "Add Breakpoint":
Figure 4.20: Add Breakpoint menu
2. Check if the breakpoint setting is correct, then click "OK":
Figure 4.21: Add Breakpoint screen
- 50 -
Information and Communication Mobile IDE Integration
3. The line with a breakpoint will then be highlighted in red in the "Source Editor" window:
Figure 4.22: Breakpoint highlight example
4. Now, to run the application in the debug mode, select "Start" in the "Debug" menu:
Figure 4.23: Debugging window
5. The application will be loaded into the emulator and launched. It will execute up to the breakpoint, where it will pause, and the breakpoint line will be high­lighted in blue in the "Source Editor" window:
6. At this point, debugging features provided by Sun ONE Studio can be used, and also the log file generation facilities included into the emulator.
7. It is possible to set up the emulator's log file options for a given project under Sun ONE Studio using the following procedure:
a. In the "Project" menu, select "Settings". b. A new window opens, entitled "Project Settings". Under "Execution Types"
select "Siemens Executions". c. In the right frame of the same window, select "Properties". d. Select "Midlet Executor Properties" and click the "…" button. e. Another window will open, entitled "Property Editor". In the "Arguments
field", add new options describing the log file generation.
- 51 -
Information and Communication Mobile IDE Integration
Figure 4.24: Reached breakpoint example
NOTE: Careless execution of the procedure described above, and in particular
incorrect specification of log file options, may cause integration of the emulator
with Sun ONE Studio to fail.
8. To continue running the application, just select "Continue" in the "Debug" menu:
Figure 4.25: Continue debug menu
- 52 -
Information and Communication Mobile IDE Integration

4.2 - JBuilder Integration

Below is described the installation procedure for JBuilder 7 Personal using Bor-
land's MobileSet. The procedure is the same for other JBuilder versions.

4.2.1 - Setting the Emulator in JBuilder

1. To configure SMTK Core, click "configure JDKs":
Figure 4.26: Configure JDKs menu
- 53 -
Information and Communication Mobile IDE Integration
2. Set JDK home path to SMTK Core path:
Figure 4.27: Configure JDKs screen
3. The emulator is shown on "Micro" tab, in "Target Device":
Figure 4.28: Target emulator screen
- 54 -
Information and Communication Mobile IDE Integration
NOTE: It is assumed that SMTK Core and at least one SMTK Emulator Pack
are already installed, so it is shown the default selected emulator.

4.2.2 - Creating a new Project

1. To create a Project in JBuilder, select "New Project" in the "File" menu:
Figure 4.29: New Project menu
2. Type the "Project name" (e.g. Test), select the directory and click "Next":
Figure 4.30: Project Wizard - Project name Screen
- 55 -
Information and Communication Mobile IDE Integration
3. At this stage, instead of writing our own application program, let us take one of the examples which are provided with the SMTK. To do this, change the default directory name in "Source Path" to the directory containing source code files for those examples, and click "Finish":
Figure 4.31: Project Wizard - Project paths Screen
- 56 -
Information and Communication Mobile IDE Integration
4. Add source files, by selecting "Add Files/Packages…"in the "Project" menu:
Figure 4.32: Add Files/Packages menu
5. Select class files for one of the examples (e.g. "Arkanoid"). The main window will then look like this:
Figure 4.33: Select class files screen
This completes the process of creating a project and a set of source files.
- 57 -
Information and Communication Mobile IDE Integration

4.2.3 - Compiling, Preverifying and Testing

1. From the "Project" menu, select "Rebuild Project <Name>". This starts compi­lation of the specified project, always followed by preverifying if no compila­tion errors have been found:
Figure 4.34: Rebuild Project menu
2. From the "Run" menu, select "Run Project":
Figure 4.35: Run Project menu
- 58 -
Information and Communication Mobile IDE Integration
3. Select "MIDlet", then set "Main class" to the name of the application's main class (arkanoid.Arkanoid in our example) and click "OK':
Figure 4.36: Set Main Class screen
4. As a result, the application will be loaded into the emulator and launched. Now start testing the application on the emulator (in this example, the S55 emulator):
Figure 4.37: Emulator window launched
- 59 -
Information and Communication Mobile IDE Integration

4.2.4 - Debugging

1. Having built the project, select a source code line where to put a breakpoint.
Figure 4.38: Select breakpoint
2. From the pop-up menu at this line, select "Toggle Breakpoint":
Figure 4.39: Toggle breakpoint
- 60 -
Information and Communication Mobile IDE Integration
3. The line with a breakpoint will then be highlighted in red:
Figure 4.40: Breakpoint marked
4. Now, to run the application in the debug mode, select "Debug Project" in the "Run" menu:
Figure 4.41: Debug Project menu
- 61 -
Information and Communication Mobile IDE Integration
5. The application will be loaded into the emulator and launched. It will execute up to the breakpoint, where it will pause, and the breakpoint line will be high­lighted in blue:
Figure 4.42: Breakpoint highlighted
6. To continue running the application, just select "Resume Program" in the "Run" menu:
Figure 4.43: Resume Program menu
NOTE: At this point, JBuilder's debugging features can be used, as well as the
logfile generation facilities included into the emulator
- 62 -
Information and Communication Mobile General Features

5 - General Features

5.1 - Emulator Start-up

The Launcher utility provides a unique emulator launching tool for all the installed
SMTK Emulator Packs.
It's possible to excute the Launcher utility from the Start Menu, or clicking on the
desktop icon, as shown below:
Figure 5.1: Lauching Emulator
It's also possible to launch the emulator from a console, using the following com-
mand:
emulator [arguments] [<<APPLICATION>>]
The <<APPLICATION>> parameter, if present, is the name of the main class,
.JAR or .JAD file of the user application. The application is started just after the
emulator has been launched.
When the Launcher is started without specifying a phone emulator to launch, a
window appears, asking for the user to specify it.
Figure 5.2: Selecting a Phone Model
This happens only when the two following conditions are both met: the launcher's
command line has no -Xdevice argument, and the launcher had not been instruct-
ed to always use the target emulator as set by the SMTK Configuration and Man-
agement Utility.
- 63 -
Information and Communication Mobile General Features
The window displayed by the Launcher contains a list of all emulators installed,
and a check-box labeled "Use the current target emulator". Two options are given:
• Select one of the emulators in the list, while leaving the check-box unchecked.
This will result in launching the selected emulator for this execution only. The
target emulator is highlighted in the list as a proposed initial selection, which
may be modified by the user, or;
• Check the "Use the current target emulator" check-box. The current target
emulator will be launched for this execution, and every subsequent invocation
of the Launcher without specifying the "-Xdevice:<device_name>" argument
will perform without displaying this window. Switching off this operation mode
of the Launcher may only be done using the
• SMTK Configuration and Management Utility.
Starting the launcher without any installed SMTK Emulator Pack will lead Launch-
er to invoke a warning window, informing that there is no one registered emulator.
In this case, download at least one SMTK Emulator Pack from Siemens Develop-
er Portal and install it.
In order to have the full functionality, follow these steps below:
1. Launch the emulator and press F9 to simulate the SIM card insertion:
Figure 5.3: Inserting SIM Card
2. Select "MM: Full Service" on the Commands window:
Figure 5.4: “Commands” Window
- 64 -
Information and Communication Mobile General Features
3. Select Mode / yes to switch off the "CSD only mode":
Figure 5.5: Set "CSD only mode"

5.1.1 - Setting Up HTTP_PROXY and HTTP Profile

TCP/IP/HTTP connections use cellular dial-up on the real handset, while on the
emulator they go along an already existing LAN/Internet connection. If an HTTP
proxy is used, then the “HTTP_PROXY” environment variable must be appropri-
ately set. The "HTTP_PROXY" can be set either from command line or as an ar-
gument of Launcher utility (see Programmer´s Reference for further information).
If an HTTP-URL has been specified in the .jad file of an application, the Applica-
tion Management System (AMS) will download the .jar file of the application using
an HTTP connection to that URL.
But if this same application is tested on a real device, a valid HTTP Profile must
be configured, in order to allow the J2ME™ application to work correctly. To con-
figure the HTTP Profile on the mobile phone in order to accept J2ME™ applica-
tions establishing HTTP connections, proceed as follows:
1. In the main menu, select "Setup":
Figure 5.6: Main Menu
2. In the "Setup" menu, select "Connectivity":
Figure 5.7: Setup screen
- 65 -
Information and Communication Mobile General Features
3. In the "Connectivity" menu, select "Data services":
Figure 5.8: Connectivity screen
4. In the "Data services" menu, select "Mail,Java,Rms":
Figure 5.9: Data Services screen
5. In the "Mail,Java,Rms" menu, navigate to an empty profile and select "Options":
Figure 5.10: Mail,Java,Rms screen
6. In the “Options” menu, select "Rename":
Figure 5.11: Options screen
7. Name this profile, e.g. "my-http-profile", and save it by selecting “Save“:
Figure 5.12: Rename screen
8. The “Mail,Java,Rms” is shown again. Navigate to the "my-http-profile" and select "Edit":
Figure 5.13: Mail,Java,Rms screen with a HTTP Profile
- 66 -
Information and Communication Mobile General Features
9. A confirmation screen will be shown, informing that any changes promoted on that profile may affect J2ME™ applications. Select "Yes":
Figure 5.14: Confirmation screen
10. In the next screen, activate the "GPRS settings" my selecting “On“, and then edit this option by selecting “Edit“:
Figure 5.15: HTTP Profile setup screen
11. In the "GPRS settings" screen, fill the form with your provider's settings and save it by selecting “Save”:
12. Go to the "Connectivity" screen again, and select the "HTTP profile" option:
13. Finally, set the "my-http-profile" profile as the "Provider" option, and select “OK“ to finish the process:

5.1.2 - Setting Up WAP

The following steps setup the WAP browser on the emulator:
Figure 5.16: GPRS Settings screen
Figure 5.17: Connectivity screen
Figure 5.18: Account settings screen
1. Select "Surf & fun->Internet", the Openwave screen will appear, followed by Start Menu:
- 67 -
Information and Communication Mobile General Features
Figure 5.19: Set Up WAP
2. On "Start Menu", select "Profiles", and set the IP address from the proxy, the Port and a WAP homepage.
Figure 5.20: Set up WAP Homepage
3. To launch the browser, select "Homepage":
Figure 5.21: Launch WAP Browser

5.2 - Filesystem Structure

A mapping of the mobile phone's filesystem can be accessed via a "screen Ex-
plorer". The filesystem can be accessed selecting Menu -> filesystem, and then
navigate through the folders and files. Selecting the left soft key the folders/exe-
cute files are opened. With the selection of the right soft button it is possible to
select to open, move, copy, paste, delete and rename the files and folders.
Figure 5.22: Filesystem Structure
Java files normally are allocated at the path /Java/jam, and generally each MIDlet
has its own folder under this path.
- 68 -
Information and Communication Mobile General Features
Actually, no support is given to access this filesystem via J2METM applications,
but tin the future, it will be offered.

5.3 - Hot Keys

Besides the on-screen keypad and the commands, the following hot keys are pro-
posed as an alternative way to operate the emulator:
Key Function F3 Starts a phone call (green, Call key) F4 Terminates a phone call (red, On/Off/End key) F5 Left soft key F8; Enter; PageDown Right soft key F9 Simulates insertion of a SIM card into phone Cursor keys Control keys Numeric keypad Numeric phone key pad * Phone star key #; / Phone hash key
These keys are only active when the MMI-window is the active one.

5.4 - Commands

The “Commands” window contains the commands that can be used to simulate
some environmental events.
To execute any of these commands, double-click on its line in the “Commands”
window.
Figure 5.23: Commands Window
- 69 -
Information and Communication Mobile General Features
The commands are described below:
Group Command Simulated Event MSM Mobile Terminating Call A call to the mobile phone
Disconnect Call by Net Call disconnected by the network Interrupt Call (Reest. Proc.) Simulation of interrupt call
MM No Service No network service is available
Limited Service Limited service (no Internet access) Full Service All the network services are available
Power Begin Low Power Battery is empty
End Low Power Battery is charged
SMS Incoming Short Message Simulation of receiving a new SMS message
Immediate Message Simulation of receiving a new immediate
message
Status Report Simulation of receiving a new status report
message
Toggle Voice Message Simulation of receiving a new voice mes-
sage Switch Off Turn the phone off and close the emulator Start Java Application Start a J2ME™ application (.jad or .jar file)
Note: for specific features, see the “features” section of the desired model.
All the above commands, except the last two, simulate environmental events.
They are divided into four groups: MSM, MM, Power and SMS. Commands in the
MSM group simulate events related to incoming phone calls. Commands in the
MM group simulate the presence or absence of network services. Commands in
the Power group simulate the charge status of the mobile phone battery. Finally,
SMS groups commands simulate reception of text and voice messages. The first
two of these commands (“Incoming Short Message” and “Immediate Message”)
display a window for specifying transport protocol parameters and a message
text:
Figure 5.24: SMS - TPDU Dialog Incoming Message
- 70 -
Information and Communication Mobile General Features
The following parameters, which correspond to appropriate parameters in the
“Deliver” TPDU (Transfer Protocol Data Unit) of the SMS protocol, may be spec-
ified:
• message type indicator (“TP-Type” button);
• originating address (“TP-OA” button);
• protocol identifier (“TP-PID” button);
• data coding scheme (“TP-DCS” button);
• service centre time stamp (“TP-SCTS” button);
• user data (“TP-UD” button).
For full specification of the SMS service and protocol, see the ETSI TS 100
901(V7.4.0) standard. It can be downloaded a full text of this standard, free of
charge, after filling a registration form at the ETSI site http://www.etsi.org
the “ETSI Publications Download Area”, and search for “TS 100 901” in “Standard
type and doc No”.
The previous SMS window also allows to store a SMS message in a file, or to load
it from a file.

5.5 - Additional Emulators Features

5.5.1 - Change microedition.locale

The C60 and MC60 emulators have a new feature available from the “Commands
Window” as follow:
. Go to
Figure 5.25: Command window - locale
- 71 -
Information and Communication Mobile General Features
Choosing the highlighted option, it is possible to set the locale as shown below:
Figure 5.26: Change microedition.locale window
As the previous window shows, this setting neither changes the phone´s display
language nor the available fonts: it only switches the return value of System.get-
Property(“microedition.locale”). The return value follows ISO standard format.
- 72 -
Information and Communication Mobile Specific Features

6 - Specific Features

6.1 - CF62 Emulator

6.1.1 - CF62 GUI Use / MMI Display

The "MMI-Display" represents the user interface of the target device. The figure
below contains the definitions of the keys on the CF62 emulator’s image:
Figure 6.2:C65 Emulator
Menu Options Function Phone LCD colors Zoom 100% or 200% Debugging/Tracing A two-level pull-down menu to turn on/off different boolean options.
Help Contains, in particular, the About option, which gives information about
the current version of the emulator.
- 73 -
Information and Communication Mobile Specific Features

6.1.2 - Mobile Features

Technical Specifications
Network frequency Triband 900/1800/1900 Voice encoding FR, HR, EFR, AMR Weight (in gramme) 85 Volume (cm³) 78 Dimensions(L x W x H in mm) 82 x 45 x 22 Display 132 x 176 64k colors Standy-by time (with standard battery) (max in
hours) 220 Talk time (with standard battery) (max in
hours) 6 Standard battery Li-Ion 600 mAh Charging time (max in hours) 2 Integrated Antenna External loop SIM card Plug-in(3V)
Special Features
JAVATM Wireless Technology yes GPRS Multislot Class 10, Coding scheme 1-4 Mobile Internet Access WAP 1.2.1, parts of 2.0 Voice Dialing yes Voice Recording yes Built-in data and fax modem yes Soft-Data Link yes Infrared interface (IrDA) no
Bluetooth Voice memory no Organizer yes
MS Outlook Remind function yes Date and time in Display yes Alarm function yes Currency converter yes Calculator yes Stopwatch yes Messaging SMS, MMS Intelligent typing (T9) yes Redial list yes List of calls (received/missed) yes Date and time stamp for missed calls yes Menu animations yes Menu format Normal + Jumbo User profiles yes Softkey programmable yes Call wait/call hold yes Conference call yes Call forwarding yes Display call timer and cost yes Keypad lock yes
TM
interface no
TM
98/2000 synchronization yes
- 74 -
Information and Communication Mobile Specific Features
Ringer melodies mono/polyphonic(pre­installed) 16 polyphonics
Melody composer no MP3-Player no Silent alert yes Calling Line Identification (CLI) yes Calling faces yes Calling symbols yes Call filter yes Games yes SIM application toolkit class 3 Colour variants (may vary by country) cool silver Handsfree talking yes Integrated FM Radio no Video Recorder no Camera Clip-on QuickPic with flash as accessory CLDC Version 1.0 MIDP Version 1.0 WMA no MMAPI no Bluetooth API no 3D Game API no Location API no Heap Memory 728 Kb
- 75 -
Information and Communication Mobile

6.2 - C60 Emulator

6.2.1 - C60 GUI Use / MMI Display

The "MMI-Display" represents the user interface of the target device. The figure
below contains the definitions of the keys on the C60 emulator’s image:
Figure 6.1: C60 Emulator
Menu Options Function
Zoom 100% or 200% Debugging/Tracing A two-level pull-down menu to turn on/off different boolean options.
Help Contains, in particular, the About option, which gives information about
the current version of the emulator.
- 76 -
Information and Communication Mobile

6.2.2 - Mobile Features

Technical Specifications
Network frequency Triband Voice encoding AMR, ADPCM Weight (in gramme) 85 Volume (cm³) 91 Dimensions(L x W x H in mm) 110 x 47 x 23 Display 4096 colors, 5 lines, 101 x 80 pixels Standy-by time (with standard battery) (max in hours) Talk time (with standard battery) (max in hours) 5 Standard battery Li-Ion 700 mAh Charging time (max in hours) 2 Integrated Antenna yes SIM card Plug-in(3V)
Special Features
MP3-Player no
TM
JAVA
Wireless Technology GPRS yes Mobile Internet Access WAP 1.2.1 Address book (no. of entries) no Telephone book (SIM card) (no. of entries) Max 250 Telephone book in the phone (no. of entries) Max 500 Voice Dialing yes Voice Recording yes Built-in data and fax modem yes Soft-Data Link yes Infrared interface (IrDA) no
Bluetooth
TM
interface Voice memory yes Organizer yes
MS Outlook
TM
98/2000 synchronization Remind function yes Date and time in Display yes Alarm function yes Currency converter yes Calculator yes Stopwatch yes SMS (Short Message Service) yes Intelligent typing (T9) yes Picture Messaging EMS/MMS EMS/MMS Redial list yes List of calls (received/missed) yes Date and time stamp for missed calls yes Menu animations yes Menu format Normal + Jumbo User profiles yes Softkey programmable yes Call wait/call hold yes Conference call yes Call forwarding yes Display call timer and cost yes Keypad lock yes
250
yes
no
yes
- 77 -
Information and Communication Mobile
Ringer melodies mono/polyphonic(pre­installed, no) Melody composer yes Silent alert yes Calling Line Identification (CLI) yes Calling faces yes Calling symbols yes Call filter yes Games yes SIM application toolkit Class 3 USIM application toolkit no Colour variants (may vary by country) 3 Handsfree talking yes Integrated FM Radio no Camera Built-in JAVA API supported audio files MIDI-0, MIDI-1
Poly, 16
- 78 -
Information and Communication Mobile

6.3 - MC60 Emulator

6.3.1 - MC60 GUI Use / MMI Display

The "MMI-Display" represents the user interface of the target device. The figure
below contains the definitions of the keys on the MC60 emulator’s image:
Figure 6.2: MC60 Emulator
Menu Options Function Phone LCD colors Zoom 100% or 200% Debugging/Tracing A two-level pull-down menu to turn on/off different boolean options.
Help Contains, in particular, the About option, which gives information about
the current version of the emulator.
- 79 -
Information and Communication Mobile

6.3.2 - Mobile Features

Technical Specifications
Network frequency Triband Voice encoding AMR, ADPCM Weight (in gramme) 86 Volume (cm³) 88 Dimensions(L x W x H in mm) 109 x 46 x 21 Display 4096 colors, 7 lines, 101 x 80 pixels Standy-by time (with standard battery) (max in hours) Talk time (with standard battery) (max in hours) 5 Standard battery Li-Ion 700 mAh Charging time (max in hours) 2 Integrated Antenna yes SIM card Plug-in(3V)
Special Features
MP3-Player no
TM
JAVA
Wireless Technology GPRS yes Mobile Internet Access WAP 1.2.1 Address book (no. of entries) no Telephone book (SIM card) (no. of entries) Max 250 Telephone book in the phone (no. of entries) Max 500 Voice Dialing yes Voice Recording yes Built-in data and fax modem yes Soft-Data Link yes Infrared interface (IrDA) no
Bluetooth
TM
interface Voice memory yes Organizer yes
MS Outlook
TM
98/2000 synchronization Remind function yes Date and time in Display yes Alarm function yes Currency converter yes Calculator yes Stopwatch yes SMS (Short Message Service) yes Intelligent typing (T9) yes Picture Messaging EMS/MMS EMS/MMS Redial list yes List of calls (received/missed) yes Date and time stamp for missed calls yes Menu animations yes Menu format Normal + Jumbo User profiles yes Softkey programmable yes Call wait/call hold yes Conference call yes Call forwarding yes Display call timer and cost yes Keypad lock yes
250
yes
no
yes
- 80 -
Information and Communication Mobile
Ringer melodies mono/polyphonic(pre­installed, no) Melody composer yes Silent alert yes Calling Line Identification (CLI) yes Calling faces yes Calling symbols yes Call filter yes Games yes SIM application toolkit Class 3 USIM application toolkit no Colour variants (may vary by country) 3 Handsfree talking yes Integrated FM Radio no Camera Built-in JAVA API supported audio files MIDI-0, MIDI-1, and WAV (ADPCM)
Poly, 16
- 81 -
Information and Communication Mobile

6.4 - M55 Emulator

6.4.1 - M55 GUI Use / MMI Display

The "MMI-Display" represents the user interface of the target device. The figure
below contains the definitions of the keys on the M55 emulator’s image:
Figure 6.3: M55 Emulator
Menu Options Function
Phone LCD colors Zoom 100% or 200% Debugging/Tracing A two-level pull-down menu to turn on/off different boolean options.
Help Contains, in particular, the About option, which gives information about
the current version of the emulator.
- 82 -
Information and Communication Mobile

6.4.2 - Mobile Features

Technical Specifications
Network frequency Triband Voice encoding FR, EFR, HR, AMR Weight (in gramme) 87 Volume (cm³) 71 Dimensions(L x W x H in mm) 100.8 x 45.6 x 20.9 Display 4096 colors, 7 lines, 101 x 80 pixels Standy-by time (with standard battery) (max in hours) Talk time (with standard battery) (max in hours) 5 Standard battery Li-Ion 700 mAh Charging time (max in hours) 2 Integrated Antenna yes SIM card Plug-in(3V)
Special Features
MP3-Player no
TM
JAVA
Wireless Technology GPRS yes Mobile Internet Access WAP 1.2.1 Address book (no. of entries) Max 500 (Flex. Memory) Telephone book (SIM card) (no. of entries) Max 250 (SIM dependent) Telephone book in the phone (no. of entries) Max 500(Flex. Memory) Voice Dialing yes Voice Recording yes Built-in data and fax modem yes Soft-Data Link yes Infrared interface (IrDA) no
Bluetooth
TM
interface Voice memory yes Organizer yes
MS Outlook
TM
98/2000 synchronization Remind function yes Date and time in Display yes Alarm function yes Currency converter yes Calculator yes Stopwatch yes SMS (Short Message Service) / up to 760 char­acteres Intelligent typing (T9) yes Picture Messaging EMS/MMS EMS/MMS Redial list yes List of calls (received/missed) yes Date and time stamp for missed calls yes Menu animations yes Menu format Normal + Jumbo User profiles yes Softkey programmable yes Call wait/call hold yes Conference call yes Call forwarding yes Display call timer and cost yes
250
yes
no
yes
yes/yes
- 83 -
Information and Communication Mobile
Keypad lock yes Ringer melodies mono/polyphonic(pre­installed, no) Melody composer yes Silent alert yes Calling Line Identification (CLI) yes Calling faces yes Calling symbols yes Call filter yes Games yes SIM application toolkit Class 2 + 3 USSD USIM application toolkit no Colour variants (may vary by country) 4 Handsfree talking yes Integrated FM Radio no Camera Clip-on JAVA API supported audio files MIDI-0, MIDI-1, and ADPCM (WAV file with
Poly, 25
Intel DVI format)
- 84 -
Information and Communication Mobile

6.5 - SL55 Emulator

6.5.1 - SL55 GUI Use / MMI Display

The "MMI-Display" represents the user interface of the target device. The figure
below contains the definitions of the keys on the SL55 emulator’s image:
Figure 6.4: SL55 Emulator
Menu Options Function Phone LCD colors Zoom 100% or 200% Debugging/Tracing A two-level pull-down menu to turn on/off different boolean options.
Help Contains, in particular, the About option, which gives information about
the current version of the emulator.
- 85 -
Information and Communication Mobile

6.5.2 - Mobile Features

Technical Specifications
Network frequency Triband Voice encoding FR, EFR, HR, AMR Weight (in gramme) 79 Volume (cm³) 63 Dimensions(L x W x H in mm) 81.6 x 44.5 x 21.9 Display 4096 colors, 7 lines, 101 x 80 pixels Standy-by time (with standard battery) (max in hours) Talk time (with standard battery) (max in hours) 3.5 Standard battery Li-Ion 700 mAh Charging time (max in hours) 2 Integrated Antenna yes SIM card Plug-in(3V)
Special Features
MP3-Player no
TM
JAVA
Wireless Technology GPRS yes Mobile Internet Access WAP 1.2.1 Address book (no. of entries) Max 500 (Flex. Memory) Telephone book (SIM card) (no. of entries) Max 250 (SIM dependent) Telephone book in the phone (no. of entries) Max 500(Flex. Memory) Voice Dialing yes Voice Recording yes Built-in data and fax modem yes Soft-Data Link yes Infrared interface (IrDA) yes
Bluetooth
TM
interface Voice memory yes Organizer yes
MS Outlook
TM
98/2000 synchronization Remind function yes Date and time in Display yes Alarm function yes Currency converter yes Calculator yes Stopwatch yes SMS (Short Message Service) / up to 760 char­acteres Intelligent typing (T9) yes Picture Messaging EMS/MMS EMS/MMS Redial list yes List of calls (received/missed) yes Date and time stamp for missed calls yes Menu animations yes Menu format Normal + Jumbo User profiles yes Softkey programmable yes Call wait/call hold yes Conference call yes Call forwarding yes Display call timer and cost yes
200
yes
no
yes
yes/yes
- 86 -
Information and Communication Mobile
Keypad lock yes Ringer melodies mono/polyphonic(pre­installed, no) Melody composer no Silent alert yes Calling Line Identification (CLI) yes Calling faces yes Calling symbols yes Call filter yes Games yes SIM application toolkit Class 2 + 3 USSD USIM application toolkit no Colour variants (may vary by country) 2 Handsfree talking yes Integrated FM Radio no Camera Clip-on JAVA API supported audio files MIDI-0, MIDI-1, and SMAF (Yamaha sound
Poly, 20
format)
- 87 -
Information and Communication Mobile

6.6 - S55 Emulator

6.6.1 - S55 GUI Use / MMI Display

The "MMI-Display" represents the user interface of the target device. The figure
below contains the definitions of the keys on the S55 emulator’s image:
Figure 6.5: S55 Emulator
Menu Options Function
Phone LCD colors Zoom 100% or 200% Debugging/Tracing A two-level pull-down menu to turn on/off different boolean options.
Help Contains, in particular, the About option, which gives information about
the current version of the emulator.
- 88 -
Information and Communication Mobile

6.6.2 - Mobile Features

Technical Specifications
Network frequency Triband Voice encoding FR, EFR, HR, AMR Weight (in gramme) 85 Volume (cm³) 69 Dimensions(L x W x H in mm) 101 x 42 x 18 Display 256 colors, 7 lines, 101 x 80 pixels Standy-by time (with standard battery) (max in hours) Talk time (with standard battery) (max in hours) 6 Standard battery Li-Ion 700 mAh Charging time (max in hours) 2 Integrated Antenna yes SIM card Plug-in(3V)
Special Features
MP3-Player no
TM
JAVA
Wireless Technology GPRS yes Mobile Internet Access WAP 1.2.1 Address book (no. of entries) Max 500 (Flex. Memory) Telephone book (SIM card) (no. of entries) Max 250 (SIM dependent) Telephone book in the phone (no. of entries) Max 500(Flex. Memory) Voice Dialing yes Voice Recording yes Built-in data and fax modem yes Soft-Data Link yes Infrared interface (IrDA) yes
Bluetooth
TM
interface Voice memory yes Organizer yes
MS Outlook
TM
98/2000 synchronization Remind function yes Date and time in Display yes Alarm function yes Currency converter yes Calculator yes Stopwatch yes SMS (Short Message Service) / up to 760 char­acteres Intelligent typing (T9) yes Picture Messaging EMS/MMS EMS/MMS Redial list yes List of calls (received/missed) yes Date and time stamp for missed calls yes Menu animations yes Menu format Normal + Jumbo User profiles yes Softkey programmable yes Call wait/call hold yes Conference call yes Call forwarding yes Display call timer and cost yes
300
yes
no
yes
yes/yes
- 89 -
Information and Communication Mobile
Keypad lock yes Ringer melodies mono/polyphonic(pre­installed, no) Melody composer no Silent alert yes Calling Line Identification (CLI) yes Calling faces yes Calling symbols yes Call filter yes Games yes SIM application toolkit Class 2 + 3 USSD USIM application toolkit no Colour variants (may vary by country) 2 Handsfree talking yes Integrated FM Radio no Camera Clip-on JAVA API supported audio files MIDI-0, MIDI-1, and SMAF (Yamaha sound
Poly, 20
format)
- 90 -
Information and Communication Mobile

6.7 - C55/C(T)56/2128 Emulator

6.7.1 - C55 GUI Use / MMI Display

The "MMI-Display" represents the user interface of the target device. The figure
below contains the definitions of the keys on the C55 emulator’s image:
Figure 6.6: C55 Emulator
Menu Options Function
Zoom 100% or 200% Debugging/Tracing A two-level pull-down menu to turn on/off different boolean options.
Help Contains, in particular, the About option, which gives information about
the current version of the emulator.
- 91 -
Information and Communication Mobile

6.7.2 - Mobile Features

Technical Specifications
Network frequency Dual band Voice encoding FR, EFR, HR, AMR Weight (in gramme) 80 Volume (cm³) 69 Dimensions(L x W x H in mm) 100.8 x 44 x 21 Display 5 lines, 64 x 101 pixels Standy-by time (with standard battery) (max in hours) Talk time (with standard battery) (max in hours) 6 Standard battery Li-Ion 700 mAh Charging time (max in hours) 2 Integrated Antenna yes SIM card Plug-in(3V)
Special Features
MP3-Player no
TM
JAVA
Wireless Technology GPRS yes Mobile Internet Access WAP 1.2.1 Address book (no. of entries) no Telephone book (SIM card) (no. of entries) Max 250 (SIM dependent) Telephone book in the phone (no. of entries) Max 500(Flex. Memory) Voice Dialing yes Voice Recording yes Built-in data and fax modem no Soft-Data Link yes Infrared interface (IrDA) no
Bluetooth
TM
interface Voice memory no Organizer no
MS Outlook
TM
98/2000 synchronization Remind function yes Date and time in Display yes Alarm function yes Currency converter yes Calculator yes Stopwatch no SMS (Short Message Service) / up to 760 char­acteres Intelligent typing (T9) yes Picture Messaging EMS/MMS EMS Redial list yes List of calls (received/missed) yes Date and time stamp for missed calls yes Menu animations no Menu format Normal + Jumbo User profiles yes Softkey programmable yes Call wait/call hold yes Conference call yes Call forwarding yes Display call timer and cost yes
300
yes
no
no
yes/yes
- 92 -
Information and Communication Mobile
Keypad lock yes Ringer melodies mono/polyphonic(pre­installed, no) Melody composer no Silent alert yes Calling Line Identification (CLI) yes Calling faces yes Calling symbols yes Call filter yes Games yes SIM application toolkit Class 2 + 3 USSD USIM application toolkit no Colour variants (may vary by country) 4 Handsfree talking yes Integrated FM Radio no Camera no JAVA API supported audio files MIDI-0 and ADPCM (WAV file with Intel DVI
Poly, 20
format)
- 93 -
Information and Communication Mobile

6.8 - M(T)50/M46/3118 Emulator

6.8.1 - M50 GUI Use / MMI Display

The "MMI-Display" represents the user interface of the target device. The figure
below contains the definitions of the keys on the M50 emulator’s image:
Figure 6.7: M50 Emulator
Menu Options Function
Zoom 100% or 200% Debugging/Tracing A two-level pull-down menu to turn on/off different boolean options.
Help Contains, in particular, the About option, which gives information about
the current version of the emulator.
- 94 -
Information and Communication Mobile

6.8.2 - Mobile Features

Technical Specifications
Network frequency Dual band Voice encoding FR, EFR, HR Weight (in gramme) 97 Volume (cm³) 82 Dimensions(L x W x H in mm) 109 x 46 x 23 Display 5 lines, 64 x 101 pixels Standy-by time (with standard battery) (max in hours) Talk time (with standard battery) (max in hours) 6 Standard battery Li-Ion 650 mAh Charging time (max in hours) 2 Integrated Antenna yes SIM card Plug-in(3V)
Special Features
MP3-Player no
TM
JAVA
Wireless Technology GPRS yes Mobile Internet Access WAP 1.2.1 Address book (no. of entries) no Telephone book (SIM card) (no. of entries) Max 250 (SIM dependent) Telephone book in the phone (no. of entries) Voice Dialing no Voice Recording no Built-in data and fax modem yes Soft-Data Link yes Infrared interface (IrDA) no
Bluetooth
TM
interface Voice memory no Organizer no
MS Outlook
TM
98/2000 synchronization Remind function yes Date and time in Display yes Alarm function yes Currency converter yes Calculator yes Stopwatch no SMS (Short Message Service) / up to 760 char­acteres Intelligent typing (T9) yes Picture Messaging EMS/MMS EMS Redial list yes List of calls (received/missed) yes Date and time stamp for missed calls yes Menu animations no Menu format Normal + Jumbo User profiles yes Softkey programmable yes Call wait/call hold yes Conference call yes Call forwarding yes Display call timer and cost yes Keypad lock yes
260
yes
no
no
yes/yes
- 95 -
Information and Communication Mobile
Ringer melodies mono/polyphonic(pre­installed, no) Melody composer no Silent alert yes Calling Line Identification (CLI) yes Calling faces yes Calling symbols yes Call filter yes Games yes SIM application toolkit Class 2 + 3 USSD USIM application toolkit no Colour variants (may vary by country) 2 Handsfree talking no Integrated FM Radio no Camera no JAVA API supported audio files MIDI-0
Mono, 20
- 96 -
Loading...