MikeFaith/aliro-project
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
5521503258263f1cca31ce03311d16efba453f0d
aliro-project/reader/STM32CubeExpansion_ALIRO_V1_0_0/Release_Notes.html
Dangerous Things 782074f6ae Initial snapshot: Aliro applet, harness, Nucleo NFC10A1 reader port 
Three components, all bench-validated to varying depths:

- applet/: CSA Aliro v1.0 Java Card applet for J3R180. AUTH0 + AUTH1
  expedited-standard flow end-to-end green via PC/SC bench reader
  (aliro-bench-test). Userland AES-256-GCM and HMAC-SHA-256 layered
  on top of J3R180's primitives because the card lacks both natively.
  P-256 curve params seeded explicitly per J3R180's quirk.

- harness/: Python orchestrator (aliro-trustgen, aliro-personalize,
  aliro-bench-test) for trust-bundle generation, card personalization
  via PersonalizationApplet, and PC/SC AUTH0+AUTH1 transactions. 126
  pytest cases passing.

- reader/STM32CubeExpansion_ALIRO_V1_0_0/: ST X-CUBE-ALIRO V1.0.0
  with our NFC10A1 port (NUCLEO-U545RE-Q + X-NUCLEO-NFC10A1, ST25R200
  shared with NFC09A1). nfc10-only/ project, NFC10A1 BSP shim,
  ALIRO_TRUST_OVERRIDE include into vendor's provisioning.c, and an
  ALIRO_APDU_TRACE wrapper around demoTransceiveBlocking. Boots,
  detects the J3R180, completes SELECT + AUTH0; AUTH1 currently fails
  with RFAL ERR_PROTO (0xB) — under investigation, see
  docs/plans/2026-04-20-nucleo-nfc10a1-port.md and bench-notes/.

Excluded: x-cube-aliro.zip vendor archive, harness/.venv, build dirs,
generated aliro_trust.h (contains private reader scalar), all PEMs.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 10:17:46 -07:00

