UM3526
Bukana ea mosebelisi

Ho qala ka katoloso ea software ea X-CUBE-NFC12 e phahameng ea NFC ea 'mali / e qalang IC bakeng sa STM32Cube.

Selelekela

The X-CUBE-NFC12 software expansion for STM32Cube provides complete middleware for STM32 to control payment, consumer and industrial applications using the ST25R300 high performance NFC front-end IC, supporting NFC initiator, target, reader, and card emulation modes.
The expansion is built on top of STM32Cube software technology to ease portability across different STM32 microcontrollers.
Software e tla le sample ts'ebetsong ea bakhanni ba sebetsang botong ea katoloso ea X-NUCLEO-NFC12A1, e hoketsoeng holim'a boto ea ntlafatso ea NUCLEO-G0B1RE kapa NUCLEO-L476RG kapa NUCLEO-C071RB.

Lihokelo tse amanang
Etela tikoloho ea STM32Cube web leqepheng la www.st.com bakeng sa lintlha tse ling

Acronyms le khutsufatso

Lethathamo la 1. Lethathamo la li-acronyms

Kgutsufatso	Tlhaloso
NFC	Puisano e haufi le tšimo
RFAL	RF abstract layer
P2P	Thaka ho thaka
MCU	Setsi sa Microcontroller
BSP	Sephutheloana sa tšehetso sa boto
HALALA	Hardware abstraction layer
LED	Khanya e ntšang diode
SPI	Serial peripheral interface
CMSIS	Arm®  Cortex®  microcontroller software interface standard

X-CUBE-NFC12 katoloso ea software bakeng sa STM32Cube

2.1 Ho fetaview
Sephutheloana sa software sa X-CUBE-NFC12 se holisa ts'ebetso ea STM32Cube. Lintlha tse ka sehloohong tsa pakete ke:

• Complete middleware to build applications using the ST25R300 high performance NFC reader, initiator, target, and card emulation front-end IC.
• Sample sesebelisoa sa ho bona NFC tags tsa mefuta e fapaneng.
• Sample implementations available for the X-NUCLEO-NFC12A1 expansion board plugged onto a NUCLEO-G0B1RE or NUCLEO-L476RG or NUCLEO-C071RB development board.
• E bonolo ho pholletsa le malapa a fapaneng a MCU, ka lebaka la STM32Cube.
• Complete RF/NFC abstraction (RFAL) for all major technologies, including complete ISO-DEP and NFC- DEP layers.
• Lipehelo tsa laesense tsa mahala, tse bonolo ho basebelisi.

Software ena e na le li-driver tsa NFC tse sebetsang hantle / tse qalang tsa IC bakeng sa sesebelisoa sa ST25R300, se sebetsang ho STM32. E hahiloe ka holim'a theknoloji ea software ea STM32Cube ho nolofatsa ts'ebetso ho li-microcontroller tse fapaneng tsa STM32.
Sephutheloana sena sa firmware se kenyelletsa bakhanni ba lisebelisoa tsa likarolo, sephutheloana sa tšehetso sa boto, le joalo kaample kopo e bonts'ang ts'ebeliso ea boto ea katoloso ea X-NUCLEO-NFC12A1 ka liboto tsa STM32 Nucleo.
A sampSesebelisoa se hlophisa ST25R300 sebakeng sa likhetho bakeng sa ho lemoha lisebelisoa tse sebetsang le tse sa sebetseng. Ha motho a sa etse letho tag kapa sesebelisoa se sebetsang se fumanoa, tšimo ea 'mali e bontša theknoloji e fumanoeng ka ho fetola LED e lumellanang le eona. Hape hoa khoneha ho beha ST25R300 ka mokhoa oa ho tsoha ka inductive ka ho tobetsa konopo ea mosebedisi. Nakong ena ea khetho ea likhetho, sampLe application e boetse e beha ST25R300 ka mokhoa oa ho etsisa karete ho bona boteng ba 'mali.
Demo e boloka mesebetsi eohle ho moamoheli oa sistimi ka ST-LINK virtual COM port.
Theknoloji ea RFID e tšehetsoeng ho demo ena ke:

• ISO14443A/NFCA.
• ISO14443B/NFCB.
• Felica/NFCF.
• ISO15693/NFCV.
• Mohlala oa karete ea mofuta oa A le F.

2.2 Boqapi ba Meaho
Katoloso ena ea software e tsamaellanang ka botlalo ea STM32Cube e u fa monyetla oa ho nts'etsapele lits'ebetso u sebelisa ST25R300 sebali sa NFC se qalang IC. E thehiloe holim'a STM32CubeHAL hardware abstraction layer bakeng sa microcontroller ea STM32, 'me e atolosa STM32Cube ka sephutheloana sa tšehetso sa boto (BSP) bakeng sa boto ea katoloso ea X-NUCLEONFC12A1.

Software ea kopo e ka fihlella le ho sebelisa boto ea katoloso ea X-NUCLEO-NFC12A1 ka likarolo tse latelang:

• STM32Cube HAL layer: the HAL driver layer provides a simple set of generic, multi-instance application programming interfaces (APIs) to interact with the upper layers (application, libraries, and stacks). These generic and extension APIs are directly built on a common architecture and allow overlying layers like middleware to implement their functions without depending on specific microcontroller unit (MCU) hardware information. This structure improves the library code reusability and guarantees easy portability across other devices.
• Board support package (BSP) layer: the BSP provides support for the peripherals on the STM32 Nucleo board, apart from the MCU. This set of APIs provides a programming interface for certain board-specific peripherals like the LED, the user button etc. This interface also helps you identify the specific board version.
• Middleware NRF abstraction layer (RFAL): the RFAL provides several functions for RF/NFC communication. It possesses RF IC (existing ST25R300 device) under a common and easy to use interface.

Melao-motheo e fanoeng ke RFAL ke:

• ISO-DEP (ISO14443-4 data link layer, T = CL).
• NFC-DEP (Protocol ea phapanyetsano ea data ea ISO18092).
• NFC-A\ISO14443A (T1T, T2T, T4TA).
• NFC-B\ISO14443B (T4TB).
• NFC-F\FeliCa (T3T).
• NFC-V\ISO15693 (T5T).
• P2P\ISO18092 (NFCIP1, Passive-Active P2P).
• ST25TB (ISO14443-2 Mofuta oa B o nang le Protocol ea Proprietary).

Ka hare, RFAL e arotsoe ka likaroloana tse tharo:

• RF e phahameng lera (RF HL).
• RF hardware abstraction layer (RF HAL).
• RF abstraction layer (RF AL).

Li-module tsa RF HAL li itšetlehile ka chip. Ba kenya tšebetsong mokhanni oa RF IC, litafole tsa tlhophiso, le litaelo tse tobileng bakeng sa HW ho etsa mesebetsi ea 'mele ea RF.
Khokahano ea motho ea letsetsang ke hlooho ea RF e arolelanoang file, e fanang ka sebopeho se tšoanang bakeng sa likarolo tse ka holimo (bakeng sa li-chips tsohle).
RFAL e ka aroloa ka likarolo tse ling tse peli:

• Theknoloji: li-module tsa theknoloji tse sebelisang lintlha tsohle, ho etsa moralo, linako, joalo-joalo.
• Protocols: ts'ebetsong ea protocol ho kenyelletsa le meralo eohle, linako, ho sebetsana le liphoso, jj.

Ka holim'a tsena, karolo ea kopo e sebelisa mesebetsi ea RFAL joalo ka NFC Forum Activities (NFCC), EMVCo®, DISCO/ NUCLEO demo, joalo-joalo.
Mojule oa RFAL NFC o fana ka sebopeho sa ho etsa mesebetsi e tloaelehileng joalo ka sesebelisoa sa poller / momameli.
Ho fihlella mesebetsi e tlase haholo ea li-IC ho fanoa ke mojule oa RF. Motho ea letsetsang a ka sebelisa ka kotloloho theknoloji efe kapa efe ea RF kapa likarolo tsa protocol ntle le ho hloka data efe kapa efe ea tlhophiso ea hardware.

