GSM/SMS/examples/smartmessagingserver/README

   1                                                                   Example
   2                                                   SMART MESSAGING SERVER
   3
   4 INTRODUCTION
   5
   6 Today I see in every magazine, targetted to the average person, advertisements for ringing tones and logo downloads. You have to call a telephone number (0900-principle) and then by acting upon a voice menu you can download a certain ringing tone or graphic. Because this package does not implements a voice box we will use an SMS message to 'order' a ringing tone or groupgraphic. Anyway, if you are interested in implementing such a service using this package, you can look at the Modem::VBox module.
   7
   8 Of course, this is just intented as a demo for the GSM::SMS package. As such, the implementation can be a bit crude. But it should be functional anyway...
   9
  10 To receive a message, you have to send a SMS message that contains which ringing tone or graphic you want to receive. Such command messages consist of a 6 number string. Thge first 2 numbers indicate the type of resource you want to receive; 10 for a group graphic 20 for a ringing tone. The next 4 digits tell the server which file you actually want to receive.
  11
  12 The program maps the first 2 numbers to a directory, inside this directory we find files with a filename like:
  13
  14 nnnn.rtttl
  15 or
  16 nnnn.gif
  17
  18 Just as you thought, thse 'nnnn' are the 4 last digits in the incoming command message.
  19
  20 The program picks up the file and sends it back to the commands message originating address.
  21
  22 USAGE
  23
  24 ./sms --config=<config file>
  25
  26 CONFIG FILE FORMAT
  27
  28 The following directives can be used in the config file.
  29
  30 access=^\+32475,^\+32478
  31         comma seperated access list. The incoming phone number must match
  32         one of these regular expressions to be allowed access.
  33
  34 rtttldir=./media/rtttl
  35         directory where to find ringing tones.
  36
  37 rtttlprefix=20
  38         prefix to use in the 6 digit number to map a command to a ringing tone.
  39
  40 groupgraphicdir=./media/groupgraphics
  41         directory where to find group graphics
  42
  43 groupgraphicprefix=10
  44         prefix to use in the 6 digit number to map a command to a group graphic.
  45
  46 transportconfig=./transport.conf
  47         transport configuration file to use
  48
  49 log=./log.txt
  50         log file to keep date, time, originating phonenumber and file requested. Can be used to keep accountancy.