Table of Contents

Name

gsmcaps - GSM devices capacity table (aka "driver").

Description

gsmcaps is an ASCII file which contains an entry for each GSM module brand and model supported by the application. Each entry defines the features and pecularities of each GSM model encoded as a flags matrix. Those flags will be used to "drive" the module.

There is one entry per line, and each line has the format:

modname:capmatrix:datefmt:okaystring:linesep:brand and model name

Lines beginning with '#' are treated as comments and ignored. Empty lines are allowed and ignored. This file is searched for a match on modname.

The field descriptions are:

modname
The short model name that will be used in /etc/gsmdevices to define the GSM model actually connected to the server. This field will be read and compared with the model configured in /etc/gsmdevices and a match occurs on a "first fit" basis. Matchings are case-sensitive.
capmatrix
A numerical value, composed of binary flags, defining the features and behaviour supported by that particular model of GSM module. In order to customize this, if needed, please use the values defined in the header file server/gsmdev.h provided in the program source tree. A value of 0 would mean that the device is essentially worthless, and any device defined as such will be discarded.
datefmt
A short string (3 characters) describing how the device will return the date part of timestamps in incoming SMS when read in text mode. The characters supported in this field are 'y' (for year coded on 2 positions), 'Y' (for year coded on 4 positions), 'm' (for month - 2 positions) and 'd' (for day - 2 positions).
okaystring
The "OK" string the modem sends after acknowledging each AT command, including the heading and trailing line delimiters. Those line delimiters can be specified by any control character recognized by printf() format strings (typically, they will be a mix of \n and / or \r characters). The point of including heading and trailing delimiters is to avoid the potential presence of an "OK" string in some other string data returned by the modem (usual problem of inband signalling). When left blank, this field defaults to the compiled-in MODEM_OKAY define.
linesep
The end-of-line character (or character sequence) used by the modem. Those line delimiters can be specified using any control character(s) recognized by printf() format strings (typically, they will be a mix of \n and / or \r characters). The maximum length for this field is 2 characters, and when left blank, it defaults to <cr><lf>.
brand and model name
This field is basically a comment for the ease of use of the server administrator. It only serves as a guide to help recognize the different models based on more info than just the short model name.

Files

/etc/gsmcaps
/etc/gsmdevices
server/gsmdev.h (in the source tree).

See Also

sms_serv(1) , sendsms(1) , gsmdevices(5) , gsmaccess(5)

Copyright

SMSLink is (c) Les Ateliers du Heron, 1998-2006 by Philippe Andersson <philipa STRUDEL scarlet PUNKT be>. It has been originally written for Scitex Europe, S.A.

Part of the code is (c) Riccardo Facchetti.

The code also includes contributions from Philipp Klaus <pklaus@access.ch>, Andrew Worsley <epaanwo@asac.ericsson.se>, and numerous others. All contributors are acknowledged in the CHANGELOG document, and in the comment headers of the source files they modified.

SMSLink has been released to the public under the GNU GPL.

Home page: <http://smslink.sourceforge.net/ >


Table of Contents