2.3 Sebopeho sa foldara

Li-folders tse latelang li kenyelelitsoe ka har'a sephutheloana sa software:

• Litokomane: e na le HTML e hlophisitsoeng file e hlahisoang ke khoutu ea mohloli, e hlalosang likarolo tsa software le li-API.
• Drivers: it contains HAL drivers, board-specific drivers for each supported board or hardware platform, including the on-board components, and the CMSIS vendor-independent hardware abstraction layer for the Cortex®-M processor series.
• Middlewares: it contains RF abstraction layer (RFAL). RFAL provides several functions required to perform RF/NFC communication.
  RFAL e na le RF IC (ST25R300) tlasa sebopeho se tloaelehileng le se bonolo ho se sebelisa.
• Merero: e na le sample kopo example, e leng, NFC12A1_PollingTagLemoha.

Li fanoa bakeng sa sethala sa NUCLEO-L476RG, NUCLEO-G0B1RE kapa NUCLEO-C071RB bakeng sa libaka tse tharo tsa ntlafatso: IAR Embedded Workbench® for Arm, Keil® Microcontroller Development Kit (MDKARM), le STM32CubeIDE.

2.4 APIs
Lintlha tse qaqileng tsa tekheniki mabapi le li-API tse fumanehang ho mosebelisi li ka fumanoa ho CHM e hlophisitsoeng file e fumanehang ka har'a foldara ea "RFAL" ea sephutheloana sa software moo mesebetsi eohle le litekanyetso li hlalosoang ka botlalo.
Lintlha tse felletseng mabapi le li-API tsa NDEF lia fumaneha ho .chm file bolokoa foldareng ea "doc".
2.5 Sample kopo
A sample kopo e sebelisang boto ea katoloso ea X-NUCLEO-NFC12A1 le NUCLEO-L476RG, NUCLEOG0B1RE kapa boto ea ntlafatso ea NUCLEO-C071RB e fanoe bukeng ea "Projects". Merero e itokiselitseng ho aha e teng bakeng sa li-IDE tse ngata.
Ts'ebelisong ena, NFC tags tsa mefuta e fapaneng li bonoa ke ST25R300 sebali se phahameng sa NFC se balang / se qalang IC (bakeng sa lintlha tse ling, sheba litokomane tsa CHM file hlahiswa ho tswa ho khoutu ya mohlodi).
After system initialization and clock configuration, LED1, LED2, LED3, LED4, LED5, and LED6 blink three times.
Then LED6 glows to indicate the reader field has been activated.
Ha a tag e lemohuoa haufi, LED e butsoe joalo ka ha ho thathamisitsoe ka tlase.

Tafole 2. LED e bonesitsoeng tag ho lemoha

NFC tag mofuta	LED e bonesitse tag ho lemoha
NFC MOFUTA A	LED2/Mofuta oa A
NFC MOFUTA B	LED3/Mofuta oa B
NFC MOFUTA V	LED4/Mofuta oa V
NFC MOFUTA F	LED5/Mofuta oa F

If a reader approaches the X-NUCLEO-NFC12A1 expansion board, the software enters into card emulation mode and, depending on the command type sent, it switches the respective NFC TYPE LED on.
By default, the X-NUCLEO-NFC12A1 does not write any data to the tag, empa monyetla ona o ka sebelisoa ke preprocessor e hlalositsoeng ho file demo.h.
Ho etsisa karete le mokhoa oa poller le tsona li ka nolofalloa / tsa holofatsoa ka mokhoa o ts'oanang.
The ST virtual communication port interface is also included in the package. Once the board is powered on, the board is initialized and enumerated as ST-LST-LINK virtual COM port.

