Tapi Configuration Service Provider

  • Article

4/8/2010

Use the Tapi Configuration Service Provider to configure telephony settings. The Tapi Configuration Service Provider is used for configuring the Global System for Mobile Communications (GSM) telephony settings on the device.

Note

This Configuration Service Provider is not available on Windows Mobile Professional and Windows Mobile Classic.

Note

This Configuration Service Provider is managed over the OMA Client Provisioning (formerly WAP Client Provisioning) protocol.

Note

Access to this Configuration Service Provider is determined by Security roles. Because OEMs and Mobile Operators can selectively disallow access, ask them about the availability of this Configuration Service Provider. For more information about roles, see Security Roles and Default Roles for Configuration Service Providers.

In the root characteristic, the default security roles are defined. The default security role maps to each subnode unless specific permission is granted to the subnode. The following table shows the default settings:

Permissions

Read/write

Roles allowed to query and update setting

Manager

The following image shows the Configuration Service Provider in tree format as used by OMA Client Provisioning.

Bb737554.3e968e59-25ab-4001-b77f-10818ceb98f2(en-us,MSDN.10).gif

Characteristics

  • FWD_CODE
    This characteristic is used to configure the call forwarding settings. The following table lists the possible values.

    Value Description

    No-Reply

    Forward when there is no reply.

    Not-Reachable

    Forward when not reachable.

    Busy

    Forward when busy.

    Unconditional

    Forward unconditionally.

  • FWD_CODE/<INFOCLASS>
    This characteristic determines the class of information. The following table lists the possible values.

    Value Description

    All-Bearers

    All calls.

    Voice

    Voice calls.

    Data

    Data calls.

    Fax

    Fax calls.

Parameters

  • AreaCode
    Identifies the home area code of the device. The area code is used by Tapi to plan call costs and for phone number matching and formatting heuristics.

Note

The value for this parm should be preset if possible. Applications such as smartdial make use of this parm when performing searches for matching phone numbers. The value for this parm can be placed in ROM by OEMs during manufacture or provisioned by Mobile Operators before deployment to their customers.

This parm is used in the root Tapi characteristic.

The following table shows the default settings for this parm.

Permissions

Read/write

Data type

string

Label

Area code:

Semantic type

phone-number

Roles allowed to query and update setting

Manager

Operator

Operator - TPS

AuthenticatedUser

  • CellBroadcastEnabled
    Enables or disables receipt of cell broadcast messages. A value of 0 indicates cell broadcast messages are disabled. A value of 1 indicates that they are enabled.

    This parm is used in the root Tapi characteristic.

    The following table shows the default settings.

    Permissions

    Read/write

    Data type

    boolean

    Label

    Enable channels

    Roles allowed to query and update setting

    Manager

    AuthenticatedUser

  • CellBroadcastEnableTopicList
    Enables or disables the cell broadcast topic list. A value of 0 indicates cell broadcast topic list is disabled. A value of 1 indicates that it is enabled.

    This parm is used in the root Tapi characteristic.

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    boolean

    Label

    Receive channel list

    Roles allowed to query and update setting

    Manager

    AuthenticatedUser

  • CellBroadcastLanguage
    Identifies which cell broadcast messages to receive based on their language. This parm is used in the root Tapi characteristic.

    The following list shows the possible values:

    • 131071 indicates all languages
    • 2 indicates German
    • 4 indicates English
    • 8 indicates Italian
    • 16 indicates French
    • 32 indicates Spanish
    • 64 indicates Dutch
    • 128 indicates Swedish
    • 256 indicates Danish
    • 512 indicates Portuguese
    • 1024 indicates Finnish
    • 2048 indicates Norwegian
    • 4096 indicates Greek
    • 8192 indicates Turkish
    • 16384 indicates Hungarian
    • 32768 indicates Polish
    • 65536 indicates Czech

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    integer

    Label

    language

    Roles allowed to query and update setting

    Manager

    AuthenticatedUser
  • CountryCode
    Identifies the home country/region code of the device. The country/region code is used by Tapi to plan call costs and for phone number matching and formatting heuristics.

Note

