3
This distribution contains a library to access GSM mobile phones
4
through GSM modems or IrDA devices. Features include:
6
* modification of phonebooks stored in the mobile phone or on the
9
* reading and writing of SMS messages stored in the mobile phone
11
* sending and reception of SMS messages
13
Additionally, some simple command line programs are provided to
14
use these functionalities.
19
You need a mobile phone that conforms to the GSM
20
standards ETSI GSM 07.07, ETSI GSM 07.05, and others.
21
Non-GSM mobile phones will not work! Additionally,
22
to access the mobile phone from the computer you will probably need an
23
GSM modem (that would be a PC-CARD, usually). There might be some
24
mobile phones, however, that incorporate directly terminal
25
adapter (TA) functionality. Access via IrDA interfaces is also
28
If you want to compile the library yourself please also read
29
doc/README.developers.
34
This distribution uses autoconf/automake/libtool. See the file
35
INSTALL for generic installation instructions. The default
36
commands for installation under /usr/local would be:
42
If there are any problems you can generate a debug version. See
43
doc/README.developers for details.
46
AVAILABLE DOCUMENTATION
48
For the command line tools UNIX manual pages are available in the
49
doc subdirectory of this distribution. These are installed by
50
default in the directories /usr/local/man1, man7, and man8.
52
See also the files doc/README.developers, doc/README.NLS and doc/FAQ.
57
The following mobile phone/GSM modem combinations are reported to
58
be compatible in varying degrees with the current release:
60
- Nokia 6150/Xircom REM56G.100
61
- Nokia 6150/Options "GSM-Ready(R) Cellular-Only" modem
62
from Option International
63
- Nokia 6210/- (Linux IrDA serial device)
64
- Nokia 8810/- (Linux IrDA serial device)
65
- Siemens S10D/Dr Neuhaus Gipsy Card GSM
66
- Siemens S25/- (Linux IrDA serial device)
67
- Siemens S35i/- (Linux IrDA serial device)
68
- Ericcson SH888/- (Linux IrDA serial device)
69
- Ericsson 6050102/GM 12 GSM module
70
- -/Siemens M20T (stand-alone GSM module)
71
- -/Wavecom WM02 GSM (stand-alone GSM module)
72
- Nokia 7110 (firware rev 4.80)/- (Linux IrDA serial device)
73
- Nokia 8290 (USA GSM 1900MHz)/- (Linux IrDA serial device)
74
- Falcom A2-1/- (stand-alone GSM module)
75
- Ericsson R320s/- (Linux IrDA serial device)
76
- Motorola Timeport 260/- (Serial cable and Linux IrDA serial device)
77
- Motorola Timeport 250/- (Linux IrDA serial device)
78
- Nokia Cellular Card Phone RPE-1 GSM900 and
79
- Nokia Card Phone RPM-1 GSM900/1800
82
Note 1: Some of the mobile phones have an integrated GSM modem
83
that can be accessed via the Linux IrDA drivers.
85
Note 2: Some of the abovementioned phones have still some glitches
86
with gsmlib (and I haven't tested them myself).
88
For the following phones I receive a lot of errors reports:
90
- Ericcson SH888: SMS function don't work with many firmware releases
92
This list is not exhaustive, there are probably many other types of
93
phone or GSM modem that work with gsmlib. Just try it and report back
99
Even though care has been taken in the design and implementation
100
of this software it can not be excluded that this software could
101
destroy data in your mobile phone or may even render your mobile
102
phone useless (by erroneous PIN settings, for example). The
103
author will not be held responsible legally, financially, or in any
104
other form for any kind of damage that might occur from using
107
This software is provided "as is" and without any expressed or implied
108
warranties, including, without limitation, the implied warranties of
109
merchantibility and fitness for any particular purpose.
111
If you are not ready to accept these conditions please don't use
117
This software is available on the LGPL (GNU LIBRARY GENERAL
118
PUBLIC LICENSE), ie. it is allowed to link
119
the library to commercial programs.
121
See the file COPYING for details on the license.
126
There still seem to be some problems with IrDA devices under
127
Linux. There have been reports of gsmlib-based applications
128
(eg. gsmctl) hanging upon startup after initializing the serial port
129
/dev/ircomm. I would be thankful for any input on this problem.
131
If something does not work with your OS platform or the mobile/TA
132
combination please send a complete trace of the compilation or the
133
program execution that did fail. Make sure to compile with debugging
134
information enabled. Otherwise it will not be possible for me to do
135
much about the problem. Send bug reports to the mailing list or
136
to software@pxh.de. I promise not to publish telephone numbers or other
137
private information that might be contained in the execution traces
143
There are now two mailings lists available for announcements and
144
discussion of gsmlib-related issues (hosted on lists.over.net).
145
Refer to these pages for information on subscription procedures
146
and an archive of previous postings:
148
http://lists.over.net/mailman/listinfo/gsmlib-announce/
149
for announcements regarding GSMLIB
151
http://lists.over.net/mailman/listinfo/gsmlib-devel/
152
the GSMLIB development list
157
Peter Hofmann <software@pxh.de>.
added
removed
README
