ShortMessage

A processing library to send/receive short messages (SMS).

Maintained by hamzeen Hosted on GitHub Pages — Theme by mattgraham

1. ABOUT

This library wraps around SMSLib to provide a simple API for Processing users. It was tested on both 1.5.1 as well as the latest 2.0 versions of Processing Development Environment (PDE).

2. INSTALLATION

2.1. For Processing 2.0

You can navigate to Tools -> Add Tool... and select ShortMessage.

2.2. For previous versions of Processing (i.e before 2.0)

The instalaltion of this library follows the same process of extracting the archive you obtain here to your libraries folder, found inside the sketchbook folder.

2.3. Java COMM Installation

After the instalaltion of the library you also need to install JavaCOMM as this library is essentially a set of wrappers around SMSLib. Installation instructions for it can be found below, all the required files for it can be found inside *extras* folder of the library.

File comm.jar should be copied to JDK_DIR/jre/lib/ext/ (typically, JDK_DIR=C:\Program Files\Java)
File javax.comm.properties should be copied to JDKDIR/jre/lib/
Library files (i.e. win32com.dll for Win32 or the .so Linux library files) should be copied to JDKDIR/jre/bin

If you have more JRE installations, please follow the same with each installation. This is important!. The extras folder here, only contains files required for installation on Windows boxes running on 32-bit (i586) Java.

However, this library should work on all platforms. Hence if you are not on a Windows box, please follow installation instructions tailored for your OS/distribution at, SMSLib Installation
For PROCESSING 2.0: The file, javax.comm.properties also needs to be copied to /processing-2.0/java/lib/ it's an additioanl step for you

Note: This might not work with 64-bit Java installations and it's a known issue with SMSLib as well. Hence in this case, I reccomend you to install 32-bit Java.

3. Examples & Usage

The libray contains two seperate examples on sending/receiving short messages (SMS) with the library. Before you run either of these examples make sure to update the port ("COM3").

If you are to run the SendMessage example, make sure to specify the message center number of your operator, it's the last parameter ("+9477000003") of SendSms constructor.

sender = new SendSms("modem.com1", "COM3", 19200, "Huawei", "E220", "+9477000003");

Also make sure to provide a correct phone number here.

sender.sendMessage("+94777123456","Hello Short Messaging Service.");

4. Credit

SMSLib, for making this library possible.

5. LICENSE

Copyright © 2013 Hamzeen. H. Licensed under the Apache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0
Permission is hereby granted, free of charge, to any person obtaining a copy of this project. It includes the rights to use, fork, modify, merge, publish and distribute.

THE SOURCE OF THIS PROJECT IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.