UM2548 Linux Driver
I-Linux® umshayeli we-ST25R3916/ST25R3916B
Imaniwali yosebenzisayo
UM2548 Linux Driver
Isingeniso
I-STSW-ST25R013 Umshayeli we-Linux® uvumela i-Raspberry Pi® 4 ukuthi isebenze namabhodi e-X-NUCLEO-NFCO6A1 kanye ne-X-NUCLEO-NFCO8A1, aqukethe, ngokulandelana, amadivayisi we-ST25R3916 kanye ne-ST25R3916B.
Le phakheji ifaka ungqimba lwe-RF abstraction (RFAL) endaweni yesikhulumi se-Raspberry Pi 4 Linux, ukuze isebenze ne-firmware yebhodi, futhi inikeza njengeampuhlelo lokusebenza oluthola izinhlobo ezahlukene ze-NFC tags kanye nomakhalekhukhwini abasekela i-P2P. I-RFAL ingumshayeli ojwayelekile we-ST we-ST25R3916 kanye ne-ST25R3916B, ukusebenza okuphezulu kwamadivayisi we-NFC jikelele / abafundi be-EMVCo. Isetshenziswa, ngokwesibonelo, yi-firmware ye-ST25R3916-DISCO (STSW-ST25R010) kanye ne-firmware ye-X-NUCLEO-NFCO06A1 (X-CUBE-NFC6).
I-STSW-ST25R013 isekela zonke i-ST25R3916/ST25R3916B isendlalelo esiphansi kanye namanye amaphrothokholi esendlalelo aphezulu okuxhumana. 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.
Kuphelileview
1.1 Izici
- Qedela umshayeli wesikhala somsebenzisi we-Linux (i-RF abstraction layer) ukuze wakhe izinhlelo zokusebenza ezinikwe amandla ze-NFC usebenzisa i-ST25R3916 kanye namadivayisi we-ST25R3916B
- Ukuxhumana kosokhaya we-Linux nge-ST25R3916/ST25R3916B kusetshenziswa isixhumi esibonakalayo se-SPI
- Gcwalisa i-RF/NFC abstraction (RFAL) yabo bonke ubuchwepheshe obukhulu kanye nemithetho elandelwayo yesendlalelo esiphezulu:
– NFC-A (ISO14443-A)
– NFC-B (ISO14443-B)
– NFC-F (FeliCa™)
– NFC-V (ISO15693)
– P2P (ISO18092)
- ISO-DEP (ISO 14443-4)
- NFC-DEP (NFC data exchange protocol, ISO18092)
- Ubuchwepheshe bobunikazi, njengeKovio, B', iClass, Calypso® - Sampukuqaliswa okutholakala ngamabhodi okunweba we-X-NUCLEO-NFC06A1 kanye ne-X-NUCLEO-NFC08A1, axhunywe ku-Raspberry Pi 4
- Sample isicelo ukuthola i-NFC eminingana tag izinhlobo namaselula asekela i-P2P
- Imigomo yelayisensi esebenziseka kalula yamahhala
1.2 Isakhiwo sesoftware
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 I-rfal_platform.h iqukethe izincazelo ezinkulu, okufanele zinikezwe futhi zisetshenziswe umnikazi wenkundla.
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 ye-RFAL endaweni yomsebenzisi we-Linux.
Ilabhulali eyabiwe file iyakhiqizwa, esetshenziswa uhlelo lokusebenza olukhombisayo ukukhombisa ukusebenza okuhlinzekwa yisendlalelo se-RFAL.
Umsingathi we-Linux usebenzisa isixhumi esibonakalayo se-sysfs esitholakala esikhaleni somsebenzisi we-Linux ukwenza ukuxhumana kwe-SPI namadivayisi. Ngaphakathi kwe-Linux kernel isixhumi esibonakalayo se-SPI sysfs sisebenzisa i-Linux kernel driver spidev ukuthumela/ukwamukela ozimele be-SPI ukuya/kusuka kumadivayisi.
Ngokuphatha ulayini we-INT wamadivayisi we-ST25R3916 kanye ne-ST25R3916B, umshayeli usebenzisa ama-sysfs e-libpiod ukuze aziswe ngezinguquko kulo mugqa.
Ukusethwa kwezingxenyekazi zekhompuyutha
2.1 Inkundla esetshenzisiwe
Ibhodi le-Raspberry Pi 4 eline-Raspberry Pi OS lisetshenziswa njengeplathifomu ye-Linux ukwakha umtapo wezincwadi we-RFAL futhi uhlanganyele ne-ST25R3916/ST25R3916B phezu kwe-SPI.
Amadivayisi anika amandla uhlelo lokusebenza kuplathifomu ye-Linux ukuthola nokuxhumana namadivayisi e-NFC.
2.2 Izidingo zezingxenyekazi zekhompuyutha
- I-Raspberry Pi 4
- Ikhadi le-SD elingu-8 GB lokuqalisa i-Raspberry Pi OS (nezidingo zayo zakamuva)
- Isifundi sekhadi le-SD
- X-NUCLEO-NFC06A1 noma X-NUCLEO-NFC08A1 amabhodi
- Ibhuloho lokuxhuma ibhodi nge-adaptha ye-Raspberry Pi Arduino™ ye-Raspberry Pi (ingxenye yenombolo ARPI600)
2.2.1 Ukuxhumana kwezingxenyekazi zekhompyutha
I-adaptha ye-ARPI600 Raspberry Pi to Arduino isetshenziswa ukuxhuma amabhodi ne-Raspberry Pi. Ama-jumper ebhodi le-adaptha kufanele ashintshwe ukuze ayixhume namabhodi we-X-NUCLEO-NFC06A1 noma i-X-NUCLEO-NFC08A1.
Isexwayiso:
I-ARPI600 inikeza ngokungalungile i-5 V kuphinikhodi ye-Arduino IOREF. Ukunamathisela amabhodi ngokuqondile kubuyisela i-5 V kwezinye izikhonkwane, lokhu kungalimaza ibhodi le-Raspberry Pi. Kunemibiko yamabhodi acekeleke phansi (ikakhulukazi i-Raspberry Pi 4B+).
Ukuze ugweme lokhu, lungisa i-ARPI600 (ukusebenza okunzima kakhulu), noma ibhodi le-X-NUCLEO-NFC06A1/X-NUCLEONFC08A1 (kalula).
Ukulungisa okulula ukusika iphinikhodi ye-CN6.2 (IOREF) kumabhodi we-X-NUCLEO-NFC06A1/X-NUCLEO-NFC08A1, njengoba kuboniswe kuMfanekiso 3.
Ukusika le phini akuthinti ukusebenza ngokubambisana namabhodi e-Nucleo (afana ne-NUCLEO-L474RG, NUCLEO-F401RE, NUCLEO-8S208RB).
Isilungiselelo se-Jumper
Ama-jumpers we-A5, A4, A3, A2, A1 kanye no-A0 aboniswe kuMfanekiso 4 kufanele ashintshwe, ngokulandelana, aye ku-P25, P24, P23, P22, P21 kanye ne-CE1. Ngalesi silungiselelo inombolo 7 yephinikhodi ye-Raspberry's GPIO isetshenziswa njengomugqa wokuphazamiseka we-X-NUCLEONFC06A1/X-NUCLEO-NFC08A1.
Njengamanje, le mbobo 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) kufanele ilungiswe ukuze kushintshwe incazelo ye-macro ST25R_INT_PIN isuke ku-7 iye ku-GPIO pin entsha, ukuze isetshenziswe njengomugqa wokuphazamisa.
Ngezilungiselelo ezingenhla ze-jumper, ibhodi ye-adaptha ingasetshenziswa ukuxhuma i-X-NUCLEO NFC06A1 ne-X-NUCLEO-NFC08A1 ngebhodi le-Raspberry Pi, njengoba kuboniswe kwizibalo ezilandelayo.
Ukusethwa kwemvelo ye-Linux
3.1 Ukuqalisa kabusha i-Raspberry Pi
Ukusetha indawo ye-Linux, qala ufake futhi uqalise i-Raspberry Pi nge-Raspberry Pi OS, njengoba kuchazwe ngezansi:
Isinyathelo 1
Landa isithombe sakamuva se-Raspberry Pi OS kusuka https://www.raspberrypi.com, bese ukhetha i-Raspberry Pi OS enedeskithophu. Ukuhlola okungezansi kwenguqulo 2022-09-22-raspios-bullseye-armhf.img.xz (September 2022) isetshenzisiwe.
Isinyathelo 2
Vula isithombe se-Raspberry Pi OS bese usibhala ekhadini le-SD ngokulandela imiyalelo etholakala esigabeni esibizwa ngokuthi “Ukubhala isithombe ekhadini le-SD”.
Isinyathelo 3
Xhuma ihadiwe:
- Xhuma i-Raspberry Pi 4 kusiqapha usebenzisa intambo ye-HDMI ejwayelekile.
- Xhuma igundane nekhibhodi kumachweba we-USB we-Raspberry Pi.
Kungenzeka futhi ukusebenza ne-Raspberry Pi usebenzisa i-ssh. Esimweni esinjalo. akudingekile ukuxhuma i-monitor, ikhibhodi kanye negundane nge-Raspberry Pi. Okuwukuphela kwemfuneko ukuba ne-PC ene-ssh ngaphakathi kwenethiwekhi efanayo ne-Raspberry Pi, futhi ulungiselele ikheli le-IP ngokufanele.
Isinyathelo 4
Qalisa i-Raspberry Pi 4 ngekhadi le-SD. Ngemuva kokuqalisa, ideskithophu ye-Linux esekwe ku-Debian ivela kumqaphi.
Qaphela:
Kwesinye isikhathi, ngemuva kokuqalisa i-Raspberry Pi OS, ezinye izikhiye zekhibhodi azisebenzi. Ukuze ubenze basebenze, vula ifayela file /etc/default/keyboard bese usetha i-XKBLAYOUT="us", bese uqalisa kabusha i-Raspberry Pi.
3.2 Nika amandla i-SPI ku-Raspberry Pi
Umshayeli we-SPI ongaphakathi kwe-kernel uxhumana namabhodi we-X-NUCLEO-NFC06A1/X-NUCLEO-NFC08A1 nge-SPI. Kubalulekile ukubheka ukuthi i-SPI isivele inikwe amandla yini ekucushweni kwe-kernel ye-Raspbian Pi OS.
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 nesicelo
Ukuboniswa kwe-RFAL kwe-Linux kunikezwa kungobo yomlando, njenge-ST25R3916_v2.8.0_Linux_demo_v1.0.tar.xz.
Ukwakha umtapo wezincwadi we-RFAL nohlelo lokusebenza ku-Raspberry Pi, dlula lezi zinyathelo ezilandelayo:
Isinyathelo 1
Vula iphakheji ku-Raspberry Pi usebenzisa umyalo olandelayo ovela kumkhombandlela wasekhaya
i-tar -xJvf ST25R3916_v2.8.0_Linux_demo_v1.0.tar.xz
Isinyathelo 2
Faka i-cmake (uma ingenziwanga ngaphambili) usebenzisa umyalo
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, hamba kumkhombandlela wokwakha
cd ST25R3916_v2.8.0_Linux_demo_v1.0/linux_demo/build
Ukusuka lapho, sebenzisa umyalo
cmka..
Emyalweni ongenhla othi “..” kubonisa ukuthi izinga eliphezulu le-CMakeLists.txt likhona kuhla lwemibhalo elingumzali
(ST25R3916_v2.8.0_Linux_demo_v1.0).
Lo myalo udala i-makefile isetshenziswe esinyathelweni esilandelayo ukwakha umtapo wolwazi kanye nohlelo lokusebenza. Ukusuka lapho, sebenzisa umyalo olandelayo ukuze wakhe ukuboniswa kwe-ST25R3916B
i-cmake -DRFAL_VARIANT=st25r3916b..
Isinyathelo 4
Qalisa ukwenza umyalo wokwakha umtapo wezincwadi we-RFAL kanye nohlelo lokusebenza:
yenza
Lo myalo wakha kuqala umtapo wezincwadi we-RFAL, bese kuba uhlelo lokusebenza phezu kwawo.
Ulusebenzisa kanjani uhlelo
Ukwakhiwa okuyimpumelelo kukhiqiza okusebenzisekayo okuqanjwe ngokuthi “nfc_poller_st25r3916” noma “nfc_poller_st25r3916b” endaweni /build/demo.
Ngokuzenzakalelayo, uhlelo lokusebenza ludinga ukuqhutshwa ngamalungelo empande asendleleni ST25R3916_v2.8.0_Linux_demo_v1.0/linux_demo/build/demo/:
sudo ./nfc_demo_st25r3916
Isicelo siqala ukuvotela i-NFC tags kanye nomakhalekhukhwini, bese bebonisa amadivayisi atholakele ane-UID yawo, njengoba kukhonjisiwe kuMfanekiso 7.
Ukumisa uhlelo cindezela u-Ctrl + C.
Umlando wokubuyekeza
Ithebula 1. Umlando wokubuyekeza idokhumenti
| Usuku | Buyekeza | Izinguquko |
| 1-Mar-19 | 1 | Ukukhishwa kokuqala. |
| 4-Ephreli-23 | 2 | Isihloko sombhalo esibuyekeziwe, Isingeniso Sesigaba, Izici zeSigaba 1.1, Isigaba 1.2 Ukwakhiwa kweSoftware, Ingxenye 2.1 Ingxenyekazi esetshenzisiwe, Ingxenye 2.2 Hardware izidingo, Isigaba 2.2.1 Uxhumo lwezingxenyekazi zekhompuyutha, Isigaba 3.1 Ukuqalisa i-Raspberry Pi, Isigaba 3.2 Nika amandla i-SPI ku-Raspberry Pi, Isigaba 4 Yakha umtapo wezincwadi we-RFAL kanye nesicelo, kanye neSigaba 5 Indlela yokuqhuba isicelo. Umfanekiso Obuyekeziwe 1. Umtapo wezincwadi we-RFAL kuplathifomu ye-Linux, Umfanekiso 2. Isakhiwo sesofthiwe ye-RFAL ku-Linux, naku-Figure 5. Indawo ephezulu yokusetha i-Hardware view. Ukuhlelwa kombhalo omncane kuyo yonke idokhumenti. |
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.
© 2023 STMicroelectronics – Wonke amalungelo agodliwe
UM2548 - Rev 2
Amadokhumenti / Izinsiza
 |
I-STMicroelectronics UM2548 Linux Driver [pdf] Imaniwali yosebenzisayo UM2548 Linux Driver, UM2548, Linux Driver, Driver |
