Tapi Configuration Service Provider

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.

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:

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

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.

This parm is used in the root Tapi characteristic.

The following table shows the default settings for this parm.

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

This parm is used in the root Tapi characteristic.

The following table shows the default settings.

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

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