FAQ-1152 How do I configure the UIQ 2.1 emulator to send an SMS message using a GSM phone connected via serial cable?


FAQ-1152 How do I configure the UIQ 2.1 emulator to send an SMS message using a GSM phone connected via serial cable?

» Symbian OS » Developer Knowledgebase » FAQ-1152

Classification:	General	Category:	Emulator
Created:	10/11/2004	Modified:	10/13/2004
Number:	FAQ-1152
Platform:	Symbian OS v7.0

Question:
How do I configure the UIQ 2.1 emulator to send an SMS message using a GSM phone connected via serial cable?

Answer:
You will need a suitable phone* connected to the host PC's serial COM port via a serial cable.

First make a backup copy of your Cdbv3.dat file located in

\epoc32\wins\c\system\data\

directory. Cdbv3.dat is a binary file holding the comms database settings. We can get an ASCII text configuration file from Cdbv3.dat by running the CEDDUMP.EXE utility. This produces the configuration file cedout.cfg located in the \epoc32\wins\c\directory

The comms database contains a set of Modem Configuration tables, including a table for serial cable connection (an extract of which is listed below)

# COMMDB_ID = 5
Name=GSM Mobile Phone via Serial
PortName=COMM::0
TSYName=MM
CSYName=ECUART
DataBits=8
…
END_ADD

The default setting is

PortName=COMM::0

which maps to your PC's COM1 port. Edit this as appropriate (eg COMM::1 represents your PC's COM2 port etc).

To get the emulator to use these modem settings we need to set the

ModemForDataAndFax=5
ModemForPhoneServicesAndSMS=5

fields in the Global Settings table to CommDB_ID of the relevant Modem Configuration table (5 in this case). For example

############################################################
## GlobalSettings
##
[GlobalSettings]
ADD_SECTION
RedialAttempts=3
SmsBearer=2
SmsReceiveMode=2
GPRSAttachMode=1
AcceptIncomingGprs=0
GPRSClassCBearer=GPRS
ConnectionAttempts=2
ModemForDataAndFax=5
ModemForPhoneServicesAndSMS=5
LocationForDataAndFax=3
LocationForPhoneServicesAndSMS=3
FIELD_COUNT=11
END_ADD

Now save the amended cedout.cfg file.
We generate a new comms database Cdbv3.dat file by running the CED utility located in the \epoc32\release\wins\udeb\ directory

ced -i cedout.cfg

The emulator comms database is now configured to send SMS via a phone connected via serial cable. Note when you first run the emulator you may be asked to configure a SMS service centre in the emulator Control Panel (Control Panel -> Connections -> Messaging Accounts -> SMS). Enter any value, it doesn't matter as the SMS service centre on your phone will be used to send the SMS (this, of course, must be configured correctly!). Your emulator should now be configured to send SMS messages created from C++, PersonalJava/JavaPhone or J2ME MIDP applications.

*phones tested include

Ericsson SH888
Ericsson I888
Ericsson R320s
Ericsson R520m
Ericsson T39m