Ka mor'a ho hlahloba nomoro ea boema-kepe ea COM, bula terminal ea Windows (HyperTerminal kapa e tšoanang) ka tlhophiso e bontšitsoeng ka tlase (ho etsa khetho: Implicit CR ho LF, haeba e le teng).

The terminal window returns several messages similar to those shown below to confirm a successful connection.

Tataiso ea ho seta sistimi

3.1 Tlhaloso ea lisebelisoa
3.1.1 STM32 Nucleo
Liboto tsa nts'etsopele ea STM32 Nucleo li fana ka mokhoa o theko e tlaase le o tenyetsehang oa basebelisi ho lekola litharollo le ho aha li-prototypes ka mohala ofe kapa ofe oa STM32 microcontroller.
Tšehetso ea khokahanyo ea Arduino le li-connectors tsa ST morpho li etsa hore ho be bonolo ho atolosa ts'ebetso ea sethala sa nts'etsopele se bulehileng sa STM32 Nucleo ka mefuta e mengata ea liboto tse khethehileng tsa ho atolosa tseo u ka li khethang.
The STM32 Nucleo board does not require separate probes as it integrates the ST-LINK/V2-1 debugger/ programmer.
Boto ea STM32 Nucleo e tla le laeborari e felletseng ea STM32 HAL hammoho le li-software tse fapaneng tse pakiloeng.amples bakeng sa li-IDE tse fapaneng (IAR EWARM, Keil MDK-ARM, STM32CubeIDE, mbed le GCC/ LLVM).
Basebelisi bohle ba STM32 Nucleo ba na le phihlello ea mahala ea lisebelisoa tsa marang-rang (mokopanyi, C/C++ SDK le sechaba sa bahlahisi) ho www.mbed.org ho haha ​​habonolo lits'ebetso tse felletseng.

3.1.2 X-NUCLEO-NFC12A1 expansion board
The X-NUCLEO-NFC12A1 NFC card reader expansion board is based on the ST25R300 device.
The expansion board is configured to support ISO14443A/B, ISO15693, FeliCa™ communication.
ST25R300 e laola likhoutu tsa foreimi le ho etsa li-decoding ka mokhoa oa ho bala bakeng sa lits'ebetso tse tloaelehileng, joalo ka NFC, haufi le maemo a HF RFID a haufi. E tšehetsa ISO/IEC 14443 Mofuta oa A le B, ISO/IEC 15693 (motlakase o le mong feela) le ISO/IEC 18092 liprothokholo tsa puisano, hammoho le ho lemoha, ho bala le ho ngola NFC Forum Type 1, 2, 3, 4 le 5. tags.
E boetse e ts'ehetsa liprothokholo tsohle tse tloaelehileng joalo ka Kovio, CTS, le B'.
ST25R300 e na le moamoheli oa khatello ea lerata (NSR), e lumellang ho amoheloa sebakeng se lerata.

3.2 Tlhaloso ea software
Ho hlokahala likarolo tse latelang tsa software molemong oa ho theha tikoloho e loketseng ea nts'etsopele bakeng sa ho theha lits'ebetso tsa STM32 Nucleo e nang le boto ea katoloso ea NFC:

• X-CUBE-NFC12: ke software ea katoloso ea STM32Cube, e inehetseng ho nts'etsopele ea lits'ebetso tsa NFC.
  Firmware ea X-CUBE- NFC12 le litokomane tse amanang le tsona lia fumaneha ho www.st.com.
• Development tool chain and Compiler: the STM32Cube expansion software supports the three following environments:
  – IAR Embedded Workbench for ARM® (EWARM) toolchain + ST-LINK.
  – Keil® Microcontroller Development Kit (MDK-ARM) toolchain + ST-LINK.
  – STM32CubeIDE + ST-LINK.

3.3 Sesebelisoa sa thepa
Ho hlokahala likarolo tse latelang tsa Hardware:

• One STM32 Nucleo development platform (suggested order code: NUCLEO-L476RG, NUCLEO-G0B1RE, or NUCLEO-C071RB).
• One ST25R300 high performance NFC reader/initiator IC expansion board (order code: X-NUCLEO- NFC12A1).
• Mofuta o le mong oa USB oa mofuta oa A ho ea ho Mini-B oa USB ho hokahanya Nucleo ea STM32 ho PC.

3.4 Ho seta software
3.4.1 Lisebelisuoa tsa nts'etsopele le li-compilers
Khetha e 'ngoe ea libaka tsa ntlafatso tse kopantsoeng (IDE) tse tšehetsoeng ke software ea ho atolosa STM32Cube 'me u bale litlhoko tsa tsamaiso le boitsebiso ba ho seta bo fanoeng ke mofani oa IDE.
3.5 Ho seta tsamaiso
3.5.1 STM32 Nucleo le X-NUCLEO-NFC12A1 ho seta boto ea katoloso
The STM32 Nucleo board integrates the ST-LINK/V2-1 debugger/programmer. You can download the ST-LINK/ V2-1 USB driver at STSW-LINK009.
The X-NUCLEO-NFC12A1 expansion board is easily plugged onto the STM32 Nucleo development board through the Arduino™ UNO R3 extension connector.
It interfaces with the STM32 microcontroller on STM32 Nucleo board through the SPI transport layer.
The default hardware configuration is set up for SPI communication.

Nalane ea ntlafatso

Lethathamo la 3. Histori ea ntlafatso ea litokomane

Letsatsi	Khatiso	Liphetoho
11-Phup-2025	1	Tokollo ea pele.

TSEBISO EA BOHLOKOA – BALA KA HLOKO
STMicroelectronics NV le li-subsidiary tsa eona ("ST") li na le tokelo ea ho etsa liphetoho, litokiso, lintlafatso, lintlafatso, le lintlafatso ho lihlahisoa tsa ST le/kapa tokomaneng ena ka nako efe kapa efe ntle le tsebiso. Bareki ba lokela ho fumana lintlha tsa morao-rao tse amanang le lihlahisoa tsa ST pele ba fana ka litaelo. Lihlahisoa tsa ST li rekisoa ho latela lipehelo le maemo a thekiso ea ST ka nako ea tumello ea taelo.
Bareki ke bona feela ba ikarabellang bakeng sa khetho, khetho, le tšebeliso ea lihlahisoa tsa ST mme ST ha e nke e le molato bakeng sa thuso ea kopo kapa moralo oa lihlahisoa tsa bareki.
Ha ho laesense, e hlalositsoeng kapa e boletsoeng, ea tokelo efe kapa efe ea thepa ea mahlale e fanoeng ke ST mona.
Ho rekisoa ha lihlahisoa tsa ST ka litokisetso tse fapaneng le tlhahisoleseding e boletsoeng mona ho tla hlakola waranti leha e le efe e fanoeng ke ST bakeng sa sehlahisoa se joalo.
ST le logo ea ST ke matšoao a khoebo a ST. Bakeng sa lintlha tse ling mabapi le matšoao a khoebo a ST, sheba ho www.st.com/trademarks. Mabitso a mang kaofela a lihlahisoa kapa litšebeletso ke thepa ea beng ba tsona.
Lintlha tse tokomaneng ena li nkela sebaka le ho nkela tlhahisoleseding e neng e fanoe pele liphetolelong tsa pele tsa tokomane ena.
© 2025 STMicroelectronics – Litokelo tsohle li sirelelitsoe

UM3526 - Tšen 1

Litokomane / Lisebelisoa

ST UM3526 Tshebetso ea NFC Reader Initiator IC Keketseho ea Software [pdf] Bukana ea Mosebelisi NUCLEO-G0B1RE, NUCLEO-L476RG, NUCLEO-C071RB, UM3526 Performance NFC Reader Initiator IC Software Expansion, UM3526, Performance NFC Reader Initiator IC Software Katoloso, Reader Initiator IC Katoloso ea Software, IC Software Katoloso.

Litšupiso

• Bukana ea Mosebelisi