ST X-LINUX-NFC5 User manual

Quick Start Guide
X-LINUX-NFC5
Linux® driver for the ST25R3911B high performance
NFC frontend
Version: 1.1
Date: July 22, 2021

Quick Start Guide Contents
1X-LINUX-NFC5: Linux® driver for the ST25R3911B high performance
NFC frontend overview
2Setup & Demo Examples
Documents & Related Resources
3STM32 MPU OpenSTLinux Software Expansion Package Overview
2

Software Description
•X-LINUX-NFC5 is a software expansion package
developed to demonstrate RFAL (Radio Frequency
Abstraction Layer) library for NFC based applications on
STM32MP157F-DK2 using ST25R3911B NFC device
•UID and NFC tag type is displayed on screen when the
tag is paced in range NFC antenna of X-NUCLEO-
NFC05A1 board.
•Demo application detect NFC Tag types such as NFC-A,
NFC-B, NFC-V and other types supported by RFAL library
•The package is easy to port across different Linux based
platforms with compatible hardware interface.
X-LINUX-NFC5
Software Overview
3

Hardware Description
•X-NUCLEO-NFC05A1 is an NFC card reader expansion
board based on ST25R3911B for STM32MP1, STM32 and
STM8 based platforms
•STM32MP157F-DK2 Discovery kit leverages the
capabilities of STM32MP1 series microprocessors to allow
users easily develop applications using STM32 MPU
OpenSTLinux distribution software
X-LINUX-NFC5
Hardware Overview
4
X-NUCLEO-NFC05A1
board plugged over
STM32MP157F-DK2
View of connectors
on the board
Arduino
connectors
STM32MP157F-DK2
X-NUCLEO-NFC05A1
Key Products on board
STM32MP157F
Microprocessor
ST25R3911B
High performance HF reader / NFC initiator

Quick Start Guide Contents
1X-LINUX-NFC5: Linux® driver for the ST25R3911B high performance
NFC frontends overview
2Setup & Demo Examples
Documents & Related Resources
3STM32 MPU OpenSTLinux Software Expansion Package : Overview
5

Hardware requirements
•1x STM32MP157F-DK2 board (Discovery Kit)
•1x X-NUCLEO-NFC05A1 (expansion board for
ST25R3911B)
•1x Linux - Laptop/PC (Ubuntu 16.04 LTS or higher)
•1x USB Type A to micro USB cable
•1x USB PD compliant 5V 3A power supply
•1x cable with USB-Type C to connect STM32MP1 with PC
•micro SD card ( minimum 4GB )
Setup & Demo Example
Hardware Pre-requisites
6
STM32MP157F-DK2
(Discovery Kit)
X-NUCLEO-NFC05A1

Software requirements
•Boot the Discovery Kit with Starter Package. Please refer
to instructions at wiki page Getting Started with
STM32MP157F-DK2 baord
•Download the X-LINUX-NFC5 package. Extract it to find
the pre-built images for evaluation
•Follow instructions on wiki page to copy the pre-built files
and device tree blob at correct locations (or build using
Developer Package and source code of application),
restart the Discovery Kit and run the Demo application.
Wiki page link : X-NUCLEO NFC05A1 expansion board
•Snapshot of running application on Discovery Kit. Remote
terminal applications such as Tera-Term or Minicom can
also be used
Setup & Demo Example
Software Pre-requisites
7

•Boot the STM32MP157F-DK2 board with Starter Package. Please refer to instructions at wiki page Getting Started with
STM32MP157F-DK2 board
•Download the X-LINUX-NFC5 package and transfer the below files to respective locations on board using Tera-Term (see
next slide for help)–
•Connect to Discovery Kit using Tera-Term- settings below –
•Baud 115200
•For COM port number, check device manager for enumeration similar to below snapshot
•Once connected run below commands –
•Run the application using below commands -
Setup (1/2)
Installation Steps
8
Board $> /sbin/depmod –a
Board $> sync
Board $> reboot
Downloaded File Location in DK2 Board
STM32MP157F-DK2_DeviceTree/Binaries/stm32mp157f-dk2.dtb /boot/
NFCPollerApplication/Binaries/nfc_poller_st25r3911 /usr/bin/
NFCPollerApplication/Binaries/librfal_st25r3911.so /usr/lib/
Board $> cd /usr/bin
Board $> ./nfc_poller_st25r3911

•Connect the Discovery Kit to the Internet / Intranet via LAN or Wi-Fi and use ssh commands for accessing the board or scp
command for transferring files. Any alternate method can be used for file transfer / access. For example, below steps need
to be executed on TERA-TERM :
•Connect the Discovery Kit to your PC via USB type-A to type-micro B cable.
•Check the Virtual COM port number visible in the device manager. For example, in below snapshot, the COM port
number is 14.
•Open Tera-Term on your PC and select the COM port (as found in step 3 above). The baud rate should be 115200 baud.
The virtual terminal (remote access) will appear.
•To transfer a file from host PC to Discovery Kit, click on File menu on top left corner of the Tera-Tem window and go to
File>>Transfer>>ZMODEM>>Send. The select desired file for sending it to the /usr location of Discovery Kit. Below
snapshots -
Setup (2/2)
Transfer files from PC to Discovery Kit
9

•All documents are available on the www.st.com
•User Manual
•Data Brief
•Quick Start Guide
•Source code
•Wiki page on https://wiki.st.com/stm32mpu
Documents & Related Resources
10