STMicroelectronics UM2375 Linux Avetaavale Tusi Taiala

Avetaavale Linux® mo ST25R3911B ma ST25R3912/14/15 pito i luma NFC maualuga
Folasaga
O le avetaavale STSW-ST25R009 Linux® e mafai ai e le Raspberry Pi 4 ona faʻaogaina le X-NUCLEO-NFC05A1, lea o loʻo i ai le ST25R3911B maualuga maualuga NFC masini lautele.
O lenei afifi o loʻo faʻapipiʻiina le RF abstraction layer (RFAL) i luga o le Raspberry Pi 4 Linux platform e faʻaogaina i le X-NUCLEO-NFC05A1 firmware. O le afifi e maua ai e pei oample talosaga e iloa ai ituaiga eseese o NFC tags ma telefoni feaveai e lagolagoina le P2P. O le RFAL o le ST standard avetaʻavale mo ST25R NFC/RFID Reader ICs ST25R3911B, ST25R3912, ST25R3913, ST25R3914 ma ST25R3915. E faʻaaogaina, mo se faʻataʻitaʻiga, e le ST25R3911B-DISCO firmware (STSW-ST25R002) ma le X-NUCLEONFC05A1 firmware (X-CUBE-NFC5).
STSW-ST25R009 e lagolagoina uma ST25R3911B fa'avae pito i lalo fa'atasi ma nisi fa'atonuga maualuga atu mo feso'ota'iga. O le RFAL o loʻo tusia i se auala feaveaʻi, ina ia mafai ona taʻavale i luga o le tele o masini faʻavae i luga ole Linux®. O lenei pepa o loʻo faʻamatalaina pe faʻapefea ona faʻaogaina le faletusi RFAL i luga o se faiga masani Linux (i le tulaga lea o le Raspberry Pi 4) mo fesoʻotaʻiga NFC/RF. O le code e sili ona feaveaʻi ma galue i nai suiga laiti i luga o soʻo se Linux platform.
Ata 1. faletusi RFAL i luga ole tulaga Linux

Ua umaview
Vaega
- Fa'auma le aveta'avale avanoa e fa'aoga ai le Linux (RF abstraction layer) e fausia ai le NFC fa'aogaina talosaga e fa'aaoga ai le ST25R3911B/ST25R391x pito i luma NFC maualuga ma e o'o atu i le 1.4 W mana fa'aola.
- Feso'ota'iga talimalo Linux ma le ST25R3911B/ST25R391x fa'aoga le SPI
- Fa'auma RF/NFC abstraction (RFAL) mo tekinolosi tetele uma ma faiga fa'avae maualuga:
- NFC-A (ISO14443-A)
- NFC-B (ISO14443-B)
- NFC-F (FeliCa™)
- NFC-V (ISO15693)
- P2P (ISO18092)
- ISO-DEP (ISO fa'asoa fa'amatalaga, ISO14443-4)
- NFC-DEP (NFC fa'asoa fa'amatalaga, ISO18092)
- Tekinolosi fa'apitoa (Kovio, B', iClass, Calypso®, …)
- Sample faʻatinoga o loʻo maua ma le X-NUCLEO-NFC05A1 faʻalautele laupapa, faʻapipiʻi i totonu o le Raspberry Pi 4
- Sample talosaga e iloa ai le tele o NFC tag ituaiga ma telefoni feaveai e lagolagoina le P2P
- Tu'utu'uga laisene fa'aui-fai fua
Faiga fa'akomepiuta
Ata 2 o lo'o fa'aalia ai fa'amatalaga fa'ata'ita'iga fa'akomepiuta a le faletusi RFAL i luga o le Linux® platform.
O le RFAL e faigofie ona feaveaʻi i isi faʻavae e ala i le fetuutuunai o le mea e taʻua o le faʻavae files.
O le ulutala file rfal_platform.h o loʻo i ai faʻamatalaga macro, e manaʻomia ona tuʻuina atu ma faʻatinoina e le pule faʻavae. E le gata i lea, o loʻo tuʻuina atu tulaga faʻapitoa e pei o le GPIO, punaoa faʻaoga, loka ma IRQs, e manaʻomia mo le faʻaogaina saʻo o le RFAL.
O lenei fa'ata'ita'iga e fa'atino ai galuega fa'avae ma tu'uina atu se uafu o le faletusi RFAL i avanoa fa'aoga o Linux®. Se faletusi fa'asoa file ua fa'atupuina, lea e fa'aaogaina e le fa'ata'ita'iga talosaga e fa'aalia ai galuega fa'atino e tu'uina atu e le RFAL layer.
O lo'o fa'aogaina e le Linux® host interface sysfs o lo'o maua mai le avanoa fa'aoga Linux® e mafai ai ona feso'ota'i SPI ma le masini ST25R3911B. I totonu o le Linux® kernel o le SPI sysfs interface e fa'aogaina ai le Linux® kernel driver spidev e lafo/maua ai fa'avaa SPI i/mai ST25R3911B.
Mo le taulimaina o le laina faʻalavelave a ST25R3911B, e faʻaaoga e le avetaavale le libgpiod e logoina ai suiga i lenei laina.
Ata 2. RFAL software architecture i luga o Linux

