General Usage

Bluetooth Sleuth is designed to be a utility for exposing the wide assortment of features that Apple's iOS and macOS devices offer via Bluetooth

Advertising

The advertising section allows you to set up your device to broadcast specific information.

  1. Services allows you to either generate random CBUUIDs or provide your own valid CBUUID. Once entered, you can configure the service, add characteristics, and descriptors. These will be shared with your advertisement
  2. Advertisement Service allows you to associate a valid CBUUID with the advertisement. This can be used by scanners to restrict your advertisement
  3. Advertisement Local Name allows you to provide a name for the advertisement. This will not appear in the scan, but can be viewed by a connected central

Once configured, you can begin advertising your device

Scan

The scan section will search for available peripherals.

  1. You can provide one or more service CBUUIDs to restrict the devices found
  2. When the Service CBUUID field is left blank, all devices will be returned
  3. Any discovered device that supports connections (as shown by the image) will begin a connection when clicked
  4. If a device fails to connect within 10 seconds, the connection will fail
  5. Once connected, your can view peripheral data, advertisement data, and all services
  6. You can disconnect from a peripheral with the button that will appear under the connected device

Search

The search feature can view and filter 16 bit UUID numbers assigned by the Bluetooth organization

  1. Search values by allocation type, such as company, characteristic or service type

Broadcast

The broadcast section will turn your device into an iBeacon

  1. You must provide a valid UUID to begin broadcasting
  2. Optionally, you may generate a random UUID to broadcast
  3. The Beacon identifier is an optional field to help label your beacon
  4. Beacon values are optional, and help to further refine iBeacon observations.
  5. If using beacon values, you can either provide only a major, or a major and minor. Using only a minor value is not possible
  6. Measured power is an optional value, and generally should be left to its default value. This supports cases where you need to obtain a precise output value at 1m

Range

The range section will allow you to discover other iBeacons

  1. You must provide a valid UUID that matches the broadcasting device to begin ranging
  2. The Beacon identifier is an optional field to help label your beacon
  3. Beacon values are optional, and help to further refine iBeacon observations. If your values differ from assigned values of the broadcasting iBeacon, then you will not see it
  4. Once you start ranging, any iBeacons that satisfy the provided criteria will display.

Monitor

The monitor section will allow you to discover when you are entering and exiting the presence of other iBeacons

  1. You must provide a valid UUID that matches the broadcasting device to begin ranging
  2. Beacon values are optional, and help to further refine iBeacon observations. If your values differ from assigned values of the broadcasting iBeacon, then you will not see it
  3. Once you start monitoring, any iBeacons that satisfy the provided criteria will trigger updates in your region status. These updates may not occur immediately due to device throttling of location services.