I-STMicroelectronics UM2375 Linux Driver User Manual

Umshayeli we-STSW-ST25R009 Linux® unika amandla i-Raspberry Pi 4 ukuthi isebenze ne-X-NUCLEO-NFC05A1, equkethe i-ST25R3911B yokusebenza okuphezulu kwedivayisi ye-NFC yendawo yonke.

Le phakheji ifaka isendlalelo se-RF abstraction (RFAL) endaweni ye-Raspberry Pi 4 Linux ukuze isebenze nge-X-NUCLEO-NFC05A1 firmware. Iphakheji inikeza njengeampuhlelo lokusebenza oluthola izinhlobo ezahlukene ze-NFC tags kanye nomakhalekhukhwini abasekela i-P2P. I-RFAL ingumshayeli ojwayelekile we-ST we-ST25R NFC/RFID Reader ICs ST25R3911B, ST25R3912, ST25R3913, ST25R3914 kanye ne-ST25R3915. Isetshenziswa, ngokwesibonelo, yi-firmware ye-ST25R3911B-DISCO (STSW-ST25R002) kanye ne-X-NUCLEONFC05A1 firmware (X-CUBE-NFC5).

I-STSW-ST25R009 isekela zonke izimiso ze-ST25R3911B ezinesendlalelo esiphansi kanye nezinye izivumelwano zongqimba eziphakeme zokuxhumana. I-RFAL ibhalwe ngendlela ephathekayo, ngakho ingasebenza kumadivayisi anhlobonhlobo asekelwe ku-Linux®. Lo mbhalo uchaza ukuthi umtapo wezincwadi we-RFAL ungasetshenziswa kanjani ohlelweni olujwayelekile lwe-Linux (kulokhu i-Raspberry Pi 4) yokuxhumana kwe-NFC/RF. Ikhodi iyaphatheka kakhulu futhi isebenza nezinguquko ezincane kunoma iyiphi ingxenyekazi ye-Linux.

Umfanekiso 1. Ilabhulali ye-RFAL kuplathifomu ye-Linux

Kuphelileview

Izici

Qedela umshayeli wesikhala somsebenzisi we-Linux (i-RF abstraction layer) ukwakha izinhlelo zokusebenza ezinikwe amandla ze-NFC kusetshenziswa i-ST25R3911B/ST25R391x ukusebenza okuphezulu okungaphambili kwe-NFC okunamandla afinyelela ku-1.4 W

