JavaScript- / Node.js-SDKTigerTag SDK

In drie stappen aan de slag

Installeer het pakket, lees een chip met je NFC-bibliotheek en schrijf een nieuwe. Dankzij de meegeleverde referentietabellen werkt de eerste start zonder netwerk.

1. 1

   Installeer het pakket

   Uit het npm-register. pnpm, yarn en bun installeren hetzelfde pakket.

   npm install tigertag

   pnpm add tigertag
   yarn add tigertag
   bun add tigertag

2. 2

   Lees een chip

   Geef de UID van 7 bytes en de 144 bytes door die je NFC-bibliotheek leest. Hier met nfc-pcsc en een 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
   });

3. 3

   Wijzig en schrijf

   Elke wijziging geeft een nieuwe TigerTag terug; toBytes() levert de bytes om terug te schrijven. erase() levert een lege chip.

   // 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();

De volledige API in de README

Wat de SDK doet

Eén pakket voor alles rond een TigerTag-chip: lezen, controleren, schrijven en de gegevens actueel houden.

Drie soorten tags

De SDK leest en schrijft de drie tagtypen van TigerTag-protocol v2.2, op NTAG213-, NTAG215- en NTAG216-chips.

Vanaf de opdrachtregel en in Electron

Het pakket installeert de opdracht tigertag en draait in het hoofdproces van een Electron-app.

# Parse a dump file
tigertag dump.bin

# JSON output
tigertag dump.bin --json

# Update the reference tables now (into the data dir)
tigertag update

// 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(),
  };
}

Onderdeel van het TigerTag-ecosysteem

De SDK implementeert de open TigerTag-specificatie, naast de andere officiële tools.

Vragen