K2 Material Catalog, Firmware, and Mac App Updates

.gitignore

@@ -1 +1,58 @@
+# macOS
 .DS_Store
+.AppleDouble
+.LSOverride
+._*
+.Spotlight-V100
+.Trashes
+
+# Xcode
+mac-app/build/
+mac-app/DerivedData/
+mac-app/*.xcodeproj/project.xcworkspace/xcuserdata/
+mac-app/*.xcodeproj/xcuserdata/
+*.xcuserstate
+*.xcscmblueprint
+*.xccheckout
+*.moved-aside
+*.hmap
+*.ipa
+*.dSYM.zip
+*.dSYM
+Timeline.xctimeline
+PlaygroundAlwaysShown
+*.gcno
+*.gcda
+
+# Swift Package Manager
+mac-app/.build/
+mac-app/Packages/
+mac-app/Package.resolved
+
+# CocoaPods (if used)
+mac-app/Pods/
+
+# Arduino / ESP32 firmware builds
+firmware/build/
+firmware/build-*/
+*.elf
+*.map
+*.bin
+!firmware/releases/*.bin
+
+# PlatformIO (if used)
+.pio/
+.pioenvs/
+.piolibdeps/
+
+# IDE and editor files
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Logs and temp files
+*.log
+tmp/
+temp/

docs/API.md

@@ -80,12 +80,19 @@ READY
 
 **TAG_DATA Format:**
 ```
-TAG_DATA:<material>|<length>|#<color>|S/N:<serial>
+TAG_DATA:<material>|<length>|#<color>|S/N:<serial>|ID:<filmID>|VENDOR:<vendorCode>
 ```
 
+- `<material>` — coarse type when known (`PLA`, `PETG`, …), otherwise the raw 6-char film ID
+- `<filmID>` — 6-char RFID film ID (`"1"` + K2 `material_database` base id, e.g. Hyper PLA `01001` → `101001`)
+- `<vendorCode>` — 4-char RFID vendor ID from the tag (e.g. `0276` = Creality, `0000` = Generic)
+
+The Mac app maps `ID:` and `VENDOR:` against the material/brand catalog to show product name and brand.
+
 Example:
 ```
-TAG_DATA:PLA|330m|#9CFF4F|S/N:736314
+TAG_DATA:PLA|330m|#9CFF4F|S/N:736314|ID:101001|VENDOR:0276
+TAG_DATA:106002|330m|#FFFFFF|S/N:123456|ID:106002|VENDOR:0276
 ```
 
 **Timeout:**