Files
MAG160C/csdk

MAG160C C SDK (csdk/)

Pure C reimplementation of the MAG160C thermal camera SDK, written from the recovered protocol (see analysis/protocol_spec.md for the full reverse engineering report). The previous C++ implementation was archived to analysis/legacy-cpp/; this tree replaces it.

Layout

csdk/
  include/mag160c/mag160c.h   public C ABI (error domain, magic codes, frame
                              format, temperature API, TCM framing)
  src/
    mag160c_internal.h        shared helpers (last-error)
    mag160c_error.c           TLS last-error + error names
    mag160c_frame.c           0x1bb1b11b frame parse + streaming assembler
    mag160c_temp.c            Calibration / ConvertResponse2Temperature / T2E
    mag160c_tcm.c             FTDICommand 0x7e framing + rotate/light builders
    mag160c_ir.c              libusb session (link/start/stop/ffc/info)
    mag160c_tables.h          T2E + E2TAccQ10 tables (generated from binary)
  tools/mag160c_cli.c         CLI: ir-info, ffc, start, stop, tcm-rotate,
                              tcm-light, frame-test, temp-test
  tests/                      test_frame, test_temp, test_tcm, test_api

Build

cmake -B build -S csdk          # auto-detects libusb-1.0 via pkg-config
cmake --build build
ctest --test-dir build

Without libusb-1.0 the IR session APIs return MAG160C_ERR_NOT_SUPPORTED; the pure helpers (frame parse, temperature math, TCM framing) and their tests work with no dependencies. Threads (pthread) are used when available.

Recovered protocol summary

  • VID 0x833C, config value 2, interface 0.
  • Commands: EP OUT 0x03, 8-byte packets {u32 magic, u32 param} (0x3c-byte with 0x38-byte payload for DDT). Response: EP IN 0x82 (0x1000 max, 2000 ms).
  • Magic commands: 0x6bb6b66b/66c prepare, 66d/66e DDT, 66f info, 670 version, 672 FFC, 673 start, 674 stop, 676/677 set params.
  • Magic responses: 0x5bb5b55b..55f (0x38-byte info blocks / 0x10 pair), 0x5bb5b57b file header.
  • Frame stream: EP IN 0x81, marker 0x1bb1b11b @0, counter @4, data length @8, type @0xc (0 response / 1 raw), shutter @0x10, pixels @0x1c (uint16 LE), trailing 0x1bb1b11c @0x1c+len, frame size 0x38+len.
  • Temperature: per-pixel piecewise-linear Calibration with baseline, ConvertResponse2Temperature auto-gain, T2E curve (0x112 entries) with Q13 band interpolation.
  • TCM: FTDICommand 0x7e framing with additive (mod-256) checksums; command table main 0x02 (rotate 0x77, light 0x31/32/33, ...).