ST Logo

ST UM2766 X-LINUX-NFC5-pakket vir die ontwikkeling van NFC/RFID-leser

ST UM2766 X-LINUX-NFC5-pakket vir die ontwikkeling van NFC RFID-leser

Inleiding

Hierdie STM32 MPU OpenSTLinux-sagteware-uitbreidingspakket demonstreer hoe jy NFC/RF-kommunikasie vir 'n standaard Linux-stelsel kan ontwikkel deur gebruik te maak van ons Radio Frequency Abstraction Library (RFAL). Die RFAL algemene koppelvlakbestuurder verseker dat gebruikersfunksie en toepassingsagteware versoenbaar is met enige ST25R NFC/RFID-leser-IC.
Die X-LINUX-NFC5-pakket plaas die RFAL op 'n Discovery Kit met STM32MP1-reeks mikroverwerker wat Linux gebruik om 'n ST25R3911B NFC-voorkant op 'n STM32 Nucleo-uitbreidingsbord aan te dryf. Die pakket sluit asample toepassing om jou te help om opsporing van verskillende tipes NFC te verstaan tags en selfone wat P2P ondersteun.
Die bronkode is ontwerp vir oordraagbaarheid oor 'n wye reeks verwerkingseenhede met Linux en ondersteun alle laer lae en sommige hoërlaagprotokolle van ST25R IC's om RF-kommunikasie te abstraheer.

Radiofrekwensie-abstraksiebiblioteek vir LinuxRadiofrekwensie-abstraksiebiblioteek vir Linux

RFAL

Protokolle ISO DEP NFC DEP
Tegnologieë NFC-A NFC-B NFC-F NFC-V T1T

ST25TB

HAL

RF

RF-konfigurasies

ST25R3911B

X-LINUX-NFC5 verbyview

Belangrikste kenmerke

