Supir Spasi Pamaké UM3078 ST25DVXXKC Linux

Bubuka

Dokumén ieu nunjukkeun kumaha ngagunakeun pakét parangkat lunak STSW-ST25DV009 pikeun ngadalikeun NFC dinamis ST25DVXXKC. tag tina platform Linux®. Paket software STSW-ST25DV009 nyadiakeun supir spasi pamaké Linux® jeung sababaraha examples nu bisa ngonpigurasi ngajalankeun on sagala platform Linux®. ST25DVXXKC mangrupikeun dinamis NFC tag, anu tiasa diurus ku pamaca RFID atanapi ku telepon NFC, éta ogé gaduh antarmuka I2C pikeun komunikasi sareng MCU atanapi MPU. ST25DVXXKC sayogi, contonaample, dina dewan ékspansi X-NUCLEO-NFC07A1. Inpormasi sareng dokuméntasi anu aya hubunganana sareng komponén NFC, papan ékspansi X-NUCLEO‑NFC07A1 sareng parangkat lunak STSWST25DV009 sayogi di www.st.com.

Tujuan

ST25DVXXKC dinamis NFC / RFID tags mangrupakeun sirkuit terpadu anu tiasa komunikasi sareng duanana:

• Pamaca RFID sareng telepon NFC, dumasar kana ISO / IEC 15693 sareng NFC Forum Type 5 tag spésifikasi.
• MCU atanapi MPU nganggo antarmuka I2C.

Alat ieu tiasa dianggo dina platform Linux pikeun ngaktipkeun komunikasi nirkabel, pikeun gampang nransper data tina platform Linux ka smartphone (contona: URL, Koordinat GPS, data papasangan Out-Of-Band, jeung sajabana). Paket software STSW‑ST25DV009 nyadiakeun kode anu diperlukeun pikeun ngadalikeun alat ST25DVXXKC ti rohangan pamaké platform Linux anu boga controller I2C.

Struktur software

Parangkat lunak STSW-ST25DV009 dibagi kana sababaraha lapisan:

• ST25DVXXKC komponén supir
• pakét rojongan dewan
• middleware perpustakaan NDEF
• Sampkode proyék le

ST25DVXXKC komponén supir
Supir komponén ST25DVXXKC nyayogikeun metode pikeun ngonpigurasikeun sareng ngontrol alat ST25DVXXKC. Ieu bagian tina kode nu bebas tina hardware, sarta merlukeun sababaraha fungsi IO dasar pikeun dilaksanakeun (tingali Bagéan 2.2 pakét rojongan Board) kayaning I2C maca / nulis, kontrol gpio. Supir komponén ST25DVXXKC files aya dina Supir / BSP / komponén / diréktori ST25DVxxKC.

pakét rojongan dewan
Paket dukungan dewan ngalaksanakeun dua aspék anu béda:

• Fungsi IO tingkat handap disebut ku supir komponén ST25DVXXKC
• API kana métode supir komponén ST25DVXXKC

Paket rojongan dewan files aya dina diréktori Supir / BSP / Linux.

Fungsi IO tingkat rendah
Lapisan IO-tingkat low ngalaksanakeun sagala fungsi-tingkat low diperlukeun ku supir ST25DVXXKC. Lapisan ieu dilaksanakeun dina diréktori Drivers/BSP/Linux jeung files digambarkeun dina Table 1.

Files	Katerangan
	Ieu files ngalaksanakeun fungsi pikeun:
st25dv-i2c_linux.c	• Konpigurasikeun, maca jeung nulis panganteur I2C
st25dv-i2c_linux.h	• Meunang centang millidetik
	Kode ieu ngandelkeun /dev/i2c-X file pikeun ngadalikeun periferal I2C.
