Configuration Tree Entries

Introduction

This page describes all the parameters that can be stored in the configuration tree to set up the Modem and Positioning device.

Cellular Network Service

The configuration database path for the SIM is:

 /
     modemServices/
         sim/
             1/
                 pin<string> == <PIN_CODE>

• '1' is the sim slot number that le_sim_GetSelectedCard is returning.
• 'PIN_CODE' is the PIN code for the SIM card.

Note

when a new SIM is inserted and :

• is locked, Cellular Network Service will read automatically the config DB in order to try to enter the pin for the SIM card.
• is blocked, Cellular Network Service just log an error and did not try to enter the puk code.
  

Modem Radio Control

The configuration database path for the Radio is:

 /
     modemServices/
         radio/
             preferredOperators/
                 0/
                     mcc<int> = <MCC_VALUE>
                     mnc<int> = <MNC_VALUE>
                     rat/
                         0<string> = <RAT_VALUE>
                         1<string> = <RAT_VALUE>
                         ...
                 1/
                     mcc<int> = <MCC_VALUE>
                     mnc<int> = <MNC_VALUE>
                     rat/
                         0<string> = <RAT_VALUE>
                         1<string> = <RAT_VALUE>
                         ...
                 ...

             scanMode/
                 manual<bool>
                 mcc<int> = <MCC_VALUE>
                 mnc<int> = <MNC_VALUE>

             preferences/
                 rat/
                     0<string> == <Rat>
                     1<string> == <Rat>
                     2<string> == <Rat>
                     ...
                 band/
                     0<string> == <Band>
                     1<string> == <Band>
                     2<string> == <Band>
                     ...
                 lteBand/
                     0<string> == <LteBand>
                     1<string> = <LteBand>
                     2<string> = <LteBand>
                     ...
                 tdScdmaBand/
                     0<string> = <TdScdmaBand>
                     1<string> = <TdScdmaBand>
                     2<string> = <TdScdmaBand>
                     ...

The preferred operators can be set using the following choices (string type):

• MCC_VALUE is the Mobile Country Code
• MNC_VALUE is the Mobile Network Code
• RAT_VALUE is the Radio Access technology.Possible values are:
  • "GSM"
  • "UMTS"
  • "LTE"

The Radio Access Technology preferences can be set with the following choices (string type):

• "CDMA" (CDMA2000-1X + CDMA2000-HRPD)
• "GSM"
• "UMTS" (UMTS + TD-SCDMA)
• "LTE"

The 2G/3G Band preferences can be set with the following choices (string type):

• "Band-Class-0-A-System"
• "Band-Class-0-B-System"
• "Band-Class-1-All-Blocks"
• "Band-Class-2-Placeholder"
• "Band-Class-3-A-System"
• "Band-Class-4-All-Blocks"
• "Band-Class-5-All-Blocks"
• "Band-Class-6"
• "Band-Class-7"
• "Band-Class-8"
• "Band-Class-9"
• "Band-Class-10"
• "Band-Class-11"
• "Band-Class-12"
• "Band-Class-13"
• "Band-Class-14"
• "Band-Class-15"
• "Band-Class-16"
• "Band-Class-17"
• "Band-Class-18"
• "Band-Class-19"
• "GSM-DCS-1800"
• "E-GSM-900" (for Extended GSM 900 band)
• "Primary-GSM-900"
• "GSM-450"
• "GSM-480"
• "GSM-750"
• "GSM-850"
• "GSMR-900" (for GSM Railways GSM 900 band)
• "GSM-PCS-1900"
• "WCDMA-EU-J-CH-IMT-2100" (for WCDMA Europe, Japan, and China IMT 2100 band)
• "WCDMA-US-PCS-1900" (for WCDMA U.S. PCS 1900 band)
• "WCDMA-EU-CH-DCS-1800" (for WCDMA Europe and China DCS 1800 band)
• "WCDMA-US-1700" (for WCDMA U.S. 1700 band)
• "WCDMA-US-850" (for WCDMA U.S. 850 band)
• "WCDMA-J-800" (for WCDMA Japan 800 band)
• "WCDMA-EU-2600" (for WCDMA Europe 2600 band)
• "WCDMA-EU-J-900" (for WCDMA Europe and Japan 900 band)
• "WCDMA-J-1700" (for WCDMA Japan 1700 band)

