UM3078 ST25DVXXKC Linux User Space Driver

Isingeniso

Lo mbhalo ubonisa indlela yokusebenzisa iphakheji yesofthiwe ye-STSW-ST25DV009 ukuze ulawule i-ST25DVXXKC eguquguqukayo ye-NFC tag kusuka kungxenyekazi ye-Linux®. Iphakheji yesofthiwe ye-STSW-ST25DV009 ihlinzeka ngomshayeli wesikhala somsebenzisi we-Linux® kanye nabanye examplezo ezingalungiselelwa ukusebenza kunoma iyiphi iplathifomu ye-Linux®. I-ST25DVXXKC iyi-NFC enamandla tag, engaphathwa ngumfundi we-RFID noma ngefoni ye-NFC, futhi inokuxhumana kwe-I2C ukuxhumana ne-MCU noma i-MPU. I-ST25DVXXKC iyatholakala, ngokwesiboneloample, ebhodini lokunweba le-X-NUCLEO-NFC07A1. Ulwazi nemibhalo ehlobene nezingxenye ze-NFC, ibhodi lokunweba le-X-NUCLEO‑NFC07A1 kanye nesofthiwe ye-STSWST25DV009 kuyatholakala ku- www.st.com.

Inhloso

I-ST25DVXXKC i-NFC/RFID enamandla tags amasekethe ahlanganisiwe angaxhumana nakho kokubili:

• Abafundi be-RFID namafoni e-NFC, asekelwe ku-ISO/IEC 15693 kanye ne-NFC Forum Type 5 tag imininingwane.
• I-MCU noma i-MPU esebenzisa isixhumi esibonakalayo se-I2C.

Lawa madivaysi angasetshenziswa kuplathifomu ye-Linux ukunika amandla ukuxhumana okungenantambo, ukudlulisa kalula idatha isuka ku-Linux iyise ku-smartphone (isibonelo: URL, izixhumanisi ze-GPS, idatha yokumatanisa ye-Off-Off-Band, njalonjalo). Iphakheji yesofthiwe ye-STSW‑ST25DV009 inikeza ikhodi edingekayo ukuze ulawule idivayisi ye-ST25DVXXKC kusuka endaweni yomsebenzisi weplathifomu ye-Linux enesilawuli se-I2C.

Isakhiwo sesofthiwe

Isofthiwe ye-STSW-ST25DV009 ihlukaniswe ngezigaba ezimbalwa:

• ST25DVXXKC umshayeli wengxenye
• Iphakethe losekelo lwebhodi
• I-NDEF library middleware
• Sampamakhodi wephrojekthi

ST25DVXXKC umshayeli wengxenye
Umshayeli wengxenye ye-ST25DVXXKC unikeza izindlela zokumisa nokulawula idivayisi ye-ST25DVXXKC. Le ngxenye yekhodi izimele ku-hardware, futhi idinga imisebenzi ethile eyisisekelo ye-IO ukuthi isetshenziswe (bona iphakheji yosekelo yeBhodi Lesigaba 2.2) njenge-I2C yokufunda/ukubhala, isilawuli se-gpio. Umshayeli wengxenye ye-ST25DVXXKC files aku-Driver/BSP/Components/ST25DVxxKC lwemibhalo.

Iphakethe losekelo lwebhodi
Iphakethe lokusekelwa kwebhodi lisebenzisa izici ezimbili ezihlukene:

• Imisebenzi yeleveli ephansi ye-IO ebizwa umshayeli wengxenye ye-ST25DVXXKC
• I-API eya ezindleleni zomshayeli zengxenye ye-ST25DVXXKC

Iphakethe lokusekela ibhodi files iku-Driver/BSP/Linux directory.

Imisebenzi yeleveli ephansi ye-IO
Isendlalelo sezinga eliphansi le-IO lisebenzisa yonke imisebenzi yeleveli ephansi edingwa umshayeli we-ST25DVXXKC. Lesi sendlalelo sisetshenziswa kuhla lwemibhalo lwabashayeli/i-BSP/Linux nge- filekuchazwe kuThebula 1.

