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

NAME

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

SYNOPSIS

10       Usage: gammu [parameters] <command> [options]
11
12
13

DESCRIPTION

15       This  program  is a tool for mobile phones. Many vendors and phones are
16       supported, for actual listing see <http://cihar.com/gammu/phonedb/>.
17
18
19

OPTIONS

21       Parameters before command configure gammu behaviour:
22       -c / --config <filename> ... name of configuration file
23       -s / --section <confign> ... section of config file to use, eg. 42
24       -d / --debug <level> ... debug level (see gammurc(5) for possible  val‐
25       ues)
26       -f / --debug-file <filename> ... file for logging debug messages
27
28
29
30   Commands
31       Commands can be specified with or without leading --.
32
33
34
35   Calls
36       answercall [ID]
37              Answer incoming call.
38
39
40       cancelcall [ID]
41              Cancel incoming call
42
43
44       canceldiverts
45              Cancel all existing call diverts.
46
47
48       conferencecall ID
49              Initiates a conference call.
50
51
52       dialvoice number [show|hide]
53              Make voice call from SIM card line set in phone.
54
55              show|hide  -  optional  parameter whether to disable call number
56              indication.
57
58
59       divert  get|set  all|busy|noans|outofreach  all|voice|fax|data  [number
60       timeout]
61              Manage or display call diverts.
62
63              get|set - whether to get divert information or to set it.
64
65              all|busy|noans|outofreach - condition when apply divert
66
67              all|voice|fax|data - call type when apply divert
68
69              number - number where to divert
70
71              timeout - timeout when the diversion will happen
72
73
74
75       getspeeddial start [stop]
76              Gets speed dial choices.
77
78
79       getussd code
80              Retrieves  USSD  information  - dials a service number and reads
81              response.
82
83
84       holdcall ID
85              Holds call.
86
87
88       maketerminatedcall number length [show|hide]
89              Make voice call from SIM card line set in phone  which  will  be
90              terminated after length seconds.
91
92
93       monitor [times]
94              Get  phone  status  and  writes continuously to standard output.
95              Press Ctrl+C to break this state.
96
97
98       senddtmf sequence
99              Plays DTMF sequence. In some phones available only during calls
100
101
102       splitcall ID
103              Splits call.
104
105
106       switchcall [ID]
107              Switches call.
108
109
110       transfercall [ID]
111              Transfers call.
112
113
114       unholdcall ID
115              Unholds call.
116
117
118
119   SMS and EMS
120       Sending messages might look a bit complicated on first attempt to  use.
121       But  be  patient,  the  command line has been written in order to allow
122       almost every usage. See EXAMPLE section for some hints on usage.
123
124       There is also an option to use gammu-smsd(1) when you want to  send  or
125       receive more messages and process them automatically.
126
127
128       Common parameters for sendsms and savesms
129
130              -smscset  number  -  SMSC will be taken from set number. Default
131              set: 1
132
133              -smscnumber number - SMSC number
134
135              -reply - reply SMSC is set
136
137              -maxnum number - Limit maximal number of messages which will  be
138              created.  If  there are more messages, Gammu will terminate with
139              failure.
140
141              -folder number - save to specified folder.
142
143              Folders are numerated from 1.
144
145              The most often folder 1 = "Inbox", 2 = "Outbox",etc. Use getsms‐
146              folders to get folder list.
147
148              -unread  -  makes message unread. In some phones (like 6210) you
149              won't see unread sms envelope after saving  such  sms.  In  some
150              phones  with internal SMS memory (like 6210) after using it with
151              folder 1 SIM SMS memory will be used
152
153              -read - makes message read. In some  phones  with  internal  SMS
154              memory  (like  6210) after using it with folder 1 SIM SMS memory
155              will be used
156
157              -unsent - makes message unsent
158
159              -sent - makes message sent
160
161              -sender number - set sender number
162
163              -smsname name - set message name
164
165              -sender number - set sender number (default: "Gammu")
166
167              -report - request delivery report for message
168
169              -validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX - sets how long will be
170              the  message valid (SMSC will the discard the message after this
171              time if it could not deliver it).
172
173              -save - will also save message which is being sent
174
175
176       addsms folder file [-yes]
177              Adds SMSes from file (format like backupsms  uses)  to  selected
178              folder in phone.
179
180       addsmsfolder name
181
182
183       backupsms file [-yes|-all]
184              Stores all SMSes from phone to file.
185
186              Use -yes for answering yes to all questions (backup all messages
187              and delete them from phone), or -all to just backup all  folders
188              while keeping messages in phone.
189
190
191       deleteallsms folder
192              Delete all SMS from specified SMS folder.
193
194
195       deletesms folder start [stop]
196              Delete SMS from phone. See description for getsms for info about
197              sms folders naming convention.
198
199              Locations are numerated from 1.
200
201
202       displaysms ... (options like in sendsms)
203
204              Displays PDU data of  encoded  SMS  messages.  It  accepts  same
205              parameters and behaves same like sendsms.
206
207
208       getallsms -pbk
209              Get  all  SMS  from phone. In some phones you will have also SMS
210              templates and info about locations used to save Picture  Images.
211              With each sms you will see location. If you want to get such sms
212              from phone alone, use gammu getsms 0 location
213
214
215       geteachsms -pbk
216              Similiary to getallsms. Difference is, that links  all  contace‐
217              nated sms
218
219
220       getsms folder start [stop]
221              Get SMS.
222
223              Locations are numerated from 1.
224
225              When  give  folder  0,  sms is given from "flat" memory (all sms
226              from all folders have unique numbers). It's  sometimes  emulated
227              by Gammu. You can use it with all phones.
228
229              When  give  folder  1, 2, etc. sms are taken from Inbox, Outbox,
230              etc.  and each sms has unique number  in  his  folder.  Name  of
231              folders  can  depend  on  your  phone (the most often 1="Inbox",
232              2="Outbox", etc.).  This method is not supported by  all  phones
233              (for  example, not supported by Nokia 3310, 5110, 6110). If work
234              with your phone, use getsmsfolders to get folders list.
235
236
237       getsmsc [start [stop]]
238              Get SMSC settings from SIM card.
239
240              Locations are numerated from 1.
241
242
243       getsmsfolders
244              Get names for SMS folders in phone
245
246
247       nokiagett9
248
249
250       restoresms file [-yes]
251              Restores  SMSes  from  file  (format  like  backupsms  uses)  to
252              selected  folder  in  phone.  Please  note  that this overwrites
253              existing messages in phone (if it supports it).
254
255       savesms ANIMATION frames file1 file2... [-folder id] [-unread]  [-read]
256       [-unsent]  [-sent]  [-sender  number] [-smsname name] [-smscset number]
257       [-smscnumber number] [-reply] [-maxsms num]
258              Save an animation as a SMS. You need to give  number  of  frames
259              and  picture  for each frame. Each picture can be in any picture
260              format which Gammu supports (B/W bmp, gif, wbmp, nol, nlm...).
261
262
263              For description of shared parameters see Common  parameters  for
264              sendsms and savesms.
265
266
267
268       savesms BOOKMARK file location [-folder id] [-unread] [-read] [-unsent]
269       [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
270       number] [-reply] [-maxsms num]
271              Read  WAP  bookmark from file created by backup option and saves
272              in Nokia format as SMS
273
274
275              For description of shared parameters see Common  parameters  for
276              sendsms and savesms.
277
278
279
280       savesms CALENDAR file location [-folder id] [-unread] [-read] [-unsent]
281       [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
282       number] [-reply] [-maxsms num]
283              Read  calendar note from file created by backup option and saves
284              in VCALENDAR 1.0 format as SMS.
285
286
287              For description of shared parameters see Common  parameters  for
288              sendsms and savesms.
289
290
291
292       savesms  CALLER  file  [-folder id] [-unread] [-read] [-unsent] [-sent]
293       [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
294       [-reply] [-maxsms num]
295              Save caller logo as sms (Nokia format - size 72x14).
296
297
298              For  description  of shared parameters see Common parameters for
299              sendsms and savesms.
300
301
302
303       savesms EMS [-folder id] [-unread] [-read] [-unsent]  [-sent]  [-sender
304       number] [-smsname name] [-smscset number] [-smscnumber number] [-reply]
305       [-maxsms num] [-unicode]  [-16bit]  [-format  lcrasbiut]  [-text  text]
306       [-unicodefiletext  file]  [-defsound  ID]  [-defanimation  ID] [-tone10
307       file] [-tone10long file] [-tone12  file]  [-tone12long  file]  [-toneSE
308       file]  [-toneSElong  file]  [-fixedbitmap  file] [-variablebitmap file]
309       [-variablebitmaplong file] [-animation frames  file1  ...]  [-protected
310       number]
311
312              Saves  EMS  sequence.  All  parameters after -unread (like -def‐
313              sound) can be used few times.
314
315              -text - adds text
316
317              -unicodefiletext - adds text from Unicode file
318
319              -defanimation - adds default  animation  with  ID  specified  by
320              user.ID for different phones are different.
321
322              -animation - adds "frames" frames read from file1, file2, etc.
323
324              -defsound - adds default sound with ID specified by user. ID for
325              different phones are different.
326
327              -tone10 - adds IMelody version 1.0 read from RTTL or other  com‐
328              patible file
329
330              -tone10long  -  IMelody version 1.0 saved in one of few SMS with
331              UPI. Phones compatible with UPI (like SonyEricsson phones)  will
332              read such ringtone as one
333
334              -tone12  - adds IMelody version 1.2 read from RTTL or other com‐
335              patible file
336
337              -tone12long - IMelody version 1.2 saved in one of few  SMS  with
338              UPI.  Phones compatible with UPI (like SonyEricsson phones) will
339              read such ringtone as one
340
341              -toneSE - adds IMelody in "short" form supported by SonyEricsson
342              phones
343
344              -variablebitmap - bitmap in any size saved in one SMS
345
346              -variablebitmaplong  -  bitmap with maximal size 96x128 saved in
347              one or few sms
348
349              -fixedbitmap  - bitmap 16x16 or 32x32
350
351              -protected - all ringtones  and  bitmaps  after  this  parameter
352              (excluding  default ringtones and logos) will be "protected" (in
353              phones compatible with ODI like SonyEricsson products  it  won't
354              be possible to forward them from phone menu)
355
356              Example:  gammu  savesms EMS -text "Greetings" -defsound 1 -text
357              "from Gammu" -tone10 axelf.txt -animation 2 file1.bmp file2.bmp
358
359              will create EMS sequence with text "Greetings" and default sound
360              1  and text "from Gammu" and ringtone axelf.txt and 2 frame ani‐
361              mation  read  from  (1'st  frame)  file1.bmp  and  (2'nd  frame)
362              file2.bmp
363
364              Example:  gammu  savesms  EMS  -protected  2 -variablebitmaplong
365              ala.bmp -toneSElong axelf.txt -toneSE ring.txt
366
367              ala.bmp and axelf.txt will be "protected"
368
369
370              For description of shared parameters see Common  parameters  for
371              sendsms and savesms.
372
373
374
375       savesms  MMSINDICATOR  URL  Title Sender [-folder id] [-unread] [-read]
376       [-unsent] [-sent] [-sender number] [-smsname  name]  [-smscset  number]
377       [-smscnumber number] [-reply] [-maxsms num]
378
379              Saves  a  message  with MMS indication. The recipient phone will
380              then download MMS from given URL and display it.
381
382              Please note that you should provide valid smil data on that URL.
383
384
385              For description of shared parameters see Common  parameters  for
386              sendsms and savesms.
387
388
389
390       savesms  MMSSETTINGS  file  location   [-folder  id]  [-unread] [-read]
391       [-unsent] [-sent] [-sender number] [-smsname  name]  [-smscset  number]
392       [-smscnumber number] [-reply] [-maxsms num]
393              Saves  a  message with MMS configuration. The configuration will
394              be read from Gammu backup file from given location.
395
396              For description of shared parameters see Common  parameters  for
397              sendsms and savesms.
398
399
400
401       savesms  OPERATOR file [-folder id] [-unread] [-read] [-unsent] [-sent]
402       [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
403       [-reply] [-maxsms num] [-netcode netcode] [-biglogo]
404              Save  operator  logo  as sms (Nokia format - size 72x14 or 78x21
405              after using -biglogo).
406
407
408              For description of shared parameters see Common  parameters  for
409              sendsms and savesms.
410
411
412
413       savesms  PICTURE  file [-folder id] [-unread] [-read] [-unsent] [-sent]
414       [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
415       [-reply] [-maxsms num] [-text text] [-unicode] [-alcatelbmmi]
416              Save Picture Image as sms (Nokia format - size 72x28).
417
418
419              For  description  of shared parameters see Common parameters for
420              sendsms and savesms.
421
422
423
424       savesms  PROFILE  [-folder  id]  [-unread]  [-read]  [-unsent]  [-sent]
425       [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
426       [-reply] [-maxsms num] [-name name] [-bitmap bitmap]  [-ringtone  ring‐
427       tone]
428              Read  ringtone (RTTL) format and bitmap (Picture Image size) and
429              name and save as Nokia profile.
430
431
432              For description of shared parameters see Common  parameters  for
433              sendsms and savesms.
434
435
436
437       savesms  RINGTONE file [-folder id] [-unread] [-read] [-unsent] [-sent]
438       [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
439       [-reply] [-maxsms num] [-long] [-scale]
440              Read RTTL ringtone from file and save as SMS into SIM/phone mem‐
441              ory. Ringtone is saved in Nokia format.
442
443              -long - ringtone is saved using Profile style. It can be  longer
444              (and  saved  in  2  SMS), but decoded only by newer phones (like
445              33xx)
446
447              -scale - ringtone will have Scale info for each  note.  It  will
448              allow to edit it correctly later in phone composer (for example,
449              in 33xx)
450
451
452              For description of shared parameters see Common  parameters  for
453              sendsms and savesms.
454
455
456
457       savesms  SMSTEMPLATE  [-folder  id] [-unread] [-read] [-unsent] [-sent]
458       [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
459       [-reply]  [-maxsms num] [-unicode] [-text text] [-unicodefiletext file]
460       [-defsound ID] [-defanimation ID]  [-tone10  file]  [-tone10long  file]
461       [-tone12  file]  [-tone12long  file]  [-toneSE file] [-toneSElong file]
462       [-variablebitmap file] [-variablebitmaplong  file]  [-animation  frames
463       file1 ...]
464              Saves a SMS template (for Alcatel phones).
465
466
467              For  description  of shared parameters see Common parameters for
468              sendsms and savesms.
469
470
471
472       savesms TEXT [-folder id] [-unread] [-read] [-unsent] [-sent]  [-sender
473       number] [-smsname name] [-smscset number] [-smscnumber number] [-reply]
474       [-maxsms num] [-inputunicode] [-16bit] [-flash]  [-len  len]  [-autolen
475       len]  [-unicode] [-enablevoice] [-disablevoice] [-enablefax] [-disable‐
476       fax] [-enableemail] [-disableemail]  [-voidsms]  [-replacemessages  ID]
477       [-replacefile file] [-text msgtext] [-textutf8 msgtext]
478              Take  text  from  stdin  (or commandline if -text specified) and
479              save as text SMS into SIM/phone memory.
480
481              -flash - Class 0 SMS
482
483              -len len - specify, how many chars will be read. When  use  this
484              option and text will be longer than 1 SMS, will be splitted into
485              more linked SMS
486
487              -autolen len - specify, how many chars will be  read.  When  use
488              this option and text will be longer than 1 SMS, will be splitted
489              into more linked SMS.Coding type (SMS default  alphabet/Unicode)
490              is set according to input text
491
492              -enablevoice  |  -disablevoice  |  -enablefax   | -disablefax  |
493              -enableemail  | -disableemail  - sms will set  such  indicators.
494              Text will be cut to 1 sms.
495
496              -voidsms  -  many  phones  after receiving it won't display any‐
497              thing, only beep, vibrate or turn on light. Text will be cut  to
498              1 sms.
499
500              -unicode - SMS will be saved in Unicode format
501
502              -inputunicode - input text is in Unicode.
503
504              -text - get text from command line instead of stdin.
505
506              -textutf8  -  get  text  in  UTF-8  from command line instead of
507              stdin.
508
509              TIP: You can create Unicode file using WordPad in Windows  (dur‐
510              ing  saving  select "Unicode Text Document" format). In Unix can
511              use for example YUdit.
512
513              -replacemessages ID - ID can be 1..7. When you will  use  option
514              and send more single SMS to one recipient with the same ID, each
515              another SMS will replace each previous with the same ID
516
517              -replacefile file  - when you want, you can make  file  in  such
518              format:    src_unicode_char1,    dest_unicode_char1,    src_uni‐
519              code_char2, dest_unicode_char2 (everything in one  line).  After
520              reading  text  for SMS from stdin there will be made translation
521              and each src char will be converted to dest char. In docs  there
522              is  example  file (replace.txt), which will change all "a" chars
523              to "1"
524
525              TIP: when use ~ char in sms text and  -unicode  option  (Unicode
526              coding  required),  text  of sms after ~ char will blink in some
527              phones (like N33xx)
528
529              Example: echo some_text | gammu savesms TEXT
530
531
532              For description of shared parameters see Common  parameters  for
533              sendsms and savesms.
534
535
536
537       savesms  TODO  file  location  [-folder id] [-unread] [-read] [-unsent]
538       [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
539       number] [-reply] [-maxsms num]
540              Saves a message with a todo entry. The content will be read from
541              any backup format which Gammu supports and from given location.
542
543              For description of shared parameters see Common  parameters  for
544              sendsms and savesms.
545
546
547
548       savesms  VCARD10|VCARD21  file  SM|ME  location  [-nokia]  [-folder id]
549       [-unread] [-read] [-unsent] [-sent] [-sender  number]  [-smsname  name]
550       [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
551              Read  phonebook  entry  from  file  created by backup option and
552              saves in VCARD 1.0 (only name and default number) or  VCARD  2.1
553              (all  entry  details  with all numbers, text and name) format as
554              SMS
555
556
557              For description of shared parameters see Common  parameters  for
558              sendsms and savesms.
559
560
561
562       savesms WAPINDICATOR URL Title [-folder id] [-unread] [-read] [-unsent]
563       [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
564       number] [-reply] [-maxsms num]
565              Saves a SMS with a WAP indication for given URL and title.
566
567
568              For  description  of shared parameters see Common parameters for
569              sendsms and savesms.
570
571
572
573       savesms WAPSETTINGS file  location  DATA|GPRS  [-folder  id]  [-unread]
574       [-read]  [-unsent]  [-sent]  [-sender number] [-smsname name] [-smscset
575       number] [-smscnumber number] [-reply] [-maxsms num]
576              Read WAP settings from file created by backup option  and  saves
577              in Nokia format as SMS
578
579
580              For  description  of shared parameters see Common parameters for
581              sendsms and savesms.
582
583
584
585       sendsms ANIMATION destination frames file1 file2... [-report]  [-valid‐
586       ity  HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset
587       number] [-smscnumber number] [-reply] [-maxsms num]
588              Sends a message, for description of message specific  parameters
589              see savesms ANIMATION.
590
591
592
593              For  description  of shared parameters see Common parameters for
594              sendsms and savesms.
595
596
597
598       sendsms  BOOKMARK  destination  file  location   [-report]   [-validity
599       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
600       ber] [-smscnumber number] [-reply] [-maxsms num]
601              Sends a message, for description of message specific  parameters
602              see savesms BOOKMARK.
603
604
605
606              For  description  of shared parameters see Common parameters for
607              sendsms and savesms.
608
609
610
611       sendsms  CALENDAR  destination  file  location   [-report]   [-validity
612       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
613       ber] [-smscnumber number] [-reply] [-maxsms num]
614              Sends a message, for description of message specific  parameters
615              see savesms CALENDAR.
616
617
618
619              For  description  of shared parameters see Common parameters for
620              sendsms and savesms.
621
622
623
624       sendsms    CALLER     destination     file     [-report]     [-validity
625       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
626       ber] [-smscnumber number] [-reply] [-maxsms num]
627              Sends a message, for description of message specific  parameters
628              see savesms CALLER.
629
630
631
632              For  description  of shared parameters see Common parameters for
633              sendsms and savesms.
634
635
636
637       sendsms       EMS        destination        [-report]        [-validity
638       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
639       ber] [-smscnumber number] [-reply] [-maxsms  num]  [-unicode]  [-16bit]
640       [-format lcrasbiut] [-text text] [-unicodefiletext file] [-defsound ID]
641       [-defanimation ID] [-tone10 file]  [-tone10long  file]  [-tone12  file]
642       [-tone12long  file]  [-toneSE  file]  [-toneSElong  file] [-fixedbitmap
643       file] [-variablebitmap  file]  [-variablebitmaplong  file]  [-animation
644       frames file1 ...] [-protected number]
645              Sends  a message, for description of message specific parameters
646              see savesms EMS.
647
648
649
650              For description of shared parameters see Common  parameters  for
651              sendsms and savesms.
652
653
654
655       sendsms  MMSINDICATOR destination URL Title Sender [-report] [-validity
656       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
657       ber] [-smscnumber number] [-reply] [-maxsms num]
658              Sends  a message, for description of message specific parameters
659              see savesms MMSINDICATOR.
660
661
662
663              For description of shared parameters see Common  parameters  for
664              sendsms and savesms.
665
666
667
668       sendsms  MMSSETTINGS  destination  file  location  [-report] [-validity
669       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
670       ber] [-smscnumber number] [-reply] [-maxsms num]
671              Sends  a message, for description of message specific parameters
672              see savesms MMSSETTINGS.
673
674
675
676              For description of shared parameters see Common  parameters  for
677              sendsms and savesms.
678
679
680
681       sendsms     OPERATOR     destination    file    [-report]    [-validity
682       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
683       ber]  [-smscnumber  number]  [-reply]  [-maxsms num] [-netcode netcode]
684       [-biglogo]
685              Sends a message, for description of message specific  parameters
686              see savesms OPERATOR.
687
688
689
690              For  description  of shared parameters see Common parameters for
691              sendsms and savesms.
692
693
694
695       sendsms    PICTURE    destination     file     [-report]     [-validity
696       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
697       ber] [-smscnumber number] [-reply] [-maxsms num]  [-text  text]  [-uni‐
698       code] [-alcatelbmmi]
699              Sends  a message, for description of message specific parameters
700              see savesms PICTURE.
701
702
703
704              For description of shared parameters see Common  parameters  for
705              sendsms and savesms.
706
707
708
709       sendsms       PROFILE       destination       [-report]      [-validity
710       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
711       ber]  [-smscnumber number] [-reply] [-maxsms num] [-name name] [-bitmap
712       bitmap] [-ringtone ringtone]
713              Sends a message, for description of message specific  parameters
714              see savesms PROFILE.
715
716
717
718              For  description  of shared parameters see Common parameters for
719              sendsms and savesms.
720
721
722
723       sendsms    RINGTONE    destination    file     [-report]     [-validity
724       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
725       ber] [-smscnumber number] [-reply] [-maxsms num] [-long] [-scale]
726              Sends a message, for description of message specific  parameters
727              see savesms RINGTONE.
728
729
730
731              For  description  of shared parameters see Common parameters for
732              sendsms and savesms.
733
734
735
736       sendsms     SMSTEMPLATE      destination      [-report]      [-validity
737       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
738       ber] [-smscnumber number]  [-reply]  [-maxsms  num]  [-unicode]  [-text
739       text]   [-unicodefiletext   file]  [-defsound  ID]  [-defanimation  ID]
740       [-tone10 file] [-tone10long file]  [-tone12  file]  [-tone12long  file]
741       [-toneSE   file]  [-toneSElong  file]  [-variablebitmap  file]  [-vari‐
742       ablebitmaplong file] [-animation frames file1 ...]
743              Sends a message, for description of message specific  parameters
744              see savesms SMSTEMPLATE.
745
746
747
748              For  description  of shared parameters see Common parameters for
749              sendsms and savesms.
750
751
752
753       sendsms       TEXT       destination        [-report]        [-validity
754       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
755       ber]  [-smscnumber  number]  [-reply]  [-maxsms  num]   [-inputunicode]
756       [-16bit]  [-flash]  [-len len] [-autolen len] [-unicode] [-enablevoice]
757       [-disablevoice]  [-enablefax]   [-disablefax]   [-enableemail]   [-dis‐
758       ableemail]  [-voidsms] [-replacemessages ID] [-replacefile file] [-text
759       msgtext] [-textutf8 msgtext]
760              Sends a message, for description of message specific  parameters
761              see savesms TEXT.
762
763
764
765              For  description  of shared parameters see Common parameters for
766              sendsms and savesms.
767
768
769
770       sendsms   TODO   destination   file   location   [-report]   [-validity
771       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
772       ber] [-smscnumber number] [-reply] [-maxsms num]
773              Sends a message, for description of message specific  parameters
774              see savesms TODO.
775
776
777
778              For  description  of shared parameters see Common parameters for
779              sendsms and savesms.
780
781
782
783       sendsms  VCARD10|VCARD21  destination  file  SM|ME  location   [-nokia]
784       [-report]  [-validity  HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save [-folder
785       number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
786              Sends a message, for description of message specific  parameters
787              see savesms VCARD10|VCARD21.
788
789
790
791              For  description  of shared parameters see Common parameters for
792              sendsms and savesms.
793
794
795
796       sendsms  WAPINDICATOR  destination  URL  Title   [-report]   [-validity
797       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
798       ber] [-smscnumber number] [-reply] [-maxsms num]
799              Sends a message, for description of message specific  parameters
800              see savesms WAPINDICATOR.
801
802
803
804              For  description  of shared parameters see Common parameters for
805              sendsms and savesms.
806
807
808
809       sendsms  WAPSETTINGS  destination  file  location  DATA|GPRS  [-report]
810       [-validity  HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]
811       [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
812              Sends a message, for description of message specific  parameters
813              see savesms WAPSETTINGS.
814
815
816
817              For  description  of shared parameters see Common parameters for
818              sendsms and savesms.
819
820
821
822       setsmsc location number
823              Set SMSC settings on SIM card. This keeps all SMSC configuration
824              intact, it just changes the SMSC number.
825
826              Locations are numerated from 1.
827
828
829
830   Memory (phonebooks and calls)
831       addcategory TODO|PHONEBOOK text
832
833
834       addnew file [-yes]
835              Adds  data  written  in  file  created  using backup option. All
836              things backup'ed by backup can be restored (when made backup  to
837              Gammu text file).
838
839              Please  note  that this adds all content of backup file to phone
840              and does not care about current data in the phone (no duplicates
841              are detected).
842
843
844       backup file [-yes]
845              Backup  your  phone to file. It's possible to backup (depends on
846              phone and backup format):
847
848              * phonebook from SIM and phone memory
849              * calendar notes
850              * SMSC settings
851              * operator logo
852              * startup (static) logo or startup text
853              * WAP bookmarks
854              * WAP settings
855              * caller logos and groups
856              * user ringtones
857
858              There are various backup formats supported and the backup format
859              is guessed based on file extension:
860
861              *  .lmb  -  Nokia  backup,  supports  contacts, caller logos and
862              startup logo.
863              * .vcs - vCalendar, supports calendar and todo.
864              * .vcf - vCard, supports contacts.
865              * .ldif - LDAP import, supports contacts.
866              * .ics - iCalendar, supports calendar and todo.
867              * Any other extension is Gammu backup file and it  supports  all
868              data mentioned above.
869
870              See  EXAMPLE section for some hints on manipulating Gammu backup
871              format.
872
873
874
875       clearall
876              Deletes all private data from the phone.
877
878
879       deleteallmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL
880              Deletes all entries from specified memory type.
881
882       deletememory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL start [stop]
883              Deletes entries in specified range from specified memory type.
884
885       getallcategory TODO|PHONEBOOK
886
887
888       getallmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL
889              Get all memory locations from phone. For memory types  see  get‐
890              memory.
891
892       getcategory TODO|PHONEBOOK start [stop]
893
894
895       getmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL start [stop [-nonempty]]
896              Get memory location from phone.
897
898              Locations are numerated from 1.
899
900              DC = Dialled calls
901              MC = Missed calls
902              RC = Received calls
903              ON = Own numbers
904              VM = voice mailbox
905              SM = SIM phonebook
906              ME = phone internal phonebook
907              FD = fixed dialling
908              SL = sent SMS log
909
910
911       getspeeddial start [stop]
912              Gets speed dial choices.
913
914
915       listmemorycategory text|number
916
917
918       nokiagetpbkfeatures memorytype
919
920
921       restore file [-yes]
922              Restore settings written in file created using backup option.
923
924              Please note that restoring deletes all current content in phone.
925              If you want only to add entries to phone, use addnew.
926
927              In some phones restoring calendar notes will not show error, but
928              won't be done, when phone doesn't have set clock inside.
929
930
931       savefile VCARD10|VCARD21 target.vcf file SM|ME location
932              Allows  to  convert  between  various backup formats which gammu
933              supports for phonebook events. The file  type  is  guessed  (for
934              input  file  guess  is  based on extension and file content, for
935              output solely on extension).
936
937              For example if you want  to  convert  single  entry  from  gammu
938              native backup to vCard, you need following command:
939
940                  gammu savefile CALENDAR output.vcf myPhonebook.backup ME 42
941
942
943       savesms  VCARD10|VCARD21  file  SM|ME  location  [-nokia]  [-folder id]
944       [-unread] [-read] [-unsent] [-sent] [-sender  number]  [-smsname  name]
945       [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
946              Read  phonebook  entry  from  file  created by backup option and
947              saves in VCARD 1.0 (only name and default number) or  VCARD  2.1
948              (all  entry  details  with all numbers, text and name) format as
949              SMS
950
951
952              For description of shared parameters see Common  parameters  for
953              sendsms and savesms.
954
955
956
957       searchmemory text
958              Scans all memory entries for given text. It performs case insen‐
959              sitive substring lookup. You can interrupt searching by pressing
960              Ctrl+C.
961
962       sendsms   VCARD10|VCARD21  destination  file  SM|ME  location  [-nokia]
963       [-report] [-validity  HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder
964       number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
965              Sends  a message, for description of message specific parameters
966              see savesms VCARD10|VCARD21.
967
968
969
970              For description of shared parameters see Common  parameters  for
971              sendsms and savesms.
972
973
974
975
976   Filesystem
977       Gammu  allows  to access phones using native protocol (Nokias) or OBEX.
978       Your phone can also support usb storage, which is handled on the  oper‐
979       ating system level and Gammu does not use that.
980
981
982       addfile folderID name [-type JAR|BMP|PNG|GIF|JPG|MIDI|WBMP|AMR|3GP|NRT]
983       [-readonly] [-protected] [-system] [-hidden] [-newtime]
984              Add file with specified name to folder with specified folder ID.
985
986              -type - file type was required for filesystem 1 in Nokia  phones
987              (current filesystem 2 doesn't need this)
988
989              -readonly,  -protected, -system, -hidden - you can set readonly,
990              protected (file can't be for example forwarded from phone menu),
991              system  and  hidden  (file  is  hidden  from  phone  menu)  file
992              attributes
993
994              -newtime - after using it date/time of file modification will be
995              set to moment of uploading
996
997
998
999       addfolder parentfolderID name
1000              Create  a  folder  in phone with specified name in a folder with
1001              specified folder ID.
1002
1003       deletefiles fileID
1004              Delete files with given IDs.
1005
1006       deletefolder name
1007              Delete folder with given ID.
1008
1009       getfilefolder ID1, ID2, ...
1010              Retrieve files or all files from folder with given  IDs  from  a
1011              phone filesytem.
1012
1013       getfiles ID1, ID2, ...
1014              Retrieve files with given IDs from a phone filesytem.
1015
1016       getfilesystem [-flatall|-flat]
1017              Display  info about all folders and files in phone memory/memory
1018              card. By default there is tree displayed, you can change it:
1019
1020              -flatall there are displayed full file/folder  details  like  ID
1021              (first parameter in line)
1022
1023              -flat
1024
1025              Please  note,  that  in some phones (like N6230) content of some
1026              folders (with more files) can be cut (only part of files will be
1027              displayed) for example on infrared connection. This is not Gammu
1028              issue, but phone firmware problem.
1029
1030
1031       getfilesystemstatus
1032              Display info filesystem status - number of bytes available, used
1033              or used by some specific content.
1034
1035       getfolderlisting folderID
1036
1037              Display  files and folders available in folder with given folder
1038              ID. You can get ID's using getfilesystem -flatall.
1039
1040              Please note, that in some phones (like N6230)  content  of  some
1041              folders (with more files) can be cut (only part of files will be
1042              displayed) for example on infrared connection. This is not Gammu
1043              issue, but phone firmware problem.
1044
1045
1046       getrootfolders
1047
1048              Display info about drives available in phone/memory card.
1049
1050
1051       nokiaaddfile                                      Gallery|Gallery2|Cam‐
1052       era|Tones|Tones2|Records|Video|Playlist|MemoryCard  file  [-name  name]
1053       [-protected] [-readonly] [-system] [-hidden] [-newtime]
1054              Install the *.jar/*.jad file pair of a midlet in the application
1055              or game menu of the phone. You have to give the name without the
1056              jar/jad  suffix,  otherwise  you will get the slightly confusing
1057              error message Can't open specified file. Read only ?
1058
1059              The option -overwrite deletes the application's  .jad  and  .jar
1060              files bevor installing, but doesn't delete the application data.
1061              Option -overwriteall will  also  delete  all  data.  Both  these
1062              options work only for Application or Game upload.
1063
1064              Example:   gammu   nokiaaddfile   Application  Alien  will  read
1065              Alien.JAD and Alien.JAR and add to Applications
1066
1067              Example: gammu nokiaaddfile Tones file.mid  will  read  file.mid
1068              and add to Tones folder
1069
1070              You  can  use  jadmaker(1)  to  generate a .jad file from a .jar
1071              file.
1072
1073
1074       nokiaaddplaylists
1075
1076
1077       sendfile name
1078              Sends file to a phone. It's up to phone to decide where to store
1079              this  file and how to handle it (for example when you send vCard
1080              or vCalendar, most of phones will offer you to import it.
1081
1082
1083       setfileattrib folderID [-system] [-readonly] [-hidden] [-protected]
1084
1085
1086
1087   Logo and pictures
1088       copybitmap inputfile [outputfile [OPERATOR|PICTURE|STARTUP|CALLER]]
1089              Allow to convert logos files to another. When give  ONLY  input‐
1090              file,  output  will  be  written to stdout using ASCII art. When
1091              give output file and format, in some  file  formats  (like  NLM)
1092              will be set indicator informing about logo type to given.
1093
1094
1095       getbitmap DEALER
1096              In  some models it's possible to save dealer welcome note - text
1097              displayed during enabling phone,  which  can't  be  edited  from
1098              phone menu.  Here you can get it.
1099
1100
1101       getbitmap CALLER location [file]
1102              Get caller group logo from phone. Locations 1-5.
1103
1104
1105       getbitmap OPERATOR [file]
1106              Get  operator  logo (picture displayed instead of operator name)
1107              from phone.
1108
1109
1110       getbitmap PICTURE location [file]
1111              Get Picture Image from phone.
1112
1113
1114       getbitmap STARTUP [file]
1115              Get static startup logo from phone. Allow to save it in file.
1116
1117
1118       savesms ANIMATION frames file1 file2... [-folder id] [-unread]  [-read]
1119       [-unsent]  [-sent]  [-sender  number] [-smsname name] [-smscset number]
1120       [-smscnumber number] [-reply] [-maxsms num]
1121              Save an animation as a SMS. You need to give  number  of  frames
1122              and  picture  for each frame. Each picture can be in any picture
1123              format which Gammu supports (B/W bmp, gif, wbmp, nol, nlm...).
1124
1125
1126              For description of shared parameters see Common  parameters  for
1127              sendsms and savesms.
1128
1129
1130
1131       savesms  CALLER  file  [-folder id] [-unread] [-read] [-unsent] [-sent]
1132       [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
1133       [-reply] [-maxsms num]
1134              Save caller logo as sms (Nokia format - size 72x14).
1135
1136
1137              For  description  of shared parameters see Common parameters for
1138              sendsms and savesms.
1139
1140
1141
1142       savesms OPERATOR file [-folder id] [-unread] [-read] [-unsent]  [-sent]
1143       [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
1144       [-reply] [-maxsms num] [-netcode netcode] [-biglogo]
1145              Save operator logo as sms (Nokia format - size  72x14  or  78x21
1146              after using -biglogo).
1147
1148
1149              For  description  of shared parameters see Common parameters for
1150              sendsms and savesms.
1151
1152
1153
1154       savesms PICTURE file [-folder id] [-unread] [-read]  [-unsent]  [-sent]
1155       [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
1156       [-reply] [-maxsms num] [-text text] [-unicode] [-alcatelbmmi]
1157              Save Picture Image as sms (Nokia format - size 72x28).
1158
1159
1160              For description of shared parameters see Common  parameters  for
1161              sendsms and savesms.
1162
1163
1164
1165       sendsms  ANIMATION destination frames file1 file2... [-report] [-valid‐
1166       ity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]]  [-smscset
1167       number] [-smscnumber number] [-reply] [-maxsms num]
1168              Sends  a message, for description of message specific parameters
1169              see savesms ANIMATION.
1170
1171
1172
1173              For description of shared parameters see Common  parameters  for
1174              sendsms and savesms.
1175
1176
1177
1178       sendsms     CALLER     destination     file     [-report]    [-validity
1179       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
1180       ber] [-smscnumber number] [-reply] [-maxsms num]
1181              Sends  a message, for description of message specific parameters
1182              see savesms CALLER.
1183
1184
1185
1186              For description of shared parameters see Common  parameters  for
1187              sendsms and savesms.
1188
1189
1190
1191       sendsms     OPERATOR     destination    file    [-report]    [-validity
1192       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
1193       ber]  [-smscnumber  number]  [-reply]  [-maxsms num] [-netcode netcode]
1194       [-biglogo]
1195              Sends a message, for description of message specific  parameters
1196              see savesms OPERATOR.
1197
1198
1199
1200              For  description  of shared parameters see Common parameters for
1201              sendsms and savesms.
1202
1203
1204
1205       sendsms    PICTURE    destination     file     [-report]     [-validity
1206       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
1207       ber] [-smscnumber number] [-reply] [-maxsms num]  [-text  text]  [-uni‐
1208       code] [-alcatelbmmi]
1209              Sends  a message, for description of message specific parameters
1210              see savesms PICTURE.
1211
1212
1213
1214              For description of shared parameters see Common  parameters  for
1215              sendsms and savesms.
1216
1217
1218
1219       setbitmap CALLER location [file]
1220              Set caller logo.
1221
1222
1223       setbitmap COLOUROPERATOR [fileID [netcode]]
1224
1225
1226       setbitmap COLOURSTARTUP [fileID]
1227
1228
1229       setbitmap DEALER text
1230
1231
1232       setbitmap OPERATOR [file [netcode]]
1233              Set  operator  logo  in phone. When won't give file and netcode,
1234              operator logo will be removed from phone. When  will  give  only
1235              filename,  operator  logo will be displayed for your current GSM
1236              operator. When give additionaly network code, it  will  be  dis‐
1237              played for this operator: gammu setbitmap OPERATOR file "260 02"
1238
1239
1240       setbitmap PICTURE file location [text]
1241
1242
1243       setbitmap STARTUP file|1|2|3
1244              Set  startup logo in phone. It can be static (then you will have
1245              to give file name) or one  of  predefined  animated  (only  some
1246              phones like Nokia 3310 or 3330 supports it)
1247
1248
1249       setbitmap TEXT text
1250
1251
1252       setbitmap WALLPAPER fileID
1253
1254
1255
1256   Ringtones
1257       Ringtones are mostly supported only for older phones. For recent phones
1258       you usually just upload them to some folder in phone filesystem.
1259
1260
1261       addnew file [-yes]
1262              Adds data written in  file  created  using  backup  option.  All
1263              things  backup'ed by backup can be restored (when made backup to
1264              Gammu text file).
1265
1266              Please note that this adds all content of backup file  to  phone
1267              and does not care about current data in the phone (no duplicates
1268              are detected).
1269
1270
1271       backup file [-yes]
1272              Backup your phone to file. It's possible to backup  (depends  on
1273              phone and backup format):
1274
1275              * phonebook from SIM and phone memory
1276              * calendar notes
1277              * SMSC settings
1278              * operator logo
1279              * startup (static) logo or startup text
1280              * WAP bookmarks
1281              * WAP settings
1282              * caller logos and groups
1283              * user ringtones
1284
1285              There are various backup formats supported and the backup format
1286              is guessed based on file extension:
1287
1288              * .lmb - Nokia  backup,  supports  contacts,  caller  logos  and
1289              startup logo.
1290              * .vcs - vCalendar, supports calendar and todo.
1291              * .vcf - vCard, supports contacts.
1292              * .ldif - LDAP import, supports contacts.
1293              * .ics - iCalendar, supports calendar and todo.
1294              *  Any  other extension is Gammu backup file and it supports all
1295              data mentioned above.
1296
1297              See EXAMPLE section for some hints on manipulating Gammu  backup
1298              format.
1299
1300
1301
1302       clearall
1303              Deletes all private data from the phone.
1304
1305
1306       copyringtone source destination [RTTL|BINARY]
1307              Copy source ringtone to destination.
1308
1309
1310       getphoneringtone location [file]
1311
1312              Get one of "default" ringtones and saves into file
1313
1314
1315       getringtone location [file]
1316              Get ringtone from phone in RTTL or BINARY format.
1317
1318              Locations are numerated from 1.
1319
1320
1321       getringtoneslist
1322
1323
1324       nokiacomposer file
1325              Show,  how  to  enter RTTL ringtone in composer existing in many
1326              Nokia phones (and how should it look like).
1327
1328
1329       playringtone file
1330              Play aproximation of ringtone over phone buzzer. File can be  in
1331              RTTL or BINARY (Nokia DCT3) format.
1332
1333
1334       playsavedringtone number
1335
1336              Play one of "built" ringtones. This option is available for DCT4
1337              phones. For getting ringtones list use getringtoneslist.
1338
1339
1340       restore file [-yes]
1341              Restore settings written in file created using backup option.
1342
1343              Please note that restoring deletes all current content in phone.
1344              If you want only to add entries to phone, use addnew.
1345
1346              In some phones restoring calendar notes will not show error, but
1347              won't be done, when phone doesn't have set clock inside.
1348
1349
1350       savesms RINGTONE file [-folder id] [-unread] [-read] [-unsent]  [-sent]
1351       [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
1352       [-reply] [-maxsms num] [-long] [-scale]
1353              Read RTTL ringtone from file and save as SMS into SIM/phone mem‐
1354              ory. Ringtone is saved in Nokia format.
1355
1356              -long  - ringtone is saved using Profile style. It can be longer
1357              (and saved in 2 SMS), but decoded only  by  newer  phones  (like
1358              33xx)
1359
1360              -scale  -  ringtone  will have Scale info for each note. It will
1361              allow to edit it correctly later in phone composer (for example,
1362              in 33xx)
1363
1364
1365              For  description  of shared parameters see Common parameters for
1366              sendsms and savesms.
1367
1368
1369
1370       sendsms    RINGTONE    destination    file     [-report]     [-validity
1371       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
1372       ber] [-smscnumber number] [-reply] [-maxsms num] [-long] [-scale]
1373              Sends a message, for description of message specific  parameters
1374              see savesms RINGTONE.
1375
1376
1377
1378              For  description  of shared parameters see Common parameters for
1379              sendsms and savesms.
1380
1381
1382
1383       setringtone file [-location location] [-scale] [-name name]
1384              Set ringtone in phone. When don't  give  location,  it  will  be
1385              written  "with  preview" (in phones supporting this feature like
1386              61xx or 6210).  When use RTTL ringtones, give location  and  use
1387              -scale, there will be written scale info with each note. It will
1388              avoid scale problems available during editing ringtone  in  com‐
1389              poser from phone menu (for example, in N33xx).
1390
1391              TIP:  when  use  ~  char  in ringtone name, in some phones (like
1392              33xx) name will blink later in phone menus
1393
1394
1395
1396   Calendar notes
1397       addnew file [-yes]
1398              Adds data written in  file  created  using  backup  option.  All
1399              things  backup'ed by backup can be restored (when made backup to
1400              Gammu text file).
1401
1402              Please note that this adds all content of backup file  to  phone
1403              and does not care about current data in the phone (no duplicates
1404              are detected).
1405
1406
1407       backup file [-yes]
1408              Backup your phone to file. It's possible to backup  (depends  on
1409              phone and backup format):
1410
1411              * phonebook from SIM and phone memory
1412              * calendar notes
1413              * SMSC settings
1414              * operator logo
1415              * startup (static) logo or startup text
1416              * WAP bookmarks
1417              * WAP settings
1418              * caller logos and groups
1419              * user ringtones
1420
1421              There are various backup formats supported and the backup format
1422              is guessed based on file extension:
1423
1424              * .lmb - Nokia  backup,  supports  contacts,  caller  logos  and
1425              startup logo.
1426              * .vcs - vCalendar, supports calendar and todo.
1427              * .vcf - vCard, supports contacts.
1428              * .ldif - LDAP import, supports contacts.
1429              * .ics - iCalendar, supports calendar and todo.
1430              *  Any  other extension is Gammu backup file and it supports all
1431              data mentioned above.
1432
1433              See EXAMPLE section for some hints on manipulating Gammu  backup
1434              format.
1435
1436
1437
1438       clearall
1439              Deletes all private data from the phone.
1440
1441
1442       deletecalendar start [stop]
1443              Deletes selected calendar entries in phone.
1444
1445       getallcalendar
1446              Retrieves all calendar entries from phone.
1447
1448       getcalendar start [stop]
1449              Retrieves selected calendar entries from phone.
1450
1451       getcalendarsettings
1452              Displays  calendar  settings like first day of week or automatic
1453              deleting of old entries.
1454
1455
1456       restore file [-yes]
1457              Restore settings written in file created using backup option.
1458
1459              Please note that restoring deletes all current content in phone.
1460              If you want only to add entries to phone, use addnew.
1461
1462              In some phones restoring calendar notes will not show error, but
1463              won't be done, when phone doesn't have set clock inside.
1464
1465
1466       savefile CALENDAR target.vcs file location
1467              Allows to convert between various  backup  formats  which  gammu
1468              supports  for  calendar  events.  The  file type is guessed (for
1469              input file guess is based on extension  and  file  content,  for
1470              output solely on extension).
1471
1472              For  example  if  you  want  to  convert single entry from gammu
1473              native backup to vCalendar, you need following command:
1474
1475                  gammu savefile CALENDAR output.vcs myCalendar.backup 260
1476
1477
1478       savesms CALENDAR file location [-folder id] [-unread] [-read] [-unsent]
1479       [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
1480       number] [-reply] [-maxsms num]
1481              Read calendar note from file created by backup option and  saves
1482              in VCALENDAR 1.0 format as SMS.
1483
1484
1485              For  description  of shared parameters see Common parameters for
1486              sendsms and savesms.
1487
1488
1489
1490       sendsms  CALENDAR  destination  file  location   [-report]   [-validity
1491       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
1492       ber] [-smscnumber number] [-reply] [-maxsms num]
1493              Sends a message, for description of message specific  parameters
1494              see savesms CALENDAR.
1495
1496
1497
1498              For  description  of shared parameters see Common parameters for
1499              sendsms and savesms.
1500
1501
1502
1503
1504   To do lists
1505       addcategory TODO|PHONEBOOK text
1506
1507
1508       addnew file [-yes]
1509              Adds data written in  file  created  using  backup  option.  All
1510              things  backup'ed by backup can be restored (when made backup to
1511              Gammu text file).
1512
1513              Please note that this adds all content of backup file  to  phone
1514              and does not care about current data in the phone (no duplicates
1515              are detected).
1516
1517
1518       backup file [-yes]
1519              Backup your phone to file. It's possible to backup  (depends  on
1520              phone and backup format):
1521
1522              * phonebook from SIM and phone memory
1523              * calendar notes
1524              * SMSC settings
1525              * operator logo
1526              * startup (static) logo or startup text
1527              * WAP bookmarks
1528              * WAP settings
1529              * caller logos and groups
1530              * user ringtones
1531
1532              There are various backup formats supported and the backup format
1533              is guessed based on file extension:
1534
1535              * .lmb - Nokia  backup,  supports  contacts,  caller  logos  and
1536              startup logo.
1537              * .vcs - vCalendar, supports calendar and todo.
1538              * .vcf - vCard, supports contacts.
1539              * .ldif - LDAP import, supports contacts.
1540              * .ics - iCalendar, supports calendar and todo.
1541              *  Any  other extension is Gammu backup file and it supports all
1542              data mentioned above.
1543
1544              See EXAMPLE section for some hints on manipulating Gammu  backup
1545              format.
1546
1547
1548
1549       clearall
1550              Deletes all private data from the phone.
1551
1552
1553       deletetodo start [stop]
1554              Deletes selected todo entries in phone.
1555
1556       getallcategory TODO|PHONEBOOK
1557
1558
1559       getalltodo
1560              Retrieves all todo entries from phone.
1561
1562       getcategory TODO|PHONEBOOK start [stop]
1563
1564
1565       gettodo start [stop]
1566              Retrieves selected todo entries from phone.
1567
1568       listtodocategory text|number
1569
1570
1571       restore file [-yes]
1572              Restore settings written in file created using backup option.
1573
1574              Please note that restoring deletes all current content in phone.
1575              If you want only to add entries to phone, use addnew.
1576
1577              In some phones restoring calendar notes will not show error, but
1578              won't be done, when phone doesn't have set clock inside.
1579
1580
1581       savefile TODO target.vcs file location
1582              Allows  to  convert  between  various backup formats which gammu
1583              supports for todo events. The file type is  guessed  (for  input
1584              file  guess  is  based on extension and file content, for output
1585              solely on extension).
1586
1587              For example if you want  to  convert  single  entry  from  gammu
1588              native backup to vCalendar, you need following command:
1589
1590                  gammu savefile CALENDAR output.vcs myCalendar.backup 260
1591
1592
1593       savesms  TODO  file  location  [-folder id] [-unread] [-read] [-unsent]
1594       [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
1595       number] [-reply] [-maxsms num]
1596              Saves a message with a todo entry. The content will be read from
1597              any backup format which Gammu supports and from given location.
1598
1599              For description of shared parameters see Common  parameters  for
1600              sendsms and savesms.
1601
1602
1603
1604       sendsms   TODO   destination   file   location   [-report]   [-validity
1605       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
1606       ber] [-smscnumber number] [-reply] [-maxsms num]
1607              Sends  a message, for description of message specific parameters
1608              see savesms TODO.
1609
1610
1611
1612              For description of shared parameters see Common  parameters  for
1613              sendsms and savesms.
1614
1615
1616
1617
1618   Notes
1619       getallnotes
1620              Reads all notes from the phone.
1621
1622
1623
1624   Date, time and alarms
1625       getalarm [start]
1626              Get alarm from phone, if no location is specified, 1 is used.
1627
1628
1629       getdatetime
1630              Get date and time from phone
1631
1632
1633       setalarm hour minute
1634              Sets repeating alarm in phone on selected time.
1635
1636       setdatetime [HH:MM[:SS]] [YYYY/MM/DD]
1637              Set  date  and  time  in phone to date and time set in computer.
1638              Please note, that  this  option  doesn't  show  clock  on  phone
1639              screen. It only set date and time.
1640
1641              TIP: you can make such synchronization each time, when will con‐
1642              nect your phone and use Gammu. See gammurc(5) for details.
1643
1644
1645
1646   Categories
1647       addcategory TODO|PHONEBOOK text
1648
1649
1650       addnew file [-yes]
1651              Adds data written in  file  created  using  backup  option.  All
1652              things  backup'ed by backup can be restored (when made backup to
1653              Gammu text file).
1654
1655              Please note that this adds all content of backup file  to  phone
1656              and does not care about current data in the phone (no duplicates
1657              are detected).
1658
1659
1660       backup file [-yes]
1661              Backup your phone to file. It's possible to backup  (depends  on
1662              phone and backup format):
1663
1664              * phonebook from SIM and phone memory
1665              * calendar notes
1666              * SMSC settings
1667              * operator logo
1668              * startup (static) logo or startup text
1669              * WAP bookmarks
1670              * WAP settings
1671              * caller logos and groups
1672              * user ringtones
1673
1674              There are various backup formats supported and the backup format
1675              is guessed based on file extension:
1676
1677              * .lmb - Nokia  backup,  supports  contacts,  caller  logos  and
1678              startup logo.
1679              * .vcs - vCalendar, supports calendar and todo.
1680              * .vcf - vCard, supports contacts.
1681              * .ldif - LDAP import, supports contacts.
1682              * .ics - iCalendar, supports calendar and todo.
1683              *  Any  other extension is Gammu backup file and it supports all
1684              data mentioned above.
1685
1686              See EXAMPLE section for some hints on manipulating Gammu  backup
1687              format.
1688
1689
1690
1691       clearall
1692              Deletes all private data from the phone.
1693
1694
1695       getallcategory TODO|PHONEBOOK
1696
1697
1698       getcategory TODO|PHONEBOOK start [stop]
1699
1700
1701       listmemorycategory text|number
1702
1703
1704       listtodocategory text|number
1705
1706
1707       restore file [-yes]
1708              Restore settings written in file created using backup option.
1709
1710              Please note that restoring deletes all current content in phone.
1711              If you want only to add entries to phone, use addnew.
1712
1713              In some phones restoring calendar notes will not show error, but
1714              won't be done, when phone doesn't have set clock inside.
1715
1716
1717
1718   Backing up and restoring
1719       addnew file [-yes]
1720              Adds  data  written  in  file  created  using backup option. All
1721              things backup'ed by backup can be restored (when made backup  to
1722              Gammu text file).
1723
1724              Please  note  that this adds all content of backup file to phone
1725              and does not care about current data in the phone (no duplicates
1726              are detected).
1727
1728
1729       addsms folder file [-yes]
1730              Adds  SMSes  from  file (format like backupsms uses) to selected
1731              folder in phone.
1732
1733       backup file [-yes]
1734              Backup your phone to file. It's possible to backup  (depends  on
1735              phone and backup format):
1736
1737              * phonebook from SIM and phone memory
1738              * calendar notes
1739              * SMSC settings
1740              * operator logo
1741              * startup (static) logo or startup text
1742              * WAP bookmarks
1743              * WAP settings
1744              * caller logos and groups
1745              * user ringtones
1746
1747              There are various backup formats supported and the backup format
1748              is guessed based on file extension:
1749
1750              * .lmb - Nokia  backup,  supports  contacts,  caller  logos  and
1751              startup logo.
1752              * .vcs - vCalendar, supports calendar and todo.
1753              * .vcf - vCard, supports contacts.
1754              * .ldif - LDAP import, supports contacts.
1755              * .ics - iCalendar, supports calendar and todo.
1756              *  Any  other extension is Gammu backup file and it supports all
1757              data mentioned above.
1758
1759              See EXAMPLE section for some hints on manipulating Gammu  backup
1760              format.
1761
1762
1763
1764       backupsms file [-yes|-all]
1765              Stores all SMSes from phone to file.
1766
1767              Use -yes for answering yes to all questions (backup all messages
1768              and delete them from phone), or -all to just backup all  folders
1769              while keeping messages in phone.
1770
1771
1772       restore file [-yes]
1773              Restore settings written in file created using backup option.
1774
1775              Please note that restoring deletes all current content in phone.
1776              If you want only to add entries to phone, use addnew.
1777
1778              In some phones restoring calendar notes will not show error, but
1779              won't be done, when phone doesn't have set clock inside.
1780
1781
1782       restoresms file [-yes]
1783              Restores  SMSes  from  file  (format  like  backupsms  uses)  to
1784              selected folder in  phone.  Please  note  that  this  overwrites
1785              existing messages in phone (if it supports it).
1786
1787       savefile BOOKMARK target.url file location
1788
1789
1790       savefile CALENDAR target.vcs file location
1791              Allows  to  convert  between  various backup formats which gammu
1792              supports for calendar events. The  file  type  is  guessed  (for
1793              input  file  guess  is  based on extension and file content, for
1794              output solely on extension).
1795
1796              For example if you want  to  convert  single  entry  from  gammu
1797              native backup to vCalendar, you need following command:
1798
1799                  gammu savefile CALENDAR output.vcs myCalendar.backup 260
1800
1801
1802       savefile TODO target.vcs file location
1803              Allows  to  convert  between  various backup formats which gammu
1804              supports for todo events. The file type is  guessed  (for  input
1805              file  guess  is  based on extension and file content, for output
1806              solely on extension).
1807
1808              For example if you want  to  convert  single  entry  from  gammu
1809              native backup to vCalendar, you need following command:
1810
1811                  gammu savefile CALENDAR output.vcs myCalendar.backup 260
1812
1813
1814       savefile VCARD10|VCARD21 target.vcf file SM|ME location
1815              Allows  to  convert  between  various backup formats which gammu
1816              supports for phonebook events. The file  type  is  guessed  (for
1817              input  file  guess  is  based on extension and file content, for
1818              output solely on extension).
1819
1820              For example if you want  to  convert  single  entry  from  gammu
1821              native backup to vCard, you need following command:
1822
1823                  gammu savefile CALENDAR output.vcf myPhonebook.backup ME 42
1824
1825
1826
1827   Nokia specific
1828       nokiaaddfile                                      Gallery|Gallery2|Cam‐
1829       era|Tones|Tones2|Records|Video|Playlist|MemoryCard  file  [-name  name]
1830       [-protected] [-readonly] [-system] [-hidden] [-newtime]
1831              Install the *.jar/*.jad file pair of a midlet in the application
1832              or game menu of the phone. You have to give the name without the
1833              jar/jad  suffix,  otherwise  you will get the slightly confusing
1834              error message Can't open specified file. Read only ?
1835
1836              The option -overwrite deletes the application's  .jad  and  .jar
1837              files bevor installing, but doesn't delete the application data.
1838              Option -overwriteall will  also  delete  all  data.  Both  these
1839              options work only for Application or Game upload.
1840
1841              Example:   gammu   nokiaaddfile   Application  Alien  will  read
1842              Alien.JAD and Alien.JAR and add to Applications
1843
1844              Example: gammu nokiaaddfile Tones file.mid  will  read  file.mid
1845              and add to Tones folder
1846
1847              You  can  use  jadmaker(1)  to  generate a .jad file from a .jar
1848              file.
1849
1850
1851       nokiaaddplaylists
1852
1853
1854       nokiacomposer file
1855              Show, how to enter RTTL ringtone in composer  existing  in  many
1856              Nokia phones (and how should it look like).
1857
1858
1859       nokiadebug filename [[v11-22] [,v33-44]...]
1860
1861
1862       nokiadisplayoutput
1863
1864
1865       nokiadisplaytest number
1866
1867
1868       nokiagetadc
1869
1870
1871       nokiagetoperatorname
1872              6110.c  phones  have  place  for  name  for  one GSM network (of
1873              course, with flashing it's possible to  change  all  names,  but
1874              Gammu  is  not  flasher  ;-)).  You can get this name using this
1875              option.
1876
1877
1878       nokiagetpbkfeatures memorytype
1879
1880
1881       nokiagetscreendump
1882
1883
1884       nokiagett9
1885
1886
1887       nokiagetvoicerecord location
1888
1889              Get voice record from location and save to  WAV  file.  File  is
1890              coded  using  GSM  6.10  codec (available for example in win32).
1891              Name of file is like name of voice record in phone.
1892
1893
1894       nokiamakecamerashoot
1895
1896
1897       nokianetmonitor test
1898              Takes output or set netmonitor for Nokia DCT3 phones.
1899
1900              TIP:  For  more   info   about   this   option,   please   visit
1901              http://www.mwiacek.com and read netmonitor manual.
1902
1903              TIP:  test  243  enables  all  tests  (after using command gammu
1904              nokianetmonitor 243 in some phones like 6210  or  9210  have  to
1905              reboot them to see netmonitor menu)
1906
1907
1908       nokianetmonitor36
1909              Reset counters from netmonitor test 36 in Nokia DCT3 phones.
1910
1911              TIP:   For   more   info   about   this   option,  please  visit
1912              http://www.mwiacek.com and read netmonitor manual.
1913
1914
1915       nokiasecuritycode
1916              Get/reset to "12345" security code
1917
1918
1919       nokiaselftests
1920
1921
1922       nokiasetlights keypad|display|torch on|off
1923
1924
1925       nokiasetoperatorname [networkcode name]
1926
1927
1928       nokiasetphonemenus
1929              Enable all (?) possible menus for DCT3 Nokia phones:
1930
1931              1. ALS (Alternative Line Service) option menu
1932              2. vibra menu for 3210
1933              3. 3315 features in 3310 5.45 and higher
1934              4. two additional games (React and  Logic)  for  3210  5.31  and
1935              higher
1936              5. WellMate menu for 6150
1937              6. NetMonitor
1938
1939              and for DCT4:
1940
1941              1. ALS (Alternative Line Service) option menu
1942              2. Bluetooth, WAP bookmarks and settings menu, ... (6310i)
1943              3. GPRS Always Online
1944               ...
1945
1946
1947       nokiasetvibralevel level
1948              Set vibra power to "level" (given in percent)
1949
1950
1951       nokiatuneradio
1952
1953
1954       nokiavibratest
1955
1956
1957
1958   Siemens specific
1959       siemensnetmonact netmon_type (1-full, 2-simple)
1960
1961
1962       siemensnetmonitor test
1963
1964
1965       siemenssatnetmon
1966
1967
1968
1969   Network
1970       getgprspoint start [stop]
1971
1972
1973       listnetworks [country]
1974              Show names/codes of GSM networks known for Gammu
1975
1976
1977       monitor [times]
1978              Get  phone  status  and  writes continuously to standard output.
1979              Press Ctrl+C to break this state.
1980
1981
1982       networkinfo
1983              Show information about network status from the phone.
1984
1985
1986       nokiadebug filename [[v11-22] [,v33-44]...]
1987
1988
1989       nokiagetoperatorname
1990              6110.c phones have place  for  name  for  one  GSM  network  (of
1991              course,  with  flashing  it's  possible to change all names, but
1992              Gammu is not flasher ;-)). You can  get  this  name  using  this
1993              option.
1994
1995
1996       nokianetmonitor test
1997              Takes output or set netmonitor for Nokia DCT3 phones.
1998
1999              TIP:   For   more   info   about   this   option,  please  visit
2000              http://www.mwiacek.com and read netmonitor manual.
2001
2002              TIP: test 243 enables  all  tests  (after  using  command  gammu
2003              nokianetmonitor  243  in  some  phones like 6210 or 9210 have to
2004              reboot them to see netmonitor menu)
2005
2006
2007       nokiasetoperatorname [networkcode name]
2008
2009
2010       setautonetworklogin
2011
2012
2013       siemensnetmonact netmon_type (1-full, 2-simple)
2014
2015
2016       siemensnetmonitor test
2017
2018
2019       siemenssatnetmon
2020
2021
2022
2023   WAP settings and bookmarks
2024       addnew file [-yes]
2025              Adds data written in  file  created  using  backup  option.  All
2026              things  backup'ed by backup can be restored (when made backup to
2027              Gammu text file).
2028
2029              Please note that this adds all content of backup file  to  phone
2030              and does not care about current data in the phone (no duplicates
2031              are detected).
2032
2033
2034       backup file [-yes]
2035              Backup your phone to file. It's possible to backup  (depends  on
2036              phone and backup format):
2037
2038              * phonebook from SIM and phone memory
2039              * calendar notes
2040              * SMSC settings
2041              * operator logo
2042              * startup (static) logo or startup text
2043              * WAP bookmarks
2044              * WAP settings
2045              * caller logos and groups
2046              * user ringtones
2047
2048              There are various backup formats supported and the backup format
2049              is guessed based on file extension:
2050
2051              * .lmb - Nokia  backup,  supports  contacts,  caller  logos  and
2052              startup logo.
2053              * .vcs - vCalendar, supports calendar and todo.
2054              * .vcf - vCard, supports contacts.
2055              * .ldif - LDAP import, supports contacts.
2056              * .ics - iCalendar, supports calendar and todo.
2057              *  Any  other extension is Gammu backup file and it supports all
2058              data mentioned above.
2059
2060              See EXAMPLE section for some hints on manipulating Gammu  backup
2061              format.
2062
2063
2064
2065       clearall
2066              Deletes all private data from the phone.
2067
2068
2069       deletewapbookmark start [stop]
2070              Delete WAP bookmarks from phone.
2071
2072              Locations are numerated from 1.
2073
2074
2075       getchatsettings start [stop]
2076
2077
2078       getsyncmlsettings start [stop]
2079
2080
2081       getwapbookmark start [stop]
2082              Get WAP bookmarks from phone.
2083
2084              Locations are numerated from 1.
2085
2086
2087       getwapsettings start [stop]
2088              Get WAP settings from phone.
2089
2090              Locations are numerated from 1.
2091
2092
2093       restore file [-yes]
2094              Restore settings written in file created using backup option.
2095
2096              Please note that restoring deletes all current content in phone.
2097              If you want only to add entries to phone, use addnew.
2098
2099              In some phones restoring calendar notes will not show error, but
2100              won't be done, when phone doesn't have set clock inside.
2101
2102
2103       savefile BOOKMARK target.url file location
2104
2105
2106       savesms BOOKMARK file location [-folder id] [-unread] [-read] [-unsent]
2107       [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
2108       number] [-reply] [-maxsms num]
2109              Read  WAP  bookmark from file created by backup option and saves
2110              in Nokia format as SMS
2111
2112
2113              For description of shared parameters see Common  parameters  for
2114              sendsms and savesms.
2115
2116
2117
2118       savesms WAPINDICATOR URL Title [-folder id] [-unread] [-read] [-unsent]
2119       [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
2120       number] [-reply] [-maxsms num]
2121              Saves a SMS with a WAP indication for given URL and title.
2122
2123
2124              For  description  of shared parameters see Common parameters for
2125              sendsms and savesms.
2126
2127
2128
2129       savesms WAPSETTINGS file  location  DATA|GPRS  [-folder  id]  [-unread]
2130       [-read]  [-unsent]  [-sent]  [-sender number] [-smsname name] [-smscset
2131       number] [-smscnumber number] [-reply] [-maxsms num]
2132              Read WAP settings from file created by backup option  and  saves
2133              in Nokia format as SMS
2134
2135
2136              For  description  of shared parameters see Common parameters for
2137              sendsms and savesms.
2138
2139
2140
2141       sendsms  BOOKMARK  destination  file  location   [-report]   [-validity
2142       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
2143       ber] [-smscnumber number] [-reply] [-maxsms num]
2144              Sends a message, for description of message specific  parameters
2145              see savesms BOOKMARK.
2146
2147
2148
2149              For  description  of shared parameters see Common parameters for
2150              sendsms and savesms.
2151
2152
2153
2154       sendsms  WAPINDICATOR  destination  URL  Title   [-report]   [-validity
2155       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
2156       ber] [-smscnumber number] [-reply] [-maxsms num]
2157              Sends a message, for description of message specific  parameters
2158              see savesms WAPINDICATOR.
2159
2160
2161
2162              For  description  of shared parameters see Common parameters for
2163              sendsms and savesms.
2164
2165
2166
2167       sendsms  WAPSETTINGS  destination  file  location  DATA|GPRS  [-report]
2168       [-validity  HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]
2169       [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
2170              Sends a message, for description of message specific  parameters
2171              see savesms WAPSETTINGS.
2172
2173
2174
2175              For  description  of shared parameters see Common parameters for
2176              sendsms and savesms.
2177
2178
2179
2180
2181   MMS and MMS settings
2182       getallmms [-save]
2183
2184
2185       geteachmms [-save]
2186
2187
2188       getmmsfolders
2189
2190
2191       getmmssettings start [stop]
2192
2193
2194       readmmsfile file [-save]
2195
2196
2197       savesms MMSINDICATOR URL Title Sender [-folder  id]  [-unread]  [-read]
2198       [-unsent]  [-sent]  [-sender  number] [-smsname name] [-smscset number]
2199       [-smscnumber number] [-reply] [-maxsms num]
2200
2201              Saves a message with MMS indication. The  recipient  phone  will
2202              then download MMS from given URL and display it.
2203
2204              Please note that you should provide valid smil data on that URL.
2205
2206
2207              For  description  of shared parameters see Common parameters for
2208              sendsms and savesms.
2209
2210
2211
2212       savesms MMSSETTINGS  file  location   [-folder  id]  [-unread]  [-read]
2213       [-unsent]  [-sent]  [-sender  number] [-smsname name] [-smscset number]
2214       [-smscnumber number] [-reply] [-maxsms num]
2215              Saves a message with MMS configuration. The  configuration  will
2216              be read from Gammu backup file from given location.
2217
2218              For  description  of shared parameters see Common parameters for
2219              sendsms and savesms.
2220
2221
2222
2223       sendsms MMSINDICATOR destination URL Title Sender [-report]  [-validity
2224       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
2225       ber] [-smscnumber number] [-reply] [-maxsms num]
2226              Sends a message, for description of message specific  parameters
2227              see savesms MMSINDICATOR.
2228
2229
2230
2231              For  description  of shared parameters see Common parameters for
2232              sendsms and savesms.
2233
2234
2235
2236       sendsms MMSSETTINGS  destination  file  location  [-report]  [-validity
2237       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
2238       ber] [-smscnumber number] [-reply] [-maxsms num]
2239              Sends a message, for description of message specific  parameters
2240              see savesms MMSSETTINGS.
2241
2242
2243
2244              For  description  of shared parameters see Common parameters for
2245              sendsms and savesms.
2246
2247
2248
2249
2250   Phone tests
2251       nokiadisplaytest number
2252
2253
2254       nokiagetadc
2255
2256
2257       nokiaselftests
2258
2259
2260       nokiasetlights keypad|display|torch on|off
2261
2262
2263       nokiavibratest
2264
2265
2266
2267   FM radio
2268       addnew file [-yes]
2269              Adds data written in  file  created  using  backup  option.  All
2270              things  backup'ed by backup can be restored (when made backup to
2271              Gammu text file).
2272
2273              Please note that this adds all content of backup file  to  phone
2274              and does not care about current data in the phone (no duplicates
2275              are detected).
2276
2277
2278       backup file [-yes]
2279              Backup your phone to file. It's possible to backup  (depends  on
2280              phone and backup format):
2281
2282              * phonebook from SIM and phone memory
2283              * calendar notes
2284              * SMSC settings
2285              * operator logo
2286              * startup (static) logo or startup text
2287              * WAP bookmarks
2288              * WAP settings
2289              * caller logos and groups
2290              * user ringtones
2291
2292              There are various backup formats supported and the backup format
2293              is guessed based on file extension:
2294
2295              * .lmb - Nokia  backup,  supports  contacts,  caller  logos  and
2296              startup logo.
2297              * .vcs - vCalendar, supports calendar and todo.
2298              * .vcf - vCard, supports contacts.
2299              * .ldif - LDAP import, supports contacts.
2300              * .ics - iCalendar, supports calendar and todo.
2301              *  Any  other extension is Gammu backup file and it supports all
2302              data mentioned above.
2303
2304              See EXAMPLE section for some hints on manipulating Gammu  backup
2305              format.
2306
2307
2308
2309       clearall
2310              Deletes all private data from the phone.
2311
2312
2313       getfmstation start [stop]
2314              Show info about FM stations in phone
2315
2316
2317       nokiatuneradio
2318
2319
2320       restore file [-yes]
2321              Restore settings written in file created using backup option.
2322
2323              Please note that restoring deletes all current content in phone.
2324              If you want only to add entries to phone, use addnew.
2325
2326              In some phones restoring calendar notes will not show error, but
2327              won't be done, when phone doesn't have set clock inside.
2328
2329
2330
2331   Phone information
2332       checkfirmware
2333
2334              Gammu  connects  to www.gammu.org and checks for latest firmware
2335              versions    available    for    the     device.     The     file
2336              <http://www.gammu.org/support/phones/phonedbxml.php?model=x>
2337              will be downloaded and all phone details will be read  from  it.
2338              No  private  data  are  sent  to  server. Internet connection to
2339              www.gammu.org on port 80 required.
2340
2341
2342       getdisplaystatus
2343
2344
2345       getsecuritystatus
2346              Show, if phone wait for security code (like PIN, PUK,  etc.)  or
2347              not
2348
2349
2350       identify
2351              Show the most important phone data.
2352
2353
2354       monitor [times]
2355              Get  phone  status  and  writes continuously to standard output.
2356              Press Ctrl+C to break this state.
2357
2358
2359       nokiasecuritycode
2360              Get/reset to "12345" security code
2361
2362
2363
2364   Phone settings
2365       getcalendarsettings
2366              Displays calendar settings like first day of week  or  automatic
2367              deleting of old entries.
2368
2369
2370       getprofile start [stop]
2371
2372
2373       resetphonesettings PHONE|DEV|UIF|ALL|FACTORY
2374              Reset phone settings. BE CAREFULL !!!!
2375
2376              PHONE:
2377
2378              DEV:
2379
2380              ALL:
2381
2382              Clear user settings
2383              * removes or set logos to default
2384              * set default phonebook and other menu settings
2385              * clear T9 words,
2386              * clear call register info
2387              * set default profiles settings
2388              * clear user ringtones
2389
2390              UIF:
2391              * changes like after ALL
2392              * disables netmon and PPS (all "hidden" menus)
2393
2394              FACTORY:
2395              * changes like after UIF
2396              * clear date/time
2397
2398
2399       savesms  PROFILE  [-folder  id]  [-unread]  [-read]  [-unsent]  [-sent]
2400       [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
2401       [-reply]  [-maxsms  num] [-name name] [-bitmap bitmap] [-ringtone ring‐
2402       tone]
2403              Read ringtone (RTTL) format and bitmap (Picture Image size)  and
2404              name and save as Nokia profile.
2405
2406
2407              For  description  of shared parameters see Common parameters for
2408              sendsms and savesms.
2409
2410
2411
2412       sendsms      PROFILE       destination       [-report]       [-validity
2413       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
2414       ber] [-smscnumber number] [-reply] [-maxsms num] [-name name]  [-bitmap
2415       bitmap] [-ringtone ringtone]
2416              Sends  a message, for description of message specific parameters
2417              see savesms PROFILE.
2418
2419
2420
2421              For description of shared parameters see Common  parameters  for
2422              sendsms and savesms.
2423
2424
2425
2426
2427   Dumps decoding
2428       decodebinarydump file [phonemodel]
2429              Decodes  a  dump  made by Gammu with logformat se to binary (see
2430              README for info about this method of reporting bugs).
2431
2432              This option is available only if Gammu was compiled with  debug‐
2433              ing options.
2434
2435
2436
2437       decodesniff MBUS2|IRDA file [phonemodel]
2438              Option  available only, if Gammu was compiled with debug. Allows
2439              to  decode  sniffs.  See  /docs/develop/develop.txt   for   more
2440              details.
2441
2442
2443       makeconverttable file
2444
2445
2446
2447   Functions that don't fit elsewhere
2448       batch [file]
2449              Starts Gammu in a batch mode. In this mode you can issue several
2450              commands each on one line. Lines starting with # are treated  as
2451              a comments.
2452
2453              By  default,  commands are read from standard input, but you can
2454              optionally specify a file from where they would be read (special
2455              case - means standard input).
2456
2457
2458       entersecuritycode PIN|PUK|PIN2|PUK2|PHONE|NETWORK code|-
2459              Allow to enter security code from PC. When code is -, it is read
2460              from stdin.
2461
2462
2463       nokiagetscreendump
2464
2465
2466       nokiagetvoicerecord location
2467
2468              Get voice record from location and save to  WAV  file.  File  is
2469              coded  using  GSM  6.10  codec (available for example in win32).
2470              Name of file is like name of voice record in phone.
2471
2472
2473       nokiamakecamerashoot
2474
2475
2476       nokiasetphonemenus
2477              Enable all (?) possible menus for DCT3 Nokia phones:
2478
2479              1. ALS (Alternative Line Service) option menu
2480              2. vibra menu for 3210
2481              3. 3315 features in 3310 5.45 and higher
2482              4. two additional games (React and  Logic)  for  3210  5.31  and
2483              higher
2484              5. WellMate menu for 6150
2485              6. NetMonitor
2486
2487              and for DCT4:
2488
2489              1. ALS (Alternative Line Service) option menu
2490              2. Bluetooth, WAP bookmarks and settings menu, ... (6310i)
2491              3. GPRS Always Online
2492               ...
2493
2494
2495       nokiasetvibralevel level
2496              Set vibra power to "level" (given in percent)
2497
2498
2499       presskeysequence mMnNpPuUdD+-123456789*0#gGrR<>[]hHcCjJfFoOmMdD@
2500              Press specified key sequence on phone keyboard
2501
2502              mM - Menu
2503              nN - Names key
2504              pP - Power
2505              uU - Up
2506              dD - Down
2507              +- - +-
2508              gG - Green
2509              rR - Red
2510              123456789*0# is numeric keyboard
2511
2512
2513       reset SOFT|HARD
2514              Make  phone  reset:  soft (without asking for PIN) or hard (with
2515              PIN).
2516
2517              Note: some phones will make hard reset even with SOFT option.
2518
2519
2520       searchphone [-debug]
2521              Attempts to search for a connected phone. Please note that  this
2522              can  take  a very long time, but in case you have no clue how to
2523              configure phone connection, this is a  convenient  way  to  find
2524              working setup for Gammu.
2525
2526
2527   Gammu information
2528       checkversion [STABLE]
2529              Checks whether there is newer Gammu version available online (if
2530              Gammu has been compiled  with  CURL).  If  you  pass  additional
2531              parameter STABLE, only stable versions will be checked.
2532
2533
2534       features
2535              Print information about compiled in features.
2536
2537
2538       help [topic]
2539              Print help. By default general help is printed, but you can also
2540              specify a help category to get more detailed help on some topic.
2541
2542
2543       version
2544              Print version information and license.
2545
2546
2547

FILES

2549       ~/.gammurc
2550       /usr/share/doc/gammu/*
2551       /dev/ircomm?
2552       /dev/ttyS?
2553       /dev/ttyACM?
2554
2555

EXAMPLE

2557   Configuration
2558       To check it out, you need to have configuration  file  for  gammu,  see
2559       gammurc(5) for more details about it.
2560
2561
2562   Sending messages
2563       Save text message up to standard 160 chars:
2564
2565              echo "All your base are belong to us" | gammu savesms TEXT
2566
2567              or
2568
2569              gammu savesms TEXT -text "All your base are belong to us"
2570
2571
2572       Save long text message:
2573
2574              echo  "All your base are belong to us" | gammu savesms TEXT -len
2575              400
2576
2577              or
2578
2579              gammu savesms TEXT -len 400 -text "All your base are  belong  to
2580              us"
2581
2582              or
2583
2584              gammu savesms EMS -text "All your base are belong to us"
2585
2586
2587       Save some funky message with predefined sound and animation from 2 bit‐
2588       maps:
2589
2590              gammu savesms EMS -text  "Greetings"  -defsound  1  -text  "from
2591              Gammu" -tone10 axelf.txt -animation 2 file1.bmp file2.bmp
2592
2593
2594       Save protected message with ringtone:
2595
2596              gammu  savesms  EMS  -protected  2  -variablebitmaplong  ala.bmp
2597              -toneSElong axelf.txt -toneSE ring.txt
2598
2599
2600   Backups
2601       If you will backup settings to Gammu text file, it will be possible  to
2602       edit  it.  It's easy: many things in this file will be written double -
2603       once in Unicode, once in ASCII. When you will  remove  Unicode  version
2604       Gammu  will use ASCII on restore (and you can easy edit ASCII text) and
2605       will convert it according to your OS locale.  When  will  be  available
2606       Unicode version of text, it will be used instead of ASCII (usefull with
2607       Unicode phones - it isn't important, what locale is set in computer and
2608       no conversion Unicode -> ASCII and ASCII -> Unicode is done).
2609
2610       You can use any editor with regular expressions function to edit backup
2611       text file. Examples of such editors can be vim <http://www.vim.org/> or
2612       TextPad <http://www.textpad.com/> which both do support regular expres‐
2613       sions.
2614
2615
2616       Remove info about voice tags
2617
2618              Find: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
2619
2620              Replace:
2621
2622
2623       Change all numbers starting from +3620, +3630, +3660, +3670 to +3620
2624
2625              Find:   Type    =    NumberGeneral\nEntry\([0-9][0-9]\)Text    =
2626              "\+36\(20\|30\|60\|70\)\n
2627
2628              Replace: Type = NumberMobile\nEntry\1Text = "\+3620
2629
2630
2631       Change  phone  numbers  type to mobile for numbers starting from +3620,
2632       +3630,... and removing the corresponding TextUnicode line
2633
2634              Find:   Type    =    NumberGeneral\nEntry\([0-9][0-9]\)Text    =
2635              "\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode    =
2636              \([^\n]*\)\n
2637
2638              Replace: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n
2639
2640
2641
2643       Copyright © 2003-2009 Marcin Wiacek, Michal Cihar  and  other  authors.
2644       License         GPLv2:         GNU         GPL         version        2
2645       <http://www.gnu.org/licenses/old-licenses/gpl-2.0.html>
2646       This is free software: you are free  to  change  and  redistribute  it.
2647       There is NO WARRANTY, to the extent permitted by law.
2648
2649

REPORTING BUGS

2651       There  are definitely many bugs, reporting to author is welcome. Please
2652       include some useful information when sending  bug  reports  (especially
2653       debug  logs,  operating  system, it's version and phone information are
2654       needed).
2655
2656
2657       To generate debug log, enable it in gammurc (alternatively you  can  do
2658       it on command line using -d textall -f /tmp/gammu.log):
2659
2660           [gammu]
2661           ...your connection settings...
2662           logfile = /tmp/gammu.log
2663           logformat = textall
2664
2665       With  this  settings, Gammu generates /tmp/gammu.log on each connection
2666       to phone and stores dump of communication there. You can also find some
2667       hints for improving support for your phone in this log.
2668
2669       Please report bugs to <http://bugs.cihar.com>.
2670
2671

AUTHOR

2673       You can contact authors on <gammu-users@lists.sourceforge.net>.
2674
2675
2676       Michal  Cihar <michal@cihar.com> is current project maintainer and con‐
2677       tributor of most of AT and OBEX code.
2678
2679
2680       Marcin Wiacek <marcin@mwiacek.com> is project iniciator and contributor
2681       of most Nokia code.
2682
2683
2684       As  this  project  grew from Gnokii, we would like to thanks all Gnokii
2685       developers, especially Pavel Janik, Pawel Kot and Manfred Jonsson  (see
2686       CREDITS from Gnokii for all their contributor).
2687
2688
2689       Many  other  people  have helped with various features, check ChangeLog
2690       for more details.
2691
2692

SEE ALSO

2694       gammu-smsd(1), gammu-smsd-inject(1), gammurc(5), jadmaker(1)
2695
2696       Some  more  hints  can  be  found   in   README   file   or   on   wiki
2697       <http://www.gammu.org/>.
2698
2699       Related programs which can be used with GSM modem:
2700
2701       cu(1), gnokii(1), minicom(1)
2702
2703       Graphical interfaces for Gammu:
2704
2705       wammu(1), gmobilemedia(1)
2706
2707
2708
2709
2710Gammu 1.25.91                     Aug 11 2009                         GAMMU(1)
Impressum