1 .TH SMS9110 1 "7 Sep 1999" ~ VERSION ~ "SMS9110 Manual"
6 sms9110 \- send SmartMessaging SMSes through Nokia 9110
10 .RB [ "-c <cfgfile>" ]
14 .RB [ "-l <lockfile>" ]
21 .RB [ "<dest. phone>" ]
22 .RB [ "<logo filename>" ]
26 Program sends one SmartMessaging SMS through Nokia 9110 device.
30 .BR -c | --config\ < cfgfile >
31 Process recursively this file and read all options from it. See the section
35 .BR -d | --device\ < device >
36 Specify serial device to communicate with Nokia. If only bare name is
37 specified, "\fB/dev/\fP" is prepended automatically. This device name is used
42 .BR -L | --log\ < file >
43 Log all important messages to this file preceded by timestamp, machine hostname
44 etc., similar to output of
46 If set to empty string (which is default - ~\fB DEF_LOGNAME \fP~), nothing
49 .BR -b | --baud\ < rate >
50 Sets custom baudrate for accessing Nokia modem. Supported speeds are currently:
56 \fB57600\fP. Default is \fB DEF_BAUD \fP.
58 .BR -l | --lockfile\ < lockfile >
59 Prior to accessing serial device specified above the lockfile should be
60 acquired for correct concurrent processes behaviour. Although this name
61 can be given as direct filename more common method is to use pattern
62 with embedded "\fB%s\fP" where this mark is replaced by actual basename
63 (last component of pathname with all preceding directory names stripped)
64 of serial device used.
65 Default name for lockfile is ~\fB DEF_LOCKFILE \fP~.
67 .BR -s | --smsc\ < smsc\ # >
68 Specify custom SMS center number. If not specified (or overriden as empty
69 string by \fB-s ""\fP)
71 asks by "\fBAT+CSCA?\fP"
72 Siemens A1 for its default SMS center. Situation with undeterminable SMS center
73 is unrecoverable and casues immediate fail. It is a common practice to use
74 plus sign ("\fB+\fP") to indicate international number type.
75 Known SMS centers as of May 1999:
78 .BR "CZ Paegas " ( "230 01" "): " +420603052000
80 .BR "CZ EuroTel " ( "230 02" "): " +420602909909
83 .BR -m | --maxretry\ < # >
84 Maximum retries of any \fBAT\fP-style command during the session. All the
85 retries are summed during one run of
87 and no more retries of the command are permitted. After exceeding this
88 value the program is terminated.
90 .BR -r | --readtime\ < sec >
91 Maximum response read timeout before give up.
93 sends the requested \fBAT\fP-style command to
95 and expects response. After exceeding this time interval,
97 is terminated immediately,
99 parameter notwithstanding. Standard value is
101 seconds and should be enough for any voice call.
103 .BR -t | --chartime\ < msec >
104 Although the fixed used baudrate of
106 is pretty low, MobilDock/Siemens A1 couple
108 able to accept steady
109 stream of data at this speed. Even the used XON/XOFF handshaking is just not
110 enough. The only possible workaround is to slowdown the communication by
111 waiting a bit after character sent to give relax time to these devices.
112 When full rate communication was used, occasional longer SMS data corruption
113 was observed. Argument is given in milliseconds and its default value is
115 \fB(This paragraph\fP
117 \fBapply to Nokia 9110 but the functionality has been
118 retained just to be on the safe side.)\fP
120 .BR -T | --cmdtime\ < msec >
121 This delay is given before sending any
124 Its primary purpose is to let any previous entered commands to finish and
125 to clear any input before actually sending our own command. Also all Siemens
126 devices are known that they strongly dislike fast edge-to-edge communication
127 and to satisfy these requirements this delay was considered as the best
131 \fBapply to Nokia 9110 but the functionality has been
132 retained just to be on the safe side.)\fP
137 Increase verbosity level by one. Currently the maximum defined level is
143 Give short parameters description to
145 (standard error output stream).
148 Print the version number and exit.
150 .RB < "dest. phone" >
151 This mandatory parameter specifies the telephone number of the recipient
152 of SmartMessaging message. International prefix character plus
154 is supported the national mode without plus
156 prefix is supported and the meaning is specific to the GSM operator currently
157 being roamed in (NOT the native
159 operator of the SIM card!).
160 This number can be made default in system configuration files, see below
164 .RB < "logo filename" >
165 Here you specifify the filename of the logo file to be uploaded. Currently
166 recognized file formats are \fBNOL\fP (Nokia logo?) and \fBNGG\fP (Nokia
167 Group Graphics). These formats are proprietary by \fBKESSLER Wireless Design\fP
168 and \fBsms9110\fP currently "can't" edit them. More info can be found on:
170 .B http:/ /www.kessler-design.com/wireless/operatorlogo.php3
174 Specify GSM network code to be set on the logo being uploaded. Upon upload to
175 Nokia phone each operator logo has a GSM network code binded with it. When
176 you are registered (even roamed) into such network the logo is displayed on
177 the phone. Current Nokia mobile phones can handle only one logo loaded
178 simultaneously, it will be rewritten by any other upload. You can also
179 specify string ~\fB WORD_GROUP \fP~ to send the logo as group graphics
180 (even from \fBNOL\fP format) or string ~\fB WORD_NET \fP~ to force detection
181 of network code from \fBNOL\fP. The default if this parameter is not specified
182 is ~\fB WORD_NET \fP~ for \fBNOL\fP files and ~\fB WORD_GROUP \fP~ for
187 reads ~\fB CONFIG_MAIN \fP~ followed by ~\fB$HOME CONFIG_HOME \fP~
188 configuration files. The content of these files (and also any file read by
193 syntax with dashes. Newlines are taken as whitespace, both double ("\fB~\fP")
194 and single ("\fB'\fP")
195 quoting is supported. Embedded quote characters can be escaped by backslash
197 Arguments are processes in order as specified in configuration files and
198 finally the command-line of the program itself, overriding any previous
199 values. Although the order of
201 options on one line is preserved the first file is read AFTER all of the
202 current options are processed. Recursive use of
204 is permitted and the files are read in LIFO (Last-In First-Out, AKA stack)
205 order. You should use "\fB-v -v\fP"
206 to see details of option processing with more complex configuration setups.
211 locks the port (see option
213 for details) and opens the serial device with specified baudrate (default
214 \fB DEF_BAUD \fP baud), software handshaking (XON/XOFF style), 8 bits,
215 no parity. Then issues the following commands:
219 is used to fool Nokia and pass the following
221 (ascii decimal code 27) character to Nokia and break it from eventual
223 mode in which it may errorneously remain from previous sessions.
226 Test the responsiveness of Nokia.
228 \fBAT+CSCA="\fPsmc # from user\fB"\fP
229 This command is omitted if
231 is not specified by user (or specified/overriden as empty string \fB""\fP
234 Query the currently set SMC center number to detect possibly unset SMS center.
236 \fBAT+CSMP=81,,0,245\fP
237 Sets PDU type to 81 (\fBSMS-SUBMIT\fP + integer-type for \fBvalidity\fP
238 + \fBUDHI\fP - user data header indicator), PID (protocol identifier) to
239 0 (standard non-converted SMS) and DCS (data coding scheme) to 0xF5
240 (\fBdata coding\fP/\fBmessage class\fP, \fB8-bit data\fP + \fBmobile-equipment\fP
243 \fBAT+CMGS="\fPphone # from user\fB"\fP
244 This command physically sends the message and the resulting "\fB+CMGS:\fP" output
245 is catched and returned as
247 (message reference) number to the user.
249 \fBAT+CSMP=17,,0,0\fP
250 Resets back PDU type to 17 (\fBSMS-SUBMIT\fP + integer-type for \fBvalidity\fP),
251 PID (protocol identifier) to 0 (standard non-converted SMS) and DCS (data coding
252 scheme) to 0 (\fBalphabet indication\fP, \fBdefault 7-bit alphabet\fP).
255 Check that Nokia survived the sending of the message.
260 ETSI documentation for SMS messages in GSM networks
262 .B GNokii, tools and drivers for Nokia mobile phones
263 Nokia logo data format was read from its sources:
264 .B http:/ www.gnokii.org/
266 .B "Developers'" Guide: SMS with the A1
267 Tech note on PDU SMS format etc:
268 .B http:/ /www.siemens.se/telefoner/ovrigtgsm/fragorsvar/a1_sms.pdf
270 .B Technical Description of the Siemens A1
271 Siemens A1 command description
272 .B http:/ /www.siemens.se/telefoner/ovrigtgsm/fragorsvar/a1_manual.pdf
277 Main configuration file
279 \fB$HOME CONFIG_HOME \fP
280 User personalized local configuration file
284 was written by Jan Kratochvil who should be responsible for all the bugs
285 included. Please see the file "\fBAUTHORS\fP"
286 shipped with the original distribution archive for more details.