Linux Certif

Toute la documentation sur la certification Linux LPI

gammu

NAME

Gammu - Does some neat things with your cellular phone or modem.

SYNOPSIS

Usage: gammu [parameters] <command> [options]

DESCRIPTION

This program is a tool for mobile phones. Many vendors and phones are supported, for actual listing see <http://wammu.eu/phones/>.

OPTIONS

Parameters before command configure gammu behaviour:
-c / --config <filename> ... name of configuration file
-s / --section <confign> ... section of config file to use, eg. 42
-d / --debug <level> ... debug level (see gammurc(5) for possible values)
-f / --debug-file <filename> ... file for logging debug messages

Commands

Commands can be specified with or without leading --.

Calls

answercall [ID]

Answer incoming call.

cancelcall [ID]

Cancel incoming call

canceldiverts

Cancel all existing call diverts.

conferencecall ID

Initiates a conference call.

dialvoice number [show|hide]

Make voice call from SIM card line set in phone.

show|hide - optional parameter whether to disable call number indication.

divert get|set all|busy|noans|outofreach all|voice|fax|data [number timeout]

Manage or display call diverts.

get|set - whether to get divert information or to set it.

all|busy|noans|outofreach - condition when apply divert

all|voice|fax|data - call type when apply divert

number - number where to divert

timeout - timeout when the diversion will happen

getspeeddial start [stop]

Gets speed dial choices.

getussd code

Retrieves USSD information - dials a service number and reads response.

holdcall ID

Holds call.

maketerminatedcall number length [show|hide]

Make voice call from SIM card line set in phone which will be terminated after length seconds.

monitor [times]

Get phone status and writes continuously to standard output. Press Ctrl+C to break this state.

senddtmf sequence

Plays DTMF sequence. In some phones available only during calls

splitcall ID

Splits call.

switchcall [ID]

Switches call.

transfercall [ID]

Transfers call.

unholdcall ID

Unholds call.

SMS and EMS

Sending messages might look a bit complicated on first attempt to use. But be patient, the command line has been written in order to allow almost every usage. See EXAMPLE section for some hints on usage.

There is also an option to use gammu-smsd(1) when you want to send or receive more messages and process them automatically.

Common parameters for sendsms and savesms

-smscset number - SMSC will be taken from set number. Default set: 1

-smscnumber number - SMSC number

-reply - reply SMSC is set

-maxnum number - Limit maximal number of messages which will be created. If there are more messages, Gammu will terminate with failure.

-folder number - save to specified folder.

Folders are numerated from 1.

The most often folder 1 = "Inbox", 2 = "Outbox",etc. Use getsmsfolders to get folder list.

-unread - makes message unread. In some phones (like 6210) you won't see unread sms envelope after saving such sms. In some phones with internal SMS memory (like 6210) after using it with folder 1 SIM SMS memory will be used

-read - makes message read. In some phones with internal SMS memory (like 6210) after using it with folder 1 SIM SMS memory will be used

-unsent - makes message unsent

-sent - makes message sent

-sender number - set sender number

-smsname name - set message name

-sender number - set sender number (default: "Gammu")

-report - request delivery report for message

-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX - sets how long will be the message valid (SMSC will the discard the message after this time if it could not deliver it).

-save - will also save message which is being sent

addsms folder file [-yes]

Adds SMSes from file (format like backupsms uses) to selected folder in phone.

addsmsfolder name

backupsms file [-yes|-all]

Stores all SMSes from phone to file.

Use -yes for answering yes to all questions (backup all messages and delete them from phone), or -all to just backup all folders while keeping messages in phone.

deleteallsms folder

Delete all SMS from specified SMS folder.

deletesms folder start [stop]

Delete SMS from phone. See description for getsms for info about sms folders naming convention.

Locations are numerated from 1.

displaysms ... (options like in sendsms)

Displays PDU data of encoded SMS messages. It accepts same parameters and behaves same like sendsms.

getallsms -pbk

Get all SMS from phone. In some phones you will have also SMS templates and info about locations used to save Picture Images. With each sms you will see location. If you want to get such sms from phone alone, use gammu getsms 0 location

geteachsms -pbk

Similiary to getallsms. Difference is, that links all contacenated sms

getsms folder start [stop]

Get SMS.

Locations are numerated from 1.

Folder 0 means that sms is being read from "flat" memory (all sms from all folders have unique numbers). It's sometimes emulated by Gammu. You can use it with all phones.

Other folders like 1, 2, etc. match folders in phone such as Inbox, Outbox, etc. and each sms has unique number in his folder. Name of folders can depend on your phone (the most often 1="Inbox", 2="Outbox", etc.). This method is not supported by all phones (for example, not supported by Nokia 3310, 5110, 6110). If work with your phone, use getsmsfolders to get folders list.

getsmsc [start [stop]]

Get SMSC settings from SIM card.

Locations are numerated from 1.

getsmsfolders

Get names for SMS folders in phone

nokiagett9

restoresms file [-yes]

Restores SMSes from file (format like backupsms uses) to selected folder in phone. Please note that this overwrites existing messages in phone (if it supports it).