The LTE Band preferences can be set by specifying the number of E-UTRA operating band, 0 to 43 except: 15, 16, 22, 23, and 26 to 32.

The TD-SCDMA Band preferences can be set with the following choices (string type): "A" to "F".

Modem Data Control

The configuration database path for the Modem Data Control is:

 /
     modemServices/
         modemDataConnection/
             isUserSettings<bool> = <true/false>
             userProfiles/
                 <ProfileName_1>/
                     accessPointName<string> == <ADDR>
                     packetDataProtocol<string> == <PDP_TYPE>
                     authentication/
                         pap/
                             enable<bool> == <true/false>
                             userName<string> == <USERNAME>
                             password<string> == <PWD>
                         chap/
                             enable<bool> == <true/false>
                             userName<string> == <USERNAME>
                             password<string> == <PWD>

                 <ProfileName_2>/
                     accessPointName<string> == <ADDR>
                 ...
                 <ProfileName_5>/
                     accessPointName<string> == <ADDR>

• 'isUserSetting' is to use userProfiles, default is false.
• 'ProfileName_*' is the name that le_mdc_LoadProfile can load.
• 'ADDR' is an address like xxx.xxx.xxx.xxx .
• 'USERNAME' is the name used for authentication
• 'PWD' is the password used for authentication
• 'PDP_TYPE' is the protocol:
  • IPV4
  • IPV6
  • IPV4V6

If //modemServices/modemDataConnection/<ProfileName>/packetDataProtocol is omitted, IPV4 will be the default protocol.

Note

PAP and CHAP authentication are not usable at the same time, the first authentication enabled found in the configDB will be used.

eCall

The configuration database path for the eCall is:

/
    modemServices/
        eCall/
            pushpull<string> = <push-pull mode>
            msdVersion<int> = <MSD value>
            vehicleType<string> = <vehicle type>
            vin<string> = <VIN>
            propulsionType/
                0<string> = <propulsion type>
                1<string> = <propulsion type>
                ...

The 'pushpull' field can be set with the following two choices (string type):

• "Push": the MSD is pushed by the IVS
• "Pull": the MSD is sent when requested by the PSAP

The 'msdVersion' field is the MSD format version.

The 'vehicleType' field can be set with the following choices (string type):

• "Passenger-M1" (Passenger vehicle, Class M1)
• "Bus-M2" (Buses and coaches, Class M2)
• "Bus-M3" (Buses and coaches, Class M2)
• "Commercial-N1" (Light commercial vehicles, Class N1)
• "Heavy-N2" (Heavy duty vehicles, Class N2)
• "Heavy-N3" (Heavy duty vehicles, Class N2)
• "Motorcycle-L1e" (Motorcycles, Class L1e)
• "Motorcycle-L2e" (Motorcycles, Class L1e)
• "Motorcycle-L3e" (Motorcycles, Class L1e)
• "Motorcycle-L4e" (Motorcycles, Class L1e)
• "Motorcycle-L5e" (Motorcycles, Class L1e)
• "Motorcycle-L6e" (Motorcycles, Class L1e)
• "Motorcycle-L7e" (Motorcycles, Class L1e)

The 'vin' is the vehicle identification number (string type).

The 'propulsionType' field can be set with the following choices (string type):

• "Gasoline" (Gasoline propulsion)
• "Diesel" (Diesel propulsion)
• "NaturalGas" (Compressed natural gas propulsion)
• "Propane" (Liquid propane gas propulsion)
• "Electric" (Electric propulsion)
• "Hydrogen" (Hydrogen propulsion)
• "Other" (Other type of propulsion)
  

Positioning

The configuration database path for Positioning is:

/
    positioning/
        acquisitionRate<int> == 5

• 'acquisitionRate' is the fix acquisition rate in seconds.

Note

If there is no configuration for 'acquisitionRate', it will be automatically set to 5 seconds.

---

Copyright (C) Sierra Wireless, Inc. 2014. Use of this work is subject to license.