ST UM2766 X-LINUX-NFC5 paket za razvoj NFC/RFID čitača

Uvod

Ovaj STM32 MPU OpenSTLinux softverski paket za proširenje pokazuje kako možete razviti NFC/RF komunikaciju za standardni Linux sistem koristeći našu Biblioteku radiofrekventne apstrakcije (RFAL). RFAL upravljački program zajedničkog sučelja osigurava da su korisnička funkcija i aplikativni softver kompatibilni sa bilo kojim ST25R NFC/RFID čitačem IC.
Paket X-LINUX-NFC5 prenosi RFAL na Discovery Kit sa STM32MP1 serijom mikroprocesora koji pokreće Linux za pogon ST25R3911B NFC prednjeg kraja na STM32 Nucleo ploči za proširenje. Paket uključuje kaoample aplikacija koja će vam pomoći da razumijete otkrivanje različitih tipova NFC-a tags i mobilni telefoni koji podržavaju P2P.
Izvorni kod je dizajniran za prenosivost kroz širok raspon procesorskih jedinica koje pokreću Linux i podržava sve niže slojeve i neke protokole višeg sloja ST25R IC-a za apstraktnu RF komunikaciju.

Biblioteka radiofrekvencijskih apstrakcija za Linux

RFAL	Protokoli	ISO DEP			NFC DEP
	Tehnologije	NFC-A	NFC-B	NFC-F	NFC-V	T1T	ST25TB
	HAL	RF
		RF konfiguracije
		ST25R3911B

X-LINUX-NFC5 Gotovoview

Glavne karakteristike

Softverski paket za proširenje X-LINUX-NFC5 uključuje sljedeće karakteristike:

• Kompletan Linux upravljački program za korisnički prostor (RF apstrakcioni sloj) za pravljenje NFC aplikacija pomoću ST25R3911B/ST25R391x NFC prednjih krajeva sa izlaznom snagom do 1.4 W.
• Linux host komunikacija sa ST25R3911B/ST25R391x preko SPI interfejsa velike brzine.
• Potpuna RF/NFC apstrakcija (RFAL) za sve glavne tehnologije i protokole višeg sloja:
  • NFC-A (ISO14443-A)
  • NFC-B (ISO14443-B)
  • NFC-F (FeliCa)
  • NFC-V (ISO15693)
  • P2P (ISO18092)
  • ISO-DEP (ISO protokol za razmjenu podataka, ISO14443-4)
  • NFC-DEP (NFC protokol za razmjenu podataka, ISO18092)
  • Vlasničke tehnologije (Kovio, B', iClass, Calypso, itd.)
• Sampimplementacija dostupna sa X-NUCLEO-NFC05A1 pločom za proširenje priključenom na STM32MP157F-DK2
• Sample aplikacija za otkrivanje nekoliko NFC tags vrste

Arhitektura paketa

Softverski paket radi na A7 jezgri serije STM32MP1. X-LINUX-NFC5 je u interakciji sa bibliotekama nižih slojeva i SPI linijama izloženim Linux softverskom okviru.

X-LINUX-NFC5 arhitektura aplikacije u Linux okruženju

Podešavanje hardvera

Hardverski zahtjevi:

• PC/Virtual-mašina zasnovana na Ubuntu verziji 16.04 ili novija
• STM32MP157F-DK2 ploča (Discovery Kit)
• X-NUCLEO-NFC05A1
• 8 GB mikro SD kartica za pokretanje STM32MP157F-DK2
• Čitač SD kartica / LAN povezivanje
• USB kabl tipa-A do tipa-micro B
• USB kabl tipa A do tipa C
• USB PD kompatibilno napajanje 5V 3A

PC/Virtual-mašina formira platformu za unakrsni razvoj za izgradnju RFAL biblioteke i koda aplikacije za otkrivanje i komunikaciju sa NFC uređajima preko ST25R3911B IC.

Kako povezati hardver

Korak 1. Priključite X-NUCLEO-NFC05A1 ploču za proširenje na Arduino konektore na donjoj strani STM32MP157F-DK2 ploče za otkrivanje.

Nucleo board i Discovery board Arduino konektori

1. X-NUCLEO-NFC05A1 ploča za proširenje
2. STM32MP157F-DK2 ploča za otkrivanje
3. Arduino konektori

Korak 2. Povežite ST-LINK programator/debuger ugrađen u ploču za otkrivanje na vaš host računar preko USB micro B porta (CN11).

Korak 3. Napajajte ploču za otkrivanje preko USB Type C porta (CN6).

Potpuno podešavanje hardverske veze

POVEZANI LINKOVI
Pogledajte ovaj wiki za više detalja vezanih za napajanje i komunikacijske portove

Postavljanje softvera

Prije nego što počnete, napajajte komplet za otkrivanje STM32MP157F-DK2 putem USB PD kompatibilnog napajanja od 5 V, 3 A i instalirajte početni paket prema uputama u wikiju Početak rada. Biće vam potrebna microSD kartica od najmanje 2 GB za flešovanje slika koje se mogu pokrenuti.
Za pokretanje aplikacije, konfiguraciju platforme treba ažurirati ažuriranjem stabla uređaja kako bi se omogućile relevantne periferne jedinice. To možete učiniti brzo korištenjem dostupnih unaprijed napravljenih slika ili možete razviti stablo uređaja i izgraditi vlastite slike kernela.
Takođe možete (opciono) izgraditi ovaj softverski paket uključivanjem Yocto sloja (meta-nfc5 ) u ST distributivni paket. Ova operacija kreira izvorni kod i uključuje modifikacije stabla uređaja zajedno sa kompajliranim binarnim datotekama u konačnim fleš slikama. Za detaljne korake koji opisuju proces, pogledajte Odjeljak 3.5.
Možete se povezati na Discovery Kit sa glavnog računara putem TCP/IP mreže koristeći ssh i scp komande, ili putem serijskih UART ili USB veza koristeći alate kao što su minicom za Linux ili Tera Term za Windows.

Koraci za brzu procjenu softvera

• Korak 01: Fleširajte početni paket na SD kartici.
• Korak 02: Pokrenite ploču sa početnim paketom.
• Korak 03: Omogućite internet konekciju na ploči putem Etherneta ili Wi-Fi veze. Za pomoć pogledajte relevantne wiki stranice.
• Korak 04: Preuzmite unapred napravljene slike sa X-LINUX-NFC5 web stranici na ST website
• Korak 05: Koristite sljedeće naredbe da kopirate blob stabla uređaja i ažurirate novu konfiguraciju platforme:
  Ako mrežna veza nije dostupna, možete prenijeti files lokalno sa vašeg Windows računara na Discovery Kit koristeći Tera Term.
  Za više detalja o prijenosu podataka files korištenjem Tera Term.
  
• Korak 06: Nakon što se ploča pokrene, kopirajte binarnu aplikaciju i dijeljenu lib na ploču za otkrivanje.
  Aplikacija će početi da radi kada se ove komande izvrše.

Kako ažurirati konfiguraciju platforme u paketu za programere

Sljedeći koraci će vam omogućiti da postavite razvojno okruženje.

• Korak 01: Preuzmite Developer Package i instalirajte SDK u zadanu strukturu foldera na vašem Ubuntu uređaju.
  Uputstva možete pronaći ovdje: Instalirajte SDK
• Korak 02: Otvorite stablo uređaja file 'stm32mp157f-dk2.dts' u izvornom kodu paketa za programere i dodajte isječak koda ispod u file:
  Ovo ažurira stablo uređaja da omogući i konfiguriše interfejs upravljačkog programa SPI4.
  
• Korak 03: Kompilirajte paket za programere da biste dobili stm32mp157f-dk2.dtb file.

Kako napraviti RFAL Linux kod aplikacije

Prije nego što počnete, SDK mora biti preuzet, instaliran i omogućen. Preuzmite aplikaciju sa linka: X-LINUX-NFC5

• Korak 1. Pokrenite donje naredbe za unakrsno kompajliranje koda:
  Ove naredbe će izgraditi sljedeće files:
  • Bivšiampaplikacija: nfc_poller_st25r3911
  • zajednička biblioteka za pokretanje example aplikacija: librfal_st25r3911.so
    

Kako pokrenuti RFAL Linux aplikaciju na STM32MP157F-DK2

• Korak 01: Kopirajte generirane binarne datoteke u Discovery Kit koristeći donje naredbe
  
• Korak 02: Otvorite terminal na ploči Discovery Kit ili koristite ssh prijavu i pokrenite aplikaciju koristeći sljedeće naredbe.
  Korisnik će na ekranu vidjeti donju poruku:
  
• Korak 03: Kada je NFC tag se približi NFC prijemniku, UID-u i NFC-u tag tip se prikazuje na ekranu.

Discovery Kit Pokreće aplikaciju nfcPoller

Kako uključiti Meta-nfc5 sloj u distribucijski paket

• Korak 01: Preuzmite i kompajlirajte distribucijski paket na vašoj Linux mašini.
• Korak 02: Pratite zadanu strukturu direktorija koju je predložila ST wiki stranica da biste sinhrono pratili ovaj dokument.
• Korak 03: Preuzmite paket aplikacije X-LINUX-NFC5:
  
• Korak 04: Postavite konfiguraciju izgradnje.
  
• Korak 05: Dodajte sloj meta-nfc5 u konfiguraciju izgradnje konfiguracije distributivnog paketa.
  
• Korak 06: Ažurirajte konfiguraciju da dodate nove komponente u svoju sliku.
  
• Korak 07: Napravite svoj sloj zasebno, a zatim napravite kompletan distributivni sloj.
  Napomena: Izgradnja stranice za distribuciju po prvi put može potrajati nekoliko sati. Međutim, potrebno je samo nekoliko minuta da se izgradi meta-nfc5 sloj i instaliraju izvršni fajlovi u konačnim slikama. Nakon što je gradnja završena, slike su prisutne u sljedećem direktoriju: build- - /tmp-glibc/deploy/images/stm32mp1.
• Korak 08: Slijedite upute na ST wiki stranici: Flešovanje izgrađene slike za flešovanje novih napravljenih slika na
  komplet za otkrivanje.
• Korak 09: Pokrenite aplikaciju kao što je navedeno u koraku 2 odeljka 3.4.

Kako prenijeti Files Korištenje Tera Term

Za prijenos možete koristiti aplikaciju emulatora Windows terminala kao što je Tera Term files vašeg računara na Discovery Kit.

• Korak 01: Uključite USB napajanje u Discovery Kit.
• Korak 02: Povežite Discovery Kit sa svojim računarom preko USB micro B konektora (CN11).
• Korak 03: Provjerite broj virtuelnog COM porta u upravitelju uređaja.
  Na slici ispod, broj COM porta je 14.
  Snimak ekrana upravitelja uređaja koji prikazuje virtuelni kom port
  
• Korak 04: Otvorite Tera Term na svom računaru i izaberite COM port identifikovan u prethodnom koraku. Brzina prijenosa bi trebala biti 115200 baudova.
  Snimak udaljenog terminala preko Tera Term
  
• Korak 05: Za prijenos a file sa glavnog računara na Discovery Kit, odaberite [File]>[Transfer]>[ZMODEM]>[Pošalji] u gornjem levom uglu prozora Tera Term.
  Tera Term File Transfer Menu
  
• Korak 06: Odaberite file biti prebačen u file pretraživač i izaberite [Otvori].
  File Prozor pretraživača za slanje Files
  .
• Korak 07: Traka napretka će pokazati status file transfer.
  File Traka napretka prijenosa
  

Istorija revizija

Istorija revizija dokumenta

Datum	Verzija	Promjene
30-okt-2020	1	Prvo izdanje.
15-Jul-2021	2	Ažurirano Odjeljak 1.1 Glavne karakteristike, Odjeljak 2 Podešavanje hardvera, Odjeljak 2.1 Kako povežite hardver, Odjeljak 3 Podešavanje softvera, Odjeljak 3.1 Koraci za brzu evaluaciju softver, Odjeljak 3.2 Kako ažurirati konfiguraciju platforme u paketu programera i Odjeljak 3.3 Kako napraviti RFAL Linux kod aplikacije. Dodano Odjeljak 3.5 Kako uključiti meta-nfc5 sloj u distribucijski paket. Dodate informacije o kompatibilnosti kompleta za otkrivanje STM32MP157F-DK2.

Dokumenti / Resursi

ST UM2766 X-LINUX-NFC5 paket za razvoj NFC/RFID čitača [pdf] Korisnički priručnik UM2766, X-LINUX-NFC5 paket za razvoj NFC-RFID čitača, razvoj NFC-RFID čitača, NFC-RFID čitač, X-LINUX-NFC5 paket, X-LINUX-NFC5

Reference

• Uputstvo za upotrebu