Add cross-platform Windows and Linux CI builds

Introduce a reproducible CMake build and GitHub Actions matrix for Ubuntu Linux x64 and Windows x64. Each platform installs libusb, builds the usbboot executable, and publishes a platform-specific artifact containing the executable, required boot binaries, and documentation. The Windows artifact also includes libusb-1.0.dll.

Add a small Windows getopt_long compatibility layer because the Microsoft CRT does not provide the POSIX GNU option parser used by usbboot. Add Windows sleep support and make the source explicitly include the fixed-width integer and time headers needed by the cross-platform build.

Replace C99 variable-length arrays with checked heap allocations so the source compiles with MSVC, which does not support VLAs. Cast libusb request-type flags to avoid MSVC enum warnings, and use a conforming cleanup(void) callback signature for atexit(). Correct the existing cleanup NULL check so an open libusb handle is actually closed.

Document local CMake builds, CI artifacts, the Windows libusb DLL, and the requirement to bind the boot-mode device to WinUSB before use.

Credit: OpenAI Codex (GPT-5), collaborating with dark98 on the Windows port and CI implementation.
This commit is contained in:
dark98
2026-08-17 01:00:33 +01:00
parent c65eaa337c
commit 2324280493
6 changed files with 312 additions and 12 deletions
+15
View File
@@ -3,6 +3,21 @@
`make`
Cross-platform release artifacts are built by GitHub Actions for Linux x64 and
Windows x64. See the workflow runs under the repository's Actions tab.
For a local CMake build, install CMake and libusb-1.0, then run:
```sh
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release
```
On Windows, install libusb through vcpkg and configure CMake with the vcpkg
toolchain file. The Windows artifact includes `libusb-1.0.dll` beside
`usbboot.exe`. Before using it, bind the boot-mode device to WinUSB with a
tool such as Zadig.
## Running
To see console output, a USB to TTL adapter is needed. For the Creality K1 board, the serial pinout is by the reset/boot botton.