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.
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/ >