Provided by: gammu_1.31.0-1_i386 bug

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

       -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 bellow 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.

       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
              Installs  applet  for  currently  configured  connection  to the
              phone.

              You can configure search path for instllation files by DataPath.

   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  bellow 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 iha <michal@cihar.com>

COPYRIGHT

       2009-2011, Michal iha <michal@cihar.com>