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

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
11

STM32 MPU OpenSTLinux Software Expansion Package:
all that you need
12
The building blocks Your need Our answer
Bluetooth LE, Sub-GHz radio
NFC, Wi-Fi, GNSS
Energy management & battery
General-purpose microcontrollers
Secure microcontrollers
Stepper motor driver
DC & BLDC motor driver
Industrial input / output
Audio amplifier
Touch controller
Operation Amplifier
Accelerometer, gyroscope
Inertial modules, magnetometer
Pressure, temperature, humidity
Proximity, microphone
Move / Actuate
Connect
Power
Sense
Process
COLLECT
TRANSMIT
ACCESS
CREATE
POWER
PROCESS
Software
Translate

•X-LINUX Software Expansion Package is developed on A7 core of STM32MP1 for stand alone
applications and applications using X-NUCLEO boards
•X-NUCLEO expansion board can be plugged on Arduino connector or HAT board can be plugged
on the 40-pin connector available on the STM32MP157F-DK2 board
X-LINUX Software Expansion Package
13

STM32MPU Embedded Software
•More complex
•Multiple piece of software to deliver
•STM32CubeMP1 is part of it
14
Application
Frameworks
Linux Kernel
OP-TEE
U-Boot
TF-A
Cortex-A and Cortex-M cores
X-LINUX-
NFC5
OpenSTLinux
Expansion Package

STM32MPU Embedded Software
15
Boot chain
Cortex-A7
Non-Secure
LINUX
Cortex
M4
Cortex-A7
Secure
OP-TEE
STM32MPU Embedded Software
OpenSTLinux
Application frameworks
OpenSTLinux BSP
U-BootTF-AOP-TEE Linux
kernel
OP-TEE Linux
Kernel space
User space STM32Cube
MPU Package
Trusted
Applications
X-LINUX-NFC5
Software
Expansion
Package
Applications
Platform
configuration
ST Community
Applications
Legend

Software packages presentation
16
•Starter Package
•Used to quickly and easily start with any STM32MP
microprocessor device. The Starter package is
generated from the Distribution Package.
•Developer Package
•Used to add your own developments on top of the
STM32MPU Embedded Software distribution, or to
replace the Starter package pre-built binaries. The
Developer Package is generated from the Distribution
Package.
•Distribution Package
•Used to create your own Linux®distribution, your own
Starter package and your own Developer Package.

More info:
https://wiki.st.com/stm32mpu

For more information on ST products and solutions, visit www.st.com
© STMicroelectronics - All rights reserved.
ST logo is a trademark or a registered trademark of STMicroelectronics International NV or its affiliates in the EU and/or other countries.
For additional information about ST trademarks, please refer to www.st.com/trademarks.
All other product or service names are the property of their respective owners.
Thank You