SAMSEM
SMS interface programs for GSM devices
(Gabor Kiss <kissg@sztaki.hu> 1998-2001)
This package is located at ftp://ftp.sztaki.hu/pub/private/kissg/samsem/ and contains 4 programs:
samsemd - a daemon that can receive and deliver incoming messages
asynchronously. You don't rely on size of message store of the
GSM device, you can receive any number of messages without fast
polling.
It is intended to be base of a bidirectional SMS-<anything>
gateway.
Sample configuration file and sample phonebook are included.
spoolmsg - a utility that creates job files for samsemd.
samsem - a command line utility to GSM modules and other modem-like
interfaces to GSM phones.
It allows you to send/receive Short Messages as well as to manipulate
the message store of your device. Run 'samsem' without args
for help. Samsem uses PDU mode with 7 bit encoding to send SMs
so your messages may be up to 160 character long.
Sample configuration file and sample phonebook are included.
cquery - a simple utility to discover capabilities of your device.
Samsem programs are originally written for Siemens M1 GSM module.
However modern GSM devices (made by Falcom, Nokia, Bosch etc.)
use the similar subset of AT+C command set described in ETSI document
GSM 07.05, so Samsem is probably can work with any of them.
Cquery checks the most important AT+C commands against
your hardware. I ask you to send me the output in order
to adapt Samsem programs to as much GSM device as possible.
I have a web page with comparison of different implementations.
URL is http://www.sztaki.hu/~kissg/gsm/at+c.html
Note for native Hungarian speakers about the word "samsem": A program neve nem jelent semmit, de jól rímel az SMS-re. Hofi Géza énekelte a színpadon: "Samsem, samsem, nincs egy vasam sem." :-)
Additional files:
samsem.pl - a PERL library file. It contains common subroutines of samsem
and samsemd as well as GSM device database.
sms.pl - a PERL library file. It contains subroutines for encoding and
decoding PDUs.
lock.pl - a PERL library file. It provides UUCP-style device locking
routines for samsem.
It needs some customization before use.
chat3.pl - replacement of chat2.pl shipped with PERL.
Original chat2.pl uses network dependent constants to handle sockets.
These constants normally come from PERL header (.ph) files which are
generated from C header (.h) files via the h2ph utility.
However several times I had problems when making .ph files.
Moreover I found a bug in chat2.pl around interrupted system
calls. Using of chat3.pl is strongly encouraged.
You should put .pl file into a directory where the Samsem programs can found them. Use standard PERL include directories or edit the 'push(@INC,".");' statement appropriately in the head of the programs.
Samsem package is originally developed and tested under Linux with a Siemens M1 GSM module. It is written in PERL5 so you should be able to run on most Unix systems. I don't hope major portability problems.
It is partially tested under Solaris 2.5, and NetBSD.
Samsem 3.0+ can be configured to adapt to your device. It has a little database that contains differences of implementations. See file samsem.pl for details.
You have to have write access to the serial device where the GSM device is connected to. This is usually writable by group 'uucp' so you may use samsem as setgid 'uucp' if you wants to allow nonprivileged users to access the SMS engine. However if you run samsem in setuid/setgid mode configuration file must be owned by effective uid/gid. Config file must be world unreadable anyway.
Comments and suggestions are welcome.
Additional informations can be found at http://www.sztaki.hu/~kissg/gsm/.
DISCLAIMER.
This software is in the public domain.
This software is distributed with no warranty whatever. The author takes no responsibility for the consequences of its use.