st25dv-i2c-gpo.c st25dv-i2c-gpo.h	Ieu files ngalaksanakeun fungsi pikeun ngonpigurasikeun sarta narima interruptions ti GPO pin ST25DVXXKC. Kode ieu ngagunakeun /dev/gpiochipX file sarta thread dedicated ka polling pikeun acara on GPIO nu.
st25dv-i2c-lpd.c st25dv-i2c-lpd.h	Ieu files ngalaksanakeun fungsi pikeun ngonpigurasikeun tur kadalikeun kakuatan low handap pin ST25DVXXKC. Kode ieu ngagunakeun handap files pikeun ngadalikeun GPIO: • / sys / kelas / gpio / ékspor • / sys / kelas / gpio / gpioXX / arah • /sys/class/gpio/gpioXX/value.

fungsi ieu husus pikeun dewan dipaké sarta kudu diadaptasi kana platform nu aranjeunna dipaké (tingali Bagéan 3 Kumaha ngonpigurasikeun dewan).

API kana métode supir ST25DVXXKC
API Ieu ngan hiji wrapper sabudeureun supir komponén ST25DVXXKC. Éta dilaksanakeun dina Drivers/BSP/Linux/bsp_nfctag.c jeung Supir/BSP/Linux/bsp_nfctag.h files.

middleware perpustakaan NDEF
Forum NFC netepkeun format standar pikeun dianggo nalika maca/nulis alat NFC. format ieu katelah
seratan NDEF. Perpustakaan NDEF nerapkeun metode tingkat luhur pikeun gampang pormat data kana NDEF patuh
cara. perpustakaan STMicroelectronics ieu dikirimkeun salaku middleware a, pinuh bebas tina hardware na
datangna kalawan panganteur file pikeun dilaksanakeun pikeun platform sasaran.
Dina pakét software STSW-ST25DV009 panganteur ieu files dilaksanakeun dina:

• Proyék\NDEF_URI\Src\lib_NDEF_config.c
• Proyék\NDEF_BLUETOOTH\Src\lib_NDEF_config.c

The NDEF perpustakaan middleware files aya dina diréktori Middlewares/ST/lib_nfc

Sampproyék le
Dina bagian ieu, hiji leuwih pondokview tina sampproyék le kaasup dina pak STSW-ST25DV009 disadiakeun. The sampproyék:

• kedah diadaptasi kana platform Linux anu dituju (sapertos anu dijelaskeun dina Bagéan 3 Kumaha ngonpigurasikeun papan)
• nunjukkeun ka pangguna kumaha ngagunakeun API pikeun ngamimitian anu leres sareng nganggo NFC / RFID dinamis tag IC (alat ST25DVxxKC)

The sampproyék le aya dina diréktori ./Projects.

• NDEF_URI
  Aplikasi ieu nunjukkeun kumaha cara nyerat pesen URI NDEF saderhana ka EEPROM ST25DVXXKC nganggo middleware lib NDEF. Hiji talatah dipintonkeun lamun talatah geus hasil ditulis. Smartphone atanapi pamaca NFC tiasa dianggo pikeun maca pesen NDEF_URI.
• NDEF_BLUETOOTH
  Aplikasi ieu nunjukkeun kumaha cara nyerat pesen Bluetooth® OOB NDEF ka EEPROM ST25DVXXKC nganggo middleware lib NDEF. Hiji talatah dipintonkeun lamun talatah geus hasil ditulis. Smartphone atanapi pamaca NFC tiasa dianggo pikeun maca pesen NDEF_BLUETOOTH.
• GPO (kaluaran tujuan umum)
  Mantan ieuample nembongkeun kumaha carana ngaktipkeun sarta ngagunakeun GPO. Saatos inisialisasi, interupsi diprogram pikeun ngadeteksi parobahan lapangan dina jarak ST25DVXXKC. Hiji talatah dipintonkeun sawaktos sawah dideteksi sareng nalika sawah ngaleungit.
• I2CPROTEKSI
  Mantan ieuample nunjukeun kumaha carana nyieun wewengkon di ST25DVXXKC na kumaha ngajaga aranjeunna. Téks dipintonkeun dina konsol.
