DOKUMENTASI

Manual Integrasi Pembaca RFID

Dokumentasi komprehensif yang merangkumi persediaan komunikasi bersiri, konfigurasi antena, operasi pengekodan tag (EPC Gen2 / ISO 18000-6C), dan pengurusan kuasa. Termasuk contoh untuk penggunaan berbilang antena dan pengimbasan inventori berkelajuan tinggi.

Reader bring-up
NRN
Serial115200 8N1
ProtocolCRC16-CCITT
RF power0-33 dBm
Inventory700 tags/s
5APCWCATMIDLENDATACRC16

Persediaan Komunikasi Bersiri

Pembaca RFID protokol NRN Nextwaves berkomunikasi melalui port bersiri (RS-232 atau USB-ke-Bersiri). Parameter sambungan mesti dikonfigurasi dengan betul untuk memastikan penghantaran data yang stabil.

Untuk sambungan API WebSerial berasaskan pelayar, gunakan Nextwaves Reader Connect di app.nextwaves.com/reader. Aplikasi mengesan port COM secara automatik dan mengkonfigurasi parameter sambungan.

Baud rate115200
Data bits8
Stop bits1
ParityNone
TypeScript - WebSerial Connection
// Request serial port access
const port = await navigator.serial.requestPort();
await port.open({
  baudRate: 115200,
  dataBits: 8,
  stopBits: 1,
  parity: "none",
  flowControl: "none",
  bufferSize: 4096,
});

// Get reader/writer streams
const reader = port.readable.getReader();
const writer = port.writable.getWriter();
Python - PySerial Connection
import serial

port = serial.Serial(
    port="/dev/ttyUSB0",      # Linux/macOS
    # port="COM3",            # Windows
    baudrate=115200,
    bytesize=serial.EIGHTBITS,
    stopbits=serial.STOPBITS_ONE,
    parity=serial.PARITY_NONE,
    timeout=2.0,
)

# Flush buffers before communication
port.reset_input_buffer()
port.reset_output_buffer()

Struktur Rangka Protokol NRN Nextwaves

Setiap arahan protokol NRN dibungkus dalam bingkai binari yang terdiri daripada: Header (0x5A), PCW (Protocol Control Word), Kategori, MID (Message ID), Panjang, muatan Data, dan checksum CRC16-CCITT.

MedanSaizPenerangan
Header
1 byte
Sentiasa 0x5A. penanda permulaan bingkai
PCW
2 bytes
Bendera protokol (versi, alamat)
Category
1 byte
Kategori perintah (0x00=Sistem, 0x01=Peranti, 0x02=RFID)
MID
1 byte
ID Mesej dalam kategori
Length
2 bytes
Panjang muatan dalam bait (big-endian)
Data
N bytes
Muatan khusus perintah
CRC16
2 bytes
Checksum CRC16-CCITT bagi bait selepas pengepala

Contoh Perintah

QUERY_INFO - Query reader serial number and firmware
TX -> 5A 00 01 01 00 00 00 DC E5
       +----+ +------+ +----+ +----+ +------+ +------+
       | 5A | | 0001 | | 01 | | 00 | | 0000 | | DCE5 |
       +----+ +------+ +----+ +----+ +------+ +------+
        HDR     PCW    CAT   MID    LEN     CRC16
READ_EPC_TAG - Start continuous EPC tag inventory
TX -> 5A 00 01 02 10 00 00 04 5A
       HDR  PCW   CAT MID LEN   CRC16

Response notifications (PID 0x1231) contain:
  - Antenna ID (1 byte)
  - RSSI value (1 byte, raw ADC 0-255)
  - EPC data (12+ bytes)
  - Frequency channel index (1 byte)
STOP_INVENTORY - Stop running inventory scan
TX -> 5A 00 01 02 FF 00 00 88 5A
       HDR  PCW   CAT MID LEN   CRC16

Rujukan Perintah Utama

