ST UM2766 X-LINUX-NFC5 pakotne NFC/RFID lasītāja izstrādei

Ievads

Šī STM32 MPU OpenSTLinux programmatūras paplašināšanas pakotne parāda, kā jūs varat izveidot NFC/RF komunikāciju standarta Linux sistēmai, izmantojot mūsu radiofrekvenču abstrakcijas bibliotēku (RFAL). RFAL kopējā interfeisa draiveris nodrošina lietotāja funkciju un lietojumprogrammatūras saderību ar jebkuru ST25R NFC/RFID lasītāja IC.
X-LINUX-NFC5 pakotne pievieno RFAL Discovery Kit ar STM32MP1 sērijas mikroprocesoru, kurā darbojas operētājsistēma Linux, lai vadītu ST25R3911B NFC priekšējo daļu STM32 Nucleo paplašināšanas platē. Komplektā ietilpst kāamplietojumprogramma, kas palīdz izprast dažādu NFC veidu noteikšanu tags un mobilie tālruņi, kas atbalsta P2P.
Avota kods ir paredzēts pārnesamībai plašā procesoru vienībās, kurās darbojas Linux, un atbalsta visus ST25R IC zemākos slāņus un dažus augstāka slāņa protokolus abstraktai RF komunikācijai.

Radiofrekvenču abstrakcijas bibliotēka operētājsistēmai Linux

RFAL	Protokoli	ISO DEP			NFC DEP
	Tehnoloģijas	NFC-A	NFC-B	NFC-F	NFC-V	T1T	ST25TB
	HAL	RF
		RF konfigurācijas
		ST25R3911B

X-LINUX-NFC5 beidziesview

Galvenās iezīmes

X-LINUX-NFC5 programmatūras paplašināšanas pakotnē ir iekļautas šādas funkcijas:

• Pabeigts Linux lietotāja telpas draiveris (RF abstrakcijas slānis), lai izveidotu NFC iespējotas lietojumprogrammas, izmantojot ST25R3911B/ST25R391x NFC priekšpuses ar līdz pat 1.4 W izejas jaudu.
• Linux saimniekdatora saziņa ar ST25R3911B/ST25R391x, izmantojot ātrgaitas SPI interfeisu.
• Pilnīga RF/NFC abstrakcija (RFAL) visām galvenajām tehnoloģijām un augstāka slāņa protokoliem:
  • NFC-A (ISO14443-A)
  • NFC-B (ISO14443-B)
  • NFC-F (FeliCa)
  • NFC-V (ISO15693)
  • P2P (ISO18092)
  • ISO-DEP (ISO datu apmaiņas protokols, ISO14443-4)
  • NFC-DEP (NFC datu apmaiņas protokols, ISO18092)
  • Patentētas tehnoloģijas (Kovio, B', iClass, Calypso utt.)
• SampPieejama ieviešana ar X-NUCLEO-NFC05A1 paplašināšanas plati, kas pievienota STM32MP157F-DK2
• Samplietojumprogramma, lai noteiktu vairākus NFC tags veidi

Pakešu arhitektūra

Programmatūras pakotne darbojas STM7MP32 sērijas A1 kodolā. X-LINUX-NFC5 mijiedarbojas ar zemāko slāņu bibliotēkām un SPI līnijām, kuras atklāj Linux programmatūras ietvars.

X-LINUX-NFC5 lietojumprogrammu arhitektūra Linux vidē

Aparatūras iestatīšana

Aparatūras prasības:

• Uz Ubuntu balstīta datora/virtuālās mašīnas versija 16.04 vai jaunāka
• STM32MP157F-DK2 plate (Discovery Kit)
• X-NUCLEO-NFC05A1
• 8 GB micro SD karte, lai palaistu STM32MP157F-DK2
• SD karšu lasītājs / LAN savienojums
• USB Type-A līdz Type-micro B USB kabelis
• A tipa līdz C tipa USB USB kabelis
• USB PD saderīgs 5V 3A barošanas avots

Personālais dators/virtuālā iekārta veido starpnozaru platformu, lai izveidotu RFAL bibliotēku un lietojumprogrammas kodu, lai noteiktu un sazinātos ar NFC ierīcēm, izmantojot IC ST25R3911B.

Kā savienot aparatūru

1. darbība. Pievienojiet X-NUCLEO-NFC05A1 paplašināšanas plati Arduino savienotājiem, kas atrodas STM32MP157F-DK2 atklāšanas plates apakšējā pusē.

Nucleo plates un Discovery plates Arduino savienotāji

1. X-NUCLEO-NFC05A1 paplašināšanas plate
2. STM32MP157F-DK2 atklāšanas plate
3. Arduino savienotāji

2. darbība. Savienojiet ST-LINK programmētāju/atkļūdotāju, kas iegults atklāšanas platē, ar resursdatoru, izmantojot USB micro B tipa portu (CN11).

3. darbība. Ieslēdziet atklāšanas plati, izmantojot C tipa USB portu (CN6).

Pilna aparatūras savienojuma iestatīšana

SAISTĪTĀS SAITES
Plašāku informāciju par barošanas avotu un sakaru portiem skatiet šajā wiki

Programmatūras iestatīšana

Pirms sākat, ieslēdziet STM32MP157F-DK2 Discovery komplektu, izmantojot USB PD saderīgu 5 V, 3 A barošanas avotu, un instalējiet sākuma pakotni saskaņā ar instrukcijām darba sākšanas wiki. Lai palaistu attēlus, jums būs nepieciešama vismaz 2 GB microSD karte.
Lai palaistu lietojumprogrammu, platformas konfigurācija ir jāatjaunina, atjauninot ierīces koku, lai iespējotu attiecīgās perifērijas ierīces. To var izdarīt ātri, izmantojot pieejamos iepriekš izveidotos attēlus, vai arī varat izstrādāt ierīces koku un izveidot savus kodola attēlus.
Varat arī (pēc izvēles) izveidot šo programmatūras pakotni, iekļaujot Yocto slāni (meta-nfc5) ST izplatīšanas pakotnē. Šī darbība izveido avota kodu un ietver ierīces koka modifikācijas kopā ar apkopotajiem binārajiem failiem galīgajos mirgojamajos attēlos. Detalizētas darbības, kas apraksta procesu, skatiet 3.5. sadaļā.
Varat izveidot savienojumu ar Discovery Kit no resursdatora, izmantojot TCP/IP tīklu, izmantojot ssh un scp komandas, vai seriālās UART vai USB saites, izmantojot tādus rīkus kā minicom operētājsistēmai Linux vai Tera Term operētājsistēmai Windows.

Pasākumi ātrai programmatūras novērtēšanai

• 01. darbība: SD kartē aktivizējiet sākuma pakotni.
• 02. darbība: sāknējiet paneli ar sākuma pakotni.
• 03. darbība. Iespējojiet interneta savienojumu, izmantojot Ethernet vai Wi-Fi. Lai saņemtu palīdzību, skatiet attiecīgās wiki lapas.
• 04. darbība. Lejupielādējiet iepriekš izveidotos attēlus no X-LINUX-NFC5 web lapa ST webvietne
• 05. darbība: izmantojiet šīs komandas, lai kopētu ierīces koka lāse un atjauninātu jauno platformas konfigurāciju:
  Ja tīkla savienojums nav pieejams, varat pārsūtīt files lokāli no jūsu Windows datora uz Discovery Kit, izmantojot Tera Term.
  Sīkāka informācija par datu pārsūtīšanu files izmanto Tera Term.
  
• 06. darbība. Kad dēlis ir sāknēts, kopējiet lietojumprogrammas bināro failu un koplietoto lib uz atklāšanas paneli.
  Lietojumprogramma sāks darboties, tiklīdz šīs komandas tiks izpildītas.

Kā atjaunināt platformas konfigurāciju izstrādātāja pakotnē

Tālāk norādītās darbības ļaus iestatīt izstrādes vidi.

• 01. darbība: lejupielādējiet izstrādātāja pakotni un instalējiet SDK noklusējuma mapju struktūrā savā Ubuntu datorā.
  Norādījumus varat atrast šeit: SDK instalēšana
• 02. darbība: atveriet ierīces koku file “stm32mp157f-dk2.dts” izstrādātāja pakotnes avota kodā un pievienojiet tālāk norādīto koda fragmentu file:
  Tādējādi tiek atjaunināts ierīces koks, lai iespējotu un konfigurētu SPI4 draivera interfeisu.
  
• 03. darbība. Kompilējiet izstrādātāja pakotni, lai iegūtu stm32mp157f-dk2.dtb file.

Kā izveidot RFAL Linux lietojumprogrammas kodu

Pirms sākat, SDK ir jālejupielādē, jāinstalē un jāiespējo. Lejupielādējiet lietojumprogrammu no saites: X-LINUX-NFC5

• 1. darbība. Palaidiet tālāk norādītās komandas, lai savstarpēji kompilētu kodu:
  Šīs komandas veidos sekojošo files:
  • Bijušaisamplietojumprogramma: nfc_poller_st25r3911
  • koplietots lib, lai palaistu examppieteikums: librfal_st25r3911.so
    

Kā palaist RFAL Linux lietojumprogrammu STM32MP157F-DK2

• 01. darbība: kopējiet ģenerētos bināros failus Discovery Kit, izmantojot tālāk norādītās komandas
  
• 02. darbība. Atveriet termināli Discovery Kit panelī vai izmantojiet ssh pieteikšanos un palaidiet lietojumprogrammu, izmantojot šādas komandas.
  Lietotājs ekrānā redzēs šādu ziņojumu:
  
• 03. darbība. Kad NFC tag atrodas tuvu NFC uztvērējam, UID un NFC tag tips tiek parādīts ekrānā.

Atklāšanas komplekts, kurā darbojas lietojumprogramma nfcPoller

Kā izplatīšanas pakotnē iekļaut meta-nfc5 slāni

• 01. darbība: lejupielādējiet un kompilējiet izplatīšanas paketi savā Linux datorā.
• 02. darbība. Lai sinhroni sekotu šim dokumentam, izpildiet ST wiki lapas ieteikto noklusējuma direktoriju struktūru.
• 03. darbība. Lejupielādējiet X-LINUX-NFC5 lietojumprogrammas pakotni:
  
• 04. darbība: iestatiet būvēšanas konfigurāciju.
  
• 05. darbība. Pievienojiet meta-nfc5 slāni izplatīšanas pakotnes konfigurācijas būvkonfigurācijai.
  
• 06. darbība. Atjauniniet konfigurāciju, lai attēlam pievienotu jaunus komponentus.
  
• 07. darbība: izveidojiet slāni atsevišķi un pēc tam izveidojiet visu izplatīšanas slāni.
  Piezīme: Izplatīšanas lapas izveide pirmo reizi var ilgt vairākas stundas. Tomēr ir nepieciešamas tikai dažas minūtes, lai izveidotu meta-nfc5 slāni un instalētu izpildāmos failus gala attēlos. Kad būvēšana ir pabeigta, attēli atrodas šādā direktorijā: build- - /tmp-glibc/deploy/images/stm32mp1.
• 08. darbība. Izpildiet ST wiki lapā sniegtos norādījumus: iebūvētā attēla mirgošana, lai jaunos iebūvētos attēlus mirgotu uz
  atklājumu komplekts.
• 09. darbība. Palaidiet lietojumprogrammu, kā minēts 2. sadaļas 3.4. darbībā.

Kā pārsūtīt Files Tera termina lietošana

Pārsūtīšanai varat izmantot Windows termināļa emulatora lietojumprogrammu, piemēram, Tera Term files no datora uz Discovery Kit.

• 01. darbība. Piegādājiet atklāšanas komplektam USB strāvu.
• 02. darbība: savienojiet Discovery Kit ar datoru, izmantojot USB micro B tipa savienotāju (CN11).
• 03. darbība. Ierīču pārvaldniekā pārbaudiet virtuālā COM porta numuru.
  Tālāk esošajā ekrānuzņēmumā COM porta numurs ir 14.
  Ekrānuzņēmums ar ierīces pārvaldnieku, kurā ir redzams virtuālais sakaru ports
  
• 04. darbība: datorā atveriet Tera Term un atlasiet iepriekšējā darbībā norādīto COM portu. Bodu ātrumam jābūt 115200 XNUMX bodu.
  Attālā termināļa momentuzņēmums, izmantojot Tera Term
  
• 05. darbība. Lai pārsūtītu a file no resursdatora uz Discovery Kit, atlasiet [File]>[Pārsūtīt]>[ZMODEM]>[Sūtīt] Tera Term loga augšējā kreisajā stūrī.
  Tera termins File Pārsūtīšanas izvēlne
  
• 06. darbība: atlasiet file pārsūtīt file pārlūkprogrammu un atlasiet [Atvērt].
  File Pārlūka logs nosūtīšanai Files
  .
• 07. darbība: progresa joslā tiks parādīts statuss file nodošana.
  File Pārsūtīšanas norises josla
  

Pārskatīšanas vēsture

Dokumentu pārskatīšanas vēsture

Datums	Versija	Izmaiņas
30. gada 2020. oktobris	1	Sākotnējā izlaišana.
15. gada 2021. jūlijs	2	Atjaunināts 1.1. sadaļa Galvenās iezīmes, 2. sadaļa Aparatūras iestatīšana, Sadaļa 2.1. Kā savienojiet aparatūru, 3. sadaļa Programmatūras iestatīšana, Sadaļa 3.1. Darbības ātrai novērtēšanai programmatūra, Sadaļa 3.2. Kā atjaunināt platformas konfigurāciju izstrādātāja pakotnē un Sadaļa 3.3. Kā izveidot RFAL Linux lietojumprogrammas kodu. Pievienots Sadaļa 3.5. Kā izplatīšanas pakotnē iekļaut meta-nfc5 slāni. Pievienota STM32MP157F-DK2 atklāšanas komplekta saderības informācija.

Dokumenti / Resursi

ST UM2766 X-LINUX-NFC5 pakotne NFC/RFID lasītāja izstrādei [pdfLietotāja rokasgrāmata UM2766, X-LINUX-NFC5 pakotne NFC-RFID lasītāja izstrādei, NFC-RFID lasītāja izstrāde, NFC-RFID lasītājs, X-LINUX-NFC5 pakotne, X-LINUX-NFC5

Atsauces

• Lietotāja rokasgrāmata