Seti meafaigaluega
Fa'aoga fa'avae
O le Raspberry Pi 4 laupapa ma Raspberry Pi OS o loʻo faʻaaogaina e avea ma Linux platform e fausia ai le faletusi RFAL ma fegalegaleai ma ST25R3911B i luga ole SPI.
ST25R3911B e mafai ai e se talosaga ile Linux platform ona iloa ma fesoʻotaʻi ma masini NFC.
Meafaigaluega mana'omia
- Rasipi Pi 4
- 8 GBytes micro SD card e faʻaulu ai Raspberry Pi OS
- SD card faitau
- Laupapa laupapa e faʻafesoʻotaʻi X-NUCLEO-NFC05A1 ma Raspberry Pi Arduino Adapter mo Raspberry Pi, vaega numera ARPI600.
- X-NUCLEO-NFC05A1. Va'ai ile Raspberry Pi OS mana'oga lata mai.
Feso'ota'iga meafaigaluega
O le ARPI600 Raspberry Pi i Arduino adapter board e faʻaogaina e faʻafesoʻotaʻi le X-NUCLEO-NFC05A1 ma le Raspberry Pi. E manaʻomia le suia o le osooso o le laupapa faʻapipiʻi e faʻafesoʻotaʻi ma le X-NUCLEO-NFC05A1.
Lapata'iga: O le ARPI600 e sese le tu'uina atu o le 5 V i le Arduino IOREF pine. Fa'apipi'i sa'o le X-NUCLEO-NFC05A1 fa'afo'i le 5 V i luga o nisi pine, e ono fa'aleagaina ai le laupapa Raspberry Pi. O loʻo i ai lipoti aemaise lava o le Raspberry Pi 4B+ o loʻo faʻaumatia moni lava. Ina ia aloese mai lenei tulaga faʻafetaui le ARPI600 (se faʻagaioiga faigata) poʻo le X-NUCLEO-NFC05A1 (faʻaoga faigofie).
Ole mea sili ona faigofie ole tipi ole pine CN6.2 (IOREF) ile X-NUCLEO-NFC05A1 e pei ona faʻaalia ile Ata 3.
O le tipiina o lenei pine e le afaina ai le gaioiga faʻatasi ma laupapa Nucleo (NUCLEO-L474RG, NUCLEO-F401RE, NUCLEO-8S208RB, ma isi).
Ata 3. Fa'apipi'i feso'ota'iga meafaigaluega

Fa'atulagaina o le osooso
O osooso mo A5, A4, A3, A2, A1 ma A0 o loʻo faʻaalia i le Ata 4 e tatau ona suia i le P23, P22, P21 ma le CE1. Faatasi ai ma nei tulaga osooso, Raspberry's GPIO pine numera 7 o loʻo faʻaaogaina e fai ma laina faʻalavelave mo X-NUCLEO-NFC05A1.
Ata 4. Tulaga o tagata osooso A5, A4, A3, A2, A1 ma A0 i luga o le laupapa fetuutuunai

I le taimi nei, o lenei faletusi faletusi RFAL e faʻaaogaina le pine GPIO7 o le laina faʻalavelave, e tusa ai ma le faʻaogaina o le osooso. Afai ei ai se manaʻoga e sui le laina faʻalavelave mai GPIO7 i se GPIO ese, o le faʻailoga faʻapitoa (i totonu file pltf_gpio.h) e manaʻomia ona suia e sui ai le faʻamatalaga o le macro "ST25R_INT_PIN" mai le 7 i le GPIO pine fou, e faʻaaogaina e avea ma laina faʻalavelave.
Fa'atasi ai ma fa'atonuga o lo'o i luga, e mafai ona fa'aoga le laupapa fa'apipi'i e fa'afeso'ota'i le X-NUCLEO-NFC05A1 ma le laupapa Raspberry Pi e pei ona fa'aalia i le Ata 5.
Ata 5. Fa'atonuga pito i luga view

Ata 6. Itu o le seti meafaigaluega view

