STMicroelectronics UM2375 Linux Driver User Manual

Mokhanni oa STSW-ST25R009 Linux® o nolofalletsa Raspberry Pi 4 ho sebetsa le X-NUCLEO-NFC05A1, e nang le ST25R3911B sesebelisoa sa bokahohle sa NFC se sebetsang hantle.

Sephutheloana sena se kenya RF abstraction layer (RFAL) sethaleng sa Raspberry Pi 4 Linux ho sebetsa ka X-NUCLEO-NFC05A1 firmware. Sephutheloana se fana ka e leample ts'ebeliso ea ho bona mefuta e fapaneng ea NFC tags le mehala ea cellular e tšehetsang P2P. RFAL ke ST mokhanni ea tloaelehileng oa ST25R NFC/RFID Reader ICs ST25R3911B, ST25R3912, ST25R3913, ST25R3914 le ST25R3915. E sebelisoa, ka mohlala, ke firmware ea ST25R3911B-DISCO (STSW-ST25R002) le X-NUCLEONFC05A1 firmware (X-CUBE-NFC5).

STSW-ST25R009 e ts'ehetsa liprothokholo tsohle tsa ST25R3911B tse tlase le liprothokholo tse ling tse phahameng tsa puisano. RFAL e ngotsoe ka mokhoa o nkehang habonolo, kahoo e ka sebetsa ho lisebelisoa tse fapaneng tse thehiloeng ho Linux®. Tokomane ena e hlalosa kamoo laeborari ea RFAL e ka sebelisoang ho sistimi e tloaelehileng ea Linux (tabeng ena Raspberry Pi 4) bakeng sa puisano ea NFC/RF. Khoutu e nkehang habonolo ebile e sebetsa ka liphetoho tse nyane sethaleng sefe kapa sefe sa Linux.

Setšoantšo sa 1. RFAL laebrari sethaleng sa Linux

Fetileview

Likaroloana

Qetella mokhanni oa sebaka sa mosebelisi oa Linux (RF abstraction layer) ho aha lits'ebetso tse lumelletsoeng tsa NFC ho sebelisa ST25R3911B/ST25R391x li-frontend tsa NFC tse nang le matla a fihlang ho 1.4 W.

