RIL Registry Settings (Windows Embedded CE 6.0)

1/6/2010

Use the RIL registry setting to configure RIL functionality.

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

Value : 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\RIL registry key configures the port name used by Radio Interface Layer. The following table shows the named values.

Value : 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\CellTSP registry key configures the telephony service provider. The following table shows the named values.

Value : 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.

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

Value : 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\RemoteCallType registry 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.

Value : type Description

CalltypeDLL : REG_SZ

The name of the DLL that contains the implementation of theRILCALLTYPECALLBACKfunction. 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 RILCALLTYPECALLBACK function. By default, this is set to "PTTDetermineCalltype" in the Cellcore.reg file. The maximum length of this string is specified by Maximum Lengths Constants.

See Also

Concepts

Radio Interface Layer
Adding Push-to-talk Support