Page 2 - GENERAL NOTES - EXCLUSION OF LIABILITY; Copyright; Trademark notice; Status; Confidential / Released
GENERAL NOTES - EXCLUSION OF LIABILITY PRODUCT IS DEEMED ACCEPTED BY RECIPIENT AND IS PROVIDED WITHOUT INTERFACE TO RECIPI- ENT'S PRODUCTS. THE DOCUMENTATION AND/OR PRODUCT ARE PROVIDED FOR TESTING, EVALUA- TION, INTEGRATION AND INFORMATION PURPOSES. THE DOCUMENTATION AND/OR PRODUCT ARE PROVIDED ON ...
Page 3 - Content
Java User’s Guide Content 123 s wm_java_usersguide_v12 Page 3 of 123 2008-02-25 Confidential / Released Content 1 Preface ....................................................................................................................... 11 2 Overview ...............................................
Page 8 - Tables
Java User’s Guide Tables 8 s wm_java_usersguide_v12 Page 8 of 123 2008-02-25 Confidential / Released Tables Table 1: GPRS upload data rate with different number of timeslots, CS2 ................... 46 Table 2: GPRS upload data rate with different number of timeslots, CS4 ................... 46 Tabl...
Page 9 - Figures
Java User’s Guide Figures 10 wm_java_usersguide_v12 Page 9 of 123 2008-02-25 Confidential / Released s Figures Figure 1: Overview ........................................................................................................ 12 Figure 2: Installation of Eclipse ME-Plugin 1.2.3: Dialog box ...
Page 11 - Preface
Java User’s Guide 1 Preface 11 s wm_java_usersguide_v12 Page 11 of 123 2008-02-25 Confidential / Released 1 Preface This document covers the full range of IMP-NG Java products from Siemens, currently includ-ing:1. TC65 Module2. TC65 Terminal3. AC75/AC65 Module4. XT75/XT65 Module Differences between ...
Page 12 - Overview; Related Documents; AT Command Set of your Siemens Wireless product
Java User’s Guide 2 Overview 14 s wm_java_usersguide_v12 Page 12 of 123 2008-02-25 Confidential / Released 2 Overview The ME features an ultra-low profile and low-power consumption for data (CSD and GPRS),voice, SMS and fax. Java technology and several peripheral interfaces on the module allow youto...
Page 13 - Terms and Abbreviations; Abbreviation
Java User’s Guide 2.2 Terms and Abbreviations 14 s wm_java_usersguide_v12 Page 13 of 123 2008-02-25 Confidential / Released 2.2 Terms and Abbreviations Abbreviation Description API Application Program Interface ASC Asynchronous Serial Controller CLDC Connected Limited Device Configuration CSD Circui...
Page 15 - Installation; System Requirements; installed
Java User’s Guide 3 Installation 27 s wm_java_usersguide_v12 Page 15 of 123 2008-02-25 Confidential / Released 3 Installation 3.1 System Requirements The Siemens Mobility Toolkit (SMTK) requires that you have:1. Windows 2000, Windows XP or Windows Vista 1 installed 2. 110 Mbytes free disk space for ...
Page 16 - GPS Evaluation Software
Java User’s Guide 3.2 Installation CD for AC65/AC75 and XT65/XT75 27 s wm_java_usersguide_v12 Page 16 of 123 2008-02-25 Confidential / Released 3.2 Installation CD for AC65/AC75 and XT65/XT75 The Siemens Mobility Toolkit Installation CD includes:• Module Exchange Suite (MES setup is distributed on C...
Page 17 - Installation CD for TC65; Some of the content can only be accessed after the installation.
Java User’s Guide 3.3 Installation CD for TC65 27 s wm_java_usersguide_v12 Page 17 of 123 2008-02-25 Confidential / Released 3.3 Installation CD for TC65 The Siemens Mobility Toolkit Installation CD includes:• Module Exchange Suite (MES setup is distributed on CD under "MES\Setup.exe") • WTK...
Page 18 - Components; Properties; WTK
Java User’s Guide 3.3 Installation CD for TC65 27 s wm_java_usersguide_v12 Page 18 of 123 2008-02-25 Confidential / Released 3.3.1 Components 3.3.1.1 Module Exchange Suite The Module Exchange Suite allows the developer to access the Flash file system on the cellu-lar engine from the development envi...
Page 21 - Port and Receiver
Java User’s Guide 3.3 Installation CD for TC65 27 s wm_java_usersguide_v12 Page 21 of 123 2008-02-25 Confidential / Released 3.3.1.8 GPS Evaluation Software The GPS Evaluation Software (u-center) was developed by u-blox AG, Switzerland. This soft-ware demonstrates the capabilities of global position...
Page 22 - Help
Java User’s Guide 3.4 Set up Java Development Environment with Eclipse IDE (Quick Start-up) 27 s wm_java_usersguide_v12 Page 22 of 123 2008-02-25 Confidential / Released 3.4 Set up Java Development Environment with Eclipse IDE (Quick Start-up) Please complete the following steps to set up your Eclip...
Page 24 - Siemens Mobility Toolkit Installation
Java User’s Guide 3.5 Siemens Mobility Toolkit Installation 27 s wm_java_usersguide_v12 Page 24 of 123 2008-02-25 Confidential / Released 3.5 Siemens Mobility Toolkit Installation The SMTK comes with an installation CD. The installation program automatically installs thenecessary components and IDE ...
Page 25 - Note for installing the SMTK environment on Windows 2000 systems:
Java User’s Guide 3.5 Siemens Mobility Toolkit Installation 27 s wm_java_usersguide_v12 Page 25 of 123 2008-02-25 Confidential / Released IDE please follow the instructions below and in Section 3.5.3 . If no installed IDE is found the SMTK offers to install NetBeans IDE 5.0 and NetBeans Mobility pac...
Page 27 - SMTK Uninstall
Java User’s Guide 3.6 SMTK Uninstall 27 s wm_java_usersguide_v12 Page 27 of 123 2008-02-25 Confidential / Released 3.5.5 Installing Borland JBuilder X, 2005 and 2006 Enterprise/Developer Borland JBuilder can be purchased from http://www.borland.com/jbuilder . There are also 30 days trial versions av...
Page 28 - Software Platform; Software Architecture; Figure 7
Java User’s Guide 4 Software Platform 35 s wm_java_usersguide_v12 Page 28 of 123 2008-02-25 Confidential / Released 4 Software Platform In this chapter, we discuss the software architecture of the SMTK and the interfaces to it. 4.1 Software Architecture The SMTK enables a customer to develop a Java ...
Page 29 - Interfaces
Java User’s Guide 4.2 Interfaces 35 s wm_java_usersguide_v12 Page 29 of 123 2008-02-25 Confidential / Released 4.2 Interfaces 4.2.1 ASC0 - Serial Device ASC0, an Asynchronous Serial Controller, is a 9-wire serial interface. It is described in [2] . With- out a running Java application the module can...
Page 30 - GPS; AT commands via ATCommand
Java User’s Guide 4.2 Interfaces 35 s wm_java_usersguide_v12 Page 30 of 123 2008-02-25 Confidential / Released 4.2.7 GPS The on-board GPS functionality can be accessed in 4 different ways from a Java application.• AT commands via ATCommand • Java API JSR179 • transparent via CommConnection • transpa...
Page 31 - JVM Interfaces; . Documentation for the other APIs; IP Networking; or by parameters given to the connector open method, see; Media; Media package is only supported in TC65. See; Other Interfaces
Java User’s Guide 4.2 Interfaces 35 s wm_java_usersguide_v12 Page 31 of 123 2008-02-25 Confidential / Released 4.2.8 JVM Interfaces Figure 6: Interface Configuration Java ME, CLDC and MIDP were implemented by SUN. IMP-NG is a stripped down version ofMIDP 2.0 prepared by Siemens and does not include ...
Page 32 - Data Flow of a Java Application Running on the Module
Java User’s Guide 4.3 Data Flow of a Java Application Running on the Module 35 s wm_java_usersguide_v12 Page 32 of 123 2008-02-25 Confidential / Released 4.3 Data Flow of a Java Application Running on the Module Figure 7: Data flow of a Java application running on the module. The diagram shows the d...
Page 33 - Handling Interfaces and Data Service Resources; There are multiple AT parsers available; Module States; for information about the AT commands referenced. A state; State 1: Default – No Java Running
Java User’s Guide 4.4 Handling Interfaces and Data Service Resources 35 s wm_java_usersguide_v12 Page 33 of 123 2008-02-25 Confidential / Released 4.4 Handling Interfaces and Data Service Resources To develop Java applications the developer must know which resources, data services andhardware access...
Page 34 - by; State 4: Default – Java Application Active; The I/O pins are configured with
Java User’s Guide 4.4 Handling Interfaces and Data Service Resources 35 s wm_java_usersguide_v12 Page 34 of 123 2008-02-25 Confidential / Released 4.4.1.2 State 2: No Java Running, General Purpose I/O and I2C/SPI The Java application is inactive. There is an AT parser with CSD on ASC0 as well as ASC...
Page 35 - Module State Transitions
Java User’s Guide 4.4 Handling Interfaces and Data Service Resources 35 s wm_java_usersguide_v12 Page 35 of 123 2008-02-25 Confidential / Released 4.4.2 Module State Transitions Figure 12: Module State Transition Diagram Note: No AT parser is available over serial interface ASC0 or ASC1 while a Java...
Page 36 - Maintenance; and; IP Service
Java User’s Guide 5 Maintenance 49 s wm_java_usersguide_v12 Page 36 of 123 2008-02-25 Confidential / Released 5 Maintenance The basic maintenance features of the ME are described below. Explicit details of these func-tions and modes can be found in [1] and [2] . 5.1 IP Service Apart from the standar...
Page 37 - Remote SIM Access; or
Java User’s Guide 5.2 Remote SIM Access 49 s wm_java_usersguide_v12 Page 37 of 123 2008-02-25 Confidential / Released 5.2 Remote SIM Access While Remote SIM Access (RSA) is normally closely coupled with the GSM 07.10 multiplexerthere are some things to keep in mind when using it with Java.• Java mus...
Page 38 - Charging
Java User’s Guide 5.4 Charging 49 s wm_java_usersguide_v12 Page 38 of 123 2008-02-25 Confidential / Released 5.4 Charging Please refer to [1] and [2] for general information about charging. Charging can be monitored by the running Java application. The JVM is active in Charge mode and in Charge-Only...
Page 39 - Shutdown; under- or overtemperature; Manual Shutdown; explains how to handle a switched off situation.; Watchdog; Watchdog class is only available in TC65.
Java User’s Guide 5.7 Shutdown 49 s wm_java_usersguide_v12 Page 39 of 123 2008-02-25 Confidential / Released 5.7 Shutdown If an unexpected shutdown occurs, data scheduled to be written will get lost due to a bufferedwrite access to the flash file system. The best and safest approach to powering down...
Page 40 - Special AT Command Set for Java Applications
Java User’s Guide 5.8 Special AT Command Set for Java Applications 49 s wm_java_usersguide_v12 Page 40 of 123 2008-02-25 Confidential / Released 5.8 Special AT Command Set for Java Applications For the full AT command set refer to [1] . There are differences in the behaviour AT commands issued from ...
Page 41 - Java Commands; AT^SJNET, configuration of Java networking connections; AutoExec Function; for; System Out
Java User’s Guide 5.9 System Out 49 s wm_java_usersguide_v12 Page 41 of 123 2008-02-25 Confidential / Released 5.8.5 Java Commands There is a small set of special Java AT commands:• AT^SJRA, start a Java application • AT^SJNET, configuration of Java networking connections • AT^SJOTAP, start and conf...
Page 42 - ). This can be changed by editing the emulator’s
Java User’s Guide 5.10 GPIO 49 s wm_java_usersguide_v12 Page 42 of 123 2008-02-25 Confidential / Released 5.9.2 File The System.out print can be redirected into log files within the module’s flash file system. Theoutput will be written alternatingly into two files which can be concatenated afterward...
Page 43 - Performance; Java instruction execution; duration of each loop; Instructions (executed twice per pin cycle); frequencyA; frequencyB; as measured with a universal counter; State
Java User’s Guide 5.12 Performance 49 s wm_java_usersguide_v12 Page 43 of 123 2008-02-25 Confidential / Released 5.12 Performance The performance study was focused on comparable performance values under various circum-stances. 5.12.1 Java This section gives information about the Java command executi...
Page 44 - Data Rates on RS-232 API; For details about the software platform and interfaces refer to
Java User’s Guide 5.12 Performance 49 s wm_java_usersguide_v12 Page 44 of 123 2008-02-25 Confidential / Released 5.12.2 Pin I/O The pin I/O test was designed to find out how fast a Java MIDlet can process URCs caused byPin I/O and react to these URCs. The URCs are generated by feeding an input pin w...
Page 45 - Plain Serial Interface; Scenario: A device is connected to ASC0 (refer to; Voice Call in Parallel; Same scenario as in; Scenarios with GPRS/EGDE Connection
Java User’s Guide 5.12 Performance 49 s wm_java_usersguide_v12 Page 45 of 123 2008-02-25 Confidential / Released 5.12.3.1 Plain Serial Interface Scenario: A device is connected to ASC0 (refer to Section 4.2.4 ). The Java application must handle data input and output streams. A simple Java applicatio...
Page 46 - Upload
Java User’s Guide 5.12 Performance 49 s wm_java_usersguide_v12 Page 46 of 123 2008-02-25 Confidential / Released 5.12.3.4 Upload The ME supports up to four uplink time slots for GPRS and up to two for EGDE. The Java appli-cation receives data over RS232 API and sends them over GPRS to a server. Tabl...
Page 47 - Download
Java User’s Guide 5.12 Performance 49 s wm_java_usersguide_v12 Page 47 of 123 2008-02-25 Confidential / Released Figure 17: Scenario for testing data rates on ASC1 with GPRS data upload 5.12.3.5 Download The data rate for downloading data over GPRS/EDGE depends on the number of assignedtimeslots and...
Page 49 - System Time
Java User’s Guide 5.13 System Time 49 s wm_java_usersguide_v12 Page 49 of 123 2008-02-25 Confidential / Released 5.13 System Time When Java starts up, it initializes its time base from the system’s real time clock. If the RTC ischanged by AT command (AT+CCLK) later on, the Java time does not adjust....
Page 50 - MIDlets; MIDlet Documentation; Paused
Java User’s Guide 6 MIDlets 52 s wm_java_usersguide_v12 Page 50 of 123 2008-02-25 Confidential / Released 6 MIDlets The Java ME TM Mobile Information Device Profile (MIDP) provides a targeted Java API for writ- ing wireless applications. The MIDP runs on top of the Connected Limited Device Configura...
Page 51 - paused; Application Management Software; MIDlet
Java User’s Guide 6.2 MIDlet Life Cycle 52 s wm_java_usersguide_v12 Page 51 of 123 2008-02-25 Confidential / Released • notifyDestroyed() – the MIDlet notifies the application management software that it has cleaned up and is done.Note: the only way to terminate a MIDlet is to call notifyDestroyed()...
Page 52 - Hello World MIDlet; Here is a sample HelloWorld program.
Java User’s Guide 6.3 Hello World MIDlet 52 s wm_java_usersguide_v12 Page 52 of 123 2008-02-25 Confidential / Released 6.3 Hello World MIDlet Here is a sample HelloWorld program. /** * HelloWorld.java */ package example.helloworld; import javax.microedition.midlet.*; import java.io.*; public class H...
Page 53 - File Transfer to Module; Module Exchange Suite; . The tools included in this suite are MESdel,; Over the Air Provisioning; See
Java User’s Guide 7 File Transfer to Module 54 s wm_java_usersguide_v12 Page 53 of 123 2008-02-25 Confidential / Released 7 File Transfer to Module 7.1 Module Exchange Suite The Module Exchange Suite allows you to view the Flash file system on the module as a direc-tory from Windows Explorer. Make s...
Page 54 - Security Issues; The serial interface should be mechanically protected.; OTAP; A password should be used to update with OTA (SMS Authentication)
Java User’s Guide 7.3 Security Issues 54 s wm_java_usersguide_v12 Page 54 of 123 2008-02-25 Confidential / Released 7.3 Security Issues The developer should be aware of the following security issues. Security aspects in general arediscussed in Chapter 12 . 7.3.1 Module Exchange Suite The serial inte...
Page 55 - Introduction to OTAP; Install/Update: A new JAR and JAD file are downloaded and installed.
Java User’s Guide 8 Over The Air Provisioning (OTAP) 63 s wm_java_usersguide_v12 Page 55 of 123 2008-02-25 Confidential / Released 8 Over The Air Provisioning (OTAP) 8.1 Introduction to OTAP OTA (Over The Air) Provisioning of Java Applications is a common practice in the Java world.OTAP describes me...
Page 56 - OTAP Parameters; Chapter 6; Parameters
Java User’s Guide 8.3 OTAP Parameters 63 s wm_java_usersguide_v12 Page 56 of 123 2008-02-25 Confidential / Released 8.3 OTAP Parameters There is a set of parameters that control the OTAP procedures. These parameters can eitherbe set by AT command (AT^SJOTAP, refer to [1] during the production of the...
Page 57 - the SM is only limited by the maximum SM length.; Short Message Format
Java User’s Guide 8.4 Short Message Format 63 s wm_java_usersguide_v12 Page 57 of 123 2008-02-25 Confidential / Released The length of the string parameters in the AT command is limited (see Table 10 ), the length in the SM is only limited by the maximum SM length. The minimum set of required parame...
Page 58 - Java File Format; filesystem like
Java User’s Guide 8.5 Java File Format 63 s wm_java_usersguide_v12 Page 58 of 123 2008-02-25 Confidential / Released The values of APPDIR, BEARER and START are used internally and must be lower case. Thepassword (PWD) is case sensitive. The case sensitivity of the other parameter values dependson th...
Page 59 - A suitable Manifest file for the JAD file above might look like:; Procedures
Java User’s Guide 8.6 Procedures 63 s wm_java_usersguide_v12 Page 59 of 123 2008-02-25 Confidential / Released A suitable Manifest file for the JAD file above might look like: 8.6 Procedures 8.6.1 Install/Update Figure 20: OTAP: Install/Update Information Flow (messages in brackets are optional) Whe...
Page 60 - Delete
Java User’s Guide 8.6 Procedures 63 s wm_java_usersguide_v12 Page 60 of 123 2008-02-25 Confidential / Released the old and the new application at the same time, the old application is deleted before the down-load of the new one, therefore it is lost when an error occurs.If install/update was success...
Page 61 - Time Out Values and Result Codes; Section
Java User’s Guide 8.7 Time Out Values and Result Codes 63 s wm_java_usersguide_v12 Page 61 of 123 2008-02-25 Confidential / Released 8.7 Time Out Values and Result Codes Timeouts:• Closedown Timeout: 10 seconds • Safety Timeout: 10 minutes Result Codes: Supported status codes in body of the http POS...
Page 62 - OTAP Tracer; Java Security as described in; How To; files conform to the requirements listed in
Java User’s Guide 8.9 OTAP Tracer 63 s wm_java_usersguide_v12 Page 62 of 123 2008-02-25 Confidential / Released 8.9 OTAP Tracer For easy debugging of the OTAP scenario, the OTAP procedure can be traced over the serialinterface. The trace output shows details of the OTAP procedure and the used parame...
Page 64 - Compile and Run a Program without a Java IDE; Build Results; , or with OTA provisioning. OTA provisioning is described in
Java User’s Guide 9 Compile and Run a Program without a Java IDE 66 s wm_java_usersguide_v12 Page 64 of 123 2008-02-25 Confidential / Released 9 Compile and Run a Program without a Java IDE This chapter explains how to compile and run a Java application without a Java IDE. 9.1 Build Results A JAR fi...
Page 65 - Compile; Command Prompt; Run on the Module with Manual Start; Chapter 7
Java User’s Guide 9.2 Compile 66 s wm_java_usersguide_v12 Page 65 of 123 2008-02-25 Confidential / Released 9.2 Compile • Launch a Command Prompt . This can be done from the Programs menu or by typing „cmd“ at the Run... prompt in the Start menu. • Change to the directory where the code to be compil...
Page 66 - Run on the Module with Autostart; Switch on Autostart
Java User’s Guide 9.4 Run on the Module with Autostart 66 s wm_java_usersguide_v12 Page 66 of 123 2008-02-25 Confidential / Released 9.4 Run on the Module with Autostart • Compile the application at the prompt as discussed in Section 9.2 or in an SMTK integrated IDE. • Transfer the .jar and .jad fil...
Page 67 - Compile and Run a Program with a Java IDE; Setup a New Project; File
Java User’s Guide 10 Compile and Run a Program with a Java IDE 71 s wm_java_usersguide_v12 Page 67 of 123 2008-02-25 Confidential / Released 10 Compile and Run a Program with a Java IDE 10.1 Eclipse 3.1.2 (with ME Plugin 1.2.3) The following description assumes that Eclipse 3.1.2 is installed from S...
Page 70 - Modify Java source file “printme.java” template:
Java User’s Guide 10.1 Eclipse 3.1.2 (with ME Plugin 1.2.3) 71 s wm_java_usersguide_v12 Page 70 of 123 2008-02-25 Confidential / Released Step 2: Modify Java source file “printme.java” template: Figure 28: Create new Eclipse project: Edit some Java commands This application prints the given line via...
Page 71 - Create Package
Java User’s Guide 10.1 Eclipse 3.1.2 (with ME Plugin 1.2.3) 71 s wm_java_usersguide_v12 Page 71 of 123 2008-02-25 Confidential / Released Step 4: Create Jad and Jar file: - Select “Project01”- Open context menu of “Project01” and select Create Package from item J2ME - Jad and Jar file are be created...
Page 72 - Debug Environment; Data Flow of a Java Application in the Debug Environment
Java User’s Guide 11 Debug Environment 97 s wm_java_usersguide_v12 Page 72 of 123 2008-02-25 Confidential / Released 11 Debug Environment 11.1 Data Flow of a Java Application in the Debug Environment Figure 30: Data flow of a Java application in the debug environment In the debug environment the mod...
Page 73 - Emulator; Application Data
Java User’s Guide 11.2 Emulator 97 s wm_java_usersguide_v12 Page 73 of 123 2008-02-25 Confidential / Released 11.2 Emulator The ME emulator is part of the SMTK and is used as the controlling entity for on-device debug-ging. Some values can be configured in the file wtk/bin/WM_Debug_config.ini (see b...
Page 75 - Java IDE; “MIDlet
Java User’s Guide 11.3 Java IDE 97 s wm_java_usersguide_v12 Page 75 of 123 2008-02-25 Confidential / Released 11.3 Java IDE The SMTK is integrated into your Java IDE during installation. Please note that the IDE inte-gration is intended to create MIDlets suitable for the Java enabled module and for ...
Page 76 - Switching Emulator to IMP-NG Emulator; and the device
Java User’s Guide 11.3 Java IDE 97 s wm_java_usersguide_v12 Page 76 of 123 2008-02-25 Confidential / Released Figure 31: NetBeans IDE 5.0 - installed emulators 11.3.1.1 Switching Emulator to IMP-NG Emulator You can switch to the SMTK emulator project dependent using the context menu for projectprope...
Page 77 - Templates
Java User’s Guide 11.3 Java IDE 97 s wm_java_usersguide_v12 Page 77 of 123 2008-02-25 Confidential / Released 11.3.1.2 Templates Templates for a Siemens MIDlet can be found in the file explorer and under NetBeans IDE 5.0menu File → New File... The MIDlet template provides the skeleton of an IMP-NG M...
Page 78 - Examples; The; Press the
Java User’s Guide 11.3 Java IDE 97 s wm_java_usersguide_v12 Page 78 of 123 2008-02-25 Confidential / Released 11.3.1.3 Examples There are three IMP-NG MIDlet sample projects (“HelloSample”, “NetDemo” and“RS232Sample”) included. Each sample project can be selected directly in NetBeans IDE 5.0. You ca...
Page 79 - Compile and Run
Java User’s Guide 11.3 Java IDE 97 s wm_java_usersguide_v12 Page 79 of 123 2008-02-25 Confidential / Released 11.3.1.4 Compile and Run Ensure that the proper emulator will be used and compile the project as normal. Any output willbe shown in the output window in the IDE together with some debugging ...
Page 80 - Switching Java “System.out” to IDE debug window.
Java User’s Guide 11.3 Java IDE 97 s wm_java_usersguide_v12 Page 80 of 123 2008-02-25 Confidential / Released 11.3.1.6 Displaying Java "System.out" in NetBeans IDE window Please prepare redirection of Java “System.out” during a debugging session as described in Section 11.5 Switching Java “S...
Page 81 - from SMTK CD after clicking the
Java User’s Guide 11.3 Java IDE 97 s wm_java_usersguide_v12 Page 81 of 123 2008-02-25 Confidential / Released 11.3.2 Eclipse 3.0 and Eclipse 3.1 We recommend that Eclipse 3.0.1 or higher is to be used. 11.3.2.1 Eclipse 3.0 Please use the customized Eclipse ME Plugin version that is distributed with ...
Page 82 - Using Eclipse with ME Plugin up to Version 1.2.3; to
Java User’s Guide 11.3 Java IDE 97 s wm_java_usersguide_v12 Page 82 of 123 2008-02-25 Confidential / Released 11.3.2.4 Using Eclipse with ME Plugin up to Version 1.2.3 11.3.2.4.1 Additional Configuration of Integrated Emulator The following configuration is displayed after SMTK integration into Ecli...
Page 83 - Siemens IMP-NG TC65 R2 Module; Window
Java User’s Guide 11.3 Java IDE 97 s wm_java_usersguide_v12 Page 83 of 123 2008-02-25 Confidential / Released 11.3.2.4.2 Switching Emulators You can easily switch between different installed emulators by using the preferences of aproject and choosing e.g. Siemens IMP-NG TC65 R2 Module , see figure b...
Page 85 - Manage Devices...
Java User’s Guide 11.3 Java IDE 97 s wm_java_usersguide_v12 Page 85 of 123 2008-02-25 Confidential / Released 11.3.2.5.2 Switching Emulators You can easily switch between different installed emulators by using the properties of a projectand choosing a Device Group, e.g. "Siemens IMP-NG XT75 Wire...
Page 86 - Import Example; The following figure shows the “Hello World” example in the IDE.
Java User’s Guide 11.3 Java IDE 97 s wm_java_usersguide_v12 Page 86 of 123 2008-02-25 Confidential / Released 11.3.2.7 Import Example You can import an existing Eclipse project using the following steps: - Open menu: File → Import → Existing Project into Workspace - Choose the root directory of the ...
Page 87 - Compile and Debug; To build the jar and jad files you have rebuild the project with the; Now you are ready to debug your project.
Java User’s Guide 11.3 Java IDE 97 s wm_java_usersguide_v12 Page 87 of 123 2008-02-25 Confidential / Released 11.3.2.8 Compile and Debug To build the jar and jad files you have rebuild the project with the Create Package function. Open the context menu of the project and go to J2ME → Create Package....
Page 89 - Starting Debug Session without Downloading Java Files
Java User’s Guide 11.3 Java IDE 97 s wm_java_usersguide_v12 Page 89 of 123 2008-02-25 Confidential / Released 11.3.2.9 Starting Debug Session without Downloading Java Files It is possible to start a debugging session without download of the Java files (*.jad and *.jar)again. The emulator has to be s...
Page 91 - Borland JBuilder X; Tools
Java User’s Guide 11.3 Java IDE 97 s wm_java_usersguide_v12 Page 91 of 123 2008-02-25 Confidential / Released 11.3.3 Borland JBuilder X If you want to use JBuilder X and it is not installed, first install JBuilder X and follow the instal-lation wizard instructions. Run the SMTK installation program ...
Page 92 - Micro Debug using “HelloWorld”
Java User’s Guide 11.3 Java IDE 97 s wm_java_usersguide_v12 Page 92 of 123 2008-02-25 Confidential / Released 11.3.3.1 Examples There are sample projects provided with the SMTK. These projects can be found in the JBuild-erSamples directory of the SMTK installation directory. This directory is access...
Page 93 - Set the additional emulator parameter “-noload” and press
Java User’s Guide 11.3 Java IDE 97 s wm_java_usersguide_v12 Page 93 of 123 2008-02-25 Confidential / Released 11.3.3.2 Starting Debug Session without Downloading Java Files It is possible to start a debugging session without download of the Java files (*.jad and *.jar)again. The emulator has to be s...
Page 95 - Breakpoints
Java User’s Guide 11.4 Breakpoints 97 s wm_java_usersguide_v12 Page 95 of 123 2008-02-25 Confidential / Released 11.3.4.1 Examples There are sample projects provided with the SMTK. These projects can be found in the JBuild-erSamples directory of the SMTK installation directory. This directory is acc...
Page 96 - Switching Java “System.out” to IDE Debug Window; “System Out” and
Java User’s Guide 11.5 Switching Java “System.out” to IDE Debug Window 97 s wm_java_usersguide_v12 Page 96 of 123 2008-02-25 Confidential / Released 11.5 Switching Java “System.out” to IDE Debug Window The Java “System.out” can be redirected during a debugging session using a UDP socket con-nection ...
Page 97 - Important Information for Java Debugging on Windows Vista; This section applies only to TC65.
Java User’s Guide 11.6 Important Information for Java Debugging on Windows Vista 97 s wm_java_usersguide_v12 Page 97 of 123 2008-02-25 Confidential / Released 11.6 Important Information for Java Debugging on Windows Vista This section applies only to TC65. Java Debugging on Windows Vista requires th...
Page 98 - Java Security; Secure Data Transfer
Java User’s Guide 12 Java Security 112 s wm_java_usersguide_v12 Page 98 of 123 2008-02-25 Confidential / Released 12 Java Security The Java Security Model follows the specification of MIDP 2.0 and is IMP-NG conforming. Itintegrates only a simple protection domain concept since protection domains are...
Page 99 - Two modes exist for safe data links.; Mode 2
Java User’s Guide 12.1 Secure Data Transfer 112 s wm_java_usersguide_v12 Page 99 of 123 2008-02-25 Confidential / Released Two modes exist for safe data links. Mode 1 : • No examination of the server certificate takes place when setting up the connection. Theauthenticity of the server certificate is...
Page 100 - Create a Secure Data Transfer Environment Step by Step; The certificate exists within the module (
Java User’s Guide 12.1 Secure Data Transfer 112 s wm_java_usersguide_v12 Page 100 of 123 2008-02-25 Confidential / Released Figure 61: Mode 2 - Server Certificate and self signed root Certificate in module form a chain 12.1.1 Create a Secure Data Transfer Environment Step by Step The following steps...
Page 102 - Import CA root certificate and CA private key into java keystore; SetRootCert”
Java User’s Guide 12.1 Secure Data Transfer 112 s wm_java_usersguide_v12 Page 102 of 123 2008-02-25 Confidential / Released 5. Import CA root certificate and CA private key into java keystore - Use the CA Root Certificate for the creation of Java Security Command. See Section 12.5.3 . - Execute comm...
Page 103 - Execution Control; The Java environment of the ME supports two modes.; Standard behavior of the module:; Remove the certificate:
Java User’s Guide 12.2 Execution Control 112 s wm_java_usersguide_v12 Page 103 of 123 2008-02-25 Confidential / Released 12.2 Execution Control The Java environment of the ME supports two modes. Unsecured mode: • The device starts all Java applications (MIDlets). Secured mode: • A condition for the ...
Page 104 - Change to Secured Mode Concept; After this action the module is in the following conditions:
Java User’s Guide 12.2 Execution Control 112 s wm_java_usersguide_v12 Page 104 of 123 2008-02-25 Confidential / Released 12.2.1 Change to Secured Mode Concept Create and insert a customer root certificate:A condition for the change to the secured mode is the existence of a customer root certificatei...
Page 105 - Concept for the Signing the Java MIDlet
Java User’s Guide 12.2 Execution Control 112 s wm_java_usersguide_v12 Page 105 of 123 2008-02-25 Confidential / Released 12.2.2 Concept for the Signing the Java MIDlet Figure 63: Prepare MIDlet for Secured Mode
Page 106 - Application and Data Protection; The default state of MES is ON.; Structure and Description of the Java Security Commands
Java User’s Guide 12.3 Application and Data Protection 112 s wm_java_usersguide_v12 Page 106 of 123 2008-02-25 Confidential / Released 12.3 Application and Data Protection In addition to the Java secured mode it is possible to prevent the activation of the ModuleExchange Suite. When Module Exchange ...
Page 107 - Structure of the Java Security Commands
Java User’s Guide 12.4 Structure and Description of the Java Security Commands 112 s wm_java_usersguide_v12 Page 107 of 123 2008-02-25 Confidential / Released 12.4.1 Structure of the Java Security Commands
Page 109 - Send Java Security Command to the Module; The HTTPS connection or Secure Connection is possible if the
Java User’s Guide 12.4 Structure and Description of the Java Security Commands 112 s wm_java_usersguide_v12 Page 109 of 123 2008-02-25 Confidential / Released 12.4.3 Send Java Security Command to the Module Use a terminal program. Enter: AT^SJSEC Wait for the answer: CONNECTJSEC READY: SEND COMMAND ...
Page 110 - Create a Java Security Environment Step by Step
Java User’s Guide 12.5 Create a Java Security Environment Step by Step 112 s wm_java_usersguide_v12 Page 110 of 123 2008-02-25 Confidential / Released 12.5 Create a Java Security Environment Step by Step 12.5.1 Create Key Store The key store contains the key pairs for signing data. For producing the...
Page 111 - Command: switch on Java Security Mode
Java User’s Guide 12.5 Create a Java Security Environment Step by Step 112 s wm_java_usersguide_v12 Page 111 of 123 2008-02-25 Confidential / Released Command: switch on Java Security Mode Command: switch off Java Security Mode Command: switch on Untrusted Domain (it is possible only inside of the J...
Page 112 - Sign a MIDlet; The central element of Java Security is the; private key; . If Java Security is activated and you; module is destroyed; . You have no chance of deactivating Java; secure the private key
Java User’s Guide 12.6 Attention 112 s wm_java_usersguide_v12 Page 112 of 123 2008-02-25 Confidential / Released 12.5.4 Sign a MIDlet Use the tool “jadtool.jar” to sign a Java MIDlet. This program is in the folder “wkt\bin”. 12.6 Attention The central element of Java Security is the private key . If...
Page 113 - Java Tutorial; Using the AT Command API
Java User’s Guide 13 Java Tutorial 122 s wm_java_usersguide_v12 Page 113 of 123 2008-02-25 Confidential / Released 13 Java Tutorial This small tutorial includes explanations on how to use the AT Command API and suggestionsfor programming MIDlets. The developer should read about MIDlets, Threads and ...
Page 114 - ATCommandResponseListener
Java User’s Guide 13.1 Using the AT Command API 122 s wm_java_usersguide_v12 Page 114 of 123 2008-02-25 Confidential / Released 13.1.1.2 Sending an AT Command to the Device, the send() Method An AT command is sent to the device by using the send() method. The AT command is sentas a string which must...
Page 115 - Data Connections; If a data connection is created with the
Java User’s Guide 13.1 Using the AT Command API 122 s wm_java_usersguide_v12 Page 115 of 123 2008-02-25 Confidential / Released 13.1.1.3 Data Connections If a data connection is created with the ATCommand class, for instance with ‘ atd ’ , an input stream is opened to receive the data from the conne...
Page 116 - AT^SIS commands for Internet services
Java User’s Guide 13.1 Using the AT Command API 122 s wm_java_usersguide_v12 Page 116 of 123 2008-02-25 Confidential / Released These streams behave slightly differently than regular data streams. The streams are notclosed by using the close() method. A stream remains open until the release() method...
Page 117 - Synchronization
Java User’s Guide 13.1 Using the AT Command API 122 s wm_java_usersguide_v12 Page 117 of 123 2008-02-25 Confidential / Released 13.1.1.4 Synchronization For performance reasons no synchronization is done in the ATCommand class. If an instanceof this class has to be accessed from different threads en...
Page 118 - ATCommandListener Interface
Java User’s Guide 13.1 Using the AT Command API 122 s wm_java_usersguide_v12 Page 118 of 123 2008-02-25 Confidential / Released 13.1.3 ATCommandListener Interface The ATCommandListener interface implements callback functions for: • URCs • Changes of the serial interface signals RING, DCD and DSR • O...
Page 119 - Implementation
Java User’s Guide 13.1 Using the AT Command API 122 s wm_java_usersguide_v12 Page 119 of 123 2008-02-25 Confidential / Released 13.1.3.2 Implementation class ATListenerA implements ATCommandListener { public void ATEvent(String Event) { if (Event.indexOf("+CALA: Reminder 1") >= 0) { /* ta...
Page 120 - Registering a Listener with an ATCommand Instance; ATCommandListener
Java User’s Guide 13.1 Using the AT Command API 122 s wm_java_usersguide_v12 Page 120 of 123 2008-02-25 Confidential / Released 13.1.3.3 Registering a Listener with an ATCommand Instance After creating an instance of the ATCommandListener class, it must be passed as a parameter to the ATCommand.addL...
Page 121 - Programming the MIDlet; Threads; Thread; Example
Java User’s Guide 13.2 Programming the MIDlet 122 s wm_java_usersguide_v12 Page 121 of 123 2008-02-25 Confidential / Released 13.2 Programming the MIDlet The life cycle and structure of MIDlets are described in Chapter 6 . Since the MIDlets will run on Java ME TM , all of Java ME TM ’s features, inc...
Page 123 - Differences to the TC45; CommConnection can access both RS232 interfaces ASC0 and ASC1
Java User’s Guide 14 Differences to the TC45 123 s wm_java_usersguide_v12 Page 123 of 123 2008-02-25 Confidential / Released 14 Differences to the TC45 For those who are familiar with the Siemens WM IMP1.0 product (TC45) this is an overview ofthe main differences between this and the IMP-NG product ...