Files	Incazelo
	Lezi files isebenzise imisebenzi ukuze:
st25dv-i2c_linux.c	• Lungiselela, funda futhi ubhale isixhumi esibonakalayo se-I2C
st25dv-i2c_linux.h	• Thola umakhi we-millisecond
	Le khodi incike kufayela /dev/i2c-X file ukuthatha ukulawula kwe-I2C peripheral.
st25dv-i2c-gpo.c st25dv-i2c-gpo.h	Lezi files isebenzise imisebenzi ukuze ilungiselele futhi yamukele iziphazamiso kusukela kuphinikhodi ye-GPO ye-ST25DVXXKC. Le khodi isebenzisa /dev/gpiochipX file kanye nochungechunge oluzinikele lokuvotela umcimbi ku-GPIO.
st25dv-i2c-lpd.c st25dv-i2c-lpd.h	Lezi files sebenzisa imisebenzi yokumisa nokulawula iphinikhodi yamandla aphansi we-ST25DVXXKC. Le khodi isebenzisa okulandelayo files ukulawula i-GPIO: •/sys/class/gpio/export •/sys/class/gpio/gpioXX/direction • /sys/class/gpio/gpioXX/value.

Le misebenzi iqondene ngqo nebhodi elisetshenziswayo futhi kufanele ihambisane nesiteji lapho isetshenziswa khona (bheka Isigaba 3 Indlela yokumisa ibhodi).

I-API eya ezindleleni zomshayeli ze-ST25DVXXKC
Le API iwukugoqa kuphela umshayeli wengxenye ye-ST25DVXXKC. Isetshenziswa kokuthi Drivers/BSP/Linux/bsp_nfctag.c kanye ne-Drivers/BSP/Linux/bsp_nfctag.h files.

I-NDEF library middleware
Iforamu ye-NFC ichaza ifomethi evamile ongayisebenzisa lapho ufunda/ubhala idivayisi ye-NFC. Le fomethi yaziwa ngokuthi
Imiyalezo ye-NDEF. Umtapo wezincwadi we-NDEF usebenzisa izindlela ezisezingeni eliphezulu zokufometha kalula idatha ibe ethobelana ne-NDEF
indlela. Lo mtapo wezincwadi we-STMicroelectronics ulethwa njenge-middleware, ezimele ngokugcwele ku-hardware kanye
iza ne-interface file ezosetshenziswa endaweni ehlosiwe.
Kuphakheji yesofthiwe ye-STSW-ST25DV009 lezi zixhumi ezibonakalayo files zenziwa ku:

• Amaphrojekthi\NDEF_URI\Src\lib_NDEF_config.c
• Amaphrojekthi\NDEF_BLUETOOTH\Src\lib_NDEF_config.c

I-NDEF library middleware files akuluhlu lwemibhalo lwe-Middlewares/ST/lib_nfc

Sample amaphrojekthi
Kulesi sigaba, i-over ifushaneview kwe sampamaphrojekthi afakwe kuphakethe le-STSW-ST25DV009 anikeziwe. I-sampamaphrojekthi:

• kufanele iguqulelwe endaweni eqondisiwe ye-Linux (njengoba kuchazwe eSigabeni sesi-3 Limiswa kanjani ibhodi)
• bonisa kumsebenzisi ukuthi asetshenziswa kanjani ama-API ukuze aqalise kahle futhi asebenzise i-NFC/RFID enamandla tag I-IC (ST25DVxxKC idivayisi)

I-sampamaphrojekthi asohlwini lwemibhalo lwe-./Projects.