330 lines
13 KiB
HTML
Raw Blame History

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<meta charset="utf-8" />
<meta name="generator" content="pandoc" />
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
<title>Release Notes for X-CUBE-ALIRO STM32Cube Pack</title>
<style type="text/css">
code{white-space: pre-wrap;}
span.smallcaps{font-variant: small-caps;}
span.underline{text-decoration: underline;}
div.column{display: inline-block; vertical-align: top; width: 50%;}
</style>
<link rel="stylesheet" href="_htmresc/mini-st_2020.css" />
<!--[if lt IE 9]>
<script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
<![endif]-->
<link rel="icon" type="image/x-icon" href="_htmresc/favicon.png" />
</head>
<body>
<div class="row">
<div class="col-sm-12 col-lg-4">
<center>
<h1 id="release-notes-for-x-cube-aliro-software-for-stm32"><small>Release Notes for</small> <strong>X-CUBE-ALIRO Software for STM32</strong></h1>
<p>Copyright © 2026 STMicroelectronics<br />
</p>
<a href="https://www.st.com" class="logo"><img src="_htmresc/st_logo_2020.png" alt="ST logo" /></a>
</center>
<h1 id="purpose">Purpose</h1>
<p>The <strong>X-CUBE-ALIRO</strong> implements the CSA Aliro protocol for access control. <br>
Please read carefully the Known Limitations section in the Update History to get additional information for correct configuration of the ioc files.
It is recommended to start from the preconfigured ioc files in the Projects folder.<br>
The <strong>X-CUBE-ALIRO</strong> package supports STM32WBA65, STM32U545 MCUs. </p>
<!--
<h1 id="X-CUBE-ALIRO-software-features">X-CUBE-ALIRO software features:</h1>
<ul>
<li><p>LIST FEATURES <mark style="background-color:red;">HERE</mark></p></li>
<ul>
<li><a href="https://www.st.com/en/wireless-connectivity/aliro-products.html" target=_new><strong>Aliro products web page on st.com</strong></a> </li>
</ul>
</ul>
<p>This firmware package includes Components Device Drivers, Board Support Package and example application for the STMicroelectronics:</p>
<ul>
<li>ALIRO BOARD NAME <mark style="background-color:red;">HERE</mark> evaluation board which supports following devices:
<ul>
<li>Processing, security, and connectivity <mark style="background-color:red;">HERE</mark>:
<ul>
<li>part numbers <mark style="background-color:red;">HERE</mark></li>
</ul></li>
<li>Power management and protections:
<ul>
<li>part numbers <mark style="background-color:red;">HERE</mark></li>
</ul></li>
<li>Diodes and transistors:
<ul>
<li>part numbers <mark style="background-color:red;">HERE</mark></li>
</ul></li>
</ul></li>
</ul>
-->
<h1 id="this-package-contains-the-following-projects">This package contains the following projects:</h1>
<ul>
<li><p><strong>Applications</strong>:</p>
<ul>
<li><strong>Access control</strong></li>
<!-- <li><strong>Custom</strong></li> -->
</ul></li>
</ul>
<p>The figure below shows the overall architecture: <img src="_htmresc/X-CUBE-ALIRO-Software_Architecture_800px.png" /></p>
<ul>
</ul>
<h1 id="here-is-the-list-of-references-to-user-documents">Here is the list of references to user documents:</h1>
<ul>
<li><a href="https://www.st.com/en/wireless-connectivity/aliro-products.html">ST ALIRO web page</a> </li>
</ul>
</div>
<div class="col-sm-12 col-lg-8">
<h1 id="update-history">Update History</h1>
<div class="collapse">
<input type="checkbox" id="collapse-section3" checked aria-hidden="true"> <label for="collapse-section3" aria-hidden="true">V1.0.0 / 25-February-2026</label>
<div>
<h2 id="main-changes-1">Main Changes</h2>
<h3 id="First-release-1">First release.
</h3>
<ul>
<li>Compatible with ALIRO PROTOCOL VERSION 0x0100 - REFERENCE APPLICATIONS: NFC-ONLY / NFC - BLERKE - BLEUWB <br />
</li>
<li>Known limitations: the example applications provided in this package have been tested with IAR and STM32CubeIDE toolchain. Projects for MDK-ARM and Cmake can be generated using STM32CubeMX<br />
Please see readme.txt files inside each project folder for instructions.
</li>
</ul>
<h2 id="contents-1">Contents</h2>
<table>
<p><strong>Documentation</strong></p>
<thead>
<tr class="header">
<th style="text-align: left;">Name</th>
<th style="text-align: left;">Version</th>
<th style="text-align: center;">Document</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">X-CUBE_ALIRO Doxygen documentation</td>
<td style="text-align: left;">1.0.0</td>
<td style="text-align: center;"><a href="Documentation\X-CUBE-ALIRO.chm">CHM</a></td>
</tr>
</tbody>
</table>
<h2 id="projects">Projects</h2>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Name</th>
<th style="text-align: center;">Version</th>
<th style="text-align: center;">Document</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">Projects\nucleo-u5\Applications\Aliro\nfc12-only</td>
<td style="text-align: center;">1.0.0</td>
<td style="text-align: center;"><a href="Projects/nucleo-u5/Applications/Aliro/nfc12-only/readme.txt">Read Me</a></td>
</tr></tbody>
<tr class="even">
<td style="text-align: left;">Projects\nucleo-u5\Applications\Aliro\nfc-only</td>
<td style="text-align: center;">1.0.0</td>
<td style="text-align: center;"><a href="Projects/nucleo-u5/Applications/Aliro/nfc-only/readme.txt">Read Me</a></td>
</tr></tbody>
<tr class="odd">
<td style="text-align: left;">Projects\nucleo-wba65\Applications\Aliro\nfc12ble</td>
<td style="text-align: center;">1.0.0</td>
<td style="text-align: center;"><a href="Projects/nucleo-wba65/Applications/Aliro/nfc12ble/readme.txt">Read Me</a></td>
</tr>
<tr class="even">
<td style="text-align: left;">Projects\nucleo-wba65\Applications\Aliro\nfcble</td>
<td style="text-align: center;">1.0.0</td>
<td style="text-align: center;"><a href="Projects/nucleo-wba65/Applications/Aliro/nfcble/readme.txt">Read Me</a></td>
</tr>
</table>
<h2 id="components">Components</h2>
<table>
<p><strong>Drivers</strong></p>
<thead>
<tr class="header">
<th style="text-align: left;">Name</th>
<th style="text-align: left;">Version</th>
<th style="text-align: center;">Document</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">STM32WBAxx CMSIS</td>
<td style="text-align: left;">1.8.0</td>
<td style="text-align: center;"><a href="Drivers\CMSIS\Device\ST\STM32WBAxx\Release_Notes.html">Release notes</a></td>
</tr>
<tr class="even">
<td style="text-align: left;">STM32U5xx CMSIS</td>
<td style="text-align: left;">1.4.2</td>
<td style="text-align: center;"><a href="Drivers\CMSIS\Device\ST\STM32U5xx\Release_Notes.html">Release notes</a></td>
</tr>
<tr class="odd">
<td style="text-align: left;">STM32WBAxx HAL Drivers</td>
<td style="text-align: left;">1.8.0</td>
<td style="text-align: center;"><a href="Drivers\STM32WBAxx_HAL_Driver\Release_Notes.html">Release notes</a></td>
</tr>
<tr class="even">
<td style="text-align: left;">STM32U5xx HAL Drivers</td>
<td style="text-align: left;">1.6.2</td>
<td style="text-align: center;"><a href="Drivers\STM32U5xx_HAL_Driver\Release_Notes.html">Release notes</a></td>
</tr>
</tbody>
</table>
<table>
<p><strong>BSP Drivers</strong></p>
<thead>
<tr class="header">
<th style="text-align: left;">Name</th>
<th style="text-align: left;">Version</th>
<th style="text-align: center;">Document</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">STM32U5xx_Nucleo</td>
<td style="text-align: left;">1.2.3</td>
<td style="text-align: center;"><a href="Drivers\BSP\STM32U5xx_Nucleo\Release_Notes.html">Release notes</a></td>
</tr>
<tr class="odd">
<td style="text-align: left;">STM32WBAxx_Nucleo</td>
<td style="text-align: left;">1.1.1</td>
<td style="text-align: center;"><a href="Drivers\BSP\STM32WBAxx_Nucleo\Release_Notes.html">Release notes</a></td>
</tr>
<tr class="odd">
<td style="text-align: left;">X-CUBE-NFC9 BSP</td>
<td style="text-align: left;">1.0.0</td>
<td style="text-align: center;"><a href="Drivers\BSP\NFC09A1\Release_Notes.html">Release notes</a></td>
</tr>
<tr class="odd">
<td style="text-align: left;">X-CUBE-NFC12 BSP</td>
<td style="text-align: left;">1.0.0</td>
<td style="text-align: center;"><a href="Drivers\BSP\NFC12A1\Release_Notes.html">Release notes</a></td>
</tr>
<tr class="odd">
<td style="text-align: left;">ST25R200 driver</td>
<td style="text-align: left;">1.0.0</td>
<td style="text-align: center;"><a href="Drivers\BSP\Components\st25r200\Release_Notes.html">Release notes</a></td>
</tr>
<tr class="odd">
<td style="text-align: left;">ST25R500 driver</td>
<td style="text-align: left;">1.0.0</td>
<td style="text-align: center;"><a href="Drivers\BSP\Components\st25r500\Release_Notes.html">Release notes</a></td>
</tr>
</tbody>
</table>
<table>
<p><strong>Middlewares</strong></p>
<thead>
<tr class="header">
<th style="text-align: left;">Name</th>
<th style="text-align: left;">Version</th>
<th style="text-align: center;">Document</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">Aliro</td>
<td style="text-align: left;">Version 1.0.0</td>
<td style="text-align: center;"><a href="Middlewares\ST\ACWG_Security\Release_Notes.html">Release Note</a></td>
</tr>
<tr class="even">
<td style="text-align: left;">STM32_WPAN</td>
<td style="text-align: left;">Version 2.8.0</td>
<td style="text-align: center;"><a href="Middlewares\ST\STM32_WPAN\Release_Notes.html">Release Note</a></td>
</tr>
<tr class="odd">
<td style="text-align: left;">ST25 Middleware - rfal</td>
<td style="text-align: left;">Version 4.0.2</td>
<td style="text-align: center;"><a href="Middlewares\ST\rfal\Release_Notes.html">Release Note</a></td>
</tr>
<tr class="even">
<td style="text-align: left;">QCBOR</td>
<td style="text-align: left;">Version 2.0alpha</td>
<td style="text-align: center;"><a href="Middlewares\Third_Party\QCBOR\README.md">Readme</a></td>
</tr>
<tr class="odd">
<td style="text-align: left;">t_cose</td>
<td style="text-align: left;">Version 2.0</td>
<td style="text-align: center;"><a href="Middlewares\Third_Party\t_cose\README.md">Readme</a></td>
</tr>
</tbody>
</table>
<table>
<p><strong>Utilities</strong></p>
<thead>
<tr class="header">
<th style="text-align: left;">Name</th>
<th style="text-align: left;">Version</th>
<th style="text-align: center;">Document</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">STM32 TINY low power manager</td>
<td style="text-align: left;">1.5.1</td>
<td style="text-align: center;"><a href="Utilities\lpm\tiny_lpm\Release_Notes.html">Release notes</a></td>
</tr>
<tr class="even">
<td style="text-align: left;">STM32 Sequencer</td>
<td style="text-align: left;">1.11.0</td>
<td style="text-align: center;"><a href="Utilities\sequencer\Release_Notes.html">Release notes</a></td>
</tr>
<tr class="even">
<td style="text-align: left;">STM32 adv_trace</td>
<td style="text-align: left;">1.3.0</td>
<td style="text-align: center;"><a href="Utilities\trace\adv_trace\Release_Notes.html">Release notes</a></td>
</tr>
<tr class="even">
<td style="text-align: left;">STM32 miscellaneous utilities</td>
<td style="text-align: left;">1.1.1</td>
<td style="text-align: center;"><a href="Utilities\misc\Release_Notes.html">Release notes</a></td>
</tr>
<tr class="even">
<td style="text-align: left;">STM32 timer server</td>
<td style="text-align: left;">1.3.1</td>
<td style="text-align: center;"><a href="Utilities\tim_serv\Release_Notes.html">Release notes</a></td>
</tr>
</tbody>
</table>
<h2 id="development-toolchains-and-compilers-1">Development Toolchains and Compilers</h2>
<ul>
<li>IAR Embedded Workbench for ARM (EWARM) toolchain V9.20.1</li>
<!-- <li>RealView Microcontroller Development Kit (Open Keil µVision 5 - MDK-ARM) toolchain V5.32.0</li> -->
<li>STM32CubeIDE V2.0.0</li>
</ul>
<h2 id="supported-devices-and-boards-1">Supported Devices and Boards</h2>
<ul>
<li>See CHM files for the list of supported boards, NUCLEOs and X-NUCLEOs</li>
</ul>
<h2 id="backward-compatibility-1">Backward Compatibility</h2>
<p>None</p>
<h2 id="dependencies-1">Dependencies</h2>
<!-- <p>This software release is compatible with:</p>
<ul>
<li><a href="https://www.st.com/en/embedded-software/stassettracking.html"><strong>ST Asset Tracking application for Android and iOS</strong></a> </li>
<li><a href="https://www.st.com/en/embedded-software/dsh-assetracking.html"><strong>Cloud Amazon-based web application for asset tracking</strong></a> </li>
</ul> -->
</div>
</div>
</div>
<footer class="sticky">
<p>For complete documentation on <strong>ALIRO EVALUATION KIT </strong> , visit: <a href="https://www.st.com">www.st.com</a></p>
This release note uses up to date web standards and, for this reason, should not be opened with Internet Explorer but preferably with popular browsers such as Google Chrome, Mozilla Firefox, Opera or Microsoft Edge.
</footer>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink