ST UM2766 X-LINUX-NFC5 Pakiet do opracowania czytnika NFC/RFID

Wstęp

Ten pakiet rozszerzeń oprogramowania STM32 MPU OpenSTLinux demonstruje, w jaki sposób można opracować komunikację NFC/RF dla standardowego systemu Linux przy użyciu naszej biblioteki abstrakcji częstotliwości radiowych (RFAL). Sterownik wspólnego interfejsu RFAL zapewnia zgodność funkcji użytkownika i oprogramowania aplikacji z dowolnym układem scalonym czytnika ST25R NFC/RFID.
Pakiet X-LINUX-NFC5 przenosi RFAL do zestawu Discovery z mikroprocesorem serii STM32MP1 z systemem Linux, aby sterować interfejsem ST25R3911B NFC na karcie rozszerzeń STM32 Nucleo. Pakiet zawiera jakample aplikacja, która pomoże Ci zrozumieć wykrywanie różnych typów NFC tags oraz telefony komórkowe obsługujące P2P.
Kod źródłowy został zaprojektowany z myślą o przenośności w szerokim zakresie jednostek przetwarzających z systemem Linux i obsługuje wszystkie niższe warstwy oraz niektóre protokoły wyższych warstw układów scalonych ST25R w celu abstrakcyjnej komunikacji RF.

Biblioteka abstrakcji częstotliwości radiowych dla systemu Linux

RFAL	Protokoły	ISO DEP			Funkcja NFC
	Technologie	NFC-A	NFC-B	NFC-F	NFC-V	T1T	ST25 TB
	HAL	RF
		Konfiguracje RF
		ST25R3911B

Koniec X-LINUX-NFC5view

Główne cechy

Pakiet rozszerzenia oprogramowania X-LINUX-NFC5 obejmuje następujące funkcje:

