Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 26 additions & 7 deletions documentation-site/docs/openprinttag/supported-tags.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,15 +14,24 @@ NTAG and MIFARE tags (NFC-A, ISO 14443A) are found and named, but nothing on the
| Memory | 80 blocks of 4 bytes (320 bytes) |
| Tag ID (UID) | Starts with `E0:04`, the NXP manufacturer code |
| Content | Blank, or already an OpenPrintTag |
| Protection | No locked blocks, no write protection |
| Protection | No locked blocks in the first 78 blocks (0–77), no write protection |

The station uses the first 312 bytes (blocks 0–77) and never touches the last two blocks.
Those two blocks may be locked; the station reads their lock state but does not act on it.
The tag's ID is permanent; writing or clearing does not change it.

## What "blank" means

For the station, blank means **every byte of the data area is zero**.
It then shows `BLANK TAG` / `Ready to use` on the touchscreen (browser: **Blank tag**, **Ready to write**).
For the station, blank means **every byte of the data area (blocks 0–77) is zero**.

A blank tag is shown like this:

| Where | What you see |
|---|---|
| Touchscreen, Home | `COMPATIBLE BLANK TAG`, `Ready to write`, `Open Manage tag to choose a spool` |
| Touchscreen, **Manage tag** | `BLANK TAG`, `Ready to use` and the tag's ID, with the button **WRITE TAG** |
| Browser, Dashboard | `Blank tag`, `Ready to write`, with the buttons **Write tag** and **Write tag for a spool** |
| Browser, **Manage tag** | `Compatible blank tag`, `Ready to write`, with the badge `Blank` |

Many NFC stickers are sold for phones and arrive "formatted" or with a web link stored on them.
Those are not blank. The station shows `This tag can't be used as it is`,
Expand All @@ -39,10 +48,20 @@ and it cannot erase them: **CLEAR / REUSE** only works on tags that hold OpenPri
| Tag | What happens |
|---|---|
| NTAG213 / 215 / 216, MIFARE Classic and other NFC-A (ISO 14443A) tags | Found and named, not read: the touchscreen says `Tag type not supported yet` with the tag's kind and ID, the browser `Not supported yet`. Reading them is planned (NTAG: issue #95, MIFARE Classic: issue #94). |
| NFC-B or NFC-F tags | The reader does not see them at all. The screen keeps showing `PLACE A TAG`. |
| NFC-B or NFC-F tags | The reader does not see them at all. Home keeps showing `Place a spool`, and **Manage tag** keeps showing `PLACE A TAG`. |
| ISO 15693 tags that are not SLIX2 (other maker, other memory size) | The station reads them, so OpenPrintTag data on them is shown. A blank one shows `This tag can't be used as it is`. Writing and clearing are refused with `Incompatible tag: this release approves NXP 80 x 4-byte SLIX2 only`. |
| ISO 15693 tags with more than 4096 bytes of memory, or blocks larger than 32 bytes | The station does not read them. Home shows `Place a spool`, **Manage tag** shows `PLACE A TAG`, and the NFC READER setup step says `NFC reader problem. Check the NFC wiring.` The browser's **Manage tag** shows `NFC reader error` with `NFC-V tag geometry is invalid or too large` (too much memory) or `Unsupported NFC-V geometry` (blocks too large). |
| SLIX2 with phone formatting, a web link or other data | `This tag can't be used as it is` |
| SLIX2 with locked blocks | `Tag has protected blocks` |
| SLIX2 with locked blocks among blocks 0–77 | The tag is read and shown as usual. Writing and clearing are refused with `Tag has protected blocks`. |

A tag that can't be used is shown like this:

| Where | What you see |
|---|---|
| Touchscreen, Home | `Place a spool`, as if no tag were there |
| Touchscreen, **Manage tag** | `This tag can't be used as it is`, the reader's reason, and `Use a blank NXP ICODE SLIX2 tag.` |
| Browser, Dashboard | `Reading spool…` and `Tag needs attention` |
| Browser, **Manage tag** | The badge `Unsupported` and `OpenPrintTag decode failed / unsupported` |

## Buying

Expand All @@ -54,8 +73,8 @@ and it cannot erase them: **CLEAR / REUSE** only works on tags that hold OpenPri

## Test a new tag

1. Place **one** tag on the reader.
2. Touchscreen: tap **MANAGE TAG**. Browser: the Dashboard shows the tag.
1. Place **one** tag on the reader. With two tags, **Manage tag** says `Two tags on the reader. Remove one.`
2. Touchscreen: Home shows `COMPATIBLE BLANK TAG`; tap **MANAGE TAG**. Browser: the Dashboard shows the tag.
3. A usable new tag shows `BLANK TAG` / `Ready to use` and the button **WRITE TAG**
(browser: **Blank tag** and **Write tag**).

Expand Down
Loading