Summary of the content on the page No. 1
s
Java User’s Guide
Siemens Cellular Engines
Version: 12
DocId: wm_java_usersguide_v12
Products: TC65, AC65, AC75, XT65, XT75
User’s Guide
Summary of the content on the page No. 2
Java User’s Guide s Document Name: Java User’s Guide Version: 12 Date: 2008-02-25 DocId: wm_java_usersguide_v12 Status Confidential / Released Supported Products: TC65, AC65, AC75, XT65, XT75 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 AN "AS
Summary of the content on the page No. 3
Java User’s Guide s Content 123 Content 1 Preface ....................................................................................................................... 11 2 Overview .................................................................................................................... 12 2.1 Related Documents ......................................................................................... 12 2.2 Terms and Abbreviations ....................................................
Summary of the content on the page No. 4
Java User’s Guide s Content 123 4.2.8.3 Other Interfaces .................................................................. 31 4.3 Data Flow of a Java Application Running on the Module ................................ 32 4.4 Handling Interfaces and Data Service Resources ........................................... 33 4.4.1 Module States ..................................................................................... 33 4.4.1.1 State 1: Default – No Java Running ............................
Summary of the content on the page No. 5
Java User’s Guide s Content 123 5.12.3.4 Upload................................................................................. 46 5.12.3.5 Download ............................................................................ 47 5.13 System Time .................................................................................................... 49 6 MIDlets ....................................................................................................................... 50 6.1 MIDlet Docu
Summary of the content on the page No. 6
Java User’s Guide s Content 123 11.3 Java IDE .......................................................................................................... 75 11.3.1 NetBeans IDE 5.0, NetBeans 5.5 or NetBeans 5.5.x.......................... 75 11.3.1.1 Switching Emulator to IMP-NG Emulator ............................ 76 11.3.1.2 Templates............................................................................ 77 11.3.1.3 Examples ...............................................................
Summary of the content on the page No. 7
Java User’s Guide s Content 123 13 Java Tutorial............................................................................................................ 113 13.1 Using the AT Command API.......................................................................... 113 13.1.1 Class ATCommand........................................................................... 113 13.1.1.1 Instantiation with or without CSD Support......................... 113 13.1.1.2 Sending an AT Command to the Device, th
Summary of the content on the page No. 8
Java User’s Guide s Tables 8 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 Table 3: EDGE upload data rate with two timeslots, CS5............................................ 46 Table 4: EDGE upload data rate with two timeslots, CS9............................................ 46 Table 5: GPRS Download data rate with different number of timeslots, CS
Summary of the content on the page No. 9
Java User’s Guide s Figures 10 Figures Figure 1: Overview ........................................................................................................ 12 Figure 2: Installation of Eclipse ME-Plugin 1.2.3: Dialog box Feature Updates............ 22 Figure 3: Installation of Eclipse ME-Plugin 1.2.3: Dialog box Updates sites to visit...... 22 Figure 4: Installation of Eclipse ME-Plugin 1.2.3: dialog box Search Results............... 23 Figure 5: Installation of Eclipse ME-Plugin 1.2.3:
Summary of the content on the page No. 10
Java User’s Guide s Figures 10 Figure 47: Eclipse 3.2.x ME1.5.x and 1.6.x select System Java Thread for showing breakpoint line in Java source .................................................... 90 Figure 48: JBuilder X – JDK settings............................................................................... 91 Figure 49: JBuilder X – Siemens Library......................................................................... 91 Figure 50: JBuilder X – Sample Projects.........................
Summary of the content on the page No. 11
Java User’s Guide s 1 Preface 11 1Preface This document covers the full range of IMP-NG Java products from Siemens, currently includ- ing: 1. TC65 Module 2. TC65 Terminal 3. AC75/AC65 Module 4. XT75/XT65 Module Differences between the products are noted in the particular chapters. Throughout the docu- ment, all supported products are referred to as ME (Mobile Equipment). For use in file, directory or path names, the string “” represents the actual name of a product, for exam- ple TC
Summary of the content on the page No. 12
Java User’s Guide s 2 Overview 14 2Overview 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 you to easily integrate your application. This document explains how to work with the ME, the installation CD and the tools provided on the installation CD. Figure 1: Overview 2.1 Related Documents List of documents referenced throughout this manual: [1] AT Command Set of your
Summary of the content on the page No. 13
Java User’s Guide s 2.2 Terms and Abbreviations 14 2.2 Terms and Abbreviations Abbreviation Description API Application Program Interface ASC Asynchronous Serial Controller CLDC Connected Limited Device Configuration CSD Circuit-Switched Data DAI Digital Audio Interface DCD Data Carrier Detect DSR Data Set Ready GPIO General Purpose I/O GPRS General Packet Radio Service GPS Global Positioning System HTTP Hypertext Transfer Protocol I/O Input/Output IDE Integrated Development Environment IDS Inte
Summary of the content on the page No. 14
Java User’s Guide s 2.2 Terms and Abbreviations 14 Abbreviation Description URL Universal Resource Locator VBS Visual Basic Script WTK Wireless Toolkit wm_java_usersguide_v12 Page 14 of 123 2008-02-25 Confidential / Released
Summary of the content on the page No. 15
Java User’s Guide s 3 Installation 27 3Installation 3.1 System Requirements The Siemens Mobility Toolkit (SMTK) requires that you have: 1 1. Windows 2000, Windows XP or Windows Vista installed 2. 110 Mbytes free disk space for SMTK 3. Administration privileges 4. Java 2 SDK, Standard Edition 1.4. To install the JDK version 1.4.2_09 provided, follow the instructions in Section 3.5.1 Java 2 SDK, Standard Edition 1.5 is required for TC65. 1 If a Java IDE such as NetBeans IDE 5.0, NetBeans IDE 5.5.
Summary of the content on the page No. 16
Java User’s Guide s 3.2 Installation CD for AC65/AC75 and XT65/XT75 27 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 CD under "MES\Setup.exe") • WTK (is distributed as zip file on the CD e.g. "WTK\ac75_wtk.zip") bin - various tools doc -html - java docs for APIs lib - classes.zip src - various examples • Java SDK J2sdk-1_4_2_09-windows-i586-p.exe • NetBeans IDE 5.0 netbeans-5_0-windows.e
Summary of the content on the page No. 17
Java User’s Guide s 3.3 Installation CD for TC65 27 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 (is distributed as zip file on the CD e.g. "WTK\tc65_wtk.zip") bin - various tools doc -html - java docs for APIs lib - classes.zip src - various examples • Java SDK jdk-1_5_0_07-windows-i586-p.exe • NetBeans IDE 5.5.1 netbeans-5_5_1-windows.exe (NetBeans IDE 5.5.1) netbeans_mob
Summary of the content on the page No. 18
Java User’s Guide s 3.3 Installation CD for TC65 27 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 environment over a serial interface. File transfers from PC to module are greatly facilitated by this suite. The Module Exchange Suite (MES) will be installed under the following directories: • MES executables (e.g. MESCopy.exe, etc.) in the windows system directory (e.g. C
Summary of the content on the page No. 19
Java User’s Guide s 3.3 Installation CD for TC65 27 3.3.1.3 SDK / JDK This is software provided by SUN to support Java application development. SMTK emulator uses the following JDK (stored in JavaSoft Registry key) for starting the Debug Agent: • Registry path: HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\Java Development Kit\1.4 5 HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\Java Development Kit\1.5 • Registry key: JavaHome (e.g. "C:\j2sdk1.4.2_09") 5 JavaHome (e.g. "C:\Program Files\Java\jdk1.5.0_07") •
Summary of the content on the page No. 20
Java User’s Guide s 3.3 Installation CD for TC65 27 3.3.1.6 Eclipse 3.1.2 IDE and Eclipse ME Plugin 1.5.x This is a Java IDE provided by the Eclipse Foundation to support Java application develop- ment. The integration of SMTK into Eclipse with ME Plugin 1.5.0 is supported by the TC65, XT65/XT75 and AC65/AC75 CDs. Eclipse ME Plugin 1.5.5 is only distributed on TC65 CD. The installed Eclipse Version and ME Plugin can be read out after starting Eclipse and selecting: • Eclipse menu Help → About E
