1GAMMU(1) Gammu Documentation GAMMU(1)
2
3
4
6 Gammu - Does some neat things with your cellular phone or modem.
7
8
10 Usage: gammu [parameters] <command> [options]
11
12
13
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
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
2549 ~/.gammurc
2550 /usr/share/doc/gammu/*
2551 /dev/ircomm?
2552 /dev/ttyS?
2553 /dev/ttyACM?
2554
2555
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
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
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
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)