Described options implemented in current mdsms.c:1.19->1.20 change:

   -x/--xonxoff   -C/--rtscts   -M/--smsmode   -P/--pdusmscmode
Various typos fixed.
SMS center # added for: 230 03
Siemens M20 and M1 (M1 untested...) listed as supported devices

diff --git a/mdsms.1.in b/mdsms.1.in
index a5b9823..ded0992 100644 (file)
--- a/mdsms.1.in
+++ b/mdsms.1.in
@@ -46,13 +46,22 @@ device connected through the serial port. Currently supported:
 .RS
 .TP
 .B Nokia Communicator 9000/9000i
 .RS
 .TP
 .B Nokia Communicator 9000/9000i

-All modes except \fB--logo-send\fP supported.
+All modes except \fB--logo-send\fP/\fB--ring-send\fP supported.

 .TP
 .B Nokia Communicator 9110
 .TP
 .B Nokia Communicator 9110

-All modes supported. This is the only device with \fB--logo-send\fP capability for now.
+All modes supported. This is the only device with \fB--logo-send\fP/\fB--ring-send\fP capability for now.

 .TP
 .B Siemens A1
 .TP
 .B Siemens A1

-Firmware revision 2.0 required. All modes except \fB--logo-send\fP supported.
+Firmware revision 2.0 required. All modes except \fB--logo-send\fP/\fB--ring-send\fP supported.
+These modes \fBcould\fP be supported for this device but unfortunately
+.B mdsms
+currently does not support it.
+.TP
+.B Siemens M20, M1
+All modes except \fB--logo-send\fP/\fB--ring-send\fP supported.
+These modes \fBcould\fP be supported for this device but unfortunately
+.B mdsms
+currently does not support it.

 .RE
 
 .SH OPTIONS
 .RE
 
 .SH OPTIONS


@@ -76,6 +85,15 @@ etc., similar to output of
 If set to empty string (which is default - ~\fB        DEF_LOGNAME     \fP~), nothing
 is logged anywhere.
 .TP
 If set to empty string (which is default - ~\fB        DEF_LOGNAME     \fP~), nothing
 is logged anywhere.
 .TP

+.BR -l | --lockfile\  < lockfile >
+Prior to accessing serial device specified above the lockfile should be
+acquired for correct concurrent processes behaviour. Although this name
+can be given as direct filename more common method is to use pattern
+with embedded "\fB%s\fP" where this mark is replaced by actual basename
+(last component of pathname with all preceding directory names stripped)
+of serial device used.
+Default name for lockfile is ~\fB      DEF_LOCKFILE    \fP~.
+.TP

 .BR -b | --baud\  < rate >
 Sets custom baudrate for accessing Nokia modem. Supported speeds are currently:
 \fB2400\fP,
 .BR -b | --baud\  < rate >
 Sets custom baudrate for accessing Nokia modem. Supported speeds are currently:
 \fB2400\fP,


@@ -85,14 +103,60 @@ Sets custom baudrate for accessing Nokia modem. Supported speeds are currently:
 \fB38400\fP,
 \fB57600\fP. Default is \fB    DEF_BAUD        \fP.
 .TP
 \fB38400\fP,
 \fB57600\fP. Default is \fB    DEF_BAUD        \fP.
 .TP