Puisano ea moamoheli oa Linux le ST25R3911B/ST25R391x e sebelisa sebopeho sa SPI
Tlatsa RF/NFC abstraction (RFAL) bakeng sa mahlale ohle a maholo le liprothokholo tse phahameng tsa layer:
- NFC-A (ISO14443-A)
- NFC-B (ISO14443-B)
- NFC-F (FeliCa™)
- NFC-V (ISO15693)
- P2P (ISO18092)
- ISO-DEP (ISO ea phapanyetsano ea data protocol, ISO14443-4)
- NFC-DEP (NFC data exchange protocol, ISO18092)
- Theknoloji ea thepa (Kovio, B', iClass, Calypso®, ...)

Sampts'ebetsong e fumanehang ka boto ea katoloso ea X-NUCLEO-NFC05A1, e hoketsoeng ho Raspberry Pi 4.
Sample sesebelisoa sa ho bona NFC tse 'maloa tag mefuta le mehala ea thekeng e tšehetsang P2P

Lipehelo tsa laesense tse bonolo tsa basebelisi

Moralo oa software

Setšoantšo sa 2 se bonts'a lintlha tsa meralo ea software ea laeborari ea RFAL sethaleng sa Linux®.

RFAL e nkeha habonolo ho li-platform tse ling ka ho fetola seo ho thoeng ke sethala files.

Hlooho file rfal_platform.h e na le litlhaloso tse kholo, tse hlokang ho fanoa le ho kengoa ts'ebetsong ke mong'a sethala. Ho feta moo, e fana ka litlhophiso tse ikhethileng tsa sethala joalo ka kabelo ea GPIO, lisebelisoa tsa sistimi, linotlolo le li-IRQ, tse hlokahalang bakeng sa ts'ebetso e nepahetseng ea RFAL.

Pontšo ena e kenya tšebetsong mesebetsi ea sethala mme e fana ka boema-kepe ba laeborari ea RFAL sebakeng sa basebelisi ba Linux®. Laeborari e arolelanoang file e hlahisoa, e sebelisoang ke sesebelisoa sa demo ho bonts'a mesebetsi e fanoeng ke lera la RFAL.

Moamoheli oa Linux® o sebelisa sebopeho sa sysfs se fumanehang sebakeng sa mosebelisi sa Linux® ho nolofalletsa puisano ea SPI ka sesebelisoa sa ST25R3911B. Ka hare ho Linux® kernel sebopeho sa SPI sysfs se sebelisa Linux® kernel driver spidev ho romela/ho amohela liforeimi tsa SPI ho/ho tloha ho ST25R3911B.

Bakeng sa ho sebetsana le mohala o sitisang oa ST25R3911B, mokhanni o sebelisa libgpiod ho tsebisoa ka liphetoho moleng ona.

Setšoantšo sa 2. Moralo oa software oa RFAL ho Linux

Ho hlophisoa ha Hardware

Sethala se sebedisoang

Boto ea Raspberry Pi 4 e nang le Raspberry Pi OS e sebelisoa e le sethala sa Linux ho aha laeborari ea RFAL le ho sebelisana le ST25R3911B holim'a SPI.
ST25R3911B e thusa sesebelisoa sethaleng sa Linux ho lemoha le ho buisana le lisebelisoa tsa NFC.

Litlhoko tsa lisebelisoa

Raspberry Pi 4
8 GBytes karete ea SD e nyane ho qala Raspberry Pi OS
Sebali sa karete ea SD
Boto ea borokho ho hokahanya X-NUCLEO-NFC05A1 le Raspberry Pi Arduino Adapter bakeng sa Raspberry Pi, karolo ea karolo ea ARPI600.
X-NUCLEO-NFC05A1. Sheba litlhoko tsa morao-rao tsa Raspberry Pi OS.

Likhokahano tsa Hardware

ARPI600 Raspberry Pi to Arduino adapter board e sebelisoa ho hokahanya X-NUCLEO-NFC05A1 le Raspberry Pi. Hoa hlokahala ho fetola li-jumpers tsa boto ea adapter ho e hokahanya le X-NUCLEO-NFC05A1.

Tlhokomeliso: ARPI600 e fana ka 5 V ka phoso ho pin ea Arduino IOREF. Ho hokela X-NUCLEO-NFC05A1 ka kotloloho ho fepa 5 V ho lithakhisa tse ling, sena se ka senya boto ea Raspberry Pi. Ho na le litlaleho haholo-holo tsa hore Raspberry Pi 4B+ e hlile e senngoa. Ho qoba boemo bona, fetola ARPI600 (ts'ebetso e thata) kapa X-NUCLEO-NFC05A1 (ts'ebetso e bonolo haholoanyane).

Tsela e bonolo ka ho fetisisa ea ho lokisa ke ho khaola phini ea CN6.2 (IOREF) ho X-NUCLEO-NFC05A1 joalokaha ho bontšitsoe setšoantšong sa 3.

Ho khaola pin ena ha ho ame ts'ebetso hammoho le mapolanka a Nucleo (NUCLEO-L474RG, NUCLEO-F401RE, NUCLEO-8S208RB, joalo-joalo).

Setšoantšo sa 3. Tokiso ea khokahanyo ea lisebelisoa

Setlhophiso sa jumper

Li-jumpers tsa A5, A4, A3, A2, A1 le A0 tse bontšitsoeng ho Setšoantšo sa 4 li tlameha ho fetoloa ho P23, P22, P21 le CE1. Ka litlhophiso tsena tsa jumper, nomoro ea 7 ea GPIO ea Raspberry e sebelisoa e le mohala oa tšitiso bakeng sa X-NUCLEO-NFC05A1.

Setšoantšo sa 4. Boemo ba li-jumpers A5, A4, A3, A2, A1 le A0 holim'a boto ea adaptara.

Hajoale, boema-kepe bona ba laeborari ea RFAL bo sebelisa pin GPIO7 joalo ka mola oa tšitiso, ho latela litlhophiso tsa jumper. Haeba ho na le tlhokahalo ea ho fetola mohala oa tšitiso ho tloha GPIO7 ho ea ho GPIO e fapaneng, khoutu e khethehileng ea sethaleng (ho file plf_gpio.h) e hloka ho fetoloa ho fetola tlhaloso ea macro "ST25R_INT_PIN" ho tloha ho 7 ho isa ho pin e ncha ea GPIO, e tla sebelisoa e le mohala oa ho senya.

Ka litlhophiso tse kaholimo tsa jumper, boto ea adaptara e ka sebelisoa ho hokahanya X-NUCLEO-NFC05A1 le boto ea Raspberry Pi joalo ka ha ho bonts'itsoe ho Setšoantšo sa 5.

Setšoantšo sa 5. Hardware setup top view

Setšoantšo sa 6. Lehlakore la ho seta hardware view

Ho seta tikoloho ea Linux

Ho qala ha Raspberry Pi

Ho theha tikoloho ea Linux, mohato oa pele ke ho kenya le ho qalisa Raspberry Pi 4 ka Raspberry Pi OS joalokaha ho hlalositsoe ka tlase:

Mohato oa 1

Khoasolla setšoantšo sa morao-rao sa Raspberry Pi OS sehokelong:

https://www.raspberrypi.com

Khetha Raspberry Pi OS e nang le desktop. Bakeng sa liteko tse ka tlase ho sebelisitsoe mofuta o latelang: Loetse 2022 (2022-09-22-raspios-bullseye-armhf.img.xz).

Mohato oa 2

Unzip setšoantšo sa Raspberry Pi 'me u se ngole kareteng ea SD ka ho latela litaelo tse fumanehang karolong e bitsoang "Ho ngola setšoantšo ho karete ea SD".

Mohato oa 3

Hokela hardware:

Hokela Raspberry Pi ho sebali o sebelisa thapo e tloaelehileng ea HDMI.

Hokela mouse le keyboard ho likoung tsa USB tsa Raspberry Pi.

Hape hoa khoneha ho sebetsa le Raspberry Pi u sebelisa ssh. Boemong bo joalo ha ho hlokahale ho hokela sebali, keyboard le mouse ka Raspberry Pi. Ntho feela e hlokahalang ke ho ba le PC e nang le ssh kahare ho marang-rang a tšoanang le a Raspberry Pi le ho lokisa aterese ea IP ka nepo.

Mohato oa 4

Qala Raspberry Pi ka karete ea SD.

Kamora ho qala, komporo ea Linux e thehiloeng ho Debian e hlaha ka leihlo.

Tlhokomeliso: Ka linako tse ling, hoa hlokomeleha hore ka mor'a ho qala Raspberry Pi, linotlolo tse ling tsa keyboard ha li sebetse. Ho etsa hore li sebetse, bula file ea file / joalo-joalo/ default/keyboard ebe u beha XKBLAYOUT = "rona" 'me u qalise Raspberry Pi hape.

Numella SPI ho Raspberry Pi

Mokhanni oa SPI ka hare ho kernel o buisana le X-NUCLEO-NFC05A1 ka SPI. Ho bohlokoa ho hlahloba hore na SPI e se e ntse e sebelisoa ho Raspberry Pi OS/kernel tlhophiso.
Sheba hore na /dev/spidev0.0 e bonahala tikolohong ea Raspberry Pi. Haeba e sa bonahale, etsa hore sebopeho sa SPI se sebelise "raspi-config" ka ho latela mehato e hlalositsoeng ka tlase.

Mohato oa 1

Bula terminal e ncha ho Raspberry Pi 'me u tsamaise taelo ea "raspi-config" joalo ka motso:

sudo raspi-config

Mohato ona o bula sebopeho sa graphical.

Mohato oa 2

Khetha ka har'a sebopeho sa graphical khetho e bitsoang "Interfacing Options".

Mohato oa 3

Mohato ona o thathamisa likhetho tse fapaneng.
Khetha khetho e bitsoang "SPI".
Ho hlaha fensetere e ncha e nang le mongolo o latelang:
"Na u ka rata hore sebopeho sa SPI se khonehe?"

Mohato oa 4

Khetha fensetereng ena ho nolofalletsa SPI.

Mohato oa 5

Qala hape Raspberry Pi.
Mehato e kaholimo e tla thusa sebopeho sa SPI tikolohong ea Raspberry Pi kamora ho qala bocha.

Haha laeborari ea RFAL le ts'ebeliso

RFAL demo ea Linux e fanoe sebakeng sa polokelo. Ha re nke hore lebitso la eona ke:
ST25R3911B_v2.8.0_Linux_demo_v1.0.tar.xz.
Ho aha laeborari ea RFAL le ts'ebeliso ho Raspberry Pi, latela mehato e ka tlase:

Mohato oa 1

Unzip sephutheloana ho Raspberry Pi u sebelisa taelo e ka tlase ho tsoa bukeng ea lapeng:

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

Mohato oa 2

Haeba e sa etsoa pele, kenya cmake, u sebelisa taelo e ka tlase:

apt-fumana kenya cmake

Laeborari ea RFAL le sistimi ea kaho ea ts'ebeliso e thehiloe ho cmake, ka lebaka lena ho hlokahala ho kenya cmake bakeng sa ho bokella sephutheloana.

Mohato oa 3

Ho aha laeborari ea RFAL le ts'ebeliso, ea ho "build" directory:

cd ST25R3911B_v2.8.0_Linux_demo_v1.0/Linux_demo/build

'me u tsamaise taelo e ka tlase ho tloha moo:

cme..

Taelong e ka holimo ".." e bontša hore boemo bo holimo CMakeLists.txt bo teng bukeng ea motsoali, ke hore.
ST25R3911B_v2.8.0_Linux_demo_v1.0.

Taelo ea cmake e theha makefile e sebelisoang mohatong o latelang ho aha laebrari le ts'ebeliso.

Mohato oa 4

Etsa taelo ea "etsa" ho aha laeborari ea RFAL le ts'ebeliso:

etsa

Taelo ea "etsa" e qala ka ho haha laebrari ea RFAL ebe e theha kopo holim'a eona.

Mokhoa oa ho tsamaisa kopo

Kaho e atlehileng e hlahisa "nfc_demo_st25r3911b" e ka phethisoang sebakeng se latelang:
/build/application.

Ka ho sa feleng, ts'ebeliso e tlameha ho tsamaisoa ka litokelo tsa metso ho tloha tseleng: ST25R3911B_v2.8.0_Linux_demo_v1.0/linux_demo/build:

sudo ./demo/nfc_demo_st25r3911b

Kopo e qala ho khetha NFC tags le mehala ea cellular. E bonts'a lisebelisoa tse fumanoeng ka UID ea tsona joalo ka ha ho bonts'itsoe ho Setšoantšo sa 7.

Setšoantšo sa 7. Pontšo ea lisebelisoa tse fumanoeng

Ho emisa ts'ebeliso, tobetsa Ctrl + C.

Nalane ea ntlafatso

Lethathamo la 1. Histori ea ntlafatso ea litokomane

Lethathamo la litafole

Lethathamo la 1. Histori ea ntlafatso ea litokomane. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Lenane la lipalo

Setšoantšo sa 1. RFAL laebrari sethaleng sa Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Setšoantšo sa 2. Moralo oa software oa RFAL Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Setšoantšo sa 3. Tokiso ea khokahanyo ea lisebelisoa. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Setšoantšo sa 4. Boemo ba li-jumpers A5, A4, A3, A2, A1 le A0 holim'a boto ea adapter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Setšoantšo sa 5. Hardware setup top view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Setšoantšo sa 6. Lehlakore la ho seta hardware view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Setšoantšo sa 7. Pontšo ea lisebelisoa tse fumanoeng. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

TSEBISO EA BOHLOKOA – BALA KA HLOKO

STMicroelectronics NV le li-subsidiary tsa eona ("ST") li na le tokelo ea ho etsa liphetoho, litokiso, lintlafatso, lintlafatso, le lintlafatso ho lihlahisoa tsa ST le/kapa tokomaneng ena ka nako efe kapa efe ntle le tsebiso. Bareki ba lokela ho fumana lintlha tsa morao-rao tse amanang le lihlahisoa tsa ST pele ba fana ka litaelo. Lihlahisoa tsa ST li rekisoa ho latela lipehelo le maemo a thekiso ea ST ka nako ea tumello ea taelo.

Bareki ke bona feela ba ikarabellang bakeng sa khetho, khetho, le tšebeliso ea lihlahisoa tsa ST mme ST ha e nke e le molato bakeng sa thuso ea kopo kapa moralo oa lihlahisoa tsa bareki.

Ha ho laesense, e hlalositsoeng kapa e boletsoeng, ea tokelo efe kapa efe ea thepa ea mahlale e fanoeng ke ST mona.

Ho rekisoa ha lihlahisoa tsa ST ka litokisetso tse fapaneng le tlhahisoleseding e boletsoeng mona ho tla hlakola waranti leha e le efe e fanoeng ke ST bakeng sa sehlahisoa se joalo.

ST le logo ea ST ke matšoao a khoebo a ST. Bakeng sa lintlha tse ling mabapi le matšoao a khoebo a ST, sheba ho www.st.com/trademarks. Mabitso a mang kaofela a lihlahisoa kapa litšebeletso ke thepa ea beng ba tsona.

Lintlha tse tokomaneng ena li nkela sebaka le ho nkela tlhahisoleseding e neng e fanoe pele liphetolelong tsa pele tsa tokomane ena.

Litokomane / Lisebelisoa

STMicroelectronics UM2375 Linux Driver [pdf] Bukana ea Mosebelisi
UM2375 Linux Driver, UM2375, Linux Driver, Driver

Litšupiso

Bukana ea Mosebelisi