RIL Registry Settings

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Use the RIL registry settings to configure RIL functionality.

The HKEY_LOCAL_MACHINE\Comm\Cellular\RILregistry key configures the connection mode and number of concurrent connections used by Radio Interface Layer. The following table shows the named values.

Name	Type	Description
Packet	REG_DWORD	Specifies the connection mode used by GPRS connections. When set to 0, a RAS-based connection is used. When set to a value greater than or equal to 1, NDIS GPRS is used. By default, this registry key does not exist. To enable RIL NDIS packet APIs, this registry key must be added to Cellcore.reg.
Contexts	REG_DWORD	Specifies the number of concurrent connections (contexts) accepted by the Connection Manager and the RIL proxy. Only values between 1 and 8 are supported. If set to 0, the default value is used. If set to a value greater than 8, the value is ignored and 8 concurrent connections are accepted. For PPP-based GPRS connections, if the registry key does not exist, or if the registry setting is 1, the RIL proxy will retrieve the COM (serial) port from HKEY_LOCAL_MACHINE\Software\Microsoft\RIL\DataPort. The COM port is not used for NDIS-based GPRS connections. By default, this registry setting does not exist. To enable multiple concurrent GPRS connections on a device, this registry key must be added to Cellcore.reg and set to a value greater than 1.

Name

Type

Description

Packet

REG_DWORD

Specifies the connection mode used by GPRS connections. When set to 0, a RAS-based connection is used. When set to a value greater than or equal to 1, NDIS GPRS is used.

By default, this registry key does not exist. To enable RIL NDIS packet APIs, this registry key must be added to Cellcore.reg.

Contexts

REG_DWORD

Specifies the number of concurrent connections (contexts) accepted by the Connection Manager and the RIL proxy. Only values between 1 and 8 are supported. If set to 0, the default value is used. If set to a value greater than 8, the value is ignored and 8 concurrent connections are accepted.

For PPP-based GPRS connections, if the registry key does not exist, or if the registry setting is 1, the RIL proxy will retrieve the COM (serial) port from HKEY_LOCAL_MACHINE\Software\Microsoft\RIL\DataPort. The COM port is not used for NDIS-based GPRS connections.

By default, this registry setting does not exist. To enable multiple concurrent GPRS connections on a device, this registry key must be added to Cellcore.reg and set to a value greater than 1.

The HKEY_LOCAL_MACHINE\Software\Microsoft\RILregistry key configures the port name used by Radio Interface Layer. The following table shows the named values.

Name	Type	Description
DataPort	REG_SZ	Specifies the name of the serial port to be used for PPP-based data connections. The serial port is not used for NDIS-based GPRS connections. This registry setting is only used if the HKEY_LOCAL_MACHINE\Comm\Cellular\RIL\Contexts key has not been set.

Name

Type

Description

DataPort

REG_SZ

Specifies the name of the serial port to be used for PPP-based data connections. The serial port is not used for NDIS-based GPRS connections.

This registry setting is only used if the HKEY_LOCAL_MACHINE\Comm\Cellular\RIL\Contexts key has not been set.

The HKEY_LOCAL_MACHINE\Comm\Cellular\CellTSPregistry key configures the telephony service provider and the dial filter settings. The following table shows the named values.

Name	Type	Description
DisableCPHSOverride	REG_DWORD	By default, the CPHS operator name (the operator name stored in the SIM) overrides all other stored operator names when the user is registered on the Home PLMN (Public Land Mobile Network) and EONS is not enabled. In that case, the CPHS name is displayed as the operator name. Setting this value to 1 disables CPHS override. When override is disabled, the sample RIL driver then queries registry values keyed by network number, hard-coded tables and radio responses for the operator name. The EONS string, if enabled, takes precedence over CPHS override.
DialFilter	REG_SZ	Creates a custom dial filter that will allow calls containing specified valid characters. If not present, the default dial filter is used. If present and set to a null string "", the dial filter will not be applied and the dial string will be passed through as is. If present and set to a non-null string, the default dial filter will be disabled and a custom dial filter will be used that allows the characters specified in DialFilterto be accepted in the dial string.

Name

Type

Description

DisableCPHSOverride

REG_DWORD

By default, the CPHS operator name (the operator name stored in the SIM) overrides all other stored operator names when the user is registered on the Home PLMN (Public Land Mobile Network) and EONS is not enabled. In that case, the CPHS name is displayed as the operator name.

Setting this value to 1 disables CPHS override. When override is disabled, the sample RIL driver then queries registry values keyed by network number, hard-coded tables and radio responses for the operator name.

The EONS string, if enabled, takes precedence over CPHS override.

DialFilter

REG_SZ

Creates a custom dial filter that will allow calls containing specified valid characters.

If not present, the default dial filter is used.
If present and set to a null string "", the dial filter will not be applied and the dial string will be passed through as is.
If present and set to a non-null string, the default dial filter will be disabled and a custom dial filter will be used that allows the characters specified in DialFilterto be accepted in the dial string.

The HKEY_LOCAL_MACHINE\Comm\Cellular\RILregistry key has new values, as described in the following table.

Name	Type	Description
EONSEnabled	REG_DWORD	When set to 1, specifies that EONS (Enhanced Operator Name String) is available. When set to 0 or not present, EONS is not used. The operator name is then set using the CPHS override, unless the override has been explicitly disabled.

Name

Type

Description

EONSEnabled

REG_DWORD

When set to 1, specifies that EONS (Enhanced Operator Name String) is available.

When set to 0 or not present, EONS is not used. The operator name is then set using the CPHS override, unless the override has been explicitly disabled.

The HKEY_LOCAL_MACHINE\Comm\Cellular\RIL\RemoteCallTyperegistry key is used for push-to-talk (PTT) calls. This key is read during the device initialization process, so it must be built into the device image or provisioned using XML.

Note:
The IMGPTT flag needs to be set in the platform.reg file.

The following table shows named values.

Name	Type	Description
CalltypeDLL	REG_SZ	The name of the DLL that contains the implementation of the RILCALLTYPECALLBACK function. By default, this is set to "PTTCalltypeCallback.dll" in the Cellcore.reg file. The maximum length of this string is specified by Maximum Lengths Constants.
CalltypeFunction	REG_SZ	The name of the function that implements the RILCALLTYPECALLBACKfunction. By default, this is set to "PTTDetermineCalltype" in the Cellcore.reg file. The maximum length of this string is specified by Maximum Lengths Constants.

The key HKEY_LOCAL_MACHINE\Security\RILhas one named value:

Name	Type	Description
LastScannedNetworkType	REG_DWORD	This RIL driver may use this setting to record the last scanned network type for a global phone. If used, it should be set to 0 for GSM or 1 for CDMA. This value can be used by other applications as well; for example, to display a tray icon.

Name

Type

Description

LastScannedNetworkType

REG_DWORD

This RIL driver may use this setting to record the last scanned network type for a global phone. If used, it should be set to 0 for GSM or 1 for CDMA. This value can be used by other applications as well; for example, to display a tray icon.

See Also

Concepts

Other Resources