Symbian
Symbian Developer Library

SYMBIAN OS V9.4

Feedback

[Index] [Previous] [Next]

Setting up the Comms Database for RAS

The RAS settings for Symbian OS are stored in its communications database. This database is used both in the emulator and real devices.

The database is made up of a number of tables. Several tables are required to connect the emulator to the Internet. They are described below.

The CED and CEDDUMP tools should be used to securely modify comms database entries; see Comms database configuration tools.

[Top]

Modem Bearer table

The Modem Bearer table contains information about modems and physical connections to networks. The start of the modem bearer table is indicated by the text [ModemBearer]. Below this there will be a number of connections. One may be suitable for the emulator. If not, add a new connection in a new ADD_SECTION...END_SECTION section.

  1. Set the Agent and IfName fields to csd.agt and PPP respectively.

  2. Set PortName to a suitable COM port. For COM 1, set PortName to COMM::0. This is shown in the example file below. For COM 2 use COMM::1, for COM 3 use COMM::2 etc.

  3. The Last[SocketActivity|SessionClosed|SocketClosed]Timeout fields store the auto-disconnect timeout values. Disable these by setting the fields to – 1.

  4. The remaining fields can use the values in the example below.

ADD_SECTION
    Name=Null Modem 115200bps
    Agent=CSD.agt
    IfName=PPP
    PortName=COMM::0
    TSYName=MM
    CSYName=ECUART
    DataBits=8
    StopBits=1
    Parity=NONE
    Rate=115200
    Handshaking=52
    SpecialRate=0
    XonChar=0
    XoffChar=0
    FaxClassPref=AUTO
    SpeakerPref=NEVER
    ModemInitString=AT
    DataInitString=AT
    FaxInitString=AT
    DialPauseLength=S8=
    SpeakerVolPref=QUIET
    SpeakerVolContorlLow=L0
    SpeakerVolControlMedium=L1
    SpeakerVolControlHigh=L2
    SpeakerAlwaysOff=M0
    SpeakerOnUntilCarrier=M1
    SpeakerAlwaysOn=M2
    SpeakerOnAfterUntilCarrier=M3
    DialToneWaitModifier=W
    CallProgress1=X1
    CallProgress2=X2
    CallProgress3=X3
    CallProgress4=X4
    EchoOff=E0
    VerboseText=V1
    QuietOn=Q1
    QuietOff=Q0
    DialCommandStateModifier=;
    OnLine=O
    ResetConfiguration=Z
    ReturnToFactoryDefs=&F
    DCDOnDuringLink=&C1
    DTRHangUp=&D2
    DSRAlwaysOn=&S0
    RTSCTSHandshake=&K3
    XonXoffHandshake=&K4
    EscapeCharacter=+
    EscapeGuardPeriod=S12
    NoDialTone=NO DIAL TONE
    Busy=BUSY
    NoAnswer=NO ANSWER
    Carrier=CARRIER
    Connect=CONNECT
    CompressionClass5=COMPRESSION:CLASS 5
    CompressionV42bis=COMPRESSION:V.42 bis
    CompressionNone=COMPRESSION:NONE
    ProtocolLAPD=PROTOCOL:LAPD
    ProtocolALT=PROTOCOL:ALT
    ProtocolALTCELLULAR=PROTOCOL:ALT-CELLULAR
    ProtocolNone=PROTOCOL:NONE
    MessageCentreNumber=+44123456789
    MessageValidityPeriod=1440
    MessageDeliveryReport=FALSE
    MinimumSignalLevel=9905
    LastSocketActivityTimeout=-1
    LastSessionClosedTimeout=-1
    LastSocketClosedTimeout=-1
    SirSettings=0
    CommRole=0
    FIELD_COUNT=69
END_SECTION

[Top]

Dial-out ISP table

The Dial-out ISP table contains the information about ISPs, needed to connect to various dial-up services.

The start of the Dial-out ISP table is indicated by the text [DialOutISP]. Below this there will be a number of sections defining ISPs. You must ensure that there is one suitable for RAS. It should look like the one below. Its user name and password are stored in IfAuthName and IfAuthPass. These must be set to 'RasUser' and 'pass' that were were chosen in Setting up the Remote Access Service on Windows NT and Setting up the Remote Access Service on Windows 2000. If there is no RAS section then you will have to add one: 

