readme.txt

The following file describes how to use the Bluetooth Headset Audio Gateway.

Bluetooth Headset Audio Gateway
-------------------------------

The following file describes how to use the Bluetooth Headset Audio Gateway.


Step 1 - Build the components

--> Ensure you have the following environment settings:
SYSGEN_BTH=1
SYSGEN_AUDIO=1
SYSGEN_USB=1   [for usb transport]
BSP_WAVEDEV_ENSONIQ=1   [when using CEPC]

Note: Ensure you do NOT have BSP_NOAUDIO=1

--> Build the following components:
a) SCO
cd \ce\public\common\oak\drivers\bluetooth\sample\btscosnd
build -c

Note: This is an audio driver which transfers data over Bluetooth using SCO.

b) Headset
cd \ce\public\common\oak\drivers\bluetooth\sample\btheadset
build -c

Note: btaudiogw is a dll which exports an interface to configure the audio
gateway.  headsetctl.exe is the UI which calls into btaudiogw.dll.  bttalk
and btplay are samples to play audio to the headset.

c) Audio players
cd \ce\public\common\sdk\samples\audio\wavplay
build -c
sysgen wavplay
cd ..\wavrec
build -c
sysgen wavrec


Step 2 - Registry settings

You need this for the audio driver to be registered
[HKEY_LOCAL_MACHINE\Drivers\BuiltIn\BtScoSnd]
   "Prefix"="WAV"
   "Dll"="btscosnd.dll"
   "Order"=dword:25

The following is read by the audio driver
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Bluetooth\ScoWav]
   "Direction"=dword:0
   "AirCoding"=dword:0
   "ConnectInTimeout"=dword:10000
   "8BitSignedSamples"=dword:1

The following registry setting is for USB and will be set to 0 by default:
[HKEY_LOCAL_MACHINE\Software\Microsoft\Bluetooth\Transports\BuiltIn\1]
   "IsochAltSetting"=dword:1     

The following registry setting directs the audio gateway on how audio data will
be converted to bluetooth.  If MapAudioToPcmMode is 0, then the built-in SCO
audio driver will be used.  Otherwise, the audio gateway will use bthlink.dll to
create a SCO connection and assume their is a hardware solution to convert audio
to SCO data.  In this scenario it is not necessary to have btscosnd or any of its
registry settings (ScoWav).
[HKEY_LOCAL_MACHINE\Software\Microsoft\Bluetooth\AudioGateway]
   "MapAudioToPcmMode"=dword:0


Step 3 - Run the sample

a) Go to Control Panel --> Bluetooth
b) Prepare your headset device and scan for services
c) Pair with the headset service
d) Goto Start->Run and run headsetctl.exe
e) Click the start button on headsetctl

Your headset should now start ringing...

f) Press the headset button to answer the call
g) Go to command prompt and type the following:

> wavrec -d 0 -b 8 -r 8000
"Talk into headset for 5 seconds"
> btplay wavrec.wav
"Listen to headset for 5 seconds"

Note: To play the file to the default audio driver use wavplay

h) You may also play around with the bttalk sample.  It takes no paramters
and sets up a two-way conversation between two audio drivers.