SDK для JavaScript / Node.jsTigerTag SDK

Начните за три шага

Установите пакет, прочитайте чип своей NFC-библиотекой, запишите новый. Встроенные справочные таблицы позволяют первому запуску работать без сети.

1. 1

   Установите пакет

   Из реестра npm. pnpm, yarn и bun устанавливают тот же пакет.

   npm install tigertag

   pnpm add tigertag
   yarn add tigertag
   bun add tigertag

2. 2

   Прочитайте чип

   Передайте 7-байтовый UID и 144 байта, прочитанные NFC-библиотекой. Здесь — с nfc-pcsc и 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

   Измените и запишите

   Каждое изменение возвращает новый TigerTag; toBytes() даёт байты для записи. erase() даёт пустой чип.

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

Полный API в README

Что умеет SDK

Один пакет для всего, что связано с чипом TigerTag: чтения, проверки, записи и обновления данных.

Три вида меток

SDK читает и записывает три типа меток протокола TigerTag v2.2 на чипах NTAG213, NTAG215 и NTAG216.

В командной строке и внутри Electron

Пакет устанавливает команду tigertag и работает в главном процессе приложения 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(),
  };
}

Часть экосистемы TigerTag

SDK реализует открытую спецификацию TigerTag наряду с другими официальными инструментами.

Вопросы