建立 MAG160C 逆向工程交接仓库

2026-08-11 19:08:44 +08:00
commit 8409b27ba3
3135 changed files with 534408 additions and 0 deletions
@@ -0,0 +1,55 @@
+# 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, ...).