Online Store

NT4H NTAG® 424 DNA Tag Read/Write Software

Source code examples in C programming language

Primjeri izvornog koda softvera objašnjeni na ovoj stranici odnose se na rješenja NFC NTAG® DNA tehnologije. Njegova primarna svrha je pisanje i čitanje NTAG® 413 DNA i NTAG® 424 DNK oznaka, tj®.

Te su oznake u potpunosti usklađene s:

  • ISO/IEC 14443, svi dijelovi od 1 do 4, odabir datoteke ISO/IEC 7816-4 i rukovanje APDU-om te pasivni cilj u skladu s ISO/IEC18092
  • 7-bajtni UID (prema ISO/IEC 14443 – 3)
  • Konfiguracija tehničke i NDEF strukture strukture podataka NFC Forum Tag 4 Type

Međutim, glavni razlog za odabir NTAG® 424 DNK oznaka među svim tipovima NTAG obitelji je njegova napredna sigurnosna podrška. NTAG® 424 DNK oznake nude napredne sigurnosne metode, kao što su:

  • Standardna AES-128 kriptografija za provjeru autentičnosti / sigurne poruke ili LRP omotana AES operacija za još jači otpor napada
  • 3-prolazna međusobna provjera autentičnosti za pristup zaštićenoj podatkovnoj datoteci
  • Sigurna jedinstvena NFC poruka (SUN)
  • Inkrementalni NFC prisluškuje Brojač
  • Obična, CMAC i šifrirana komunikacija (podesiva)
  • NXP potpis originalnosti temeljen na ECC-u
  • Sklop URL-ova artikala na čipu s fleksibilnim ASCII ogledalima.

U skladu s tim, naš softverski primjer uključuje funkcije za sve NTAG® 424 DNK sigurnosne protokole i implementaciju opcija.

Docs & Software Download

Pregled softvera

Softverske funkcije:

  • Dohvaćanje i uređivanje postavki datoteka
  • Dohvati UID
  • Postavljanje slučajnog ID-a
  • Promjena AES ključa
  • Linearno čitanje/pisanje (ASCII & HEX)
  • Način provjere autentičnosti na tri razine
  • SDM (sigurna dinamička poruka) čitanje/pisanje
  • Nabavite SDM brojač za čitanje
  • Pohrana AES ključa u čitač
  • Zaključavanje/otključavanje čitača
  • Napredne mogućnosti čitača (navedite Reader COM priključak, IP adresu, SN itd.)

Dostupni programski jezici:

  • C (konzola)
  • C# (GUI)

Podržani operativni sustavi, platforme i okruženja:

  • Višeplatforma

Podržane oznake, naljepnice, kartice:

  • NXP NTAG® 21x (210, 213, 215, 216, Tag Tamper)
  • NXP NTAG® 4xx DNA (413, 424)

Preporučeni hardver:

  • μFR Nano
  • μFR Nano Online
  • μFR Classic
  • μFR Classic CS
  • μFR Advance
  • μFR XL

nt4h source coe software

 

Softver respiratorniOpis
ufr-examples-c-nt4h

Primjer izvornog koda konzole C implementacije nt4h oznaka s NFC RFID čitačima serije μFR.  

ufr-examples-c_sharp-nt4h

PRIMJER izvornog koda GUI C# f nt4h označava implementaciju s NFC RFID čitačima serije μFR.

Software manual

1. NT4H Softver – C konzola – Reader Open

Preuzimanje: ufr-examples-c-nt4h

NT4H je namijenjen za NXP NTAG® manipulaciju novim serijama oznaka. Ova serija uključuje NTAG® 413 DNA i NTAG ®424 DNA. NTAG® 424 DNA u potpunosti je u skladu s NFC Forum Type 4 Tag IC. Podržava kriptografski rad AES-128 i novu sigurnu jedinstvenu NFC (SUN) poruku. NXP ne preporučuje korištenje NTAG® 413 DNK oznaka za nove projekte jer dostupna NTAG® 424 DNA nudi bolje sigurnosne značajke.

