gsmlib

Introduction

This distribution contains a library to access GSM mobile phones through GSM modems. Features include:

modification of phonebooks stored in the mobile phone or on the SIM card
reading and writing of SMS messages stored in the mobile phone
sending and reception of SMS messages

Additionally, some simple command line programs are provided to use these functionalities.

Operating Systems

The software works under Linux (tested with Redhat Linux 6.1 and 7.0) and Win32 (experimental, tested with Windows95 and Windows NT4.0). It has also been ported to FreeBSD.

Requirements

You need a mobile phone that conforms to the GSM standards ETSI GSM 07.07, ETSI GSM 07.05, and others. Non-GSM mobile phones will not work! Additionally, to access the mobile phone from the computer you will probably need an GSM modem (that would be a PC-CARD, usually). There might be some mobile phones, however, that incorporate directly terminal adapter (TA) functionality.

If you want to use Nokia mobile phones without an GSM modem gsmlib will not work for you. Please refer to to http://www.gnokii.org in this case.

Hardware

The following mobile phone/GSM modem combinations are reported to be compatible in varying degrees with the current release:

Nokia 6150/Xircom REM56G.100
Nokia 6150/Options "GSM-Ready(R) Cellular-Only" modem from Option International
Nokia 6210/- (Linux IrDA serial device)
Nokia 8810/- (Linux IrDA serial device)
Siemens S10D/Dr Neuhaus Gipsy Card GSM
Siemens S25/- (Linux IrDA serial device)
Siemens S35i/- (Linux IrDA serial device)
Siemens S45
Siemens TC35T and MC35T
Ericcson SH888/- (Linux IrDA serial device)
Ericsson 6050102/GM 12 GSM module
Ericsson T28s (firmware 000809 1106)
Ericsson T20e (firmware R3A007)
Ericsson R520m
-/Siemens M20T (stand-alone GSM module)
-/Wavecom WM02 GSM (stand-alone GSM module)
Nokia 7110 (firware rev 4.80)/- (Linux IrDA serial device)
Nokia 8290 (USA GSM 1900MHz)/- (Linux IrDA serial device)
Falcom A2-1/- (stand-alone GSM module)
Ericsson R320s/- (Linux IrDA serial device)
Ericsson R520s/-
Motorola Timeport 260/- (Serial cable and Linux IrDA serial device)
Motorola Timeport 250/- (Linux IrDA serial device)
Motorola Timeport P7389/- (Linux IrDA serial device)
Nokia Cellular Card Phone RPE-1 GSM900 and
Nokia Card Phone RPM-1 GSM900/1800
Nokia Cardphone/Compaq iPAQ
Omnipoint technologies Redhawk 2000 GSM modem
Ericsson T28 (but one firmware revision is reported to have problems)
Ericcson T65
Ericcson T39m/Bluetooth
Option International GlobeTrotter PCMCIA
Samsung A300e/- (Linux IrDA)
Sony Ericsson T300/- (Linux IrDA)
"Vierling ECOTEL" GSM Gateway
Nokia 30/- (stand-alone GSM module)

For the following phones I receive a lot of errors reports:

Ericcson SH888: SMS function don't work with many firmware releases

Note 1: Some of the mobile phones have an integrated GSM modem that can be accessed via the Linux IrDA drivers.

Note 2: Some of the abovementioned phones have still some glitches with gsmlib (and I haven't tested them myself).

This list is not exhaustive, there are probably many other types of phone or GSM modem that work with gsmlib. Just try it and report back to me!

Status

The current release is version 1.10.

Disclaimer

Even though care has been taken in the design and implementation of this software it can not be excluded that this software could destroy data in your mobile phone or may even render your mobile phone useless (by erroneous PIN settings, for example). The author will not be held responsible legally, financially, or in any other form for any kind of damage that might occur from using this software.

This software is provided "as is" and without any expressed or implied warranties, including, without limitation, the implied warranties of merchantibility and fitness for any particular purpose.

If you are not ready to accept these conditions please don't use this software.

Copying

This software is available on the LGPL (GNU LIBRARY GENERAL PUBLIC LICENSE), ie. it is allowed to link the library to commercial programs.