Introduction
The ST UHF library (STSW-ST25RU-SDK) is a middleware software stack written in ANSI C, to build RAIN
®
RFID enabled
applications for reader devices based on ST25RU3993. This document describes the usage of the ST UHF library software API.
Along with this package, a comprehensive demonstration source code is available to illustrate the usage of the ST UHF library
for Windows
®
and Linux
®
platforms. The complete software stack is ANSI C and POSIX compatible and enables fast and
straightforward porting to other operating systems and/or toolchains.
UHF application
STUHFL
Standards
EPC UHF
Gen2V2
...
Device
Protocol
Bus
ST25RU3993-HPEV board firmware
HAL
ST25RU3993 ST UHF library
UM2618
User manual
UM2618 - Rev 4 - April 2021
For further information contact your local STMicroelectronics sales office.
www.st.com
1 System overview
The ST UHF library (STUHFL) design is a classic middleware software stack running on a host system. It
provides a simple software API to abstract low-level communication details. As shown in the simplified system
overview the system is made up of two hardware components running the involved software components.
Figure 1. System overview
Host
STUHFL
UHF application
IRQ
SPI
ST25RU3993 firmware
Device/reader module
ST25RU3993
STUHFL EVAL API
The first component (device/reader module) runs the firmware with low-level driver implementation to operate
the ST25RU3993 reader IC and various protocols. The firmware implements a software interface to the ST UHF
library.
The second component (host side) runs the ST UHF library and abstracts the low-level functionality. It provides a
clean software API for UHF applications.
The ST UHF library runs on host systems with an operating system as well as on embedded systems (with OS
or native), with limited resources. Even a design without a dedicated host module is possible, where the complete
system runs on the reader module only.
1.1
General information
The software described in this document supports Arm
®
-based device.
Note: Arm is a registered trademark of Arm Limited (or its subsidiaries) in the US and/or elsewhere.
1.2 Features
• Comprehensive middleware to build RAIN
®
RFID enabled applications for reader devices based on
ST25RU3993
• Mirrored host and device library API
• Written in pure ANSI C99
• POSIX compatible
UM2618
System overview
UM2618 - Rev 4
page 2/24