
SMS README 
----------


Last updated: 1997-01-11 by jaclu@ibk.se



1.0 Introduction
----------------

This file describes the usage of a kermit script that sends SMS messages.

I use it as a mail -> SMS gateway, and also from  the "Big Brother"
network monitor.

If you get this with the BB packet, the kermit script can be found in

BBHOME/etc/sms.scr



2.0 Disclaimer
--------------
My operator uses NOKIA server software, hopefully you can use this also
on Motorola servers, without to much hazzle.



3.0 Terms
---------

SMS     Short Message Service
SMSC    Short Message Service Center
CIMD    Computer Interface to Message Distribution



4.0 Syntax
----------

kermit sms.scr device file number [number [number [...]]]

device is modem device like /dev/cua0

file should contain the message, only first line of file will be sent,
and it MUST be terminated with LF, otherwise the kermit script won't be
able to extract the message.

SMS messages can only be 160 chars, and since nobody would wan't a lengthly
message on a 8 character display, I haven't botherd to handle message 
splitting. If message is to long, it is truncated.

One ore more SMS phonenumbers can be specified, the message will be sent to
each one of them.


5.0 Configuration
---------------

I have done this the easy way, that is I start CIMD with faked checksums,
if anybody manages to generate correct checksums, please mail me.


5.1 Log in to SMSC
------------------

You have to set two variables in sms.scr:

\%b 	phonenumber to you operators SMSC
\%c	login to access CIMD

For Europolitan (Swedish operator) you can use:

\%b 46708222902
\%c cimd3  # (use faked checksums)

This starts the CIMD server, and from now we must ACK all responses.

Don't forget to include your modem prefix to \%b!!

I don't use the "prefix" token from BB, since I also use this script as a
mail->SMS gateway. If you are going to use this, you must anyhow configure
this script, so I hope you don't mind.


5.2 Start a CIMD session
------------------------

The first step in a CIMD session is to identify yourself

You have to set two variables in sms.scr:

\%d	CIMD account
\%e	CIMD password

Unfourtunately, I cant give you theese values ;)

Now you have configured your script and can start to use it!


5.3 Send to all recipients
--------------------------
BB calls the script one time for each recipient, that's a bit of a waste,
but it would just be to much work to get around.

If you call it manually or from sendmail, you can use multiple recipients.



6.0 More info
-------------

The (english) spec of NOKIAS CIMD implementation can be found on:

http://www.europolitan.se/europolitan/fick/tjanst/cimdspec.htm

If you happen to know swedish, you can read more on Europolitans
implementation  on:

http://www.europolitan.se/europolitan/fick/tjanst/faqcimd.htm



7.0 Feedback
------------

Please let me know if you use this with a non NOKIA server, or if
you fix real checksums!

Jacob Lundqvist <jaclu@ibk.se> (SMS:+46-708-555 456)
