MANUAL REVISION HISTORY

COPYRIGHT

No part of this document may be reproduced, distributed, stored in a retrieval system or translated into any language, in any form or by any means, electronic, mechanical, magnetic, optical, photocopying, manual or otherwise, without the prior written permission of MOBITEK System Sdn. Bhd.

TRADEMARK

MOBITEK® is a trademark that belongs to MOBITEK System Sdn. Bhd.

DISCLAIMER

MOBITEK System Sdn. Bhd. (hereafter “MOBITEK”) makes no representations or warranties with respect to the contents hereof and specifically disclaims any implied warranties of merchantability or fitness for any particular purpose.

Furthermore, MOBITEK reserves the right to revise this publication and to make changes from time to time in the contents hereof without obligation to notify any person of such revision or changes.

Trademarks and Registered Trademarks Products and product names mentioned in this document may be trademarks or registered trademarks of their respective owners.

ACKNOWLEDGEMENT

We like to extend our appreciation to the following persons for their contribution in revising this manual:-

One of the kits or components is SMS Application Programming Interface (SMS API ). The type of API is Microsoft’s Component Object Model (COM) in the form of an ActiveX Dll file. We will call it COM-ActiveX.

COM-ActiveX is a Microsoft’s technology (http://www.microsoft.com/com/default.mspx). In order to use COM-ActiveX , SI/SD needs to use Microsoft’s programming language or integrated development environment (IDE) such as VB6, VC++, Visual Studio, Visual Studio.Net, VB.Net and C#.

On the other side, Java is Oracle’s (formerly Sun) technology. Unfortunately, Java cannot use COM-ActiveX. A solution for Java developer is to use Java COM Bridge (JACOB). For more information, please refer to — http://danadler.com/jacob/

With JACOB, SI/SD can use Java with MOBITEK® SMS API.

BENEFITS

Use Java programming language to build a SMS application or SMS gateway.

SI/SD do not need to worry about the firmware changes to the GSM modem. Any underlying changes on GSM modem will not affect SI/SD’s application or system.

LIMITATIONS

Linux not supported.

JACOB belongs to 3rd party.

Warranty of Modem does not cover failure of Java to call SMS API via JACOB. The warranty only covers hardware failure.

REQUIREMENTS

LICENCE AGREEMENT

MOBITEK® SMS API (hereafter refer as “API”) and JACOB is given free of charge. It is completely free of any registration, licensing or deployment fees. It may be deployed freely for use with any third-party software, whether for commercial purpose or not. Therefore, no warranty and support is given.

API must be used together with the GSM Modem supplied.

MOBITEK System Sdn. Bhd. (hereafter refer as “MOBITEK”) shall not be held liable for any loss nor damage as a result of using the API .

API is at beta stage. It is a pre-release version. It may or may not be compatible with the final version of the API will. MOBITEK may change it for the final version.

MOBITEK may not release a final version of this API.

It is not recommended to use the API to build an application that will be deployed.

It is recommended to use the API for the purpose of research and development.

You grant MOBITEK, without charge, the right to use, share and commercialize your feedback in any way and for any purpose.

The API is supplied “as-is.” You bear the risk of using it.

MOBITEK makes no warranty, express nor implied.

You have the ability to give feedback about the API to MOBITEK by writing to support2010@mobitek.com.my

MOBITEK may or may not provide any fix nor patch for the API.

The functionality of API depends on the model of the wireless/SMS/GSM modem. Certain model does not support all the functions.

INSTALLATION GUIDE

SMS/GSM Modem: follow the instruction in SMS Gateway Development CD to set-up the SMS/GSM modem.

MOBITEK® SMS API version 9.0 : follow the instruction in CD to install.

JRE: install JRE version 1.6 from the CD.

JACOB: to install

Unzip the file “jacob-1.14.3.zip” that is in CD

For 32 bit, Copy these 2 files to “System32” folder:

jacob-1.14.3-x64.dll

jacob-1.14.3-x86.dll

For 64 bit, Copy these 2 files to “SysWOW64” folder:

jacob-1.14.3-x64.dll

jacob-1.14.3-x86.dll

ECLIPSE: install from CD; we choose ECLIPSE as the IDE for Java. You may use other IDE.

SETTING-UP ECLIPSE

Objective:-

To set up Eclipse with JACOB.

To use Java language calling functions of “MobitekSMSAPI7.dll” (MOBITEK® SMS API version 9.0) in order to send SMS, read SMS, etc.

For 64 bit user, Before you run the eclipse.exe, right click at the icon eclipse and select “Run As Administrator”. For 32 bit user, you can run eclipse normally.

Add a new project, select “Java Project”

Type “SMSAPIv9” in “Project Name:” Click “Next”.

Go to “Libraries” tab.

Click on “Add External JARs” button

Select the file “jacob.jar” (that was unzip from “jacob-1.14.3.zip”)

The final outcome should be similar to figure below. Click Finish.

Add a new package, named it “SMSAPIv9”.

Add a new class, named it “SMSAPIv9.java”

And your final outcome should be similar to figure below:

Copy the Java sample code (scroll) and paste to “SMSAPIv9.java”.

In the sample code, change the COM port from “11” to the respective COM port:

vMOBITEK = Modem.invoke(“Init”, 11);

In the Java code, change the “0176096718” to the intended recipient’s mobile number