ST UM2766 X-LINUX-NFC5 пакет за развој на NFC/RFID читач

Вовед

Овој пакет за проширување на софтверот STM32 MPU OpenSTLinux покажува како можете да развиете NFC/RF комуникација за стандарден Linux систем користејќи ја нашата библиотека за апстракција на радио фреквенции (RFAL). Двигателот за заеднички интерфејс RFAL осигурува дека корисничката функција и апликативниот софтвер се компатибилни со кој било IC на ST25R NFC/RFID читач.
Пакетот X-LINUX-NFC5 го пренесува RFAL на комплет за Discovery со микропроцесор од серијата STM32MP1 што работи со Linux за да управува со предниот дел ST25R3911B NFC на плочката за проширување STM32 Nucleo. Пакетот вклучува какоampле апликација за да ви помогне да го разберете откривањето на различни типови на NFC tags и мобилни телефони кои поддржуваат P2P.
Изворниот код е дизајниран за преносливост низ широк опсег на процесорски единици кои работат со Linux и ги поддржува сите пониски слоеви и некои протоколи со повисоки слоеви на ST25R IC за апстрактна RF комуникација.

Библиотека за апстракција на радио фреквенција за Linux

РФАЛ	Протоколи	ISO DEP			NFC DEP
	Технологии	NFC-A	NFC-B	NFC-F	NFC-V	Т1Т	ST25TB
	ХАЛ	RF
		RF конфигурации
		ST25R3911B

X-LINUX-NFC5 Завршиview

Главни карактеристики

Пакетот за проширување на софтверот X-LINUX-NFC5 ги вклучува следните карактеристики:

• Комплетен двигател за кориснички простор на Linux (слој за апстракција на RF) за да се создадат апликации со овозможен NFC користејќи ги предните краеви ST25R3911B/ST25R391x NFC со излезна моќност до 1.4 W.
• Комуникација на домаќин на 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 (комплет за откривање)
• X-NUCLEO-NFC05A1
• 8 GB micro SD картичка за подигање на STM32MP157F-DK2
• Читач на SD картички / LAN поврзување
• USB-кабел од тип А до тип-микро Б USB
• УСБ-кабел од типот А до тип-C
• Напојување од 5V 3A, усогласено со 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 програмерот/дебагерот вграден на таблата за откривање со компјутерот-домаќин преку приклучокот USB micro B од типот (CN11).

Чекор 3. Напојувајте ја таблата за откривање преку приклучокот USB од тип C (CN6).

Целосно поставување на хардверска врска

ПОВРЗАНИ ЛИНКИ
Погледнете го ова вики за повеќе детали поврзани со портите за напојување и комуникација

Поставување на софтвер

Пред да започнете, напојувајте го STM32MP157F-DK2 Discovery комплетот преку напојување компатибилен со USB PD 5 V, 3 A и инсталирајте го почетниот пакет според упатствата во викито За почеток. Ќе ви треба минимум 2 GB microSD картичка за да ги трепкате бутабилните слики.
За да ја извршите апликацијата, конфигурацијата на платформата треба да се ажурира со ажурирање на дрвото на уредот за да се овозможат соодветните периферни уреди. Можете да го направите ова брзо со користење на достапните претходно изградени слики или можете да го развиете дрвото на уредот и да изградите свои слики од јадрото.
Можете исто така (опционално) да го изградите овој софтверски пакет со вклучување на слојот Yocto (мета-nfc5 ) во пакетот за дистрибуција ST. Оваа операција го креира изворниот код и ги вклучува модификациите на стеблото на уредот заедно со компајлираните бинарни датотеки во последните слики што може да се трепкаат. За детални чекори кои го опишуваат процесот, видете во Дел 3.5.
Може да се поврзете со Discovery Kit од компјутерот домаќин преку TCP/IP мрежа користејќи ssh и scp команди или преку сериски UART или USB врски користејќи алатки како minicom за Linux или Tera Term за Windows.

Чекори за брза евалуација на софтверот

• Чекор 01: Трепкајте го почетниот пакет на SD-картичката.
• Чекор 02: Подигнете ја плочката со Starter Package.
• Чекор 03: Овозможете интернет конекција на таблата преку етернет или Wi-Fi. За помош, погледнете ги соодветните вики страници.
• Чекор 04: Преземете претходно вградени слики од X-LINUX-NFC5 web страница на ST webсајт
• Чекор 05: Користете ги следните команди за да ја копирате дупката од дрвото на уредот и да ја ажурирате конфигурацијата на новата платформа:
  Ако мрежното поврзување не е достапно, можете да го префрлите fileЛокално од вашиот Windows PC до Discovery Kit користејќи Tera Term.
  За повеќе детали за пренос на податоци files користи Тера Термин.
  
• Чекор 06: Откако ќе се подигне таблата, копирајте ја бинарната апликација и споделената lib на таблата за откривање.
  Апликацијата ќе започне да работи откако ќе се извршат овие команди.

Како да ја ажурирате конфигурацијата на платформата во пакетот за програмери

Следниве чекори ќе ви овозможат да ја поставите околината за развој.

• Чекор 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
  • споделени lib за водење на ексampле апликација: librfal_st25r3911.so
    

Како да ја извршите апликацијата RFAL Linux на STM32MP157F-DK2

• Чекор 01: Копирајте ги генерираните бинарни датотеки во комплетот Discovery користејќи ги командите подолу
  
• Чекор 02: Отворете го терминалот на таблата Discovery Kit или користете ssh најавување и стартувајте ја апликацијата користејќи ги следните команди.
  Корисникот ќе ја види следнава порака на екранот:
  
• Чекор 03: Кога NFC tag е доведена во близина на NFC приемникот, UID и NFC tag типот се прикажува на екранот.

Комплет за откривање работи со апликацијата nfcPoller

Како да го вклучите слојот Meta-nfc5 во пакетот за дистрибуција

• Чекор 01: Преземете и компајлирајте го пакетот за дистрибуција на вашата машина Линукс.
• Чекор 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

Може да користите апликација за емулатор на Windows терминал како Tera Term за пренос fileод вашиот компјутер до комплетот Discovery.

• Чекор 01: Напојување со USB на комплетот Discovery.
• Чекор 02: Поврзете го Discovery Kit со вашиот компјутер преку USB-микро Б-тип конектор (CN11).
• Чекор 03: Проверете го бројот на виртуелната COM порта во менаџерот на уредот.
  На сликата од екранот подолу, бројот на COM портата е 14.
  Слика од екранот на Управувачот со уреди што ја прикажува виртуелната ком-порта
  
• Чекор 04: Отворете го Tera Term на вашиот компјутер и изберете ја COM портата идентификувана во претходниот чекор. Стапката на бауд треба да биде 115200 бауд.
  Снимка од далечинскиот терминал преку Тера термин
  
• Чекор 05: За пренос на a file од компјутерот домаќин до комплетот за откривање, изберете [File]>[Пренеси]>[ZMODEM]>[Испрати] во горниот лев агол на прозорецот Тера Термин.
  Тера Термин File Мени за трансфер
  
• Чекор 06: Изберете го file да се пренесат во file прелистувач и изберете [Open].
  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 Како да се вклучи слојот мета-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

Референци

• Упатство за употреба