Download instructions:

You may download Ozeki SMS for Linux from the following location as an RPM package: ozekisms-1.0.0-1.i386.rpm (Please be aware of the limitation of the trial version: it randomly changes the text of some of the SMS messages to the text: "Ozeki SMS Trial".)

To install the package simply issue the following command:

rpm -i ozekisms-1.0.0-1.i386.rpm

Note:

  • After the software has been installed please set the appropriate serial device and the SMS service center address in the /etc/smsconf.ini file

  • The server can be started by issuing the following command /etc/init.d/ozekisms start

Mini users guide

After installation make sure you attach your phone to the PC serial port with a phone-to-pc data cable. The first serial port in Linux is called /dev/ttyS0, the second is called /dev/ttyS1. (On Windows /dev/ttyS0 would be called as COM1, and /dev/ttyS1 as COM2). After the phone is attached, the correct serial port and the SMS service center address should be specified in the /etc/smsconf.ini configuration file. When this is done you can start the service. To verify the connection, look at the log file, which is located in the /var/sms/logs/directory!

If the connection seems to be working, you can send an SMS from the command prompt, issue the following command: /usr/bin/sendsms +36203105366 "Hello world". If you want to send an SMS from an application, all you have to do is place a text file in the following directory: /var/sms/folders/outbox. To make sure the Ozeki SMS Server does not send the message before you wish, you can create a lock file to protect your outgoing messages. Here is a short example on how this can be done:

To send an SMS from an application, you must follow these steps:

Step 1 - Create a lock file

touch /var/sms/folders/outbox/mysms.lock

Step 2 - Create the text file

echo "+36201111111" > /var/sms/folders/outbox/mysms
echo "+36209937723" >> /var/sms/folders/outbox/mysms
echo "This is the message text" >> /var/sms/folders/outbox/mysms

Step 3 - Remove the lock file

rm -rf /var/sms/folders/outbox/mysms.lock

When an SMS arrives it is automatically saved to the following directory: /var/sms/folders/inbox. Each message is saved as a separate text file with a random name. Please take at look a the SMS File format to understand how the file is organized:

SMS File Format: 

+36304454171 <- sender phone number
+36304084241 <- receiver phone number
Hello World  <- message text
160          <- message id (1-255)
2003-01-30 04:20:43 <- timestamp
6            <- maximum number of retries to send a message
2            <- message type (1 message, 2 status report)
48           <- GSM status code

SMS Sending Procedures:

  1. Send an SMS

  2. If the SMS is accepted by the service provider for delivery it is saved to the following folder: /var/sms/folders/sent (Note: that the message id is updated in the file!)

  3. If the SMS is not accepted by the service provider it is saved to the following folder: /var/sms/folders/deleted (For example, if an incorrect service center address is specified in the /etc/smsconf.ini file, the SMS will not be accepted by the service provider)

  4. If the SMS is received by the recepient phone, a status report is saved in the following directory /var/sms/folders/received (Note: the message, which the status report belongs to, can be identified by the message id and the recepient phone number)

More information