• Installation Instructions
• Prerequisites
• Important Note
• Java Communications Library
• Java Comm Installation
• Installation
• Apache ANT
• Simple logging facade for Java (slf4j)
• Apache Jakarta Commons - NET
• Building SMSLib
• Now what?

Installation Instructions

Prerequisites

To use SMSLib, you should install the following components:

Important Note

Starting from SMSLib v3.4, the installation procedure has changed a bit. Some SMSServer components that required extra dependencies have been pulled out of the main source tree. This was done in order to reduce the required third party libraries & dependency files for those wanting to use the core library.

All other add-on SMSServer components are moved in the /misc/SMSServer/Interfaces/ directory, organized by development status. Installation instructions for these specific components are given in the relevant SMSServer documentation pages.

Java Communications Library

You have two options:

Java Comm Installation

The installation procedure for both the old Java Comm v2 and the new Java Comm v3 is identical.

Java Comm v2 is for Win32 systems and it is available on the Download page.

Java Comm v3 is for Linux systems and it is available for download directly from SUN downloads (registration is required)

To install it, unzip the downloaded archive file in a temporary place and do the following copies:

• File comm.jar should go under JDKDIR/jre/lib/ext/
• File javax.comm.properties should go under JDKDIR/jre/lib/
• Library files (i.e. win32com.dll for Win32 or the .so Linux library files) should go under JDKDIR/jre/bin/

If you have a separate JRE directory, do the same copies for the JREDIR directory!

RxTx Installation

The official RxTx binary pack is available here. The provided link will download the distro with some standard binaries (for linux 32bit, 64 bit, etc). If binaries for your specific operating system are not included, you may consider recompiling RxTx yourselves.

For a custom Win64 RxTx distro, have a look at the CloudHopper's web site.

To install it, unzip the distribution file in a temporary place and do the following copies:

• File RXTXcomm.jar should go under JDKDIR/jre/lib/ext/
• The necessary library (e.g.. for Linux 32bit, the librxtxSerial.so) should go under JDKDIR/jre/bin/

If you have a separate JRE directory, do the same copies for the JREDIR directory!

Apache ANT

Download and install Apache Ant from here.

Simple logging facade for Java (slf4j)

Java logging facade (slf4j) acts as the middle layer between an application and the various logging systems. Download slf4j from here. You need to have the slf4j-api-1.5.6.jar file (1.5.6 was the current version at the time of this writing) somewhere in your classpath or in Java's lib/ext directories, together with one of the following files, depending on which logging system you use:

Apache Jakarta Commons - NET

Download Apache Jakarta Commons/NET from here. You need to have the commons-net-2.0.jar file (2.0 was the current version at the time of this writing) somewhere in your classpath or in Java's lib/ext directories.

Building SMSLib

The ANT build file provides the following targets:

ant

Now what?

If you are new to SMSLib, spend some time with the two examples ReadMessages and SendMessage (located in the src/java/examples/modem folder) to find out the basics of how to read / send messages via your phone.