Supir Linux UM2548
Linux® supir pikeun ST25R3916 / ST25R3916B
Manual pamaké
Supir Linux UM2548
Bubuka
STSW-ST25R013 Supir Linux® ngamungkinkeun Raspberry Pi® 4 tiasa beroperasi sareng papan X-NUCLEO-NFCO6A1 sareng X-NUCLEO-NFCO8A1, anu masing-masing ngandung alat ST25R3916 sareng ST25R3916B.
Paket ieu nga-port lapisan abstraksi RF (RFAL) kana platform Linux Raspberry Pi 4, pikeun beroperasi sareng firmware dewan, sareng nyayogikeun salakuampaplikasi le detecting tipena béda NFC tags sareng telepon sélulér anu ngadukung P2P. RFAL teh supir standar ST pikeun ST25R3916 na ST25R3916B, kinerja tinggi NFC alat universal / EMVCo pamiarsa. Hal ieu dianggo, contona, ku firmware ST25R3916-DISCO (STSW-ST25R010) sareng ku firmware X-NUCLEO-NFCO06A1 (X-CUBE-NFC6).
STSW-ST25R013 ngarojong sagala ST25R3916 / ST25R3916B handap-lapisan jeung sababaraha protokol lapisan luhur pikeun komunikasi. RFAL ditulis dina cara portabel, ku kituna bisa dijalankeun dina rupa-rupa alat dumasar kana Linux. Dokumén ieu ngajelaskeun kumaha perpustakaan RFAL tiasa dianggo dina sistem Linux standar (dina hal ieu Raspberry Pi 4) pikeun komunikasi NFC / RF. Kodena kacida portabel sareng tiasa dianggo sareng parobihan leutik dina platform Linux naon waé.
Leuwihview
1.1 Fitur
- Kumplit supir angkasa pamaké Linux (lapisan abstraksi RF) pikeun ngawangun aplikasi anu diaktipkeun NFC nganggo alat ST25R3916 sareng ST25R3916B
- Komunikasi host Linux sareng ST25R3916 / ST25R3916B nganggo antarmuka SPI
- Lengkep abstraksi RF/NFC (RFAL) pikeun sakabéh téknologi utama jeung protokol lapisan luhur:
- NFC-A (ISO14443-A)
- NFC-B (ISO14443-B)
- NFC-F (FeliCa™)
- NFC-V (ISO15693)
- P2P (ISO18092)
- ISO-DEP (ISO data exchange protocol, ISO14443-4)
- NFC-DEP (NFC data exchange protocol, ISO18092)
- Téknologi proprietary, sapertos Kovio, B', iClass, Calypso® - SampImplementasina sayogi sareng papan ékspansi X-NUCLEO-NFC06A1 sareng X-NUCLEO-NFC08A1, dipasang kana Raspberry Pi 4
- Sampaplikasi pikeun ngadeteksi sababaraha NFC tag jenis sarta handphone ngarojong P2P
- Syarat lisénsi ramah-pamaké gratis
1.2 Arsitéktur software
Gambar 2 nembongkeun rinci arsitektur software perpustakaan RFAL dina platform Linux Ubuntu.
The RFAL gampang dibabawa ka platform sejen ku adapting nu disebut platform files.
lulugu file rfal_platform.h ngandung harti makro, bakal disadiakeun jeung dilaksanakeun ku nu boga platform.
Éta nyayogikeun setélan khusus platform sapertos tugas GPIO, sumber sistem, konci sareng IRQ, anu diperyogikeun pikeun operasi RFAL anu leres.
Démo ieu ngalaksanakeun fungsi platform sareng nyayogikeun palabuhan RFAL kana rohangan pangguna Linux.
A perpustakaan dibagikeun file dihasilkeun, nu dipaké ku aplikasi demonstrative showcase fungsionalitas disadiakeun ku lapisan RFAL.
Host Linux nganggo antarmuka sysfs anu sayogi ti rohangan pangguna Linux pikeun ngalaksanakeun komunikasi SPI sareng alat. Di jero kernel Linux, antarmuka sysfs SPI nganggo supir kernel Linux spidev pikeun ngirim / nampi pigura SPI ka / tina alat.
Pikeun nanganan garis INT alat ST25R3916 sareng ST25R3916B, supir nganggo sysfs libpiod pikeun ngabéjaan parobahan dina jalur ieu.
Setélan hardware
2.1 Platform dipaké
Papan Raspberry Pi 4 sareng Raspberry Pi OS dianggo salaku platform Linux pikeun ngawangun perpustakaan RFAL sareng berinteraksi sareng ST25R3916 / ST25R3916B ngalangkungan SPI.
Alat-alat ngaktifkeun aplikasi dina platform Linux pikeun ngadeteksi sareng komunikasi sareng alat NFC.
2.2 Syarat hardware
- Raspberry Pi 4
- 8 GB kartu micro SD pikeun boot Raspberry Pi OS (kalawan syarat panganyarna na)
- maca kartu SD
- Papan X-NUCLEO-NFC06A1 atanapi X-NUCLEO-NFC08A1
- Sasak pikeun nyambungkeun papan sareng adaptor Raspberry Pi Arduino™ pikeun Raspberry Pi (nomer bagian ARPI600)
2.2.1 Sambungan hardware
ARPI600 Raspberry Pi to Arduino adapter dipaké pikeun nyambungkeun papan jeung Raspberry Pi. The jumpers dewan adaptor kudu dirobah pikeun nyambungkeunana jeung papan X-NUCLEO-NFC06A1 atanapi X-NUCLEO-NFC08A1.
Awas:
ARPI600 salah suplai 5 V ka pin Arduino IOREF. Langsung ngagantelkeun papan eupan deui 5 V dina sababaraha pin, ieu bisa ngaruksak dewan buah prambus Pi. Aya laporan papan ancur (utamana Raspberry Pi 4B+).
Jang ngalampahkeun ieu, adaptasi ARPI600 (operasi rada hese), atawa dewan X-NUCLEO-NFC06A1 / X-NUCLEONFC08A1 (gampang).
Perbaikan panggampangna nyaéta motong pin CN6.2 (IOREF) dina papan X-NUCLEO-NFC06A1/X-NUCLEO-NFC08A1, ditémbongkeun saperti dina Gambar 3.
Motong pin ieu teu mangaruhan operasi ditéang jeung papan Nucleo (kayaning NUCLEO-L474RG, NUCLEO-F401RE, NUCLEO-8S208RB).
Setélan jumper
The jumpers pikeun A5, A4, A3, A2, A1 na A0 ditémbongkeun dina Gambar 4 kudu dirobah masing-masing mun P25, P24, P23, P22, P21 na CE1. Kalayan setelan ieu, angka pin GPIO buah prambus 7 dipaké salaku garis interupsi pikeun X-NUCLEONFC06A1 / X-NUCLEO-NFC08A1.
Ayeuna, port perpustakaan RFAL ieu ngagunakeun pin GPIO7 salaku garis interupsi (nurutkeun setelan jumper). Upami aya sarat pikeun ngarobih jalur interupsi tina GPIO7 ka GPIO anu béda, kodeu khusus platform (dina file pltf_gpio.h) kudu dirobah pikeun ngarobah harti makro ST25R_INT_PIN tina 7 ka pin GPIO anyar, pikeun dipaké salaku garis interupsi.
Kalawan setelan jumper luhur, dewan adaptor bisa dipaké pikeun nyambungkeun X-NUCLEO NFC06A1 na X-NUCLEO-NFC08A1 kalawan dewan buah prambus Pi, ditémbongkeun saperti dina gambar di handap ieu.
Setélan lingkungan Linux
3.1 Booting buah prambus Pi
Pikeun nyetél lingkungan Linux, pasang heula sareng boot Raspberry Pi nganggo Raspberry Pi OS, sakumaha anu dijelaskeun di handap ieu:
Lengkah 1
Unduh gambar Raspberry Pi OS panganyarna tina https://www.raspberrypi.com, teras pilih Raspberry Pi OS sareng desktop. Pikeun tés di handap ieu vérsi 2022-09-22-raspios-bullseye-armhf.img.xz (September 2022) parantos dianggo.
Lengkah 2
Buka zip gambar Raspberry Pi OS sareng tuliskeun kana kartu SD ku nuturkeun pitunjuk anu aya dina bagian anu namina "Nulis gambar kana kartu SD".
Lengkah 3
Sambungkeun hardware:
- Sambungkeun Raspberry Pi 4 ka monitor nganggo kabel HDMI standar.
- Sambungkeun mouse sareng keyboard kana port USB Raspberry Pi.
Éta ogé tiasa dianggo sareng Raspberry Pi nganggo ssh. Dina hal ieu. teu diperlukeun pikeun nyambungkeun monitor, keyboard jeung mouse kalawan buah prambus Pi. Hiji-hijina sarat nyaéta gaduh PC sareng ssh di jero jaringan anu sami sareng Raspberry Pi, sareng ngonpigurasikeun alamat IP sasuai.
Lengkah 4
Boot Raspberry Pi 4 nganggo kartu SD. Saatos booting, desktop Linux berbasis Debian muncul dina monitor.
Catetan:
Sakapeung, saatos booting Raspberry Pi OS, sababaraha kenop keyboard henteu jalan. Pikeun ngajantenkeun aranjeunna tiasa dianggo, buka file /etc/standar/keyboard tur nyetel XKBLAYOUT = "urang", sarta reboot Raspberry Pi.
3.2 Aktipkeun SPI dina buah prambus Pi
Supir SPI di jero kernel komunikasi sareng papan X-NUCLEO-NFC06A1/X-NUCLEO-NFC08A1 ngaliwatan SPI. Penting pikeun pariksa naha SPI parantos diaktipkeun dina konfigurasi kernel Raspbian Pi OS.
Pariksa naha /dev/spidev0.0 katingali di lingkungan Raspberry Pi. Upami éta henteu katingali, aktipkeun antarmuka SPI nganggo utilitas "raspi-config" ku nuturkeun léngkah anu dijelaskeun di handap ieu.
Lengkah 1
Buka terminal anyar dina Raspberry Pi sareng jalankeun paréntah "raspi-config" salaku akar: sudo raspi-config
Léngkah ieu muka antarmuka grafis.
Lengkah 2
Pilih dina panganteur grafis pilihan ngaranna "Interfacing Options".
Lengkah 3
Léngkah ieu daptar sababaraha pilihan.
Pilih pilihan ngaranna "SPI".
Jandéla anyar muncul kalayan téks di handap ieu:
"Naha anjeun hoyong antarmuka SPI diaktipkeun?"
Lengkah 4
Pilih dina jandela ieu pikeun ngaktipkeun SPI.
Lengkah 5
Reboot buah prambus Pi.
Léngkah-léngkah di luhur bakal ngaktifkeun antarmuka SPI di lingkungan Raspberry Pi saatos reboot.
Ngawangun perpustakaan RFAL sareng aplikasi
Demonstrasi RFAL Linux disayogikeun dina arsip, sapertos ST25R3916_v2.8.0_Linux_demo_v1.0.tar.xz.
Pikeun ngawangun perpustakaan RFAL sareng aplikasi dina Raspberry Pi, ngalangkungan léngkah-léngkah ieu:
Lengkah 1
Buka zip pakét dina Raspberry Pi nganggo paréntah di handap ieu tina diréktori bumi
tar -xJvf ST25R3916_v2.8.0_Linux_demo_v1.0.tar.xz
Lengkah 2
Pasang cmake (upami henteu dilakukeun sateuacanna) nganggo paréntah
apt-meunang install cmake
Perpustakaan RFAL sareng sistem ngawangun aplikasi dumasar kana cmake, pikeun alesan ieu diperyogikeun masang cmake pikeun nyusun pakét.
Lengkah 3
Pikeun ngawangun perpustakaan jeung aplikasi RFAL, buka diréktori ngawangun
cd ST25R3916_v2.8.0_Linux_demo_v1.0/linux_demo/build
Ti dinya, ngajalankeun paréntah
cing..
Dina paréntah di luhur ".." nunjukkeun yén tingkat luhur CMakeLists.txt aya dina diréktori indungna
(ST25R3916_v2.8.0_Linux_demo_v1.0).
Paréntah ieu nyiptakeun makefile dipaké dina lengkah saterusna pikeun ngawangun perpustakaan jeung aplikasi. Ti dinya, ngajalankeun paréntah di handap pikeun ngawangun démo pikeun ST25R3916B
cmake -DRFAL_VARIANT=st25r3916b ..
Lengkah 4
Jalankeun paréntah make pikeun ngawangun perpustakaan sareng aplikasi RFAL:
nyieun
Paréntah ieu mimiti ngawangun perpustakaan RFAL, teras aplikasi dina luhureun éta.
Kumaha ngajalankeun aplikasi
A ngawangun-up suksés ngahasilkeun hiji laksana ngaranna "nfc_poller_st25r3916" atawa "nfc_poller_st25r3916b" di lokasi / ngawangun / demo.
Sacara standar, aplikasi kudu dijalankeun kalawan hak root tina jalur ST25R3916_v2.8.0_Linux_demo_v1.0/linux_demo/build/demo/:
sudo ./nfc_demo_st25r3916
Aplikasi mimiti polling pikeun NFC tags jeung telepon sélulér, teras mintonkeun alat nu kapanggih kalawan UID maranéhanana, ditémbongkeun saperti dina Gambar 7.
Pikeun ngeureunkeun aplikasi pencét Ctrl + C.
Riwayat révisi
Méja 1. Sajarah révisi dokumén
| titimangsa | Révisi | Parobahan |
| 1-Mar-19 | 1 | Pelepasan awal. |
| 4-Apr-23 | 2 | Judul dokumén anu diropéa, Bagian Pendahuluan, Bagian 1.1 Fitur, Bagian 1.2 Arsitéktur software, Bagian 2.1 Platform dipaké, Bagian 2.2 Hardware sarat, Bagian 2.2.1 Sambungan hardware, Bagian 3.1 Booting Raspberry Pi, Bagian 3.2 Aktipkeun SPI dina Raspberry Pi, Bagian 4 Ngawangun perpustakaan sareng aplikasi RFAL, jeung Bagéan 5 Kumaha ngajalankeun aplikasi. Gambar diropéa 1. perpustakaan RFAL dina platform Linux, angka 2. arsitéktur software RFAL on Linux Ubuntu, sarta Gambar 5. Hardware setelan luhur view. Éditan téks minor dina sakabéh dokumén. |
PERHATOSAN PENTING – BACA TELITI
STMicroelectronics NV sareng anak perusahaanna ("ST") ngagaduhan hak pikeun ngarobih, koréksi, perbaikan, modifikasi, sareng perbaikan produk ST sareng / atanapi dokumen ieu iraha waé tanpa aya bewara. Purchasers kudu ménta inpo relevan panganyarna dina produk ST saméméh nempatkeun pesenan. Produk ST dijual dumasar kana sarat sareng kaayaan penjualan ST di tempat nalika 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 ti 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 hak milik nu gaduhna.
Inpormasi dina dokumén ieu ngagentos sareng ngagentos inpormasi anu disayogikeun saacanna dina versi sateuacanna tina dokumén ieu.
© 2023 STMicroelectronics – Sadaya hak ditangtayungan
UM2548 - Wahyu 2
Dokumén / Sumberdaya
 |
STMicroelectronics UM2548 Linux Ubuntu Supir [pdf] Manual pamaké Supir Linux UM2548, UM2548, Supir Linux, Supir |
