Skip to content

Commit 25f60e6

Browse files
committed
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
1 parent d9d1815 commit 25f60e6

2 files changed

Lines changed: 23 additions & 20 deletions

File tree

README.md

Lines changed: 0 additions & 1 deletion
This file was deleted.

plan.md

Lines changed: 23 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -28,16 +28,17 @@ Build a repository that:
2828
| Host OS | macOS on Apple Silicon (ARM64) |
2929
| 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`. |
3030
| 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. |
3232
| Python | `python3` from Xcode Command Line Tools (3.9+). **Standard library only** — no `pip install` step for the end user. |
3333

3434
---
3535

3636
## 2. Hardware reality check — READ BEFORE WRITING CODE
3737

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.
4142

4243
### 2.1 What a Toniebox actually checks
4344

@@ -86,28 +87,31 @@ tag's own UID requires a modified box (TeddyCloud / HackieboxNG) and is out of s
8687
| Genuine SLIX-L, fixed UID || UID is unknown to the cloud → box ignores it. Only useful on a modified box. |
8788
| Genuine SLIX (the AliExpress stickers, see below) || Wrong UID prefix *and* no privacy support. |
8889

89-
### 2.4 The tags the user already owns
90+
### 2.4 Tag classes that do *not* work (for `docs/HARDWARE.md` troubleshooting)
9091

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:
9496

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.
101+
plain SLIX. Fixed `E0 04 02…` UID, wrong chip class.
102+
* **Generic magic ISO 15693** (ICODE SLI, SLIX2, TAG-it TI2048) — UID *is* changeable,
103+
so `E0 04 03…` can be written, but the chip is not SLIX-L and fails the box's
104+
privacy-password step. This is why "cloning a Tonie" was long considered impossible.
105+
* **Genuine SLIX-L with fixed UID** — right chip, but the UID belongs to no Tonie, so
106+
the cloud lookup finds nothing. This is the TeddyCloud product.
97107

98-
The patch in question is exactly the HackieboxNG OFW patch that allows tags *without*
99-
privacy-password support (i.e. plain SLIX). Needing that patch is strong evidence the
100-
stickers are genuine SLIX with a fixed `E0 04 02…` UID — not magic, not SLIX-L.
101-
No review claims a stock box works.
102-
103-
**Expected outcome: these stickers will not work for this project.** Say so in the
104-
README, do not let the user discover it after 30 failed writes. They remain usable if
105-
the box is ever modified.
108+
All of these remain useful as **development/test tags** (§2.5).
106109

107110
### 2.5 The 2-minute verification the user runs first
108111

109112
`./tonie doctor [--probe-magic]` reports the tag's UID prefix and whether the magic UID
110-
write takes. Document the three outcomes plainly:
113+
write takes. With the rfidfriend tags the expected result is the first row; the other
114+
two exist so a wrong batch or a mixed-up bag of tags is diagnosed in seconds:
111115

112116
| Outcome | Meaning | What to do |
113117
|---------|---------|------------|

0 commit comments

Comments
 (0)