STMicroelectronics UM2375 Linux Driver User Manual

Ny mpamily STSW-ST25R009 Linux® dia ahafahan'ny Raspberry Pi 4 miasa miaraka amin'ny X-NUCLEO-NFC05A1, izay misy ny ST25R3911B fitaovana manerantany NFC avo lenta.

Ity fonosana ity dia mandefa ny RF abstraction layer (RFAL) amin'ny sehatra Raspberry Pi 4 Linux mba hiasa miaraka amin'ny firmware X-NUCLEO-NFC05A1. Ny fonosana dia manome toy nyampny fampiharana mamantatra karazana NFC isan-karazany tags ary finday manohana ny P2P. Ny RFAL no ST standard mpamily ho an'ny ST25R NFC/RFID Reader ICs ST25R3911B, ST25R3912, ST25R3913, ST25R3914 ary ST25R3915. Ampiasaina, ohatra, ny firmware ST25R3911B-DISCO (STSW-ST25R002) sy ny firmware X-NUCLEONFC05A1 (X-CUBE-NFC5).

STSW-ST25R009 dia manohana ny ST25R3911B ambany-sosona protocols ary koa ny sasany sosona protocols ambony kokoa ho an'ny fifandraisana. Ny RFAL dia nosoratana tamin'ny fomba azo entina, ka afaka mandeha amin'ny fitaovana isan-karazany mifototra amin'ny Linux®. Ity antontan-taratasy ity dia mamaritra ny fomba fampiasana ny tranomboky RFAL amin'ny rafitra Linux mahazatra (amin'ity tranga ity ny Raspberry Pi 4) ho an'ny fifandraisana NFC/RF. Ny kaody dia tena azo entina ary miasa miaraka amin'ny fiovana kely amin'ny sehatra Linux rehetra.

Sary 1. tranomboky RFAL amin'ny sehatra Linux

TAPITRAview

Toetoetra