Pokretanjem aplikacije otvara se konzola s ispisom početnog izbornika.
Ako ste ispravno instalirali hardverske upravljačke programe, priključak za čitanje moći ćete otvoriti tako da odaberete jednu od dostupnih mogućnosti:

  • Opcija 1 – Priključak čitača otvara se pomoću zadanih (automatskih otkrivanja) opcija (obično se koristi za jedan USB čitač priključen na glavno računalo)
  • Opcija 2 – Priključak čitača otvara se pomoću ručno podesivih parametara: reader_type, port_name, port_interface i argumenta.

D NFC SDK ufr examples c nt4h master win64 release nt4h c example.exe 27 08 2020 13 36 18

2. NT4H Softver – C konzola – Glavni izbornik

Ovdje je izlog načina Simple Reader Open. 
Odabir mogućnosti izbornika 1. otvorit će priključak čitača i uspostaviti komunikaciju s uređajem. Kada je komunikacija uspostavljena, konzola prikazuje glavni izbornik sa svim navedenim softverskim funkcijama. 

D NFC SDK ufr examples c nt4h master win64 release nt4h c example.exe 27 08 2020 13 37 35

2.1 NT4H Softver – C konzola – Nabavite postavke datoteke

Prva funkcija, Dohvati postavke datoteke, prikazuje odabrane postavke datoteke. Ovisno o oznaci koju koristite, upišite 1 -2 za NTAG413 i 1-3 za NTAG 424.

NTAG413 ima dvije standardne podatkovne datoteke:

  • Datoteka broj 1 odnosi se na datoteku spremnika mogućnosti (32 bajta),
  • Datoteka broj 2 odnosi se na NDEF datoteku (128 bajtova).

NTAG424 ima tri standardne podatkovne datoteke:

  • Datoteka broj 1 odnosi se na datoteku spremnika mogućnosti (32 bajta),
  • Datoteka broj 2 odnosi se na NDEF datoteku (256 bajtova),
  • Datoteka broj 3 odnosi se na vlasničku datoteku (128 bajtova),
  • Broj vraćenih parametara je promjenjiv.

Ako je trenutna datoteka standardna podatkovna datoteka s AES sigurnim porukama, primjenjuje se sljedeće:

  • Vrsta datoteke
  • Način komunikacije
  • Prava pristupa datoteci.

nt4h c set file settings1 1

EXAMPLE 1

Primjer veličine datoteke:

  • Broj datoteke = 3 (vlasnička datoteka NTAG424)
  • Status komunikacijskog načina rada šifriran (0x03)
  • Sigurno dinamičko slanje poruka je onemogućeno
  • Ključni broj za čitanje je 2, ključni broj za pisanje je 3,
  • Broj ključa za čitanje/pisanje je 3,
  • Broj ključa za postavke promjene datoteke je 0,
  • Veličina datoteke je 128 bajtova.

nt4h c get file settings

EXAMPLE 2

Ako je trenutna datoteka standardna podatkovna datoteka sa sigurnim dinamičkim porukama, sadrži više podataka.

Primjer:

  • broj datoteke je 2 (NDEF datoteka),
  • Omogućeno je sigurno dinamičko slanje poruka,
  • pristup čitanju i pisanju je besplatan (ključni 0x0E),
  • veličina datoteke je 256 bajtova,
  • UID zrcaljenje je omogućeno,
  • SDM brojač za čitanje je omogućen,
  • Ograničenje brojača za čitanje SDM-a je onemogućeno,
  • aktiviran je dio datoteke šifriranih podataka,
  • ključni broj za SDM Meta Read je 2 (UID, SDM brojač za čitanje, PICC podaci, MAC),
  • Dio šifriranih podataka broja ključa datoteke je 2.
  • SDM mjerač za čitanje može čitati bez provjere autentičnosti,
  • POMAK PICC podataka (šifrirani UID i SDM brojač za čitanje) je 49,
  • POMAK ULAZA MAC-a je 86,
  • dio pomaka šifriranih podataka u pomaku datoteke je 86,
  • dio duljine datoteke šifriranih podataka je 32,
  • MAC Offset je 124.

nt4h c set file settings

2.2 NT4H Softver – C konzola – Postavljanje postavki datoteke

Da biste dodali postavke datoteke, odaberite mogućnost drugog izbornika. Zbog velikog broja parametara postoje dvije funkcije za postavke parametara datoteke.

nt4h c set file settings1

EXAMPLE 1

nt4h c set file settings2

