UM2548 Linux bílstjóri
Linux® bílstjóri fyrir ST25R3916/ST25R3916B
Notendahandbók
UM2548 Linux bílstjóri
Inngangur
STSW-ST25R013 Linux® bílstjóri gerir Raspberry Pi® 4 kleift að starfa með X-NUCLEO-NFCO6A1 og X-NUCLEO-NFCO8A1 töflunum, sem innihalda, í sömu röð, ST25R3916 og ST25R3916B tækin.
Þessi pakki tengir RF abstraktlagið (RFAL) inn á Raspberry Pi 4 Linux vettvang, til að starfa með vélbúnaðarborðinu og veitir eins ogampforritið finnur mismunandi gerðir af NFC tags og farsímar sem styðja P2P. RFAL er ST staðaldrifinn fyrir ST25R3916 og ST25R3916B, hágæða NFC alhliða tæki / EMVCo lesendur. Það er til dæmis notað af ST25R3916-DISCO fastbúnaðinum (STSW-ST25R010) og af X-NUCLEO-NFCO06A1 fastbúnaðinum (X-CUBE-NFC6).
STSW-ST25R013 styður allar ST25R3916/ST25R3916B lægra lag og sum hærra lag samskiptareglur fyrir samskipti. RFAL er skrifað á flytjanlegan hátt, svo það getur keyrt á fjölmörgum tækjum sem byggjast á Linux. Þetta skjal lýsir því hvernig hægt er að nota RFAL bókasafnið á venjulegu Linux kerfi (í þessu tilfelli Raspberry Pi 4) fyrir NFC/RF samskipti. Kóðinn er mjög flytjanlegur og virkar með smávægilegum breytingum á hvaða Linux vettvang sem er.
Yfirview
1.1 Eiginleikar
- Heill Linux notendarýmisrekla (RF abstraktlag) til að smíða NFC virk forrit með því að nota ST25R3916 og ST25R3916B tækin
- Linux gestgjafi samskipti við ST25R3916/ST25R3916B með SPI tengi
- Heill RF/NFC abstrakt (RFAL) fyrir alla helstu tækni og samskiptareglur fyrir hærra lag:
– NFC-A (ISO14443-A)
– NFC-B (ISO14443-B)
- NFC-F (FeliCa™)
– NFC-V (ISO15693)
– P2P (ISO18092)
– ISO-DEP (ISO gagnaskiptasamskiptareglur, ISO14443-4)
- NFC-DEP (NFC gagnaskiptareglur, ISO18092)
– Sértækni, eins og Kovio, B', iClass, Calypso® - Sampútfærsla í boði með X-NUCLEO-NFC06A1 og X-NUCLEO-NFC08A1 stækkunartöflunum, tengd við Raspberry Pi 4
- SampLe forritið til að greina nokkra NFC tag gerðir og farsíma sem styðja P2P
- Ókeypis notendavænir leyfisskilmálar
1.2 Hugbúnaðararkitektúr
Mynd 2 sýnir upplýsingar um hugbúnaðararkitektúr RFAL bókasafnsins á Linux palli.
RFAL er auðvelt að flytja til annarra palla með því að aðlaga svokallaðan pall files.
Hausinn file rfal_platform.h inniheldur þjóðhagsskilgreiningar, sem eigandi pallsins á að veita og útfæra.
Það býður upp á sérstakar stillingar eins og GPIO úthlutun, kerfisauðlindir, læsingar og IRQ, sem eru nauðsynlegar fyrir rétta notkun RFAL.
Þessi sýnikennsla útfærir vettvangsaðgerðirnar og veitir tengi fyrir RFAL inn í notendarými Linux.
Sameiginlegt bókasafn file er búið til, sem er notað af sýnikenndu forriti til að sýna fram á virkni RFAL lagsins.
Linux gestgjafi notar sysfs tengi sem er fáanlegt frá Linux notendarými til að framkvæma SPI samskipti við tækin. Inni í Linux kjarnanum notar SPI sysfs viðmótið Linux kjarna driver spidev til að senda/móttaka SPI ramma til/frá tækjunum.
Til að meðhöndla INT línuna af ST25R3916 og ST25R3916B tækjum notar ökumaðurinn libpiod sysfs til að fá tilkynningu um breytingar á þessari línu.
Uppsetning vélbúnaðar
2.1 Notaður pallur
Raspberry Pi 4 borð með Raspberry Pi OS er notað sem Linux vettvangur til að byggja upp RFAL bókasafnið og hafa samskipti við ST25R3916/ST25R3916B yfir SPI.
Tækin gera forriti á Linux vettvangi kleift að greina og eiga samskipti við NFC tæki.
2.2 Kröfur um vélbúnað
- Raspberry Pi 4
- 8 GB micro SD kort til að ræsa Raspberry Pi OS (með nýjustu kröfum þess)
- SD kortalesari
- X-NUCLEO-NFC06A1 eða X-NUCLEO-NFC08A1 borð
- Brú til að tengja borðið við Raspberry Pi Arduino™ millistykki fyrir Raspberry Pi (hlutanúmer ARPI600)
2.2.1 Vélbúnaðartengingar
ARPI600 Raspberry Pi til Arduino millistykki er notað til að tengja borðin við Raspberry Pi. Breyta verður stökkum millistykkisins til að tengja það við X-NUCLEO-NFC06A1 eða X-NUCLEO-NFC08A1 töflurnar.
Varúð:
ARPI600 gefur rangt 5 V til Arduino IOREF pinna. Með því að festa brettin beint á 5 V á suma pinna, þetta getur skemmt Raspberry Pi borðið. Það eru skýrslur um eyðilögð borð (sérstaklega Raspberry Pi 4B+).
Til að forðast þetta skaltu laga ARPI600 (frekar erfið aðgerð) eða X-NUCLEO-NFC06A1/X-NUCLEONFC08A1 borðið (auðveldara).
Auðveldasta leiðréttingin er að klippa CN6.2 (IOREF) pinna á X-NUCLEO-NFC06A1/X-NUCLEO-NFC08A1 borðunum, eins og sýnt er á mynd 3.
Að klippa þennan pinna hefur ekki áhrif á aðgerðina í tengslum við Nucleo plötur (eins og NUCLEO-L474RG, NUCLEO-F401RE, NUCLEO-8S208RB).
Jumper stilling
Breyta verður stökkunum fyrir A5, A4, A3, A2, A1 og A0 sem sýndir eru á mynd 4 í P25, P24, P23, P22, P21 og CE1. Með þessari stillingu er GPIO pinnanúmer 7 frá Raspberry notað sem truflunarlína fyrir X-NUCLEONFC06A1/X-NUCLEO-NFC08A1.
Eins og er, notar þetta RFAL bókasafnstengi pinna GPIO7 sem truflunarlínu (samkvæmt stillingum jumper). Ef það er krafa um að breyta truflunarlínunni úr GPIO7 í annan GPIO, skal vettvangssérstakur kóðann (í file pltf_gpio.h) verður að breyta til að breyta skilgreiningunni á macro ST25R_INT_PIN úr 7 í nýja GPIO pinna, til að nota sem truflunarlínu.
Með ofangreindum jumper stillingum er hægt að nota millistykkið til að tengja X-NUCLEO NFC06A1 og X-NUCLEO-NFC08A1 við Raspberry Pi borð, eins og sýnt er á eftirfarandi myndum.
Linux umhverfi uppsetning
3.1 Að ræsa Raspberry Pi
Til að setja upp Linux umhverfið skaltu fyrst setja upp og ræsa Raspberry Pi með Raspberry Pi OS, eins og útskýrt er hér að neðan:
Skref 1
Sæktu nýjustu Raspberry Pi OS myndina frá https://www.raspberrypi.com, veldu síðan Raspberry Pi OS með skjáborði. Fyrir prófin hér að neðan hefur útgáfan 2022-09-22-raspios-bullseye-armhf.img.xz (september 2022) verið notuð.
Skref 2
Taktu niður Raspberry Pi OS myndina og skrifaðu hana á SD-kortið með því að fylgja leiðbeiningunum sem eru fáanlegar í hlutanum sem heitir „Að skrifa mynd á SD-kortið“.
Skref 3
Tengdu vélbúnaðinn:
- Tengdu Raspberry Pi 4 við skjá með venjulegri HDMI snúru.
- Tengdu mús og lyklaborð við USB-tengi Raspberry Pi.
Það er líka hægt að vinna með Raspberry Pi með ssh. Í þessu tilfelli. það er ekki nauðsynlegt að tengja skjáinn, lyklaborðið og músina við Raspberry Pi. Eina krafan er að hafa tölvuna með ssh inni á sama neti og Raspberry Pi og stilla IP töluna í samræmi við það.
Skref 4
Ræstu Raspberry Pi 4 með SD korti. Eftir ræsingu birtist Debian byggt Linux skjáborð á skjánum.
Athugið:
Stundum, eftir að Raspberry Pi OS er ræst, virka sumir lyklaborðslyklar ekki. Til að láta þá virka skaltu opna file /etc/default/keyboard og stilltu XKBLAYOUT=“us“ og endurræstu Raspberry Pi.
3.2 Virkja SPI á Raspberry Pi
SPI bílstjórinn inni í kjarnanum hefur samskipti við X-NUCLEO-NFC06A1/X-NUCLEO-NFC08A1 töflurnar í gegnum SPI. Það er mikilvægt að athuga hvort SPI sé nú þegar virkt í Raspbian Pi OS kjarnastillingunni.
Athugaðu hvort /dev/spidev0.0 sé sýnilegt í Raspberry Pi umhverfinu. Ef það er ekki sýnilegt, virkjaðu SPI viðmótið með því að nota tólið „raspi-config“ með því að fylgja skrefunum sem lýst er hér að neðan.
Skref 1
Opnaðu nýja flugstöð á Raspberry Pi og keyrðu skipunina "raspi-config" sem rót: sudo raspi-config
Þetta skref opnar grafískt viðmót.
Skref 2
Veldu í grafísku viðmótinu valmöguleikann sem heitir „Tengivalkostir“.
Skref 3
Þetta skref sýnir ýmsa valkosti.
Veldu valkostinn sem heitir "SPI".
Nýr gluggi birtist með eftirfarandi texta:
"Viltu að SPI viðmótið sé virkt?"
Skref 4
Veldu í þessum glugga til að virkja SPI.
Skref 5
Endurræstu Raspberry Pi.
Ofangreind skref munu virkja SPI viðmótið í Raspberry Pi umhverfi eftir endurræsingu.
Byggja RFAL bókasafn og forrit
RFAL sýningin á Linux er veitt í skjalasafni, eins og ST25R3916_v2.8.0_Linux_demo_v1.0.tar.xz.
Til að byggja RFAL bókasafnið og forritið á Raspberry Pi skaltu fara í gegnum eftirfarandi skref:
Skref 1
Taktu upp pakkann á Raspberry Pi með því að nota eftirfarandi skipun úr heimaskránni
tar -xJvf ST25R3916_v2.8.0_Linux_demo_v1.0.tar.xz
Skref 2
Settu upp cmake (ef ekki hefur verið gert áður) með því að nota skipunina
apt-get install cmake
RFAL bókasafn og forritsbyggingarkerfi eru byggð á cmake, af þessum sökum er nauðsynlegt að setja upp cmake til að setja saman pakkann.
Skref 3
Til að byggja upp RFAL bókasafnið og forritið, farðu í byggingarskrána
cd ST25R3916_v2.8.0_Linux_demo_v1.0/linux_demo/build
Þaðan skaltu keyra skipunina
cmgerð..
Í ofangreindri skipun „.“ gefur til kynna að efsta stig CMakeLists.txt sé til í móðurskránni
(ST25R3916_v2.8.0_Linux_demo_v1.0).
Þessi skipun býr til gerðfile notað í næsta skrefi til að byggja upp bókasafnið og forritið. Þaðan skaltu keyra eftirfarandi skipun til að byggja upp sýnikennsluna fyrir ST25R3916B
cmake -DRFAL_VARIANT=st25r3916b ..
Skref 4
Keyrðu make skipunina til að byggja upp RFAL bókasafnið og forritið:
gera
Þessi skipun byggir fyrst RFAL bókasafnið og síðan forritið ofan á það.
Hvernig á að keyra forritið
Vel heppnuð uppbygging býr til keyrslu sem heitir „nfc_poller_st25r3916“ eða „nfc_poller_st25r3916b“ á staðsetningu /build/demo.
Sjálfgefið þarf að keyra forritið með rótarréttindum frá slóðinni ST25R3916_v2.8.0_Linux_demo_v1.0/linux_demo/build/demo/:
sudo ./nfc_demo_st25r3916
Forritið byrjar að skoða könnun fyrir NFC tags og farsímar, birtir síðan tækin sem fundust með UID þeirra, eins og sýnt er á mynd 7.
Til að loka forritinu ýtirðu á Ctrl + C.
Endurskoðunarsaga
Tafla 1. Endurskoðunarferill skjala
| Dagsetning | Endurskoðun | Breytingar |
| 1-mars-19 | 1 | Upphafleg útgáfa. |
| 4. apríl 23 | 2 | Uppfærður skjaltitill, Kaflakynning, Kafli 1.1 Eiginleikar, Kafli 1.2 Hugbúnaðararkitektúr, Kafli 2.1 Notaður pallur, Kafli 2.2 Vélbúnaður kröfur, Kafli 2.2.1 Vélbúnaðartengingar, Kafli 3.1 Ræsing Raspberry Pi, Kafli 3.2 Virkja SPI á Raspberry Pi, Kafli 4 Byggja RFAL bókasafn og forrit, og Kafli 5 Hvernig á að keyra forritið. Uppfært mynd 1. RFAL bókasafn á Linux palli, mynd 2. RFAL hugbúnaðararkitektúr á Linux, og mynd 5. Uppsetning vélbúnaðar efst view. Minniháttar textabreytingar á öllu skjalinu. |
MIKILVÆG TILKYNNING - LESIÐU VARLEGA
STMicroelectronics NV og dótturfélög þess („ST“) áskilja sér rétt til að gera breytingar, leiðréttingar, endurbætur, breytingar og endurbætur á ST vörum og/eða þessu skjali hvenær sem er án fyrirvara. Kaupendur ættu að fá nýjustu viðeigandi upplýsingar um ST vörur áður en þeir leggja inn pantanir. ST vörur eru seldar í samræmi við söluskilmála ST sem eru í gildi þegar pöntun er staðfest.
Kaupendur bera einir ábyrgð á vali, vali og notkun ST vara og ST tekur enga ábyrgð á umsóknaraðstoð eða hönnun vöru kaupenda.
Ekkert leyfi, óbeint eða óbeint, til nokkurs hugverkaréttar er veitt af ST hér.
Endursala á ST vörum með öðrum ákvæðum en upplýsingarnar sem settar eru fram hér ógilda alla ábyrgð sem ST veitir fyrir slíka vöru.
ST og ST merkið eru vörumerki ST. Fyrir frekari upplýsingar um ST vörumerki, sjá www.st.com/trademarks. Öll önnur vöru- eða þjónustuheiti eru eign viðkomandi eigenda.
Upplýsingar í þessu skjali koma í stað og koma í stað upplýsinga sem áður hafa verið gefnar í fyrri útgáfum þessa skjals.
© 2023 STMicroelectronics – Allur réttur áskilinn
UM2548 – Rev 2
Skjöl / auðlindir
 |
STMicroelectronics UM2548 Linux bílstjóri [pdfNotendahandbók UM2548 Linux bílstjóri, UM2548, Linux bílstjóri, bílstjóri |
