次の方法で共有


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.
For more information, see HID Driver and HID Parser Reference.

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.

See Also

Other Resources

Bluetooth