Gammu:SMS commands

From Gammu.org Wiki

Jump to: navigation, search

[edit] SMS and EMS

[edit] Introduction to SMS formats

These commands are provided for SMS. Gammu has got support for many SMS formats like:

Nokia Smart Messaging (used for monochromatic picture images, downloadable profiles, monochromatic operator logos, monochromatic caller logos and monophonic ringtones)
linked SMS (both with 8 and 16-bit identification numbers in headers)
EMS (this is SMS format used for saving monochromatic images, monophonic ringtones, animations, text formatting and others)

[edit] Encoding chars in SMS text

Text in SMS can be coded using two ways:

with GSM Default Alphabet - in single SMS you can have maximally 160 chars (Gammu doesn't support compressing such texts according to GSM standards, but it isn't big limit, because there are no phones supporting them), but they're from limited set:
- all Latin small (abcdefghjklmnopqrstuvwxyz) and large (ABCDEFGHIJKLMNOPQRSTUVWXYZ)
- all digits (1234567890)
- some Greek (? ? ? ? ? ? ? ? ?)
- some other national (? ? ß ? ? É é ? ? ? ç ? ? Ä ä Ö ö ? ? Ü ü)
- § ? ? @ ! " # & / ( ) % * + = - , . : ; < > ?
- few other
with Unicode - in single SMS you can save maximally 70 chars, but these can be any chars including all national and special. Please note, that problems with receiving/displaying such SMS can be sometimes connected with limits existing in (recipient's) phone firmware.

Gammu tries to give solution for some issues connected with translating chars between phone and computer. If you copy text into SMS:

all chars are internally converted into Unicode:
- if they were given using standard input, there are used operating system functions (you need to have correctly set national support for Greek chars to have Greek chars conversion, etc.)
- if you gave Unicode coded file to Gammu, chars from it are simply copied
if SMS will use:
- GSM Default Alphabet, Gammu will:
  - check, if some Unicode chars can be saved in GSM Default Alphabet using two chars only and will create such sequences (it's done for ^ { } \ [ ] ~ | ? chars)
  - put all chars available in GSM Default Alphabet into SMS
  - try to save into SMS all other national chars (with dashes, dots, double dots, etc.) after replacing them with Latin
  - use "?" for all other chars
- Unicode, Gammu will copy all chars into SMS

TIP: You can create Unicode file using WordPad in Win32 (during saving select "Unicode Text Document" format). In Unix can use for example YUdit.

TIP: when use ~ char in sms text and Unicode coding, text of sms after ~ char will blink in some DCT3 phones (like Nokia 3310)

[edit] Chinese SMS

If I understand correctly, they're saved with Unicode alphabet in SMS. Gammu is prepared for it. For example for sending/saving SMS just create Unicode file and use switch -inputunicode, when use send/savesms

[edit] SMS folders and locations

When you use SMS folder 0, SMS location is given from "flat" memory (all sms from all folders have unique numbers). It's sometimes emulated by Gammu. You can use it with all phones.

When give folder 1, 2, etc. SMS are taken from Inbox, Outbox, etc. and each SMS has unique number in his folder. Name of folders can depend on your phone (the most often 1="Inbox", 2="Outbox", etc.). This method is not supported by all phones (for example, not supported by Nokia 3310, 5110, 6110). If work with your phone, use --getsmsfolders to get folders list.

Phone	Folder	Memory
AT	1="Inbox",2="Outbox"	SIM
AT	3="Inbox",4="Outbox"	Phone
DCT3 without own SMS memory	1="Inbox", 2="Outbox"	SIM
DCT3 with own SMS memory (7110, 6210)	1="Inbox"	SIM, when Read, UnRead
	1="Inbox"	Phone, when Sent, UnSent
	2="Outbox"	SIM, when Sent, UnSent
	2="Outbox"	Phone, when Read, UnRead
	3="Archive",...	Phone
DCT4 and Series 40 1.0/2.0 phones with own SMS memory	1="Inbox",2="Outbox"	SIM
DCT4 and Series 40 1.0/2.0 phones with own SMS memory	3="Inbox",4="Outbox",...	Phone

[edit] Commands to get messages from phone

--getsmsfolders

Get list of SMS folders in phone and SIM.

--getsms folder start [stop]

Get SMS from specified locations. Option display SMS location like available in folder 0.

--getallsms

Get all possible SMS from phone and SIM. Each SMS is displayed just after getting from device (because of it please don't expect correct displaying linked SMS or EMS sequences). Option display SMS location like available in folder 0.

--geteachsms

Get all possible SMS from phone and SIM. Option get all of them, tries to find sequences (and link them) and display final content (texts, ringtones, bitmaps, etc.) to user. Option display SMS location like available in folder 0.

[edit] Commands to delete messages from phone

--deletesms folder start [stop]

--deleteallsms folder

[edit] Commands to send messages/save messages to phone

General format for sending messages is easy:

--sendsms SMSFORMAT destination options_specific_for_sms_format [switches_specific_for_sms_format] [switches_specific_for_sending_sms]

where:

instead of SMSFORMAT you should put selected by you SMS format (they're descibed later)
destination - recipient's phone number
options_specific_for_sms_format - some parameters required for used SMSFORMAT
switches_specific_for_sms_format - optional switches available for used SMSFORMAT
switches_specific_for_sending_sms - optional switches available for --sendsms:
- -report - add requests for delivery report (it's the most often offered by cellular network operators for free and allows to check, if SMS were received by recipients' phone. Please note, that receiving such report doesn't mean, that SMS was READ on recipients' phone)
- -validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX - set SMS validity. Default it's taken from SMSC settings (set 1 on SIM card or other specified by -smscset)
- -save [-folder number] -
- -smscset number - SMSC and validity settings will be taken from set number on SIM card. If not specified, there will be used set 1.
- -smscnumber number - SMSC number. If not specified, SMSC number is taken from set 1 on SIM card or specified by -smscset.
- -reply - when used, you allow recipient to answer on SMS using your SMSC. The most often you will pay for his SMS then.
- -maxsms num - Gammu will take such part of SMS text, which can be saved in maximally num SMS

Similiary it's possible to save sms:

--savesms SMSFORMAT options_specific_for_sms_format [switches_specific_for_sms_format] [switches_specific_for_saving_sms]

where switches_specific_for_saving_sms:

-folder id - save to specified folder. Numerate folders from 1. The most often folder 1 = "Inbox", 2 = "Outbox",etc. Use --getsmsfolders to get folder list.
-unread - makes message unread. In some phones (like 6210) you won't see unread sms envelope after saving such sms. In some phones with internal SMS memory (like 6210) after using it with folder 1 SIM SMS memory will be used.
-read - makes message read. In some phones with internal SMS memory (like 6210) after using it with folder 1 SIM SMS memory will be used.
-unsent - makes message unsent.
-sent - makes message sent.
-sender number - set sender number (default: "Gammu")
-smscset number - SMSC number will be taken from set number on SIM card. If not specified, there will be used set 1.
-smscnumber number - SMSC number. If not specified, SMSC number is taken from set 1 on SIM card or specified by -smscset.
-reply - this will set indicator, that SMS sender allowed recipient to answer on SMS using his SMSC.
-maxsms num - Gammu will take such part of SMS text, which can be saved in maximally num SMS
-smsname name - SMS will be saved with specified name (used instead of name proposed by Gammu)

For each saved SMS there is displayed info about folder. Location is given like in SMS folder "0".

Now we will describe available SMSFORMATs:

format TEXT

Used for single/linked text SMS. Gammu reads SMS text, format according to used command line switches and send/save.

--sendsms TEXT destination [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-inputunicode] [-16bit] [-flash] [-len len] [-autolen len] [-unicode] [-enablevoice] [-disablevoice] [-enablefax] [-disablefax] [-enableemail] [-disableemail] [-voidsms] [-replacemessages ID] [-replacefile file]

--savesms TEXT [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-smsname name] [-inputunicode] [-16bit] [-flash] [-len len] [-autolen len] [-unicode] [-enablevoice] [-disablevoice] [-enablefax] [-disablefax] [-enableemail] [-disableemail] [-voidsms] [-replacemessages ID] [-replacefile file]

Switches specific for this option:

-inputunicode - input text is in Unicode.
-16bit - Gammu uses SMS headers with 16-bit numbers for saving linking info in SMS (it means less chars available for user in each SMS)
-flash - SMS will use Class 0 (should be displayed after receiving on recipients' phone display after receiving without entering Inbox)
-len len - specify, how many chars will be read. When use this option and text will be longer than 1 SMS, will be splitted into more linked SMS
-autolen len - specify, how many chars will be read. When use this option and text will be longer than 1 SMS, will be splitted into more linked SMS. Coding type (SMS default alphabet/Unicode) is set according to input text.
-unicode - SMS will be saved in Unicode format
-enablevoice, -disablevoice, -enablefax, -disablefax, -enableemail, -disableemail - SMS for setting voice mail, email or fax on phone display
-voidsms - many phones after receiving it won't display anything, only beep, vibrate or turn on light. Text will be cut to 1 sms.
-replacemessages ID - ID can be 1..7. When you will use option and send more single SMS to one recipient with the same ID, each another SMS will replace each previous with the same ID
-replacefile file - when you want, you can make file in such format: src_unicode_char1,dest_unicode_char1, src_unicode_char2,dest_unicode_char2 (everything in one line). After reading text for SMS from stdin there will be made translation and each src char will be converted to dest char. In docs there is example file (replace.txt), which will change all "a" chars to "1"

Example usages:

echo "I hate mondays" | gammu --savesms TEXT

saves SMS with text "I hate mondays"

gammu --savesms TEXT -maxlen 40 < file.txt

get maximally 40 chars from text file and save them into text sms

TIP: you can use format EMS with -text switch to have the same effect too.

format EMS

Used for EMS sequences. Please note, that currently bitmaps, ringtones, text formatting compatible with this standard it's not supported by Nokia phones and don't expect it there.

--sendsms EMS destination [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-unicode] [-16bit] [-format lcrasbiut] [-text text] [-unicodefiletext file] [-defsound ID] [-defanimation ID] [-tone10 file] [-tone10long file] [-tone12 file] [-tone12long file] [-toneSE file] [-toneSElong file] [-fixedbitmap file] [-variablebitmap file] [-variablebitmaplong file] [-animation frames file1 ...] [-protected number]

--savesms EMS [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-smsname name] [-unicode] [-16bit] [-format lcrasbiut] [-text text] [-unicodefiletext file] [-defsound ID] [-defanimation ID] [-tone10 file] [-tone10long file] [-tone12 file] [-tone12long file] [-toneSE file] [-toneSElong file] [-fixedbitmap file] [-variablebitmap file] [-variablebitmaplong file] [-animation frames file1 ...] [-protected number]

Switches specific for this option:

-unicode - all texts will be coded using Unicode
-16bit - Gammu uses SMS headers with 16-bit numbers for saving linking info in SMS (it means less chars available for user in each SMS)
-format lcrasbiut - last text will be formatted. You can use combinations of chars:
- l - left aligned
- c - centered
- r - right aligned
- a - large font
- s - small font
- b - bold font
- i - italic font
- u - underlined font
- t - ~~strikethrough~~ font
-text text - add text as sequence part
-unicodefiletext file - read text from Unicode file and add as sequence part
-defsound ID - adds default sound with ID specified by user as sequence part. ID for different phones are different.
-defanimation ID - adds default animation with ID specified by user as sequence part. ID for different phones are different.
-tone10 file - add IMelody version 1.0 read from RTTL or other compatible file
-tone10long file - add IMelody version 1.0 saved in one of few SMS with UPI. Phones compatible with UPI (like SonyEricsson phones) will read such ringtone as one
-tone12 file - add IMelody version 1.2 read from RTTL or other compatible file
-tone12long file - add IMelody version 1.0 saved in one of few SMS with UPI. Phones compatible with UPI (like SonyEricsson phones) will read such ringtone as one
-toneSE file - add IMelody in "short" form supported by SonyEricsson phones
-toneSElong file - add SonyEricsson IMelody saved in one or few SMS with UPI
-fixedbitmap file - add bitmap read from 2 colors bitmap file (BMP, NOL, NGG,...). It's saved in 16x16 or 32x32 size.
-variablebitmap file - add bitmap read from 2 colors bitmap file (BMP, NOL, NGG,...). It's saved in original size in one SMS.
-variablebitmaplong file - add bitmap read from 2 colors bitmap file (BMP, NOL, NGG,...). It's saved as bitmap with original size (but there is maximal size limit equal 96x128) saved in one or few sms.
-animation frames file1 ... - adds "frames" frames read from file1, file2, etc.
-protected number - number of ringtones and bitmaps after this parameter (excluding default ringtones and logos) will be "protected" (in phones compatible with ODI like SonyEricsson products it won't be possible to forward them from phone menu). It's kind of DRM.

All switches after "-16bit" (like "-defsound") can be used few times (they're connected with sequence parts).

Example usages:

gammu --savesms EMS -text "I hate mondays"

will save simple SMS with text "I hate mondays"

gammu --savesms EMS -text "Greetings" -defsound 1 -text "from Gammu"
-tone10 axelf.txt -animation 2 file1.bmp file2.bmp

will save EMS sequence with text "Greetings", default sound 1, text "from Gammu", ringtone axelf.txt and 2 frames animation read from (1'st frame) file1.bmp and (2'nd frame) file2.bmp

gammu --savesms EMS -protected 2 -variablebitmaplong ala.bmp
-toneSElong axelf.txt -toneSE ring.txt

ala.bmp and axelf.txt will be "protected"

format RINGTONE

Used for ringtones in Smart Messaging format.

--savesms RINGTONE file [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-smsname name]

Switches specific for this option:

-long - ringtone is saved using Profile style. It can be longer (and saved in 2 SMS), but decoded only by newer phones (like Nokia 3310)
-scale - ringtone will have Scale info for each note. It will allow to edit it correctly later in phone composer (for example, in Nokia 3310)

format OPERATOR

Read bitmap from 2 colors file (bmp, nlm, nsl, ngg, nol, wbmp, etc.), format into operator logo in Smart Messaging format (72x14 or 78x21, 2 colors) and send/save over SMS.

Please note, that it isn't designed for colour logos available for example in DCT4/TIKU - you need to put bitmap file there inside phone using filesystem commands.

--savesms OPERATOR file [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-smsname name] [-netcode netcode] [-biglogo]

Switches specific for this option:

-netcode netcode -
-biglogo - there will be used 78x21 size instead of 72x14 (bigger size is supported by Nokia 6210, 7110 and so on)

format CALLER

Read bitmap from 2 colors file (bmp, nlm, nsl, ngg, nol, wbmp, etc.), format into caller group logo in Smart Messaging format (72x14, 2 colors) and send/save over SMS.

Please note, that it isn't designed for colour logos available for example in DCT4/TIKU - you need to put bitmap file there inside phone using filesystem commands.

--savesms CALLER file [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-smsname name]

format PROFILE

Read ringtone (RTTL) format, bitmap (Picture Image size) and name, format into Smart Messaging profile and send/save as SMS. Please note, that this format is abandomed by Nokia and supported by some (older) devices only like Nokia 3310.

--savesms PROFILE [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-smsname name] [-name name] [-bitmap bitmap] [-ringtone ringtone]

Switches specific for this option:

-name name -
-bitmap bitmap -
-ringtone ringtone -

format PICTURE

Read bitmap from 2 colors file (bmp, nlm, nsl, ngg, nol, wbmp, etc.), format into bitmap in Smart Messaging (72x28, 2 colors, called often Picture Image and saved with text) or Alcatel format and send/save over SMS.

--savesms PICTURE file [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-smsname name] [-text text] [-unicode] [-alcatelbmmi]

Switches specific for this option:

-text text -
-unicode -
-alcatelbmmi -

format ANIMATION

--savesms ANIMATION frames file1 file2... [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-smsname name]

format SMSTEMPLATE

--sendsms SMSTEMPLATE destination [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-unicode] [-text text] [-unicodefiletext file] [-defsound ID] [-defanimation ID] [-tone10 file] [-tone10long file] [-tone12 file] [-tone12long file] [-toneSE file] [-toneSElong file] [-variablebitmap file] [-variablebitmaplong file] [-animation frames file1 ...]

--savesms SMSTEMPLATE [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-smsname name] [-unicode] [-text text] [-unicodefiletext file] [-defsound ID] [-defanimation ID] [-tone10 file] [-tone10long file] [-tone12 file] [-tone12long file] [-toneSE file] [-toneSElong file] [-variablebitmap file] [-variablebitmaplong file] [-animation frames file1 ...]

format MMSINDICATOR

--savesms MMSINDICATOR URL Title Sender [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-smsname name]

format WAPINDICATOR

--savesms WAPINDICATOR URL Title [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-smsname name]

format BOOKMARK

--savesms BOOKMARK file location [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-smsname name]

Read WAP bookmark from file created by --backup option and saves in SMS.

format WAPSETTINGS

--savesms WAPSETTINGS file location DATA|GPRS [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-smsname name]

Read WAP settings from file created by --backup option and saves in SMS.

format MMSSETTINGS

--savesms MMSSETTINGS file location [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-smsname name]

format CALENDAR

--savesms CALENDAR file location [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-smsname name]

Read calendar note from file created by --backup option and saves in VCALENDAR 1.0 format.

format TODO

Read todo from file created by --backup option and send/save using SMS.

--savesms TODO file location [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-smsname name]

format VCARD10|VCARD21

Read phonebook entry from file created by --backup option and saves in VCARD 1.0 (only name and default number) or VCARD 2.1 (all entry details with all numbers, text and name) format.

--savesms VCARD10|VCARD21 file SM|ME location [-nokia] [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-smsname name]

[edit] Other commands

Command line options for SMS daemon (SMSD) are described in SMSD manual. Other are:

--displaysms ... (options like in sendsms)

--addsmsfolder name

--getsmsc start [stop]

Get specified SMS Center(s) info from SIM card (number, name and so on) and phone memory.

--backupsms file

Backup option for SMS.

--restoresms file

Restore option for SMS.

--addsms folder file

Add SMS from backup file into specified SMS folder.

--nokiagett9

This option should display T9 dictionary content from DCT4 phones.

Gammu:SMS commands

From Gammu.org Wiki

Contents

[edit] SMS and EMS

[edit] Introduction to SMS formats

[edit] Encoding chars in SMS text

[edit] Chinese SMS

[edit] SMS folders and locations

[edit] Commands to get messages from phone

[edit] Commands to delete messages from phone

[edit] Commands to send messages/save messages to phone

[edit] Other commands

Views

Personal tools

Projects

Links

wiki

Search

Toolbox