ST UM2766 X-LINUX-NFC5 paketas, skirtas NFC / RFID skaitytuvui kurti

Įvadas

Šis STM32 MPU OpenSTLinux programinės įrangos išplėtimo paketas parodo, kaip galite sukurti NFC/RF ryšį standartinei Linux sistemai, naudodami mūsų radijo dažnių abstrakcijos biblioteką (RFAL). RFAL bendrosios sąsajos tvarkyklė užtikrina, kad vartotojo funkcijos ir taikomoji programinė įranga būtų suderinama su bet kuriuo ST25R NFC/RFID skaitytuvo IC.
„X-LINUX-NFC5“ paketas perkelia RFAL į „Discovery Kit“ su STM32MP1 serijos mikroprocesoriumi, kuriame veikia „Linux“, kad būtų galima valdyti ST25R3911B NFC priekinę dalį STM32 Nucleo išplėtimo plokštėje. Į paketą įeina kaipampprograma, kuri padės suprasti įvairių tipų NFC aptikimą tags ir mobiliuosius telefonus, palaikančius P2P.
Šaltinio kodas sukurtas taip, kad jį būtų galima perkelti į įvairius apdorojimo įrenginius, kuriuose veikia „Linux“, ir palaiko visus žemesnius sluoksnius ir kai kuriuos aukštesnio sluoksnio ST25R IC protokolus, skirtus abstrakčiam RF ryšiui.

Radijo dažnių abstrakcijos biblioteka, skirta Linux

RFAL	Protokolai	ISO DEP			NFC DEP
	Technologijos	NFC-A	NFC-B	NFC-F	NFC-V	„T1T“	ST25TB
	HAL	RF
		RF konfigūracijos
		ST25R3911B

X-LINUX-NFC5 baigėsiview

Pagrindinės savybės

X-LINUX-NFC5 programinės įrangos išplėtimo paketas apima šias funkcijas:

• Užbaikite „Linux“ vartotojo erdvės tvarkyklę (RF abstrakcijos sluoksnis), kad sukurtumėte NFC palaikytas programas naudojant ST25R3911B/ST25R391x NFC priekines dalis su iki 1.4 W išėjimo galia.
• „Linux“ pagrindinio kompiuterio ryšys su ST25R3911B/ST25R391x per didelės spartos SPI sąsają.
• Visiškas RF / NFC abstrakcija (RFAL) visoms pagrindinėms technologijoms ir aukštesnio lygio protokolams:
  • ALR-A (ISO14443-A),
  • ALR-B (ISO14443-B),
  • ALR-F (FELICA)
  • ALR-V (ISO15693)
  • P2P (ISO18092)
  • ISO-DEP (ISO duomenų mainų protokolas, ISO14443-4)
  • NFC-DEP (NFC duomenų mainų protokolas, ISO18092)
  • Patentuotos technologijos (Kovio, B', iClass, Calypso ir kt.)
• SampGalimas įgyvendinimas naudojant X-NUCLEO-NFC05A1 išplėtimo plokštę, prijungtą prie STM32MP157F-DK2
• Sampprograma, skirta aptikti kelis NFC tags tipai

Paketo architektūra

Programinės įrangos paketas veikia STM7MP32 serijos A1 branduolyje. X-LINUX-NFC5 sąveikauja su žemesnių sluoksnių bibliotekomis ir SPI linijomis, kurias veikia Linux programinės įrangos sistema.

X-LINUX-NFC5 taikomųjų programų architektūra Linux aplinkoje

Aparatinės įrangos sąranka

Aparatinės įrangos reikalavimai:

• 16.04 ar naujesnė Ubuntu kompiuterio / virtualaus įrenginio versija
• STM32MP157F-DK2 plokštė (Discovery Kit)
• X-NUCLEO-NFC05A1
• 8 GB „micro SD“ kortelė, skirta STM32MP157F-DK2 paleisti
• SD kortelių skaitytuvas / LAN ryšys
• A tipo USB iki mikro B tipo USB kabelis
• A tipo USB iki C tipo USB kabelis
• Su USB PD suderinamas 5V 3A maitinimo šaltinis

Kompiuteris / virtuali mašina sudaro kryžminio kūrimo platformą, kad būtų galima sukurti RFAL biblioteką ir programos kodą, kad būtų galima aptikti ir susisiekti su NFC įrenginiais per ST25R3911B IC.

Kaip prijungti aparatinę įrangą

1 veiksmas. Prijunkite X-NUCLEO-NFC05A1 išplėtimo plokštę prie Arduino jungčių, esančių apatinėje STM32MP157F-DK2 atradimo plokštės pusėje.

Nucleo plokštės ir Discovery plokštės Arduino jungtys

1. X-NUCLEO-NFC05A1 išplėtimo plokštė
2. STM32MP157F-DK2 atradimų lenta
3. Arduino jungtys

2 veiksmas. Prijunkite ST-LINK programuotoją / derintuvą, įdėtą atradimo plokštėje, prie pagrindinio kompiuterio per USB mikro B tipo prievadą (CN11).

3 veiksmas. Maitinkite aptikimo plokštę per C tipo USB prievadą (CN6).

Visas aparatinės įrangos ryšio nustatymas

SUSIJUSIOS NUORODOS
Daugiau informacijos apie maitinimo šaltinį ir ryšio prievadus rasite šiame wiki

Programinės įrangos sąranka

Prieš pradėdami, įjunkite STM32MP157F-DK2 Discovery rinkinį naudodami USB PD suderinamą 5 V, 3 A maitinimo šaltinį ir įdiekite pradinį paketą pagal instrukcijas, pateiktas pradžios wiki. Jums reikės mažiausiai 2 GB „microSD“ kortelės, kad galėtumėte paleisti įkrovos vaizdus.
Norint paleisti programą, reikia atnaujinti platformos konfigūraciją atnaujinant įrenginio medį, kad būtų įjungti atitinkami išoriniai įrenginiai. Tai galite padaryti greitai naudodami turimus iš anksto sukurtus vaizdus arba galite sukurti įrenginio medį ir sukurti savo branduolio vaizdus.
Taip pat galite (pasirinktinai) sukurti šį programinės įrangos paketą įtraukdami Yocto sluoksnį (meta-nfc5) į ST platinimo paketą. Ši operacija sukuria šaltinio kodą ir apima įrenginio medžio modifikacijas kartu su sukompiliuotais dvejetainiais failais galutiniuose atvaizduose. Išsamius veiksmus, aprašančius procesą, rasite 3.5 skyriuje.
Galite prisijungti prie „Discovery Kit“ iš pagrindinio kompiuterio per TCP/IP tinklą naudodami ssh ir scp komandas arba per nuosekliąsias UART arba USB nuorodas, naudodami tokius įrankius kaip „minicom“, skirta „Linux“, arba „Tera Term“, skirta „Windows“.

Greito programinės įrangos įvertinimo žingsniai

• 01 veiksmas: SD kortelėje įjunkite pradinį paketą.
• 02 veiksmas: paleiskite plokštę su pradiniu paketu.
• 03 veiksmas: įjunkite interneto ryšį plokštėje per Ethernet arba Wi-Fi. Pagalbos ieškokite atitinkamuose wiki puslapiuose.
• 04 veiksmas: atsisiųskite iš anksto sukurtus vaizdus iš X-LINUX-NFC5 web puslapyje ST websvetainę
• 05 veiksmas: naudokite šias komandas, kad nukopijuotumėte įrenginio medžio blobą ir atnaujintumėte naują platformos konfigūraciją:
  Jei tinklo ryšys nepasiekiamas, galite perkelti files vietoje iš „Windows“ kompiuterio į „Discovery Kit“ naudojant „Tera Term“.
  Daugiau informacijos apie duomenų perdavimą files naudoja Tera Term.
  
• 06 veiksmas: kai plokštė bus paleista, nukopijuokite programos dvejetainį failą ir bendrinamą lib į atradimų lentą.
  Programa pradės veikti, kai bus įvykdytos šios komandos.

Kaip atnaujinti platformos konfigūraciją kūrėjo pakete

Šie veiksmai leis jums nustatyti kūrimo aplinką.

• 01 veiksmas: atsisiųskite kūrėjo paketą ir įdiekite SDK į numatytąją aplankų struktūrą Ubuntu kompiuteryje.
  Instrukcijas rasite čia: Įdiekite SDK
• 02 veiksmas: atidarykite įrenginio medį file „stm32mp157f-dk2.dts“ kūrėjų paketo šaltinio kode ir toliau pateiktą kodo fragmentą pridėkite prie file:
  Tai atnaujina įrenginio medį, kad būtų įjungta ir sukonfigūruota SPI4 tvarkyklės sąsaja.
  
• 03 veiksmas: sukompiliuokite kūrėjo paketą, kad gautumėte stm32mp157f-dk2.dtb file.

Kaip sukurti RFAL Linux programos kodą

Prieš pradedant SDK reikia atsisiųsti, įdiegti ir įgalinti. Atsisiųskite programą iš nuorodos: X-LINUX-NFC5

• 1 veiksmas. Vykdykite toliau pateiktas komandas, kad sukompiliuotumėte kodą:
  Šios komandos bus sukurtos toliau files:
  • Buvęsampprograma: nfc_poller_st25r3911
  • bendrinamas lib, skirtas exampprograma: librfal_st25r3911.so
    

Kaip paleisti RFAL Linux programą STM32MP157F-DK2

• 01 veiksmas: nukopijuokite sugeneruotus dvejetainius failus į „Discovery Kit“ naudodami toliau pateiktas komandas
  
• 02 veiksmas: atidarykite terminalą Discovery Kit plokštėje arba naudokite ssh prisijungimą ir paleiskite programą naudodami šias komandas.
  Vartotojas ekrane matys toliau pateiktą pranešimą:
  
• 03 veiksmas: kai NFC tag yra šalia NFC imtuvo, UID ir NFC tag tipas rodomas ekrane.

Atradimų rinkinys, kuriame veikia „nfcPoller“ programa

Kaip į platinimo paketą įtraukti „Meta-nfc5“ sluoksnį

• 01 veiksmas: atsisiųskite ir sukompiliuokite platinimo paketą savo „Linux“ kompiuteryje.
• 02 veiksmas: vykdykite numatytąją ST wiki puslapio siūlomą katalogo struktūrą, kad galėtumėte sinchroniškai sekti šį dokumentą.
• 03 veiksmas: atsisiųskite X-LINUX-NFC5 programos paketą:
  
• 04 veiksmas: nustatykite kūrimo konfigūraciją.
  
• 05 veiksmas: pridėkite meta-nfc5 sluoksnį prie platinimo paketo konfigūracijos kūrimo konfigūracijos.
  
• 06 veiksmas: atnaujinkite konfigūraciją, kad pridėtumėte naujų komponentų į vaizdą.
  
• 07 veiksmas: sukurkite sluoksnį atskirai, tada sukurkite visą paskirstymo sluoksnį.
  Pastaba: Pirmą kartą platinimo puslapio kūrimas gali užtrukti kelias valandas. Tačiau meta-nfc5 sluoksnio sukūrimas ir vykdomųjų failų įdiegimas galutiniuose vaizduose užtrunka tik kelias minutes. Kai kūrimas bus baigtas, vaizdai bus šiame kataloge: build- - /tmp-glibc/deploy/images/stm32mp1.
• 08 veiksmas: vadovaukitės ST wiki puslapyje pateiktomis instrukcijomis: Sukurto vaizdo mirksėjimas, kad nauji sukurti vaizdai būtų rodomi ant
  atradimų rinkinys.
• 09 veiksmas: paleiskite programą, kaip nurodyta 2 skirsnio 3.4 veiksme.

Kaip pervesti Files Tera termino naudojimas

Norėdami perkelti, galite naudoti „Windows“ terminalo emuliatoriaus programą, pvz., „Tera Term“. files iš kompiuterio į Discovery Kit.

• 01 veiksmas: tiekkite USB maitinimą Discovery Kit.
• 02 veiksmas: prijunkite „Discovery Kit“ prie kompiuterio per USB mikro B tipo jungtį (CN11).
• 03 veiksmas: įrenginių tvarkytuvėje patikrinkite virtualaus COM prievado numerį.
  Žemiau esančioje ekrano kopijoje COM prievado numeris yra 14.
  Įrenginių tvarkytuvės, kurioje rodomas virtualus komunikacinis prievadas, ekrano kopija
  
• 04 veiksmas: savo kompiuteryje atidarykite „Tera Term“ ir pasirinkite COM prievadą, nurodytą ankstesniame veiksme. Bodų sparta turėtų būti 115200 XNUMX bodų.
  Nuotolinio terminalo momentinė nuotrauka per „Tera Term“.
  
• 05 veiksmas: Norėdami perkelti a file iš pagrindinio kompiuterio į Discovery Kit, pasirinkite [File]>[Perkelti]>[ZMODEM]>[Siųsti] viršutiniame kairiajame Tera Term lango kampe.
  Tera terminas File Perkėlimo meniu
  
• 06 veiksmas: pasirinkite file būti perkeltas į file naršyklę ir pasirinkite [Atidaryti].
  File Naršyklės langas siuntimui Files
  .
• 07 veiksmas: eigos juostoje bus rodoma būsena file perkėlimas.
  File Perkėlimo eigos juosta
  

Revizijos istorija

Dokumento taisymo istorija

Data	Versija	Pakeitimai
30-spalio-2020 d	1	Pradinis išleidimas.
15-liepos-2021 d	2	Atnaujinta 1.1 skyrius Pagrindinės savybės, 2 skyrius Aparatinės įrangos sąranka, 2.1 skyrius Kaip prijungti aparatūrą, 3 skyrius Programinės įrangos sąranka, 3.1 skyrius Greito įvertinimo žingsniai programinė įranga, 3.2 skyrius Kaip atnaujinti platformos konfigūraciją kūrėjo pakete ir 3.3 skyrius Kaip sukurti RFAL Linux programos kodą. Pridėta 3.5 skyrius Kaip įtraukti meta-nfc5 sluoksnį į platinimo paketą. Pridėta STM32MP157F-DK2 atradimo rinkinio suderinamumo informacija.

Dokumentai / Ištekliai

ST UM2766 X-LINUX-NFC5 paketas, skirtas NFC / RFID skaitytuvui kurti [pdf] Naudotojo vadovas UM2766, X-LINUX-NFC5 paketas, skirtas NFC-RFID skaitytuvui kurti, NFC-RFID skaitytuvui kurti, NFC-RFID skaitytuvui, X-LINUX-NFC5 paketui, X-LINUX-NFC5

Nuorodos

• Vartotojo vadovas