You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: fix hardware to rfidfriend magic SLIX-L, drop stub README
The tag question is settled, so the plan now states the hardware as a
given instead of hedging. Non-working tag classes move into a
troubleshooting subsection for docs/HARDWARE.md and double as test
hardware for the CLI.
Removes the placeholder README.md; the plan specifies the real one as
part of the documentation phase.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Gd1Q57zANnKAPN5hc8m3Es
Copy file name to clipboardExpand all lines: plan.md
+23-19Lines changed: 23 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -28,16 +28,17 @@ Build a repository that:
28
28
| Host OS | macOS on Apple Silicon (ARM64) |
29
29
| Reader/Writer | "Proxmark3 512M" from AliExpress — a **Proxmark3 Easy clone** with a 512 KB ARM MCU. Runs the Iceman (RfidResearchGroup) firmware, built with `PLATFORM=PM3GENERIC`. |
30
30
| Toniebox |**Stock / unmodified** (no TeddyCloud, no HackieboxNG) → cloning a real Tonie UID is the only viable path |
31
-
| Tags |**Magic SLIX-L with changeable UID** (see §2.3). The AliExpress "SLIX 15693 Dia 30 mm … programmable RFID sticker" the user already owns is expected *not*to work — see §2.4. |
31
+
| Tags |**Magic SLIX-L with changeable UID from [rfidfriend.com](http://rfidfriend.com)** — assume the user has these. See §2.3 for why nothing else works and §4.4 for how to write them. |
32
32
| Python |`python3` from Xcode Command Line Tools (3.9+). **Standard library only** — no `pip install` step for the end user. |
33
33
34
34
---
35
35
36
36
## 2. Hardware reality check — READ BEFORE WRITING CODE
37
37
38
-
This section does **not** change what we build, but it determines whether the hardware
39
-
the user already bought will work. The CLI must surface these facts to the user instead
40
-
of failing cryptically.
38
+
The hardware is settled: a stock Toniebox and magic SLIX-L tags from rfidfriend.com.
39
+
This section records *why* that is the only combination that works, so the CLI can
40
+
explain failures instead of dying cryptically — and so nobody "simplifies" the write
41
+
sequence in §4.4 back into something that bricks tags.
41
42
42
43
### 2.1 What a Toniebox actually checks
43
44
@@ -86,28 +87,31 @@ tag's own UID requires a modified box (TeddyCloud / HackieboxNG) and is out of s
86
87
| Genuine SLIX-L, fixed UID | ❌ | UID is unknown to the cloud → box ignores it. Only useful on a modified box. |
87
88
| Genuine SLIX (the AliExpress stickers, see below) | ❌ | Wrong UID prefix *and* no privacy support. |
88
89
89
-
### 2.4 The tags the user already owns
90
+
### 2.4 Tag classes that do *not* work (for `docs/HARDWARE.md` troubleshooting)
90
91
91
-
AliExpress "Echtes SLIX 15693 Dia 30 mm … programmierbarer RFID-Aufkleber".
92
-
"Programmable" refers to the **memory**, not the UID. The listing's reviews are the
93
-
tell — every positive report describes a **patched** box:
92
+
The user also owns AliExpress "SLIX 15693 Dia 30 mm … programmable RFID sticker" and may
93
+
have generic magic tags (ICODE SLI / SLIX2 / TAG-it TI2048). None of them drive a stock
94
+
box; record why, because these are the listings anyone shopping for replacements will
95
+
hit first:
94
96
95
-
> "Funktioniert perfekt mit meiner Toniebox (CC3200), die den benutzerdefinierten Bootloader HackieboxNG verwendet."
96
-
> "Funktioniert mit Toniebox/Teddycloud mit aktivierten Patches."
97
+
***Plain SLIX stickers** — "programmable" refers to the *memory*, not the UID. Every
98
+
positive review of these describes a **patched** box ("Toniebox (CC3200) mit
99
+
HackieboxNG", "Toniebox/Teddycloud mit aktivierten Patches"). The patch in question is
100
+
the HackieboxNG OFW patch that allows tags *without* privacy-password support, i.e.
0 commit comments