PerintahKodPenerangan
QUERY_INFO
0x0100
Pertanyaan nombor siri pembaca dan versi perisian tegar
QUERY_RFID_ABILITY
0x1000
Pertanyaan keupayaan RFID (julat kuasa, kiraan antena)
READ_EPC_TAG
0x0210
Mulakan inventori tag EPC berterusan
WRITE_EPC_TAG
0x0211
Tulis data ke bank EPC tag
STOP_INVENTORY
0x02FF
Hentikan inventori tag yang sedang berjalan
CONFIGURE_READER_POWER
0x0201
Tetapkan kuasa transmisi (0-33 dBm per antena)
CONFIGURE_ANTENNA_ENABLE
0x0203
Aktifkan/lumpuhkan port antena (bitmask)
SET_WORKING_FREQUENCY
0x0205
Tetapkan frekuensi kerja tertentu
SET_FILTER_SETTINGS
0x0209
Konfigurasi penapis pendua tag (berasaskan masa)
BUZZER_SWITCH
0x011E
Kawalan mod buzzer

Konfigurasi Antena

Pembaca RFID menyokong sehingga 32 port antena. Setiap port diaktifkan atau dilumpuhkan melalui bitmask 4 bait. Antena dinomborkan 1 hingga 32, dengan setiap bit sepadan dengan satu port.

Bitmask Antena

Dayakan Antena 1-40F 00 00 00Binary 00001111 - ports 1, 2, 3, 4 on
Dayakan Antena 1 & 3 Sahaja05 00 00 00Binary 00000101 - ports 1 and 3 on
CONFIGURE_ANTENNA_ENABLE - Enable ports 1-4
TX -> 5A 00 01 02 03 00 04 0F 00 00 00 E1 EF
                              +-----------+
       Payload:               |0F 00 00 00| <- bitmask
                              +-----------+
       Bit 0 = ANT1, Bit 1 = ANT2, Bit 2 = ANT3, Bit 3 = ANT4
       0x0F = 0b00001111 -> all 4 ports enabled

Penggunaan Berbilang Antena

Apabila menggunakan berbilang antena, pertimbangkan polarisasi (linear berbanding bulat), jarak antara antena, dan zon liputan yang bertindih. Pembaca mengimbas secara berurutan melalui antena yang didayakan, dan setiap laporan tag termasuk ID antena untuk penentuan kedudukan.

Portal

Pintu Dok

2-4 antena setiap portal, polarisasi membulat, kuasa 30 dBm

Station

Tali Sawat

1-2 antena setiap stesen, polarisasi linear, 20-25 dBm

Shelf

Rak Runcit

Antena medan dekat, kuasa rendah 15-20 dBm, ketumpatan tinggi

Pengekodan Tag (EPC Gen2 / ISO 18000-6C)

UHF RFID mengikut piawaian EPC Gen2 (ISO 18000-6C). Setiap tag mempunyai 4 bank memori: Reserved (kata laluan), EPC (pengecam 96+ bit), TID (ID cip yang tidak boleh diubah), dan User (data tersuai).

Struktur Memori Tag

BankIDSaiz TipikalPenggunaan
Reserved
00
64 bits
Kata laluan bunuh (32b) + Kata laluan akses (32b)
EPC
01
96-128 bits
SGTIN-96, SSCC-96, atau pengekodan tersuai
TID
10
96+ bits
ID pengilang cip (baca sahaja, unik)
User
11
0-512 bits
Data khusus aplikasi (bergantung pada cip)

Contoh Pengekodan SGTIN-96

SGTIN-96 ialah pengekodan yang paling biasa untuk produk runcit dan rantaian bekalan. Tukar EPC heksadesimal 24 aksara kepada GTIN-14, nombor siri, dan Pautan Digital GS1.

SGTIN-96 Decode - Example
EPC Hex: 3034257BF7194E4000001A85

Decoded:
  Header:         0x30 (SGTIN-96)
  Filter:         1 (Point-of-Sale)
  Partition:      5
  Company Prefix: 0614141
  Item Reference: 812345
  Serial:         6789
  GTIN-14:        80614141123458
  Digital Link:   https://id.gs1.org/01/80614141123458/21/6789
WRITE_EPC_TAG - Write EPC data to tag
// NRN protocol WRITE_EPC_TAG command
TX -> 5A 00 01 02 11 00 0C [EPC_DATA_12_BYTES] [CRC16]

// The reader will:
// 1. Select the tag in its field
// 2. Write the provided EPC data to Bank 01
// 3. Return success/failure notification

// Access password required if tag is locked:
TX -> 5A 00 01 02 11 00 10 [ACCESS_PWD_4B] [EPC_DATA_12B] [CRC16]

