Readme


Application Description

System Requirements

User Guide

FAQ

Known Bugs

Release Notes







Application Description

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
http://www2.viaweb.com/pilotgearsw/marren.html
Thank you.
For support, mail to m.r@mail.com.
No liability for damage. Use at your own risk.


System Requirements

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.


User Guide

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.

Sync Preferences
country code
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)
- dialing
- 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 code.
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 code.
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 xxx.
Default is not checked = 0 will be removed.
Position
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.
Note:
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.
Field Codes
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:
work,home,fax,other,email,main,pager,mobile
Default is WHFOEMPM.

SMS Preferences
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 prefix.
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 Center
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)!

Dial
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 it.

Sync Address Book
Notes:
In Step 1, duplicate entries in the Mobile are detected and produce a warning message.
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.

FAQ
The FAQ is available on this page.

Known Bugs
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 this soon.

Release notes:
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 an hour.
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.