Add bambu-nfc dump parse, Key-A HKDF, and spool merge.

Parse filanfc-dump/v1 zip/JSON, Bambu 1K images, and merge stickers by tray UID. dump and mifare packages stay importable for a later common library.
2026-08-23 15:23:11 -05:00
parent a794db4838
commit b38f7f643b
29 changed files with 893 additions and 0 deletions
@@ -0,0 +1,21 @@
+# bambu-nfc
+
+Go library for Bambu Lab filament NFC dumps produced by the Filament NFC dump Android app.
+
+```go
+import bambunfc "git.s1d3sw1ped.com/s1d3sw1ped/bambu-nfc"
+
+tags, err := bambunfc.ParseZip(r)
+spools, err := bambunfc.Merge(tags)
+keys, err := bambunfc.KeysA(uid)
+```
+
+- `dump` — brand-blind `filanfc-dump/v1` JSON/zip
+- `mifare` — Classic 1K layout helpers
+- root package — Bambu Key-A HKDF, block parse, merge by `tray_uid`
+
+`Brand` is `"Bambu Lab"` on a successful parse.
+
+```bash
+go test -race ./...
+```