xref: /btstack/port/windows-winusb/README.md (revision 0561b2d8d5dba972c7daa57d5e677f7a1327edfd)
1# BTstack port for Windows Systems using the WinUSB Driver
2
3The Windows-WinUSB port uses the native run loop and WinUSB API to access a USB Bluetooth dongle.
4
5## Access to Bluetooth USB Dongle with Zadig
6
7To 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.
8
9It works like this:
10
11-  Download [Zadig](http://zadig.akeo.ie)
12-  Start Zadig
13-  Select Options -> “List all devices”
14-  Select USB Bluetooth dongle in the big pull down list
15-  Select WinUSB (libusb) in the right pull pull down list
16-  Select “Replace Driver”
17
18## Toolchain
19
20The port requires a Unix-like toolchain. We successfully used [mingw-w64](https://mingw-w64.org/doku.php) to compile and run the examples. mingw64-w64 is based on [MinGW](mingw.org), 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.'
21
22We've used the Msys2 package available from the [downloads page](https://mingw-w64.org/doku.php/download) on Windows 10, 64-bit and use the MSYS2 MinGW 64-bit start menu item to compile 64-bit binaries.
23
24In the MSYS2 shell, you can install everything with pacman:
25
26    $ pacman -S git
27    $ pacman -S make
28    $ pacman -S mingw-w64-x86_64-toolchain
29    $ pacman -S python
30    $ pacman -S winpty
31
32## Compilation
33
34With mingw64-w64 installed, just go to the port/windows-winusb directory and run make
35
36    $ cd btstack/port/windows-winusb
37    $ make
38
39## Console Output
40
41When 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:
42
43    $ winpty ./spp_and_le_counter.exe
44
45