savesms ANIMATION frames file1 file2... [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Save an animation as a SMS. You need to give number of frames and picture for each frame. Each picture can be in any picture format which Gammu supports (B/W bmp, gif, wbmp, nol, nlm...).

For description of shared parameters see Common parameters for sendsms and savesms.

savesms BOOKMARK file location [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Read WAP bookmark from file created by backup option and saves in Nokia format as SMS

For description of shared parameters see Common parameters for sendsms and savesms.

savesms CALENDAR file location [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Read calendar note from file created by backup option and saves in VCALENDAR 1.0 format as SMS.

For description of shared parameters see Common parameters for sendsms and savesms.

savesms CALLER file [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Save caller logo as sms (Nokia format - size 72x14).

For description of shared parameters see Common parameters for sendsms and savesms.

savesms EMS [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-unicode] [-16bit] [-format lcrasbiut] [-text text] [-unicodefiletext file] [-defsound ID] [-defanimation ID] [-tone10 file] [-tone10long file] [-tone12 file] [-tone12long file] [-toneSE file] [-toneSElong file] [-fixedbitmap file] [-variablebitmap file] [-variablebitmaplong file] [-animation frames file1 ...] [-protected number]

Saves EMS sequence. All parameters after -unread (like -defsound) can be used few times.

-text - adds text

-unicodefiletext - adds text from Unicode file

-defanimation - adds default animation with ID specified by user.ID for different phones are different.

-animation - adds "frames" frames read from file1, file2, etc.

-defsound - adds default sound with ID specified by user. ID for different phones are different.

-tone10 - adds IMelody version 1.0 read from RTTL or other compatible file

-tone10long - IMelody version 1.0 saved in one of few SMS with UPI. Phones compatible with UPI (like SonyEricsson phones) will read such ringtone as one

-tone12 - adds IMelody version 1.2 read from RTTL or other compatible file

-tone12long - IMelody version 1.2 saved in one of few SMS with UPI. Phones compatible with UPI (like SonyEricsson phones) will read such ringtone as one

-toneSE - adds IMelody in "short" form supported by SonyEricsson phones

-variablebitmap - bitmap in any size saved in one SMS

-variablebitmaplong - bitmap with maximal size 96x128 saved in one or few sms

-fixedbitmap - bitmap 16x16 or 32x32

-protected - all ringtones and bitmaps after this parameter (excluding default ringtones and logos) will be "protected" (in phones compatible with ODI like SonyEricsson products it won't be possible to forward them from phone menu)

Example: gammu savesms EMS -text "Greetings" -defsound 1 -text "from Gammu" -tone10 axelf.txt -animation 2 file1.bmp file2.bmp

will create EMS sequence with text "Greetings" and default sound 1 and text "from Gammu" and ringtone axelf.txt and 2 frame animation read from (1'st frame) file1.bmp and (2'nd frame) file2.bmp

Example: gammu savesms EMS -protected 2 -variablebitmaplong ala.bmp -toneSElong axelf.txt -toneSE ring.txt

ala.bmp and axelf.txt will be "protected"

For description of shared parameters see Common parameters for sendsms and savesms.

savesms MMSINDICATOR URL Title Sender [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Saves a message with MMS indication. The recipient phone will then download MMS from given URL and display it.

Please note that you should provide valid smil data on that URL.

For description of shared parameters see Common parameters for sendsms and savesms.

savesms MMSSETTINGS file location [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Saves a message with MMS configuration. The configuration will be read from Gammu backup file from given location.

For description of shared parameters see Common parameters for sendsms and savesms.

savesms OPERATOR file [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-netcode netcode] [-biglogo]

Save operator logo as sms (Nokia format - size 72x14 or 78x21 after using -biglogo).

For description of shared parameters see Common parameters for sendsms and savesms.

savesms PICTURE file [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-text text] [-unicode] [-alcatelbmmi]

Save Picture Image as sms (Nokia format - size 72x28).

For description of shared parameters see Common parameters for sendsms and savesms.

savesms PROFILE [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-name name] [-bitmap bitmap] [-ringtone ringtone]

Read ringtone (RTTL) format and bitmap (Picture Image size) and name and save as Nokia profile.

For description of shared parameters see Common parameters for sendsms and savesms.

savesms RINGTONE file [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-long] [-scale]

Read RTTL ringtone from file and save as SMS into SIM/phone memory. Ringtone is saved in Nokia format.

-long - ringtone is saved using Profile style. It can be longer (and saved in 2 SMS), but decoded only by newer phones (like 33xx)

-scale - ringtone will have Scale info for each note. It will allow to edit it correctly later in phone composer (for example, in 33xx)

For description of shared parameters see Common parameters for sendsms and savesms.

savesms SMSTEMPLATE [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-unicode] [-text text] [-unicodefiletext file] [-defsound ID] [-defanimation ID] [-tone10 file] [-tone10long file] [-tone12 file] [-tone12long file] [-toneSE file] [-toneSElong file] [-variablebitmap file] [-variablebitmaplong file] [-animation frames file1 ...]

Saves a SMS template (for Alcatel phones).

For description of shared parameters see Common parameters for sendsms and savesms.

savesms TEXT [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-inputunicode] [-16bit] [-flash] [-len len] [-autolen len] [-unicode] [-enablevoice] [-disablevoice] [-enablefax] [-disablefax] [-enableemail] [-disableemail] [-voidsms] [-replacemessages ID] [-replacefile file] [-text msgtext] [-textutf8 msgtext]

Take text from stdin (or commandline if -text specified) and save as text SMS into SIM/phone memory.

-flash - Class 0 SMS

-len len - specify, how many chars will be read. When use this option and text will be longer than 1 SMS, will be splitted into more linked SMS

-autolen len - specify, how many chars will be read. When use this option and text will be longer than 1 SMS, will be splitted into more linked SMS.Coding type (SMS default alphabet/Unicode) is set according to input text

-enablevoice | -disablevoice | -enablefax | -disablefax | -enableemail | -disableemail - sms will set such indicators. Text will be cut to 1 sms.

-voidsms - many phones after receiving it won't display anything, only beep, vibrate or turn on light. Text will be cut to 1 sms.

-unicode - SMS will be saved in Unicode format

-inputunicode - input text is in Unicode.

-text - get text from command line instead of stdin.

-textutf8 - get text in UTF-8 from command line instead of stdin.

TIP: You can create Unicode file using WordPad in Windows (during saving select "Unicode Text Document" format). In Unix can use for example YUdit.

-replacemessages ID - ID can be 1..7. When you will use option and send more single SMS to one recipient with the same ID, each another SMS will replace each previous with the same ID

-replacefile file - when you want, you can make file in such format: src_unicode_char1, dest_unicode_char1, src_unicode_char2, dest_unicode_char2 (everything in one line). After reading text for SMS from stdin there will be made translation and each src char will be converted to dest char. In docs there is example file (replace.txt), which will change all "a" chars to "1"

TIP: when use ~ char in sms text and -unicode option (Unicode coding required), text of sms after ~ char will blink in some phones (like N33xx)

Example: echo some_text | gammu savesms TEXT

For description of shared parameters see Common parameters for sendsms and savesms.

savesms TODO file location [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Saves a message with a todo entry. The content will be read from any backup format which Gammu supports and from given location.

For description of shared parameters see Common parameters for sendsms and savesms.

savesms VCARD10|VCARD21 file SM|ME location [-nokia] [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Read phonebook entry from file created by backup option and saves in VCARD 1.0 (only name and default number) or VCARD 2.1 (all entry details with all numbers, text and name) format as SMS

For description of shared parameters see Common parameters for sendsms and savesms.

savesms WAPINDICATOR URL Title [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Saves a SMS with a WAP indication for given URL and title.

For description of shared parameters see Common parameters for sendsms and savesms.

savesms WAPSETTINGS file location DATA|GPRS [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Read WAP settings from file created by backup option and saves in Nokia format as SMS

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms ANIMATION destination frames file1 file2... [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Sends a message, for description of message specific parameters see savesms ANIMATION.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms BOOKMARK destination file location [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Sends a message, for description of message specific parameters see savesms BOOKMARK.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms CALENDAR destination file location [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Sends a message, for description of message specific parameters see savesms CALENDAR.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms CALLER destination file [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Sends a message, for description of message specific parameters see savesms CALLER.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms EMS destination [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-unicode] [-16bit] [-format lcrasbiut] [-text text] [-unicodefiletext file] [-defsound ID] [-defanimation ID] [-tone10 file] [-tone10long file] [-tone12 file] [-tone12long file] [-toneSE file] [-toneSElong file] [-fixedbitmap file] [-variablebitmap file] [-variablebitmaplong file] [-animation frames file1 ...] [-protected number]

Sends a message, for description of message specific parameters see savesms EMS.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms MMSINDICATOR destination URL Title Sender [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Sends a message, for description of message specific parameters see savesms MMSINDICATOR.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms MMSSETTINGS destination file location [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Sends a message, for description of message specific parameters see savesms MMSSETTINGS.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms OPERATOR destination file [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-netcode netcode] [-biglogo]

Sends a message, for description of message specific parameters see savesms OPERATOR.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms PICTURE destination file [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-text text] [-unicode] [-alcatelbmmi]

Sends a message, for description of message specific parameters see savesms PICTURE.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms PROFILE destination [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-name name] [-bitmap bitmap] [-ringtone ringtone]

Sends a message, for description of message specific parameters see savesms PROFILE.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms RINGTONE destination file [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-long] [-scale]

Sends a message, for description of message specific parameters see savesms RINGTONE.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms SMSTEMPLATE destination [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-unicode] [-text text] [-unicodefiletext file] [-defsound ID] [-defanimation ID] [-tone10 file] [-tone10long file] [-tone12 file] [-tone12long file] [-toneSE file] [-toneSElong file] [-variablebitmap file] [-variablebitmaplong file] [-animation frames file1 ...]

Sends a message, for description of message specific parameters see savesms SMSTEMPLATE.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms TEXT destination [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-inputunicode] [-16bit] [-flash] [-len len] [-autolen len] [-unicode] [-enablevoice] [-disablevoice] [-enablefax] [-disablefax] [-enableemail] [-disableemail] [-voidsms] [-replacemessages ID] [-replacefile file] [-text msgtext] [-textutf8 msgtext]

Sends a message, for description of message specific parameters see savesms TEXT.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms TODO destination file location [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Sends a message, for description of message specific parameters see savesms TODO.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms VCARD10|VCARD21 destination file SM|ME location [-nokia] [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Sends a message, for description of message specific parameters see savesms VCARD10|VCARD21.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms WAPINDICATOR destination URL Title [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Sends a message, for description of message specific parameters see savesms WAPINDICATOR.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms WAPSETTINGS destination file location DATA|GPRS [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Sends a message, for description of message specific parameters see savesms WAPSETTINGS.

For description of shared parameters see Common parameters for sendsms and savesms.

setsmsc location number

Set SMSC settings on SIM card. This keeps all SMSC configuration intact, it just changes the SMSC number.

Locations are numerated from 1.

Memory (phonebooks and calls)

addcategory TODO|PHONEBOOK text

addnew file [-yes] [-memory ME|SM|..]

Adds data written in file created using backup option. All things backup'ed by backup can be restored (when made backup to Gammu text file).

Please note that this adds all content of backup file to phone and does not care about current data in the phone (no duplicates are detected).

Use -yes parameter to answer yes to all questions (you want to automatically restore all data).

Use -memory parameter to force usage of defined memory type for storing entries regardless what backu format says.

backup file [-yes]

Backup your phone to file. It's possible to backup (depends on phone and backup format):

* phonebook from SIM and phone memory
* calendar notes
* SMSC settings
* operator logo
* startup (static) logo or startup text
* WAP bookmarks
* WAP settings
* caller logos and groups
* user ringtones

There are various backup formats supported and the backup format is guessed based on file extension:

* .lmb - Nokia backup, supports contacts, caller logos and startup logo.
* .vcs - vCalendar, supports calendar and todo.
* .vcf - vCard, supports contacts.
* .ldif - LDAP import, supports contacts.
* .ics - iCalendar, supports calendar and todo.
* Any other extension is Gammu backup file and it supports all data mentioned above.

See EXAMPLE section for some hints on manipulating Gammu backup format.

clearall

Deletes all private data from the phone.

deleteallmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL

Deletes all entries from specified memory type.

deletememory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL start [stop]

Deletes entries in specified range from specified memory type.

getallcategory TODO|PHONEBOOK

getallmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL

Get all memory locations from phone. For memory types see getmemory.

getcategory TODO|PHONEBOOK start [stop]

getmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL start [stop [-nonempty]]

Get memory location from phone.

Locations are numerated from 1.

DC = Dialled calls
MC = Missed calls
RC = Received calls
ON = Own numbers
VM = voice mailbox
SM = SIM phonebook
ME = phone internal phonebook
FD = fixed dialling
SL = sent SMS log

getspeeddial start [stop]

Gets speed dial choices.

listmemorycategory text|number

nokiagetpbkfeatures memorytype

restore file [-yes]

Restore settings written in file created using backup option.

Please note that restoring deletes all current content in phone. If you want only to add entries to phone, use addnew.

In some phones restoring calendar notes will not show error, but won't be done, when phone doesn't have set clock inside.

savefile VCARD10|VCARD21 target.vcf file SM|ME location

Allows to convert between various backup formats which gammu supports for phonebook events. The file type is guessed (for input file guess is based on extension and file content, for output solely on extension).

For example if you want to convert single entry from gammu native backup to vCard, you need following command:

    gammu savefile CALENDAR output.vcf myPhonebook.backup ME 42

savesms VCARD10|VCARD21 file SM|ME location [-nokia] [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Read phonebook entry from file created by backup option and saves in VCARD 1.0 (only name and default number) or VCARD 2.1 (all entry details with all numbers, text and name) format as SMS

For description of shared parameters see Common parameters for sendsms and savesms.

searchmemory text

Scans all memory entries for given text. It performs case insensitive substring lookup. You can interrupt searching by pressing Ctrl+C.

sendsms VCARD10|VCARD21 destination file SM|ME location [-nokia] [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Sends a message, for description of message specific parameters see savesms VCARD10|VCARD21.

For description of shared parameters see Common parameters for sendsms and savesms.

Filesystem

Gammu allows to access phones using native protocol (Nokias) or OBEX. Your phone can also support usb storage, which is handled on the operating system level and Gammu does not use that.

addfile folderID name [-type JAR|BMP|PNG|GIF|JPG|MIDI|WBMP|AMR|3GP|NRT] [-readonly] [-protected] [-system] [-hidden] [-newtime]

Add file with specified name to folder with specified folder ID.

-type - file type was required for filesystem 1 in Nokia phones (current filesystem 2 doesn't need this)

-readonly, -protected, -system, -hidden - you can set readonly, protected (file can't be for example forwarded from phone menu), system and hidden (file is hidden from phone menu) file attributes

-newtime - after using it date/time of file modification will be set to moment of uploading

addfolder parentfolderID name

Create a folder in phone with specified name in a folder with specified folder ID.

deletefiles fileID

Delete files with given IDs.

deletefolder name

Delete folder with given ID.

getfilefolder ID1, ID2, ...

Retrieve files or all files from folder with given IDs from a phone filesytem.

getfiles ID1, ID2, ...

Retrieve files with given IDs from a phone filesytem.

getfilesystem [-flatall|-flat]

Display info about all folders and files in phone memory/memory card. By default there is tree displayed, you can change it:

-flatall there are displayed full file/folder details like ID (first parameter in line)

-flat

Please note, that in some phones (like N6230) content of some folders (with more files) can be cut (only part of files will be displayed) for example on infrared connection. This is not Gammu issue, but phone firmware problem.

getfilesystemstatus

Display info filesystem status - number of bytes available, used or used by some specific content.

getfolderlisting folderID

Display files and folders available in folder with given folder ID. You can get ID's using getfilesystem -flatall.

Please note, that in some phones (like N6230) content of some folders (with more files) can be cut (only part of files will be displayed) for example on infrared connection. This is not Gammu issue, but phone firmware problem.

getrootfolders

Display info about drives available in phone/memory card.

nokiaaddfile Gallery|Gallery2|Camera|Tones|Tones2|Records|Video|Playlist|MemoryCard file [-name name] [-protected] [-readonly] [-system] [-hidden] [-newtime]

Install the *.jar/*.jad file pair of a midlet in the application or game menu of the phone. You have to give the name without the jar/jad suffix, otherwise you will get the slightly confusing error message Can't open specified file. Read only ?

The option -overwrite deletes the application's .jad and .jar files bevor installing, but doesn't delete the application data. Option -overwriteall will also delete all data. Both these options work only for Application or Game upload.

Example: gammu nokiaaddfile Application Alien will read Alien.JAD and Alien.JAR and add to Applications

Example: gammu nokiaaddfile Tones file.mid will read file.mid and add to Tones folder

You can use jadmaker(1) to generate a .jad file from a .jar file.

nokiaaddplaylists

sendfile name

Sends file to a phone. It's up to phone to decide where to store this file and how to handle it (for example when you send vCard or vCalendar, most of phones will offer you to import it.

setfileattrib folderID [-system] [-readonly] [-hidden] [-protected]

Logo and pictures

copybitmap inputfile [outputfile [OPERATOR|PICTURE|STARTUP|CALLER]]

Allow to convert logos files to another. When give ONLY inputfile, output will be written to stdout using ASCII art. When give output file and format, in some file formats (like NLM) will be set indicator informing about logo type to given.

getbitmap DEALER

In some models it's possible to save dealer welcome note - text displayed during enabling phone, which can't be edited from phone menu. Here you can get it.

getbitmap CALLER location [file]

Get caller group logo from phone. Locations 1-5.

getbitmap OPERATOR [file]

Get operator logo (picture displayed instead of operator name) from phone.

getbitmap PICTURE location [file]

Get Picture Image from phone.

getbitmap STARTUP [file]

Get static startup logo from phone. Allow to save it in file.

savesms ANIMATION frames file1 file2... [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Save an animation as a SMS. You need to give number of frames and picture for each frame. Each picture can be in any picture format which Gammu supports (B/W bmp, gif, wbmp, nol, nlm...).

For description of shared parameters see Common parameters for sendsms and savesms.

savesms CALLER file [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Save caller logo as sms (Nokia format - size 72x14).

For description of shared parameters see Common parameters for sendsms and savesms.

savesms OPERATOR file [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-netcode netcode] [-biglogo]

Save operator logo as sms (Nokia format - size 72x14 or 78x21 after using -biglogo).

For description of shared parameters see Common parameters for sendsms and savesms.

savesms PICTURE file [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-text text] [-unicode] [-alcatelbmmi]

Save Picture Image as sms (Nokia format - size 72x28).

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms ANIMATION destination frames file1 file2... [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Sends a message, for description of message specific parameters see savesms ANIMATION.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms CALLER destination file [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Sends a message, for description of message specific parameters see savesms CALLER.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms OPERATOR destination file [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-netcode netcode] [-biglogo]

Sends a message, for description of message specific parameters see savesms OPERATOR.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms PICTURE destination file [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-text text] [-unicode] [-alcatelbmmi]

Sends a message, for description of message specific parameters see savesms PICTURE.

For description of shared parameters see Common parameters for sendsms and savesms.

setbitmap CALLER location [file]

Set caller logo.

setbitmap COLOUROPERATOR [fileID [netcode]]

setbitmap COLOURSTARTUP [fileID]

setbitmap DEALER text

setbitmap OPERATOR [file [netcode]]

Set operator logo in phone. When won't give file and netcode, operator logo will be removed from phone. When will give only filename, operator logo will be displayed for your current GSM operator. When give additionaly network code, it will be displayed for this operator: gammu setbitmap OPERATOR file "260 02"

setbitmap PICTURE file location [text]

setbitmap STARTUP file|1|2|3

Set startup logo in phone. It can be static (then you will have to give file name) or one of predefined animated (only some phones like Nokia 3310 or 3330 supports it)

setbitmap TEXT text

setbitmap WALLPAPER fileID

Ringtones

Ringtones are mostly supported only for older phones. For recent phones you usually just upload them to some folder in phone filesystem.

addnew file [-yes] [-memory ME|SM|..]

Adds data written in file created using backup option. All things backup'ed by backup can be restored (when made backup to Gammu text file).

Please note that this adds all content of backup file to phone and does not care about current data in the phone (no duplicates are detected).

Use -yes parameter to answer yes to all questions (you want to automatically restore all data).

Use -memory parameter to force usage of defined memory type for storing entries regardless what backu format says.

backup file [-yes]

Backup your phone to file. It's possible to backup (depends on phone and backup format):

* phonebook from SIM and phone memory
* calendar notes
* SMSC settings
* operator logo
* startup (static) logo or startup text
* WAP bookmarks
* WAP settings
* caller logos and groups
* user ringtones

There are various backup formats supported and the backup format is guessed based on file extension:

* .lmb - Nokia backup, supports contacts, caller logos and startup logo.
* .vcs - vCalendar, supports calendar and todo.
* .vcf - vCard, supports contacts.
* .ldif - LDAP import, supports contacts.
* .ics - iCalendar, supports calendar and todo.
* Any other extension is Gammu backup file and it supports all data mentioned above.

See EXAMPLE section for some hints on manipulating Gammu backup format.

clearall

Deletes all private data from the phone.

copyringtone source destination [RTTL|BINARY]

Copy source ringtone to destination.

getphoneringtone location [file]

Get one of "default" ringtones and saves into file

getringtone location [file]

Get ringtone from phone in RTTL or BINARY format.

Locations are numerated from 1.

getringtoneslist

nokiacomposer file

Show, how to enter RTTL ringtone in composer existing in many Nokia phones (and how should it look like).

playringtone file

Play aproximation of ringtone over phone buzzer. File can be in RTTL or BINARY (Nokia DCT3) format.

playsavedringtone number

Play one of "built" ringtones. This option is available for DCT4 phones. For getting ringtones list use getringtoneslist.

restore file [-yes]

Restore settings written in file created using backup option.

Please note that restoring deletes all current content in phone. If you want only to add entries to phone, use addnew.

In some phones restoring calendar notes will not show error, but won't be done, when phone doesn't have set clock inside.

savesms RINGTONE file [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-long] [-scale]

Read RTTL ringtone from file and save as SMS into SIM/phone memory. Ringtone is saved in Nokia format.

-long - ringtone is saved using Profile style. It can be longer (and saved in 2 SMS), but decoded only by newer phones (like 33xx)

-scale - ringtone will have Scale info for each note. It will allow to edit it correctly later in phone composer (for example, in 33xx)

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms RINGTONE destination file [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-long] [-scale]

Sends a message, for description of message specific parameters see savesms RINGTONE.

For description of shared parameters see Common parameters for sendsms and savesms.

setringtone file [-location location] [-scale] [-name name]

Set ringtone in phone. When don't give location, it will be written "with preview" (in phones supporting this feature like 61xx or 6210). When use RTTL ringtones, give location and use -scale, there will be written scale info with each note. It will avoid scale problems available during editing ringtone in composer from phone menu (for example, in N33xx).

TIP: when use ~ char in ringtone name, in some phones (like 33xx) name will blink later in phone menus

Calendar notes

addnew file [-yes] [-memory ME|SM|..]

Adds data written in file created using backup option. All things backup'ed by backup can be restored (when made backup to Gammu text file).

Please note that this adds all content of backup file to phone and does not care about current data in the phone (no duplicates are detected).

Use -yes parameter to answer yes to all questions (you want to automatically restore all data).

Use -memory parameter to force usage of defined memory type for storing entries regardless what backu format says.

backup file [-yes]

Backup your phone to file. It's possible to backup (depends on phone and backup format):

* phonebook from SIM and phone memory
* calendar notes
* SMSC settings
* operator logo
* startup (static) logo or startup text
* WAP bookmarks
* WAP settings
* caller logos and groups
* user ringtones

There are various backup formats supported and the backup format is guessed based on file extension:

* .lmb - Nokia backup, supports contacts, caller logos and startup logo.
* .vcs - vCalendar, supports calendar and todo.
* .vcf - vCard, supports contacts.
* .ldif - LDAP import, supports contacts.
* .ics - iCalendar, supports calendar and todo.
* Any other extension is Gammu backup file and it supports all data mentioned above.

See EXAMPLE section for some hints on manipulating Gammu backup format.

clearall

Deletes all private data from the phone.

deletecalendar start [stop]

Deletes selected calendar entries in phone.

getallcalendar

Retrieves all calendar entries from phone.

getcalendar start [stop]

Retrieves selected calendar entries from phone.

getcalendarsettings

Displays calendar settings like first day of week or automatic deleting of old entries.

restore file [-yes]

Restore settings written in file created using backup option.

Please note that restoring deletes all current content in phone. If you want only to add entries to phone, use addnew.

In some phones restoring calendar notes will not show error, but won't be done, when phone doesn't have set clock inside.

savefile CALENDAR target.vcs file location

Allows to convert between various backup formats which gammu supports for calendar events. The file type is guessed (for input file guess is based on extension and file content, for output solely on extension).

For example if you want to convert single entry from gammu native backup to vCalendar, you need following command:

    gammu savefile CALENDAR output.vcs myCalendar.backup 260

savesms CALENDAR file location [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Read calendar note from file created by backup option and saves in VCALENDAR 1.0 format as SMS.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms CALENDAR destination file location [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Sends a message, for description of message specific parameters see savesms CALENDAR.

For description of shared parameters see Common parameters for sendsms and savesms.

To do lists

addcategory TODO|PHONEBOOK text

addnew file [-yes] [-memory ME|SM|..]

Adds data written in file created using backup option. All things backup'ed by backup can be restored (when made backup to Gammu text file).

Please note that this adds all content of backup file to phone and does not care about current data in the phone (no duplicates are detected).

Use -yes parameter to answer yes to all questions (you want to automatically restore all data).

Use -memory parameter to force usage of defined memory type for storing entries regardless what backu format says.

backup file [-yes]

Backup your phone to file. It's possible to backup (depends on phone and backup format):

* phonebook from SIM and phone memory
* calendar notes
* SMSC settings
* operator logo
* startup (static) logo or startup text
* WAP bookmarks
* WAP settings
* caller logos and groups
* user ringtones

There are various backup formats supported and the backup format is guessed based on file extension:

* .lmb - Nokia backup, supports contacts, caller logos and startup logo.
* .vcs - vCalendar, supports calendar and todo.
* .vcf - vCard, supports contacts.
* .ldif - LDAP import, supports contacts.
* .ics - iCalendar, supports calendar and todo.
* Any other extension is Gammu backup file and it supports all data mentioned above.

See EXAMPLE section for some hints on manipulating Gammu backup format.

clearall

Deletes all private data from the phone.

deletetodo start [stop]

Deletes selected todo entries in phone.

getallcategory TODO|PHONEBOOK

getalltodo

Retrieves all todo entries from phone.

getcategory TODO|PHONEBOOK start [stop]

gettodo start [stop]

Retrieves selected todo entries from phone.

listtodocategory text|number

restore file [-yes]

Restore settings written in file created using backup option.

Please note that restoring deletes all current content in phone. If you want only to add entries to phone, use addnew.

In some phones restoring calendar notes will not show error, but won't be done, when phone doesn't have set clock inside.

savefile TODO target.vcs file location

Allows to convert between various backup formats which gammu supports for todo events. The file type is guessed (for input file guess is based on extension and file content, for output solely on extension).

For example if you want to convert single entry from gammu native backup to vCalendar, you need following command:

    gammu savefile CALENDAR output.vcs myCalendar.backup 260

savesms TODO file location [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Saves a message with a todo entry. The content will be read from any backup format which Gammu supports and from given location.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms TODO destination file location [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Sends a message, for description of message specific parameters see savesms TODO.

For description of shared parameters see Common parameters for sendsms and savesms.

Notes

getallnotes

Reads all notes from the phone.

Date, time and alarms

getalarm [start]

Get alarm from phone, if no location is specified, 1 is used.

getdatetime

Get date and time from phone

setalarm hour minute

Sets repeating alarm in phone on selected time.

setdatetime [HH:MM[:SS]] [YYYY/MM/DD]

Set date and time in phone to date and time set in computer. Please note, that this option doesn't show clock on phone screen. It only set date and time.

TIP: you can make such synchronization each time, when will connect your phone and use Gammu. See gammurc(5) for details.

Categories

addcategory TODO|PHONEBOOK text

addnew file [-yes] [-memory ME|SM|..]

Adds data written in file created using backup option. All things backup'ed by backup can be restored (when made backup to Gammu text file).

Please note that this adds all content of backup file to phone and does not care about current data in the phone (no duplicates are detected).

Use -yes parameter to answer yes to all questions (you want to automatically restore all data).

Use -memory parameter to force usage of defined memory type for storing entries regardless what backu format says.

backup file [-yes]

Backup your phone to file. It's possible to backup (depends on phone and backup format):

* phonebook from SIM and phone memory
* calendar notes
* SMSC settings
* operator logo
* startup (static) logo or startup text
* WAP bookmarks
* WAP settings
* caller logos and groups
* user ringtones

There are various backup formats supported and the backup format is guessed based on file extension:

* .lmb - Nokia backup, supports contacts, caller logos and startup logo.
* .vcs - vCalendar, supports calendar and todo.
* .vcf - vCard, supports contacts.
* .ldif - LDAP import, supports contacts.
* .ics - iCalendar, supports calendar and todo.
* Any other extension is Gammu backup file and it supports all data mentioned above.

See EXAMPLE section for some hints on manipulating Gammu backup format.

clearall

Deletes all private data from the phone.

getallcategory TODO|PHONEBOOK

getcategory TODO|PHONEBOOK start [stop]

listmemorycategory text|number

listtodocategory text|number

restore file [-yes]

Restore settings written in file created using backup option.

Please note that restoring deletes all current content in phone. If you want only to add entries to phone, use addnew.

In some phones restoring calendar notes will not show error, but won't be done, when phone doesn't have set clock inside.

Backing up and restoring

addnew file [-yes] [-memory ME|SM|..]

Adds data written in file created using backup option. All things backup'ed by backup can be restored (when made backup to Gammu text file).

Please note that this adds all content of backup file to phone and does not care about current data in the phone (no duplicates are detected).

Use -yes parameter to answer yes to all questions (you want to automatically restore all data).

Use -memory parameter to force usage of defined memory type for storing entries regardless what backu format says.

addsms folder file [-yes]

Adds SMSes from file (format like backupsms uses) to selected folder in phone.

backup file [-yes]

Backup your phone to file. It's possible to backup (depends on phone and backup format):

* phonebook from SIM and phone memory
* calendar notes
* SMSC settings
* operator logo
* startup (static) logo or startup text
* WAP bookmarks
* WAP settings
* caller logos and groups
* user ringtones

There are various backup formats supported and the backup format is guessed based on file extension:

* .lmb - Nokia backup, supports contacts, caller logos and startup logo.
* .vcs - vCalendar, supports calendar and todo.
* .vcf - vCard, supports contacts.
* .ldif - LDAP import, supports contacts.
* .ics - iCalendar, supports calendar and todo.
* Any other extension is Gammu backup file and it supports all data mentioned above.

See EXAMPLE section for some hints on manipulating Gammu backup format.

backupsms file [-yes|-all]

Stores all SMSes from phone to file.

Use -yes for answering yes to all questions (backup all messages and delete them from phone), or -all to just backup all folders while keeping messages in phone.

restore file [-yes]

Restore settings written in file created using backup option.

Please note that restoring deletes all current content in phone. If you want only to add entries to phone, use addnew.

In some phones restoring calendar notes will not show error, but won't be done, when phone doesn't have set clock inside.

restoresms file [-yes]

Restores SMSes from file (format like backupsms uses) to selected folder in phone. Please note that this overwrites existing messages in phone (if it supports it).

savefile BOOKMARK target.url file location

savefile CALENDAR target.vcs file location

Allows to convert between various backup formats which gammu supports for calendar events. The file type is guessed (for input file guess is based on extension and file content, for output solely on extension).

For example if you want to convert single entry from gammu native backup to vCalendar, you need following command:

    gammu savefile CALENDAR output.vcs myCalendar.backup 260

savefile TODO target.vcs file location

Allows to convert between various backup formats which gammu supports for todo events. The file type is guessed (for input file guess is based on extension and file content, for output solely on extension).

For example if you want to convert single entry from gammu native backup to vCalendar, you need following command:

    gammu savefile CALENDAR output.vcs myCalendar.backup 260

savefile VCARD10|VCARD21 target.vcf file SM|ME location

Allows to convert between various backup formats which gammu supports for phonebook events. The file type is guessed (for input file guess is based on extension and file content, for output solely on extension).

For example if you want to convert single entry from gammu native backup to vCard, you need following command:

    gammu savefile CALENDAR output.vcf myPhonebook.backup ME 42

Nokia specific

nokiaaddfile Gallery|Gallery2|Camera|Tones|Tones2|Records|Video|Playlist|MemoryCard file [-name name] [-protected] [-readonly] [-system] [-hidden] [-newtime]

Install the *.jar/*.jad file pair of a midlet in the application or game menu of the phone. You have to give the name without the jar/jad suffix, otherwise you will get the slightly confusing error message Can't open specified file. Read only ?

The option -overwrite deletes the application's .jad and .jar files bevor installing, but doesn't delete the application data. Option -overwriteall will also delete all data. Both these options work only for Application or Game upload.

Example: gammu nokiaaddfile Application Alien will read Alien.JAD and Alien.JAR and add to Applications

Example: gammu nokiaaddfile Tones file.mid will read file.mid and add to Tones folder

You can use jadmaker(1) to generate a .jad file from a .jar file.

nokiaaddplaylists

nokiacomposer file

Show, how to enter RTTL ringtone in composer existing in many Nokia phones (and how should it look like).

nokiadebug filename [[v11-22] [,v33-44]...]

nokiadisplayoutput

nokiadisplaytest number

nokiagetadc

nokiagetoperatorname

6110.c phones have place for name for one GSM network (of course, with flashing it's possible to change all names, but Gammu is not flasher ;-)). You can get this name using this option.

nokiagetpbkfeatures memorytype

nokiagetscreendump

nokiagett9

nokiagetvoicerecord location

Get voice record from location and save to WAV file. File is coded using GSM 6.10 codec (available for example in win32). Name of file is like name of voice record in phone.

nokiamakecamerashoot

nokianetmonitor test

Takes output or set netmonitor for Nokia DCT3 phones.

TIP: For more info about this option, please visit http://www.mwiacek.com and read netmonitor manual.

TIP: test 243 enables all tests (after using command gammu nokianetmonitor 243 in some phones like 6210 or 9210 have to reboot them to see netmonitor menu)

nokianetmonitor36

Reset counters from netmonitor test 36 in Nokia DCT3 phones.

TIP: For more info about this option, please visit http://www.mwiacek.com and read netmonitor manual.

nokiasecuritycode

Get/reset to "12345" security code

nokiaselftests

nokiasetlights keypad|display|torch on|off

nokiasetoperatorname [networkcode name]

nokiasetphonemenus

Enable all (?) possible menus for DCT3 Nokia phones:

1. ALS (Alternative Line Service) option menu
2. vibra menu for 3210
3. 3315 features in 3310 5.45 and higher
4. two additional games (React and Logic) for 3210 5.31 and higher
5. WellMate menu for 6150
6. NetMonitor

and for DCT4:

1. ALS (Alternative Line Service) option menu
2. Bluetooth, WAP bookmarks and settings menu, ... (6310i)
3. GPRS Always Online

 ...

nokiasetvibralevel level

Set vibra power to "level" (given in percent)

nokiatuneradio

nokiavibratest

Siemens specific

siemensnetmonact netmon_type (1-full, 2-simple)

siemensnetmonitor test

siemenssatnetmon

Network

getgprspoint start [stop]

listnetworks [country]

Show names/codes of GSM networks known for Gammu

monitor [times]

Get phone status and writes continuously to standard output. Press Ctrl+C to break this state.

networkinfo

Show information about network status from the phone.

nokiadebug filename [[v11-22] [,v33-44]...]

nokiagetoperatorname

6110.c phones have place for name for one GSM network (of course, with flashing it's possible to change all names, but Gammu is not flasher ;-)). You can get this name using this option.

nokianetmonitor test

Takes output or set netmonitor for Nokia DCT3 phones.

TIP: For more info about this option, please visit http://www.mwiacek.com and read netmonitor manual.

TIP: test 243 enables all tests (after using command gammu nokianetmonitor 243 in some phones like 6210 or 9210 have to reboot them to see netmonitor menu)

nokiasetoperatorname [networkcode name]

setautonetworklogin

siemensnetmonact netmon_type (1-full, 2-simple)

siemensnetmonitor test

siemenssatnetmon

WAP settings and bookmarks

addnew file [-yes] [-memory ME|SM|..]

Adds data written in file created using backup option. All things backup'ed by backup can be restored (when made backup to Gammu text file).

Please note that this adds all content of backup file to phone and does not care about current data in the phone (no duplicates are detected).

Use -yes parameter to answer yes to all questions (you want to automatically restore all data).

Use -memory parameter to force usage of defined memory type for storing entries regardless what backu format says.

backup file [-yes]

Backup your phone to file. It's possible to backup (depends on phone and backup format):

* phonebook from SIM and phone memory
* calendar notes
* SMSC settings
* operator logo
* startup (static) logo or startup text
* WAP bookmarks
* WAP settings
* caller logos and groups
* user ringtones

There are various backup formats supported and the backup format is guessed based on file extension:

* .lmb - Nokia backup, supports contacts, caller logos and startup logo.
* .vcs - vCalendar, supports calendar and todo.
* .vcf - vCard, supports contacts.
* .ldif - LDAP import, supports contacts.
* .ics - iCalendar, supports calendar and todo.
* Any other extension is Gammu backup file and it supports all data mentioned above.

See EXAMPLE section for some hints on manipulating Gammu backup format.

clearall

Deletes all private data from the phone.

deletewapbookmark start [stop]

Delete WAP bookmarks from phone.

Locations are numerated from 1.

getchatsettings start [stop]

getsyncmlsettings start [stop]

getwapbookmark start [stop]

Get WAP bookmarks from phone.

Locations are numerated from 1.

getwapsettings start [stop]

Get WAP settings from phone.

Locations are numerated from 1.

restore file [-yes]

Restore settings written in file created using backup option.

Please note that restoring deletes all current content in phone. If you want only to add entries to phone, use addnew.

In some phones restoring calendar notes will not show error, but won't be done, when phone doesn't have set clock inside.

savefile BOOKMARK target.url file location

savesms BOOKMARK file location [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Read WAP bookmark from file created by backup option and saves in Nokia format as SMS

For description of shared parameters see Common parameters for sendsms and savesms.

savesms WAPINDICATOR URL Title [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Saves a SMS with a WAP indication for given URL and title.

For description of shared parameters see Common parameters for sendsms and savesms.

savesms WAPSETTINGS file location DATA|GPRS [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Read WAP settings from file created by backup option and saves in Nokia format as SMS

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms BOOKMARK destination file location [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Sends a message, for description of message specific parameters see savesms BOOKMARK.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms WAPINDICATOR destination URL Title [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Sends a message, for description of message specific parameters see savesms WAPINDICATOR.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms WAPSETTINGS destination file location DATA|GPRS [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Sends a message, for description of message specific parameters see savesms WAPSETTINGS.

For description of shared parameters see Common parameters for sendsms and savesms.

MMS and MMS settings

getallmms [-save]

geteachmms [-save]

getmmsfolders

getmmssettings start [stop]

readmmsfile file [-save]

savesms MMSINDICATOR URL Title Sender [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Saves a message with MMS indication. The recipient phone will then download MMS from given URL and display it.

Please note that you should provide valid smil data on that URL.

For description of shared parameters see Common parameters for sendsms and savesms.

savesms MMSSETTINGS file location [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Saves a message with MMS configuration. The configuration will be read from Gammu backup file from given location.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms MMSINDICATOR destination URL Title Sender [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Sends a message, for description of message specific parameters see savesms MMSINDICATOR.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms MMSSETTINGS destination file location [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Sends a message, for description of message specific parameters see savesms MMSSETTINGS.

For description of shared parameters see Common parameters for sendsms and savesms.

Phone tests

nokiadisplaytest number

nokiagetadc

nokiaselftests

nokiasetlights keypad|display|torch on|off

nokiavibratest

FM radio

addnew file [-yes] [-memory ME|SM|..]

Adds data written in file created using backup option. All things backup'ed by backup can be restored (when made backup to Gammu text file).

Please note that this adds all content of backup file to phone and does not care about current data in the phone (no duplicates are detected).

Use -yes parameter to answer yes to all questions (you want to automatically restore all data).

Use -memory parameter to force usage of defined memory type for storing entries regardless what backu format says.

backup file [-yes]

Backup your phone to file. It's possible to backup (depends on phone and backup format):

* phonebook from SIM and phone memory
* calendar notes
* SMSC settings
* operator logo
* startup (static) logo or startup text
* WAP bookmarks
* WAP settings
* caller logos and groups
* user ringtones

There are various backup formats supported and the backup format is guessed based on file extension:

* .lmb - Nokia backup, supports contacts, caller logos and startup logo.
* .vcs - vCalendar, supports calendar and todo.
* .vcf - vCard, supports contacts.
* .ldif - LDAP import, supports contacts.
* .ics - iCalendar, supports calendar and todo.
* Any other extension is Gammu backup file and it supports all data mentioned above.

See EXAMPLE section for some hints on manipulating Gammu backup format.

clearall

Deletes all private data from the phone.

getfmstation start [stop]

Show info about FM stations in phone

nokiatuneradio

restore file [-yes]

Restore settings written in file created using backup option.

Please note that restoring deletes all current content in phone. If you want only to add entries to phone, use addnew.

In some phones restoring calendar notes will not show error, but won't be done, when phone doesn't have set clock inside.

Phone information

checkfirmware

Gammu connects to www.gammu.org and checks for latest firmware versions available for the device. The file <http://www.gammu.org/support/phones/phonedbxml.php?model=x> will be downloaded and all phone details will be read from it. No private data are sent to server. Internet connection to www.gammu.org on port 80 required.

getdisplaystatus

getlocation

Gets network information from phone (same as networkinfo) and prints location (latitude and longitude) based on information from OpenCellID <http://opencellid.org>.

getsecuritystatus

Show, if phone wait for security code (like PIN, PUK, etc.) or not

identify

Show the most important phone data.

monitor [times]

Get phone status and writes continuously to standard output. Press Ctrl+C to break this state.

nokiasecuritycode

Get/reset to "12345" security code

Phone settings

getcalendarsettings

Displays calendar settings like first day of week or automatic deleting of old entries.

getprofile start [stop]

resetphonesettings PHONE|DEV|UIF|ALL|FACTORY

Reset phone settings. BE CAREFULL !!!!

PHONE:

DEV:

ALL:

Clear user settings
* removes or set logos to default
* set default phonebook and other menu settings
* clear T9 words,
* clear call register info
* set default profiles settings
* clear user ringtones

UIF:
* changes like after ALL
* disables netmon and PPS (all "hidden" menus)

FACTORY:
* changes like after UIF
* clear date/time

savesms PROFILE [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-name name] [-bitmap bitmap] [-ringtone ringtone]

Read ringtone (RTTL) format and bitmap (Picture Image size) and name and save as Nokia profile.

For description of shared parameters see Common parameters for sendsms and savesms.

sendsms PROFILE destination [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-name name] [-bitmap bitmap] [-ringtone ringtone]

Sends a message, for description of message specific parameters see savesms PROFILE.

For description of shared parameters see Common parameters for sendsms and savesms.

Dumps decoding

decodebinarydump file [phonemodel]

Decodes a dump made by Gammu with logformat se to binary (see README for info about this method of reporting bugs).

This option is available only if Gammu was compiled with debuging options.

decodesniff MBUS2|IRDA file [phonemodel]

Option available only, if Gammu was compiled with debug. Allows to decode sniffs. See /docs/develop/develop.txt for more details.

makeconverttable file

Functions that don't fit elsewhere

batch [file]

Starts Gammu in a batch mode. In this mode you can issue several commands each on one line. Lines starting with # are treated as a comments.

By default, commands are read from standard input, but you can optionally specify a file from where they would be read (special case - means standard input).

entersecuritycode PIN|PUK|PIN2|PUK2|PHONE|NETWORK code|-

Allow to enter security code from PC. When code is -, it is read from stdin.

nokiagetscreendump

nokiagetvoicerecord location

Get voice record from location and save to WAV file. File is coded using GSM 6.10 codec (available for example in win32). Name of file is like name of voice record in phone.

nokiamakecamerashoot

nokiasetphonemenus

Enable all (?) possible menus for DCT3 Nokia phones:

1. ALS (Alternative Line Service) option menu
2. vibra menu for 3210
3. 3315 features in 3310 5.45 and higher
4. two additional games (React and Logic) for 3210 5.31 and higher
5. WellMate menu for 6150
6. NetMonitor

and for DCT4:

1. ALS (Alternative Line Service) option menu
2. Bluetooth, WAP bookmarks and settings menu, ... (6310i)
3. GPRS Always Online

 ...

nokiasetvibralevel level

Set vibra power to "level" (given in percent)

presskeysequence mMnNpPuUdD+-123456789*0#gGrR<>[]hHcCjJfFoOmMdD@

Press specified key sequence on phone keyboard

mM - Menu
nN - Names key
pP - Power
uU - Up
dD - Down
+- - +-
gG - Green
rR - Red
123456789*0# is numeric keyboard

reset SOFT|HARD

Make phone reset: soft (without asking for PIN) or hard (with PIN).

Note: some phones will make hard reset even with SOFT option.

searchphone [-debug]

Attempts to search for a connected phone. Please note that this can take a very long time, but in case you have no clue how to configure phone connection, this is a convenient way to find working setup for Gammu.

Gammu information

checkversion [STABLE]

Checks whether there is newer Gammu version available online (if Gammu has been compiled with CURL). If you pass additional parameter STABLE, only stable versions will be checked.

features

Print information about compiled in features.

help [topic]

Print help. By default general help is printed, but you can also specify a help category to get more detailed help on some topic.

version

Print version information and license.

FILES

~/.gammurc
/usr/share/doc/gammu/*
/dev/ircomm?
/dev/ttyS?
/dev/ttyACM?

RETURN VALUES

gammu returns 0 on success. In case of failure non zero code is returned.

1

Out of memory or other critical error.

2

Invalid command line parameters.

3

Failed to open file specified on command line.

4

Program was interrupted.

98

Gammu library version mismatch.

99

Functionality has been moved. For example to gammu-smsd(1).

Errors codes greater than 100 map to the GSM_Error values increased by 100:

101

No error.

102

Error opening device. Unknown, busy or no permissions.

103

Error opening device, it is locked.

104

Error opening device, it doesn't exist.

105

Error opening device, it is already opened by other application.

106

Error opening device, you don't have permissions.

107

Error opening device. No required driver in operating system.

108

Error opening device. Some hardware not connected/wrongly configured.

109

Error setting device DTR or RTS.

110

Error setting device speed. Maybe speed not supported.

111

Error writing to the device.

112

Error during reading from the device.

113

Can't set parity on the device.

114

No response in specified timeout. Probably phone not connected.

115

Frame not requested right now. See <http://wammu.eu/support/bugs/> for information how to report it.

116

Unknown response from phone. See <http://wammu.eu/support/bugs/> for information how to report it.

117

Unknown frame. See <http://wammu.eu/support/bugs/> for information how to report it.

118

Unknown connection type string. Check config file.

119

Unknown model type string. Check config file.

120

Some functions not available for your system (disabled in config or not implemented).

121

Function not supported by phone.

122

Entry is empty.

123

Security error. Maybe no PIN?

124

Invalid location. Maybe too high?

125

Functionality not implemented. You are welcome to help authors with it.

126

Memory full.

127

Unknown error.

128

Can not open specified file.

129

More memory required...

130

Permission to file/device required...

131

Empty SMSC number. Set in phone or use -smscnumber.

132

You're inside phone menu (maybe editing?). Leave it and try again.

133

Phone is not connected.

134

Function is currently being implemented. If you want to help, please contact authors.

135

Phone is disabled and connected to charger.

136

File format not supported by Gammu.

137

Nobody is perfect, some bug appeared in protocol implementation. Please contact authors.

138

Transfer was canceled by phone, maybe you pressed cancel on phone.

139

Phone module need to send another answer frame.

140

Current connection type doesn't support called function.

141

CRC error.

142

Invalid date or time specified.

143

Phone memory error, maybe it is read only.

144

Invalid data given to phone.

145

File with specified name already exists.

146

File with specified name doesn't exist.

147

You have to give folder name and not file name.

148

You have to give file name and not folder name.

149

Can not access SIM card.

150

Wrong GNAPPLET version in phone. Use version from currently used Gammu.

151

Only part of folder has been listed.

152

Folder must be empty.

153

Data were converted.

154

Gammu is not configured.

155

Wrong folder used.

156

Internal phone error.

157

Error writing file to disk.

158

No such section exists.

159

Using default values.

160

Corrupted data returned by phone.

161

Bad feature string in configuration.

162

Desired functionality has been disabled on compile time.

163

Bluetooth configuration requires channel option.

164

Service is not runnig.

165

Service configuration is missing.

166

Command rejected because device was busy. Wait and restart.

167

Could not connect to the server.

168

Could not resolve the host name.

EXAMPLE

Configuration

To check it out, you need to have configuration file for gammu, see gammurc(5) for more details about it.

Sending messages

Save text message up to standard 160 chars:

 echo "All your base are belong to us" | gammu savesms TEXT
 

or

 gammu savesms TEXT -text "All your base are belong to us"
 

Save long text message:

 echo "All your base are belong to us" | gammu savesms TEXT -len 400
 

or

 gammu savesms TEXT -len 400 -text "All your base are belong to us"
 

or

 gammu savesms EMS -text "All your base are belong to us"
 

Save some funky message with predefined sound and animation from 2 bitmaps:

 gammu savesms EMS -text "Greetings" -defsound 1 -text "from Gammu"
 -tone10 axelf.txt -animation 2 file1.bmp file2.bmp
 

Save protected message with ringtone:

 gammu savesms EMS -protected 2 -variablebitmaplong ala.bmp
 -toneSElong axelf.txt -toneSE ring.txt
 

Backups

If you will backup settings to Gammu text file, it will be possible to edit it. It's easy: many things in this file will be written double - once in Unicode, once in ASCII. When you will remove Unicode version Gammu will use ASCII on restore (and you can easy edit ASCII text) and will convert it according to your OS locale. When will be available Unicode version of text, it will be used instead of ASCII (usefull with Unicode phones - it isn't important, what locale is set in computer and no conversion Unicode -> ASCII and ASCII -> Unicode is done).

You can use any editor with regular expressions function to edit backup text file. Examples of such editors can be vim <http://www.vim.org/> or TextPad <http://www.textpad.com/> which both do support regular expressions.

Remove info about voice tags

Find: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n

Replace:

Change all numbers starting from +3620, +3630, +3660, +3670 to +3620

Find: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text = "\+36\(20\|30\|60\|70\)\n

Replace: Type = NumberMobile\nEntry\1Text = "\+3620

Change phone numbers type to mobile for numbers starting from +3620, +3630,... and removing the corresponding TextUnicode line

Find: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text = "\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode = \([^\n]*\)\n

Replace: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n

COPYRIGHT

Copyright © 2003-2009 Marcin Wiacek, Michal Cihar and other authors. License GPLv2: GNU GPL version 2 <http://www.gnu.org/licenses/old-licenses/gpl-2.0.html>
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

REPORTING BUGS

There are definitely many bugs, reporting to author is welcome. Please include some useful information when sending bug reports (especially debug logs, operating system, it's version and phone information are needed).

To generate debug log, enable it in gammurc (alternatively you can do it on command line using -d textall -f /tmp/gammu.log):

 [gammu]
 YOUR CONNECTION SETTINGS
 logfile = /tmp/gammu.log
 logformat = textall
 

With this settings, Gammu generates /tmp/gammu.log on each connection to phone and stores dump of communication there. You can also find some hints for improving support for your phone in this log.

See <http://wammu.eu/support/bugs/> for more information on reporting bugs.

Please report bugs to <http://bugs.cihar.com>.

AUTHOR

You can contact authors on <gammu-users@lists.sourceforge.net>.

Michal Cihar <michal@cihar.com> is current project maintainer and contributor of most of AT and OBEX code.

Marcin Wiacek <marcin@mwiacek.com> is project iniciator and contributor of most Nokia code.

As this project grew from Gnokii, we would like to thanks all Gnokii developers, especially Pavel Janik, Pawel Kot and Manfred Jonsson (see CREDITS from Gnokii for all their contributor).

Many other people have helped with various features, check ChangeLog for more details.

SEE ALSO

gammu-smsd(1), gammu-smsd-inject(1), gammurc(5), jadmaker(1)

Some more hints can be found in README file or on wiki <http://www.gammu.org/>.

Related programs which can be used with GSM modem:

cu(1), gnokii(1), minicom(1)

Graphical interfaces for Gammu:

wammu(1), gmobilemedia(1)