Bluetooth Catalog Items and Sysgen Variables (Compact 2013)
3/26/2014
Learn about adding a Bluetooth wireless technology stack to your Windows Embedded Compact 2013 OS.
Introduction
In Windows Embedded Compact, you can include a Bluetooth wireless technology stack in your OS.
Note
The Bluetooth wireless technology stack for Windows Embedded Compact requires a Bluetooth wireless technology controller (radio) that is physically attached to the Windows Embedded Compact powered device. You must use a hardware board when you develop and test Bluetooth wireless technology applications for Windows Embedded Compact.
Hands-free devices, modems, human input devices such as keyboard and mouse, and printers are examples of devices that use this technology.
By using various protocols and profiles, Bluetooth wireless technology can perform the following tasks:
- Connect to a modem through a cellular phone.
- Connect to a personal area network (PAN).
- Connect to a wireless keyboard or mouse.
- Connect to a wireless hands-free device.
For more information about how to add or remove catalog items, see Create Your First OS.
Hardware and Software Requirements
- Requires a Bluetooth wireless technology interface (for example, USB, Universal Asynchronous Receiver/Transmitter (UART), BlueCore Serial Protocol (BCSP), or Ambicom).
Catalog Items and Sysgen Variables
The following table shows the catalog items and associated SYSGEN variables that you use to add Bluetooth wireless technology to your OS.
Catalog item |
SYSGEN Variable |
Description |
Dependencies |
|---|---|---|---|
Bluetooth Stack with Universal Loadable Driver |
SYSGEN_BTH |
Adds the core Bluetooth-2.1+ EDR compliant stack (which includes host controller interface (HCI), Logical Link Control and Adaptation Protocol (L2CAP), Radio Frequency Communications (RFCOMM), Service Discovery Protocol (SDP), Serial Port Profile (SPP)), and Secure Simple Pairing (SSP). For more information, see Bluetooth Application Development Reference, Bluetooth Host Controller Interface Reference, and Bluetooth HCI Transport Layer Reference. |
None. |
Bluetooth Settings |
SYSGEN_BTH_SETTINGS |
Provides the Windows Embedded Compact Silverlight based UI Application for Bluetooth Settings and Pairing. |
Requires Silverlight for Windows Embedded (SYSGEN_XAML_RUNTIME), Control Panel based on ConfigManager v1 and CSPs (SYSGEN_CTLPNL2) and Bluetooth Stack (SYSGEN_BTH) with proper BT HCI driver. For more information, see XAML for Windows Embedded Catalog Items and Sysgen Variables and Control Panel Catalog Items and Sysgen Variables. |
Bluetooth HID - Keyboard |
SYSGEN_BTH_HID_KEYBOARD |
Provides keyboard support for the Human Interface Device (HID)-1.0 Profile for wireless keyboards that use Bluetooth wireless technology. For more information, see HID Driver and HID Parser Reference. |
Requires Bluetooth Stack (SYSGEN_BTH) with proper BT HCI driver. |
Bluetooth HID - Mouse |
SYSGEN_BTH_HID_MOUSE |
Provides support for the Human Interface Device (HID)-1.0 Profile for wireless mice that use Bluetooth wireless technology. |
Requires Bluetooth Stack (SYSGEN_BTH) with proper BT HCI driver. |
Bluetooth HS/HF and Audio Gateway Service |
SYSGEN_BTH_AG |
Provides support for the Hands Free Profile (HFP)-1.5 Audio Gateway (AG) role for a Windows Embedded Compact powered device. For more information, see Bluetooth Audio Gateway Service Reference. |
Requires Bluetooth Stack (SYSGEN_BTH) with proper BT HCI driver. |
Bluetooth PAN |
SYSGEN_BTH_PAN |
Adds Personal Area Networking (PAN)-1.0 Profile. All three roles are supported: Network access point (NAP), Group Ad-hoc Networks (GN), and PAN User (PANU) roles. The PAN profile uses the Bluetooth Network Encapsulation Protocol (BNEP). For more information, see PAN Profile Object Identifiers. |
Requires Bluetooth Stack (SYSGEN_BTH) with proper BT HCI driver. |
Bluetooth Profile Management APIs |
SYSGEN_BTH_BTHUTIL |
Provides common profile APIs for basic profile operations such as discovery, enable, disable, connect, and disconnect. |
Requires Bluetooth Stack (SYSGEN_BTH) with proper BT HCI driver. |
Bluetooth services |
SYSGEN_BTH_BTHSSVC |
Includes sample code to support Secure Simple Pairing (SSP) in the OS image |
Requires Bluetooth Stack (SYSGEN_BTH) with proper BT HCI driver. |
Bluetooth samples |
SYSGEN_BTH_SAMPLES |
Includes sample code to demonstrate Secure Simple Pairing (SSP). |
Requires Bluetooth Stack (SYSGEN_BTH) with proper BT HCI driver. |
OBEX Client |
SYSGEN_OBEX_CLIENT |
Initiates a connection to an Object Exchange Protocol (OBEX) server device for exchanging information, such as vCards, which contain contact information. |
Requires Bluetooth Stack (SYSGEN_BTH) with proper BT HCI driver. |
OBEX client samples |
SYSGEN_OBEX_CLIENT_SAMPLES |
Includes OBEX client samples in the OS image. |
Requires Bluetooth Stack (SYSGEN_BTH) with proper BT HCI driver. |
OBEX Server |
SYSGEN_OBEX_SERVER |
Listens for incoming connections from an OBEX client for exchanging information, such as vCards, which contain contact information. |
Requires Bluetooth Stack (SYSGEN_BTH) with proper BT HCI driver and Servicesd.exe (SYSGEN_SERVICES). |
OBEX server samples |
SYSGEN_OBEX_SERVER_SAMPLES |
Includes OBEX client samples in the OS image. |
Requires Bluetooth Stack (SYSGEN_BTH) with proper BT HCI driver. |
OBEX File Browser |
SYSGEN_OBEX_FILEBROWSER |
Provides a folder/file system of information for an OBEX client to browse for finding or adding information, such as vCards, which contain contact information. |
Requires OBEX Server (SYSGEN_OBEX_SERVER). |
OBEX Inbox |
SYSGEN_OBEX_INBOX |
Provides a service that an OBEX client uses to query or add objects, such as vCards, which contain contact information. |
Requires OBEX Server (SYSGEN_OBEX_SERVER). |
Bluetooth utilities |
SYSGEN_BTH_UTILS |
Adds the Btloader.exe sample utility application for testing and debugging the Bluetooth wireless technology stack. |
Requires Bluetooth Stack (SYSGEN_BTH) with proper BT HCI driver and the Console Window (SYSGEN_CONSOLE). For more information, see Console Catalog Items and Sysgen Variables. |
Bluetooth audio |
SYSGEN_BTH_AUDIO |
Adds the sample Bluetooth synchronous connection oriented (SCO) audio driver, an HCI extension layer that implements an audio driver that sends and receives Bluetooth SCO audio data. The compiled sample generates Btscosnd.dll. For more information, see Protocol Extension Samples |
Requires Bluetooth Stack (SYSGEN_BTH) with proper BT HCI driver. |
Bluetooth modem |
SYSGEN_BTH_MODEM |
Adds the Bluetooth DUN Gateway Support Catalog item to the OS design. This functionality supports the Bluetooth DUN profile. A Windows Embedded Compact 2013 device can use this item to behave like a dial-up modem to other Bluetooth-enabled devices. |
Requires Bluetooth Stack (SYSGEN_BTH) with proper BT HCI driver. |
Note
For information about the IMG environment variables that include or exclude various Bluetooth wireless technology modules from your run-time image, see IMG Environment Variables.