Standardna podatkovna datoteka:

  • Datoteka broj 3 (vlasnička datoteka),
  • trenutni način komunikacije je šifriran,
  • Vrijednost Promijeni ključ je 0.

Nove postavke su:

  • Način obične komunikacije,
  • Pročitajte ključ 2,
  • Napišite ključ 3,
  • Ključ za čitanje/pisanje 3,
  • Promijeni ključ 0,
  • način provjere autentičnosti navedenog ključa.

 

 

 

 

 

 

EXAMPLE 2

nt4h c set file settings2

Sigurna datoteka dinamičke razmjene poruka:

  • broj datoteke je 2,
  • Komunikacijski način rada Plain,
  • Ključ za čitanje je 14,
  • Ključ za pisanje je 14,
  • Ključ za čitanje/pisanje je 14,
  • Vrijednost Promijeni ključ je 0,
  • UID zrcaljenje je omogućeno,
  • SDM brojač za čitanje je omogućen,
  • SDM mjerač za čitanje je onemogućen,
  • aktiviran je dio datoteke šifriranih podataka,
  • SDM tipka za čitanje meta je 2,
  • Čitanje SDM datoteke je 2,
  • SDM ključ brojača za čitanje je 2,
  • Pomak šifriranih PICC podataka 49,
  • POMAK MAC ulaznih podataka 86,
  • pomak dijela šifriranih podataka 86,
  • MAC Pomak 124.

2.3 NT4H Softver – C konzola – nabavite UID (samo NTAG 424)

Ako koristite oznake NTAG® 424 s omogućenim sigurnosnim načinom provjere autentičnosti, mogućnost izbornika 3. prikazat će oznaku UID.

Funkcija vraća UID karticu od 7 bajtova. Korisno je ako su aktivirane opcije Slučajnog ID-a. Potrebna je valjana provjera autentičnosti s bilo kojim ključem kartice.

nt4h c get uid

2.4 NT4H Softver – C konzola – Postavljanje slučajnog UID-a (samo NTAG® 424)

NTAG® 424 DNA omogućuje dodatnu sigurnost oznaka slučajnom postavkom UID-a (opcija izbornika 4).
Funkcija Set Random UID zamjenjuje jedinstveni UID od 7 bajtova slučajnim UID-om od 4 bajta. Slijedom toga, oznaka vraća nasumični UID od 4 bajta pri svakom očitanju. Oznaka sada vraća slučajni ID od 4 bajta umjesto jedinstvenog ID-a od 7 bajtova.
Ova funkcija zahtijeva provjeru autentičnosti glavnog ključa (broj 0).

Upozorenje: ova operacija je nepovratna!

nt4h c get uid example1 1

2.5 NT4H Softver – C konzola – Promjena AES ključa

 

nt4h c change aes keyOpcija izbornika 5 omogućuje promjenu AES ključa.
Ova funkcija zahtijeva provjeru autentičnosti glavnog ključa (broj 0).
Unesite novi AES ključ upisivanjem 16 heksadecimalnih bajtova.
Ako ključ koji treba promijeniti nije glavni ključ, prethodna vrijednost ključa je obavezna.
 
 
 
 

EXAMPLE 1

Primjer promjene AES ključa:

  • Ključ broj 4.
  • 0x00000000000000000000000000000000 vrijednosti glavnog ključa aplikacije
  • 0x00000000000000000000000000000000 vrijednosti Stari ključ 4
  • Nova vrijednost ključa 4 0x11111111111111111111111111111111.

nt4h c change aes key

2.6 NT4H Softver – C konzola – Linearno čitanje

Funkcija Linearno čitanje uključuje običan, ošamućen i šifrirani način čitanja. Također, provjera autentičnosti čitanja sadržaja u načinu ključa Provided i načinu internog ključa omogućuje pristup sadržaju ako je oznaka zaštićena. U suprotnom, sadržaj otključane oznake može se čitati bez unosa ključa (opcija: Nema autentifikacije). Konzola će prikazati sadržaj čitljiv u odabranom načinu provjere autentičnosti kao heksadecimalni i ASCI notaciju.

2.6.1 NT4H Softver – C konzola – Linearno čitanje

