Pakej ST UM2766 X-LINUX-NFC5 untuk Membangunkan Pembaca NFC/RFID

pengenalan

Pakej pengembangan perisian STM32 MPU OpenSTLinux ini menunjukkan cara anda boleh membangunkan komunikasi NFC/RF untuk sistem Linux standard menggunakan Perpustakaan Abstraksi Frekuensi Radio (RFAL) kami. Pemacu antara muka biasa RFAL memastikan fungsi pengguna dan perisian aplikasi serasi dengan mana-mana IC pembaca ST25R NFC/RFID.
Pakej X-LINUX-NFC5 mengalihkan RFAL ke Discovery Kit dengan mikropemproses Siri STM32MP1 yang menjalankan Linux untuk memacu hujung hadapan ST25R3911B NFC pada papan pengembangan STM32 Nucleo. Pakej termasuk sebagaiampaplikasi untuk membantu anda memahami pengesanan pelbagai jenis NFC tags dan telefon bimbit yang menyokong P2P.
Kod sumber direka bentuk untuk mudah alih merentasi pelbagai unit pemprosesan yang menjalankan Linux dan menyokong semua lapisan bawah dan beberapa protokol lapisan lebih tinggi IC ST25R kepada komunikasi RF abstrak.

Perpustakaan Abstraksi Frekuensi Radio untuk Linux

RFAL	Protokol	ISO DEP			NFC DEP
	Teknologi	NFC-A	NFC-B	NFC-F	NFC-V	T1T	ST25TB
	HAL	RF
		Konfigurasi RF
		ST25R3911B

X-LINUX-NFC5 Selesaiview

Ciri-ciri Utama

Pakej pengembangan perisian X-LINUX-NFC5 termasuk ciri-ciri berikut:

