GSMCTL(8) | System Manager's Manual | GSMCTL(8) |
gsmctl, gsmsiectl - GSM mobile phone control program
gsmctl [-b baudrate] [--baudrate baudrate] [-d device] [--device device] [-h] [--help] [-I init string] [--init init string] [-v] [--version] [-X] [--xonxoff] -o operation | --operation operation | parameters
gsmsiectl [-b baudrate] [--baudrate baudrate] [-d device] [--device device] [-h] [--help] [-I init string] [--init init string] [-v] [--version] [-X] [--xonxoff] -o operation | --operation operation | parameters
gsmctl can request information from or perform operations on an GSM mobile phone.
gsmctl attaches itself to the device given on the command line (usually an GSM modem) using the specified baudrate. If no device is given, the device /dev/mobilephone is used. If no baudrate is given, a default baud rate of 38400 is used.
gsmctl can be used in to modes: If no --operation option is given the parameters specify the status information to be retrieved from the mobile phone. See the section STATUS INFORMATION for more details. If an --operation option is given the requested operation is performed on the mobile using the parameters. See the section OPERATIONS for more details.
gsmsiectl is the same program with some extension for Siemens mobile phones. Some extra OPERATIONS are available in this case.
Error messages are printed to the standard error output. If the program terminates on error the error code 1 is returned.
If called without the --operation option gsmctl prints out default mobile phone status information as specified by the parameters described below:
Note that mobile phones may implement facility locks not documented here.
forw mode reason number [facilityclass] [forwardtime]
enable Call forwarding is enabled. The call forwarding reason, number, and (optionally) forwardtime must be registered beforehand.
register This registers the call forwarding reason, number, and forwardtime in the network.
erase This is the counterpart to register. It erase the call forwarding info in the network.
reason can be any of:
mobilebusy The mobile phone is busy.
noreply The call is not answered in forwardtime seconds.
notreachable Mobile phone cannot be reached (ie. switched off).
all This refers to all forwarding reasons.
allconditional This refers to all conditional forward reasons (mobilebusy, noreply, notreachable).
number is the number the incoming call is forwarded to. See the explanation for lock operation for the meaning of facilityclass. The default for forwardtime is 20 seconds if omitted. forwardtime can be in the range 1..30.
lock facility [facilityclass] [passwd]
v vf vd f fd d Any combination of voice, data and fax.
The default is all if facilityclass is omitted. The passwd is password for the facility. If no password is given this parameter can be omitted.
setop opmode numericname
manual
deregister Deregister from network.
manualautomatic If manual selection fails, automatic mode is entered.
setpw facility [oldpasswd] [newpasswd]
unlock facility [facilityclass] [passwd]
Extra operators for gsmsiectl:
cset
pbook
signal
ring
binary
The following invocation of gsmctl prints out all available status information for the mobile phone connected to /dev/mobilephone
gsmctl all
The output could look like (lines edited to fit):
<ME0> Manufacturer: SIEMENS
<ME1> Model: S10
<ME2> Revision: 06
<ME3> Serial Number: 448058511817585
<OP0> Status: available Long name: 'D1/-TELEKOM' Short name: '' Numeric name: 26201
<OP1> Status: forbidden Long name: 'D2 PRIVAT' Short name: '' Numeric name: 26202
<CURROP0> Long name: 'D1/-TELEKOM' Short name: '' Numeric name: 26201 Mode: automatic
<FLSTAT0> 'CS'
<FLSTAT1> 'PS'
<FLSTAT2> 'SC' Voice Data Fax
<FLSTAT3> 'AO'
<FLSTAT4> 'OI'
<FLSTAT5> 'OX'
<FLSTAT6> 'AI'
<FLSTAT7> 'IR'
<FLCAP0> 'CS' 'PS' 'SC' 'AO' 'OI' 'OX' 'AI' 'IR' 'AB' 'AG' 'AC'
<PW0> 'PS' 8
<PW1> 'SC' 8
<PW2> 'AO' 4
<PW3> 'OI' 4
<PW4> 'OX' 4
<PW5> 'AI' 4
<PW6> 'IR' 4
<PW7> 'AB' 4
<PW8> 'AG' 4
<PW9> 'AC' 4
<CLIP0> on
<FORW0.0> UnconditionalReason Voice inactive number: subaddr: time: -1
<FORW0.1> UnconditionalReason Data inactive number: subaddr: time: -1
<FORW0.2> UnconditionalReason Fax inactive number: subaddr: time: -1
<FORW1.0> MobileBusyReason Voice active number: +494012345678 subaddr: time: -1
<FORW1.1> MobileBusyReason Data inactive number: subaddr: time: -1
<FORW1.2> MobileBusyReason Fax inactive number: subaddr: time: -1
<FORW2.0> NoReplyReason Voice active number: +494012345678 subaddr: time: 20
<FORW2.1> NoReplyReason Data inactive number: subaddr: time: -1
<FORW2.2> NoReplyReason Fax inactive number: subaddr: time: -1
<FORW3.0> NotReachableReason Voice active number: +494012345678 subaddr: time: -1
<FORW3.1> NotReachableReason Data inactive number: subaddr: time: -1
<FORW3.2> NotReachableReason Fax inactive number: subaddr: time: -1
<BATT0> 0 ME is powered by the battery
<BATT1> 100
<BITERR0> 0
<SIG0> 19
The following locks the keys on the mobile phone:
gsmctl -o lock cs
This changes the SIM card PIN from 1234 to 2345:
gsmctl -o setpw sc 1234 2345
Switch off all call forwarding (actually erase the numbers):
gsmctl -o forw erase all
Switch on call forwarding to German D1 voice box:
gsmctl -o forw register notreachable 3313 gsmctl -o forw enable notreachable
Peter Hofmann <software@pxh.de>
Report bugs to software@pxh.de. Include a complete, self-ncontained example that will allow the bug to be reproduced, and say which version of gsmctl you are using.
Copyright © 1999 Peter Hofmann
gsmctl is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.
gsmctl is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details.
You should have received a copy of the GNU Library General Public License along with gsmctl; see the file COPYING. If not, write to the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
gsminfo(7), gsmpb(1), gsmsendsms(1), gsmsmsd(8), gsmsmsstore(1).
Sat Feb 25 05:03:10 UTC 2017 | gsmctl v1.10 |