GSMtool dials a number stored in the Pilot's Address Book or synchronizes
the Pilot's Address Book numbers with a mobile phone.
GSMtool sends and receives SMS messages.
Communication is done via the Pilot's serial interface.
If an infrared IrDA driver is active, communication is possible with phones
which support IrDA infrared standard.
No special protocol is used. The program uses GSM AT-command extensions.
Therefore it is possible, but not tested that the software runs with other
phones than the Ericsson x888 or any Ericsson 6xx or 7xx family phone with
attached GSMtool infrared modem.
This software is Shareware at $20. Please register at
For support, mail to email@example.com.
No liability for damage. Use at your own risk.
Palm III with OS upgrade 3.02 and Enhanced Infrared driver, both from
www.3com.com are required or Palm V with SerIrCommLib.prc and SerialIrPnl.prc,
which is part of the same Enhanced Infrared driver package or Palm with OS
3.3 and Infrared connector.
There is no need to activate the infrared driver before starting GSMtool
in the Pilot's preferences application. The first time the software starts,
it comes up with the preferences dialog. Later it will always go directly
to the dial menu.
If a number either in the mobile or in the Pilot does not start with + or
00, this string is prepended for the use of - matching (see if number in
mobile is already stored in Pilot)
- storing new numbers in either the mobile or in the Pilot.
Default is +49 (Germany).
Pilot area code
Same usage as for country code, but used if a number in the Pilot does not
start with +, 0 or 00. If you don't set this option, also don't set the country
Default is 0241 (Aachen).
Mobile area code
Same usage as for country code, but used if a number in the mobile does not
start with +, 0 or 00. If you don't set this option, also don't set the country
Default is 0172 (Mannesmann D2 operator).
Keep 0 of area code
If the country codes needs to be prepended, then this flag determines if
a leading 0 from the area code is kept. Normally the 0 is removed, but in
Italy the 0 is still part of an international number, e.g. Rom is +39 06
Default is not checked = 0 will be removed.
When assembling the name to be stored in the mobile phone, you can choose
the order in which they are concatenated, the maximum number of characters
for this part and the separator between the parts. For example, if you have
a display which displays only the first 9 characters of a phone book entry
(e.g. Ericsson 788 or 768), and you don't care about the title and you don't
care about the company and you don't want any separators between the parts
but you want the Field Code (e.g. M for a mobile phone number) appended,
then the display should look e.g. like this:
1 First name 5
2 Last name 3
3 Title 0
4 Company 0
5 Field Code 1
The GSMtool program tries first to use your definition. It then calculates
the maximum length that your definition can lead to and compares if the assembled
name has used up the theoretical length. If not, it increases temporary
internally all lengths which are not defined as 0.
If this would lead to an empty entry, e.g. in the example above, if the entry
would contain no first or last name, then, the 0 length definition is no
longer regarded, and those fields are taken into account, too. This is not
true for the field code, which is never included if defined as 0.
The sum of all field lengths plus the number of separators are internally
calculated as the maximum number of characters you want an entry to be in
the phone or on the SIM card. In the example above, it is 9 characters since
5+3+0+0+1 and the separaters are empty. If you choose this sum to be too
high, this may lead to the error:
"ERROR received instead of OK ..." when writing to some phones, e.g. to the
Siemens S25. Other phones may just clip the entry at its end and not throw
an error. There is no golden rule for the length as there are many different
SIM cards around. A reasonable size is 16 characters.
There is an AT command to question the maximum length, but on some phones,
junk is returned, e.g. "8", though they could take 24 characters. Also, most
phones show only part of an entry when looking/scrolling the name list. This
is usually determining the max length you want since otherwise you cannot
distinguish the entries during a search.
Therefore I have decided to let you set the length. Unfortunately, I let
you only define one length despite the fact that the phone and the SIM card
usually can store different max. lengths. The reason is mentioned already
above: The scrolling limitation is the same for both storages.
When the numbers are transferred to the mobile, the names can get a single
capital letter appended which tells you later from which field of the Pilot
address book the number was taken from (The Field Code). There are 8 letters
for the fields in the order:
Default is WHFOEMPM.
SMS Mail Gateway
Normally, an SMS is sent to another mobile. In this case you send the number
to a mobile phone extension. But, there are special SMS extension numbers
which are not mobile phones but Gateways. One example is an SMS-to-email
gateway. You send an SMS to the Gateway and the Gateway forwards the text
as an email to the receiver. To relieve you from the work to insert the Gateway
number every time you want to send an email, GSMtool has coupled the insertion
of the Gateway number to the "Ins E-mail" button press. If the To: field
is still empty, it will insert the number from this preference. In Germany's
D2 net the number is 3400.
Fax Number Prefix
One other way to address a Gateway, e.g. a Fax Gateway, is to use a special
prefix in front of the fax number. In Germany's D2 net, this is done by prefixing
the number with a "99". Unfortunately, the "+" sign is not accepted behind
this "99" tag. So what GSMtool does is: remove the "+" of a number if it
finds one and replaces it with 00. The 00 is currently not configurable,
let me know if an option is needed for this. You can still correct the number
before sending the SMS.
(Note: In Germany's D2 net, one Fax costs DM 1.99=$1)
Fax Text Prefix
If there is no number prefix for faxes, the SMS gateway has to know in another
way that the SMS should be sent as a Fax. In Switzerland, this is done by
starting the SMS text content with *FAX#. You can enter this in this preference
field. For Germany this field stays empty - the tagging is done by a number
Mail Text Prefix
For some SMS-to-email Gateways, the SMS has to start with a certain tag.
In Switzerland, this is done by starting the SMS text content with MAIL.
You can enter this in this preference field. For Germany SMS
Non Ericsson phones need the SMS center to be transmitted before every SMS.
I currently don't use this entry for Ericsson phones. In the future, I will
send a separate AT command to transfer it into Ericsson phones. The SMS Center
is preset to the one from Germany's D2 network. You must change this entry
to the SMS center of your network (otherwise, you will get CMS Error 300
if forbidden by the network, or you will be charged more for sending the
SMS, since the SMS is sent via the foreign D2 SMS center)!
Please note that you must tap the NUMBER and not the NAME to copy the number
from the lookup list to the dial field. Tapping the name will bring you to
the phone book application, just for convenience in case you want to edit
Sync Address Book
In Step 1, duplicate entries in the Mobile are detected and produce a warning
In step 3, the names, the numbers and two additional columns are shown of
which the left one is for the SIM card location and the right one is for
the phone book location. If you want a number to go into the SIM card, tap
on the SIM column. The short dial number is shown with an underline indicating
a new entry. Duplicate entries in the Pilot are shown framed. If you tap
on an existing short dial number, the number disappears, meaning that it
will be deleted in the mobile phone. The two numbers on the bottom "SIM"
and "Phone" tell you how full the phone book is. The missing number tells
you how many numbers stored in your Pilot are not yet in the mobile phone.
A warning will come up if either phone book is full. Then try the other column.
Below each of the two columns with the short dial numbers, there is a button
"All" and "0". If you press "0", all numbers in the currently selected category
and column will be marked for deletion in the mobile phone (short dial number
dissappears). If you press "All", the whole category will be marked for download
into the mobile phone. If the memory/SIM of the mobile phone is full, a warning
will pop up. You can then try the other "All" button for the remaining ones.
Please note that when you have already added some numbers in step 3, and
then change the preferences on the fly, only newly added numbers will be
affected by the new settings.
If you tap on the name, or, if the name has multiple entries, on the empty
field to the left of the number, you can edit the mobile phone entry. This
can be done for new as well as for existing entries. If the number is not
yet marked to be transfered to the phone (both columns to the right of the
number are empty), taping on the name does not trigger the edit dialog.
If you tap on the number, you can edit the number similar to above.
The FAQ is available on this
If you have a communication error and then, instead of aborting the operation
within GSMtool, try to run another application, the Pilot will start to loop
running into the same communication error over and over again which will
need a hard reset. No data will be lost.
Bug in the Ericsson SH888:
If you use my dial feature, the 888 dials correctly, but if you use the 888's
redial feature (pressing twice "yes"), the 888 forgets to send the "+". So
either don't use the redial or change the "+", before you dial, to the
international access number (in most countries: 00). I will put the international
access code into the preferences in a future version.
It is not possible to access the SIM card on Motorola Triband.
Problem will be fixed soon.
The Nokia 8810 can hang after the usage wit GSMtool (needs battery removal).
This is a Nokia bug. I send the correct commands. Hopefully, Nokia will fix
Version 1.02 99-11-05
- solved severe problems which occured with old OS
(The serial line was not closed on exit of the program, causing e.g. error
778) This problem did not occur on new OS3.3. I am sorry, but I don't have
two Pilots and therefore tested only on OS3.3.
Version 1.01 99-11-04
- solved Error #774 problem with some mobile phone models (e.g. S25)
Since 15 users have already registered the software, I felt confident, that
more will register and I immediately went out and bought an S25 (costing
as much as 22 registrations), tracked down the error and fixed it within
Thanks again to the persons reporting the problem and thanks to those who
helped to fix it by registering.
Version 1.00 99-11-01
- application renamed from DI27 (version 1.62) to GSMtool
- support for Pilot OS 3.3
- the new features (SMS Mailbox) is currently blocked until fully tested.
Since there were many requests for OS 3.3 support, I released this intermediate
version on the way to implement all the wishes from the DI27 wish list.
GSM error codes:
after SMS send:
+CMS Error 300:
Problem in the network, try other operator or change SMS Center.