Seti siosiomaga Linux
Fa'aosoina ole Raspei Pi
Ina ia setiina le siosiomaga Linux, laasaga muamua o le faʻapipiʻi ma faʻaulu le Raspberry Pi 4 ma Raspberry Pi OS e pei ona faʻamatalaina i lalo:
Laasaga 1
Sii mai le ata fou o le Raspberry Pi OS mai le sootaga:
Filifili Raspberry Pi OS ma le komepiuta. Mo su'ega o lo'o i lalo na fa'aaogaina le fa'asologa o lo'o mulimuli mai: Setema 2022 (2022-09-22-raspios-bullseye-armhf.img.xz).
Laasaga 2
Tatala le ata Raspberry Pi ma tusi i totonu o le SD card e ala i le mulimuli i faatonuga o loʻo maua i le vaega ua taʻua " Tusia se ata i le SD card".
Laasaga 3
Fa'afeso'ota'i meafaigaluega:
- Faʻafesoʻotaʻi le Raspberry Pi i se mataʻitu e faʻaaoga ai se uaea HDMI masani.
- Fa'afeso'ota'i le isumu ma le keyboard i ports USB a Raspberry Pi.
E mafai foi ona galue ma Raspberry Pi e faʻaaoga ai le ssh. I lena tulaga e le manaʻomia ona faʻafesoʻotaʻi le mataʻitu, piano ma le isumu ma Raspberry Pi. Pau lava le mea e manaʻomia o le i ai o le PC ma le ssh i totonu o le fesoʻotaʻiga tutusa e pei o le Raspberry Pi ma faʻapipiʻi le tuatusi IP e tusa ai.
Laasaga 4
Fa'afou le Raspei Pi i le SD card.
A maeʻa le taʻavale, o le Debian based Linux desktop e faʻaalia i luga o le mataʻituina.
Manatua: O nisi taimi, e matauina pe a uma ona faʻaosoina le Raspberry Pi, o nisi ki keyboard e le aoga. Ina ia galulue, tatala le file /etc/default/keyboard ma seti XKBLAYOUT = "us" ma toe faʻafou le Raspberry Pi.
Fa'amalo le SPI ile Raspei Pi
O le avetaavale SPI i totonu o le fatu e fesoʻotaʻi ma X-NUCLEO-NFC05A1 e ala i le SPI. E taua le siaki pe ua uma ona mafai SPI i le Raspberry Pi OS / kernel configuration.
Siaki pe o /dev/spidev0.0 o loʻo vaʻaia i le siosiomaga Raspberry Pi. Afai e le o vaʻaia, faʻatagaina le SPI faʻaoga e faʻaaoga ai le aoga "raspi-config" e ala i le mulimuli i laasaga o loʻo faʻamatalaina i lalo.
Laasaga 1
Tatala se laina fou i luga o le Raspberry Pi ma faʻatautaia le poloaiga "raspi-config" e pei o aʻa:
sudo raspi-config
O lenei la'asaga e tatala ai se fa'aoga fa'akalafi.
Laasaga 2
Filifili i totonu o le faʻataʻitaʻiga faʻataʻitaʻiga le filifiliga e taʻua o le "Interfacing Options".
Laasaga 3
O lenei laasaga e lisi ai filifiliga eseese.
Filifili le filifiliga e igoa "SPI".
E aliali mai se fa'amalama fou ma fa'amatalaga nei:
“E te mana’o e fa’aagaaga le SPI?”
Laasaga 4
Filifili i lenei faamalama e mafai ai e le SPI.
Laasaga 5
Toe fa'afou Raspei Pi.
O laasaga o loʻo i luga o le a mafai ai ona faʻaogaina le SPI ile siosiomaga Raspberry Pi pe a maeʻa le toe faʻafouina.
Fausia le faletusi RFAL ma le faʻaoga
O le RFAL demo o Linux o loʻo tuʻuina atu i totonu o se faʻamaumauga. Sei faapea o lona igoa:
ST25R3911B_v2.8.0_Linux_demo_v1.0.tar.xz.
Ina ia fausia le faletusi RFAL ma le faʻaoga ile Raspberry Pi, mulimuli i laasaga nei:
Laasaga 1
Aveese le afifi i luga o le Raspberry Pi e faʻaaoga ai le faʻatonuga o loʻo i lalo mai le lisi o fale:
tar -xJvf ST25R3911B_v2.8.0_Linux_demo_v1.0.tar.xz
Laasaga 2
Afai e leʻi faia muamua, faʻapipiʻi cmake, faʻaaoga i lalo le poloaiga:
apt-get install cmake
O le faletusi RFAL ma le polokalama faufale e faʻavae i luga o le cmake, o le mea lea e manaʻomia ai le faʻapipiʻiina o le cmake mo le tuʻufaʻatasia o le afifi.
Laasaga 3
Ina ia fausia le faletusi RFAL ma le talosaga, alu i le "fausia" lisi:
cd ST25R3911B_v2.8.0_Linux_demo_v1.0/Linux_demo/build
ma taʻavale le poloaiga i lalo mai iina:
cmake..
I le poloaiga o loʻo i luga ".." o loʻo faʻaalia ai le maualuga maualuga CMakeLists.txt o loʻo i ai i le faʻatonuga matua, ie
ST25R3911B_v2.8.0_Linux_demo_v1.0.
O le cmake poloaiga e fatuina ai le faiafile o loʻo faʻaaogaina i le isi laasaga e fausia ai le faletusi ma le faʻaoga.
Laasaga 4
Faʻatonu le "faia" poloaiga e fausia ai le faletusi RFAL ma le faʻaoga:
faia
O le "faia" poloaiga muamua fausia le faletusi RFAL ona fausia ai lea o le talosaga i luga.
Fa'afefea ona fa'agaoioi le talosaga
O le fa'atupuina manuia e fa'atupuina ai se fa'atonu e ta'ua "nfc_demo_st25r3911b" i le nofoaga lea:
/build/applications.
E le mafai ona fa'agasolo le talosaga e mana'omia le fa'aogaina o aia tatau mai le ala: ST25R3911B_v2.8.0_Linux_demo_v1.0/linux_demo/build:
sudo ./demo/nfc_demo_st25r3911b
Ua amata ona palota le talosaga mo le NFC tags ma telefoni fe'avea'i. O lo'o fa'aalia ai masini na maua ma latou UID e pei ona fa'aalia i le Ata 7.
Ata 7. Fa'aaliga o masini na maua

