STMicroelectronics UM2375 Linux Driver User Manual

Iyo STSW-ST25R009 Linux® mutyairi inogonesa Raspberry Pi 4 kushanda neX-NUCLEO-NFC05A1, iyo ine ST25R3911B yakakwira performance NFC universal mudziyo.

Iyi pasuru inotakura iyo RF abstraction layer (RFAL) paRaspberry Pi 4 Linux chikuva chekushanda neX-NUCLEO-NFC05A1 firmware. Iyo package inopa seample application inoona mhando dzakasiyana dzeNFC tags uye nharembozha dzinotsigira P2P. Iyo RFAL ndiyo ST yakajairwa mutyairi we ST25R NFC/RFID Reader ICs ST25R3911B, ST25R3912, ST25R3913, ST25R3914 uye ST25R3915. Inoshandiswa, semuenzaniso, neiyo ST25R3911B-DISCO firmware (STSW-ST25R002) uye neX-NUCLEONFC05A1 firmware (X-CUBE-NFC5).

STSW-ST25R009 inotsigira ese ST25R3911B yakaderera-layer maprotocol uye zvakare mamwe epamusoro layer maprotocol ekutaurirana. Iyo RFAL yakanyorwa nenzira inotakurika, saka inogona kumhanya pane dzakasiyana siyana dzemidziyo yakavakirwa paLinux®. Gwaro iri rinotsanangura kuti raibhurari yeRFAL inogona kushandiswa sei pane yakajairwa Linux system (munyaya iyi Raspberry Pi 4) yeNFC/RF kutaurirana. Iyo kodhi inotakurika zvakanyanya uye inoshanda nediki shanduko pane chero Linux chikuva.

Mufananidzo 1. RFAL raibhurari paLinux papuratifomu

Overview

Features

