From 7f033bb64506af9211e4a7df208bbd9c6a2612a3 Mon Sep 17 00:00:00 2001 From: jessikitty Date: Wed, 23 Sep 2026 20:28:46 +1000 Subject: [PATCH] docs: add .claude-context project overview --- .claude-context/00-overview.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 .claude-context/00-overview.md diff --git a/.claude-context/00-overview.md b/.claude-context/00-overview.md new file mode 100644 index 0000000..6aa3915 --- /dev/null +++ b/.claude-context/00-overview.md @@ -0,0 +1,26 @@ +# LEGO Dimensions Portal Reader + +Python module for communicating with LEGO Dimensions USB portals (PS3/PS4/Wii U versions) to detect character and vehicle disc placement/removal events. + +**Repository:** https://gitea.hideawaygaming.com.au/jessikitty/lego-dimensions-reader + +## Purpose +Drives the Moonlight Drive-In video player system — placing a LEGO Dimensions character disc triggers themed video playback and LED light effects. + +## Architecture +- **Core module:** `lego_dimensions_reader.py` — event-driven NFC tag detection with callbacks +- **Character database:** `character_database.json` — maps IDs to character/vehicle names +- **Integration:** `moonlight_integration.py` — connects portal events to video player + +## Key Features +- Tag insert/remove callbacks +- LED control: solid color, flash, fade, rainbow cycle +- TEA encryption/decryption for character ID extraction +- Built-in character (82) and vehicle (82) databases +- Cross-platform: Linux native, Windows via WinUSB/Zadig + +## Session Log +- 2026-09-23 — Windows Driver Fix — Resolved pyusb backend issues on Windows 11; requires `pip install libusb` and Zadig WinUSB driver + +--- +*Created by: Jess Rogerson (yelling commands at Claude.AI)*