• Lengkapkan pemacu ruang pengguna Linux (lapisan abstraksi RF) untuk membina aplikasi berdaya NFC menggunakan bahagian hadapan ST25R3911B/ST25R391x NFC berakhir dengan kuasa output sehingga 1.4 W.
• Komunikasi hos Linux dengan ST25R3911B/ST25R391x melalui antara muka SPI berkelajuan tinggi.
• Lengkapkan abstraksi RF/NFC (RFAL) untuk semua teknologi utama dan protokol lapisan yang lebih tinggi:
  • NFC-A (ISO14443-A)
  • NFC-B (ISO14443-B)
  • NFC-F (FeliCa)
  • NFC-V (ISO15693)
  • P2P (ISO18092)
  • ISO-DEP (protokol pertukaran data ISO, ISO14443-4)
  • NFC-DEP (protokol pertukaran data NFC, ISO18092)
  • Teknologi proprietari (Kovio, B', iClass, Calypso, dll.)
• Samppelaksanaan tersedia dengan papan pengembangan X-NUCLEO-NFC05A1 yang dipalamkan pada STM32MP157F-DK2
• Sampaplikasi untuk mengesan beberapa NFC tags jenis

Seni Bina Pakej

Pakej perisian berjalan pada teras A7 siri STM32MP1. X-LINUX-NFC5 berinteraksi dengan perpustakaan lapisan bawah dan barisan SPI yang didedahkan oleh rangka kerja perisian Linux.

Seni Bina Aplikasi X-LINUX-NFC5 dalam Persekitaran Linux

Persediaan Perkakasan

Keperluan perkakasan:

• PC/Mesin Maya berasaskan Ubuntu versi 16.04 atau lebih tinggi
• Papan STM32MP157F-DK2 (Kit Penemuan)
• X-NUCLEO-NFC05A1
• Kad SD mikro 8 GB untuk but STM32MP157F-DK2
• Pembaca kad SD / sambungan LAN
• Kabel USB Jenis-A ke Jenis-mikro B
• Kabel USB Jenis A ke Jenis-C USB
• Bekalan kuasa 5V 3A yang mematuhi USB PD

PC/Mesin Maya membentuk platform pembangunan silang untuk membina perpustakaan RFAL dan kod aplikasi untuk mengesan dan berkomunikasi dengan peranti NFC melalui IC ST25R3911B.

Cara Menyambung Perkakasan

Langkah 1. Palamkan papan pengembangan X-NUCLEO-NFC05A1 pada penyambung Arduino di bahagian bawah papan penemuan STM32MP157F-DK2.

Papan Nukleo dan papan Penemuan penyambung Arduino

1. Papan pengembangan X-NUCLEO-NFC05A1
2. Papan penemuan STM32MP157F-DK2
3. Penyambung Arduino

Langkah 2. Sambungkan pengaturcara/penyahpepijat ST-LINK yang dibenamkan pada papan penemuan ke PC hos anda melalui port jenis mikro B USB (CN11).

Langkah 3. Kuasakan papan penemuan melalui port USB Jenis C (CN6).

Persediaan Sambungan Perkakasan Penuh

PAUTAN BERKAITAN
Rujuk wiki ini untuk mendapatkan butiran lanjut berkaitan bekalan kuasa dan port komunikasi

Persediaan Perisian

Sebelum anda bermula, kuasakan kit Penemuan STM32MP157F-DK2 melalui bekalan kuasa 5 V, 3 A yang mematuhi PD USB dan pasangkan Pakej Permulaan mengikut arahan dalam wiki Bermula. Anda memerlukan Kad microSD minimum 2 GB untuk memancarkan imej boleh boot.
Untuk menjalankan aplikasi, konfigurasi platform perlu dikemas kini dengan mengemas kini pepohon peranti untuk mendayakan peranti yang berkaitan. Anda boleh melakukan ini dengan cepat dengan menggunakan imej pra-bina yang tersedia, atau anda boleh membangunkan pepohon peranti dan membina imej kernel anda sendiri.
Anda juga boleh (sebagai pilihan) membina pakej perisian ini dengan memasukkan lapisan Yocto (meta-nfc5 ) dalam pakej pengedaran ST. Operasi ini mencipta kod sumber dan termasuk pengubahsuaian pokok peranti bersama-sama dengan binari yang disusun dalam imej boleh kilat akhir. Untuk langkah terperinci yang menerangkan proses, lihat Bahagian 3.5.
Anda boleh menyambung ke Discovery Kit daripada PC hos melalui rangkaian TCP/IP menggunakan perintah ssh dan scp, atau melalui pautan UART atau USB bersiri menggunakan alatan seperti minicom untuk Linux atau Tera Term untuk Windows.

Langkah-langkah untuk Penilaian Pantas Perisian

• Langkah 01: Flash Pakej Permulaan pada Kad SD.
• Langkah 02: But papan dengan Pakej Permulaan.
• Langkah 03: Dayakan sambungan internet pada papan melalui Ethernet atau Wi-Fi. Rujuk halaman wiki yang berkaitan untuk mendapatkan bantuan.
• Langkah 04: Muat turun imej pra-bina daripada X-LINUX-NFC5 web halaman di ST webtapak
• Langkah 05: Gunakan arahan berikut untuk menyalin gumpalan pokok peranti dan mengemas kini konfigurasi platform baharu:
  Jika sambungan rangkaian tidak tersedia, anda boleh memindahkan files setempat daripada PC Windows anda ke Discovery Kit menggunakan Tera Term.
  Untuk butiran lanjut tentang pemindahan data files menggunakan Tera Term.
  
• Langkah 06: Selepas papan but, salin binari aplikasi dan lib kongsi ke papan penemuan.
  Aplikasi akan mula berjalan sebaik sahaja arahan ini dilaksanakan.

Cara Mengemas kini Konfigurasi Platform dalam Pakej Pembangun

Langkah berikut akan membolehkan anda menyediakan persekitaran pembangunan.

• Langkah 01: Muat turun Pakej Pembangun dan pasang SDK dalam struktur folder lalai pada mesin Ubuntu anda.
  Anda boleh mendapatkan arahan di sini: Pasang SDK
• Langkah 02: Buka pepohon peranti file 'stm32mp157f-dk2.dts' dalam kod sumber Pakej Pembangun dan tambahkan coretan kod di bawah pada file:
  Ini mengemas kini pepohon peranti untuk mendayakan dan mengkonfigurasi antara muka pemacu SPI4.
  
• Langkah 03: Susun pakej Pembangun untuk mendapatkan stm32mp157f-dk2.dtb file.

Cara Membina Kod Aplikasi Linux RFAL

Sebelum anda bermula, SDK mesti dimuat turun, dipasang dan didayakan. Muat turun aplikasi dari pautan: X-LINUX-NFC5

• Langkah 1. Jalankan arahan di bawah untuk menyusun silang kod:
  Perintah ini akan membina berikut files:
  • bekas ituamppermohonan: nfc_poller_st25r3911
  • shared lib untuk menjalankan examppermohonan: librfal_st25r3911.so
    

Cara Menjalankan Aplikasi Linux RFAL pada STM32MP157F-DK2

• Langkah 01: Salin binari yang dijana ke Kit Penemuan menggunakan arahan di bawah
  
• Langkah 02: Buka terminal pada papan Discovery Kit atau gunakan log masuk ssh dan jalankan aplikasi menggunakan arahan berikut.
  Pengguna akan melihat mesej di bawah pada skrin:
  
• Langkah 03: Apabila NFC tag dibawa berhampiran penerima NFC, UID dan NFC tag jenis dipaparkan pada skrin.

Discovery Kit Menjalankan Aplikasi nfcPoller

Cara Memasukkan Lapisan Meta-nfc5 dalam Pakej Pengedaran

• Langkah 01: Muat turun dan susun Pakej Pengedaran pada mesin Linux anda.
• Langkah 02: Ikuti struktur direktori lalai yang dicadangkan oleh halaman ST wiki untuk mengikuti dokumen ini secara serentak.
• Langkah 03: Muat turun pakej aplikasi X-LINUX-NFC5:
  
• Langkah 04: Sediakan konfigurasi binaan.
  
• Langkah 05: Tambahkan lapisan meta-nfc5 pada konfigurasi binaan konfigurasi Pakej Pengedaran.
  
• Langkah 06: Kemas kini konfigurasi untuk menambah komponen baharu dalam imej anda.
  
• Langkah 07: Bina lapisan anda secara berasingan dan kemudian bina Lapisan Pengedaran yang lengkap.
  Nota: Membina halaman pengedaran untuk kali pertama mungkin mengambil masa beberapa jam. Walau bagaimanapun, hanya beberapa minit diperlukan untuk membina lapisan meta-nfc5 dan memasang boleh laku dalam imej akhir. Setelah binaan selesai, imej hadir dalam direktori berikut: bina- - /tmp-glibc/deploy/images/stm32mp1.
• Langkah 08: Ikut arahan pada halaman ST wiki: Memancarkan imej terbina untuk memancarkan imej terbina baharu pada
  kit penemuan.
• Langkah 09: Jalankan aplikasi seperti yang dinyatakan dalam Langkah 2 Bahagian 3.4.

Cara Mentransfer Files Menggunakan Istilah Tera

Anda boleh menggunakan aplikasi emulator terminal Windows seperti Tera Term untuk memindahkan files daripada PC anda ke Discovery Kit.

• Langkah 01: Bekalkan kuasa USB kepada Discovery Kit.
• Langkah 02: Sambungkan Discovery Kit ke PC anda melalui penyambung jenis USB mikro B (CN11).
• Langkah 03: Semak nombor port COM Maya dalam pengurus peranti.
  Dalam tangkapan skrin di bawah, nombor port COM ialah 14.
  Petikan skrin Pengurus Peranti Menunjukkan Port Kom Maya
  
• Langkah 04: Buka Tera Term pada PC anda dan pilih port COM yang dikenal pasti dalam langkah sebelumnya. Kadar baud hendaklah 115200 baud.
  Gambar Terminal Jauh melalui Tera Term
  
• Langkah 05: Untuk memindahkan a file daripada PC hos ke Discovery Kit, pilih [File]>[Transfer]>[ZMODEM]>[Hantar] di sudut kiri atas tetingkap Tera Term.
  Jangka Tera File Menu Pemindahan
  
• Langkah 06: Pilih file untuk dipindahkan dalam file pelayar dan pilih [Buka].
  File Tetingkap Pelayar untuk Menghantar Files
  .
• Langkah 07: Bar kemajuan akan menunjukkan status file pemindahan.
  File Bar Kemajuan Pemindahan
  

Sejarah Semakan

Sejarah Semakan Dokumen

tarikh	Versi	Perubahan
30-Okt-2020	1	Keluaran awal.
15-Jul-2021	2	dikemas kini Bahagian 1.1 Ciri-ciri utama, Bahagian 2 Persediaan perkakasan, Bahagian 2.1 Bagaimana untuk menyambung perkakasan, Bahagian 3 Persediaan perisian, Bahagian 3.1 Langkah-langkah untuk penilaian pantas bagi perisian, Bahagian 3.2 Cara mengemas kini konfigurasi platform dalam pakej pembangun dan Bahagian 3.3 Bagaimana untuk membina kod aplikasi RFAL Linux. Ditambah Bahagian 3.5 Bagaimana untuk memasukkan lapisan meta-nfc5 dalam Pakej Pengedaran. Menambahkan maklumat keserasian kit penemuan STM32MP157F-DK2.

Dokumen / Sumber

Pakej ST UM2766 X-LINUX-NFC5 untuk Membangunkan Pembaca NFC/RFID [pdf] Manual Pengguna UM2766, Pakej X-LINUX-NFC5 untuk Membangunkan Pembaca NFC-RFID, Membangunkan Pembaca NFC-RFID, Pembaca NFC-RFID, Pakej X-LINUX-NFC5, X-LINUX-NFC5

Rujukan

• Manual Pengguna