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

RETURN VALUES

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

EXAMPLES

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

AUTHOR

1793       Michal Čihař <michal@cihar.com>
1794
1796       2009-2015, Michal Čihař <michal@cihar.com>
1797
1798
1799
1800
18011.42.0                           Oct 03, 2020                         GAMMU(1)
Impressum