Documentation  |   Table of Contents   |  < Previous   |  Next >   |  Index

A    Log and Database Files

Virtual Phone Guide

Palm OS® Developer Suite

     

This appendix covers the files that Virtual Phone uses:

Configuration Files ^TOP^

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 ^TOP^

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 

Section Name

Corresponding Services

CFG

Configuration

INF

Phone Information

SPC

Speech Call

POW

Power

NWK

Network

PHB

Phone Book

STY

Security

SMS

Short Message

TCP

TCP

Serial

Serial

ReadThread

Active connection (either TCP or Serial)

Disp

Error Reply Parameters

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 Phone Win
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
FR2Id=1
FE2Id=0
...

Available Network File - AvailableNwk.db ^TOP^

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 Phone 1
The network's long name
SName=VPCom 1
The network's short name
Stat=2
The network's state
[2]
Id=5051
LName=Virtual Phone 2
SName=VPCom 2
Stat=2

Phone Book Databases ^TOP^

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 ^TOP^

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.

The basic structure is:

[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.

SubId:
Submit message identifier
DlvReq:
Network Delivery Request
DupReq:
Reject Duplicate Request

Log File ^TOP^

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