Пакет ST UM2766 X-LINUX-NFC5 для распрацоўкі счытвальніка NFC/RFID

Уводзіны

Гэты пакет праграмнага пашырэння STM32 MPU OpenSTLinux дэманструе, як вы можаце распрацаваць сувязь NFC/RF для стандартнай сістэмы Linux з дапамогай нашай Бібліятэкі радыёчастотнай абстракцыі (RFAL). Драйвер агульнага інтэрфейсу RFAL гарантуе сумяшчальнасць карыстальніцкіх функцый і прыкладнога праграмнага забеспячэння з любой мікрасхемай счытвальніка NFC/RFID ST25R.
Пакет X-LINUX-NFC5 пераносіць RFAL на камплект Discovery з мікрапрацэсарам серыі STM32MP1 пад кіраваннем Linux для кіравання інтэрфейсам ST25R3911B NFC на плаце пашырэння STM32 Nucleo. Пакет уключае якampпрыкладанне, якое дапаможа вам зразумець выяўленне розных тыпаў NFC tags і мабільныя тэлефоны з падтрымкай P2P.
Зыходны код прызначаны для пераноснасці ў шырокім дыяпазоне працэсарных блокаў пад кіраваннем Linux і падтрымлівае ўсе ніжнія ўзроўні і некаторыя пратаколы вышэйшага ўзроўню мікрасхем ST25R для абстрактнай радыёчастотнай сувязі.

Бібліятэка радыёчастотнай абстракцыі для Linux

RFAL	Пратаколы	ISO DEP			NFC DEP
	Тэхналогіі	NFC-A	NFC-B	NFC-F	NFC-V	Т1Т	ST25TB
	ХАЛ	RF
		Канфігурацыі ВЧ
		ST25R3911B

X-LINUX-NFC5 скончанаview

Асноўныя асаблівасці

Пакет пашырэння праграмнага забеспячэння X-LINUX-NFC5 уключае наступныя функцыі:

• Поўны драйвер карыстальніцкай прасторы Linux (узровень радыёчастотнай абстракцыі) для стварэння прыкладанняў з падтрымкай NFC з выкарыстаннем інтэрфейсных канцоў ST25R3911B/ST25R391x NFC з выхаднай магутнасцю да 1.4 Вт.
• Сувязь хаста Linux з ST25R3911B/ST25R391x праз высакахуткасны інтэрфейс SPI.
• Поўная абстракцыя RF/NFC (RFAL) для ўсіх асноўных тэхналогій і пратаколаў больш высокага ўзроўню:
  • NFC-A (ISO14443-A)
  • NFC-B (ISO14443-B)
  • NFC-F (FeliCa)
  • NFC-V (ISO15693)
  • P2P (ISO18092)
  • ISO-DEP (пратакол абмену данымі ISO, ISO14443-4)
  • NFC-DEP (пратакол абмену данымі NFC, ISO18092)
  • Запатэнтаваныя тэхналогіі (Kovio, B', iClass, Calypso і інш.)
• SampРэалізацыя даступная з платай пашырэння X-NUCLEO-NFC05A1, падключанай да STM32MP157F-DK2
• SampПрыкладанне для выяўлення некалькіх NFC tags тыпаў

Архітэктура пакета

Праграмны пакет працуе на ядры A7 серыі STM32MP1. X-LINUX-NFC5 узаемадзейнічае з бібліятэкамі ніжэйшых узроўняў і лініямі SPI, адкрытымі праграмнай структурай Linux.

Архітэктура прыкладання X-LINUX-NFC5 у асяроддзі Linux

Налада абсталявання

Патрабаванні да абсталявання:

• ПК/віртуальная машына на базе Ubuntu версіі 16.04 або вышэй
• Плата STM32MP157F-DK2 (Discovery Kit)
• X-NUCLEO-NFC05A1
• Карта micro SD на 8 ГБ для загрузкі STM32MP157F-DK2
• Счытвальнік карт SD / падключэнне да лакальнай сеткі
• Кабель USB тыпу A да тыпу micro B
• Кабель USB тыпу A да тыпу C
• Блок сілкавання 5 В 3 А, сумяшчальны з USB PD

ПК/віртуальная машына ўтварае платформу крос-распрацоўкі для стварэння бібліятэкі RFAL і кода прыкладання для выяўлення і сувязі з прыладамі NFC праз ST25R3911B IC.

Як падключыць абсталяванне

Крок 1. Падключыце плату пашырэння X-NUCLEO-NFC05A1 да раздымаў Arduino на ніжняй частцы платы выяўлення STM32MP157F-DK2.

Раздымы Arduino для платы Nucleo і платы Discovery

1. Плата пашырэння X-NUCLEO-NFC05A1
2. Плата выяўлення STM32MP157F-DK2
3. Раздымы Arduino

Крок 2. Падключыце праграміст/адладчык ST-LINK, убудаваны ў плату Discovery, да хост-кампутара праз порт USB micro B (CN11).

Крок 3. Харчаванне платы выяўлення праз порт USB Type C (CN6).

Поўная ўстаноўка апаратнага злучэння

СПАСЫЛКІ па тэме
Звярніцеся да гэтай вікі для атрымання дадатковай інфармацыі, звязанай з блокам харчавання і партамі сувязі

Налада праграмнага забеспячэння

Перш чым пачаць, падключыце камплект STM32MP157F-DK2 Discovery праз сумяшчальны з USB PD блок сілкавання 5 В, 3 А і ўсталюйце пачатковы пакет у адпаведнасці з інструкцыямі ў вікі "Пачатак працы". Вам спатрэбіцца карта microSD аб'ёмам не менш за 2 ГБ для прашыўкі загрузных вобразаў.
Каб запусціць прыкладанне, неабходна абнавіць канфігурацыю платформы, абнавіўшы дрэва прылад, каб уключыць адпаведныя перыферыйныя прылады. Вы можаце зрабіць гэта хутка, выкарыстоўваючы даступныя загадзя створаныя выявы, або вы можаце распрацаваць дрэва прылад і стварыць свае ўласныя выявы ядра.
Вы таксама можаце (неабавязкова) стварыць гэты праграмны пакет, уключыўшы ўзровень Yocto (meta-nfc5) у дыстрыбутыўны пакет ST. Гэтая аперацыя стварае зыходны код і ўключае мадыфікацыі дрэва прылад разам са скампіляванымі двайковымі файламі ў канчатковыя флэш-выявы. Для падрабязнага апісання працэсу гл. Раздзел 3.5.
Вы можаце падключыцца да Discovery Kit з галоўнага ПК праз сетку TCP/IP з дапамогай каманд ssh і scp або праз паслядоўныя UART або USB-сувязі з дапамогай такіх інструментаў, як minicom для Linux або Tera Term для Windows.

Крокі для хуткай ацэнкі праграмнага забеспячэння

• Крок 01: Загрузіце пачатковы пакет на SD-карту.
• Крок 02: Загрузіце плату са стартавым пакетам.
• Крок 03: Уключыце інтэрнэт-злучэнне на плаце праз Ethernet або Wi-Fi. Звяртайцеся да адпаведных вікі-старонак па дапамогу.
• Крок 04: Спампуйце загадзя сабраныя выявы з X-LINUX-NFC5 web старонка на СТ webсайт
• Крок 05: Выкарыстоўвайце наступныя каманды, каб скапіяваць блоб дрэва прылад і абнавіць новую канфігурацыю платформы:
  Калі падключэнне да сеткі недаступнае, вы можаце перанесці файл fileлакальна з ПК з Windows на Discovery Kit з дапамогай Tera Term.
  Для атрымання дадатковай інфармацыі аб перадачы даных fileз выкарыстаннем Tera Term.
  
• Крок 06: Пасля загрузкі платы скапіруйце двайковы файл прыкладання і агульную бібліятэку на плату выяўлення.
  Праграма пачне працаваць пасля выканання гэтых каманд.

Як абнавіць канфігурацыю платформы ў пакеце распрацоўшчыка

Наступныя крокі дазволяць вам наладзіць асяроддзе распрацоўкі.

• Крок 01: Спампуйце пакет распрацоўніка і ўсталюйце SDK у структуру тэчак па змаўчанні на вашай машыне Ubuntu.
  Вы можаце знайсці інструкцыі тут: Усталяваць SDK
• Крок 02: Адкрыйце дрэва прылад file 'stm32mp157f-dk2.dts' у зыходным кодзе пакета распрацоўшчыка і дадайце прыведзены ніжэй фрагмент кода ў file:
  Гэта абнаўляе дрэва прылад, каб уключыць і наладзіць інтэрфейс драйвера SPI4.
  
• Крок 03: Скампілюйце пакет распрацоўшчыка, каб атрымаць stm32mp157f-dk2.dtb file.

Як стварыць код прыкладання RFAL Linux

Перш чым пачаць, трэба загрузіць, усталяваць і ўключыць SDK. Спампуйце прыкладанне па спасылцы: X-LINUX-NFC5

• Крок 1. Выканайце наступныя каманды для крос-кампіляцыі кода:
  Гэтыя каманды будуць будаваць наступныя files:
  • Былыampпрыкладанне: nfc_poller_st25r3911
  • агульная бібліятэка для запуску exampпрыкладанне: librfal_st25r3911.so
    

Як запусціць прыкладанне RFAL Linux на STM32MP157F-DK2

• Крок 01: Скапіруйце згенераваныя двайковыя файлы ў Discovery Kit з дапамогай прыведзеных ніжэй каманд
  
• Крок 02: Адкрыйце тэрмінал на плаце Discovery Kit або выкарыстайце ўваход па ssh і запусціце прыкладанне з дапамогай наступных каманд.
  Карыстальнік убачыць на экране наступнае паведамленне:
  
• Крок 03: Калі NFC tag знаходзіцца побач з прыёмнікам NFC, UID і NFC tag тып адлюстроўваецца на экране.

Набор Discovery, на якім працуе праграма nfcPoller

Як уключыць узровень Meta-nfc5 у пакет дыстрыбутыва

• Крок 01: Спампуйце і скампілюйце пакет дыстрыбутыва на вашай машыне Linux.
• Крок 02: Выконвайце структуру каталогаў па змаўчанні, прапанаваную вікі-старонкай ST, каб сінхронна сачыць за гэтым дакументам.
• Крок 03: Спампуйце пакет прыкладанняў X-LINUX-NFC5:
  
• Крок 04: Наладзьце канфігурацыю зборкі.
  
• Крок 05: Дадайце ўзровень meta-nfc5 у канфігурацыю зборкі канфігурацыі пакета распаўсюджвання.
  
• Крок 06: абнавіце канфігурацыю, каб дадаць новыя кампаненты ў ваш вобраз.
  
• Крок 07: Стварыце свой пласт асобна, а затым пабудуйце поўны ўзровень размеркавання.
  Заўвага: Стварэнне старонкі распаўсюджвання ў першы раз можа заняць некалькі гадзін. Аднак стварэнне ўзроўню meta-nfc5 і ўстаноўка выкананых файлаў у канчатковыя выявы зойме ўсяго некалькі хвілін. Пасля завяршэння зборкі выявы знаходзяцца ў наступным каталогу: build- - /tmp-glibc/deploy/images/stm32mp1.
• Крок 08: Выконвайце інструкцыі на вікі-старонцы ST: Прашыўка ўбудаванага вобраза для ўключэння новых убудаваных вобразаў на
  набор адкрыццяў.
• Крок 09: Запусціце прыкладанне, як паказана ў кроку 2 раздзела 3.4.

Як перадаць Files Выкарыстанне Tera Term

Для перадачы можна выкарыстоўваць праграму эмулятара тэрмінала Windows, напрыклад Tera Term fileз вашага ПК на Discovery Kit.

• Крок 01: Падключыце USB-сілкаванне да Discovery Kit.
• Крок 02: Падключыце Discovery Kit да ПК праз раздым USB micro B (CN11).
• Крок 03: Праверце нумар віртуальнага COM-порта ў дыспетчару прылад.
  На скрыншоце ніжэй нумар COM-порта роўны 14.
  Здымак экрана дыспетчара прылад, які паказвае віртуальны COM-порт
  
• Крок 04: Адкрыйце Tera Term на вашым ПК і абярыце COM-порт, вызначаны на папярэднім кроку. Хуткасць перадачы дадзеных павінна быць 115200 бод.
  Здымак аддаленага тэрмінала праз Tera Term
  
• Крок 05: Каб перадаць a file ад галоўнага ПК да Discovery Kit, абярыце [File]>[Перадача]>[ZMODEM]>[Адправіць] у левым верхнім куце акна Tera Term.
  Тэра тэрмін File Меню перадачы
  
• Крок 06: Выберыце file быць перададзены ў file браўзер і абярыце [Адкрыць].
  File Акно браўзера для адпраўкі Files
  .
• Крок 07: Індыкатар выканання пакажа стан file перадача.
  File Панэль прагрэсу перадачы
  

Гісторыя версій

Гісторыя версій дакумента

Дата	Версія	Змены
30-2020 кастрычніка	1	Першапачатковы выпуск.
15 ліпеня 2021 г	2	Абноўлены Раздзел 1.1 Асноўныя асаблівасці, Раздзел 2 Налада абсталявання, Раздзел 2.1 Як падключыць абсталяванне, Раздзел 3 Настройка праграмнага забеспячэння, Раздзел 3.1 Крокі для хуткай ацэнкі праграмнае забеспячэнне, Раздзел 3.2 Як абнавіць канфігурацыю платформы ў пакеце распрацоўшчыка і Раздзел 3.3 Як стварыць код прыкладання RFAL Linux. Дададзена Раздзел 3.5 Як уключыць узровень meta-nfc5 у пакет дыстрыбутыва. Дададзена інфармацыя аб сумяшчальнасці камплекта выяўлення STM32MP157F-DK2.

Дакументы / Рэсурсы

Пакет ST UM2766 X-LINUX-NFC5 для распрацоўкі счытвальніка NFC/RFID [pdfКіраўніцтва карыстальніка UM2766, пакет X-LINUX-NFC5 для распрацоўкі счытвальніка NFC-RFID, распрацоўка счытвальніка NFC-RFID, счытвальнік NFC-RFID, пакет X-LINUX-NFC5, X-LINUX-NFC5

Спасылкі

• Кіраўніцтва карыстальніка