• NDEF_URI
  Lolu hlelo lokusebenza lubonisa ukuthi ubhalwa kanjani umlayezo olula we-URI NDEF ku-ST25DVXXKC EEPROM usebenzisa i-NDEF lib middleware. Umlayezo uyavezwa uma umyalezo ubhalwe ngempumelelo. I-smartphone noma isifundi se-NFC singasetshenziswa ukufunda umlayezo we-NDEF_URI.
• NDEF_BLUETOOTH
  Lolu hlelo lokusebenza lubonisa ukuthi ubhalwa kanjani umlayezo we-Bluetooth® OOB NDEF ku-ST25DVXXKC EEPROM usebenzisa i-NDEF lib middleware. Umlayezo uyavezwa uma umyalezo ubhalwe ngempumelelo. I-smartphone noma isifundi se-NFC singasetshenziswa ukufunda umlayezo we-NDEF_BLUETOOTH.
• I-GPO (inhloso evamile okukhiphayo)
  Lesi exampi-le ikhombisa ukuthi ungayivula kanjani futhi uyisebenzise kanjani i-GPO. Ngemva kokuqaliswa, ukuphazamiseka kuhlelwa ukuze kutholwe izinguquko zenkambu eduze kwe-ST25DVXXKC. Umlayezo uyavezwa lapho inkambu itholwa nalapho inkambu inyamalala.
• I2CPROTECTION
  Lesi exampi-le ikhombisa ukuthi zingakha kanjani izindawo ku-ST25DVXXKC nokuthi ungazivikela kanjani. Umbhalo uboniswa kukhonsoli.
• I-LPD (amandla aphansi phansi)
  Lesi exampi-le ikhombisa indlela yokusebenzisa iphinikhodi ye-low power down (LPD). Ngokufaka u-“1” noma “0”, iphinikhodi ye-LPD iyacushwa noma iyekiswe ukusebenza. Uma iphinikhodi ye-LPD yenziwe yasebenza, i-ST25DVXXKC VCC iyanqanyulwa, ukusetshenziswa kwamandla kuncane futhi ukuxhumana nge-I2C akutholakali.
  Qaphela: Lokhu kuhlola akukwazi ukwenziwa ngebhodi lokunweba le-X-NUCLEO‑NFC07A1 njengoba ibhodi lingaxhumi iphinikhodi.
• Ibhokisi lemeyili
  Lesi exampI-le ibonisa indlela yokubhala umlayezo ebhokisini leposi kanye nendlela yokufunda irejista yesimo sebhokisi lemeyili yedivayisi ye-ST25DVXXKC. Umbhalo uyavezwa.
• I2CChannel
  Lesi exampI-le ibonisa indlela yokushintsha ikheli lesigqila le-I2C futhi ibonisa ukuthi ukubhala umlayezo ebhokisini leposi nokufunda irejista yesimo sebhokisi leposi ledivayisi ye-ST25DVXXKC kokubili kusebenza nekheli lesigqila elisha. Umbhalo uyaboniswa futhi ikheli lesigqila le-I2C libuyiselwa kunani elizenzakalelayo.
  Qaphela: Uma umsebenzisi emisa uhlelo ngaphambi kokuphela kwalo, ikheli lesigqila le-I2C elifanelekile kufanele lisetshenziswe ekuxhumaneni okulandelayo ne-ST25DVXXKC.
• I-I2CMode
  Lesi exampI-le ikhombisa ukuthi ungayishintsha kanjani imodi yesigqila ye-I2C (I-Normal/RF Off) nokuthi ngemodi yesigqila ye-I2C esethwe ukuze ithi 'RFOFF' akusaphathwa ukuxhumana kwe-NFC kuyilapho imodi yesigqila ye-I2C isethwe kokuthi 'Okuvamile' ukuxhumana kwe-NFC kuyacutshungulwa.

Indlela yokumisa ibhodi

