RefuhrandClaude Opus 5
c39c8660d7
MSVC rejects a calling convention placed before the '*' of a pointer return type with C2165, so every translation unit including candle.h failed to compile. MinGW accepts the upstream spelling, which is why the cross build did not catch this. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XZnuZJ7zc3e8hk6C8bGDZN
30 lines
1.4 KiB
Markdown
30 lines
1.4 KiB
Markdown
# candle API (gs_usb / candleLight Windows driver)
|
|
|
|
Vendored copy of the candle Windows API used by SavvyCAN's gs_usb
|
|
connection (`connections/gs_usb.cpp`). It talks to gs_usb class devices
|
|
(candleLight, CANable, CANnectivity, cantact, ...) over WinUSB, so no vendor
|
|
driver is needed — only a WinUSB binding on the device interface (which the
|
|
stock candleLight/CANable firmware already declares via WCID descriptors).
|
|
|
|
## Provenance
|
|
|
|
- Original: <https://github.com/HubertD/candle_dll> — Copyright (c) 2016 Hubert Denkmair
|
|
- This copy: <https://github.com/Schildkroet/CANgaroo>, `src/driver/CandleApiDriver/api/`
|
|
at commit `ed3088d5393e02a01afe867af2ee8ab0e12db039`, which adds CAN FD,
|
|
multi-channel and hardware timestamp support — Copyright (c) 2026 Schildkroet
|
|
|
|
## Local changes
|
|
|
|
Kept to the minimum needed to build here; re-apply them when refreshing from upstream.
|
|
|
|
- `candle.h` / `candle.c`: the three functions returning a pointer declared the calling
|
|
convention before the `*` (`wchar_t __stdcall DLL *candle_dev_get_path`). MinGW accepts
|
|
that, MSVC rejects it with C2165, so `__stdcall` moved behind the `*`.
|
|
|
|
## License
|
|
|
|
These files are **LGPL-3.0**, not MIT like the rest of SavvyCAN. They are only
|
|
compiled into Windows builds. Keep `LICENSE` alongside them, and keep the files
|
|
separable so the LGPL relinking provision can be satisfied. Do not copy code out
|
|
of this directory into the MIT-licensed parts of the tree.
|