STMicroelectronics UM2375 Linux Driver User Manual

Ka utaina e tenei kete te paparanga tangohanga RF (RFAL) ki runga i te papaaapapa Raspberry Pi 4 Linux hei mahi me te miihini X-NUCLEO-NFC05A1. Ka whakaratohia e te putea heiampte tono ki te kimi i nga momo NFC tags me nga waea pūkoro e tautoko ana i te P2P. Ko te RFAL te taraiwa paerewa ST mo ST25R NFC/RFID Reader ICs ST25R3911B, ST25R3912, ST25R3913, ST25R3914 me ST25R3915. Ka whakamahia, hei tauira, na te ST25R3911B-DISCO firmware (STSW-ST25R002) me te X-NUCLEONFC05A1 firmware (X-CUBE-NFC5).

Kei te tautoko a STSW-ST25R009 i nga kawa papa-raro katoa o ST25R3911B me etahi kawa paparanga teitei ake mo te whakawhitiwhiti korero. Kua tuhia te RFAL i roto i te tikanga kawe, na reira ka taea te whakahaere i runga i te tini o nga taputapu i runga i te Linux®. Ko tenei tuhinga e whakaatu ana me pehea te whakamahi i te whare pukapuka RFAL i runga i te punaha Linux paerewa (i tenei keehi ko te Raspberry Pi 4) mo te whakawhitiwhiti korero NFC/RF. He tino kawe te waehere me te mahi me nga huringa iti i runga i tetahi papaaho Linux.

Whakaahua 1. whare pukapuka RFAL i runga i te papaaho Linux

Ka mutuview

Ngā āhuatanga

