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