• Kompletny sterownik przestrzeni użytkownika dla systemu Linux (warstwa abstrakcji RF) do tworzenia aplikacji obsługujących NFC przy użyciu interfejsu ST25R3911B/ST25R391x NFC o mocy wyjściowej do 1.4 W.
• Komunikacja hosta Linux z ST25R3911B/ST25R391x za pośrednictwem szybkiego interfejsu SPI.
• Pełna abstrakcja RF/NFC (RFAL) dla wszystkich głównych technologii i protokołów wyższych warstw:
  • NFC-A (ISO14443-A)
  • NFC-B (ISO14443-B)
  • NFC-F (FeliCa)
  • NFC-V (ISO15693)
  • P2P (ISO18092)
  • ISO-DEP (protokół wymiany danych ISO, ISO14443-4)
  • NFC-DEP (protokół wymiany danych NFC, ISO18092)
  • Autorskie technologie (Kovio, B', iClass, Calypso itp.)
• SampImplementacja dostępna z kartą rozszerzeń X-NUCLEO-NFC05A1 podłączoną do STM32MP157F-DK2
• SampLe aplikacja do wykrywania kilku NFC tags typy

Architektura pakietu

Pakiet oprogramowania działa na rdzeniu A7 serii STM32MP1. X-LINUX-NFC5 współdziała z bibliotekami niższych warstw i liniami SPI udostępnianymi przez środowisko oprogramowania Linux.

Architektura aplikacji X-LINUX-NFC5 w środowisku Linux

Konfiguracja sprzętu

Wymagania sprzętowe:

• Komputer PC/maszyna wirtualna z systemem Ubuntu w wersji 16.04 lub nowszej
• Płytka STM32MP157F-DK2 (Zestaw Discovery)
• X-NUCLEO-NFC05A1
• Karta microSD o pojemności 8 GB do rozruchu STM32MP157F-DK2
• Czytnik kart SD / łączność LAN
• Kabel USB typu A do typu micro B
• Kabel USB typu A na USB typu C
• Zasilacz 5 V 3A zgodny z USB PD

Komputer PC/maszyna wirtualna stanowi platformę do rozwoju wielu aplikacji do budowania biblioteki RFAL i kodu aplikacji do wykrywania i komunikacji z urządzeniami NFC za pośrednictwem układu ST25R3911B IC.

Jak podłączyć sprzęt?

Krok 1. Podłącz kartę rozszerzeń X-NUCLEO-NFC05A1 do złączy Arduino na spodzie płytki wykrywania STM32MP157F-DK2.

Złącza Arduino dla płytki Nucleo i Discovery

1. Karta rozszerzeń X-NUCLEO-NFC05A1
2. Płytka wykrywania STM32MP157F-DK2
3. Złącza Arduino

Krok 2. Podłącz programator/debugger ST-LINK wbudowany w płytkę wykrywania do komputera hosta przez port USB typu micro B (CN11).

Krok 3. Zasil płytę wykrywania przez port USB typu C (CN6).

Pełna konfiguracja połączenia sprzętowego

LINKI POWIĄZANE
Zapoznaj się z tą wiki, aby uzyskać więcej informacji dotyczących zasilania i portów komunikacyjnych

Konfiguracja oprogramowania

Przed rozpoczęciem podłącz zestaw Discovery STM32MP157F-DK2 do zasilacza 5 V, 3 A zgodnego z USB PD i zainstaluj pakiet startowy zgodnie z instrukcjami w wiki Rozpoczęcie pracy. Do flashowania obrazów rozruchowych potrzebna będzie karta microSD o pojemności co najmniej 2 GB.
Aby uruchomić aplikację, należy zaktualizować konfigurację platformy, aktualizując drzewo urządzeń w celu włączenia odpowiednich urządzeń peryferyjnych. Możesz to zrobić szybko, korzystając z dostępnych gotowych obrazów lub możesz opracować drzewo urządzeń i zbudować własne obrazy jądra.
Możesz także (opcjonalnie) zbudować ten pakiet oprogramowania, dołączając warstwę Yocto (meta-nfc5 ) do pakietu dystrybucyjnego ST. Ta operacja tworzy kod źródłowy i obejmuje modyfikacje drzewa urządzenia wraz ze skompilowanymi plikami binarnymi w końcowych obrazach do flashowania. Szczegółowe kroki opisujące proces znajdują się w Sekcji 3.5 .
Z zestawem Discovery Kit można połączyć się z komputera hosta przez sieć TCP/IP za pomocą poleceń ssh i scp lub przez szeregowe łącza UART lub USB przy użyciu narzędzi takich jak minicom dla systemu Linux lub Tera Term dla systemu Windows.

Kroki do szybkiej oceny oprogramowania

• Krok 01: Flash pakiet startowy na karcie SD.
• Krok 02: Uruchom płytę z pakietem startowym.
• Krok 03: Włącz łączność z Internetem na płycie przez Ethernet lub Wi-Fi. Aby uzyskać pomoc, zapoznaj się z odpowiednimi stronami wiki.
• Krok 04: Pobierz gotowe obrazy z X-LINUX-NFC5 web strona na ST webstrona
• Krok 05: Użyj następujących poleceń, aby skopiować obiekt blob drzewa urządzeń i zaktualizować nową konfigurację platformy:
  Jeśli połączenie sieciowe nie jest dostępne, możesz przenieść files lokalnie z komputera z systemem Windows do zestawu Discovery Kit przy użyciu Tera Term.
  Więcej informacji na temat przesyłania danych files przy użyciu Tera Term.
  
• Krok 06: Po uruchomieniu tablicy skopiuj plik binarny aplikacji i udostępnioną bibliotekę na tablicę wykrywania.
  Aplikacja uruchomi się po wykonaniu tych poleceń.

Jak zaktualizować konfigurację platformy w pakiecie programisty?

Poniższe kroki pozwolą Ci skonfigurować środowisko programistyczne.

• Krok 01: Pobierz pakiet programisty i zainstaluj pakiet SDK w domyślnej strukturze folderów na komputerze z systemem Ubuntu.
  Instrukcje znajdziesz tutaj: Zainstaluj SDK
• Krok 02: Otwórz drzewo urządzeń file „stm32mp157f-dk2.dts” w kodzie źródłowym pakietu deweloperskiego i dodaj poniższy fragment kodu do file:
  Spowoduje to zaktualizowanie drzewa urządzeń w celu włączenia i skonfigurowania interfejsu sterownika SPI4.
  
• Krok 03: Skompiluj pakiet deweloperski, aby uzyskać stm32mp157f-dk2.dtb file.

Jak zbudować kod aplikacji RFAL Linux?

Zanim zaczniesz, SDK musi zostać pobrany, zainstalowany i włączony. Pobierz aplikację z linku: X-LINUX-NFC5

• Krok 1. Uruchom poniższe polecenia, aby skompilować kod:
  Te polecenia zbudują następujące files:
  • Byłyampplik aplikacji: nfc_poller_st25r3911
  • współdzielona biblioteka do uruchamiania exampplik aplikacji: librfal_st25r3911.so
    

Jak uruchomić aplikację RFAL Linux na STM32MP157F-DK2?

• Krok 01: Skopiuj wygenerowane pliki binarne do Discovery Kit za pomocą poniższych poleceń
  
• Krok 02: Otwórz terminal na płycie Discovery Kit lub użyj logowania ssh i uruchom aplikację za pomocą następujących poleceń.
  Użytkownik zobaczy na ekranie poniższy komunikat:
  
• Krok 03: Kiedy NFC tag znajduje się w pobliżu odbiornika NFC, UID i NFC tag typ jest wyświetlany na ekranie.

Zestaw Discovery z uruchomioną aplikacją nfcPoller

Jak dołączyć warstwę Meta-nfc5 do pakietu dystrybucyjnego?

• Krok 01: Pobierz i skompiluj pakiet dystrybucyjny na swoim komputerze z systemem Linux.
• Krok 02: Postępuj zgodnie z domyślną strukturą katalogów sugerowaną przez stronę wiki ST, aby synchronicznie podążać za tym dokumentem.
• Krok 03: Pobierz pakiet aplikacji X-LINUX-NFC5:
  
• Krok 04: Skonfiguruj konfigurację kompilacji.
  
• Krok 05: Dodaj warstwę meta-nfc5 do konfiguracji kompilacji konfiguracji pakietu dystrybucyjnego.
  
• Krok 06: Zaktualizuj konfigurację, aby dodać nowe komponenty do obrazu.
  
• Krok 07: Zbuduj swoją warstwę osobno, a następnie zbuduj kompletną warstwę dystrybucyjną.
  Notatka: Budowanie strony dystrybucyjnej po raz pierwszy może zająć kilka godzin. Jednak zbudowanie warstwy meta-nfc5 i zainstalowanie plików wykonywalnych w końcowych obrazach zajmuje tylko kilka minut. Po zakończeniu kompilacji obrazy znajdują się w następującym katalogu: build- - /tmp-glibc/deploy/images/stm32mp1.
• Krok 08: Postępuj zgodnie z instrukcjami na stronie wiki ST: Flashowanie zbudowanego obrazu, aby sflashować nowo zbudowane obrazy na
  zestaw do odkrycia.
• Krok 09: Uruchom aplikację, jak wspomniano w kroku 2 sekcji 3.4.

Jak przenieść Files Korzystanie z Tera Term

Do transferu możesz użyć aplikacji emulatora terminala Windows, takiej jak Tera Term files z komputera do zestawu Discovery.

• Krok 01: Podłącz zasilanie USB do zestawu Discovery.
• Krok 02: Podłącz zestaw Discovery do komputera za pomocą złącza USB typu micro B (CN11).
• Krok 03: Sprawdź numer wirtualnego portu COM w menedżerze urządzeń.
  Na poniższym zrzucie ekranu numer portu COM to 14.
  Zrzut ekranu Menedżera urządzeń pokazujący wirtualny port Com
  
• Krok 04: Otwórz Tera Term na swoim komputerze i wybierz port COM zidentyfikowany w poprzednim kroku. Szybkość transmisji powinna wynosić 115200 bodów.
  Migawka zdalnego terminala za pośrednictwem Tera Term
  
• Krok 05: Aby przenieść a file z komputera-hosta do zestawu Discovery, wybierz [File]>[Transfer]>[ZMODEM]>[Wyślij] w lewym górnym rogu okna Tera Term.
  Termin Tera File Menu transferu
  
• Krok 06: Wybierz file do przeniesienia w file przeglądarki i wybierz [Otwórz].
  File Okno przeglądarki do wysyłania Files
  .
• Krok 07: Pasek postępu pokaże status file przenosić.
  File Pasek postępu transferu
  

Historia rewizji

Historia rewizji dokumentu

Data	Wersja	Zmiany
30-paź-2020	1	Pierwsze wydanie.
15-lip-2021	2	Zaktualizowano Sekcja 1.1 Główne cechy, Sekcja 2 Konfiguracja sprzętu, Sekcja 2.1 Jak podłącz sprzęt, Sekcja 3 Konfiguracja oprogramowania, Sekcja 3.1 Etapy szybkiej oceny oprogramowanie, Sekcja 3.2 Jak zaktualizować konfigurację platformy w pakiecie deweloperskim I Sekcja 3.3 Jak zbudować kod aplikacji RFAL Linux. W dodatku Sekcja 3.5 Jak dołączyć warstwę meta-nfc5 do pakietu dystrybucyjnego. Dodano informacje o kompatybilności zestawu wykrywania STM32MP157F-DK2.

Dokumenty / Zasoby

ST UM2766 X-LINUX-NFC5 Pakiet do opracowania czytnika NFC/RFID [plik PDF] Instrukcja obsługi UM2766, pakiet X-LINUX-NFC5 do opracowania czytnika NFC-RFID, do opracowania czytnika NFC-RFID, czytnik NFC-RFID, pakiet X-LINUX-NFC5, X-LINUX-NFC5

Odniesienia

• Instrukcja obsługi