Whakaotia te atekōkiri mokowā kaiwhakamahi Linux (papanga tangohanga RF) ki te hanga i nga tono whakaahei NFC ma te whakamahi i te ST25R3911B/ST25R391x o mua NFC mahi teitei tae atu ki te 1.4 W te mana whakaputa.
Ko te whakawhitiwhiti korero a te kaihautu Linux me te ST25R3911B/ST25R391x ma te whakamahi i te atanga SPI
Whakaotia te tangohanga RF/NFC (RFAL) mo nga hangarau nui katoa me nga tikanga paparanga teitei ake:
- NFC-A (ISO14443-A)
- NFC-B (ISO14443-B)
- NFC-F (FeliCa™)
- NFC-V (ISO15693)
- P2P (ISO18092)
- ISO-DEP (Kawa whakawhiti raraunga ISO, ISO14443-4)
- NFC-DEP (kawa whakawhiti raraunga NFC, ISO18092)
- Hangarau motuhake (Kovio, B', iClass, Calypso®, …)
SampKo te whakatinanatanga e waatea ana me te papa roha X-NUCLEO-NFC05A1, kua honoa ki te Raspberry Pi 4
Sampte tono ki te kite i etahi NFC tag momo me waea pūkoro tautoko P2P
Ko nga kupu raihana hoa-kaiwhakamahi kore utu

Te hoahoanga rorohiko

Ko te Whakaahua 2 e whakaatu ana i nga taipitopito hoahoanga rorohiko o te whare pukapuka RFAL i runga i te papaaho Linux®.

Ko te RFAL he ngawari ki te kawe ki etahi atu papaarangi ma te whakarereke i te waahanga e kiia nei files.

Ko te pane file rfal_platform.h kei roto nga whakamaramatanga tonotono, me whakarato me te whakatinana e te rangatira o te papaaho. I tua atu, ka whakaratohia e ia nga waahanga motuhake penei i te mahi GPIO, nga rauemi punaha, nga kati me nga IRQ, e hiahiatia ana mo te mahi tika o te RFAL.

Ko tenei whakaaturanga e whakatinana ana i nga mahi papaaho me te whakarato i tetahi tauranga o te whare pukapuka RFAL ki te waahi kaiwhakamahi o Linux®. He whare pukapuka tiritahi file ka hangaia, ka whakamahia e te tono demo hei whakaatu i nga mahi e whakaratohia ana e te paparanga RFAL.

Ka whakamahia e te kaihautu Linux® te atanga sysfs e waatea ana mai i te waahi kaiwhakamahi Linux® kia taea ai te whakawhitiwhiti korero a SPI me te taputapu ST25R3911B. I roto i te kakano Linux® ka whakamahia e te atanga sysfs SPI te kaitaraiwa taraiwa Linux® ki te tuku/tango anga SPI ki/mai i ST25R3911B.

Mo te whakahaere i te raina haukoti o ST25R3911B, ka whakamahia e te taraiwa te libgpiod hei whakamohio mo nga huringa o tenei raina.

Whakaahua 2. Hanganga rorohiko RFAL i runga i te Linux

Tatūnga pūmārō

I whakamahia te papa

He papa Raspberry Pi 4 me te Raspberry Pi OS e whakamahia ana hei papaaho Linux hei hanga whare pukapuka RFAL me te taunekeneke ki a ST25R3911B i runga i te SPI.
Ka taea e ST25R3911B te tono i runga i te papaaho Linux ki te kimi me te korero ki nga taputapu NFC.

Nga whakaritenga taputapu

Rahipere Pi 4
8 GBytes moroiti kāri SD ki te whakaara Raspberry Pi OS
Kaipānui kāri SD
Papa piriti hei hono i te X-NUCLEO-NFC05A1 me te Raspberry Pi Arduino Adapter mo te Raspberry Pi, te nama wahanga ARPI600.
X-NUCLEO-NFC05A1. Tirohia nga whakaritenga hou o te Raspberry Pi OS.

Hononga taputapu

Ko te ARPI600 Raspberry Pi ki te Arduino adapter board ka whakamahia hei hono i te X-NUCLEO-NFC05A1 me te Raspberry Pi. E hiahiatia ana ki te whakarereke i nga peke o te papa urutau ki te hono atu ki te X-NUCLEO-NFC05A1.

Tupato: Ko te ARPI600 i hē te tuku 5 V ki te titi Arduino IOREF. Ko te taapiri tika i te X-NUCLEO-NFC05A1 ka whakahoki i te 5 V ki etahi titi, ka kino pea te papa Raspberry Pi. He purongo rawa mo te Raspberry Pi 4B+ e tino whakangaromia ana. Hei karo i tenei ahuatanga, urutauhia te ARPI600 (he mahi uaua) te X-NUCLEO-NFC05A1 ranei (he ngawari ake te mahi).

Ko te whakatika ngawari ko te tapahi i te titi CN6.2 (IOREF) ki te X-NUCLEO-NFC05A1 e whakaatuhia ana i te Whakaahua 3.

Ko te tapahi i tenei titi kaore e pa ki te mahi i te taha o nga papa Nucleo (NUCLEO-L474RG, NUCLEO-F401RE, NUCLEO-8S208RB, me etahi atu).

Whakaahua 3. Whakatika hononga taputapu

Tautuhinga pekepeke

Ko nga pekepeke mo A5, A4, A3, A2, A1 me A0 e whakaatuhia ana i te Whakaahua 4 me huri ki P23, P22, P21 me CE1. Ma enei tautuhinga pekepeke, ka whakamahia te nama titi GPIO 7 a Raspberry hei raina haukoti mo X-NUCLEO-NFC05A1.

Whakaahua 4. Te tuunga o nga pekepeke A5, A4, A3, A2, A1 me A0 i runga i te papa urutau

I tenei wa, ka whakamahia e tenei tauranga whare pukapuka RFAL te titi GPIO7 hei raina haukoti, e ai ki nga tautuhinga pekepeke. Mena he hiahia ki te huri i te raina haukoti mai i te GPIO7 ki te GPIO rereke, ko te waehere motuhake o te papa (i roto file plf_gpio.h) me whakarereke hei huri i te whakamaramatanga o te tonotono "ST25R_INT_PIN" mai i te 7 ki te titi GPIO hou, hei whakamahi hei raina haukoti.

Ma nga tautuhinga pekepeke i runga ake nei, ka taea te whakamahi i te papa urutau ki te hono X-NUCLEO-NFC05A1 me te papa Raspberry Pi e whakaatuhia ana i te Whakaahua 5.

Whakaahua 5. Te tihi tatūnga taputapu view

Whakaahua 6. Te taha tatūnga taputapu view

Tatūnga taiao Linux

Te Whakaoho o te Raspberry Pi

Hei whakarite i te taiao Linux, ko te mahi tuatahi ko te whakauru me te whakaara i te Raspberry Pi 4 me te Raspberry Pi OS penei i te whakamarama i raro nei:

Hipanga 1

Tangohia te ahua hou o te Raspberry Pi OS mai i te hono:

https://www.raspberrypi.com

Kōwhirihia te Raspberry Pi OS me te papamahi. Mo nga whakamatautau i raro iho i whakamahia te putanga e whai ake nei: Mahuru 2022 (2022-09-22-raspios-bullseye-armhf.img.xz).

Hipanga 2

Wewetehia te ahua Raspberry Pi ka tuhia ki roto i te kaari SD ma te whai i nga tohutohu e waatea ana i te waahanga ko "Te tuhi whakaahua ki te kaari SD".

Hipanga 3

Honoa te taputapu:

Honoa te Raspberry Pi ki te aroturuki ma te whakamahi i te taura HDMI paerewa.
Honoa te kiore me te papapātuhi ki nga tauranga USB a Raspberry Pi.

Ka taea hoki te mahi me te Raspberry Pi ma te whakamahi i te ssh. I roto i tera keehi kaore e hiahiatia kia hono atu te aroturuki, te papapātuhi me te kiore me te Raspberry Pi. Ko te hiahia anake ko te whai i te PC me te ssh i roto i te whatunga rite ki te Raspberry Pi me te whirihora i te wahitau IP kia rite.

Hipanga 4

Whakaarahia te Raspberry Pi me te kaari SD.

I muri i te whakaoho, ka puta mai he papamahi Linux i runga Debian i runga i te aroturuki.

Tuhipoka: I etahi wa, ka kitea i muri i te whakaoho i te Raspberry Pi, kaore e mahi etahi taviri papapātuhi. Kia mahi ai ratou, whakatuwheratia te file /etc/default/keyboard ka tautuhi XKBLAYOUT=”tatou” ka whakaara ano i te Raspberry Pi.

Whakahohe SPI i runga i te Raspberry Pi

Ko te taraiwa SPI i roto i te kernel ka korero ki a X-NUCLEO-NFC05A1 ma te SPI. He mea nui ki te tirotiro mena kua whakahohea kee te SPI i te whirihoranga Raspberry Pi OS/kernel.
Tirohia mehemea ka kitea /dev/spidev0.0 i te taiao Raspberry Pi. Ki te kore e kitea, whakaaheitia te atanga SPI ma te whakamahi i te whaipainga "raspi-config" ma te whai i nga hikoinga e whakaahuatia ana i raro nei.

Hipanga 1

Whakatuwherahia he tauranga hou i runga i te Raspberry Pi ka whakahaere i te whakahau "raspi-config" hei pakiaka:

sudo raspi-config

Ka whakatuwherahia e tenei taahiraa he atanga kauwhata.

Hipanga 2

Tīpakohia i roto i te atanga kauwhata te kōwhiringa i tapaina ko "Kōwhiringa Whakawhitinga".

Hipanga 3

Ka whakarārangihia e tenei taahiraa nga momo whiringa.
Tīpakohia te kōwhiringa ko "SPI".
Ka puta he matapihi hou me nga kupu e whai ake nei:
"Kei te pirangi koe kia taea te atanga SPI?"

Hipanga 4

Tīpakohia i tenei matapihi kia taea ai te SPI.

Hipanga 5

Whakahouhia te Raspberry Pi.
Ko nga mahi i runga ake nei ka taea te atanga SPI ki te taiao Raspberry Pi i muri i te whakaara ano.

Te hanga whare pukapuka RFAL me te tono

Ko te demo RFAL o Linux e whakaratohia ana i roto i te puranga. Me whakaaro tatou ko tona ingoa:
ST25R3911B_v2.8.0_Linux_demo_v1.0.tar.xz.
Hei hanga i te whare pukapuka RFAL me te tono i runga i te Raspberry Pi, whai i nga waahanga e whai ake nei:

Hipanga 1

Wewetehia te kete i runga i te Raspberry Pi ma te whakamahi i te whakahau i raro nei mai i te raarangi kaainga:

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

Hipanga 2

Mena kaore i mahia i mua, whakauruhia te cmake, ma te whakamahi i te whakahau i raro nei:

apt-tiki tāuta cmake

Ko te whare pukapuka RFAL me te punaha hanga tono kei runga i te cmake, na konei me whakauru te cmake mo te whakahiato o te kete.

Hipanga 3

Hei hanga i te whare pukapuka RFAL me te tono, haere ki te raarangi "hanga":

cd ST25R3911B_v2.8.0_Linux_demo_v1.0/Linux_demo/build

ka whakahaere i te whakahau i raro mai i reira:

cmake..

I roto i te whakahau i runga ake nei “..” e tohu ana kei te taumata teitei CMakeLists.txt kei roto i te raarangi matua, ara.
ST25R3911B_v2.8.0_Linux_demo_v1.0.

Ko te whakahau cmake te hanga hangafile ka whakamahia i roto i te taahiraa e whai ake nei ki te hanga whare pukapuka me te tono.

Hipanga 4

Whakahaerehia te whakahau "hanga" ki te hanga i te whare pukapuka RFAL me te tono:

hanga

Ko te whakahau "hanga" ka hanga tuatahi te whare pukapuka RFAL katahi ka hanga te tono ki runga ake.

Me pehea te whakahaere i te tono

Ko te hanga-hanga angitu ka whakaputa i te ingoa ko "nfc_demo_st25r3911b" kei te waahi e whai ake nei:
/build/applications.

Ma te taunoa me whakahaere te tono me nga mana pakiaka mai i te ara: ST25R3911B_v2.8.0_Linux_demo_v1.0/linux_demo/build:

sudo ./demo/nfc_demo_st25r3911b

Ka timata te tono ki te pooti mo te NFC tags me nga waea pūkoro. Ka whakaatuhia nga taputapu kua kitea me o raatau UID penei i te Whakaaturanga 7.

Whakaahua 7. Whakaaturanga o nga taputapu kua kitea

Hei whakamutu i te tono, pehia Ctrl + C.

Hītori arotakenga

Ripanga 1. Tuhinga o mua whakahounga

Rarangi o nga ripanga

Ripanga 1. Tuhinga o mua whakahounga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Rarangi o nga whika

Whakaahua 1. whare pukapuka RFAL i runga i te papaaho Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Whakaatu 2. Hanganga rorohiko RFAL i runga i te Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Whakaahua 3. Whakatika hononga taputapu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Whakaahua 4. Te tuunga o nga pekepeke A5, A4, A3, A2, A1 me A0 i runga i te papa urutau. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Whakaahua 5. Te tihi tatūnga taputapu view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Whakaahua 6. Te taha tatūnga taputapu view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Whakaahua 7. Whakaaturanga o nga taputapu kua kitea. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

WHAKAMAHI WHAKAMAHI - KAUPAPA KAUPAPA

Ko te STMicroelectronics NV me ona apiti ("ST") te mana ki te whakarereke, whakatikatika, whakapainga, whakarereke me nga whakapainga ki nga hua ST me tenei tuhinga ranei i nga wa katoa kaore he panui. Me whiwhi nga kaihoko i nga korero hou e pa ana ki nga hua ST i mua i te tuku ota. Ka hokona nga hua ST i runga i nga tikanga me nga tikanga o te hokonga a ST i te wa o te ota whakaae.

Ko nga Kaihoko anake te kawenga mo te kowhiringa, te kowhiringa me te whakamahi i nga hua ST me te ST karekau he kawenga mo te awhina tono me te hoahoa o nga hua a nga kaihoko.

Karekau he raihana, he mea whakaatu, he tohu ranei, ki tetahi mana taonga hinengaro ka tukuna e ST i konei.

Ko te hokonga ano o nga hua ST me nga tikanga rereke mai i nga korero kua whakatakotoria i konei ka whakakorehia he raihana kua tukuna e ST mo taua hua.

Ko te ST me te tohu ST he tohu tohu na ST. Mo etahi atu korero mo nga tohu hokohoko ST, tirohia www.st.com/marks. Ko etahi atu ingoa hua, ingoa ratonga ranei no ratou ake rangatira.

Ko nga korero kei roto i tenei tuhinga ka whakakapi me te whakakapi i nga korero i tukuna i mua i nga momo putanga o mua o tenei tuhinga.

Tuhinga / Rauemi

UM2375 Linux Atekōkiri

User Manual · UM2375 Linux Driver, UM2375, Linux Driver, Driver

Tohutoro

Pukapuka Kaiwhakamahimanual.tools

Whakaputaina: Mei 11, 2023

Whakahoutia: Hōngongoi 5, 2023

STMicroelectronics UM2375 Linux Atekōkiri Kaiwhakamahi Manual