Tools for Bluetooth

Debug Tools

Reference Operating System for IoT includes various widely used debug tools for Bluetooth® :

  • hcitool
  • hciconfig
  • hcidump
  • btmon

These tools provide the --help option about usage. Also, there are many resources available publicly to help you use these tools.

Note: sdptool doesn't work well with bluez5. Use the following workaround:

Open the file /lib/systemd/system/bluetooth.service and change the ExecStart line to the following:

ExecStart=/usr/libexec/bluetooth/bluetoothd --compat
systemctl daemon-reload
systemctl restart Bluetooth

BlueZ Tools

The Bluez package provides many useful tools, which are not installed by default. To install them to the image:

In the file meta-ref-os-iot/recipes-image/image/,  add

IMAGE_INSTALL_append = "\
     bluez5-noinst-tools \
           bluez5-obex \
     bluez5-testtools \


For more complete information about compiler optimizations, see our Optimization Notice.