Share via


Audio Gateway Registry Settings (Windows Embedded CE 6.0)

1/6/2010

Windows Embedded CE provides the Audio Gateway Service to support the Headset Profile and the Hands-Free Profile on the device. You can configure the Audio Gateway service through the registry.

Note

The default registry values vary depending on which Catalog items are included in your OS design. For more information, see Default Registry Settings.

To enable Handset and Hands-free profiles on the device, the OEMs must add the HKEY_LOCAL_MACHINE\Software\Microsoft\Bluetooth\HandsfreeProfileOn key in the registry. This registry key is not added by default because many devices do not support Bluetooth.

The registry settings for Audio Gateway are located under the HKEY_LOCAL_MACHINE\Software\Microsoft\Bluetooth\AudioGateway registry key.

The following table shows the named values for the AudioGateway registry key:

Value : type Description

Authenticate : REG_DWORD

Determines whether or not the connection is authenticated.

  • 0 - Disables authentication.
  • 1 - Enables authentication. Default.

This setting is optional.

Ee495798.security(en-US,WinEmbedded.60).gifSecurity Note:
Setting this value to 0 disables authentication. This may result in potential security risks.

ConnectScoInAlways : REG_DWORD

Determines whether or not audio is routed to the Bluetooth hands-free device.

  • 0 - Incoming calls answered in the handset and audio is not routed to hands-free device. Default.
  • 1 - Incoming calls answered in the handset and routes audio to hands-free device.

Encrypt : REG_DWORD

Determines whether or not the connection is encrypted.

  • 0 - Disables encryption.
  • 1 - Enables encryption. Default.

This setting is optional.

Ee495798.security(en-US,WinEmbedded.60).gifSecurity Note:
Setting this value to 0 disables encryption. This may result in potential security risks.

MapAudioToPcmMode : REG_DWORD

Specifies the audio driver. The setting can have the following values:

  • 0 - Use the built-in SCO audio driver.
  • 1 - Assume that audio is automatically routed to the Bluetooth hardware. Default.

MicVolume : REG_DWORD

Specifies the default microphone volume with respect to the AT+VGM command. Default value is set to 8.

NoHandsFree : REG_DWORD

Specifies whether or not the hands-free profile is used.

  • 0 - Enables the Hands-Free profile.
  • 1 - Disables the Hands-Free Profile.

PowerSave : REG_DWORD

Configures the audio gateway to conserve power when establishing audio connections.

  • 0 - Keeps the service level connection active for the Hands-Free profile in between calls.
  • 1 - Closes the service level connection between calls.

SpkVolume : REG_DWORD

Specifies the default speaker volume with respect to the AT+VGS command. Default value is set to 8.

Capability : REG_DWORD

Specifies the capability bitmask that is specified by the hands-free profile. Default value is 0x21. Optional bitmask values are:

  • 0x04 - Enable voice tag support
  • 0x08 - Enable Inband ringtone

PageTimeout: REG_DWORD

Specifies the page timeout for connecting to the peer Bluetooth device. This value is passed as a parameter to the BthWritePageTimeout function.

BTAGExtModule : REG_SZ

Specifies the name of the AT command extension DLL to load. By default, the AG uses btagatext.dll.

OutgoingCallOption : REG_DWORD

Specifies how outgoing calls should be handled. The setting can have the following values:

  • 0 - Prompts where the outgoing call should be handled.
  • 1 - Automatically handles the call in the headset.
  • 2 - Disables audio routing and automatically handles the call in the hands-free device.

SniffDelay : REG_DWORD

Specifies the timeout value in milliseconds before activating the SNIFF mode for the connection. Default value is 5000 milliseconds.

SniffMax : REG_DWORD

Specifies the maximum acceptable number of Baseband slots between each sniff period. The time length is equal to N * 0.625 msec, or 1 Baseband slot. The valid range for N is 0x0001 to 0xFFFF. The valid time range is 0.625 msec to 40.9 seconds.

SniffMin : REG_DWORD

Specifies the minimum acceptable number of Baseband slots between each sniff period. The time length is equal to N * 0.625 msec, or 1 Baseband slot. The valid range for N is 0x0001 to 0xFFFF. The valid time range is 0.625 msec to 40.9 seconds.

SniffAttempt : REG_DWORD

Specifies the number of Baseband receive slots for sniff attempt. The length is equal to (2 * N –1) * 0.625 msec. The valid range for N is 0x0001 to 0x7FFF. The valid time range is 0.625 msec to 40.9 seconds.

SniffTimeout : REG_DWORD

Specifies the number of Baseband receive slots for sniff timeout. If N is greater than 0, the length is equal to (2 * N –1) * 0.625 msec. If N is equal to 0, then the length is equal to 0 msec. The valid range for N is 0x0000 to 0x7FFF. The valid time range is 0 msec to 40.9 seconds.

NoRoleSwitch : REG_DWORD

0 - Enables the stack to request a role-switch with the peer device for an incoming connection.

1 - Disables role switching. Default

The registry settings for the Audio Gateway service are located under the HKEY_LOCAL_MACHINE\Services\BTAGSVC registry key.

The following table shows the named values for the BTAGSVC registry key:

Value : type Description

IsEnabled : REG_DWORD

Determines whether or not the service is started at boot time.

  • 0 - Service is not started at boot time.
  • 1 - Service is started at boot time.

See Also

Concepts

Bluetooth Registry Settings
Audio Gateway Service
Bluetooth Profiles
Headset Profile
Hands-Free Profile

Other Resources