• LPD (kakuatan handap)
  Mantan ieuample nembongkeun kumaha carana ngaktipkeun kakuatan low handap (LPD) pin. Ku ngasupkeun "1" atawa "0", pin LPD diaktipkeun atawa dinonaktipkeun. Nalika pin LPD diaktipkeun, ST25DVXXKC VCC dipotong, konsumsi kakuatan minimum sareng komunikasi via I2C henteu sayogi.
  Catetan: Tés ieu teu tiasa dijalankeun sareng papan ékspansi X-NUCLEO-NFC07A1 kusabab papan henteu nyambungkeun pin sapertos kitu.
• Kotak surat
  Mantan ieuample nembongkeun kumaha carana nulis pesen kana kotak surat jeung cara maca status kotak surat register alat ST25DVXXKC. Téks dipintonkeun.
• Saluran I2
  Mantan ieuample nembongkeun kumaha carana ngarobah alamat budak I2C sarta nembongkeun yen nulis pesen kana kotak surat jeung maca status kotak surat register tina alat ST25DVXXKC duanana dianggo kalayan alamat budak anyar. Téks ditampilkeun sareng alamat budak I2C dibalikkeun kana nilai standar.
  Catetan: Upami pangguna ngeureunkeun aplikasi sateuacan réngsé, alamat budak I2C anu pas kedah dianggo pikeun komunikasi salajengna sareng ST25DVXXKC.
• Modeu I2CM
  Mantan ieuampLe nunjukeun kumaha carana ngarobah mode budak I2C (Normal / RF Pareum) sarta yén kalayan mode budak I2C disetel ka 'RFOFF' euweuh deui komunikasi NFC diatur sedengkeun jeung mode budak I2C disetel ka 'Normal' komunikasi NFC diolah.

Kumaha ngonpigurasikeun dewan

Lapisan pakét pangrojong dewan kedah rada diadaptasi kana platform Linux anu dituju, pikeun milih periferal I2C pikeun komunikasi sareng ST25DVXXKC sareng GPIOs disambungkeun ka ST25DVXXKC GPO sareng LPD pin. Sadaya definisi anu diperyogikeun didaptarkeun di handap ieu file: Supir/BSP/Linux/hwconfig.h.

Tabél 2. Definisi konfigurasi hardware:

Fitur	Nangtukeun	Katerangan
I2C	ST25DV_I2C_NR	Ieu nangtukeun jumlah periferal I2C dipaké pikeun komunikasi sareng ST25DVXXKC. Nilai dipaké pikeun ngalengkepan jalur ka /dev/i2c-X file.
GPO	ST25DV_GPO_GPIOCHIP	Ieu nangtukeun jumlah GPIOCHIP disambungkeun ka ST25DVXXKC GPO pin. Nilai dipaké pikeun ngalengkepan jalur ka /dev/gpiochipX file.
	ST25DV_GPO_PIN	Ieu nangtukeun jumlah pin GPIO tina GPIOCHIP disambungkeun ka ST25DVXXKC GPO pin.
LPD	ST25DV_LPD_PIN	Ieu nangtukeun jumlah pin GPIO global disambungkeun ka ST25DVXXKC LPD pin. Hal ieu dipaké pikeun ngekspor GPIO ieu.
	ST25DV_LPD_DIRECTION	Éta netepkeun jalur ka Linux file nangtukeun arah GPIO disambungkeun ka ST25DVXXKC LPD pin kayaning: /sys/class/gpio/gpioXX/direction
	ST25DV_LPD_VALUE	Éta netepkeun jalur ka Linux file nangtukeun nilai GPIO disambungkeun ka ST25DVXXKC LPD pin kayaning: /sys/class/gpio/gpioXX/value

Setélan hardware

Syarat hardware:

• PC basis Ubuntu / Vérsi mesin virtual 16.04 atawa nu leuwih luhur
• Papan STM32MP157F-DK2 (papanggihan kit)
• X-NUCLEO-NFC07A1
• 8 kartu SD mikro GB pikeun boot STM32MP157F-DK2
• maca kartu SD / konektipitas LAN
• USB Tipe-A ka Tipe-mikro B kabel USB (opsional)
• USB Tipe A ka Tipe-C kabel USB
• USB PD-patuh catu daya 5V 3A

PC / Virtual-mesin ngabentuk platform cross-ngembangkeun ngawangun sample proyék kode aplikasi. Hardware disambungkeun saperti kieu:

1. Gumantung kana STM32MP157F-DK2 dewan pamanggihan mode konfigurasi I2C (normal, gancang, gancang +), nu X-NUCLEO-NFC07A1 papan ékspansi I2C resistors pullup (R5 na R6) bisa ngaronjat nepi ka 10 kΩ.
   
2. Colokkeun papan ékspansi X-NUCLEO-NFC07A1 kana konektor Arduino® di sisi handap papan panemuan STM32MP157F-DK2.
   
3. Upami diperlukeun, sambungkeun ST-link programmer / debugger dipasang dina dewan pamanggihan ka PC host via port USB micro B tipe (CN11).
4. Dayakeun papan panemuan ngaliwatan port USB Type C (CN6).
   

Nyusun sareng ngajalankeun sampproyék le

Unggal STSW-ST25DV009 sampproyék le hadir kalawan make afile sareng tiasa disusun nganggo kompiler C sapertos GCC. Perpustakaan Linux pthread dipaké pikeun nyieun thread ngadeteksi hiji acara dina garis GPO, perpustakaan ieu diperlukeun pikeun linking bener dina waktos kompilasi. Prosedur kompilasi sareng ngajalankeun:

1. Dina PC host:
   • nyalin sadayana tangkal ST25DVLinux files kana PC/Mesin Virtual: scp -r :.
2. Dina PC/mesin Virtual:
   • cross-compile aplikasi (ieu ngahasilkeun statis numbu executable file): cd ~ // Proyék / nyieun bersih sadayana
   • salinan exe file ka papan target Linux (RPi, STM32MP157F-DK2, ...): scp ~ // Proyék // st25dv-i2c_ root @:.
3. Dina papan STM32MP157F-DK2:
   • ngajalankeun exe disalin file: chmod +x st25dv-i2c_ ./st25dv-i2c_

Riwayat révisi 

PERHATOSAN PENTING – BACA TELITI

STMicroelectronics NV sareng anak perusahaanna ("ST") ngagaduhan hak pikeun ngarobih, koréksi, paningkatan, modifikasi, sareng perbaikan kana ST.
produk jeung/atawa dokumen ieu iraha wae tanpa aya bewara. Purchasers kudu ménta inpo relevan panganyarna dina produk ST saméméh nempatkeun pesenan. Produk ST dijual dumasar kana syarat sareng kaayaan penjualan ST anu aya dina waktos pangakuan pesenan. Purchasers téh solely jawab pilihan, seleksi, sarta pamakéan produk ST sarta ST nganggap euweuh liability pikeun bantuan aplikasi atawa desain produk purchasers '. Henteu aya lisénsi, terang atanapi tersirat, kana hak cipta intelektual anu dipasihkeun ku ST di dieu. Dijual deui produk ST kalayan katangtuan anu béda sareng inpormasi anu dijelaskeun di dieu bakal ngabatalkeun jaminan anu dipasihkeun ku ST pikeun produk sapertos kitu. ST jeung logo ST mangrupakeun mérek dagang ti ST. Pikeun émbaran tambahan ngeunaan merek dagang ST, tingal www.st.com/trademarks. Sadaya nami produk atanapi jasa sanés mangrupikeun milik anu gaduhna. Inpormasi dina dokumén ieu ngagentos sareng ngagentos inpormasi anu disayogikeun saacanna dina vérsi sateuacana tina dokumén ieu.
© 2022 STMicroelectronics – Sadaya hak ditangtayungan

Dokumén / Sumberdaya

ST UM3078 ST25DVXXKC Linux Ubuntu Pamaké Spasi Supir [pdf] Manual pamaké UM3078 ST25DVXXKC Supir Spasi Pamaké Linux, UM3078 ST25DVXXKC, UM3078, ST25DVXXKC, Supir Spasi Pamaké Linux, Supir Spasi Pamaké Linux UM3078, Supir Spasi Pamaké Linux ST25DVXXKC, Supir Pangguna Linux, Supir Spasi Pamaké, Supir Spasi, Supir Angkasa Linux, Supir

Rujukan

• Manual pamaké