Zadzisa Linux mushandisi nzvimbo mutyairi (RF abstraction layer) kuvaka NFC inogonesa maapplication uchishandisa iyo ST25R3911B/ST25R391x yakakwirira performance NFC kumberi inosvika 1.4 W inobuda simba.
Linux host kutaurirana neiyo ST25R3911B/ST25R391x uchishandisa SPI interface
Zadzisa RF/NFC abstraction (RFAL) kune ese makuru matekinoroji uye yakakwirira layer mapuroteni:
- NFC-A (ISO14443-A)
- NFC-B (ISO14443-B)
- NFC-F (FeliCa™)
- NFC-V (ISO15693)
- P2P (ISO18092)
- ISO-DEP (ISO data exchange protocol, ISO14443-4)
- NFC-DEP (NFC data exchange protocol, ISO18092)
- Proprietary tekinoroji (Kovio, B', iClass, Calypso®, ...)
Sample kusevenzeswa kunowanikwa neiyo X-NUCLEO-NFC05A1 yekuwedzera bhodhi, yakabatanidzwa muRaspberry Pi 4.
Sample application yekuona akati wandei NFC tag mhando uye nharembozha dzinotsigira P2P
Marezinesi emahara emushandisi ane hushamwari

Software architecture

Mufananidzo 2 unoratidza iyo software yedhizaini yeRFAL raibhurari paLinux® papuratifomu.

Iyo RFAL inotakurika nyore kune mamwe mapuratifomu nekugadzirisa iyo inonzi chikuva files.

Musoro file rfal_platform.h ine macro dudziro, ayo anoda kupihwa nekuitwa nemuridzi wepuratifomu. Uyezve, inopa zvigadziriso zvepuratifomu senge GPIO kugoverwa, zviwanikwa zvehurongwa, makiyi uye maIRQ, ayo anodiwa pakushanda chaiko kweRFAL.

Ichi chiratidziro chinoita mabasa epuratifomu uye inopa chiteshi cheRFAL raibhurari munzvimbo yemushandisi yeLinux®. Raibhurari yakagoverwa file inogadzirwa, iyo inoshandiswa nedemo application kuratidza mashandiro anopihwa neRFAL layer.

Linux® host inoshandisa sysfs interface inowanikwa kubva kuLinux® mushandisi nzvimbo kugonesa SPI kutaurirana neiyo ST25R3911B mudziyo. Mukati meLinux® kernel iyo SPI sysfs interface inoshandisa Linux® kernel driver spidev kutumira/kugamuchira SPI mafuremu kuenda/kubva ST25R3911B.

Pakubata mutsara wekukanganisa we ST25R3911B, mutyairi anoshandisa libgpiod kuti aziviswe nezve shanduko pamutsetse uyu.

Mufananidzo 2. RFAL software architecture paLinux

Hardware setup

Platform yakashandiswa

Raspberry Pi 4 bhodhi ine Raspberry Pi OS inoshandiswa seLinux chikuva kuvaka raibhurari yeRFAL uye kupindirana neST25R3911B pamusoro peSPI.
ST25R3911B inogonesa application paLinux papuratifomu kuona uye kutaurirana neNFC zvishandiso.

Hardware zvinodiwa

Raspberry Pi 4
8 GBytes micro SD kadhi kubhutsu Raspberry Pi OS
SD kadhi kuverenga
Bhiriji bhodhi rekubatanidza X-NUCLEO-NFC05A1 neRaspberry Pi Arduino Adapter yeRaspberry Pi, chikamu nhamba ARPI600.
X-NUCLEO-NFC05A1. Tarisa kune zvazvino Raspberry Pi OS zvinodiwa.

Hardware kubatana

Iyo ARPI600 Raspberry Pi kune Arduino adapta bhodhi inoshandiswa kubatanidza iyo X-NUCLEO-NFC05A1 neRaspberry Pi. Inodiwa kugadzirisa majumper eadapter board kuti aibatanidze neX-NUCLEO-NFC05A1.

Yambiro: Iyo ARPI600 inopa zvisizvo 5 V kuArduino IOREF pini. Yakananga kubatanidza iyo X-NUCLEO-NFC05A1 inodzosera kumashure 5 V pane mamwe mapini, izvi zvinogona kukuvadza Raspberry Pi bhodhi. Pane mishumo kunyanya yeRaspberry Pi 4B + iri kuparadzwa. Kuti udzivise mamiriro ezvinhu aya shandura ingave iyo ARPI600 (kushanda kwakaoma) kana X-NUCLEO-NFC05A1 (kushanda kuri nyore).

Iyo iri nyore kugadzirisa ndeyekucheka CN6.2 (IOREF) pini paX-NUCLEO-NFC05A1 sezvakaratidzwa mumufananidzo 3.

Kucheka pini iyi hakukanganisi kushanda pamwe chete neNucleo boards (NUCLEO-L474RG, NUCLEO-F401RE, NUCLEO-8S208RB, nezvimwewo).

Mufananidzo 3. Hardware connection kugadzirisa

Jumper setting

Majuru eA5, A4, A3, A2, A1 uye A0 anoratidzwa muMufananidzo 4 anofanira kuchinjwa kuita P23, P22, P21 uye CE1. Nekuseta uku kwejumper, Raspberry's GPIO pini nhamba 7 inoshandiswa sekukanganisa mutsara weX-NUCLEO-NFC05A1.

Mufananidzo 4. Nzvimbo yevanosvetuka A5, A4, A3, A2, A1 uye A0 pane adapta board.

Parizvino, iyi RFAL raibhurari chiteshi inoshandisa pini GPIO7 semutsetse wekukanganisa, zvinoenderana nejumper marongero. Kana paine chinodiwa chekushandura mutsara wekukanganisa kubva kuGPIO7 kuenda kune imwe GPIO, iyo kodhi yepuratifomu (mu file plf_gpio.h) inoda kugadziridzwa kuti ichinje tsananguro ye macro "ST25R_INT_PIN" kubva pa7 kuenda kune itsva GPIO pini, kuti ishandiswe semutsetse wekukanganisa.

Nezvirongwa zvejumper zviri pamusoro, iyo adapta bhodhi inogona kushandiswa kubatanidza X-NUCLEO-NFC05A1 neRaspberry Pi bhodhi sezvakaratidzwa mumufananidzo 5.

Mufananidzo 5. Hardware setup top view

Mufananidzo 6. Hardware setup side view

Linux environment setup

Kutanga kweRaspberry Pi

Kumisikidza nharaunda yeLinux, danho rekutanga kuisa uye bhutsu iyo Raspberry Pi 4 ine Raspberry Pi OS sezvakatsanangurwa pazasi:

Danho 1

Dhawunirodha yazvino Raspberry Pi OS mufananidzo kubva pane iyi link:

https://www.raspberrypi.com

Sarudza Raspberry Pi OS ine desktop. Kune bvunzo dziri pazasi iyi inotevera vhezheni yakashandiswa: Gunyana 2022 (2022-09-22-raspios-bullseye-armhf.img.xz).

Danho 2

Unzip iyo Raspberry Pi mufananidzo uye unyore muSD kadhi nekutevera mirairo inowanikwa muchikamu chinonzi "Kunyora mufananidzo kune SD kadhi".

Danho 3

Batanidza hardware:

Batanidza iyo Raspberry Pi kune yekutarisa uchishandisa yakajairwa HDMI tambo.
Batanidza mbeva uye keyboard kune Raspberry Pi's USB ports.

Izvo zvakare zvinogoneka kushanda neRaspberry Pi uchishandisa ssh. Muchiitiko ichocho hazvidiwi kubatanidza iyo yekutarisa, keyboard uye mbeva neRaspberry Pi. Chinongodiwa chete kuve nePC ine ssh mukati meiyo network seRaspberry Pi uye gadzirisa iyo IP kero zvinoenderana.

Danho 4

Boot iyo Raspberry Pi ine SD kadhi.

Mushure mekubhomba, Debian yakavakirwa Linux desktop inoonekwa pane yekutarisa.

Ongorora: Dzimwe nguva, zvinoonekwa kuti mushure mekubhowa Raspberry Pi, mamwe makiyi ekhibhodi haashande. Kuti vashande, vhura iyo file /etc/default/keyboard uye isa XKBLAYOUT=”isu” uye tangazve Raspberry Pi.

Gonesa SPI paRaspberry Pi

Mutyairi weSPI ari mukati mekernel anotaurirana neX-NUCLEO-NFC05A1 kuburikidza neSPI. Izvo zvakakosha kutarisa kana SPI yatogoneswa muRaspberry Pi OS/kernel kumisikidza.
Tarisa kana /dev/spidev0.0 inoonekwa munzvimbo yeRaspberry Pi. Kana isingaonekwe, gonesa iyo SPI interface uchishandisa utility "raspi-config" nekutevera matanho anotsanangurwa pazasi.

Danho 1

Vhura terminal nyowani paRaspberry Pi uye mhanyisa rairo "raspi-config" semudzi:

sudo raspi-config

Iyi nhanho inovhura graphical interface.

Danho 2

Sarudza mune graphical interface sarudzo inonzi "Interfacing Options".

Danho 3

Danho iri rinonyora sarudzo dzakasiyana.
Sarudza sarudzo inonzi "SPI".
Hwindo idzva rinobuda riine mavara anotevera:
"Ungade here kuti SPI interface igoneswe?"

Danho 4

Sarudza muhwindo rino kugonesa SPI.

Danho 5

Reboot Raspberry Pi.
Matanho ari pamusoro achagonesa iyo SPI interface muRaspberry Pi nharaunda mushure mekutangazve.

Kuvaka kweRFAL raibhurari uye kushandisa

Iyo RFAL demo yeLinux inopihwa mudura. Ngatifungei kuti zita rayo nderokuti:
ST25R3911B_v2.8.0_Linux_demo_v1.0.tar.xz.
Kuvaka raibhurari yeRFAL uye kushandisa paRaspberry Pi, tevera matanho ari pasi apa:

Danho 1

Unzip pasuru paRaspberry Pi uchishandisa iri pazasi rairo kubva kudhairekitori repamba:

tar -xJvf ST25R3911B_v2.8.0_Linux_demo_v1.0.tar.xz

Danho 2

Kana zvisati zvaitwa, isa cmake, uchishandisa pazasi kuraira:

apt-tora kuisa cmake

RFAL raibhurari uye application kuvaka sisitimu yakavakirwa pacmake, nekuda kweichi chikonzero chinodiwa kuisa cmake yekubatanidzwa kwepakeji.

Danho 3

Kuvaka raibhurari yeRFAL uye kushandisa, enda kune "kuvaka" dhairekitori:

cd ST25R3911B_v2.8.0_Linux_demo_v1.0/Linux_demo/build

uye mhanya unotevera kuraira kubva ipapo:

cmke..

Murairo riri pamusoro ".." rinoratidza kuti CMakeLists.txt iripo mudhairekitori revabereki, kureva kuti
ST25R3911B_v2.8.0_Linux_demo_v1.0.

Iyo cmmake command inogadzira makefile iyo inoshandiswa munhanho inotevera kuvaka raibhurari uye kushandisa.

Danho 4

Mhanya iyo "ita" kuraira kuvaka iyo RFAL raibhurari uye kushandisa:

make

Murairo we "ita" tanga wavaka raibhurari yeRFAL uye wobva wavaka chishandiso pamusoro payo.

Maitiro ekumhanyisa application

Kubudirira kuvaka-up kunogadzira chinoitwa chinonzi "nfc_demo_st25r3911b" panzvimbo inotevera:
/kuvaka/applications.

By default application inoda kumhanyiswa nemidzi kodzero kubva munzira: ST25R3911B_v2.8.0_Linux_demo_v1.0/linux_demo/build:

sudo ./demo/nfc_demo_st25r3911b

Chikumbiro chinotanga kuvhotera NFC tags uye nharembozha. Inoratidza zvishandiso zvakawanikwa neUID yavo sezvakaratidzwa mumufananidzo 7.

Mufananidzo 7. Kuratidzwa kwezvinhu zvakawanikwa

Kumisa application tinya Ctrl + C.

Nhoroondo yekudzokorora

Tafura 1. Document revision history

Rondedzero yematafura

Tafura 1. Document revision history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Rondedzero yenhamba

Mufananidzo 1. RFAL raibhurari paLinux platform. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Mufananidzo 2. RFAL software architecture paLinux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Mufananidzo 3. Hardware connection kugadzirisa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Mufananidzo 4. Nzvimbo yevanosvetuka A5, A4, A3, A2, A1 uye A0 pane adapter board. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Mufananidzo 5. Hardware setup top view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Mufananidzo 6. Hardware setup side view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Mufananidzo 7. Kuratidzwa kwezvigadzirwa zvakawanikwa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

CHIZIVISO CHINOKOSHA – VERENGA ZVAKANAKA

STMicroelectronics NV nevatsigiri vayo (“ST”) vanochengeta kodzero yekuita shanduko, kugadzirisa, kuvandudza, gadziridzo, uye kuvandudza kune ST zvigadzirwa uye/kana kugwaro iri chero nguva pasina chiziviso. Vatengi vanofanirwa kuwana ruzivo rwazvino rwakakodzera pane zvigadzirwa zveST vasati vaisa maodha. Zvigadzirwa zveST zvinotengeswa zvichiteerana ne ST zvirevo uye mamiriro ekutengesa aripo panguva yekuodha kubvuma.

Vatengi ndivo vane basa rekusarudza, kusarudza, uye kushandiswa kweST zvigadzirwa uye ST haitore mhosva yerubatsiro rwekushandisa kana dhizaini yezvigadzirwa zvevatengi.

Hapana rezinesi, kutaura kana kurehwa, kune chero kodzero yepfuma inopihwa neST muno.

Kutengeswazve kwezvigadzirwa zveST zvine zvipimo zvakasiyana neruzivo rwataurwa pano kuchabvisa chero waranti yakapihwa neST yechigadzirwa chakadaro.

ST uye ST logo zviratidzo zve ST. Kuti uwane rumwe ruzivo nezve ST trademark, tarisa kune www.st.com/trademarks. Zvese zvimwe zvigadzirwa kana sevhisi mazita midziyo yevaridzi vazvo.

Ruzivo rwuri mugwaro rino rinotsiva uye kutsiva ruzivo rwakambopihwa mune chero shanduro dzekare dzegwaro iri.

Zvinyorwa / Zvishandiso

STMicroelectronics UM2375 Linux Driver [pdf] User Manual
UM2375 Linux Driver, UM2375, Linux Driver, Driver

References

User Manual