Isendlalelo sephakheji yosekelo lwebhodi kufanele siguqulelwe kancane kungxenyekazi ye-Linux eqondisiwe, ukuze ukhethe i-peripheral ye-I2C ukuze uxhumane ne-ST25DVXXKC futhi ama-GPIO axhunywe ku-ST25DVXXKC GPO kanye namaphinikhodi e-LPD. Zonke izincazelo ezidingekayo zibalwe kokulandelayo file: Abashayeli/BSP/Linux/hwconfig.h.

Ithebula 2. Incazelo yokumisa izingxenyekazi zekhompuyutha:

Isici	Chaza	Incazelo
I-I2C	ST25DV_I2C_NR	Ichaza inombolo yeperipheral ye-I2C esetshenziselwa ukuxhumana ne-ST25DVXXKC. Inani lisetshenziselwa ukuqedela indlela eya ku-/dev/i2c-X file.
I-GPO	ST25DV_GPO_GPIOCHIP	Ichaza inombolo ye-GPIOCHIP exhunywe kuphinikhodi ye-ST25DVXXKC GPO. Inani lisetshenziselwa ukuqedela indlela eya ku-/dev/gpiochipX file.
	ST25DV_GPO_PIN	Ichaza inombolo yephinikhodi ye-GPIO ye-GPIOCHIP exhunywe kuphinikhodi ye-ST25DVXXKC GPO.
I-LPD	ST25DV_LPD_PIN	Ichaza inombolo yephinikhodi ye-GPIO yomhlaba wonke exhunywe kuphinikhodi ye-ST25DVXXKC LPD. Isetshenziselwa ukuthumela le GPIO.
	I-ST25DV_LPD_DIRECTION	Ichaza indlela eya ku-Linux file ukuchaza isiqondiso se-GPIO esixhunywe kuphinikhodi ye-ST25DVXXKC LPD efana nale: /sys/class/gpio/gpioXX/direction
	ST25DV_LPD_VALUE	Ichaza indlela eya ku-Linux file ukuchaza inani le-GPIO elixhunywe kuphinikhodi ye-ST25DVXXKC LPD efana nale: /sys/class/gpio/gpioXX/value

Ukusethwa kwezingxenyekazi zekhompuyutha

Izidingo zehadiwe:

• Ubuntu-based PC/Virtual-machine version 16.04 noma ngaphezulu
• Ibhodi le-STM32MP157F-DK2 (ikhithi yokutholwa)
• I-X-NUCLEO-NFC07A1
• 8 GB micro SD ikhadi ukuze uqalise i-STM32MP157F-DK2
• Isifundi sekhadi le-SD / uxhumano lwe-LAN
• I-USB Type-A kuya kukhebula le-USB le-Type-micro B (uma uthanda)
• I-USB Type A kuya kukhebula le-USB lohlobo C
• Ukunikezwa kwamandla okuhambisana ne-USB PD 5V 3A

Umshini we-PC/Virtual wakha iplatifomu yokuthuthukiswa kwe-cross-development ukwakha i-sample amaphrojekthi ikhodi yesicelo. I-Hardware ixhunywe ngale ndlela elandelayo:

1. Kuye ngebhodi yokutholwa ye-STM32MP157F-DK2 yokucushwa kwemodi ye-I2C (evamile, esheshayo, esheshayo+), ibhodi lokunweba le-X-NUCLEO-NFC07A1 i-I2C pullup resistors (R5 ne-R6) ingase yenyuswe ifike ku-10 kΩ.
   
2. Xhuma ibhodi lokunweba le-X-NUCLEO-NFC07A1 kuzixhumi ze-Arduino® ohlangothini olungezansi lwebhodi lokutholwa le-STM32MP157F-DK2.
   
3. Uma kudingekile, xhuma umhleli/isilungisi sephutha se-ST-LINK esishumekwe ebhodini lokutholwa ukuze usonge i-PC ngembobo yohlobo lwe-USB micro B (CN11).
4. Nika amandla ibhodi lokutholwa ngembobo yohlobo C lwe-USB (CN6).
   

Ukuhlanganisa nokusebenzisa u-sample amaphrojekthi