Mpamily habaka mpampiasa Linux feno (layer abstraction RF) hananganana rindranasa azo ampiasaina amin'ny alàlan'ny ST25R3911B/ST25R391x avo lenta NFC miaraka amin'ny hery mivoaka 1.4 W.
Fifandraisana mpampiantrano Linux miaraka amin'ny ST25R3911B/ST25R391x mampiasa interface SPI
Feno RF/NFC abstraction (RFAL) ho an'ny teknolojia lehibe rehetra sy ny sosona protocols ambony:
- 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)
- Teknolojia manokana (Kovio, B', iClass, Calypso®, …)
SampNy fampiharana azo alaina miaraka amin'ny birao fanitarana X-NUCLEO-NFC05A1, ampidirina amin'ny Raspberry Pi 4
Sampny fampiharana hamantarana NFC maromaro tag karazana sy finday manohana ny P2P
Fepetra fahazoan-dàlana maimaim-poana ho an'ny mpampiasa

Architecture software

Ny sary 2 dia mampiseho ny antsipirian'ny maritrano rindrambaiko ao amin'ny tranomboky RFAL amin'ny sehatra Linux®.

Ny RFAL dia mora entina amin'ny sehatra hafa amin'ny alàlan'ny fampifanarahana ilay antsoina hoe sehatra files.

Ny lohateny file rfal_platform.h misy famaritana macro, izay mila omena sy ampiharin'ny tompon'ny sehatra. Ankoatr'izay, manome sehatra manokana toy ny fanendrena GPIO, loharanon-drafitra, hidin-trano ary IRQ, izay takiana amin'ny fampandehanana marina ny RFAL.

Ity fihetsiketsehana ity dia mampihatra ny fiasan'ny sehatra ary manome seranan-tsambon'ny tranomboky RFAL ho an'ny mpampiasa Linux®. Tranomboky iombonana file dia novokarina, izay ampiasain'ny fampiharana demo hanehoana ny fiasa omen'ny sosona RFAL.

Ny mpampiantrano Linux® dia mampiasa interface sysfs azo avy amin'ny habaka mpampiasa Linux® ahafahana mifandray amin'ny SPI amin'ny fitaovana ST25R3911B. Ao anatin'ny kernel Linux® ny interface sysfs SPI dia mampiasa spidev driver kernel Linux® handefasana/handray sary SPI mankany/avy amin'ny ST25R3911B.

Ho an'ny fitantanana ny tsipika fanelanelanana an'ny ST25R3911B, ny mpamily dia mampiasa ny libgpiod mba hampahafantarana ny fiovana amin'ity andalana ity.

Figure 2. Architecture software RFAL amin'ny Linux

Fametrahana fitaovana

Platform ampiasaina

Ny birao Raspberry Pi 4 miaraka amin'ny Raspberry Pi OS dia ampiasaina ho sehatra Linux hananganana tranomboky RFAL ary hifaneraserana amin'ny ST25R3911B amin'ny SPI.
ST25R3911B dia mamela fampiharana amin'ny sehatra Linux hamantatra sy hifandray amin'ny fitaovana NFC.

Fitaovana fitakiana

Raspberry Pi 4
Karatra micro SD 8 GBytes hamerenana ny Raspberry Pi OS
mpamaky karatra SD
Tetezana board hampifandray ny X-NUCLEO-NFC05A1 amin'ny Raspberry Pi Arduino Adapter ho an'ny Raspberry Pi, ampahany laharana ARPI600.
Ampahany X-NUCLEO-NFC05A1. Jereo ny fepetra takian'ny Raspberry Pi OS farany.

Fifandraisana finday

Ny ARPI600 Raspberry Pi amin'ny Arduino adapter board dia ampiasaina hampifandraisana ny X-NUCLEO-NFC05A1 amin'ny Raspberry Pi. Ilaina ny manova ny jumper amin'ny solaitrabe adaptatera hampifandray azy amin'ny X-NUCLEO-NFC05A1.

Tandremo: Ny ARPI600 dia mamatsy 5 V amin'ny pin Arduino IOREF. Ny fametahana mivantana ny X-NUCLEO-NFC05A1 dia mamerina 5 V amin'ny tsipìka sasany, mety hanimba ny board Raspberry Pi izany. Misy tatitra manokana momba ny Raspberry Pi 4B+ tena rava. Mba hisorohana an'io toe-javatra io dia ampifanaraho ny ARPI600 (fampiasana sarotra) na ny X-NUCLEO-NFC05A1 (fampiasana mora kokoa).

Ny vahaolana mora indrindra dia ny manapaka ny pin CN6.2 (IOREF) amin'ny X-NUCLEO-NFC05A1 araka ny aseho amin'ny sary 3.

Ny fanapahana ity pin dia tsy misy fiantraikany amin'ny asa miaraka amin'ny Nucleo boards (NUCLEO-L474RG, NUCLEO-F401RE, NUCLEO-8S208RB, sns.).

Sary 3. Fanamboarana fifandraisana amin'ny fitaovana

Fametrahana jumper

Ny jumper ho an'ny A5, A4, A3, A2, A1 ary A0 aseho amin'ny sary 4 dia tsy maintsy ovaina ho P23, P22, P21 ary CE1. Miaraka amin'ireo toe-javatra jumper ireo, ny nomeraon'ny PIN GPIO 7 an'ny Raspberry dia ampiasaina ho andalana interrupt ho an'ny X-NUCLEO-NFC05A1.

Sary 4. Ny toerana misy ny jumper A5, A4, A3, A2, A1 ary A0 eo amin'ny solaitrabe adaptatera

Amin'izao fotoana izao, ity seranan-tsambo famakiam-boky RFAL ity dia mampiasa ny pin GPIO7 ho andalana manapaka, araka ny filaharana jumper. Raha misy fepetra takiana hanovana ny tsipika interrupt avy amin'ny GPIO7 mankany amin'ny GPIO hafa, ny kaody manokana amin'ny sehatra (amin'ny file pltf_gpio.h) dia mila ovaina mba hanovana ny famaritana ny macro "ST25R_INT_PIN" manomboka amin'ny 7 mankany amin'ny pin GPIO vaovao, ho ampiasaina ho andalana manapaka.

Miaraka amin'ny firafitry ny jumper etsy ambony, ny birao adaptatera dia azo ampiasaina hampifandraisana ny X-NUCLEO-NFC05A1 amin'ny board Raspberry Pi araka ny aseho amin'ny sary 5.

Sary 5. Fametrahana fitaovana ambony view

Sary 6. Lafiny fametrahana fitaovana view

Linux environment setup

Fametrahana ny Raspberry Pi

Mba hametrahana ny tontolo Linux, ny dingana voalohany dia ny fametrahana sy fametrahana ny Raspberry Pi 4 miaraka amin'ny Raspberry Pi OS araka ny hazavaina etsy ambany:

Dingana 1

Ampidino ny sary Raspberry Pi OS farany amin'ny rohy:

https://www.raspberrypi.com

Mifidiana Raspberry Pi OS miaraka amin'ny desktop. Ho an'ireo fitsapana etsy ambany dia nampiasaina ity kinova manaraka ity: Septambra 2022 (2022-09-22-raspios-bullseye-armhf.img.xz).

Dingana 2

Sokafy ny sary Raspberry Pi ary soraty ao amin'ny karatra SD izany amin'ny fanarahana ny torolàlana hita ao amin'ny fizarana antsoina hoe "Manoratra sary amin'ny karatra SD".

Dingana 3

Ampifandraiso ny fitaovana:

Ampifandraiso amin'ny monitor ny Raspberry Pi amin'ny fampiasana cable HDMI mahazatra.
Ampifandraiso amin'ny seranana USB Raspberry Pi ny totozy sy ny klavier.

Azo atao ihany koa ny miara-miasa amin'ny Raspberry Pi mampiasa ssh. Amin'izay fotoana izay dia tsy ilaina ny mampifandray ny monitor, ny klavier ary ny totozy amin'ny Raspberry Pi. Ny hany takiana dia ny fananana ny PC misy ssh ao anatin'ny tambajotra mitovy amin'ny Raspberry Pi ary amboary ny adiresy IP mifanaraka amin'izany.

Dingana 4

Sokafy ny Raspberry Pi amin'ny karatra SD.

Aorian'ny booting dia misy desktop Linux miorina amin'ny Debian miseho amin'ny monitor.

Fanamarihana: Indraindray dia tsikaritra fa aorian'ny fanombohana ny Raspberry Pi dia tsy mandeha ny fanalahidin'ny fitendry sasany. Mba hahatonga azy ireo hiasa, sokafy ny file /etc/default/keyboard ary apetraho XKBLAYOUT=”us” ary avereno indray ny Raspberry Pi.

Alefaso ny SPI amin'ny Raspberry Pi

Ny mpamily SPI ao anaty kernel dia mifandray amin'ny X-NUCLEO-NFC05A1 amin'ny alàlan'ny SPI. Zava-dehibe ny manamarina raha efa mandeha ny SPI ao amin'ny rafitra Raspberry Pi OS/kernel.
Jereo raha hita ao amin'ny tontolo Raspberry Pi ny /dev/spidev0.0. Raha tsy hita izany dia avelao ny interface SPI amin'ny alàlan'ny fampiasana "raspi-config" amin'ny alàlan'ny fanarahana ireo dingana voalaza etsy ambany.

Dingana 1

Sokafy ny terminal vaovao amin'ny Raspberry Pi ary tanteraho ny baiko "raspi-config" ho root:

sudo raspi-config

Ity dingana ity dia manokatra interface an-tsary.

Dingana 2

Safidio ao amin'ny interface grafika ny safidy antsoina hoe "Safidy Interfacing".

Dingana 3

Ity dingana ity dia mitanisa safidy isan-karazany.
Safidio ny safidy antsoina hoe "SPI".
Misy varavarankely vaovao miseho miaraka amin'ny lahatsoratra manaraka:
"Tianao ve ny hampivelatra ny interface SPI?"

Dingana 4

Select amin'ity varavarankely ity mba ahafahana SPI.

Dingana 5

Avereno indray ny Raspberry Pi.
Ireo dingana etsy ambony dia ahafahan'ny interface SPI ao amin'ny tontolo Raspberry Pi aorian'ny famerenana indray.

Fanamboarana tranomboky sy fampiharana RFAL

Ny demo RFAL an'ny Linux dia omena ao anaty tahiry. Andeha hatao hoe:
ST25R3911B_v2.8.0_Linux_demo_v1.0.tar.xz.
Raha hanangana tranomboky RFAL sy fampiharana amin'ny Raspberry Pi, araho ireto dingana manaraka ireto:

Dingana 1

Sokafy ny fonosana amin'ny Raspberry Pi amin'ny alàlan'ny baiko etsy ambany avy amin'ny lahatahiry an-trano:

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

Dingana 2

Raha tsy vita teo aloha dia apetraho ny cmake, mampiasa baiko etsy ambany:

apt-get install cmake

Ny trano famakiam-boky RFAL sy ny rafitra fananganana fampiharana dia mifototra amin'ny cmake, noho izany dia ilaina ny mametraka cmake amin'ny fanangonana ny fonosana.

Dingana 3

Raha hanangana tranomboky sy fampiharana RFAL dia mandehana any amin'ny lahatahiry "manorina":

cd ST25R3911B_v2.8.0_Linux_demo_v1.0/Linux_demo/build

ary araho ny baiko etsy ambany avy eo:

cmake..

Ao amin'ny baiko etsy ambony ".." dia manondro fa misy ny CMakeLists.txt ambony indrindra ao amin'ny lahatahiry ray aman-dreny, izany hoe
ST25R3911B_v2.8.0_Linux_demo_v1.0.

Ny baiko cmake dia mamorona ny makefile izay ampiasaina amin'ny dingana manaraka hanamboarana ny tranomboky sy ny fampiharana.

Dingana 4

Alefaso ny baiko "manao" hananganana tranomboky sy fampiharana RFAL:

manao

Ny baiko "manao" dia manorina voalohany ny tranomboky RFAL ary avy eo manangana ny fampiharana eo amboniny.

Ahoana ny fampandehanana ny fampiharana

Ny fananganana mahomby dia miteraka executable antsoina hoe "nfc_demo_st25r3911b" amin'ity toerana manaraka ity:
/build/applications.

Amin'ny alàlan'ny default dia mila mandeha miaraka amin'ny zo fototra avy amin'ny lalana ny fampiharana: ST25R3911B_v2.8.0_Linux_demo_v1.0/linux_demo/build:

sudo ./demo/nfc_demo_st25r3911b

Manomboka manao fitsapan-kevitra momba ny NFC ny fampiharana tags ary finday. Izy io dia mampiseho ireo fitaovana hita miaraka amin'ny UID-ny araka ny aseho amin'ny sary 7.

Sary 7. Fampisehoana ireo fitaovana hita

Mba hampitsaharana ny fampiharana dia tsindrio Ctrl + C.

Tantara fanavaozana

Tabilao 1. Tantaran'ny fanavaozana ny antontan-taratasy

Lisitry ny latabatra

Tabilao 1. Tantaran'ny fanavaozana ny antontan-taratasy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Lisitry ny tarehimarika

Sary 1. Tranomboky RFAL amin'ny sehatra Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Sary 2. Architecture software RFAL amin'ny Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Sary 3. Fanamboarana fifandraisana amin'ny fitaovana. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Sary 4. Ny toerana misy ny jumper A5, A4, A3, A2, A1 ary A0 eo amin'ny solaitrabe adaptatera. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Sary 5. Fametrahana fitaovana ambony view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Sary 6. Lafiny fametrahana fitaovana view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Sary 7. Fampisehoana ireo fitaovana hita . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

FANAMARIHANA MANDRAKIZAY – vakio tsara

Ny STMicroelectronics NV sy ny sampany (“ST”) dia manana zo hanao fanovana, fanitsiana, fanatsarana, fanovana ary fanatsarana ny vokatra ST sy/na ity antontan-taratasy ity amin'ny fotoana rehetra tsy misy filazana. Ny mpividy dia tokony hahazo ny vaovao farany mifandraika amin'ny vokatra ST alohan'ny hametrahana baiko. Ny vokatra ST dia amidy araka ny fepetra sy fepetra momba ny fivarotana ST amin'ny fotoana fanekena ny kaomandy.

Ny mpividy dia tompon'andraikitra amin'ny safidy, ny fisafidianana ary ny fampiasana ny vokatra ST ary ny ST dia tsy mandray andraikitra amin'ny fanampiana amin'ny fampiharana na ny famolavolana ny vokatra avy amin'ny mpividy.

Tsy misy fahazoan-dàlana, na mazava na an-kolaka, amin'ny zon'ny fananana ara-tsaina omen'ny ST eto.

Ny fivarotana indray ny vokatra ST miaraka amin'ny fepetra hafa amin'ny fampahalalana voalaza eto dia hanafoana ny fiantohana omen'ny ST ho an'ny vokatra toy izany.

ST sy ny logo ST dia marika famantarana ny ST. Raha mila fanazavana fanampiny momba ny marika ST, jereo ny www.st.com/trademarks. Ny anaran'ny vokatra na serivisy hafa rehetra dia fananan'ny tompony tsirairay avy.

Ny fampahalalana ato amin'ity antontan-taratasy ity dia manolo sy manolo ny fampahalalana efa nomena tamin'ny dikan-teny teo aloha amin'ity antontan-taratasy ity.

Documents / Loharano

STMicroelectronics UM2375 Linux Driver [pdf] Boky Torolàlana
UM2375 Linux Driver, UM2375, Linux Driver, Driver

References

User Manual