SDK dla JavaScript / Node.jsTigerTag SDK

Zacznij w trzech krokach

Zainstaluj pakiet, odczytaj chip swoją biblioteką NFC i zapisz nowy. Dołączone tabele referencyjne pozwalają na pierwsze uruchomienie bez sieci.

1. 1

   Zainstaluj pakiet

   Z rejestru npm. pnpm, yarn i bun instalują ten sam pakiet.

   npm install tigertag

   pnpm add tigertag
   yarn add tigertag
   bun add tigertag

2. 2

   Odczytaj chip

   Przekaż 7-bajtowy UID i 144 bajty odczytane przez bibliotekę NFC. Tutaj z nfc-pcsc i czytnikiem 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

   Zmień i zapisz

   Każda zmiana zwraca nowy TigerTag; toBytes() daje bajty do zapisania. erase() daje pusty 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();

Pełne API w README

Co robi SDK

Jeden pakiet do wszystkiego, co dotyczy chipu TigerTag: odczytu, sprawdzania, zapisu i aktualizacji danych.

Trzy rodzaje tagów

SDK odczytuje i zapisuje trzy typy tagów protokołu TigerTag v2.2 na chipach NTAG213, NTAG215 i NTAG216.

Z wiersza poleceń i w Electronie

Pakiet instaluje polecenie tigertag i działa w procesie głównym aplikacji Electron.

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

Część ekosystemu TigerTag

SDK implementuje otwartą specyfikację TigerTag, obok pozostałych oficjalnych narzędzi.

Pytania