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