The value for this parm should be preset if possible. Applications such as smartdial make use of this parm when performing searches for matching phone numbers. The value for this parm can be placed in ROM by OEMs during manufacture or provisioned by Mobile Operators before deployment to their customers.

This parm is used in the root Tapi characteristic.

The following table shows the default settings.

Permissions

Read/Write

Data type

String

Label

Country/region code:

Semantic type

phone-number

Roles allowed to query and update setting

Manager

Operator

Operator - TPS

AuthenticatedUser

  • CurrentDefaultLine
    Identifies the current outgoing line.

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    String

    Label

    Current Outgoing Line:

    Semantic type

    phone-number

    Roles allowed to query and update setting

    Manager

    Operator

    Operator - TPS

  • RadioVersion
    Reads the Radio Stack Version display string.

    This parm is used in the root Tapi characteristic.

    The following table shows the default settings:

    Permissions

    Read-only

    Data type

    string

    Roles allowed to query and update setting

    Operator

    Operator - TPS

    Manager

    AuthenticatedUser

  • RILVersion
    Indicates whether the RIL version entry is displayed in the About control panel application.

    The following table shows the default settings.

    Permissions

    Read-only

    Data type

    String

    Roles allowed to query and update setting

    Manager

    Operator

    Operator - TPS

    AuthenticatedUser

  • SMSC
    Sets the Short Message Service Center address.

    This parm is used in the root Tapi characteristic.

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    String

    Label

    SMS service center:

    Semantic type

    phone-number

    Roles allowed to query and update setting

    Manager

    Operator TPS

  • TAPI_BARRING_IN
    Used to block incoming messages and calls. The following list shows the possible values:

    • A value of zero (0) indicates no calls are blocked.
    • A value of 1 blocks incoming calls when roaming.
    • A value of 2 blocks all incoming calls.

    The following table shows the default settings.

    Permissions

    read/write

    Data type

    integer

    Label

    Block incoming calls:

  • TAPI_BARRING_OUT
    Used to block outgoing messages and calls. The following list shows the possible values:

    • A value of zero (0) indicates no messages are blocked.
    • A value of 1 blocks outgoing international calls except to home.
    • A value of 2 blocks all outgoing international calls.
    • A value of 3 blocks all outgoing calls.

    This parm is used in the root Tapi characteristic.

    The following table shows the default settings.

    Permissions

    read/write

    Data type

    integer

    Label

    Block outgoing calls:

  • TAPI_BARRING_PASSWORD
    This parm is used in the root Tapi characteristic to enter the network call barring password.

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    String

    Label

    Call barring password:

    Semantic type

    numeric-password

  • TAPI_FIXEDDIAL_ENABLED
    This parm is used in the root Tapi characteristic to enable or disable fixed dialing. The following table lists the possible values.

    This parm is used in the root Tapi characteristic.

    Value Description

    0

    Fixed dialing is disabled

    -1

    Fixed dialing is enabled

    The following table shows the default settings.

    Permissions

    read/write

    Data type

    boolean

    Label

    Enable fixed dialing

  • TAPI_FIXEDDIAL_NUMBERS
    This parm is used in the root Tapi characteristic to configure the list of fixed dialing numbers.

    The following table shows the default settings.

    Permissions

    read/write

    Data type

    string

  • TAPI_FORWARD_ADDRESS
    This parm is used in the call forwarding characteristic to set the phone number to which messages or calls should be forwarded.

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    String

    Label

    Forward calls to:

    Semantic type

    phone-number

    Roles allowed to query and update setting

    Manager

    AuthenticatedUser

  • TAPI_FORWARD_ENABLED
    This parm is used in the call forwarding characteristic to enable or disable the call forwarding function. The following table lists the possible values.

    Value Description

    0

    Off

    -1

    On

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    Boolean

    Label

     

    Roles allowed to query and update setting

    Manager

    AuthenticatedUser

    This parm is used in the following characteristics:

    • Tapi Configuration Service Provider under No-Reply\*\, and additionally has the Enable call forwarding when no reply label.
    • Tapi Configuration Service Provider under Unconditional\*\, and additionally has the Enable call forwarding of all calls label.
    • Tapi Configuration Service Provider under Busy\*\, and additionally has the Enable call forwarding when the phone is busy label.
    • Tapi Configuration Service Provider under Not-Reachable\*\,and additionally has the Enable call forwarding when unavailable label.

  • TAPI_FORWARD_TIMEOUT
    This parm is used to set the length of the timeout on forwarded messages or calls that receive no reply. This can be set to 5, 10, 15, 20, 25, or 30 seconds.

    This parm is used in the root call forwarding characteristic.

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    Integer

    Label

    Forward after:

    Roles allowed to query and update setting

    Manager

    AuthenticatedUser

  • TAPI_NETWORK_AUTOMATIC
    This parm is used in the root Tapi characteristic to choose which network selection method the phone should use. The following table lists the possible values.

    Value Description

    0

    Automatic

    1

    Manual

    The following table shows the default settings.

    Permissions

    Read/write

    Data type

    integer

    Label

    Network selection:

  • TAPI_NETWORK_CURRENT
    This parm is used in the root Tapi characteristic to identify the current network.

    The following table shows the default settings.

    Permissions

    Read-only

    Data type

    string

    Label

    Current network:

    Roles allowed to query and update setting

    Manager

    AuthenticatedUser

  • TAPI_NETWORK_PREFERRED
    This parm is used in the root Tapi characteristic to identify the list of preferred networks.

    The following table shows the default settings.

    Permissions

    Read/write

    Data type

    string

    Label

    Preferred networks:

  • TAPI_NETWORK_SELECT_CURRENT
    This parm is used in the root Tapi characteristic to select the current network manually.

    The following table shows the default settings.

    Permissions

    Read/write

    Data type

    integer

    Label

    Select current network:

    Roles allowed to query and update setting

    Manager

  • TAPI_PIN2
    This parm is used in the root Tapi characteristic to enter PIN2 to access fixed dialing.

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    String

    Label

    Enter PIN2:

    Semantic type

    numeric-password

  • TAPI_SEND_CALLID
    Enables or disables the ability to send caller ID information for the device . The following list shows the possible values:

    • 0 provides the caller ID of the to all callers.
    • 1 prevents the caller ID from being provided to any callers.
    • 2 provides the caller ID to callers listed in My Contacts.

    The following table shows the default settings.

    Permissions

    read/write

    Data type

    integer

    Label

    Provide my caller ID to:

  • TAPI_WAITING
    Enables or disables call waiting. A value of 0 disables call waiting. A value of -1 enables it.

    This parm is used in the root Tapi characteristic.

    The following table shows the default settings.

    Permissions

    Read/write

    Data type

    boolean

    Label

    Provide call waiting notifications

  • Voicemail1
    Identifies the voice mail number for line 1. This parm is used in the root Tapi characteristic.

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    String

    Label

    Voice mail number (L1):

    Semantic type

    phone-number

    Roles allowed to query and update setting

    Operator

    Operator - TPS

    Manager

    AuthenticatedUser

  • Voicemail2
    Sets the voice mail number for line 2. This parm is used in the root Tapi characteristic.

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    String

    Label

    Voice mail number (L2):

    Semantic Type

    Phone-number

    Roles allowed to query and update setting

    Operator

    Operator - TPS

    Manager

    AuthenticatedUser

  • VoicePrivacy
    Indicates whether to show the voice privacy icon when voice privacy is dropped and whether to play an event sound when the user is on a call.

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    Boolean

    Label

    Notify me when voice privacy is unavailable

    Roles allowed to query and update setting

    Manager

    AuthenticatedUser

Microsoft Custom Elements

The following table shows the Microsoft custom elements that this Configuration Service Provider supports for OMA Client Provisioning.

Elements Available

parm-query

Yes

noparm

No

nocharacteristic

No

characteristic-query

No

Use these elements to build standard OMA Client Provisioning (formerly WAP Client Provisioning) configuration XML. For information about specific elements, see MSPROV DTD Elements. For examples of how to generally use the Microsoft custom elements, see OMA Client Provisioning XML File Examples.

For information about OMA Client Provisioning, see OMA Client Provisioning Files.

See Also

Tasks

Tapi Configuration Service Provider Examples for OMA Client Provisioning

Concepts

Configuration Service Provider Reference for Windows Mobile Devices