This appendix covers the files that Virtual Phone uses:
Configuration Files
If the two configuration files are not found in the current directory upon execution, Virtual Phone generates them with the default values. These files, their structure, and their records are described below.
Application Configuration File - VPAppCfg.db
The configuration file, VPAppCfg.db, stores data relevant to Virtual Phone's Services and their configuration The file is divided into 12 sections, listed in Table A.1.
Table A.1 VPAppCfg.dlg File Sections
The following list contains the Service Name and all the variable names associated to the service and the variable default value.
VPAppCfg.db
-
[CFG]
- Configuration Service
-
SmsCenter=+336534985
- SMS Center Number
-
PhNum=+336558986
- Virtual Phone's number
-
[INF]
- Information Service
-
Brand=
Virtual PhoneWin
- Virtual Phone's Brand Name
-
Model=3210
- Virtual Phone's Model
-
Revision=354815
- Virtual Phone's Revision number
-
[SPC]
- Speech Call Service
-
EmcNum=112
- The emergency call number
-
[POW]
- Power Service
-
Level=75
- Battery power level
-
Status=0
- Battery status
-
[NWK]
- Network Service
-
SigLev=15
- Signal Level
-
CellId=AD
- Cell Id
-
AreaCd=BC
- Area Code
-
SearchMd=1
- Search mode
-
RegStat=1
- Registration state
-
[PHB]
- Phone Book Service
-
NumBooks=4
- Number of phone books (Max=4)
-
SelBook=0
- Selected phone book
-
MaxEntries=100
- Maximum number of entry slots
-
MaxNameLen=10
- Maximum name length
-
[STY]
- Security Service
-
State=0
- security state
-
Pin=0000
- Pin Code
-
Pin2=0000
- PIN2 Code
-
Puk=0000
- PUK Code
-
Puk2=0000
- PUK2 Code
-
Phone=0000
- Phone Code
-
[SMS]
- Short Message Service
-
MaxEntries=100
- Maximum number of message slots
-
RecSent=0
- Receive sent messages
-
NDelId=2
- Next delivery message id
-
NSubId=2
- Next submit message id
-
[TCP]
- TCP Connection
-
Port=6416
- Port number
-
[Serial]
- Serial Connection
-
Port=COM2
- Port to open
-
BaudRate=19200
- Baud rate
-
StopBit=1
- Number of stop bits
-
Parity=None
- Parity
-
FlowCtl=None
- Flow control
-
DataBit=8
- Data bit
-
[ReadThread]
- Connection to use
-
ConType=1
- Serial/TCP
-
[Disp]
- Reply Parameters
-
FR0Id=1
- Response type: According to VP state/Error
-
FE0Id=0
- Error number
Available Network File - AvailableNwk.db
The Available Network file, AvailableNwk.db
, lists the networks available to Virtual Phone. You can modify, add and delete networks using an ASCII text editor (for example, Notepad
). Remember to change the Num
key so that it corresponds to the number of networks that you want Virtual Phone to take into account.
The Section Numbers must be consecutive.
AvailableNwk.db
-
[NWK]
-
Num=1
- The number of available networks.
-
[1]
- Section Number
-
Id=5001
- The network's Id
-
LName=
Virtual Phone1
- The network's long name
-
SName=VPCom 1
- The network's short name
-
Stat=2
- The network's state
Phone Book Databases
You can use the Service Configuration's Phone Books tab to modify Virtual Phone phone book databases. See "Phone Books Tab" for more information.
You can also modify phone books manually using an ASCII text editor. The Last Dialed Phone Book automatically contains the last dialed phone number and any changes to this file will be overridden by Virtual Phone when it dials a number.
See "Phone Book Files" for a list of all of the phone books supported.
Phone Book Database Organization
Phone book databases are organized as follows:
-
[1]
- Index of entry
-
Name= John
- Name
-
Tel=+33662685921
- Phone Number
-
[3]
-
Name= David
-
Tel=+49656654654
-
[4]
-
Name= Marc
-
Tel=045687654
SMS Files
The SMS (Short Message Services) files, SmsStore.db
and SmsStoreSend.db
, are generated by Virtual Phone. They both have the same basic structure and contain all the SMS exchanged between Virtual Phone and the Palm OS Simulator. The difference between the two files are the Delivery and Submit specific data elements.
The values associated to a data elements are valid for version 1.0 of Virtual Phone.
-
[1]
- Message Identifier
-
State=0
- Represents the state of the message in Virtual Phone and should not be modified.
-
0 = Received unread message (i.e. new message)
-
1 = Received and read message
-
2 = Stored unsent message (only applicable to SMS)
-
3 = Stored sent message (only applicable to SMS)
-
4 = All messages (only applicable to +CMGL command)
-
5 = All messages (only applicable to +CMGL command)
- Do not change a Received message to a Sent message or visa versa. Never use states 4 and 5.
-
DataSize=8
- The length of the Message Text
-
Data=656461717364617A4D
- The Message Text, in hexadecimal followed by a check sum.
-
DCS=5
- Data Coding Scheme. Values are:
- 8 Bits Encoding = 0
- Default GSM Encoding = 5
-
PCount=0
- Multi Part Options: Count
-
PCurr=0
- Multi Part Options: Current
-
PId=0
- Multi Part Options: Part Id
-
DtTimAbs=1
- If DtTimAbs = 1 (absolute time) the date and time are absolute. If DtTimAbs = 0 the date and time are relative.
-
DtTim=3063866010
- The date and time are in palm format
-
Add=+33658214566
- The address of the SMS message
-
ProtocolId=0
- Protocol ID. Values are:
-
Default Protocol = 0
-
Fax Protocol = 1
-
X400 Protocol = 2
-
Paging Protocol = 3
-
Email Protocol = 4
-
Ermes Protocol = 5
-
Voice Protocol = 6
-
ReplyPath=0
- Reply Path. Values are: 1 = true or 0= false
-
SCeneter=+33668547854
- Service Center number
SmsStore.db File
The following description is valid for the SmsStore.db
file and are specific to SMS Delivery.
-
MsgIdentifier=1
- Delivery Message Identifier
-
OthToRcv=0
- Other To Receive: values1 = true or 0= false
-
RepDelivInd=0
- Report Delivery Indicator: Currently not supported
SmsStoreSend.db File
The following description is valid for the SmsStoreSend.db
file and are specific to SMS Submit.
Log File
The log file, VPAppATLog.log
, is generated by Virtual Phone. It contains all the exchanged AT commands and responses between Virtual Phone and Palm OS Simulator.
The following is an example of what the log may look like.
VPAppATLog.log
AT OK AT+CPMS=? +CPMS: ("SM") OK AT+CPMS="SM" +CPMS: 1,100 OK AT+CPMS? +CPMS: "SM",1,100,"SM",1,100,"SM",1,100