X-Git-Url: https://git.jankratochvil.net/?p=mdsms.git;a=blobdiff_plain;f=mdsms.1.in;h=43f22266af797137034413b65b4cf0d7fa092ec1;hp=d645d68b6231d1904c0febf0e390fe509a5659ed;hb=3b127365dbbc640bc1a0813b24baa925b99f5079;hpb=024c037ad5868decb5d300355ccd6220848ee220;ds=sidebyside diff --git a/mdsms.1.in b/mdsms.1.in index d645d68..43f2226 100644 --- a/mdsms.1.in +++ b/mdsms.1.in @@ -1,27 +1,55 @@ -.TH MDSMS 1 "17 May 1999" ~ VERSION ~ "SendSMS Manual" +.TH MDSMS 1 "30 Oct 1999" ~ VERSION ~ "MDSMS Manual" .\~ $Id$ .SH NAME -mdsms \- send SMSes through MobilDock +mdsms \- Mobile Device SMS tool .SH SYNOPSIS -.B mdsms +.BR "mdsms --send" [ -mobildock ] +.RB options... +.RB [ "\-f" ] +.BR "" +.BR "" +.br +.BR "mdsms --receive" +.RB options... +.BR "" +.br +.BR "mdsms --logo-send" +.RB options... +.BR "" +.BR "" +.RB [ "" ] +.br +options: .RB [ "-c " ] .RB [ "-d " ] .RB [ "-L " ] +.RB [ "-b " ] .RB [ "-l " ] .RB [ "-s " ] .RB [ "-m <#>" ] .RB [ "-r " ] .RB [ "-t " ] .RB [ "-T " ] -.RB [ "\-fvhV" ] -.RB [ "" ] -.RB [ "" ] +.RB [ "\-vhV" ] .SH DESCRIPTION -Program sends one SMS message through MobilDock device. +Program sends one SmartMessaging SMS through one of the supported mobile +device connected through the serial port. Currently supported: +.RS +.TP +.B Nokia Communicator 9000/9000i +All modes except \fB--logo-send\fP and Nokia multiparts supported. +.TP +.B Nokia Communicator 9110 +All modes except Nokia multiparts supported. This is the only device +with \fB--logo-send\fP capability for now. +.TP +.B Siemens M20 +Firmware revision 2.0 required. All modes except \fB--logo-send\fP supported. +.RE .SH OPTIONS .TP @@ -31,7 +59,7 @@ Process recursively this file and read all options from it. See the section for more information. .TP .BR -d | --device\ < device > -Specify serial device to communicate with MobilDock. If only bare name is +Specify serial device to communicate with your mobile. If only bare name is specified, "\fB/dev/\fP" is prepended automatically. This device name is used subsequently with .BR -l | --lockfile @@ -44,6 +72,15 @@ etc., similar to output of If set to empty string (which is default - ~\fB DEF_LOGNAME \fP~), nothing is logged anywhere. .TP +.BR -b | --baud\ < rate > +Sets custom baudrate for accessing Nokia modem. Supported speeds are currently: +\fB2400\fP, +\fB4800\fP, +\fB9600\fP, +\fB19200\fP, +\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 @@ -58,7 +95,7 @@ Specify custom SMS center number. If not specified (or overriden as empty string by \fB-s ""\fP) .B mdsms asks by "\fBAT+CSCA?\fP" -Siemens A1 for its default SMS center. Situation with undeterminable SMS center +for the current default SMS center. Situation with undeterminable SMS center is unrecoverable and casues immediate fail. It is a common practice to use plus sign ("\fB+\fP") to indicate international number type. Known SMS centers as of May 1999: @@ -74,16 +111,18 @@ Maximum retries of any \fBAT\fP-style command during the session. All the retries are summed during one run of .B mdsms and no more retries of the command are permitted. After exceeding this -value the program is terminated. +value the program is terminated. Exception is \fB--receive\fP which is never +quit after the initial initialisation has been successfuly negotiated. .TP .BR -r | --readtime\ < sec > -Maximum response read timeout before give up. +Maximum response read timeout before command retry. .B mdsms sends the requested \fBAT\fP-style command to +<<<<<<< mdsms.1.in .B MobilDock and expects response. Unfortunately when the voice call is in progress, .B MobilDock -will block any serial device communication and it is impossible to differentiate +€will block any serial device communication and it is impossible to differentiate between calling .B MobilDock and stucked/disconnected one. After exceeding this time interval, @@ -91,8 +130,21 @@ and stucked/disconnected one. After exceeding this time interval, is terminated immediately, .B maxretry parameter notwithstanding. Standard value is +======= +.B Nokia +and expects response. After exceeding this time interval, +.B sms9110 +reissues the last command until the maximum retry count (\fBmaxretry\fP) is exhausted. +Standard value is +>>>>>>> 1.5.2.2 .BR DEF_READTIME -seconds and should be enough for any voice call. +<<<<<<< mdsms.1.in +€seconds and should be enough for any voice call. +======= +seconds and should be enough for standard +.B Nokia +responses. +>>>>>>> 1.5.2.2 .TP .BR -t | --chartime\ < msec > Although the fixed used baudrate of @@ -106,23 +158,35 @@ waiting a bit after character sent to give relax time to these devices. When full rate communication was used, occasional longer SMS data corruption was observed. Argument is given in milliseconds and its default value is .BR DEF_CHARTIME ms. +\fB(This paragraph\fP +.BR "doesn't" +\fBapply to Nokia 9110 but the functionality has been +retained just to be on the safe side.)\fP .TP .BR -T | --cmdtime\ < msec > This delay is given before sending any .B AT-style -command to MobilDock/Siemens A1. +command to Nokia. Its primary purpose is to let any previous entered commands to finish and to clear any input before actually sending our own command. Also all Siemens devices are known that they strongly dislike fast edge-to-edge communication and to satisfy these requirements this delay was considered as the best -approach. The default value is +approach. +\fB(This sentence\fP +.BR "doesn't" +\fBapply to Nokia 9110 but the functionality has been +retained just to be on the safe side.)\fP +The default value is .BR DEF_CMDTIME ms. .TP -.BR -f | --file +<<<<<<< mdsms.1.in +€.BR -f | --file When parameter <\fBmsg text\fP> has been specified, by using this option \fBmdsms\fP will read the file with the <\fBmsg text\fP> filename instead and send its \fBcontents\fP as the SMS message. .TP +======= +>>>>>>> 1.5.2.2 .BR -v | --verbose Increase verbosity level by one. Currently the maximum defined level is .BR 3 , @@ -139,7 +203,7 @@ Print the version number and exit. .TP .RB < "dest. phone" > This mandatory parameter specifies the telephone number of the recipient -of SMS message. International prefix character plus +of SmartMessaging message. International prefix character plus .RB ( + ) is supported the national mode without plus .RB ( + ) @@ -151,7 +215,17 @@ This number can be made default in system configuration files, see below for section .BR CONFIGURATION . .TP -.RB < "msg text" > +.RB < "logo filename" > +Here you specifify the filename of the logo file to be uploaded. Currently +recognized file formats are \fBNOL\fP (Nokia logo?) and \fBNGG\fP (Nokia +Group Graphics). These formats are proprietary by \fBKESSLER Wireless Design\fP +and \fBsms9110\fP currently "can't" edit them. More info can be found on: +.RS +.B http:/ /www.kessler-design.com/wireless/operatorlogo.php3 +.RE +.TP +<<<<<<< mdsms.1.in +€.RB < "msg text" > Here you write the exact body of the message. This parameter should be specified only as one component, although if more found they are concatenated with separating space (" "). But this practice is discouraged as @@ -161,9 +235,22 @@ mess, you may prefer to omit this parameter and the the message text is then read from .I stdin (standard input stream). +======= +.RB < "GSMnet id" > +Specify GSM network code to be set on the logo being uploaded. Upon upload to +Nokia phone each operator logo has a GSM network code binded with it. When +you are registered (even roamed) into such network the logo is displayed on +the phone. Current Nokia mobile phones can handle only one logo loaded +simultaneously, it will be rewritten by any other upload. You can also +specify string ~\fB WORD_GROUP \fP~ to send the logo as group graphics +(even from \fBNOL\fP format) or string ~\fB WORD_NET \fP~ to force detection +of network code from \fBNOL\fP. The default if this parameter is not specified +is ~\fB WORD_NET \fP~ for \fBNOL\fP files and ~\fB WORD_GROUP \fP~ for +\fBNGG\fP files. +>>>>>>> 1.5.2.2 .SH CONFIGURATION -.B mdsms +.B sms9110 reads ~\fB CONFIG_MAIN \fP~ followed by ~\fB$HOME CONFIG_HOME \fP~ configuration files. The content of these files (and also any file read by .BR -c | --config @@ -187,23 +274,29 @@ to see details of option processing with more complex configuration setups. .SH OPERATION Upon startup -.B mdsms +.B sms9110 locks the port (see option .BR -l | --lockfile -for details) and opens the serial device with hardcoded parameters of -19200 baud, software handshaking (XON/XOFF style), 8 bits, no parity. -Then issues the following commands: +for details) and opens the serial device with specified baudrate (default +\fB DEF_BAUD \fP baud), software handshaking (XON/XOFF style), 8 bits, +no parity. Then issues the following commands: .TP -.BR AT +.BR AT .B AT -is used to fool MobilDock and pass the following +<<<<<<< mdsms.1.in +€is used to fool MobilDock and pass the following .B (ascii decimal code 26) character to Siemens A1 and break it from eventual +======= +is used to fool Nokia and pass the following +.B +(ascii decimal code 27) character to Nokia and break it from eventual +>>>>>>> 1.5.2.2 .B AT+CMGS mode in which it may errorneously remain from previous sessions. .TP .B AT -Test the responsiveness of Siemens A1. +Test the responsiveness of Nokia. .TP \fBAT+CSCA="\fPsmc # from user\fB"\fP This command is omitted if @@ -211,30 +304,54 @@ This command is omitted if is not specified by user (or specified/overriden as empty string \fB""\fP .TP \fBAT+CSCA?\fP +<<<<<<< mdsms.1.in Query the currently set SMC 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. .TP -\fBAT+CMGF=0\fP +€\fBAT+CMGF=0\fP Set the default SMS message format to PDU type. Currently Siemens A1 .RB "doesn't" support any other SMS format anyway. +======= +Query the currently set SMC center number to detect possibly unset SMS center. .TP -\fBAT+CMGS=\fP# chars +\fBAT+CSMP=81,,0,245\fP +Sets PDU type to 81 (\fBSMS-SUBMIT\fP + integer-type for \fBvalidity\fP ++ \fBUDHI\fP - user data header indicator), PID (protocol identifier) to +0 (standard non-converted SMS) and DCS (data coding scheme) to 0xF5 +(\fBdata coding\fP/\fBmessage class\fP, \fB8-bit data\fP + \fBmobile-equipment\fP +specific). +>>>>>>> 1.5.2.2 +.TP +<<<<<<< mdsms.1.in +€\fBAT+CMGS=\fP# chars +======= +\fBAT+CMGS="\fPphone # from user\fB"\fP +>>>>>>> 1.5.2.2 This command physically sends the message and the resulting "\fB+CMGS:\fP" output is catched and returned as .B MR (message reference) number to the user. .TP +\fBAT+CSMP=17,,0,0\fP +Resets back PDU type to 17 (\fBSMS-SUBMIT\fP + integer-type for \fBvalidity\fP), +PID (protocol identifier) to 0 (standard non-converted SMS) and DCS (data coding +scheme) to 0 (\fBalphabet indication\fP, \fBdefault 7-bit alphabet\fP). +.TP \fBAT\fP -Check that Siemens A1 survived the sending of the message. +Check that Nokia survived the sending of the message. .SH SEE ALSO .TP .B GSM 03.40 ETSI documentation for SMS messages in GSM networks .TP +.B GNokii, tools and drivers for Nokia mobile phones +Nokia logo data format was read from its sources: +.B http:/ www.gnokii.org/ +.TP .B "Developers'" Guide: SMS with the A1 Tech note on PDU SMS format etc: .B http:/ /www.siemens.se/telefoner/ovrigtgsm/fragorsvar/a1_sms.pdf @@ -252,7 +369,7 @@ Main configuration file User personalized local configuration file .SH AUTHOR -.B mdsms +.B sms9110 was written by Jan Kratochvil who should be responsible for all the bugs included. Please see the file "\fBAUTHORS\fP" shipped with the original distribution archive for more details.