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 7The port provides both a regular Makefile as well as a CMake build file. It uses native Win32 APIs for file access and does not require the Cygwin or mingw64 build/runtine. All examples can also be build with Visual Studio 2022 (e.g. Community Edition). 8 9## Visual Studio 2022 10 11Visual Studio can directly open the provided `port/windows-windows-h4/CMakeLists.txt` and allows to compile and run all examples. 12 13## mingw64 14 15It can also be compiles with a regular Unix-style toolchain like [mingw-w64](https://www.mingw-w64.org). 16mingw64-w64 is based on [MinGW](https://en.wikipedia.org/wiki/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.' 17 18We've used the Msys2 package available from the [downloads page](https://www.mingw-w64.org/downloads/) on Windows 10, 64-bit and use the MSYS2 MinGW 64-bit start menu item to compile 64-bit binaries. 19 20In the MSYS2 shell, you can install everything with pacman: 21 22 $ pacman -S git 23 $ pacman -S make 24 $ pacman -S mingw-w64-x86_64-toolchain 25 $ pacman -S python 26 $ pacman -S winpty 27 28### Compilation 29 30With mingw64-w64 installed, just go to the port/windows-h4 directory and run make 31 32 $ cd port/windows-h4 33 $ make 34 35Note: When compiling with msys2-32 bit and/or the 32-bit toolchain, compilation fails 36as `conio.h` seems to be mission. Please use msys2-64 bit with the 64-bit toolchain for now. 37 38## Console Output 39 40When 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 42 $ winpty ./gatt_counter.exe 43 44The packet log will be written to hci_dump.pklg 45 46