Funkcija linearnog čitanja uključuje običan, mac (kod za provjeru autentičnosti poruke) i šifrirani način čitanja. Također, provjera autentičnosti čitanja sadržaja u načinu pružanja ključa i načinu internog ključa omogućuje pristup sadržaju ako je oznaka zaštićena. U suprotnom, sadržaj otključane oznake dostupan je bez unosa ključa (opcija: Nema provjere autentičnosti). Konzola će prikazati sadržaj čitljiv u odabranom načinu provjere autentičnosti kao heksadecimalni i ASCI notaciju.

Funkcija čita snimljene podatke datoteke. Obavezni parametri su:

  • Broj datoteke,
  • Pristupni ključ za čitanje ili čitanje/pisanje,
  • Način komunikacije,
  • Način provjere autentičnosti (ako je ključ za čitanje 14, odaberite mogućnost Bez provjere autentičnosti),
  • Početna adresa (0 – maksimalna adresa),
  • Duljina podataka.

nt4h c linear read function

2.7 NT4H Softver – C konzola – Linearno pisanje

Kao i kod funkcije Linear Read, funkcija Linear Write omogućuje tri načina komunikacije i heksadecimalni ili ASCII format za pisanje sadržaja. Također, odabrani način provjere autentičnosti primjenjuje se na snimljeni sadržaj. 

Funkcija zapisuje podatke u datoteku. Obavezni parametri su:

  • Broj datoteke,
  • Pristupni ključ za čitanje ili čitanje/pisanje,
  • Način komunikacije,
  • Način provjere autentičnosti (ako je čitanje Ključ 14, odaberite mogućnost Bez provjere autentičnosti ),
  • Početna adresa (0 – maksimalna adresa),
  • Unesite podatke u ASCII ili heksadecimalnom obliku.

nt4h c linear write

2.8 NT4H Softver – C konzola – Sigurno čitanje dinamičke poruke

Sigurna dinamička razmjena poruka (SDM) na NT4H DNK oznakama omogućuje značajku SUN. Odnosi se na tekst (ASCII) u poruci NDEF-a.
Da biste primijenili funkciju Sigurno čitanje dinamičke poruke, omogućite datoteku Sigurna dinamička poruka. Također, postavite besplatni pristup za čitanje (ključ 14 – opcija Bez provjere autentičnosti).

nt4h c sdm read

2.9 NT4H Softver – C konzola – Sigurno dinamičko pisanje poruka

Kao i kod čitanja sigurne dinamičke poruke, za funkciju Sigurno dinamičko pisanje poruka omogućite datoteku Sigurna dinamička poruka. Također, postavite besplatni pristup za čitanje (ključ 14 – opcija Bez provjere autentičnosti).

nt4h c sdm write

2.10 NT4H Softver – C konzola – Nabavite SDM brojač za čitanje

Mjerač za čitanje sigurne dinamičke poruke postoji samo ako je omogućen SDM datoteke. Provjera autentičnosti je ili nije potrebna, ovisno o postavci pristupa SDM mjeraču za čitanje datoteke.

nt4h c get sdm reading counter

 

2.11 NT4H Softver – C konzola – Pohranite AES ključ u čitač

Uređaj Reader može pohraniti 16 AES tipki s vrijednostima indeksa 0-15. To znači da indeks ključa može biti bilo koja vrijednost između 0 i 15. Primjer pokazuje kako pohraniti ključ s vrijednošću 0 x 0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000

EXAMPLE 1

nt4h c store aes key into the reader

EXAMPLE 2

AES ključ pohranjen u čitaču otključan je prema zadanim postavkama.

Pohranjeni ključ možete zaključati bilo kojom lozinkom od 8 bajtova.

Primjer:
Lozinka je 12345678

nt4h c store aes key into the reader password

EXAMPLE 3

U slučaju da je pohranjeni ključ zaštićen lozinkom (zaključan), morate ga otključati davanjem lozinke od 8 bajtova.

Primjer:
Lozinka je 12345678

nt4h c store aes key into the reader password unlock

Ovaj priručnik predstavlja softverski primjer u programskom jeziku C. Ipak, sav povezani softver izvornog koda u drugim programskim jezicima sadrži iste funkcije. Tamo gdje je dostižan, razvijen je GUI.
Molimo, provjerite naš GitLab repozitorij za dostupne primjere izvornog koda u drugim programskim jezicima.