-.BR -l | --lockfile\  < lockfile >
-Prior to accessing serial device specified above the lockfile should be
-acquired for correct concurrent processes behaviour. Although this name
-can be given as direct filename more common method is to use pattern
-with embedded "\fB%s\fP" where this mark is replaced by actual basename
-(last component of pathname with all preceding directory names stripped)
-of serial device used.
-Default name for lockfile is ~\fB      DEF_LOCKFILE    \fP~.
+.BR -x | --xonxoff
+Turns handshaking mode to \fBXON/XOFF\fP (also called \fBsoftware handshaking\fP).
+Use this mode if you are using only 3-wire serial cable. Device should be
+configured in "\fBAT+IFC=1,1\fP" mode, if \fBAT+IFC\fP command supported. When
+possible, you should rather use \fBRTS/CTS\fP handshaking described in the
+following paragraph. This mode is the default one.
+.TP
+.BR -C | --rtscts
+Turns handshaking mode to \fBRTS/CTS\fP (also called \fBhardware handshaking\fP).
+Use this mode if you are using full 7-wire (approx.) serial cable. Device should be
+configured in "\fBAT+IFC=2,2\fP" mode, if \fBAT+IFC\fP command supported. Try
+to use this mode whenever possible (instead of the default \fBXON/XOFF\fP mode described
+in the previous paragraph). This mode may not be available in your UNIX flavour.
+.TP
+.BR -M | --smsmode
+Forces the SMS mode to use - either \fBpdu\fP or \fB text\fP mode. By default
+.B mdsms
+tries to detect mode to use automatically, \fBPDU\fP mode is preferred. When
+your modem is capable of both modes and you need for some reasone \fBtext\fP
+mode, you may use \fB--smsmode text\fP argument to force it. \fBPDU\fP mode
+is recommended for unattended operation, on the other side \fBtext\fP mode
+should be more compatible when you have compatibility problems with unsupported
+GSM modem. It is recommended to force the exact mode you will be using in
+unattanded operaton. By such way you will prevent failures caused by the other
+mode after possible random communication glitches (and therefore automatic
+.B mdsms
+switchover).
+.TP
+.BR -P | --pdusmscmode
+Forces SMS center prepending mode for \fBPDU mode\fP operation. By default
+.B mdsms
+tries sequentially all the described modes, you should lock it for
+unattanded operation to prevent vain switchovers from random communication
+glitches (also you will notice faster response for "\fBcount-out\fP" or
+"\fBnone\fP" modes):
+.RS
+.TP
+.BR count-in
+The default mode, SMS center is prepended to the \fBPDU\fP and SMS
+.RB "center's"
+length is taken into account during length calculation for "\fBAT+CMGS=\fP#".
+.TP
+.BR count-out
+SMS center is prepended to the \fBPDU\fP but SMS
+.RB "center's"
+length is omitted
+during length calculation for "\fBAT+CMGS=\fP#".
+.TP
+.BR none
+SMS center is \fBNOT\fP prepended to the \fBPDU\fP, SMS center to use by
+GSM modem is taken from the one set by
+\fBAT+CSCA="\fPsmsc # from user\fB"\fP
+command.
+.RE

 .TP
 .BR -s | --smsc\  < smsc\ # >
 Specify custom SMS center number. If not specified (or overriden as empty
 .TP
 .BR -s | --smsc\  < smsc\ # >
 Specify custom SMS center number. If not specified (or overriden as empty


@@ -100,14 +164,17 @@ string by \fB-s ""\fP)
 .B mdsms
 asks by "\fBAT+CSCA?\fP"
 for the current default SMS center. Situation with undeterminable SMS center
 .B mdsms
 asks by "\fBAT+CSCA?\fP"
 for the current default SMS center. Situation with undeterminable SMS center

-is unrecoverable and casues immediate fail. It is a common practice to use
+is unrecoverable and causes immediate fail. Please contact your GSM operator
+customer service if you are in trouble. It is a common practice to use

 plus sign ("\fB+\fP") to indicate international number type.
 plus sign ("\fB+\fP") to indicate international number type.

-Known SMS centers as of May 1999:
+Known SMS centers as of April 2001:

 .RS
 .TP
 .RS
 .TP

-.BR "CZ Paegas " ( "230 01" "): " +420603052000
+.BR "CZ Paegas  " ( "230 01" "): " +420603052000

 .TP
 .BR "CZ EuroTel " ( "230 02" "): " +420602909909
 .TP
 .BR "CZ EuroTel " ( "230 02" "): " +420602909909

+.TP
+.BR "CZ Oskar   " ( "230 03" "): " +420608005681

 .RE
 .TP
 .BR -m | --maxretry\  < # >
 .RE
 .TP
 .BR -m | --maxretry\  < # >


@@ -296,13 +363,13 @@ mode in which it may errorneously remain from previous sessions.
 .B AT
 Test the responsiveness of the device.
 .TP
 .B AT
 Test the responsiveness of the device.
 .TP

-\fBAT+CSCA="\fPsmc # from user\fB"\fP
+\fBAT+CSCA="\fPsmsc # from user\fB"\fP

 This command is omitted if
 .B "smsc #"
 is not specified by user (or specified/overriden as empty string \fB""\fP
 .TP
 \fBAT+CSCA?\fP
 This command is omitted if
 .B "smsc #"
 is not specified by user (or specified/overriden as empty string \fB""\fP
 .TP
 \fBAT+CSCA?\fP

-Query the currently set SMC center number to include it later to the
+Query the currently set SMS center number to include it later to the

 header of SMS PDU format where it is required. If \fBAT+CSCA="\fP...\fB"\fP
 was issued before, this number should match it but no sanity checks are
 currently do so. Also it is used to detect possibly unset SMS center.
 header of SMS PDU format where it is required. If \fBAT+CSCA="\fP...\fB"\fP
 was issued before, this number should match it but no sanity checks are
 currently do so. Also it is used to detect possibly unset SMS center.