Ukuxhumana komsingathi we-Linux nge-ST25R3911B/ST25R391x kusetshenziswa isixhumi esibonakalayo se-SPI
Gcwalisa i-RF/NFC abstraction (RFAL) yabo bonke ubuchwepheshe obukhulu kanye nemithetho elandelwayo yesendlalelo esiphezulu:
- I-NFC-A (ISO14443-A)
- I-NFC-B (ISO14443-B)
- I-NFC-F (FeliCa™)
- I-NFC-V (ISO15693)
- I-P2P (ISO18092)
- I-ISO-DEP (Iphrothokholi yokushintshisana kwedatha ye-ISO, ISO14443-4)
- I-NFC-DEP (NFC data exchange protocol, ISO18092)
- Ubuchwepheshe bobunikazi (Kovio, B', iClass, Calypso®, …)
Sampukuqaliswa okutholakala ngebhodi lokunweba le-X-NUCLEO-NFC05A1, elixhunywe ku-Raspberry Pi 4

Sample isicelo ukuthola i-NFC eminingana tag izinhlobo namaselula asekela i-P2P
Imigomo yelayisensi esebenziseka kalula yamahhala

I-software Architecture

Umfanekiso 2 ubonisa imininingwane ye-software yesakhiwo selabhulali ye-RFAL kuplathifomu ye-Linux®.

I-RFAL iphatheka kalula kwezinye izinkundla ngokulungisa lokho okubizwa ngokuthi inkundla files.

Unhlokweni file rfal_platform.h iqukethe izincazelo ezinkulu, ezidinga ukunikezwa futhi zisetshenziswe ngumnikazi wenkundla. Ngaphezu kwalokho, ihlinzeka ngezilungiselelo ezithize zeplathifomu njengokwabelwa kwe-GPIO, izinsiza zesistimu, izingidi nama-IRQ, adingekayo ukuze i-RFAL isebenze kahle.

Lo mboniso usebenzisa imisebenzi yesikhulumi futhi uhlinzeka ngembobo yomtapo wezincwadi we-RFAL endaweni yomsebenzisi we-Linux®. Ilabhulali eyabiwe file iyakhiqizwa, esetshenziswa uhlelo lokusebenza lwedemo ukuze kuboniswe ukusebenza okuhlinzekwa yisendlalelo se-RFAL.

Umsingathi we-Linux® usebenzisa isixhumi esibonakalayo se-sysfs esitholakala esikhaleni somsebenzisi se-Linux® ukuze unike amandla ukuxhumana kwe-SPI ngedivayisi ye-ST25R3911B. Ngaphakathi kwe-Linux® kernel isixhumi esibonakalayo se-SPI sysfs sisebenzisa i-Linux® kernel driver spidev ukuthumela/ukwamukela amafreyimu e-SPI kuya/kusuka ku-ST25R3911B.

Ukuze uphathe ulayini wokuphazamiseka we-ST25R3911B, umshayeli usebenzisa i-libgpiod ukuze aziswe ngezinguquko kulo mugqa.

Umfanekiso 2. Isakhiwo sesofthiwe ye-RFAL ku-Linux

Ukusethwa kwezingxenyekazi zekhompuyutha

Ipulatifomu esetshenzisiwe

Ibhodi le-Raspberry Pi 4 eline-Raspberry Pi OS lisetshenziswa njengeplathifomu ye-Linux ukwakha umtapo wezincwadi we-RFAL futhi uhlanganyele ne-ST25R3911B phezu kwe-SPI.
I-ST25R3911B inika amandla uhlelo lokusebenza kuplathifomu ye-Linux ukuthola nokuxhumana namadivayisi e-NFC.

Izidingo zezingxenyekazi zekhompuyutha

I-Raspberry Pi 4
8 GBytes ikhadi le-SD elincane ukuze uqalise i-Raspberry Pi OS
Isifundi sekhadi le-SD
Ibhodi lebhuloho lokuxhuma i-X-NUCLEO-NFC05A1 ne-Raspberry Pi Arduino Adapter ye-Raspberry Pi, ingxenye yenombolo ARPI600.

I-X-NUCLEO-NFC05A1. Bheka izidingo zakamuva ze-Raspberry Pi OS.

Ukuxhumeka kwehadiwe

Ibhodi ye-adaptha ye-ARPI600 Raspberry Pi kuya ku-Arduino isetshenziselwa ukuxhuma i-X-NUCLEO-NFC05A1 ne-Raspberry Pi. Kudingeka ukuguqula ama-jumpers ebhodi ye-adaptha ukuze uyixhume ne-X-NUCLEO-NFC05A1.

Isexwayiso: I-ARPI600 inikeza ngokungalungile i-5 V kuphinikhodi ye-Arduino IOREF. Ukunamathisela ngokuqondile i-X-NUCLEO-NFC05A1 ibuyisela u-5 V kwamanye amaphini, lokhu kungase kulimaze ibhodi le-Raspberry Pi. Kunemibiko ikakhulukazi yokuthi i-Raspberry Pi 4B+ iyabhujiswa ngempela. Ukuze ugweme lesi simo lungisa i-ARPI600 (ukusebenza okunzima kakhulu) noma i-X-NUCLEO-NFC05A1 (ukusebenza okulula).

Ukulungisa okulula ukusika iphinikhodi ye-CN6.2 (IOREF) ku-X-NUCLEO-NFC05A1 njengoba kuboniswe kuMfanekiso 3.

Ukusika le phini akuthinti ukusebenza ngokubambisana namabhodi e-Nucleo (NUCLEO-L474RG, NUCLEO-F401RE, NUCLEO-8S208RB, njll.).

Umfanekiso 3. Ukulungisa uxhumano lwezingxenyekazi zekhompuyutha

Isilungiselelo se-Jumper

Ama-jumpers we-A5, A4, A3, A2, A1 kanye no-A0 aboniswe kuMfanekiso 4 kufanele ashintshwe aye ku-P23, P22, P21 kanye ne-CE1. Ngalesi silungiselelo se-jumper, inombolo yephinikhodi ye-Raspberry's GPIO 7 isetshenziswa njengomugqa wokuphazamiseka we-X-NUCLEO-NFC05A1.

Umfanekiso 4. Ukuma kwama-jumper A5, A4, A3, A2, A1 no-A0 ebhodini le-adaptha.

Njengamanje, le port yelabhulali ye-RFAL isebenzisa iphinikhodi i-GPIO7 njengomugqa wokuphazamisa, ngokuya ngezilungiselelo ze-jumper. Uma kunesidingo sokushintsha umugqa wokuphazamisa usuka ku-GPIO7 uye kwenye i-GPIO ehlukile, ikhodi ethile yesikhulumi (ku file pltf_gpio.h) idinga ukushintshwa ukuze kushintshwe incazelo ye-macro “ST25R_INT_PIN” isuke kokungu-7 iye ephinikhodi entsha ye-GPIO, ukuze isetshenziswe njengomugqa wokuphazamisa.

Ngezilungiselelo ezingenhla ze-jumper, ibhodi ye-adaptha ingasetshenziswa ukuxhuma i-X-NUCLEO-NFC05A1 nebhodi le-Raspberry Pi njengoba kukhonjisiwe kuMfanekiso 5.

Umfanekiso 5. Indawo ephezulu yokusetha i-Hardware view

Umfanekiso 6. Uhlangothi lokusethwa kwezingxenyekazi zekhompuyutha view

Ukusethwa kwemvelo ye-Linux

Ukuqalwa kabusha kwe-Raspberry Pi

Ukusetha imvelo ye-Linux, isinyathelo sokuqala ukufaka nokuqalisa i-Raspberry Pi 4 nge-Raspberry Pi OS njengoba kuchazwe ngezansi:

Isinyathelo 1

Landa isithombe sakamuva se-Raspberry Pi OS kusuka kusixhumanisi:

https://www.raspberrypi.com

Khetha i-Raspberry Pi OS enedeskithophu. Ezivivinyweni ezingezansi kwasetshenziswa inguqulo elandelayo: Septhemba 2022 (2022-09-22-raspios-bullseye-armhf.img.xz).

Isinyathelo 2

Vula isithombe se-Raspberry Pi bese usibhala ekhadini le-SD ngokulandela imiyalelo etholakala esigabeni esibizwa ngokuthi “Ukubhala isithombe ekhadini le-SD”.

Isinyathelo 3

Xhuma ihadiwe:

Xhuma i-Raspberry Pi kusiqapha usebenzisa intambo ye-HDMI ejwayelekile.
Xhuma igundane nekhibhodi kumachweba we-USB we-Raspberry Pi.

Kungenzeka futhi ukusebenza ne-Raspberry Pi usebenzisa i-ssh. Uma kunjalo akudingekile ukuxhuma i-monitor, ikhibhodi negundane nge-Raspberry Pi. Okuwukuphela kwesidingo sokuba ne-PC ene-ssh ngaphakathi kwenethiwekhi efanayo ne-Raspberry Pi futhi ulungiselele ikheli le-IP ngokufanele.

Isinyathelo 4

Qalisa i-Raspberry Pi ngekhadi le-SD.

Ngemuva kokuqalisa, ideskithophu ye-Linux esekwe ku-Debian ivela kumqaphi.

Qaphela: Kwesinye isikhathi, kuyabonakala ukuthi ngemuva kokuqalisa i-Raspberry Pi, ezinye izikhiye zekhibhodi azisebenzi. Ukuze ubenze basebenze, vula ifayela file /etc/default/keyboard bese usetha i-XKBLAYOUT="us" bese uqalisa kabusha i-Raspberry Pi.

Nika amandla i-SPI ku-Raspberry Pi

Umshayeli we-SPI ongaphakathi kwe-kernel uxhumana ne-X-NUCLEO-NFC05A1 nge-SPI. Kubalulekile ukubheka ukuthi i-SPI isivele inikwe amandla yini ekucushweni kwe-Raspberry Pi OS/kernel.
Bheka ukuthi /dev/spidev0.0 iyabonakala yini endaweni ye-Raspberry Pi. Uma ingabonakali, nika amandla isixhumi esibonakalayo se-SPI usebenzisa insiza ethi “raspi-config” ngokulandela izinyathelo ezichazwe ngezansi.

Isinyathelo 1

Vula i-terminal entsha ku-Raspberry Pi bese usebenzisa umyalo othi “raspi-config” njengempande:

sudo raspi-config

Lesi sinyathelo sivula i-graphical interface.

Isinyathelo 2

Khetha kusixhumi esibonakalayo esibonakalayo inketho ebizwa ngokuthi "Izinketho Zokuhlanganisa".

Isinyathelo 3

Lesi sinyathelo sibonisa izinketho ezihlukahlukene.
Khetha inketho ebizwa ngokuthi "SPI".
Kuvela iwindi elisha elinombhalo olandelayo:
"Ungathanda ukuthi isixhumi esibonakalayo se-SPI sivulwe?"

Isinyathelo 4

Khetha kuleli windi ukuze unike amandla i-SPI.

Isinyathelo 5

Qalisa kabusha i-Raspberry Pi.
Izinyathelo ezingenhla zizonika amandla isikhombimsebenzisi se-SPI endaweni ye-Raspberry Pi ngemuva kokuqalisa kabusha.

Yakha umtapo wezincwadi we-RFAL kanye nohlelo lokusebenza

Idemo ye-RFAL ye-Linux inikezwa kungobo yomlando. Ake sicabange ukuthi igama layo lithi:
ST25R3911B_v2.8.0_Linux_demo_v1.0.tar.xz.
Ukwakha umtapo wezincwadi we-RFAL nokusebenzisa ku-Raspberry Pi, landela lezi zinyathelo ezingezansi:

Isinyathelo 1

Vula iphakheji ku-Raspberry Pi usebenzisa umyalo ongezansi kusuka kumkhombandlela wasekhaya:

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

Isinyathelo 2

Uma kungenziwanga ngaphambili, faka i-cmake, usebenzisa umyalo ongezansi:

i-apt-get ukufaka i-cmake

Umtapo wezincwadi we-RFAL nohlelo lokwakha uhlelo lokusebenza lusekelwe ku-cmake, ngenxa yalesi sizathu kuyadingeka ukuthi kufakwe i-cmake ukuze kuhlanganiswe iphakheji.

Isinyathelo 3

Ukuze wakhe umtapo wezincwadi we-RFAL kanye nohlelo lokusebenza, yiya kuhla lwemibhalo elithi “build”:

cd ST25R3911B_v2.8.0_Linux_demo_v1.0/Linux_demo/build

bese usebenzisa umyalo ongezansi ukusuka lapho:

cmka..

Emyalweni ongenhla othi “..” ikhombisa ukuthi i-CMakeLists.txt yezinga eliphezulu ikhona kuhla lwemibhalo elingumzali, okungukuthi
ST25R3911B_v2.8.0_Linux_demo_v1.0.

Umyalo we-cmmake udala i-makefile esetshenziswa esinyathelweni esilandelayo ukwakha umtapo wolwazi kanye nohlelo lokusebenza.

Isinyathelo 4

Qalisa umyalo othi "yenza" ukuze wakhe umtapo wezincwadi we-RFAL kanye nohlelo lokusebenza:

yenza

Umyalo othi “yenza” kuqala wakhe umtapo wezincwadi we-RFAL bese wakhe uhlelo lokusebenza phezu kwawo.

Ulusebenzisa kanjani uhlelo

Ukwakhiwa okuphumelelayo kukhiqiza okusebenzisekayo okuqanjwe ngokuthi “nfc_demo_st25r3911b” endaweni elandelayo:
/yakha/izinhlelo zokusebenza.

Ngokuzenzakalelayo uhlelo lokusebenza ludinga ukuqhutshwa ngamalungelo empande asendleleni: ST25R3911B_v2.8.0_Linux_demo_v1.0/linux_demo/build:

sudo ./demo/nfc_demo_st25r3911b

Isicelo siqala ukuvotela i-NFC tags nomakhalekhukhwini. Ibonisa amadivayisi atholakele ane-UID yawo njengoba kukhonjisiwe kuMfanekiso 7.

Umfanekiso 7. Ukuboniswa kwemishini etholiwe

Ukumisa uhlelo cindezela u-Ctrl + C.

Umlando wokubuyekeza

Ithebula 1. Umlando wokubuyekeza idokhumenti

Uhlu lwamathebula

Ithebula 1. Umlando wokubuyekeza idokhumenti . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Uhlu lwezibalo

Umfanekiso 1. Ilabhulali ye-RFAL kuplathifomu ye-Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Umfanekiso 2. Isakhiwo sesofthiwe ye-RFAL ku-Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Umfanekiso 3. Ukulungisa uxhumano lwezingxenyekazi zekhompuyutha. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Umfanekiso 4. Ukuma kwama-jumpers A5, A4, A3, A2, A1 no-A0 ebhodini le-adaptha. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Umfanekiso 5. Indawo ephezulu yokusetha i-Hardware view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Umfanekiso 6. Uhlangothi lokusethwa kwezingxenyekazi zekhompuyutha view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Umfanekiso 7. Ukuboniswa kwemishini etholiwe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

ISAZISO ESIBALULEKILE – FUNDA NGOKUQAPHELA

I-STMicroelectronics NV nezinkampani ezingaphansi kwayo (“ST”) igodla ilungelo lokwenza izinguquko, ukulungisa, izithuthukisi, ukuguqulwa, nokuthuthukiswa kwemikhiqizo ye-ST kanye/noma kulo mbhalo nganoma yisiphi isikhathi ngaphandle kwesaziso. Abathengi kufanele bathole ulwazi lwakamuva olufanele ngemikhiqizo ye-ST ngaphambi kokufaka ama-oda. Imikhiqizo ye-ST ithengiswa ngokulandela imigomo nemibandela ye-ST yokuthengisa ekhona ngesikhathi sokuvunywa kwe-oda.

Abathengi banomthwalo wemfanelo kuphela ekukhetheni, ekukhethweni, nasekusetshenzisweni kwemikhiqizo ye-ST futhi i-ST ayithathi sikweletu sosizo lwesicelo noma idizayini yemikhiqizo yabathengi.

Ayikho ilayisensi, eshiwo noma eshiwoyo, kunoma yiliphi ilungelo lempahla yengqondo elinikezwa i-ST lapha.

Ukudayiswa kabusha kwemikhiqizo ye-ST nezinhlinzeko ezihlukile kulwazi olubekwe lapha kuzovala noma yisiphi isiqinisekiso esinikezwe i-ST salowo mkhiqizo.

Ilogo ye-ST kanye ne-ST yizimpawu zokuthengisa ze-ST. Ukuze uthole ulwazi olwengeziwe mayelana nezimpawu zokuthengisa ze-ST, bheka ku www.st.com/trademarks. Wonke amanye amagama omkhiqizo noma wesevisi ayimpahla yabanikazi abafanele.

Ulwazi olukule dokhumenti luthatha indawo futhi luthatha indawo yolwazi olwalunikezwe ngaphambilini kunoma yiziphi izinguqulo zangaphambili zalo mbhalo.

Amadokhumenti / Izinsiza

I-STMicroelectronics UM2375 Linux Driver [pdf] Imaniwali yosebenzisayo
UM2375 Linux Driver, UM2375, Linux Driver, Driver

Izithenjwa

Imaniwali yosebenzisayo