DOKUMENTAZZJONI

Manwal tal-Integrazzjoni tal-Qarrej tal-RFID

Dokumentazzjoni komprensiva li tkopri s-setup tal-komunikazzjoni serjali, il-konfigurazzjoni tal-antenna, l-operazzjonijiet tal-kodifikazzjoni tat-tikketti (EPC Gen2 / ISO 18000-6C), u l-ġestjoni tal-enerġija. Jinkludi eżempji għal skjeramenti b'diversi antenni u skennjar ta' inventarju b'veloċità għolja.

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

Setup tal-Komunikazzjoni Serjali

Il-qarrejja tal-RFID tal-protokoll NRN ta' Nextwaves jikkomunikaw permezz tal-port serjali (RS-232 jew USB-to-Serial). Il-parametri tal-konnessjoni għandhom jiġu kkonfigurati b'mod korrett biex tiġi żgurata t-trażmissjoni stabbli tad-data.

Għal konnessjonijiet tal-API WebSerial ibbażati fuq il-browser, uża Nextwaves Reader Connect fuq app.nextwaves.com/reader. L-applikazzjoni awtomatikament tiskopri l-portijiet COM u tikkonfigura l-parametri tal-konnessjoni.

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

Struttura tal-Qafas tal-Protokoll NRN ta' Nextwaves

Kull kmand tal-protokoll NRN huwa inkapsulat f'qafas binarju li jikkonsisti minn: Header (0x5A), PCW (Protocol Control Word), Kategorija, MID (Message ID), Tul, Data payload, u checksum CRC16-CCITT.

QasamDaqsDeskrizzjoni
Header
1 byte
Dejjem 0x5A. marka tal-bidu tal-qafas
PCW
2 bytes
Flags tal-protokoll (verżjoni, indirizz)
Category
1 byte
Kategorija tal-kmand (0x00=Sistema, 0x01=Apparat, 0x02=RFID)
MID
1 byte
ID tal-messaġġ fil-kategorija
Length
2 bytes
Tul tal-payload f'bytes (big-endian)
Data
N bytes
Payload speċifiku għall-kmand
CRC16
2 bytes
Checksum CRC16-CCITT ta' bytes wara l-header

Eżempji ta' Kmand

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

Referenza tal-Kmandijiet Ewlenin

KmandKodiċiDeskrizzjoni
QUERY_INFO
0x0100
Interroga n-numru tas-serje tal-qarrej u l-verżjonijiet tal-firmware
QUERY_RFID_ABILITY
0x1000
Interroga l-kapaċitajiet tal-RFID (firxa tal-qawwa, għadd tal-antenna)
READ_EPC_TAG
0x0210
Ibda l-inventarju kontinwu tal-EPC tag
WRITE_EPC_TAG
0x0211
Ikteb data lill-bank EPC ta' tikketta
STOP_INVENTORY
0x02FF
Waqqaf inventarju tat-tag li jkun għaddej
CONFIGURE_READER_POWER
0x0201
Issettja l-qawwa tat-trażmissjoni (0-33 dBm għal kull antenna)
CONFIGURE_ANTENNA_ENABLE
0x0203
Attiva/tiddiżattiva l-portijiet tal-antenna (bitmask)
SET_WORKING_FREQUENCY
0x0205
Issettja frekwenzi speċifiċi tax-xogħol
SET_FILTER_SETTINGS
0x0209
Ikkonfigura l-filtru tad-duplikati tat-tag (ibbażat fuq il-ħin)
BUZZER_SWITCH
0x011E
Ikkontrolla l-modalità tal-buzzer

Konfigurazzjoni tal-Antenna

Il-qarrejja tal-RFID jappoġġjaw sa 32 port tal-antenna. Kull port huwa attivat jew diżattivat permezz ta' bitmask ta' 4 bytes. L-antenni huma nnumerati minn 1 sa 32, b'kull bit jikkorrispondi għal port.

Maskra tal-Antenna

Ippermetti l-Antenni 1-40F 00 00 00Binary 00001111 - ports 1, 2, 3, 4 on
Ippermetti l-Antenni 1 u 3 Biss05 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

Skjerament Multi-Antenna

