1GAMMU(1)                             Gammu                            GAMMU(1)
2
3
4

NAME

6       gammu - Does some neat things with your cellular phone or modem.
7

SYNOPSIS

9          gammu [parameters] <command> [options]
10
11       Commands  actually  indicate which operation should Gammu perform. They
12       can be specified with or without a leading --.
13

DESCRIPTION

15       This program is a tool for mobile phones. Many vendors and  phones  are
16       supported, for actual listing see Gammu Phones Database.
17
18   Options
19       Parameters before command configure gammu behaviour:
20
21       -c, --config <filename>
22              name of configuration file (see gammurc)
23
24       -s, --section <confign>
25              section of config file to use, eg. 42
26
27       -d, --debug <level>
28              debug level (see LogFormat in gammurc for possible values)
29
30       -f, --debug-file <filename>
31              file for logging debug messages
32
33   Call commands
34       answercall [id]
35              Answer incoming call.
36
37       cancelcall [id]
38              Cancel incoming call
39
40       canceldiverts
41              Cancel all existing call diverts.
42
43       conferencecall id
44              Initiates a conference call.
45
46       dialvoice number [show|hide]
47              Make voice call from SIM card line set in phone.
48
49              show|hide  -  optional  parameter whether to disable call number
50              indication.
51
52       divert  get|set  all|busy|noans|outofreach  all|voice|fax|data  [number
53       timeout]
54              Manage or display call diverts.
55
56              get or set
57                     whether to get divert information or to set it.
58
59              all or busy or noans or outofreach
60                     condition when apply divert
61
62              all or voice or fax or data
63                     call type when apply divert
64
65              number number where to divert
66
67              timeout
68                     timeout when the diversion will happen
69
70       getussd code
71              Retrieves  USSD  information  - dials a service number and reads
72              response.
73
74       holdcall id
75              Holds call.
76
77       maketerminatedcall number length [show|hide]
78              Make voice call from SIM card line set in phone  which  will  be
79              terminated after length seconds.
80
81       senddtmf sequence
82              Plays DTMF sequence. In some phones available only during calls
83
84       splitcall id
85              Splits call.
86
87       switchcall [id]
88              Switches call.
89
90       transfercall [id]
91              Transfers call.
92
93       unholdcall id
94              Unholds call.
95
96   SMS and EMS commands
97       Sending  messages might look a bit complicated on first attempt to use.
98       But be patient, the command line has been written  in  order  to  allow
99       almost every usage. See EXAMPLE section for some hints on usage.
100
101       There  is  also  an  option  to use gammu-smsd when you want to send or
102       receive more messages and process them automatically.
103
104   Introduction to SMS formats
105       Gammu has support for many SMS formats like:
106
107       Nokia Smart Messaging
108              used for monochromatic picture  images,  downloadable  profiles,
109              monochromatic  operator  logos,  monochromatic  caller logos and
110              monophonic ringtones
111
112       Linked SMS
113              both with 8 and 16-bit identification numbers in headers
114
115       EMS    this is SMS format used for saving monochromatic  images,  mono‐
116              phonic ringtones, animations, text formatting and others
117
118       MMS notifications
119              contains links where phone should download MMS
120
121       Alcatel logo messages
122              proprietary format for logos
123
124       You need to ensure that the target phone supports message type you want
125       to send. Otherwise the phone will not be able to  display  it  or  will
126       even crash, because firmware of phone did not expect this possibility.
127
128   Encoding chars in SMS text
129       Text in SMS can be coded using two ways:
130
131   GSM Default Alphabet
132       With GSM Default Alphabet you can fit at most 160 chars into single SMS
133       (Gammu doesn’t support compressing such texts according  to  GSM  stan‐
134       dards,  but  it isn’t big limit, because there are no phones supporting
135       them), but they’re from limited set:
136
137       · all Latin small and large
138
139       · all digits
140
141       · some Greek
142
143       · some other national
144
145       · some symbols like  @ ! ” # & / ( ) % * + = - , . : ; < > ?
146
147       · few others
148
149   Unicode
150       With Unicode single SMS can contain at most 70 chars, but these can  be
151       any chars including all national and special ones.
152
153       WARNING:
154          Please  note,  that some older phones might have problems displaying
155          such message.
156
157   Conversion
158       Gammu tries to do the best to handle non ASCII characters in your  mes‐
159       sage.   Everything  is internally handled in Unicode (the input is con‐
160       verted depending on your locales configuration)  and  in  case  message
161       uses Unicode the text will be given as such to the message.
162
163       Should  the  message be sent in GSM Default Alphabet, Gammu will try to
164       convert all characters to keep message  readable.  Gammu  does  support
165       multi  byte encoding for some characters in GSM Default Alphabet (it is
166       needed for ^ { } \ [ ] ~ |). The characters which are  not  present  in
167       GSM  Default  Alphabet  are  transliterated to closest ASCII equivalent
168       (accents are removed).  Remaining not known characters are replaced  by
169       question mark.
170
171   SMS commands
172       addsmsfolder name
173
174       deleteallsms folder
175              Delete all SMS from specified SMS folder.
176
177       deletesms folder start [stop]
178              Delete SMS from phone. See description for gammu getsms for info
179              about sms folders naming convention.
180
181              Locations are numerated from 1.
182
183       displaysms ... (options like in sendsms)
184              Displays PDU data of  encoded  SMS  messages.  It  accepts  same
185              parameters and behaves same like sendsms.
186
187       getallsms -pbk
188              Get  all  SMS  from phone. In some phones you will have also SMS
189              templates and info about locations used to save Picture  Images.
190              With each sms you will see location. If you want to get such sms
191              from phone alone, use gammu getsms.
192
193       geteachsms -pbk
194              Similiary to gammu getallsms. Difference is, that links all con‐
195              catenated sms
196
197       getsms folder start [stop]
198              Get SMS.
199
200              Locations are numerated from 1.
201
202              Folder  0  means  that sms is being read from “flat” memory (all
203              sms from all folders have unique numbers). It’s  sometimes  emu‐
204              lated by Gammu. You can use it with all phones.
205
206              Other  folders  like  1,  2, etc. match folders in phone such as
207              Inbox, Outbox, etc.  and each  sms  has  unique  number  in  his
208              folder. Name of folders can depend on your phone (the most often
209              1=”Inbox”, 2=”Outbox”, etc.).  This method is not  supported  by
210              all  phones  (for  example,  not  supported by Nokia 3310, 5110,
211              6110). If work with your phone, use gammu getsmsfolders  to  get
212              folders list.
213
214       getsmsc [start [stop]]
215              Get SMSC settings from SIM card.
216
217              Locations are numerated from 1.
218
219       getsmsfolders
220              Get names for SMS folders in phone
221
222       savesms  TYPE  [type  parameters] [type options] [-folder id] [-unread]
223       [-read] [-unsent] [-sent] [-sender number]  [-smsname  name]  [-smscset
224       number] [-smscnumber number] [-reply] [-maxsms num]
225              Saves SMS to phone, see below for TYPE options.
226
227                 -smscset number
228                        SMSC  number will be taken from phone stored SMSC con‐
229                        figuration number.
230
231                        Default: 1
232
233                 -smscnumber number
234                        SMSC number
235
236                 -reply reply SMSC is set
237
238                 -folder number
239                        save to specified folder.
240
241                        Folders are numerated from 1.
242
243                        The most often folder 1 = “Inbox”, 2  =  “Outbox”,etc.
244                        Use gammu getsmsfolders to get folder list.
245
246                 -unread
247                        makes  message  unread. In some phones (like 6210) you
248                        won’t see unread sms envelope after saving  such  sms.
249                        In  some  phones  with internal SMS memory (like 6210)
250                        after using it with folder 1 SIM SMS  memory  will  be
251                        used
252
253                 -read  makes  message  read. In some phones with internal SMS
254                        memory (like 6210) after using it with  folder  1  SIM
255                        SMS memory will be used
256
257                 -unsent
258                        makes message unsent
259
260                 -sent  makes message sent
261
262                 -smsname name
263                        set message name
264
265                 -sender number
266                        set sender number (default: Gammu)
267
268                 -maxsms num
269                        Limit  maximum  number  of messages which will be cre‐
270                        ated. If there are more messages, Gammu will terminate
271                        with failure.
272
273                 Types of messages:
274
275                 ANIMATION frames file1 file2...
276                        Save an animation as a SMS. You need to give number of
277                        frames and picture for each frame. Each picture can be
278                        in  any  picture format which Gammu supports (B/W bmp,
279                        gif, wbmp, nol, nlm…).
280
281                 BOOKMARK file location
282                        Read WAP bookmark from file created  by  gammu  backup
283                        command and saves in Nokia format as SMS
284
285                 CALENDAR file location
286                        Read  calendar  note from file created by gammu backup
287                        command and saves in VCALENDAR 1.0 format as SMS.  The
288                        location  identifies  position  of calendar item to be
289                        read in backup file (usually 1, but can be  useful  in
290                        case the backup contains more items).
291
292                 CALLER file
293                        Save  caller  logo  as  sms in Nokia (Smart Messaging)
294                        format - size 72x14, two colors.
295
296                        WARNING:
297                            Please note, that it  isn’t  designed  for  colour
298                            logos  available  for  example  in DCT4/TIKU - you
299                            need to put bitmap file there inside  phone  using
300                            filesystem commands.
301
302                 USSD   Send USSD query instead of SMS.
303
304                 EMS  [-unicode]  [-16bit]  [-format  lcrasbiut]  [-text text]
305                 [-unicodefiletext file]  [-defsound  ID]  [-defanimation  ID]
306                 [-tone10 file] [-tone10long file] [-tone12 file] [-tone12long
307                 file] [-toneSE file] [-toneSElong file]  [-fixedbitmap  file]
308                 [-variablebitmap file] [-variablebitmaplong file] [-animation
309                 frames file1 ...] [-protected number]
310                        Saves EMS sequence.  All  format  specific  parameters
311                        (like -defsound) can be used few times.
312
313                        -text  adds text
314
315                        -unicodefiletext
316                               adds text from Unicode file
317
318                        -defanimation
319                               adds  default  animation  with  ID specified by
320                               user. ID for different phones are different.
321
322                        -animation
323                               adds “frames” frames read  from  file1,  file2,
324                               etc.
325
326                        -defsound
327                               adds  default  sound with ID specified by user.
328                               ID for different phones are different.
329
330                        -tone10
331                               adds IMelody version  1.0  read  from  RTTL  or
332                               other compatible file
333
334                        -tone10long
335                               IMelody  version  1.0  saved  in one of few SMS
336                               with UPI.  Phones  compatible  with  UPI  (like
337                               Sony-Ericsson  phones)  will read such ringtone
338                               as one
339
340                        -tone12
341                               adds IMelody version  1.2  read  from  RTTL  or
342                               other compatible file
343
344                        -tone12long
345                               IMelody  version  1.2  saved  in one of few SMS
346                               with UPI.  Phones  compatible  with  UPI  (like
347                               Sony-Ericsson  phones)  will read such ringtone
348                               as one
349
350                        -toneSE
351                               adds  IMelody  in  “short”  form  supported  by
352                               Sony-Ericsson phones
353
354                        -toneSElong
355                               add  Sony-Ericsson  IMelody saved in one or few
356                               SMS with UPI
357
358                        -variablebitmap
359                               bitmap in any size saved in one SMS
360
361                        -variablebitmaplong
362                               bitmap with maximum size 96x128 saved in one or
363                               few sms
364
365                        -fixedbitmap
366                               bitmap 16x16 or 32x32
367
368                        -protected
369                               all  ringtones and bitmaps after this parameter
370                               (excluding default ringtones and logos) will be
371                               “protected” (in phones compatible with ODI like
372                               SonyEricsson products it won’t be  possible  to
373                               forward them from phone menu)
374
375                        -16bit Gammu  uses SMS headers with 16-bit numbers for
376                               saving linking info in SMS (it means less chars
377                               available for user in each SMS)
378
379                        -format lcrasbiut
380                               last text will be formatted. You can use combi‐
381                               nations of chars:
382
383                                      ┌──────────┬────────────────────┐
384                                      │Character │ Formating          │
385                                      ├──────────┼────────────────────┤
386l         │ left aligned       │
387                                      ├──────────┼────────────────────┤
388c         │ centered           │
389                                      ├──────────┼────────────────────┤
390r         │ right aligned      │
391                                      ├──────────┼────────────────────┤
392a         │ large font         │
393                                      ├──────────┼────────────────────┤
394s         │ small font         │
395                                      ├──────────┼────────────────────┤
396b         │ bold font          │
397                                      ├──────────┼────────────────────┤
398i         │ italic font        │
399                                      ├──────────┼────────────────────┤
400u         │ underlined font    │
401                                      ├──────────┼────────────────────┤
402t         │ strikethrough font │
403                                      └──────────┴────────────────────┘
404
405                 MMSINDICATOR URL Title Sender
406                        Creates a MMS indication SMS. It  contains  URL  where
407                        the  actual  MMS  payload  is stored which needs to be
408                        SMIL encoded. The phone usually downloads the MMS data
409                        using special APN, which does not count to transmitted
410                        data, however there might be  limitations  which  URLs
411                        can be accessed.
412
413                 MMSSETTINGS file location
414                        Saves a message with MMS configuration. The configura‐
415                        tion will be read from Gammu backup  file  from  given
416                        location.
417
418                 OPERATOR file [-netcode netcode] [-biglogo]
419                        Save  operator  logo as sms in Nokia (Smart Messaging)
420                        format - size 72x14 in two colors.
421
422                        -biglogo
423                               Use 78x21 formatted logo  instead  of  standard
424                               72x14.
425
426                        NOTE:
427                            This isn’t designed for colour logos available for
428                            example in newer phones - you need to  put  bitmap
429                            file there inside phone using filesystem commands.
430
431                 PICTURE file [-text text] [-unicode] [-alcatelbmmi]
432                        Read  bitmap  from  2 colors file (bmp, nlm, nsl, ngg,
433                        nol, wbmp, etc.), format into bitmap in Smart  Messag‐
434                        ing  (72x28,  2 colors, called often Picture Image and
435                        saved with text) or Alcatel format and send/save  over
436                        SMS.
437
438                 PROFILE [-name name] [-bitmap bitmap] [-ringtone ringtone]
439                        Read  ringtone  (RTTL)  format,  bitmap (Picture Image
440                        size) and name, format into  Smart  Messaging  profile
441                        and send/save as SMS.
442
443                        WARNING:
444                            Please  note,  that  this  format  is abandoned by
445                            Nokia and supported by some (older)  devices  only
446                            like Nokia 3310.
447
448                 RINGTONE file [-long] [-scale]
449                        Read  RTTL  ringtone  from  file  and save as SMS into
450                        SIM/phone memory. Ringtone is saved  in  Nokia  (Smart
451                        Messaging) format.
452
453                        -long  ringtone  is  saved using Profile style. It can
454                               be longer (and saved in  2  SMS),  but  decoded
455                               only by newer phones (like 33xx)
456
457                        -scale ringtone will have Scale info for each note. It
458                               will allow one to edit it  correctly  later  in
459                               phone composer (for example, in 33xx)
460
461                 SMSTEMPLATE  [-unicode]  [-text text] [-unicodefiletext file]
462                 [-defsound ID] [-defanimation ID] [-tone10 file] [-tone10long
463                 file]   [-tone12  file]  [-tone12long  file]  [-toneSE  file]
464                 [-toneSElong file] [-variablebitmap  file]  [-variablebitmap‐
465                 long file] [-animation frames file1 ...]
466                        Saves a SMS template (for Alcatel phones).
467
468                 TEXT  [-inputunicode]  [-16bit] [-flash] [-len len] [-autolen
469                 len] [-unicode] [-enablevoice]  [-disablevoice]  [-enablefax]
470                 [-disablefax]   [-enableemail]   [-disableemail]   [-voidsms]
471                 [-replacemessages ID]  [-replacefile  file]  [-text  msgtext]
472                 [-textutf8 msgtext]
473                        Take  text  from stdin (or commandline if -text speci‐
474                        fied) and save as text SMS into SIM/phone memory.
475
476                        -flash Class 0 SMS (should be displayed after  receiv‐
477                               ing  on recipients’ phone display after receiv‐
478                               ing without entering Inbox)
479
480                        -len len
481                               specify, how many chars will be read. When  use
482                               this option and text will be longer than 1 SMS,
483                               will be split into more linked SMS
484
485                        -autolen len
486                               specify, how many chars will be read. When  use
487                               this option and text will be longer than 1 SMS,
488                               will be split into more linked SMS.Coding  type
489                               (SMS default alphabet/Unicode) is set according
490                               to input text
491
492                        -enablevoice
493                               sms will set voice mail indicator. Text will be
494                               cut to 1 sms.
495
496                        -disablevoice
497                               sms  will  not  set  voice mail indicator. Text
498                               will be cut to 1 sms.
499
500                        -enablefax
501                               sms will set fax indicator. Text will be cut to
502                               1 sms.
503
504                        -disablefax
505                               sms  will  not  set fax indicator. Text will be
506                               cut to 1 sms.
507
508                        -enableemail
509                               sms will set email indicator. Text will be  cut
510                               to 1 sms.
511
512                        -disableemail
513                               sms  will not set email indicator. Text will be
514                               cut to 1 sms.
515
516                        -voidsms
517                               many phones after receiving  it  won’t  display
518                               anything,  only beep, vibrate or turn on light.
519                               Text will be cut to 1 sms.
520
521                        -unicode
522                               SMS will be saved in Unicode format
523
524                               NOTE:
525                                   The ~ char in SMS text and -unicode  option
526                                   (Unicode coding required) can cause text of
527                                   SMS after ~  char   blink  in  some  phones
528                                   (like Nokia 33xx).
529
530                        -inputunicode
531                               input text is in Unicode.
532
533                               NOTE:
534                                   You  can  create Unicode file using WordPad
535                                   in Windows (during saving  select  “Unicode
536                                   Text Document” format). In Unix can use for
537                                   example YUdit or vim.
538
539                        -text  get text from command line instead of stdin.
540
541                        -textutf8
542                               get text in UTF-8 from command line instead  of
543                               stdin.
544
545                               NOTE:
546                                   Gammu  detects  your  locales  and  uses by
547                                   default encoding based on  this.  Use  this
548                                   option only when you know the input will be
549                                   in UTF-8 in all cases.
550
551                        -16bit Gammu uses SMS headers with 16-bit numbers  for
552                               saving linking info in SMS (it means less chars
553                               available for user in each SMS)
554
555                        -replacemessages ID
556                               ID can be 1..7. When you will  use  option  and
557                               send  more single SMS to one recipient with the
558                               same ID, each another  SMS  will  replace  each
559                               previous with the same ID
560
561                        -replacefile file
562                               File with replacement table in unicode (UCS-2),
563                               preferably with byte order mark (BOM). It  con‐
564                               tains  pairs of chars, first one is to replace,
565                               second is replacement one. The  replacement  is
566                               done after reading text for the message.
567
568                               For  example  replacement  1  (0x0061)  with  a
569                               (0x0031) would be done by file  with  following
570                               content (hex dump, first two bytes is BOM):
571
572                                   ff fe 61 00 31 00
573
574                 TODO file location
575                        Saves a message with a todo entry. The content will be
576                        read from any backup format which Gammu  supports  and
577                        from given location.
578
579                 VCARD10|VCARD21 file SM|ME location [-nokia]
580                        Read phonebook entry from file created by gammu backup
581                        command and saves in VCARD 1.0 (only name and  default
582                        number)  or VCARD 2.1 (all entry details with all num‐
583                        bers, text and name)  format  as  SMS.   The  location
584                        identifies  position  of  contact  item  to be read in
585                        backup file (usually 1, but can be useful in case  the
586                        backup contains more items).
587
588                 WAPINDICATOR URL Title
589                        Saves  a  SMS  with a WAP indication for given URL and
590                        title.
591
592                 WAPSETTINGS file location DATA|GPRS
593                        Read WAP settings from file created  by  gammu  backup
594                        command and saves in Nokia format as SMS
595
596       sendsms  TYPE  destination  [type  parameters] [type options] [-smscset
597       number]   [-smscnumber   number]    [-reply]    [-report]    [-validity
598       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]]
599              Sends  a  message  to  a destination number, most parameters are
600              same as for gammu savesms.
601
602              -save  will also save message which is being sent
603
604              -report
605                     request delivery report for message
606
607              -validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX
608                     sets how long will be the message valid  (SMSC  will  the
609                     discard  the  message  after  this  time  if it could not
610                     deliver it).
611
612       setsmsc location number
613              Set SMSC settings on SIM card. This keeps all SMSC configuration
614              intact, it just changes the SMSC number.
615
616              Locations are numerated from 1.
617
618   Memory (phonebooks and calls) commands
619   Memory types
620       Gammu recognizes following memory types:
621
622       DC     Dialled calls
623
624       MC     Missed calls
625
626       RC     Received calls
627
628       ON     Own numbers
629
630       VM     voice mailbox
631
632       SM     SIM phonebook
633
634       ME     phone internal phonebook
635
636       FD     fixed dialling
637
638       SL     sent SMS log
639
640   Memory commands
641       deleteallmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL
642              Deletes all entries from specified memory type.
643
644              For memory types description see Memory types.
645
646       deletememory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL start [stop]
647              Deletes entries in specified range from specified memory type.
648
649              For memory types description see Memory types.
650
651       getallmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL
652              Get all memory locations from phone.
653
654              For memory types description see Memory types.
655
656       getmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL start [stop [-nonempty]]
657              Get memory location from phone.
658
659              For memory types description see Memory types.
660
661              Locations are numerated from 1.
662
663       getspeeddial start [stop]
664              Gets speed dial choices.
665
666       searchmemory text
667              Scans all memory entries for given text. It performs case insen‐
668              sitive substring lookup. You can interrupt searching by pressing
669              Ctrl+C.
670
671   Filesystem commands
672       Gammu  allows  one  to  access phones using native protocol (Nokias) or
673       OBEX. Your phone can also support usb storage, which is handled on  the
674       operating system level and Gammu does not use that.
675
676       addfile folderID name [-type JAR|BMP|PNG|GIF|JPG|MIDI|WBMP|AMR|3GP|NRT]
677       [-readonly] [-protected] [-system] [-hidden] [-newtime]
678              Add file with specified name to folder with specified folder ID.
679
680              -type  File type was required for filesystem 1 in  Nokia  phones
681                     (current filesystem 2 doesn’t need this).
682
683              -readonly
684                     Sets the read only attribute.
685
686              -protected
687                     Sets  the  protected attribute (file can’t be for example
688                     forwarded from phone menu).
689
690              -system
691                     Sets the system attribute.
692
693              -hidden
694                     Sets the hidden attribute  (file  is  hidden  from  phone
695                     menu).
696
697              -newtime
698                     After using it date/time of file modification will be set
699                     to moment of uploading.
700
701       addfolder parentfolderID name
702              Create a folder in phone with specified name in  a  folder  with
703              specified folder ID.
704
705       deletefiles fileID
706              Delete files with given IDs.
707
708       deletefolder name
709              Delete folder with given ID.
710
711       getfilefolder fileID, fileID
712              Retrieve  files  or  all files from folder with given IDs from a
713              phone filesytem.
714
715       getfiles fileID, fileID
716              Retrieve files with given IDs from a phone filesytem.
717
718       getfilesystem [-flatall|-flat]
719              Display info about all folders and files in phone  memory/memory
720              card. By default there is tree displayed, you can change it:
721
722              -flatall
723                     there  are  displayed  full  file/folder  details like ID
724                     (first parameter in line)
725
726              -flat
727
728              NOTE:
729                 In some phones (like N6230) content  of  some  folders  (with
730                 more files) can be cut (only part of files will be displayed)
731                 for example on infrared connection. This is not Gammu  issue,
732                 but phone firmware problem.
733
734       getfilesystemstatus
735              Display info filesystem status - number of bytes available, used
736              or used by some specific content.
737
738       getfolderlisting folderID
739              Display files and folders available in folder with given  folder
740              ID. You can get ID’s using getfilesystem -flatall.
741
742              WARNING:
743                 Please note, that in some phones (like N6230) content of some
744                 folders (with more files) can be cut (only part of files will
745                 be displayed) for example on infrared connection. This is not
746                 Gammu issue, but phone firmware problem.
747
748       getrootfolders
749              Display info about drives available in phone/memory card.
750
751       sendfile name
752              Sends file to a phone. It’s up to phone to decide where to store
753              this  file and how to handle it (for example when you send vCard
754              or vCalendar, most of phones will offer you to import it.
755
756       setfileattrib folderID [-system] [-readonly] [-hidden] [-protected]
757
758   Logo and pictures commands
759       These options are mainly (there are few exceptions)  for  monochromatic
760       logos  and  images  available in older phones. Recognized file formats:
761       xpm (only saving), 2-colors bmp, nlm, nsl, ngg,  nol,  wbmp,  gif  (for
762       Samsung).
763
764       In  new  models  all bitmaps are saved in filesystem and should go into
765       filesystem section
766
767       copybitmap inputfile [outputfile [OPERATOR|PICTURE|STARTUP|CALLER]]
768              Allow one to convert logos files  to  another.  When  give  ONLY
769              inputfile,  output  will  be  written to stdout using ASCII art.
770              When give output file and format, in  some  file  formats  (like
771              NLM) will be set indicator informing about logo type to given.
772
773       getbitmap TYPE [type options]
774              Reads bitmap from phone, following types are supported:
775
776              CALLER location [file]
777                     Get caller group logo from phone. Locations 1-5.
778
779              DEALER In  some models it’s possible to save dealer welcome note
780                     - text displayed during enabling phone,  which  can’t  be
781                     edited from phone menu.  Here you can get it.
782
783              OPERATOR [file]
784                     Get  operator logo (picture displayed instead of operator
785                     name) from phone.
786
787              PICTURE location [file]
788                     Get Picture Image from phone.
789
790              STARTUP [file]
791                     Get static startup logo from phone. Allow one to save  it
792                     in file.
793
794              TEXT   Get startup text from phone.
795
796       setbitmap TYPE [type options]
797              Sets bitmap in phone, following types are supported:
798
799              CALLER location [file]
800                     Set caller logo.
801
802              COLOUROPERATOR [fileID [netcode]]
803                     Sets color operator logo in phone.
804
805              COLOURSTARTUP [fileID]
806
807              DEALER text
808                     Sets  welcome message configured by dealer, which usually
809                     can not be changed in phone menus.
810
811              OPERATOR [file [netcode]]
812                     Set operator logo in phone. When won’t give file and net‐
813                     code, operator logo will be removed from phone. When will
814                     give only filename, operator logo will be  displayed  for
815                     your  current  GSM  operator.  When you give additionally
816                     network code, it will be displayed for this operator.
817
818              PICTURE file location [text]
819                     Sets picture image in phone.
820
821              STARTUP file|1|2|3
822                     Set startup logo in phone. It can  be  static  (then  you
823                     will  have  to  give file name) or one of predefined ani‐
824                     mated (only some phones like Nokia 3310 or 3330  supports
825                     it, use location 1, 2 or 3 for these).
826
827              TEXT text
828                     Sets startup text in phone.
829
830              WALLPAPER fileID
831                     Sets wallpaper in phone.
832
833   Ringtones commands
834       Ringtones are mostly supported only for older phones. For recent phones
835       you usually just upload them to some folder in phone filesystem.
836
837       There are recognized various file formats by options  described  below:
838       rttl, binary format created for Gammu, mid (saving), re (reading), ott,
839       communicator, ringtones format found in fkn.pl, wav  (saving),  ime/imy
840       (saving), rng, mmf (for Samsung).
841
842       copyringtone source destination [RTTL|BINARY]
843              Copy source ringtone to destination.
844
845       getphoneringtone location [file]
846              Get one of “default” ringtones and saves into file
847
848       getringtone location [file]
849              Get ringtone from phone in RTTL or BINARY format.
850
851              Locations are numerated from 1.
852
853       getringtoneslist
854
855       playringtone file
856              Play approximation of ringtone over phone buzzer. File can be in
857              RTTL or BINARY (Nokia DCT3) format.
858
859       playsavedringtone number
860              Play one of built-in ringtones. This  option  is  available  for
861              DCT4 phones.  For getting ringtones list use gammu getringtones‐
862              list.
863
864       setringtone file [-location location] [-scale] [-name name]
865              Set ringtone in phone. When don’t  give  location,  it  will  be
866              written  “with  preview” (in phones supporting this feature like
867              61xx or 6210).
868
869              -scale Scale information will be added  to  each  note  of  RTTL
870                     ringtone.  It  will avoid scale problems available during
871                     editing ringtone in composer from phone menu  (for  exam‐
872                     ple, in Nokia 33xx).
873
874              NOTE:
875                 When  use ~ char in ringtone name, in some phones (like 33xx)
876                 name will blink later in phone menus.
877
878   Calendar notes commands
879       In Nokia 3310, 3315 and 3330 these are named “Reminders” and have  some
880       limitations (depending on phone firmware version).
881
882       deletecalendar start [stop]
883              Deletes selected calendar entries in phone.
884
885       getallcalendar
886              Retrieves all calendar entries from phone.
887
888       getcalendar start [stop]
889              Retrieves selected calendar entries from phone.
890
891   To do list commands
892       deletetodo start [stop]
893              Deletes selected todo entries in phone.
894
895       getalltodo
896              Retrieves all todo entries from phone.
897
898       gettodo start [stop]
899              Retrieves selected todo entries from phone.
900
901   Notes commands
902       getallnotes
903              Reads all notes from the phone.
904
905              NOTE:
906                 Not  all  phones supports this function, especially most Sony
907                 Ericsson phones even if they have notes inside phone.
908
909   Date, time and alarm commands
910       getalarm [start]
911              Get alarm from phone, if no location is specified, 1 is used.
912
913       getdatetime
914              Get date and time from phone
915
916       setalarm hour minute
917              Sets repeating alarm in phone on selected time.
918
919       setdatetime [HH:MM[:SS]] [YYYY/MM/DD]
920              Set date and time in phone to date and  time  set  in  computer.
921              Please  note,  that  this  option  doesn’t  show  clock on phone
922              screen. It only set date and time.
923
924              NOTE:
925                 You can make such synchronization each time, when  will  con‐
926                 nect your phone and use Gammu. See SynchronizeTime in gammurc
927                 for details.
928
929   Categories commands
930       NOTE:
931          Categories are supported only on few phones (Alcatel).
932
933       addcategory TODO|PHONEBOOK text
934
935       getallcategory TODO|PHONEBOOK
936
937       getcategory TODO|PHONEBOOK start [stop]
938
939       listmemorycategory text|number
940
941       listtodocategory text|number
942
943   Backing up and restoring commands
944       addnew file [-yes] [-memory ME|SM|..]
945              Adds data written in file created using  gammu  backup  command.
946              All  things  backed  up  gammu backup can be restored (when made
947              backup to Gammu text file).
948
949              Please note that this adds all content of backup file  to  phone
950              and does not care about current data in the phone (no duplicates
951              are detected).
952
953              Use -yes parameter to answer yes to all questions (you  want  to
954              automatically restore all data).
955
956              Use  -memory parameter to force usage of defined memory type for
957              storing entries regardless what backup format says.
958
959       addsms folder file [-yes]
960              Adds SMSes from file  (format  like  gammu  backupsms  uses)  to
961              selected folder in phone.
962
963       backup file [-yes]
964              Backup  your  phone to file. It’s possible to backup (depends on
965              phone and backup format):
966
967              · phonebook from SIM and phone memory
968
969              · calendar notes
970
971              · SMSC settings
972
973              · operator logo
974
975              · startup (static) logo or startup text
976
977              · WAP bookmarks
978
979              · WAP settings
980
981              · caller logos and groups
982
983              · user ringtones
984
985              There are various backup formats supported and the backup format
986              is guessed based on file extension:
987
988              · .lmb  -  Nokia  backup,  supports  contacts,  caller logos and
989                startup logo.
990
991              · .vcs - vCalendar, supports calendar and todo.
992
993              · .vcf - vCard, supports contacts.
994
995              · .ldif - LDAP import, supports contacts.
996
997              · .ics - iCalendar, supports calendar and todo.
998
999              · Any other extension is Gammu backup file and it  supports  all
1000                data mentioned above, see gammu-backup for more details.
1001
1002              By  default this command is interactive and asks which items tou
1003              want to backup.
1004
1005              Use -yes for answering yes to all questions.
1006
1007       backupsms file [-yes|-all]
1008              Stores all SMSes from phone to file into gammu-smsbackup.
1009
1010              By default this command is interactive and  asks  which  folders
1011              you  want to backup and whether you want to remove messages from
1012              phone afterwards.
1013
1014              Use -yes for answering yes to all questions (backup all messages
1015              and  delete them from phone), or -all to just backup all folders
1016              while keeping messages in phone.
1017
1018       restore file [-yes]
1019
1020              WARNING:
1021                 Please note that restoring deletes  all  current  content  in
1022                 phone.  If  you  want only to add entries to phone, use gammu
1023                 addnew.
1024
1025              Restore settings written in file created using gammu backup com‐
1026              mand.
1027
1028              In some phones restoring calendar notes will not show error, but
1029              won’t be done, when phone doesn’t have set clock inside.
1030
1031       restoresms file [-yes]
1032
1033              WARNING:
1034                 Please note that this overwrites existing messages  in  phone
1035                 (if it supports it).
1036
1037              Restores  SMSes  from file (format like gammu backupsms uses) to
1038              selected folder in phone.
1039
1040       savefile TYPE [type options]
1041              Converts between various file formats supported by  Gammu,  fol‐
1042              lowing types are supported:
1043
1044              BOOKMARK target.url file location
1045                     Converts  backup  format  supported by Gammu to vBookmark
1046                     file.
1047
1048              CALENDAR target.vcs file location
1049                     Allows one to  convert  between  various  backup  formats
1050                     which  gammu  supports for calendar events. The file type
1051                     is guessed (for input file guess is  based  on  extension
1052                     and file content, for output solely on extension).
1053
1054              TODO target.vcs file location
1055                     Allows  one  to  convert  between  various backup formats
1056                     which gammu supports for todo events. The  file  type  is
1057                     guessed  (for  input file guess is based on extension and
1058                     file content, for output solely on extension).
1059
1060              VCARD10|VCARD21 target.vcf file SM|ME location
1061                     Allows one to  convert  between  various  backup  formats
1062                     which  gammu supports for phonebook events. The file type
1063                     is guessed (for input file guess is  based  on  extension
1064                     and file content, for output solely on extension).
1065
1066              SEE ALSO:
1067                 gammu convertbackup
1068
1069       convertbackup source.file output.file
1070              New in version 1.28.94.
1071
1072
1073              Converts backup between formats supported by Gammu. Unlike gammu
1074              savefile, this does not give you any options what to convert, it
1075              simply takes converts all what can be saved into output file.
1076
1077              SEE ALSO:
1078                 gammu savefile
1079
1080   Nokia specific commands
1081       nokiaaddfile TYPE [type options]
1082              Uploads file to phone to specific location for the type:
1083
1084              APPLICATION|GAME file [-readonly] [-overwrite] [-overwriteall]
1085                     Install  the  *.jar/*.jad  file  pair  of a midlet in the
1086                     application or game menu of the phone. You need to  spec‐
1087                     ify  filename  without  the  jar/jad suffix, both will be
1088                     added automatically.
1089
1090                     -overwrite
1091                            Delete  the  application’s  .jad  and  .jar  files
1092                            before installing, but doesn’t delete the applica‐
1093                            tion data.
1094
1095                     -overwriteall
1096                            Delete the application (same  as  -overwrite)  and
1097                            all it’s data.
1098
1099                     You  can use jadmaker to generate a .jad file from a .jar
1100                     file.
1101
1102              GALLERY|GALLERY2|CAMERA|TONES|TONES2|RECORDS|VIDEO|PLAYLIST|MEM‐
1103              ORYCARD  file  [-name  name]  [-protected] [-readonly] [-system]
1104              [-hidden] [-newtime]
1105
1106       nokiaaddplaylists
1107              Goes through phone memory and generated playlist for  all  music
1108              files found.
1109
1110              To manually manage playlists:
1111
1112                 gammu addfile a:\\predefplaylist filename.m3u
1113
1114              Will add playlist filename.m3u
1115
1116                 gammu getfilesystem
1117
1118              Will  get  list  of  all  files  (including  names of files with
1119              playlists)
1120
1121                 gammu deletefiles a:\\predefplaylist\\filename.m3u
1122
1123              Will delete playlist filename.m3u
1124
1125              Format of m3u playlist is easy (standard mp3 playlist):
1126
1127              First line is  #EXTM3U,  next  lines  contain   names  of  files
1128              (b:\file1.mp3,  b:\folder1\file2.mp3,  etc.).  File needs t have
1129              \r\n terminated lines. So just run  unix2dos  on  the  resulting
1130              file before uploading it your your phone.
1131
1132       nokiacomposer file
1133              Show,  how  to  enter RTTL ringtone in composer existing in many
1134              Nokia phones (and how should it look like).
1135
1136       nokiadebug filename [[v11-22] [,v33-44]...]
1137
1138       nokiadisplayoutput
1139
1140       nokiadisplaytest number
1141
1142       nokiagetadc
1143
1144       nokiagetoperatorname
1145              6110.c phones have place  for  name  for  one  GSM  network  (of
1146              course,  with  flashing  it’s  possible to change all names, but
1147              Gammu is not flasher ;-)). You can  get  this  name  using  this
1148              option.
1149
1150       nokiagetpbkfeatures memorytype
1151
1152       nokiagett9
1153              This  option  should  display  T9  dictionary  content from DCT4
1154              phones.
1155
1156       nokiagetvoicerecord location
1157              Get voice record from location and save to  WAV  file.  File  is
1158              coded  using  GSM  6.10  codec (available for example in win32).
1159              Name of file is like name of voice record in phone.
1160
1161              Created WAV files require GSM 6.10 codec to be played. In Win XP
1162              it’s  included  by  Microsoft.  If you deleted it by accident in
1163              this operating system, make such steps:
1164
1165              1.  Control Panel
1166
1167              2.  Add hardware
1168
1169              3.  click Next
1170
1171              4.  select “Yes. I have already connected the hardware
1172
1173              5.  select “Add a new hardware device
1174
1175              6.  select “Install the hardware that I manually select  from  a
1176                  list
1177
1178              7.  select “Sound, video and game controllers
1179
1180              8.  select “Audio codecs
1181
1182              9.  select “windows\system32” directory and file “mmdriver.inf
1183
1184              10. if  You  will  be  asked  for  file  msgsm32.acm,  it should
1185                  unpacked from Windows CD
1186
1187              11. now You can be asked if  want  to  install  unsigned  driver
1188                  (YES),  about  select  codec  configuration (select what you
1189                  want) and rebotting PC (make it)
1190
1191       nokiamakecamerashoot
1192
1193       nokianetmonitor test
1194              Takes output or set netmonitor for Nokia DCT3 phones.
1195
1196              SEE ALSO:
1197                 For more info about this option, please visit  Marcin’s  page
1198                 and read netmonitor manual there.
1199
1200              NOTE:
1201                 test  243  enables  all  tests  (after  using  command  gammu
1202                 nokianetmonitor 243 in some phones like 6210 or 9210 have  to
1203                 reboot them to see netmonitor menu)
1204
1205       nokianetmonitor36
1206              Reset counters from netmonitor test 36 in Nokia DCT3 phones.
1207
1208              SEE ALSO:
1209                 For  more  info about this option, please visit Marcin’s page
1210                 and read netmonitor manual there.
1211
1212       nokiasecuritycode
1213              Get/reset to “12345” security code
1214
1215       nokiaselftests
1216              Perform tests for Nokia DCT3 phones.
1217
1218              NOTE:
1219                 EEPROM test can show an error when your phone has  an  EEPROM
1220                 in flash (like 82xx/7110/62xx/33xx). The clock test will show
1221                 an error when the phone doesn’t have an internal battery  for
1222                 the clock (like 3xxx).
1223
1224       nokiasetlights keypad|display|torch on|off
1225
1226       nokiasetoperatorname [networkcode name]
1227
1228       nokiasetphonemenus
1229              Enable all (?) possible menus for DCT3 Nokia phones:
1230
1231              1. ALS (Alternative Line Service) option menu
1232
1233              2. vibra menu for 3210
1234
1235              3. 3315 features in 3310 5.45 and higher
1236
1237              4. two  additional  games  (React  and  Logic) for 3210 5.31 and
1238                 higher
1239
1240              5. WellMate menu for 6150
1241
1242              6. NetMonitor
1243
1244              and for DCT4:
1245
1246              1. ALS (Alternative Line Service) option menu
1247
1248              2. Bluetooth, WAP bookmarks and settings menu, … (6310i)
1249
1250              3. GPRS Always Online
1251
1252              4. and others…
1253
1254       nokiasetvibralevel level
1255              Set vibra power to “level” (given in percent)
1256
1257       nokiatuneradio
1258
1259       nokiavibratest
1260
1261   Siemens specific commands
1262       siemensnetmonact netmon_type
1263              Enables network monitor in Siemens phone. Currently known values
1264              for type are 1 for full and 2 for simple mode.
1265
1266       siemensnetmonitor test
1267
1268       siemenssatnetmon
1269
1270   Network commands
1271       getgprspoint start [stop]
1272
1273       listnetworks [country]
1274              Show names/codes of GSM networks known for Gammu
1275
1276       networkinfo
1277              Show information about network status from the phone.
1278
1279       setautonetworklogin
1280
1281   WAP settings and bookmarks commands
1282       deletewapbookmark start [stop]
1283              Delete WAP bookmarks from phone.
1284
1285              Locations are numerated from 1.
1286
1287       getchatsettings start [stop]
1288
1289       getsyncmlsettings start [stop]
1290
1291       getwapbookmark start [stop]
1292              Get WAP bookmarks from phone.
1293
1294              Locations are numerated from 1.
1295
1296       getwapsettings start [stop]
1297              Get WAP settings from phone.
1298
1299              Locations are numerated from 1.
1300
1301   MMS and MMS settings commands
1302       getallmms [-save]
1303
1304       geteachmms [-save]
1305
1306       getmmsfolders
1307
1308       getmmssettings start [stop]
1309
1310       readmmsfile file [-save]
1311
1312   FM radio commands
1313       getfmstation start [stop]
1314              Show info about FM stations in phone
1315
1316   Phone information commands
1317       battery
1318              Displays information about battery and power source.
1319
1320       getdisplaystatus
1321
1322       getsecuritystatus
1323              Show,  if  phone wait for security code (like PIN, PUK, etc.) or
1324              not
1325
1326       identify
1327              Show the most important phone data.
1328
1329       monitor [times]
1330              Retrieves phone status and writes it  continuously  to  standard
1331              output. Press Ctrl+C to interrupt this command.
1332
1333              If  no  parameter  is given, the program runs until interrupted,
1334              otherwise only given number of iterations is performed.
1335
1336              This command outputs almost all information Gammu supports:
1337
1338              · Number of  contacts,  calendar  and  todo  entries,  messages,
1339                calls, etc.
1340
1341              · Signal strength.
1342
1343              · Battery state.
1344
1345              · Currently used network.
1346
1347              · Notifications of incoming messages and calls.
1348
1349   Phone settings commands
1350       getcalendarsettings
1351              Displays  calendar  settings like first day of week or automatic
1352              deleting of old entries.
1353
1354       getprofile start [stop]
1355
1356       resetphonesettings PHONE|DEV|UIF|ALL|FACTORY
1357
1358              WARNING:
1359                 This will delete user data, be careful.
1360
1361              Reset phone settings.
1362
1363              PHONE  Clear phone settings.
1364
1365              DEV    Clear device settings.
1366
1367              ALL    Clear user settings.
1368
1369                     · removes or set logos to default
1370
1371                     · set default phonebook and other menu settings
1372
1373                     · clear T9 words,
1374
1375                     · clear call register info
1376
1377                     · set default profiles settings
1378
1379                     · clear user ringtones
1380
1381              UIF    Clear user settings and disables hidden menus.
1382
1383                     · changes like after ALL
1384
1385                     · disables netmon and PPS (all “hidden” menus)
1386
1387              FACTORY
1388                     Reset to factory defaults.
1389
1390                     · changes like after UIF
1391
1392                     · clear date/time
1393
1394   Dumps decoding commands
1395       NOTE:
1396          These commands are available only if Gammu was compiled with  debug‐
1397          ging options.
1398
1399       decodebinarydump file [phonemodel]
1400              Decodes a dump made by Gammu with LogFormat set to binary.
1401
1402       decodesniff MBUS2|IRDA file [phonemodel]
1403              Allows  one  to decode sniffs. See Discovering protocol for more
1404              details.
1405
1406   Other commands
1407       entersecuritycode PIN|PUK|PIN2|PUK2|PHONE|NETWORK code|- [newpin|-]
1408              Allow one to enter security code from PC. When code is -, it  is
1409              read from stdin.
1410
1411              In  case entering PUK, some phones require you to set new PIN as
1412              well.
1413
1414       presskeysequence mMnNpPuUdD+-123456789*0#gGrR<>[]hHcCjJfFoOmMdD@
1415              Press specified key sequence on phone keyboard
1416
1417              mM     Menu
1418
1419              nN     Names key
1420
1421              pP     Power
1422
1423              uU     Up
1424
1425              dD     Down
1426
1427              +-     +-
1428
1429              gG     Green
1430
1431              rR     Red
1432
1433              123456789*0#
1434                     numeric keyboard
1435
1436       reset SOFT|HARD
1437              Make phone reset:
1438
1439              SOFT   without asking for PIN
1440
1441              HARD   with asking for PIN
1442
1443              NOTE:
1444                 Some phones will ask for PIN even with SOFT option.
1445
1446              WARNING:
1447                 Some phones will reset user data on HARD reset.
1448
1449       setpower ON|OFF
1450              New in version 1.33.90.
1451
1452
1453              Turns off or on the phone.
1454
1455              NOTE:
1456                 This is usually required for built in modules in notebooks.
1457
1458       screenshot filename
1459              Captures phone screenshot and saves it as filename.  The  exten‐
1460              sion  is  automatically  appended to filename based on what data
1461              phone provides.
1462
1463   Batch mode commands
1464       batch [file]
1465              Starts Gammu in a batch mode. In this mode you can issue several
1466              commands  each on one line. Lines starting with # are treated as
1467              a comments.
1468
1469              By default, commands are read from standard input, but  you  can
1470              optionally specify a file from where they would be read (special
1471              case - means standard input).
1472
1473   Configuration commands
1474       searchphone [-debug]
1475              Attempts to search for a connected phone.
1476
1477              WARNING:
1478                 Please note that this can take a very long time, but in  case
1479                 you have no clue how to configure phone connection, this is a
1480                 convenient way to find working setup for Gammu.
1481
1482       install [-minimal]
1483              Installs applet  for  currently  configured  connection  to  the
1484              phone.
1485
1486              You  can  configure  search path for installation files by Data‐
1487              Path.
1488
1489              The -minimal parameter forces installation of applet only  with‐
1490              out possible support libraries, this can be useful for updates.
1491
1492   Gammu information commands
1493       checkversion [STABLE]
1494              Checks whether there is newer Gammu version available online (if
1495              Gammu has been compiled  with  CURL).  If  you  pass  additional
1496              parameter STABLE, only stable versions will be checked.
1497
1498       features
1499              Print information about compiled in features.
1500
1501       help [topic]
1502              Print help. By default general help is printed, but you can also
1503              specify a help category to get more detailed help on some topic.
1504
1505       version
1506              Print version information and license.
1507

RETURN VALUES

1509       gammu returns 0 on success.  In  case  of  failure  non  zero  code  is
1510       returned.
1511
1512       1      Out of memory or other critical error.
1513
1514       2      Invalid command line parameters.
1515
1516       3      Failed to open file specified on command line.
1517
1518       4      Program was interrupted.
1519
1520       98     Gammu library version mismatch.
1521
1522       99     Functionality has been moved. For example to gammu-smsd.
1523
1524       Errors  codes greater than 100 map to the GSM_Error values increased by
1525       100:
1526
1527       101    No error.
1528
1529       102    Error opening device. Unknown, busy or no permissions.
1530
1531       103    Error opening device, it is locked.
1532
1533       104    Error opening device, it doesn’t exist.
1534
1535       105    Error opening device, it is already opened by other application.
1536
1537       106    Error opening device, you don’t have permissions.
1538
1539       107    Error opening device. No required driver in operating system.
1540
1541       108    Error opening device. Some hardware not  connected/wrongly  con‐
1542              figured.
1543
1544       109    Error setting device DTR or RTS.
1545
1546       110    Error setting device speed. Maybe speed not supported.
1547
1548       111    Error writing to the device.
1549
1550       112    Error during reading from the device.
1551
1552       113    Can’t set parity on the device.
1553
1554       114    No response in specified timeout. Probably phone not connected.
1555
1556       115    Frame      not      requested      right     now.     See     <‐
1557              https://wammu.eu/support/bugs/> for information  how  to  report
1558              it.
1559
1560       116    Unknown       response       from       phone.       See      <‐
1561              https://wammu.eu/support/bugs/> for information  how  to  report
1562              it.
1563
1564       117    Unknown frame. See <https://wammu.eu/support/bugs/> for informa‐
1565              tion how to report it.
1566
1567       118    Unknown connection type string. Check config file.
1568
1569       119    Unknown model type string. Check config file.
1570
1571       120    Some functions not available for your system (disabled in config
1572              or not implemented).
1573
1574       121    Function not supported by phone.
1575
1576       122    Entry is empty.
1577
1578       123    Security error. Maybe no PIN?
1579
1580       124    Invalid location. Maybe too high?
1581
1582       125    Functionality  not  implemented. You are welcome to help authors
1583              with it.
1584
1585       126    Memory full.
1586
1587       127    Unknown error.
1588
1589       128    Can not open specified file.
1590
1591       129    More memory required…
1592
1593       130    Operation not allowed by phone.
1594
1595       131    No SMSC number given. Provide it manually or use the one config‐
1596              ured in phone.
1597
1598       132    You’re  inside  phone  menu  (maybe  editing?). Leave it and try
1599              again.
1600
1601       133    Phone is not connected.
1602
1603       134    Function is currently being implemented. If you  want  to  help,
1604              please contact authors.
1605
1606       135    Phone is disabled and connected to charger.
1607
1608       136    File format not supported by Gammu.
1609
1610       137    Nobody is perfect, some bug appeared in protocol implementation.
1611              Please contact authors.
1612
1613       138    Transfer was canceled by phone,  maybe  you  pressed  cancel  on
1614              phone.
1615
1616       139    Phone module need to send another answer frame.
1617
1618       140    Current connection type doesn’t support called function.
1619
1620       141    CRC error.
1621
1622       142    Invalid date or time specified.
1623
1624       143    Phone memory error, maybe it is read only.
1625
1626       144    Invalid data given to phone.
1627
1628       145    File with specified name already exists.
1629
1630       146    File with specified name doesn’t exist.
1631
1632       147    You have to give folder name and not file name.
1633
1634       148    You have to give file name and not folder name.
1635
1636       149    Can not access SIM card.
1637
1638       150    Wrong GNAPPLET version in phone. Use version from currently used
1639              Gammu.
1640
1641       151    Only part of folder has been listed.
1642
1643       152    Folder must be empty.
1644
1645       153    Data were converted.
1646
1647       154    Gammu is not configured.
1648
1649       155    Wrong folder used.
1650
1651       156    Internal phone error.
1652
1653       157    Error writing file to disk.
1654
1655       158    No such section exists.
1656
1657       159    Using default values.
1658
1659       160    Corrupted data returned by phone.
1660
1661       161    Bad feature string in configuration.
1662
1663       162    Desired functionality has been disabled on compile time.
1664
1665       163    Bluetooth configuration requires channel option.
1666
1667       164    Service is not running.
1668
1669       165    Service configuration is missing.
1670
1671       166    Command rejected because device was busy. Wait and restart.
1672
1673       167    Could not connect to the server.
1674
1675       168    Could not resolve the host name.
1676
1677       169    Failed to get SMSC number from phone.
1678
1679       170    Operation aborted.
1680
1681       171    Installation data not found, please  consult  debug  log  and/or
1682              documentation for more details.
1683
1684       172    Entry is read only.
1685

EXAMPLES

1687   Configuration
1688       To  check  it  out,  you need to have configuration file for gammu, see
1689       gammurc for more details about it.
1690
1691   Sending messages
1692       NOTE:
1693          All messages below are sent to number 123456, replace it with proper
1694          destination.
1695
1696       Send text message up to standard 160 chars:
1697
1698          echo "All your base are belong to us" | gammu sendsms TEXT 123456
1699
1700       or
1701
1702          gammu sendsms TEXT 123456 -text "All your base are belong to us"
1703
1704       Send long text message:
1705
1706          echo "All your base are belong to us" | gammu sendsms TEXT 123456 -len 400
1707
1708       or
1709
1710          gammu sendsms TEXT 123456 -len 400 -text "All your base are belong to us"
1711
1712       or
1713
1714          gammu sendsms EMS 123456 -text "All your base are belong to us"
1715
1716       Send some funky message with predefined sound and animation from 2 bit‐
1717       maps:
1718
1719          gammu sendsms EMS 123456 -text "Greetings" -defsound 1 -text "from Gammu -tone10 axelf.txt -animation 2 file1.bmp file2.bmp
1720
1721       Send protected message with ringtone:
1722
1723          gammu sendsms EMS 123456 -protected 2 -variablebitmaplong ala.bmp -toneSElong axelf.txt -toneSE ring.txt
1724
1725   Retrieving USSD replies
1726       For example for retrieving prepaid card status  or  retrieving  various
1727       network info:
1728
1729          gammu getussd '#555#'
1730
1731   Uploading files to Nokia
1732       Add  Alien  to  applications  in  your  phone  (you  need to have files
1733       Alien.JAD and Alien.JAR in current directory):
1734
1735          gammu nokiaaddfile APPLICATION Alien
1736
1737       Add file.mid to ringtones folder:
1738
1739          gammu nokiaaddfile TONES file.mid
1740
1741   Setting operator logo
1742       Set logo for network 230 03 (Vodafone CZ):
1743
1744          gammu setbitmap OPERATOR ala.bmp "230 03"
1745
1746   Converting file formats
1747       The formats conversion can done using gammu savefile or gammu  convert‐
1748       backup commands.
1749
1750       Convert single entry (at position 260) from gammu-backup to vCalendar:
1751
1752          gammu savefile CALENDAR output.vcs myCalendar.backup 260
1753
1754       Convert first phonebook entry from gammu-backup to vCard:
1755
1756          gammu savefile VCARD21 output.vcf phone.backup ME 1
1757
1758       Convert all contacts from backup to vCard:
1759
1760          gammu convertbackup phone.backup output.vcf
1761
1762   Reporting bugs
1763       There  are definitely many bugs, reporting to author is welcome. Please
1764       include some useful information when sending  bug  reports  (especially
1765       debug  logs,  operating  system, it’s version and phone information are
1766       needed).
1767
1768       To generate debug log, enable it in gammurc:
1769
1770          [gammu]
1771          YOUR CONNECTION SETTINGS
1772          logfile = /tmp/gammu.log
1773          logformat = textall
1774
1775       Alternatively you can specify logging on command line:
1776
1777          gammu -d textall -f /tmp/gammu.log ...
1778
1779       With this settings, Gammu generates /tmp/gammu.log on  each  connection
1780       to phone and stores dump of communication there. You can also find some
1781       hints for improving support for your phone in this log.
1782
1783       See <https://wammu.eu/support/bugs/> for more information on  reporting
1784       bugs.
1785
1786       Please report bugs to Gammu bug tracker.
1787

AUTHOR

1789       Michal Čihař <michal@cihar.com>
1790
1792       2009-2015, Michal Čihař <michal@cihar.com>
1793
1794
1795
1796
17971.39.0                           Jan 05, 2018                         GAMMU(1)
Impressum