I-STSW-ST25DV009 s ngayinyeample phrojekthi iza ne-makefile futhi ingahlanganiswa kusetshenziswa i-C compiler efana ne-GCC. Umtapo wezincwadi we-pthread Linux usetshenziselwa ukwakha uchungechunge oluthola umcimbi kulayini we-GPO, lo mtapo wezincwadi uyadingeka ukuze kuxhunywe okulungile ngesikhathi sokuhlanganiswa. Izinqubo zokuhlanganisa nokusebenza:

1. Kusokhaya we-PC:
   • kopisha sonke isihlahla se-ST25DVLinux files ku-PC/Umshini-Virtual: scp -r :.
2. Ku-PC/Umshini obonakalayo:
   • hlanganisa uhlelo lokusebenza (lokhu kukhiqiza okusebenzisekayo okuxhumene ngokwezibalo file): cd ~//Projects/ hlanza konke
   • kopisha exe file ebhodini eliqondiwe le-Linux (RPi, STM32MP157F-DK2, …): scp ~//Projects//st25dv-i2c_ impande @:.
3. Ku-STM32MP157F-DK2 ibhodi:
   • sebenzisa i-exe ekopishiwe file: chmod +x st25dv-i2c_ ./st25dv-i2c_

Umlando wokubuyekeza 

ISAZISO ESIBALULEKILE – FUNDA NGOKUQAPHELA

I-STMicroelectronics NV nezinkampani ezingaphansi kwayo (“ST”) igodla ilungelo lokwenza izinguquko, ukulungisa, izithuthukisi, ukuguqulwa, kanye nokuthuthukiswa kwe-ST
imikhiqizo kanye/noma kulo mbhalo nganoma yisiphi isikhathi ngaphandle kwesaziso. Abathengi kufanele bathole ulwazi lwakamuva olufanele ngemikhiqizo ye-ST ngaphambi kokufaka ama-oda. Imikhiqizo ye-ST ithengiswa ngokulandela imigomo nemibandela ye-ST yokuthengisa ekhona ngesikhathi sokuvunywa kwe-oda. Abathengi banomthwalo wemfanelo kuphela ekukhetheni, ekukhethweni, nasekusetshenzisweni kwemikhiqizo ye-ST futhi i-ST ayithathi sikweletu sosizo lwesicelo noma idizayini yemikhiqizo yabathengi. Ayikho ilayisensi, eshiwo noma eshiwoyo, kunoma yiliphi ilungelo lempahla yengqondo elinikezwa i-ST lapha. Ukudayiswa kabusha kwemikhiqizo ye-ST nezinhlinzeko ezihlukile kulwazi olubekwe lapha kuzovala noma yisiphi isiqinisekiso esinikezwe i-ST salowo mkhiqizo. Ilogo ye-ST kanye ne-ST yizimpawu zokuthengisa ze-ST. Ukuze uthole ulwazi olwengeziwe mayelana nezimpawu zokuthengisa ze-ST, bheka ku www.st.com/trademarks. Wonke amanye amagama omkhiqizo noma wesevisi ayimpahla yabanikazi abafanele. Ulwazi olukule dokhumenti luthatha indawo futhi luthatha indawo yolwazi olwalunikezwe ngaphambilini kunoma yiziphi izinguqulo zangaphambili zalo mbhalo.
© 2022 STMicroelectronics – Wonke amalungelo agodliwe

Amadokhumenti / Izinsiza

ST UM3078 ST25DVXXKC Linux User Space Driver [pdf] Imaniwali yosebenzisayo UM3078 ST25DVXXKC Linux User Space Driver, UM3078 ST25DVXXKC, UM3078, ST25DVXXKC, Linux User Space Driver, UM3078 Linux User Space Driver, ST25DVXXKC Linux User Space Driver, Linux User Driver, User Space Driver, Space Driver, Linux Driver, Linux.

Izithenjwa

• Imaniwali yosebenzisayo