Meta tuża diversi antenni, ikkunsidra l-polarizzazzjoni (lineari vs. ċirkolari), l-ispazjar bejn l-antenni, u ż-żoni ta' kopertura li jikkoinċidu. Il-qarrej jiskennja sekwenzjalment mill-antenni attivati, u kull rapport tat-tikketta jinkludi l-ID tal-antenna għad-determinazzjoni tal-pożizzjoni.

Portal

Bieb tad-Dock

2-4 antenni għal kull portal, polarizzazzjoni ċirkolari, qawwa ta' 30 dBm

Station

Ċinturin tal-Ġarr

1-2 antenni għal kull stazzjon, polarizzazzjoni lineari, 20-25 dBm

Shelf

Xkaffa tal-Bejgħ bl-Imnut

Antenni near-field, qawwa baxxa 15-20 dBm, densità għolja

Kodifikazzjoni tat-Tag (EPC Gen2 / ISO 18000-6C)

UHF RFID isegwi l-istandard EPC Gen2 (ISO 18000-6C). Kull tag għandu 4 banek tal-memorja: Riżervati (passwords), EPC (identifikatur ta' 96+ bit), TID (ID taċ-ċippa immutabbli), u Utent (data tad-dwana).

Struttura tal-Memorja tat-Tag

BankIDDaqs TipikuUżu
Reserved
00
64 bits
Password kill (32b) + Password aċċess (32b)
EPC
01
96-128 bits
SGTIN-96, SSCC-96, jew kodifikazzjoni tad-dwana
TID
10
96+ bits
ID tal-manifattur taċ-ċippa (read-only, uniku)
User
11
0-512 bits
Data speċifika għall-applikazzjoni (dipendenti miċ-ċippa)

Eżempju ta' Dekodifikazzjoni SGTIN-96

SGTIN-96 huwa l-aktar kodifikazzjoni komuni għall-prodotti tal-bejgħ bl-imnut u tal-katina tal-provvista. Ikkonverti EPC hex ta' 24 karattru f'GTIN-14, numru tas-serje, u GS1 Digital Link.

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]

Uża l-għodda online EPC Encoder f' /tools/tds-rfid-converter biex tikkodifika u tiddikodifika SGTIN-96, SSCC-96, GRAI-96 direttament fil-browser tiegħek.

Ġestjoni tal-Enerġija

Il-qawwa tat-trażmissjoni tal-qarrej hija aġġustabbli minn 0 sa 33 dBm għal kull port tal-antenna. Qawwa ogħla żżid il-medda tal-qari iżda żżid ukoll l-interferenza u l-konsum tal-enerġija.

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

Monitoraġġ tal-RSSI

Il-valuri tal-RSSI (Received Signal Strength Indicator) mit-tikketti huma rrappurtati bħala bytes ADC mhux ipproċessati (0-255). Uża l-formula tal-konverżjoni biex tikseb valuri preċiżi f'dBm.

Formula tal-KonverżjonidBm = -100 + round((raw x 70) / 255)
Raw 128 - Tajjeb-65 dBm
Raw 180 - Qawwi-51 dBm
Raw 220 - Eċċellenti-40 dBm

Skannjar tal-Inventarju b'Veloċità Għolja

Għal skannjar tal-inventarju b'veloċità għolja, ikkonfigura l-frekwenzi tax-xogħol, il-filtru tat-tags duplikati, u l-modalità ta' skannjar kontinwu. Il-qarrejja jappoġġjaw sa 700 tags/sekonda b'konfigurazzjoni ottimali.

Konfigurazzjoni tal-Frekwenza

UHF RFID jopera fil-medda ta' 920-925 MHz (l-Asja tax-Xlokk), bi spazjar tal-kanal ta' 0.5 MHz. Il-kanali huma nnumerati minn 0 (920 MHz) sa 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

Fluss tax-Xogħol tal-Iskennjar Ottimali

01

Ikkonfigura l-portijiet tal-antenna u l-livelli tal-enerġija

02

Issettja l-frekwenzi tax-xogħol (FHSS għal ambjenti densi)

03

Ikkonfigura l-filtru tad-duplikati (500ms-3000ms skont il-każ tal-użu)

04

Ibgħat READ_EPC_TAG biex tibda l-inventarju kontinwu

05

Ipproċessa n-notifiki tat-tags (PID 0x1231) hekk kif jaslu

06

Ibgħat STOP_INVENTORY meta jsir

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");