DragonFly On-Line Manual Pages
GAMMU(1) Gammu GAMMU(1)
NAME
gammu - Does some neat things with your cellular phone or modem.
SYNOPSIS
gammu [parameters] <command> [options]
Commands actually indicate which operation should Gammu perform. They
can be specified with or without leading --.
DESCRIPTION
This program is a tool for mobile phones. Many vendors and phones are
supported, for actual listing see Gammu Phones Database.
Options
Parameters before command configure gammu behaviour:
-c, --config <filename>
name of configuration file (see gammurc)
-s, --section <confign>
section of config file to use, eg. 42
-d, --debug <level>
debug level (see LogFormat in gammurc for possible values)
-f, --debug-file <filename>
file for logging debug messages
Call commands
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 or set
whether to get divert information or to set it.
all or busy or noans or outofreach
condition when apply divert
all or voice or fax or data
call type when apply divert
number number where to divert
timeout
timeout when the diversion will happen
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.
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 commands
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 when you want to send or
receive more messages and process them automatically.
Introduction to SMS formats
Gammu has support for many SMS formats like:
Nokia Smart Messaging
used for monochromatic picture images, downloadable profiles,
monochromatic operator logos, monochromatic caller logos and
monophonic ringtones
Linked SMS
both with 8 and 16-bit identification numbers in headers
EMS this is SMS format used for saving monochromatic images,
monophonic ringtones, animations, text formatting and others
MMS notifications
contains links where phone should download MMS
Alcatel logo messages
proprietary format for logos
You need to ensure that the target phone supports message type you want
to send. Otherwise the phone will not be able to display it or will
even crash, because firmware of phone did not expect this possibility.
Encoding chars in SMS text
Text in SMS can be coded using two ways:
GSM Default Alphabet
With GSM Default Alphabet you can fit at most 160 chars into single SMS
(Gammu doesn't support compressing such texts according to GSM
standards, but it isn't big limit, because there are no phones
supporting them), but they're from limited set:
o all Latin small and large
o all digits
o some Greek
o some other national
o some symbols like @ ! " # & / ( ) % * + = - , . : ; < > ?
o few others
Unicode
With Unicode single SMS can contain at most 70 chars, but these can be
any chars including all national and special ones.
WARNING:
Please note, that some older phones might have problems displaying
such message.
Conversion
Gammu tries to do the best to handle non ASCII characters in your
message. Everything is internally handled in Unicode (the input is
converted depending on your locales configuration) and in case message
uses Unicode the text will be given as such to the message.
Should the message be sent in GSM Default Alphabet, Gammu will try to
convert all characters to keep message readable. Gammu does support
multi byte encoding for some characters in GSM Default Alphabet (it is
needed for ^ { } \ [ ] ~ |). The characters which are not present in
GSM Default Alphabet are transliterated to closest ASCII equivalent
(accents are removed). Remaining not known characters are replaced by
question mark.
SMS commands
addsmsfolder name
deleteallsms folder
Delete all SMS from specified SMS folder.
deletesms folder start [stop]
Delete SMS from phone. See description for gammu 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.
geteachsms -pbk
Similiary to gammu getallsms. Difference is, that links all
concatenated 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 gammu 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
savesms TYPE [type parameters] [type options] [-folder id] [-unread]
[-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset
number] [-smscnumber number] [-reply] [-maxsms num]
Saves SMS to phone, see below for TYPE options.
-smscset number
SMSC number will be taken from phone stored SMSC
configuration number.
Default: 1
-smscnumber number
SMSC number
-reply reply SMSC is set
-folder number
save to specified folder.
Folders are numerated from 1.
The most often folder 1 = "Inbox", 2 = "Outbox",etc.
Use gammu 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
-smsname name
set message name
-sender number
set sender number (default: Gammu)
-maxsms num
Limit maximal number of messages which will be
created. If there are more messages, Gammu will
terminate with failure.
Types of messages:
ANIMATION frames file1 file2...
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...).
BOOKMARK file location
Read WAP bookmark from file created by gammu backup
command and saves in Nokia format as SMS
CALENDAR file location
Read calendar note from file created by gammu backup
command and saves in VCALENDAR 1.0 format as SMS. The
location identifies position of calendar item to be
read in backup file (usually 1, but can be useful in
case the backup contains more items).
CALLER file
Save caller logo as sms in Nokia (Smart Messaging)
format - size 72x14, two colors.
WARNING:
Please note, that it isn't designed for colour
logos available for example in DCT4/TIKU - you need
to put bitmap file there inside phone using
filesystem commands.
EMS [-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 format specific parameters
(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
Sony-Ericsson 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
Sony-Ericsson phones) will read such ringtone
as one
-toneSE
adds IMelody in "short" form supported by
Sony-Ericsson phones
-toneSElong
add Sony-Ericsson IMelody saved in one or few
SMS with UPI
-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)
-16bit Gammu uses SMS headers with 16-bit numbers for
saving linking info in SMS (it means less chars
available for user in each SMS)
-format lcrasbiut
last text will be formatted. You can use
combinations of chars:
+----------+--------------------+
|Character | Formating |
+----------+--------------------+
|l | left aligned |
+----------+--------------------+
|c | centered |
+----------+--------------------+
|r | right aligned |
+----------+--------------------+
|a | large font |
+----------+--------------------+
|s | small font |
+----------+--------------------+
|b | bold font |
+----------+--------------------+
|i | italic font |
+----------+--------------------+
|u | underlined font |
+----------+--------------------+
|t | strikethrough font |
+----------+--------------------+
MMSINDICATOR URL Title Sender
Creates a MMS indication SMS. It contains URL where
the actual MMS payload is stored which needs to be
SMIL encoded. The phone usually downloads the MMS data
using special APN, which does not count to transmitted
data, however there might be limitations which URLs
can be accessed.
MMSSETTINGS file location
Saves a message with MMS configuration. The
configuration will be read from Gammu backup file from
given location.
OPERATOR file [-netcode netcode] [-biglogo]
Save operator logo as sms in Nokia (Smart Messaging)
format - size 72x14 in two colors.
-biglogo
Use 78x21 formatted logo instead of standard
72x14.
NOTE:
This isn't designed for colour logos available for
example in newer phones - you need to put bitmap
file there inside phone using filesystem commands.
PICTURE file [-text text] [-unicode] [-alcatelbmmi]
Read bitmap from 2 colors file (bmp, nlm, nsl, ngg,
nol, wbmp, etc.), format into bitmap in Smart
Messaging (72x28, 2 colors, called often Picture Image
and saved with text) or Alcatel format and send/save
over SMS.
PROFILE [-name name] [-bitmap bitmap] [-ringtone ringtone]
Read ringtone (RTTL) format, bitmap (Picture Image
size) and name, format into Smart Messaging profile
and send/save as SMS.
WARNING:
Please note, that this format is abandoned by Nokia
and supported by some (older) devices only like
Nokia 3310.
RINGTONE file [-long] [-scale]
Read RTTL ringtone from file and save as SMS into
SIM/phone memory. Ringtone is saved in Nokia (Smart
Messaging) 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 one to edit it correctly later in
phone composer (for example, in 33xx)
SMSTEMPLATE [-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).
TEXT [-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 (should be displayed after
receiving on recipients' phone display after
receiving without entering Inbox)
-len len
specify, how many chars will be read. When use
this option and text will be longer than 1 SMS,
will be split 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 split into more linked SMS.Coding type
(SMS default alphabet/Unicode) is set according
to input text
-enablevoice
sms will set voice mail indicator. Text will be
cut to 1 sms.
-disablevoice
sms will not set voice mail indicator. Text
will be cut to 1 sms.
-enablefax
sms will set fax indicator. Text will be cut to
1 sms.
-disablefax
sms will not set fax indicator. Text will be
cut to 1 sms.
-enableemail
sms will set email indicator. Text will be cut
to 1 sms.
-disableemail
sms will not set email indicator. 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
NOTE:
The ~ char in SMS text and -unicode option
(Unicode coding required) can cause text of
SMS after ~ char blink in some phones (like
Nokia 33xx).
-inputunicode
input text is in Unicode.
NOTE:
You can create Unicode file using WordPad in
Windows (during saving select "Unicode Text
Document" format). In Unix can use for
example YUdit or vim.
-text get text from command line instead of stdin.
-textutf8
get text in UTF-8 from command line instead of
stdin.
NOTE:
Gammu detects your locales and uses by
default encoding based on this. Use this
option only when you know the input will be
in UTF-8 in all cases.
-16bit Gammu uses SMS headers with 16-bit numbers for
saving linking info in SMS (it means less chars
available for user in each SMS)
-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
File with replacement table in unicode (UCS-2),
preferably with byte order mark (BOM). It
contains pairs of chars, first one is to
replace, second is replacement one. The
replacement is done after reading text for the
message.
For example replacement 1 (0x0061) with a
(0x0031) would be done by file with following
content (hex dump, first two bytes is BOM):
ff fe 61 00 31 00
TODO file location
Saves a message with a todo entry. The content will be
read from any backup format which Gammu supports and
from given location.
VCARD10|VCARD21 file SM|ME location [-nokia]
Read phonebook entry from file created by gammu backup
command 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. The location
identifies position of contact item to be read in
backup file (usually 1, but can be useful in case the
backup contains more items).
WAPINDICATOR URL Title
Saves a SMS with a WAP indication for given URL and
title.
WAPSETTINGS file location DATA|GPRS
Read WAP settings from file created by gammu backup
command and saves in Nokia format as SMS
sendsms TYPE destination [type parameters] [type options] [-smscset
number] [-smscnumber number] [-reply] [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]]
Sends a message to a destination number, most parameters are
same as for gammu savesms.
-save will also save message which is being sent
-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).
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) commands
Memory types
Gammu recognizes following memory types:
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
Memory commands
deleteallmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL
Deletes all entries from specified memory type.
For memory types description see Memory types.
deletememory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL start [stop]
Deletes entries in specified range from specified memory type.
For memory types description see Memory types.
getallmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL
Get all memory locations from phone.
For memory types description see Memory types.
getmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL start [stop [-nonempty]]
Get memory location from phone.
For memory types description see Memory types.
Locations are numerated from 1.
getspeeddial start [stop]
Gets speed dial choices.
searchmemory text
Scans all memory entries for given text. It performs case
insensitive substring lookup. You can interrupt searching by
pressing Ctrl+C.
Filesystem commands
Gammu allows one 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
Sets the read only attribute.
-protected
Sets the protected attribute (file can't be for example
forwarded from phone menu).
-system
Sets the system attribute.
-hidden
Sets the hidden attribute (file is hidden from phone
menu).
-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 fileID, fileID
Retrieve files or all files from folder with given IDs from a
phone filesytem.
getfiles fileID, fileID
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
NOTE:
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.
WARNING:
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.
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 commands
These options are mainly (there are few exceptions) for monochromatic
logos and images available in older phones. Recognized file formats:
xpm (only saving), 2-colors bmp, nlm, nsl, ngg, nol, wbmp, gif (for
Samsung).
In new models all bitmaps are saved in filesystem and should go into
filesystem section
copybitmap inputfile [outputfile [OPERATOR|PICTURE|STARTUP|CALLER]]
Allow one 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 TYPE [type options]
Reads bitmap from phone, following types are supported:
CALLER location [file]
Get caller group logo from phone. Locations 1-5.
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.
OPERATOR [file]
Get operator logo (picture displayed instead of operator
name) from phone.
PICTURE location [file]
Get Picture Image from phone.
STARTUP [file]
Get static startup logo from phone. Allow one to save it
in file.
TEXT Get startup text from phone.
setbitmap TYPE [type options]
Sets bitmap in phone, following types are supported:
CALLER location [file]
Set caller logo.
COLOUROPERATOR [fileID [netcode]]
Sets color operator logo in phone.
COLOURSTARTUP [fileID]
DEALER text
Sets welcome message configured by dealer, which usually
can not be changed in phone menus.
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 you give additionally
network code, it will be displayed for this operator.
PICTURE file location [text]
Sets picture image in phone.
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, use location 1, 2 or 3 for these).
TEXT text
Sets startup text in phone.
WALLPAPER fileID
Sets wallpaper in phone.
Ringtones commands
Ringtones are mostly supported only for older phones. For recent phones
you usually just upload them to some folder in phone filesystem.
There are recognized various file formats by options described below:
rttl, binary format created for Gammu, mid (saving), re (reading), ott,
communicator, ringtones format found in fkn.pl, wav (saving), ime/imy
(saving), rng, mmf (for Samsung).
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
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-in ringtones. This option is available for
DCT4 phones. For getting ringtones list use gammu
getringtoneslist.
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).
-scale Scale information will be added to each note of RTTL
ringtone. It will avoid scale problems available during
editing ringtone in composer from phone menu (for
example, in Nokia 33xx).
NOTE:
When use ~ char in ringtone name, in some phones (like 33xx)
name will blink later in phone menus.
Calendar notes commands
In Nokia 3310, 3315 and 3330 these are named "Reminders" and have some
limitations (depending on phone firmware version).
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.
To do list commands
deletetodo start [stop]
Deletes selected todo entries in phone.
getalltodo
Retrieves all todo entries from phone.
gettodo start [stop]
Retrieves selected todo entries from phone.
Notes commands
getallnotes
Reads all notes from the phone.
NOTE:
Not all phones supports this function, especially most Sony
Ericsson phones even if they have notes inside phone.
Date, time and alarm commands
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.
NOTE:
You can make such synchronization each time, when will
connect your phone and use Gammu. See SynchronizeTime in
gammurc for details.
Categories commands
NOTE:
Categories are supported only on few phones (Alcatel).
addcategory TODO|PHONEBOOK text
getallcategory TODO|PHONEBOOK
getcategory TODO|PHONEBOOK start [stop]
listmemorycategory text|number
listtodocategory text|number
Backing up and restoring commands
addnew file [-yes] [-memory ME|SM|..]
Adds data written in file created using gammu backup command.
All things backed up gammu 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 gammu 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):
o phonebook from SIM and phone memory
o calendar notes
o SMSC settings
o operator logo
o startup (static) logo or startup text
o WAP bookmarks
o WAP settings
o caller logos and groups
o user ringtones
There are various backup formats supported and the backup format
is guessed based on file extension:
o .lmb - Nokia backup, supports contacts, caller logos and
startup logo.
o .vcs - vCalendar, supports calendar and todo.
o .vcf - vCard, supports contacts.
o .ldif - LDAP import, supports contacts.
o .ics - iCalendar, supports calendar and todo.
o Any other extension is Gammu backup file and it supports all
data mentioned above, see gammu-backup for more details.
By default this command is interactive and asks which items tou
want to backup.
Use -yes for answering yes to all questions.
backupsms file [-yes|-all]
Stores all SMSes from phone to file into gammu-smsbackup.
By default this command is interactive and asks which folders
you want to backup and whether you want to remove messages from
phone afterwards.
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]
WARNING:
Please note that restoring deletes all current content in
phone. If you want only to add entries to phone, use gammu
addnew.
Restore settings written in file created using gammu backup
command.
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]
WARNING:
Please note that this overwrites existing messages in phone
(if it supports it).
Restores SMSes from file (format like gammu backupsms uses) to
selected folder in phone.
savefile TYPE [type options]
Converts between various file formats supported by Gammu,
following types are supported:
BOOKMARK target.url file location
Converts backup format supported by Gammu to vBookmark
file.
CALENDAR target.vcs file location
Allows one 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).
TODO target.vcs file location
Allows one 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).
VCARD10|VCARD21 target.vcf file SM|ME location
Allows one 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).
SEE ALSO:
gammu convertbackup
convertbackup source.file output.file
New in version 1.28.94.
Converts backup between formats supported by Gammu. Unlike gammu
savefile, this does not give you any options what to convert, it
simply takes converts all what can be saved into output file.
SEE ALSO:
gammu savefile
Nokia specific commands
nokiaaddfile TYPE [type options]
Uploads file to phone to specific location for the type:
APPLICATION|GAME file [-readonly] [-overwrite] [-overwriteall]
Install the *.jar/*.jad file pair of a midlet in the
application or game menu of the phone. You need to
specify filename without the jar/jad suffix, both will be
added automatically.
-overwrite
Delete the application's .jad and .jar files
before installing, but doesn't delete the
application data.
-overwriteall
Delete the application (same as -overwrite) and
all it's data.
You can use jadmaker to generate a .jad file from a .jar
file.
GALLERY|GALLERY2|CAMERA|TONES|TONES2|RECORDS|VIDEO|PLAYLIST|MEMORYCARD
file [-name name] [-protected] [-readonly] [-system] [-hidden]
[-newtime]
nokiaaddplaylists
Goes through phone memory and generated playlist for all music
files found.
To manually manage playlists:
gammu addfile a:\\predefplaylist filename.m3u
Will add playlist filename.m3u
gammu getfilesystem
Will get list of all files (including names of files with
playlists)
gammu deletefiles a:\\predefplaylist\\filename.m3u
Will delete playlist filename.m3u
Format of m3u playlist is easy (standard mp3 playlist):
First line is #EXTM3U, next lines contain names of files
(b:\file1.mp3, b:\folder1\file2.mp3, etc.). File needs t have
\r\n terminated lines. So just run unix2dos on the resulting
file before uploading it your your phone.
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
nokiagett9
This option should display T9 dictionary content from DCT4
phones.
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.
Created WAV files require GSM 6.10 codec to be played. In Win XP
it's included by Microsoft. If you deleted it by accident in
this operating system, make such steps:
1. Control Panel
2. Add hardware
3. click Next
4. select "Yes. I have already connected the hardware
5. select "Add a new hardware device
6. select "Install the hardware that I manually select from a
list
7. select "Sound, video and game controllers
8. select "Audio codecs
9. select "windows\system32" directory and file "mmdriver.inf
10. if You will be asked for file msgsm32.acm, it should
unpacked from Windows CD
11. now You can be asked if want to install unsigned driver
(YES), about select codec configuration (select what you
want) and rebotting PC (make it)
nokiamakecamerashoot
nokianetmonitor test
Takes output or set netmonitor for Nokia DCT3 phones.
SEE ALSO:
For more info about this option, please visit Marcin's page
and read netmonitor manual there.
NOTE:
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.
SEE ALSO:
For more info about this option, please visit Marcin's page
and read netmonitor manual there.
nokiasecuritycode
Get/reset to "12345" security code
nokiaselftests
Perform tests for Nokia DCT3 phones.
NOTE:
EEPROM test can show an error when your phone has an EEPROM
in flash (like 82xx/7110/62xx/33xx). The clock test will show
an error when the phone doesn?t have an internal battery for
the clock (like 3xxx).
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
4. and others...
nokiasetvibralevel level
Set vibra power to "level" (given in percent)
nokiatuneradio
nokiavibratest
Siemens specific commands
siemensnetmonact netmon_type
Enables network monitor in Siemens phone. Currently known values
for type are 1 for full and 2 for simple mode.
siemensnetmonitor test
siemenssatnetmon
Network commands
getgprspoint start [stop]
listnetworks [country]
Show names/codes of GSM networks known for Gammu
networkinfo
Show information about network status from the phone.
setautonetworklogin
WAP settings and bookmarks commands
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.
MMS and MMS settings commands
getallmms [-save]
geteachmms [-save]
getmmsfolders
getmmssettings start [stop]
readmmsfile file [-save]
FM radio commands
getfmstation start [stop]
Show info about FM stations in phone
Phone information commands
battery
Displays information about battery and power source.
getdisplaystatus
getlocation
Gets network information from phone (same as networkinfo) and
prints location (latitude and longitude) based on information
from OpenCellID.
getsecuritystatus
Show, if phone wait for security code (like PIN, PUK, etc.) or
not
identify
Show the most important phone data.
monitor [times]
Retrieves phone status and writes it continuously to standard
output. Press Ctrl+C to interrupt this command.
If no parameter is given, the program runs until interrupted,
otherwise only given number of iterations is performed.
This command outputs almost all information Gammu supports:
o Number of contacts, calendar and todo entries, messages,
calls, etc.
o Signal strength.
o Battery state.
o Currently used network.
o Notifications of incoming messages and calls.
Phone settings commands
getcalendarsettings
Displays calendar settings like first day of week or automatic
deleting of old entries.
getprofile start [stop]
resetphonesettings PHONE|DEV|UIF|ALL|FACTORY
WARNING:
This will delete user data, be careful.
Reset phone settings.
PHONE Clear phone settings.
DEV Clear device settings.
ALL Clear user settings.
o removes or set logos to default
o set default phonebook and other menu settings
o clear T9 words,
o clear call register info
o set default profiles settings
o clear user ringtones
UIF Clear user settings and disables hidden menus.
o changes like after ALL
o disables netmon and PPS (all "hidden" menus)
FACTORY
Reset to factory defaults.
o changes like after UIF
o clear date/time
Dumps decoding commands
NOTE:
These commands are available only if Gammu was compiled with
debugging options.
decodebinarydump file [phonemodel]
Decodes a dump made by Gammu with LogFormat set to binary.
decodesniff MBUS2|IRDA file [phonemodel]
Allows one to decode sniffs. See Discovering protocol for more
details.
Other commands
entersecuritycode PIN|PUK|PIN2|PUK2|PHONE|NETWORK code|- [newpin|-]
Allow one to enter security code from PC. When code is -, it is
read from stdin.
In case entering PUK, some phones require you to set new PIN as
well.
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#
numeric keyboard
reset SOFT|HARD
Make phone reset:
SOFT without asking for PIN
HARD with asking for PIN
NOTE:
Some phones will ask for PIN even with SOFT option.
WARNING:
Some phones will reset user data on HARD reset.
setpower ON|OFF
New in version 1.33.90.
Turns off or on the phone.
NOTE:
This is usually required for built in modules in notebooks.
screenshot filename
Captures phone screenshot and saves it as filename. The
extension is automatically appended to filename based on what
data phone provides.
Batch mode commands
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).
Configuration commands
searchphone [-debug]
Attempts to search for a connected phone.
WARNING:
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.
install [-minimal]
Installs applet for currently configured connection to the
phone.
You can configure search path for instllation files by DataPath.
The -minimal parameter forces installation of applet only
without possible support libraries, this can be useful for
updates.
Gammu information commands
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.
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.
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 Operation not allowed by phone.
131 No SMSC number given. Provide it manually or use the one
configured in phone.
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 running.
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.
169 Failed to get SMSC number from phone.
170 Operation aborted.
171 Installation data not found, please consult debug log and/or
documentation for more details.
172 Entry is read only.
EXAMPLES
Configuration
To check it out, you need to have configuration file for gammu, see
gammurc for more details about it.
Sending messages
NOTE:
All messages below are sent to number 123456, replace it with proper
destination.
Send text message up to standard 160 chars:
echo "All your base are belong to us" | gammu sendsms TEXT 123456
or
gammu sendsms TEXT 123456 -text "All your base are belong to us"
Send long text message:
echo "All your base are belong to us" | gammu sendsms TEXT 123456 -len 400
or
gammu sendsms TEXT 123456 -len 400 -text "All your base are belong to us"
or
gammu sendsms EMS 123456 -text "All your base are belong to us"
Send some funky message with predefined sound and animation from 2
bitmaps:
gammu sendsms EMS 123456 -text "Greetings" -defsound 1 -text "from Gammu -tone10 axelf.txt -animation 2 file1.bmp file2.bmp
Send protected message with ringtone:
gammu sendsms EMS 123456 -protected 2 -variablebitmaplong ala.bmp -toneSElong axelf.txt -toneSE ring.txt
Retrieving USSD replies
For example for retrieving prepaid card status or retrieving various
network info:
gammu getussd '#555#'
Uploading files to Nokia
Add Alien to applications in your phone (you need to have files
Alien.JAD and Alien.JAR in current directory):
gammu nokiaaddfile APPLICATION Alien
Add file.mid to ringtones folder:
gammu nokiaaddfile TONES file.mid
Setting operator logo
Set logo for network 230 03 (Vodafone CZ):
gammu setbitmap OPERATOR ala.bmp "230 03"
Converting file formats
The formats conversion can done using gammu savefile or gammu
convertbackup commands.
Convert single entry (at position 260) from gammu-backup to vCalendar:
gammu savefile CALENDAR output.vcs myCalendar.backup 260
Convert first phonebook entry from gammu-backup to vCard:
gammu savefile VCARD21 output.vcf phone.backup ME 1
Convert all contacts from backup to vCard:
gammu convertbackup phone.backup output.vcf
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:
[gammu]
YOUR CONNECTION SETTINGS
logfile = /tmp/gammu.log
logformat = textall
Alternatively you can specify logging on command line:
gammu -d textall -f /tmp/gammu.log ...
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 Gammu bug tracker.
AUTHOR
Michal Cihar <michal@cihar.com>
COPYRIGHT
2009-2015, Michal Cihar <michal@cihar.com>
1.36.8 December 8, 2015 GAMMU(1)