xref: /btstack/port/windows-h4-da14585/README.md (revision c824d78c0a34df89b57d535abafcc7dacf30bb06)
1# BTstack Port for Windows Systems with DA14585 Controller connected via Serial Port
2
3This port allows to use the DA14585 connected via Serial Port with BTstack running on a Win32 host system.
4
5It first downloads the hci_585.hex firmware from the 6.0.8.509 SDK, before BTstack starts up.
6
7Please note that it does not detect if the firmware has already been downloaded, so you need to reset the DA14585 before starting an example.
8
9For production use, the HCI firmware could be flashed into the OTP and the firmware download could be skipped.
10
11Tested with the official DA14585 Dev Kit Basic on OS X and Windows 10.
12
13The 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).
14
15## Visual Studio 2022
16
17Visual Studio can directly open the provided `port/windows-windows-h4-da14585/CMakeLists.txt` and allows to compile and run all examples.
18
19## mingw64
20
21It can also be compiles with a regular Unix-style toolchain like [mingw-w64](https://www.mingw-w64.org).
22mingw64-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.'
23
24We'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.
25
26In the MSYS2 shell, you can install everything with pacman:
27
28    $ pacman -S git
29    $ pacman -S make
30    $ pacman -S mingw-w64-x86_64-toolchain
31    $ pacman -S python
32    $ pacman -S winpty
33
34### Compilation
35
36With mingw64-w64 installed, just go to the port/windows-h4-da14585 directory and run make
37
38    $ cd port/windows-h4-da14585
39    $ make
40
41Note: When compiling with msys2-32 bit and/or the 32-bit toolchain, compilation fails
42as `conio.h` seems to be mission. Please use msys2-64 bit with the 64-bit toolchain for now.
43
44## Console Output
45
46When 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:
47
48    $ winpty ./gatt_counter.exe
49
50The packet log will be written to hci_dump.pklg
51