Online documentation for BluetoothDiscover

Generated 2006-03-17

Attempts to discover nearby bluetooth device addresses using any local radio(s).

Description

This component uses Windows BluetoothAPI to provide a list of bluetooth devices in range. It can only detect unauthenticated bluetooth devices with discovery enabled, and devices that have already been authenticated with the machine that it is running on. Note that bluetooth discovery and connection timeouts are both relatively slow (of the order of 5-10 seconds).

Installation

Requires a Bluetooth radio on the machine that it runs on. May require WindowsXP and service pack 2 (SP2) to run. Probably requires WindowsXP and SP2 and Microsoft Platform SDK to recompile the native DLL.

Configuration

set the configPollinterval property to adjust the target poll rate (e.g. in range 20-120 seconds); the bluetooth discovery time is set to approximately half of the configPollinterval; at short timeout discovery will find random subsets of the devices in range on each poll.
set the configured property to true to cause polling to occur.
you can also, optionally set the configWatchfor property to a comma-separated list of bluetooth addresses of interest. The component will create a boolean dynamic property for each such address (property name is address with ':' mapped to '_').

Usage

The status property will give some indication of status and (low-level) failure, e.g. lack of bluetooth device, and with each attempted poll, the pollcount property will increment to show that is doing something. If the poll was successful, the devices property and any dynamic properties created through configWatchfor will update. The devices property is a comma-separated list of addresses of bluetooth devices discovered or connectable in the last poll, in the form 12:34:56:78:9a:bc. The dynamic properties will be set to true if that address was dicovered.