Siemens Cellular Engine

JAVA™ User's Guide

Version: 00.02
DocID: TC45_JAVA™ _UG_V00.02
JAVA™ User’s Guide
PRELIMINARY

Document Name: JAVA™ User’s Guide

Version: 00.02
Date: February 04, 2003
™
DocId: TC45_JAVA _UG_V00.02
Status: Preliminary

General note
Product is deemed accepted by Recipient and is provided without interface to Recipient’s products.
The Product constitutes pre-release version and code and may be changed substantially before
commercial release. The Product is provided on an “as is” basis only and may contain deficiencies or
inadequacies. The Product is provided without warranty of any kind, express or implied. To the
maximum extent permitted by applicable law, Siemens further disclaims all warranties, including
without limitation any implied warranties of merchantability, fitness for a particular purpose and
noninfringement of third-party rights. The entire risk arising out of the use or performance of the
Product and documentation remains with Recipient. This Product is not intended for use in life support
appliances, devices or systems where a malfunction of the product can reasonably be expected to
result in personal injury. Applications incorporating the described product must be designed to be in
accordance with the technical specifications provided in these guidelines. Failure to comply with any of
the required procedures can result in malfunctions or serious discrepancies in results. Furthermore, all
safety instructions regarding the use of mobile technical systems, including GSM products, which also
apply to cellular phones must be followed. Siemens AG customers using or selling this product for use
in any applications do so at their own risk and agree to fully indemnify Siemens for any damages
resulting from illegal use or resale. To the maximum extent permitted by applicable law, in no event
shall Siemens or its suppliers be liable for any consequential, incidental, direct, indirect, punitive or
other damages whatsoever (including, without limitation, damages for loss of business profits,
business interruption, loss of business information or data, or other pecuniary loss) arising out the use
of or inability to use the Product, even if Siemens has been advised of the possibility of such damages.
Subject to change without notice at any time.

Copyright notice
Copying of this document and giving it to others and the use or communication of the contents thereof,
are forbidden without express authority. Offenders are liable to the payment of damages. All rights
reserved in the event of grant of a patent or the registration of a utility model or design.

Copyright © Siemens AG 2003

Trademark notice:
™
Java is a registered trademark of Sun Microsystems Inc.

TC45_JAVA™ _UG_V00.02 Page 2 of 6 04.02.2003

JAVA™ User’s Guide
PRELIMINARY
Contents

1 Introduction ................................................................................................................................. 4

1.1 Related documents ................................................................................................................. 4

1.2 Terms and abbreviations......................................................................................................... 4

™
2 Usage of the Java software development kit ......................................................................... 5

2.1 Installation CD ......................................................................................................................... 5

2.2 Requirements .......................................................................................................................... 5
2.3 Debug environment ................................................................................................................. 6

Figures
Figure 1: Debug environment .......................................................................................................................6

TC45_JAVA™ _UG_V00.02 Page 3 of 6 04.02.2003

JAVA™ User’s Guide
PRELIMINARY

1 Introduction
This document describes how to install, configure and run the Java™ Software Development
™ ™
Kit (J2SDK ), version 1.3 which is supports the Wireless Modules Java debug
environment (IMP.Siemens).
™
Before reading this guide you should familiarize yourself with the Java programming
language. To do so we recommend the following Website:
http://java.sun.com

1.1 Related documents

[1] TC45 AT Command Set
[2] TC45 Hardware Interface Description
[3] DSB45 Support Box - Evaluation Kit for Siemens Cellular Engines
[4] Application Note 23: Installing TC45 on DSB45
[5] Mux Guide, version 02.00
[6] Mux Driver Developer Guide, version 02.00
[7] Mux Driver Installation Guide, version 02.00

The latest product information and technical documents are ready for download on the
Siemens Website or may be obtained from your local dealer or the Siemens Sales
department.

To visit the Siemens Website you can use the following link:
http://www.Siemens.com/wm

1.2 Terms and abbreviations

Abbreviation Description
API Application Programming Interface
CSD Circuit Switched Data
DSB45 Evaluation Kit for Siemens cellular engines
IP Internet Protocol
™ ™
J2SDK Java Software Development Kit
TCP Transmission Control Protocol

TC45_JAVA™ _UG_V00.02 Page 4 of 6 04.02.2003

JAVA™ User’s Guide
PRELIMINARY

2 Usage of the Java™ software development kit

2.1 Installation CD
The provided installation CD incorporates all information needed to install the Wireless
™
Modules Java Debug environment “IMP_SIEMENS”.

2.2 Requirements
To run and to translate the Wireless Modules Java™ Debug environment “IMP_SIEMENS” it
™ ™
is necessary to install the J2SDK , version 1.3. To download the requested Java platform
use the following link: http://java.sun.com
™
The platform comprises the Java 2 Software Development Kit, Standard Edition (SDK) and
™
Java Runtime Environment (JRE). Please ensure that the requested free disk space is
™
available before attempting to install the Java 2 SDK software.
Furthermore it is necessary to install the WinMux2k driver that requires either Windows 2000
or Windows XP. The WinMux2k driver is integrated in the debug environment
“IMP_SIEMENS”. In case you wish to retrieve further information please refer to [6] and [7].
Once the download has completed install the IMP_SIEMENS as the debug and development
environment. In addition install the Siemens data exchange software which is required to
™
access the flash file system of the Java module to transfer files into the wireless module.

TC45_JAVA™ _UG_V00.02 Page 5 of 6 04.02.2003

JAVA™ User’s Guide
PRELIMINARY
2.3 Debug environment

at-Parser 2
at-Parser 1
AT-Parser 0

File-System
JVM - JAVA-
application

package
package
siemens.icm.atcommand
siemens.icm.atcommand
AT Command class File class
configurable

TCP/IP
COMM connection HTTP connection
ENIP
Multiplexer configurable

Pin IO/ Pin IO/

ASC0 DAI ASC1
(5 pins) (4 pins)
GSM engine

COM port

Multiplexer

package
package
siemens.icm.atcommand
siemens.icm.atcommand
AT Command class COMM connection COM port

File-System
JVM File class - JAVA-
application

HTTP connection TCP/IP

Debug
environment
PC

Figure 1: Debug environment

™
To debug and develop the Java application for module the PC debug environment
™
“IMP_SIEMENS” is used. The debug environment enables the whole Java environment to
run on the PC. TCP/IP, flash and RS-232 access is emulated on the PC. The API to AT
commands is converted to a serial interface, which is connected to the wireless module. To
run a debug session it is necessary to establish a connection between your wireless module
and your PC. The configuration for the connection is done in file
\IMP_SIEMENS\bin\WMDebug.ini. To debug applications the installation of the WinMux2k
driver is required, regardless if more than one instance of AT parser is used or not. The
WinMux2k driver is integrated in the debug environment “IMP_SIEMENS”. Further
information about the debug environment “IMP_SIEMENS” are available in
™
\IMP_SIEMENS\doc\usage.txt. Technical documents about the Java APIs can be found
using \IMP_SIEMENS\doc\html\index.html.

TC45_JAVA™ _UG_V00.02 Page 6 of 6 04.02.2003