Ina ia faamutaina le talosaga kiliki Ctrl + C.
Toe iloilo tala'aga
Laulau 1. Tala'aga o le toe iloiloga o pepa

Lisi o laulau
Laulau 1. Tala'aga o le toe iloiloga o pepa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Lisi o fuainumera
Ata 1. faletusi RFAL i luga ole tulaga Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Ata 2. RFAL software architecture on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Ata 3. Fa'apipi'i feso'ota'iga meafaigaluega . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Ata 4. Tulaga o tagata osooso A5, A4, A3, A2, A1 ma A0 i luga o le laupapa fetuutuunai. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Ata 5. Fa'atonuga pito i luga view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Ata 6. Itu o le seti meafaigaluega view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Ata 7. Fa'aaliga o masini na maua . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
FA'AALIGA TAUA – FAITAU MA LE FA'AMANATU
STMicroelectronics NV ma ona lala ("ST") fa'aagaga le aia e fai ai suiga, fa'asa'oga, fa'aleleia, fa'aleleia, ma fa'aleleia atili i oloa ST ma/po'o lenei pepa i so'o se taimi e aunoa ma se fa'aaliga. E tatau i tagata fa'atau ona maua fa'amatalaga talafeagai lata mai i oloa ST a'o le'i tu'uina atu oka. O oloa ST o lo'o fa'atau atu e tusa ai ma tu'utu'uga ma aiaiga a le ST o lo'o fa'atau atu i le taimi e fa'ailoa ai le oka.
E na'o le au fa'atau le filifiliga, filifiliga, ma le fa'aogaina o oloa ST ma e leai se noataga a le ST mo fesoasoani talosaga po'o le mamanu o oloa a tagata fa'atau.
Leai se laisene, fa'aalia pe fa'aalia, i so'o se aia tatau tau le atamai ua fa'atagaina e ST i totonu.
Toe fa'atauina atu oloa ST ma aiaiga e ese mai fa'amatalaga o lo'o fa'ailoa mai i inei e tatau ona fa'aleaogaina ai so'o se fa'ataga na tu'uina atu e ST mo ia oloa.
ST ma le logo ST o fa'ailoga fa'ailoga a ST. Mo fa'amatalaga fa'aopoopo e uiga i fa'ailoga tau ST, va'ai ile www.st.com/trademarks. O isi igoa uma o oloa po'o auaunaga o le meatotino a latou lava tagata.
O fa'amatalaga i totonu o lenei pepa e suitulaga ma suia fa'amatalaga na tu'uina atu muamua i so'o se lomiga muamua o lenei pepa.
© 2023 STMicroelectronics – Ua taofia aia tatau uma
Pepa / Punaoa
![]() |
STMicroelectronics UM2375 Linux Avetaavale [pdf] Tusi Taiala UM2375 Linux Aveta'avale, UM2375, Linux Aveta'avale, Aveta'avale |