Gunakan alat EPC Encoder dalam talian di /tools/tds-rfid-converter untuk mengekod dan menyahkod SGTIN-96, SSCC-96, GRAI-96 secara langsung dalam pelayar anda.

Pengurusan Kuasa

Kuasa penghantaran pembaca boleh laras daripada 0 hingga 33 dBm setiap port antena. Kuasa yang lebih tinggi meningkatkan julat bacaan tetapi juga meningkatkan gangguan dan penggunaan kuasa.

CONFIGURE_READER_POWER - Set 30 dBm on all 4 ports
TX -> 5A 00 01 02 01 00 04 1E 1E 1E 1E 67 FE
                              +-----------+
       Payload:               |1E 1E 1E 1E|
                              +-----------+
       0x1E = 30 decimal = 30 dBm per port

Power guidelines:
  - 33 dBm - Maximum range (~10m), dock doors
  - 30 dBm - Standard range (~6-8m), general use
  - 25 dBm - Medium range (~3-5m), conveyor belts
  - 20 dBm - Short range (~1-2m), point-of-sale
  - 15 dBm - Near-field (~0.5m), shelf readers

Pemantauan RSSI

Nilai RSSI (Received Signal Strength Indicator) daripada tag dilaporkan sebagai bait ADC mentah (0-255). Gunakan formula penukaran untuk mendapatkan nilai dBm yang tepat.

Formula PenukarandBm = -100 + round((raw x 70) / 255)
Raw 128 - Baik-65 dBm
Raw 180 - Kuat-51 dBm
Raw 220 - Cemerlang-40 dBm

Pengimbasan Inventori Berkelajuan Tinggi

Untuk pengimbasan inventori berkelajuan tinggi, konfigurasikan frekuensi kerja, penapis tag pendua, dan mod imbasan berterusan. Pembaca menyokong sehingga 700 tag/saat dengan konfigurasi optimum.

Konfigurasi Frekuensi

RFID UHF beroperasi dalam jalur 920-925 MHz (Asia Tenggara), dengan jarak saluran 0.5 MHz. Saluran dinomborkan dari 0 (920 MHz) hingga 10 (925 MHz).

SET_WORKING_FREQUENCY - 6 channels (920-925 MHz)
TX -> 5A 00 01 02 05 00 06 00 02 04 06 08 0A C4 1B

Channel mapping (formula: 920.0 + index x 0.5 MHz):
  Ch 0  -> 920.0 MHz
  Ch 2  -> 921.0 MHz
  Ch 4  -> 922.0 MHz
  Ch 6  -> 923.0 MHz
  Ch 8  -> 924.0 MHz
  Ch 10 -> 925.0 MHz

Aliran Kerja Pengimbasan Optimum

01

Konfigurasikan port antena dan tahap kuasa

02

Tetapkan frekuensi kerja (FHSS untuk persekitaran yang padat)

03

Konfigurasikan penapis pendua (500ms-3000ms bergantung pada kes penggunaan)

04

Hantar READ_EPC_TAG untuk memulakan inventori berterusan

05

Proses pemberitahuan tag (PID 0x1231) semasa ia tiba

06

Hantar STOP_INVENTORY apabila selesai

Complete inventory flow - TypeScript
// 1. Enable antennas 1-4
await sendFrame("CONFIGURE_ANTENNA_ENABLE", [0x0F, 0x00, 0x00, 0x00]);

// 2. Set power to 30 dBm on all ports
await sendFrame("CONFIGURE_READER_POWER", [0x1E, 0x1E, 0x1E, 0x1E]);

// 3. Set working frequencies
await sendFrame("SET_WORKING_FREQUENCY", [0, 2, 4, 6, 8, 10]);

// 4. Set duplicate filter to 1000ms
await sendFrame("SET_FILTER_SETTINGS", [0x03, 0xE8]);

// 5. Start inventory
await sendFrame("READ_EPC_TAG");

// 6. Process tags...
reader.on("tag", (tag) => {
  const rssiDbm = -100 + Math.round((tag.rssi * 70) / 255);
  console.log(`EPC: ${tag.epc}, Ant: ${tag.antenna}, RSSI: ${rssiDbm} dBm`);
});

// 7. Stop when done
await sendFrame("STOP_INVENTORY");