ADD_SECTION
    Name=NT RAS
    Description=Test
    Type=INTERNETONLY
    DialResolution=TRUE
    UseLoginScript=TRUE
    LoginScript=CHARMAP \[windows-1252\]\nLOOP 10\n{\nSEND "CLIENT"+<0x0d>\nWAIT 3\n{\n"SERVER" OK\n}\n}\nEXIT KErrNoAnswer$\n\nOK:\nEXIT\n
    PromptForLogin=FALSE
    DisplayPCT=FALSE
    IfNetworks=ip
    IfPromptForAuth=FALSE
    IfCallbackEnabled=FALSE
    CallbackTimeout=0
    IfAuthName=RasUser
    IfAuthPass=pass
    AuthRetries=0
    IpAddrFromServer=TRUE
    IpDNSAddrFromServer=TRUE
    Ip6DNSAddrFromServer=TRUE
    EnableIPHeaderComp=FALSE
    EnableLCPExtension=FALSE
    DisablePlainTextAuth=FALSE
    EnableSWComp=FALSE
    BearerService=0
    BearerProtocol=0
    RlpVersion=0
    IwfToMs=0
    MsToIwf=0
    AckTimer=0
    RetransmissionAttempts=0
    ResequencePeriod=0
    V42Compression=0
    V42Codewords=0
    V42MaxLength=0
    Asymmetry=0
    UserInitUpgrade=FALSE
    UseEdge=FALSE
    FIELD_COUNT=36
END_ADD

[Top]

Internet Access Point table

In the previous two sections you defined a null modem in the Modem Bearer table, and you added your ISPs information to an entry in the Dial-out ISP table. Now you must link the two together in an Internet Access Points (IAPs). The combination of the two is all the emulator needs to connect to the network.

The IAP table defines a number of IAPs. You must ensure that there is one suitable for the emulator on your network. The start of the IAP table is indicated by the text [IAP]. After this there will be a number of sections defining IAPs. If there is not a suitable IAP already then you must create one similar to the following: 

ADD_SECTION
Name=NT RAS with Null Modem
    IAPService=2
    IAPServiceType=DialOutISP
    IAPBearer=2
    IAPBearerType=ModemBearer
    IAPNetwork=1
    IAPNetworkWeighting=0
    Location=2
    FIELD_COUNT=8
END_ADD

In each IAP, the IAPBearer and IAPService parameters define the sections to link. The following example links the second modem in the Modem Bearer table with the second ISP in the Dial-out ISP table. The second modem is the second ADD_SECTION...END_SECTION after the text [ModemBearer], and the fourth ISP is the fourth ADD_SECTION...END_SECTION after the text [DialOutISP]:

Copy the rest of the fields as shown above.

[Top]

Connection Preferences table

The Internet Access Point (IAP) table defines a number of method to connect to networks and the Internet. When a phone or the emulator wants to connect to a network, the Connection Preferences table defines how a IAP is chosen.

The start of the connection preferences table is indicated by the text [ConnectionPreferences]. After this there will be a number of sections defining your preferences.

You have two options:

  1. Ask which IAP to use each time you connect

    If the table contains a section like the one below then Symbian OS will ask you to choose an IAP before it connects. A dialog box will be displayed allowing you to make your chioce. This is useful if you often connect to more than one network.

    You can ignore the BearerSet and IAP fields, but you must copy the others as shown: 

    ADD_SECTION
        Ranking=1
        Direction=OUTGOING
        DialogPref=PROMPT
        BearerSet=CSD
        IAP=1
        FIELD_COUNT=5
    END_ADD

    Note the Ranking=1 field. This indicates that this is the highest priority connection preference.

    Any sections with Ranking=0 are ignored. Think of setting Ranking=0 as 'commenting out' a connection preference.

  2. Always connect with the same IAPDefine the IAP to use

    You can define the default IAP in the connection preferences table. When Symbian OS wants to connect, it always uses the IAP that you define here. No dialog box will appear on screen and you will not be able to choose an IAP before you connect.

    This is useful when you always connect to the same network.

    Add a section to the table like this: 

    ADD_SECTION
        Ranking=1
        Direction=OUTGOING
        DialogPref=DONOTPROMPT
        BearerSet=CSD
        IAP=1
        FIELD_COUNT=5
    END_ADD

    where the IAP field must be set to the desired IAP number. In this example we connect to the first IAP, which is the first ADD_SECTION...END_SECTION after the text [IAP]. Copy the other fields as shown.

    You can specify a second, backup connection preference. If the first connection attempt fails then the backup connection is tried. Define a backup connection in a section similar to the following: 

    ADD_SECTION
        Ranking=2
        Direction=OUTGOING
        DialogPref=DONOTPROMPT
        BearerSet=CSD
        IAP=3
        FIELD_COUNT=5
    END_ADD

    Note the Ranking=2 field. This indicates that this is the second highest priority connection preference after the section with Ranking=1. Any sections with Ranking=0 are ignored by Symbian OS.

[Previous] [Top] [Next]