btstack/port/windows-winusb
2021-07-05 16:10:43 +02:00
..
.gitignore
btstack_config.h
main.c windows: use btstack_stdin_window_register_ctrl_c_callback to trigger shutdown on ctrl-c 2021-07-05 16:10:43 +02:00
Makefile windows: use same cflags for all ports 2021-06-30 23:10:42 +02:00
README.md port: copy edit port readmes, archive ios port 2021-05-31 16:44:53 +02:00

BTstack Port for Windows Systems using the WinUSB Driver

The Windows-WinUSB port uses the native run loop and WinUSB API to access a USB Bluetooth dongle.

Access to Bluetooth USB Dongle with Zadig

To allow libusb or WinUSB to access an USB Bluetooth dongle, you need to install a special device driver to make it accessible to user space processes.

It works like this:

  • Download Zadig
  • Start Zadig
  • Select Options -> “List all devices”
  • Select USB Bluetooth dongle in the big pull down list
  • Select WinUSB (libusb) in the right pull pull down list
  • Select “Replace Driver”

Toolchain

The port requires a Unix-like toolchain. We successfully used mingw-w64 to compile and run the examples. mingw64-w64 is based on MinGW, which '...provides a complete Open Source programming tool set which is suitable for the development of native MS-Windows applications, and which do not depend on any 3rd-party C-Runtime DLLs.'

We've used the Msys2 package available from the downloads page on Windows 10, 64-bit and use the MSYS2 MinGW 64-bit start menu item to compile 64-bit binaries.

In the MSYS2 shell, you can install everything with pacman:

$ pacman -S git
$ pacman -S make
$ pacman -S mingw-w64-x86_64-toolchain
$ pacman -S python
$ pacman -S winpty

Compilation

With mingw64-w64 installed, just go to the port/windows-winusb directory and run make

$ cd btstack/port/windows-winusb
$ make

Note: When compiling with msys2-32 bit and/or the 32-bit toolchain, compilation fails as conio.h seems to be mission. Please use msys2-64 bit with the 64-bit toolchain for now.

Console Output

When running the examples in the MSYS2 shell, the console input (via btstack_stdin_support) doesn't work. It works in the older MSYS and also the regular CMD.exe environment. Another option is to install WinPTY and then start the example via WinPTY like this:

$ winpty ./spp_and_le_counter.exe