Configuring Comms Database For Circuit Switched Data (CSD) Connections

This section explains how to configure the Comms database for an outbound dial-up connection using a circuit switched telephone network. The Comms database stores the Symbian OS network configuration settings. This document is aimed at developers writing applications that use circuit switched data (CSD) connection . Refer Comms Database Configuration Overview for more information on using the Comms database.

This section is a use case of the Comms database for circuit switched data connections and explains the various tables that should be configured. You can configure tables in any order, but we recommend that you follow the same order as listed here. The configuration settings are stored in an XML file as shown in the sample configuration file. The file can be edited using CED and CEDDUMP tools.

The following tables are needed when configuring CSD connections. Note that CED generates blank tables if any of the tables listed below is not configured.

• Network table

• IAP table

• Modem bearer table

• DialOutISP table

• Connection preference table

• Global settings table

• Location table

Optional

The Chargecard table is configured when the user has to pay for the service.

There should be at least one record created for this table. This table contains the details of the network name that is used by the applications.

<NetworkTable>
    <Network operation="add">
        <Name>Office Intranet</Name>
    </Network>
</NetworkTable>

There should be at least one record created for this table but usually more than one record is used. Each record in this table specifies an access point.

<IAPTable>
    <IAP operation="add">
        <Name>CSD: From UK location</Name>
        <IAPService>DialOutISP.Default Dial Out ISP</IAPService>
        <IAPBearer>ModemBearer.Dacom Surfer</IAPBearer>
        <IAPNetwork>Network. Office Intranet</IAPNetwork>
        <IAPNetworkWeighting>0</IAPNetworkWeighting>
        <LocationRef>Location.Direct Dial From Office</LocationRef>
    </IAP>
</IAPTable>

The sample record shows that the IAP table has references to records in other tables such as DialOutISP table, Modem bearer table, Network table and Location table. The IAP records specify the access point settings and hence there are several records in this table for different access types used by the applications.

For full list of fields and possible values, Refer to Comms Database Reference

There should be at least one record created for this table. This table contains the details of modem bearer settings. Most of the values used in this table are Hayes commands.

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

The same record can be used for both circuit switched and packet switched networks by changing the value of the Agent field. The value of the Agent field depends on whether a CSD or a PSD agent is used.

For full list of fields and possible values, Refer to Comms Database Reference

There should be at least one record created for this table. Table contains the ISP settings necessary to establish a circuit switched connection.

<DialOutISPTable>
    <DialOutISP operation="add">
        <Name>Default Dial Out ISP</Name>
        <DialResolution>TRUE</DialResolution>
        <UseLoginScript>FALSE</UseLoginScript>
        <PromptForLogin>FALSE</PromptForLogin>
        <IfPromptForAuth>FALSe</IfPromptForAuth>
        <IpAddrFromServer>TRUE</IpAddrFromServer>
        <IpDNSAddrFromServer>TRUE</IpDNSAddrFromServer>
        <Description>For Documentation</Description>
        <DefaultTelNum>+440123456789</DefaultTelNum>
        <IfNetworks>ip</IfNetworks>
        <IfCallbackEnabled>FALSE</IfCallbackEnabled>
        <CallbackTimeout>0</CallbackTimeout>
        <DisplayPCT>FALSE</DisplayPCT>
        <EnableIPHeaderComp>TRUE</EnableIPHeaderComp>
        <EnableLCPExtension>FALSE</EnableLCPExtension>
        <DisablePlainTextAuth>FALSE</DisablePlainTextAuth>
        <EnableSWComp>FALSE</EnableSWComp>
        <BearerName>ASYNCHRONOUS</BearerName>
        <BearerType>HSCSD</BearerType>
        <BearerProtocol>UNSPECIFIED</BearerProtocol>
        <RlpVersion>0</RlpVersion>
        <IwfToMs>0</IwfToMs>
        <MsToIwf>0</MsToIwf>
        <AckTimer>0</AckTimer>
        <RetransmissionAttempts>0</RetransmissionAttempts>
        <ResequencePeriod>0</ResequencePeriod>
        <V42Compression>0</V42Compression>
        <V42Codewords>0</V42Codewords>
        <V42MaxLength>0</V42MaxLength>
        <Asymmetry>0</Asymmetry>
        <UserInitUpgrade>FALSE</UserInitUpgrade>
        <UseEdge>FALSE</UseEdge>
    </DialOutISP>
