xref: /btstack/port/windows-h4/README.md (revision a8d51f092f1b660d0f6921369ad2bc3f9368296c)
1# BTstack Port for Windows Systems with Bluetooth Controller connected via Serial Port
2
3The Windows-H4 port uses the native run loop and allows to use Bluetooth Controllers connected via Serial Port.
4
5Make sure to manually reset the Bluetooth Controller before starting any of the examples.
6
7## Toolchain
8
9The 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.'
10
11We'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.
12
13In the MSYS2 shell, you can install everything with pacman:
14
15    $ pacman -S git
16    $ pacman -S make
17    $ pacman -S mingw-w64-x86_64-toolchain
18    $ pacman -S python
19    $ pacman -S winpty
20
21## Compilation
22
23With mingw64-w64 installed, just go to the port/windows-winusb directory and run make
24
25    $ cd btstack/port/windows-winusb
26    $ make
27
28Note: When compiling with msys2-32 bit and/or the 32-bit toolchain, compilation fails
29as `conio.h` seems to be mission. Please use msys2-64 bit with the 64-bit toolchain for now.
30
31## Console Output
32
33When 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:
34
35    $ winpty ./spp_and_le_counter.exe
36
37