xref: /btstack/port/windows-winusb-intel/README.md (revision f61339ea81eeccfafe4eeece09018b94ef761419)
1*f61339eaSMatthias Ringwald# BTstack port for Windows Systems with Intel Wireless 8260/8265 Controllers
2*f61339eaSMatthias Ringwald
3*f61339eaSMatthias RingwaldSame as port/windows-winusb, but customized for Intel Wireless 8260 and 8265 Controllers.
4*f61339eaSMatthias RingwaldThese controller require firmware upload and configuration to work. Firmware and config is downloaded from the Linux firmware repository.
5*f61339eaSMatthias Ringwald
6*f61339eaSMatthias Ringwald## Access to Bluetooth USB Dongle with Zadig
7*f61339eaSMatthias Ringwald
8*f61339eaSMatthias RingwaldTo 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.
9*f61339eaSMatthias Ringwald
10*f61339eaSMatthias RingwaldIt works like this:
11*f61339eaSMatthias Ringwald
12*f61339eaSMatthias Ringwald-  Download [Zadig](http://zadig.akeo.ie)
13*f61339eaSMatthias Ringwald-  Start Zadig
14*f61339eaSMatthias Ringwald-  Select Options -> “List all devices”
15*f61339eaSMatthias Ringwald-  Select USB Bluetooth dongle in the big pull down list
16*f61339eaSMatthias Ringwald-  Select WinUSB (libusb) in the right pull pull down list
17*f61339eaSMatthias Ringwald-  Select “Replace Driver”
18*f61339eaSMatthias Ringwald
19*f61339eaSMatthias Ringwald## Toolchain
20*f61339eaSMatthias Ringwald
21*f61339eaSMatthias RingwaldThe 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.'
22*f61339eaSMatthias Ringwald
23*f61339eaSMatthias RingwaldWe'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 32-bit start menu item to compile 32-bit binaries that run on both 32/64-bit systems.
24*f61339eaSMatthias Ringwald
25*f61339eaSMatthias RingwaldIn the MSYS2 shell, you can install git, python, and, winpty with pacman:
26*f61339eaSMatthias Ringwald
27*f61339eaSMatthias Ringwald    $ pacman -S git
28*f61339eaSMatthias Ringwald    $ pacman -S python
29*f61339eaSMatthias Ringwald    $ pacman -S winpty
30*f61339eaSMatthias Ringwald
31*f61339eaSMatthias Ringwald## Compilation
32*f61339eaSMatthias Ringwald
33*f61339eaSMatthias RingwaldWith mingw64-w64 installed, just go to the port/windows-winusb directory and run make
34*f61339eaSMatthias Ringwald
35*f61339eaSMatthias Ringwald    $ cd btstack/port/windows-winusb
36*f61339eaSMatthias Ringwald    $ make
37*f61339eaSMatthias Ringwald
38*f61339eaSMatthias Ringwald## Console Output
39*f61339eaSMatthias Ringwald
40*f61339eaSMatthias RingwaldWhen 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:
41*f61339eaSMatthias Ringwald
42*f61339eaSMatthias Ringwald    $ winpty ./spp_and_le_counter.exe
43*f61339eaSMatthias Ringwald
44