</DialOutISPTable>

For full list of fields and possible values, Refer to Comms Database Reference

There should be at least one record created for this table. The record containing the most preferred connection should have ranking 1 and the record containing the next preferred connection should have ranking 2. All other records created in this table should have the ranking 0. The record with ranking 1 is attempted first, if it fails the connection with ranking 2 is attempted.

<ConnectionPreferencesTable>
    <ConnectionPreferences operation="add">
        <Name>First Choice</Name>
        <Ranking>1</Ranking>
        <Direction>OUTGOING</Direction>
        <BearerSet>CSD</BearerSet>
        <DialogPref>DONOTPROMPT<DialogPref>
        <IAPRef>IAP.CSD: From UK location</IAPRef>
    </ConnectionPreferences>
</ConnectionPreferencesTable>

This sample record contains the settings for an outgoing connection. A Similar record can be created for incoming connections.

For full list of fields and possible values, Refer to Comms Database Reference

There should be only one record created for this table. The record should have valid references in the Modem bearer, Location and Network tables.

<GlobalSettingsTable>
    <GlobalSettings operation="add">
        <Name>GlobalSettingsRecord</Name>
        <ConnectionAttempts>2</ConnectionAttempts>
        <RedialAttempts>3</RedialAttempts>
        <SmsBearer>3</Smsbearer>
        <SmsReceiveMode>2</SmsReceiveMode>
        <GprsAtachMode>1</GprsAttachMode>
        <AcceptIncomingGprs>1</AcceptIncomingGprs>
        <GprsClassCBearer>GSM</GprsClassCBearer>
        <ModemForDataAndFax>1</ModemForDataAndFax>
        <ModemForPhoneServicesAndSMS>1</ModemForPhoneServicesAndSMS>
        <LocationForDataAndFax>Location.Direct Dial From Office</LocationForDataAndFax>
        <LocationForPhoneServicesAndSMS>Location.Direct Dial From Office</LocationForPhoneServicesAndSMS>
        <DefaultNetwork>Network.Office Intranet</DefaultNetwork>
        <MaxBufHeap>2</MaxBufHeap>
        <BearerAvailabilityCheckTSY>mm</BearerAvailabilityCheckTSY>
    </GlobalSettings>
</GlobalSettingsTable>

The sample record contains some GPRS fields configured , which are less significant to the circuit switched connections. These fields are given some values because they cannot be assigned with null values.

The SmsBearer field is given a value 3 because the data is transmitted using a packet switched network only when a circuit switched network is not available.

For full list of fields and possible values, Refer to Comms Database Reference

There should be at least one record created for this table with the location details.

<LocationTable>
    <Location operation="add">
        <Name>Direct Dial From Office</Name>
        <IntlPrefixCode>00</IntlPrefixCode>
        <NatPrefixCode>0</NatPrefixCode>
        <AreaCode>207</AreaCode>
        <Mobile>FALSE</Mobile>
        <UsePulseDial>FALSE</UsePulseDial>
        <WaitForDialTone>FALSE</WaitFotDialTone>
        <PauseAfterDialOut>0</PauseAfterDialOut>
    </Location>
</LocationTable>

For full list of fields and possible values, Refer to Comms Database Reference

This is an optional table configured to pay for the service. This table contains the details of a credit or charge card , which can be used to pay.

<ChargecardTable>
    <Chargecard operation="add">
        <Name>Dummy chargecard record</Name>
        <AccountNumber>0500800800</AccountNumber>
        <Pin>****</Pin>
        <LocalRule>HG</LocalRule>
        <NatRule>J, K, OFG</NatRule>
        <IntlRule>HEFG</IntlRule>
    </Chargecard>
</ChargecardTable>

For full list of fields and possible values, Refer to Comms Database Reference

Sample Circuit Switched Data (CSD) Configuration

Configuring Comms Database for Ethernet connections

Configuring Comms Database for Packet Switched Data (PSD) Connections

Configuring Comms Database For VPN Connections

Comms Database Reference