Die X-LINUX-NFC5-sagteware-uitbreidingspakket bevat die volgende kenmerke:

  • Voltooi Linux-gebruikerspasiebestuurder (RF-abstraksielaag) om NFC-geaktiveerde toepassings te bou deur die ST25R3911B/ST25R391x NFC-voorkant met tot 1.4 W uitsetkrag te gebruik.
  • Linux-gasheerkommunikasie met die ST25R3911B/ST25R391x via hoëspoed SPI-koppelvlak.
  • Voltooi RF/NFC-abstraksie (RFAL) vir alle groot tegnologieë en hoërlaagprotokolle:
    • NFC-A (ISO14443-A)
    • NFC-B (ISO14443-B)
    • NFC-F (FeliCa)
    • NFC-V (ISO15693)
    • P2P (ISO18092)
    • ISO-DEP (ISO data-uitruilprotokol, ISO14443-4)
    • NFC-DEP (NFC data-uitruilprotokol, ISO18092)
    • Eiendomstegnologie (Kovio, B', iClass, Calypso, ens.)
  • Sample implementering beskikbaar met X-NUCLEO-NFC05A1 uitbreidingsbord gekoppel aan 'n STM32MP157F-DK2
  • Sample toepassing om verskeie NFC op te spoor tags tipes
Pakket argitektuur

Die sagtewarepakket loop op die A7-kern van die STM32MP1-reeks. Die X-LINUX-NFC5 is in wisselwerking met die onderste lae-biblioteke en SPI-lyne wat deur die Linux-sagtewareraamwerk blootgestel word.

X-LINUX-NFC5 Toepassingsargitektuur in Linux-omgewing
X-LINUX-NFC5 toepassingsargitektuur in Linux-omgewing

Hardeware-opstelling

Hardeware vereistes:

  • Ubuntu-gebaseerde rekenaar/virtuele masjien weergawe 16.04 of hoër
  • STM32MP157F-DK2 bord (Ontdekking Kit)
  • X-NUCLEO-NFC05A1
  • 8 GB mikro SD-kaart om die STM32MP157F-DK2 te selflaai
  • SD-kaartleser / LAN-verbinding
  • USB Tipe-A na Tipe-mikro B USB-kabel
  • USB Tipe A tot Tipe C USB-kabel
  • USB PD voldoen 5V 3A kragbron

Die rekenaar/virtuele masjien vorm die kruis-ontwikkelingsplatform om die RFAL-biblioteek en toepassingskode te bou om NFC-toestelle deur die ST25R3911B IC op te spoor en te kommunikeer.

Hoe om die hardeware te koppel

Stap 1. Prop die X-NUCLEO-NFC05A1-uitbreidingsbord aan op die Arduino-verbindings aan die onderkant van die STM32MP157F-DK2-ontdekkingsbord.

Nucleo-bord en Discovery-bord Arduino-verbindings

  1. X-NUCLEO-NFC05A1 uitbreidingsbord
  2. STM32MP157F-DK2 ontdekkingsbord
  3. Arduino-verbindings

Koppel die ST-LINK-programmeerder-ontfouter wat op die ontdekkingsbord ingebed is aan jou gasheerrekenaar

Stap 2. Koppel die ST-LINK-programmeerder/ontfouter wat op die ontdekkingsbord ingebed is aan jou gasheerrekenaar via die USB-mikro B-tipe poort (CN11).

Stap 3. Draai die ontdekkingsbord aan deur die USB Tipe C-poort (CN6).

Volledige hardewareverbinding-opstelling
Volledige hardeware verbinding opstelling

VERWANTE SKAKELS
Verwys na hierdie wiki vir meer besonderhede wat verband hou met kragtoevoer en kommunikasiepoorte

Sagteware-opstelling

Voordat jy begin, dryf die STM32MP157F-DK2 Discovery-stel aan via 'n USB PD-voldoende 5 V, 3 A-kragbron en installeer die beginpakket volgens die instruksies in die Aan die gang-wiki. Jy sal 'n minimum 2 GB microSD-kaart nodig hê om die selflaaibare beelde te flits.
Om die toepassing te laat loop, moet die platformkonfigurasie opgedateer word deur die toestelboom op te dateer om die relevante randapparatuur te aktiveer. Jy kan dit vinnig doen deur die voorafgeboude beelde wat beskikbaar is, te gebruik, of jy kan die toestelboom ontwikkel en jou eie kernbeelde bou.
Jy kan ook (opsioneel) hierdie sagtewarepakket bou deur die Yocto-laag (meta-nfc5 ) in die ST-verspreidingspakket in te sluit. Hierdie operasie skep die bronkode en sluit die toestelboom-wysigings in saam met saamgestelde binaries in die finale flitsbare beelde. Vir gedetailleerde stappe wat die proses beskryf, sien Afdeling 3.5.
Jy kan met die Discovery Kit vanaf die gasheerrekenaar koppel via TCP/IP-netwerk deur ssh- en scp-opdragte te gebruik, of deur seriële UART- of USB-skakels met nutsgoed soos minicom vir Linux of Tera Term vir Windows.

Stappe vir vinnige evaluering van sagteware
  • Stap 01: Flits die beginpakket op die SD-kaart.
  • Stap 02: Begin die bord met Starter Package.
  • Stap 03: Aktiveer internetverbinding op die bord via Ethernet of Wi-Fi. Verwys na relevante wiki-bladsye vir hulp.
  • Stap 04: Laai voorafgeboude beelde van die X-LINUX-NFC5 af web bladsy op die ST webwebwerf
  • Stap 05: Gebruik die volgende opdragte om die toestelboomblob te kopieer en die nuwe platformkonfigurasie op te dateer:
    As netwerkverbinding nie beskikbaar is nie, kan jy die oordra files plaaslik vanaf jou Windows-rekenaar na die Discovery Kit deur Tera Term te gebruik.
    Vir verdere besonderhede oor die oordrag van data files gebruik Tera Term.
    Stappe vir vinnige evaluering van sagteware 01
  • Stap 06: Nadat die bord opgestart het, kopieer die toepassingsbinêre en die gedeelde lib na ontdekkingsbord.
    Stappe vir vinnige evaluering van sagteware 02Die toepassing sal begin loop sodra hierdie opdragte uitgevoer is.
Hoe om die platformkonfigurasie in die ontwikkelaarpakket op te dateer

Die volgende stappe sal jou toelaat om die ontwikkelingsomgewing op te stel.

  • Stap 01: Laai ontwikkelaarpakket af en installeer die SDK in die verstekvouerstruktuur op u Ubuntu-masjien.
    U kan die instruksies hier vind: Installeer SDK
  • Stap 02: Maak die toestelboom oop file 'stm32mp157f-dk2.dts' in die Ontwikkelaarpakket-bronkode en voeg die kodebrokkie hieronder by die file:
    Dit werk die toestelboom op om die SPI4-bestuurderkoppelvlak te aktiveer en op te stel.
    Stappe vir vinnige evaluering van sagteware 03
  • Stap 03: Stel die Ontwikkelaarpakket saam om die stm32mp157f-dk2.dtb te kry file.
Hoe om die RFAL Linux-toepassingskode te bou

Voordat jy begin, moet die SDK afgelaai, geïnstalleer en geaktiveer word. Laai die toepassing af vanaf die skakel: X-LINUX-NFC5

  • Stap 1. Voer die opdragte hieronder uit om die kode saam te stel:
    Hierdie opdragte sal volgende bou files:
    • Die eksample aansoek: nfc_poller_st25r3911
    • gedeelde lib vir die bestuur van die example aansoek: librfal_st25r3911.so
      Hoe om die RFAL Linux-toepassingskode 01 te bou
Hoe om die RFAL Linux-toepassing op STM32MP157F-DK2 uit te voer
  • Stap 01: Kopieer gegenereerde binaries na die Discovery Kit deur die onderstaande opdragte te gebruik
    Hoe om die RFAL Linux-toepassing op STM32MP157F-DK2 01 te laat loop
  • Stap 02: Maak terminaal op die Discovery Kit-bord oop of gebruik ssh-aanmelding en laat die toepassing die volgende opdragte gebruik.
    Hoe om die RFAL Linux-toepassing op STM32MP157F-DK2 02 te laat loopDie gebruiker sal die onderstaande boodskap op die skerm sien:
    Hoe om die RFAL Linux-toepassing op STM32MP157F-DK2 03 te laat loop
  • Stap 03: Wanneer 'n NFC tag word naby die NFC-ontvanger, die UID en NFC gebring tag tipe word op die skerm vertoon.

Discovery Kit wat die nfcPoller-toepassing uitvoer
Discovery Kit wat die nfcPoller-toepassing uitvoer

Hoe om Meta-nfc5-laag in die verspreidingspakket in te sluit
  • Stap 01: Laai die verspreidingspakket af en stel dit saam op u Linux-masjien.
  • Stap 02: Volg die verstekgidsstruktuur wat deur ST wiki-bladsy voorgestel word om hierdie dokument sinchronies te volg.
  • Stap 03: Laai die X-LINUX-NFC5-toepassingspakket af:
    Hoe om meta-nfc5-laag in die verspreidingspakket 01 in te sluit
  • Stap 04: Stel die boukonfigurasie op.
    Hoe om meta-nfc5-laag in die verspreidingspakket 02 in te sluit
  • Stap 05: Voeg die meta-nfc5-laag by die boukonfigurasie van die verspreidingspakketkonfigurasie.
    Hoe om meta-nfc5-laag in die verspreidingspakket 03 in te sluit
  • Stap 06: Dateer die konfigurasie op om nuwe komponente in jou prent by te voeg.
    Hoe om meta-nfc5-laag in die verspreidingspakket 04 in te sluit
  • Stap 07: Bou jou laag afsonderlik en bou dan die volledige verspreidingslaag.
    Hoe om meta-nfc5-laag in die verspreidingspakket 05 in te sluitLet wel: Die bou van die verspreidingsbladsy vir die eerste keer kan 'n paar uur neem. Dit neem egter net 'n paar minute om meta-nfc5-laag te bou en die uitvoerbare programme in die finale beelde te installeer. Sodra die bou voltooi is, is die beelde teenwoordig in die volgende gids: build- - /tmp-glibc/deploy/images/stm32mp1.
  • Stap 08: Volg instruksies op ST wiki-bladsy: Flits die geboude prent om die nuwe geboude prente op die
    ontdekkingspakket.
  • Stap 09: Begin die toepassing soos genoem in Stap 2 van Afdeling 3.4.

Hoe om oor te dra Files Gebruik Tera Term

Jy kan 'n Windows-terminale emulator-toepassing soos Tera Term gebruik om oor te dra files van jou rekenaar na die Discovery Kit.

  • Stap 01: Voorsien USB-krag aan die Discovery Kit.
  • Stap 02: Koppel die Discovery Kit aan jou rekenaar via die USB mikro B tipe aansluiting (CN11).
  • Stap 03: Gaan die virtuele COM-poortnommer in die toestelbestuurder na.
    In die skermkiekie hieronder is die COM-poortnommer 14.
    Skermskoot van toestelbestuurder wat virtuele compoort wys
    Skermskoot van toestelbestuurder wat virtuele com-poort wys
  • Stap 04: Maak Tera Term op jou rekenaar oop en kies die COM-poort wat in die vorige stap geïdentifiseer is. Die baudkoers moet 115200 baud wees.
    Foto van afstandterminale via Tera Termyn
    Foto van afgeleë terminale via Tera Term
  • Stap 05: Om a file van die gasheerrekenaar na Discovery Kit, kies [File]>[Oordrag]>[ZMODEM]>[Stuur] in die boonste linkerhoek van die Tera Term-venster.
    Tera Termyn File Oordragkieslys
    Tera Termyn file oordrag spyskaart
  • Stap 06: Kies die file oorgedra te word in die file blaaier en kies [Open].
    File Blaaiervenster om te stuur Files
    File blaaier venster om te stuur files
    .
  • Stap 07: 'n Vorderingsbalk sal die status van wys file oordra.
    File Oordragvorderingsbalk
    File oordrag vorderingsbalk

Hersieningsgeskiedenis

Dokument Hersieningsgeskiedenis

Datum

Weergawe

Veranderinge

30 Oktober 2020

1

Aanvanklike vrystelling.

 15 Julie 2021

2

Opgedateer Afdeling 1.1 Hoofkenmerke, Afdeling 2 Hardeware-opstelling, Afdeling 2.1 Hoe om koppel die hardeware, Afdeling 3 Sagteware-opstelling, Afdeling 3.1 Stappe vir vinnige evaluering van sagteware, Afdeling 3.2 Hoe om die platformkonfigurasie in die ontwikkelaarpakket op te dateer en Afdeling 3.3 Hoe om die RFAL Linux-toepassingskode te bou.

Bygevoeg Afdeling 3.5 Hoe om meta-nfc5-laag in die verspreidingspakket in te sluit. Bygevoeg STM32MP157F-DK2 ontdekking kit verenigbaarheid inligting.

Dokumente / Hulpbronne

ST UM2766 X-LINUX-NFC5-pakket vir die ontwikkeling van NFC/RFID-leser [pdfGebruikershandleiding
UM2766, X-LINUX-NFC5-pakket vir die ontwikkeling van NFC-RFID-leser, die ontwikkeling van NFC-RFID-leser, NFC-RFID-leser, X-LINUX-NFC5-pakket, X-LINUX-NFC5

Verwysings

Los 'n opmerking

Jou e-posadres sal nie gepubliseer word nie. Vereiste velde is gemerk *