Leggi, verifica e scrivi chip NFC TigerTag da JavaScript.
L'SDK del protocollo aperto TigerTag per filamento e resina da stampa 3D: trasforma i byte di un chip in materiale, colore, parametri di stampa e quantità, verifica la sua firma ECDSA-P256 offline e costruisce nuovi tag byte per byte.
npm install tigertagconst { TigerTag } = require('tigertag');
const tag = TigerTag.fromPages(uid, payload); // from your NFC SDK
console.log(tag.pretty()); // human-readable summary
console.log(String(tag.verify())); // VALID / NOT SIGNED / INVALID
console.log(tag.toDict()); // JSON-ready objectInstalla il pacchetto, leggi un chip con la tua libreria NFC, scrivine uno nuovo. Le tabelle di riferimento incluse fanno funzionare il primo avvio senza rete.
Dal registro npm. pnpm, yarn e bun installano lo stesso pacchetto.
npm install tigertagpnpm add tigertag
yarn add tigertag
bun add tigertagPassa l'UID di 7 byte e i 144 byte letti dalla tua libreria NFC. Qui con nfc-pcsc e un ACR122U.
// Node.js — nfc-pcsc (ACR122U / PN532)
reader.on('card', async (card) => {
const uid = Buffer.from(card.uid, 'hex'); // 7 bytes
const payload = await reader.read(4, 144, 4); // pages 4–39, 144 bytes
const tag = TigerTag.fromPages(uid, payload);
console.log(tag.pretty());
console.log(String(tag.verify())); // VALID / NOT SIGNED
});Ogni modifica restituisce un nuovo TigerTag; toBytes() dà i byte da riscrivere. erase() dà un chip vuoto.
// Immutable surgical update — returns a new TigerTag, original unchanged
const patched = tag.patch({ nozzleTempMin: 200, dryTemp: 55 });
// Erase a chip — write the returned 80 bytes to the NFC chip
const blankBytes = TigerTag.erase();Un solo pacchetto per ogni aspetto di un chip TigerTag: leggere, verificare, scrivere e tenere aggiornati i dati.
fromPages(), fromDump() e fromFile() accettano un UID con 80 o 144 byte, o un dump completo di 180 byte. pretty(), describe(), toDict() e toRawDict() restituiscono testo, un paragrafo in linguaggio naturale o oggetti pronti per JSON.
verify() controlla la firma ECDSA-P256 che lega l'UID del chip ai suoi dati di prodotto, con la chiave pubblica inclusa nel pacchetto. Il risultato è valid, invalid, unsigned, no_key o no_uid.
create(), asInit(), patch() ed erase() costruiscono i byte del chip. Un TigerTag è immutabile: patch() ne restituisce uno nuovo e rifiuta di cambiare idTigertag, idProduct, uid o la firma.
TigerTag.fromCatalog(productId) costruisce un TigerTag+ completo dal catalogo ufficiale dei prodotti, scaricato al primo uso e salvato in una cartella di cache per utente.
Per i chip TigerTag+, rawApi(), diffApi() e patchFromApi() recuperano i dati attuali del marchio, elencano le differenze con il chip e le applicano.
Le tabelle di materiale, marca, aspetto, tipo, diametro e unità sono incluse nel pacchetto. Un controllo in background le aggiorna al massimo una volta al giorno; offline: true o TIGERTAG_OFFLINE=1 significa zero chiamate di rete.
L'SDK legge e scrive i tre tipi di tag del protocollo TigerTag v2.2, su chip NTAG213, NTAG215 e NTAG216.
Tutti i campi sul chip, leggibili completamente offline.
Un modello vuoto, pronto da programmare. TigerTag.asInit() ne crea uno.
Tutti i campi sul chip, più un ID prodotto collegato all'API cloud per gli aggiornamenti del produttore. Un chip firmato si verifica con verify().
Il pacchetto installa un comando tigertag e funziona nel processo principale di un'app Electron.
Interpreta un dump come testo, JSON o campi grezzi, e aggiorna le tabelle di riferimento su richiesta.
# Parse a dump file
tigertag dump.bin
# JSON output
tigertag dump.bin --json
# Update the reference tables now (into the data dir)
tigertag updateInterpreta i chip nel processo principale, senza sottoprocessi da distribuire.
// main.js — replace parseTigerTag() subprocess dependency
const { TigerTag, TigerTagDB } = require('tigertag');
function parseTigerTag(payload, uid) {
const tag = TigerTag.fromPages(Buffer.from(uid), Buffer.from(payload));
const db = new TigerTagDB();
return {
dict: tag.toDict(db),
raw: tag.toRawDict(),
sig: tag.verify(db).toDict(),
};
}Una pagina web locale, servita dall'SDK stesso, che costruisce e decodifica chip TigerTag e mostra ogni byte. Non serve hardware NFC.
npm run playground
# then open http://localhost:7432/tools/playground.html
# Enable live reader support (one-time install)
npm install ws nfc-pcscL'SDK implementa la specifica aperta TigerTag, accanto agli altri strumenti ufficiali.
La specifica aperta implementata dall'SDK: struttura della memoria, tipi di tag, schema di firma e database di riferimento.
Repository: TigerTag-RFID-GuideLa versione Python: leggere, verificare, scrivere e confrontare. La pagina del playground è lo stesso file nei due SDK.
Repository: TigerTag-SDK-PythonGestore di inventario desktop open source per Windows, macOS e Linux, compatibile con TigerTag Pod e lettori ACR122U.
Repository: TigerTag-Studio-ManagerL'app mobile ufficiale: leggi e scrivi chip con l'NFC integrato del telefono.
Esegui npm install tigertag, oppure pnpm add tigertag, yarn add tigertag o bun add tigertag. Richiede Node.js 18 o successivo e nessun altro pacchetto per leggere e verificare.
No. Le tabelle di riferimento e la chiave pubblica di firma sono incluse nel pacchetto, quindi lettura e verifica funzionano offline. La rete serve solo per il controllo giornaliero delle tabelle, il catalogo prodotti e i metodi cloud TigerTag+; offline: true o TIGERTAG_OFFLINE=1 la disattiva.
TigerTag usa chip NTAG213, NTAG215 e NTAG216 (ISO 14443-3). L'SDK riceve l'UID e i byte letti dalla tua libreria NFC, quindi non è legato a un lettore; il README mostra nfc-pcsc con un ACR122U.
verify() controlla la firma ECDSA-P256 del chip sul suo UID e sui suoi identificativi di prodotto, con la chiave pubblica inclusa nel pacchetto. Restituisce valid, invalid, unsigned (un tag Maker), no_key o no_uid, senza chiamare alcun server.
Costruisce i byte: create(), patch(), asInit(), erase() e fromCatalog() danno un TigerTag il cui toBytes() è il contenuto che la tua libreria NFC scrive. Il pulsante Burn del playground lo scrive sui chip dei lettori collegati.
Sì: TigerTag-SDK-Python è la versione Python della stessa API, e i due SDK servono la stessa pagina di playground.
Apache-2.0, che include una concessione esplicita di brevetti. Implementare il protocollo TigerTag in sé non richiede alcuna licenza.
npm install tigertag, poi TigerTag.fromPages(uid, payload).