X-CUBE-STSE01 Polokalame Polokalama

Folasaga

O lenei tusi fa'aoga o lo'o fa'amatalaina pe fa'apefea ona amata i le X-CUBE-STSE01 software package.
O le X-CUBE-STSE01 software package o se vaega faakomepiuta e maua ai le tele o fa'ata'ita'iga codes, lea e fa'aogaina ai le STSAFE-A110 ma le STSAFE-A120 mea fa'aoga mai le microcontroller host.
O nei fa'ata'ita'iga tulafono fa'aogaina le STSELib (Secured Element middleware) fau i luga ole STM32Cube software technology e fa'afaigofie ai le feavea'i i STM32 microcontrollers eseese. E le gata i lea, o le MCU-agnostic mo le feaveaʻi i isi MCUs.
O nei faʻataʻitaʻiga code o loʻo faʻaalia ai uiga nei:

• Fa'amaoni.
• Puipuia le teuina o faamatalaga.
• Fa'amaufa'ailoga fa'aoga.
• Paʻaga
• Fa'avae autu.
• afifiina teutusi fa'apitonu'u.
• Tupuga paga autu.

Fa'amatalaga lautele

• O le X-CUBE-STSE01 software package o se faʻamatalaga e tuʻufaʻatasia ai le STSAFE-A110 ma le STSAFE-A120 saogalemu elemene tautua i totonu o le MCU's operating system (OS) ma lona faʻaogaina.
• O loʻo i ai le STSAFE-A110 ma le STSAFE-A120 avetaʻavale ma faʻataʻitaʻiga tulafono e faʻatino i luga ole STM32 32-bit microcontrollers e faʻavae ile Arm® Cortex®-M processor.
• O le Arm o se fa'ailoga fa'amaufa'ailoga a le Arm Limited (po'o ona lala) i le US ma/po'o se isi nofoaga.
• O le X-CUBE-STSE01 software package ua atiaʻe i le ANSI C. Ae ui i lea, o le fausaga tutoʻatasi tutoʻatasi e mafai ai ona faigofie ona feaveaʻi i tulaga eseese eseese.
• O le laulau o lo'o i lalo o lo'o fa'aalia ai le fa'auigaina o acronyms e talafeagai mo le malamalama atili i lenei pepa.

STSAFE-A1x0 elemene malupuipuia

O le STSAFE-A110 ma le STSAFE-A120 o se fofo sili ona malupuipuia lea e galue o se elemene malupuipuia e tuʻuina atu faʻamaoniga ma faʻamaumauga faʻamaumauga i se faʻalapotopotoga faʻapitonuʻu poʻo mamao. O lo'o i ai se tali fa'ato'a atoa ma se faiga fa'aoga saogalemu o lo'o fa'agaoioia i luga o le augatupulaga aupito lata mai o microcontrollers malupuipuia.
O le STSAFE-A110 ma le STSAFE-A120 e mafai ona tu'ufa'atasia i le IoT (Initaneti o mea) masini, atamai-fale, atamai-a'ai ma alamanuia talosaga, tagata fa'atau mea fa'akomepiuta, mea fa'aaoga ma mea fa'aoga. O ona uiga autu o

• Fa'amaoni (o peripherals, IoT ma USB Type-C® masini).
• Saogalemu le fa'avaeina o le alalaupapa ma le talimalo mamao e aofia ai le fela'uaiga layer security (TLS) lululima.
• Au'aunaga fa'amaonia saini (fa'alelei le ta'avale ma le fa'aleleia o le firmware).
• Mata'ituina le fa'aogaina ma fa'amau fa'amautu.
• Fa'afeso'ota'i ma fa'amautu ala fa'atasi ma le fa'aogaina o le fa'aogaina o talosaga.
• O le afifiina ma le tatalaina o teutusi fa'apitonu'u pe mamao.
• Fa'atupuina pa'aga i luga ole masini.

STSecureElement Library (STSELib) faʻamatalaga

O lenei vaega o loʻo faʻamatalaina le STSELib middleware software package content ma le auala e faʻaoga ai.

Fa'amatalaga lautele

O le STSELib middleware o se seti o vaega faakomepiuta ua fuafuaina e:

• faʻafesoʻotaʻi le STSAFE-A110 ma le STSAFE-A120 masini elemene malupuipuia ma se MCU.
• fa'atino tulaga fa'aoga STSAFE-A110 ma le STSAFE-A120 sili ona lautele.
• O le STSELib middleware o loʻo faʻapipiʻiina atoatoa i totonu o pusa polokalama ST e avea o se vaega middleware e faʻaopoopo ai vaega elemene malupuipuia.
• O le STSELib middleware e tu'uina atu ai se seti atoatoa o galuega fa'akomepiuta Polokalama Fa'aoga maualuga i le tagata fa'apipi'i fa'apipi'i. O lenei Middleware e fa'avasegaina le fausiaina ma le fa'asologa o poloaiga e mana'omia e fa'amautinoaina ai masini, mea fa'aoga ma fa'aoga fa'aoga puipuia e fa'aaoga ai le STMicroelectronics STSAFE-A se aiga elemene saogalemu.
• O lenei middleware e mafai ai ona tu'ufa'atasia le tasi po'o le tele o STSAFE-A i le tele o fa'alapotopotoga fa'anatura MCU/MPU.
• Va'ai i fa'amatalaga tu'u mai o lo'o maua i totonu o le pusa a'a mo fa'amatalaga e uiga i lomiga IDE lagolagoina.

Fa'ataina
O le STSELib middleware o loʻo aofia ai ni faʻaoga polokalame e tolu e pei ona faʻaalia i le ata o loʻo i lalo. E tu'uina atu e vaega ta'itasi se tulaga ese'ese o le fa'aogaina o faiga i le tagata fa'apipi'i fa'apipi'i.

O le ata o loʻo i lalo o loʻo faʻaalia ai le STSELib middleware ua tuʻufaʻatasia i totonu o se faʻaoga masani STM32Cube, o loʻo taʻavale i luga o se laupapa faʻalautele X-NUCLEO-SAFEA1 poʻo X-NUCLEO-ESE01A1 faʻapipiʻi i luga o se laupapa STM32 Nucleo.

Ata 2. X-CUBE-STSE01 fa'aoga poloka poloka

Ina ia tuʻuina atu meafaigaluega sili ona lelei ma tulaga tutoʻatasi, o le STSELib middleware e le o fesoʻotaʻi tuusaʻo i le STM32Cube HAL, ae e ala i le atinaʻe files fa'atinoina ile tulaga ole talosaga

• Fa'asologa o Polokalama Fa'aoga (API).
  O lenei fa'apipi'i fa'akomepiuta o le nofoaga e ulufale ai mo le fa'aogaina o le polokalama. E maua ai se seti o galuega maualuga maualuga e mafai ai ona fegalegaleai ma STMicroelectronics Secure Elements. O le Api layer e tuʻuina atu ai faʻamatalaga mo faʻaoga eseese e pei o le Secure Element Management, Authentication, Data Storage, Key Management.
• Laega tautua
  O le SERVICE layer e tuʻuina atu ai se seti o auaunaga o oloa e faʻapipiʻiina uma tulafono e lagolagoina e le elemene saogalemu faʻatatau ma lipoti tali i luga ole laulau API/Talosaga. E mafai ona fa'aoga tuusa'o lenei laulau mai le Talosaga (mo tagata fa'aoga maualuga).
• Papa autu
  O lo'o iai fa'amatalaga lautele mo le ST Secure Element ma galuega mo le feso'ota'iga ma le fa'amautu fa'amoemoe.
  O le vaega autu e fa'afoeina le fa'avasegaina o fe'au fa'apea fo'i ma le fa'avasegaina o fa'avae mo fa'avae o lo'o i luga.

Faiga o faila
O le ata o loʻo i lalo o loʻo faʻaalia ai le fausaga faila o le X-CUBE-STSE01.

Polokalama fa'aaliga

O lenei vaega o loʻo faʻaalia ai polokalame faʻataʻitaʻiga e faʻavae ile STSELib middleware.

Fa'amaoni
O lenei faʻataʻitaʻiga o loʻo faʻaalia ai le tafe o le poloaiga lea o loʻo faʻapipiʻiina ai le STSAFE-A110 / STSAFE-A120 i luga o se masini e faʻamaonia i se nofoaga mamao (IoT device case), o loʻo faʻaaogaina le talimalo i le lotoifale e avea o se pasi-i le server mamao.
Le fa'aaliga o lo'o fa'apipi'i ai le STSAFE-A110/STSAFE-A120 i luga o se pito e fa'amaonia i se tagata talimalo i le lotoifale, moample mo ta'aloga, mea feavea'i po'o mea fa'aaoga, e tutusa lelei lava.
Mo faʻamoemoega faʻataʻitaʻiga, o 'au faʻapitonuʻu ma mamao mamao o le masini lava lea e tasi iinei.

1. Aveese, fa'avasega ma fa'amaonia le tusi fa'alaua'itele a le STSAFE-A110/STSAFE-A120 o lo'o teuina i le sone vaeluaga o fa'amaumauga 0 o le masini ina ia maua ai le ki fa'alaua'itele:
   • Faitau le tusi faamaonia e faaaoga ai le STSELib middleware e ala ile STSAFE-A110/STSAFE-A120's sone 0.
   • Fa'asalalau le tusi fa'amaonia e fa'aaoga ai le fa'ata'otoga a le potutusi.
   • Faitau le tusi faamaonia CA (maua i le code).
   • Fa'asalalau le tusipasi CA e fa'aoga ai le fa'ata'otoga a le faletusi.
   • Fa'amaonia le aoga o le tusipasi e fa'aaoga ai le tusipasi CA e ala ile faletusi fa'ata'oto.
   • Maua le ki fa'alaua'itele mai le tusi pasi STSAFE-A110/STSAFE-A120 X.509.
2. Fausia ma fa'amaonia le saini i luga o se numera lu'i:
   • Fausia se numera lu'i (numera fa'afuase'i).
   • Fa'asa'o le lu'i.
   • Aumai se saini i luga o le lu'i fa'asa'o e fa'aaoga ai le STSAFE-A110/STSAFE-A120 avanoa ki patino 0 e ala i le STSELib middleware.
   • Fa'avasega le saini na faia e fa'aaoga ai le potutusi fa'ata'oto.
   • Fa'amaonia le saini fa'atupuina e fa'aaoga ai le ki fa'alaua'itele a le STSAFE-A110/STSAFE-A120 e ala ile faletusi fa'ata'oto.
   • A faʻamaonia lenei mea, e iloa e le talimalo o le peripheral poʻo le IoT e moni.

Fa'aga'i (Tulaga Fa'atonuga)
Lenei code exampe fa'atuina se fa'atasiga i le va o se masini ma le MCU o lo'o feso'ota'i i ai. O le fetaui e mafai ai ona faʻamaonia fefaʻatauaiga i le va o le masini ma le MCU (o lona uiga, sainia ma faʻamaonia). O le STSAFE-A110 masini e fa'aaogaina na'o le fa'atasi ma le MCU o lo'o fa'atasi ma.
O le paiga e aofia ai le MCU talimalo o loʻo tuʻuina atu se ki MAC talimalo ma se ki faʻafeiloaʻi i le STSAFE-A110 O ki uma e lua o loʻo teuina i le NVM puipuia o le STSAFE-A110 ma e tatau ona teuina i le flash memory o le STM32 masini.
E ala i le faaletonu, i lenei example, auina atu e le talimalo MCU ki lauiloa i le STSAFE-A110 (vaai poloaiga tafe i lalo) e matua fautuaina e faaaoga mo faamoemoega faʻataʻitaʻiga. O le fa'ailoga e mafai ai fo'i le fa'atupuina o ki fa'afuase'i.
E le gata i lea, o le code exampe fa'atupuina se ki teutusi fa'apitonu'u pe a le'i fa'atumauina le avanoa talafeagai i le STSAFE-A110. A fa'atumuina le avanoa o teutusi i le lotoifale, o le STSAFE-A110 masini e mafai ai e le MCU talimalo ona afifi/tala'i se teutusi i le lotoifale e teu malu ai se ki i le itu o le MCU talimalo.
Fa'aaliga: O le fa'ailoga fa'atasi eampe tatau ona fa'ataunu'uina ma le manuia a'o le'i fa'atinoina uma le fa'ailoga fa'apeaamples.

Fa'atonuga

1. Fausia le ki teutusi fa'apitonu'u ile STSAFE-A110 fa'aaoga le STSELib middleware.
   E ala i le faaletonu, ua fa'agaoioia lenei poloaiga
   E na'o le fa'agaioiga lea e tupu pe afai e le'i fa'atumuina le avanoa ki teutusi fa'apitonu'u a le STSAFE-A110.
2. Fa'amatala ni numera 128-bit se lua e fa'aoga e fai ma ki MAC talimalo ma le ki fa'asinomaga.
   E le mafai, e fa'aaogaina ki auro ua iloa. E iai a latou tulaga taua nei:
   • Talia MAC ki
     0x00, 0x11, 0x22, 0x33, 0x44, 0x55, 0x66, 0x77, 0x88, 0x99, 0xAA, 0xBB, 0xCC, 0xDD, 0xEE, 0xFF
   • Host Cipher Key 0x01, 0x23, 0x45, 0x67, 0x89, 0xAB, 0xCD, 0xEF,0x01, 0x23, 0x45, 0x67, 0x89, 0xAB, 0xCD, 0xEF
3. Teu le ki MAC talimalo ma le ki faʻafeiloaʻi i la latou avanoa i le STSAFE-A110/STSAFE-A120.
4. Teu le ki MAC talimalo ma le ki fa'aoga cipher ile STM32's flash memory.

Fa'avae autu (Ki fa'atusa AES-128 CMAC)
O lenei faʻataʻitaʻiga o loʻo faʻaalia ai le tulaga o loʻo faʻapipiʻiina ai le masini STSAFE-A110 i luga o se masini (e pei o le IoT device), lea e fesoʻotaʻi ma se server mamao, ma manaʻomia le faʻatuina o se auala saogalemu e faʻafesoʻotaʻi ai faʻamatalaga.
I lenei example, o le STM32 masini e taʻalo le sao o le 'auʻaunaga mamao (mamao mamao) ma le 'au faʻapitonuʻu e fesoʻotaʻi atu i le STSAFE-A110 masini.
O le sini o lenei faʻaoga faʻaoga o le faʻaalia lea o le faʻavaeina o se mealilo fefaʻasoaaʻi i le va o le tagata talimalo i le lotoifale ma le server mamao e faʻaaoga ai le elliptic curve Diffie-Hellman scheme ma se static (ECDH) poʻo le ephemeral (ECDHE) ki i le STSAFE-A110
Ole mealilo fefa'asoaa'i e tatau ona maua atili ile tasi pe sili atu ki galue (e le fa'aalia iinei). O nei ki galue e mafai ona faʻaaogaina i fesoʻotaʻiga fesoʻotaʻiga e pei ole TLS, mo faʻataʻitaʻigaample mo le puipuia o le le faalauaiteleina, faamaoni ma le moni o faamatalaga o loo fesuiai i le va o le talimalo i le lotoifale ma le server mamao.

Fa'atonuga
O le Ata 4. Fa'atonuga fa'avae autu o lo'o fa'aalia ai le fa'atonuga:

• O ki fa'apitoa ma fa'alaua'itele a le 'au mamao e fa'amalo i le code example.
• E tu'uina atu e le 'au fa'apitonu'u le fa'atonuga o le Generate Keypair i le STSAFE-A110/STSAFE-A120 e fa'atupu ai le pa'aga autu i luga o lona avanoa ephemeral (slot 0xFF).
• O le STSAFE-A110 e toe faafoi atu le ki lautele (e fetaui ma le slot 0xFF) i le STM32 (e fai ma sui o le talimalo mamao).
• O le STM32 e fa'atatau le mealilo a le 'au'aunaga mamao (fa'aaogā le ki fa'alaua'itele a le masini STSAFE ma le ki fa'apitoa a le 'au'aunaga mamao).
• E auina atu e le STM32 le ki fa'alaua'itele a le 'au'aunaga mamao i le STSAFE-A110/STSAFE-A120 ma fai atu i le STSAFE-A110/STSAFE-A120 e fa'atatau le mealilo a le talimalo i le lotoifale e fa'aaoga ai le API.
• O le STSAFE-A110/STSAFE-A120 e toe faafoi le mealilo a le tagata talimalo ile STM32.
• O le STM32 faʻatusatusa mea lilo e lua ma lolomi le iʻuga. Afai e tutusa mea lilo, e manuia le faʻavae faalilolilo.

Afifi/talatala teutusi i le lotoifale

• O lenei faʻataʻitaʻiga o loʻo faʻaalia ai le tulaga lea e afifi ai / tatalaina e le STSAFE-A110/STSAFE-A120 le teutusi faʻapitonuʻu ina ia mafai ai ona teu malu se mea lilo i soʻo se manatua e le faʻafefe (NVM).
• E mafai ona teuina fa'amaufa'ailoga/fa'alilo ki fa'apena i se manatua fa'aopoopo po'o totonu ole STSAFE-A110/STSAFE-A120's fa'amaumauga fa'amaumauga.
• O lo'o fa'aogaina le faiga fa'apipi'i e puipui ai se tusitusiga lilo po'o se tusitusiga manino. O le gaioiga o le afifiina o se teutusi o loʻo faʻailogaina i le AES key wrap algorithm, ma o loʻo i ai le ki poʻo le tusitusiga manino e puipuia. Fa'atonuga
• O 'au fa'apitonu'u ma mamao mamao o le masini lava lea e tasi iinei.

1. Fa'atupu fa'amatalaga fa'afuase'i e fa'atatau ile teutusi fa'apitonu'u.
2. Afi le teutusi fa'apitonu'u e fa'aaoga ai le STSELib middleware API.
3. Teu le teutusi ua afifi.
4.  Tatala le teutusi afifi e fa'aaoga ai le STSELIB middleware.
5.  Faatusatusa le teutusi e lei afifiina i le teutusi muamua i le lotoifale. E tatau ona tutusa.

Tupuga paga autu
O lenei faʻataʻitaʻiga o loʻo faʻaalia ai le faʻatonuga o loʻo faʻapipiʻiina le masini STSAFE-A110/STSAFE-A120 i luga o se talimalo i le lotoifale. E fai atu se tagata talimalo mamao i lenei talimalo i le lotoifale e fa'atupuina se pa'aga autu (se ki tumaoti ma se ki fa'alaua'itele) i luga o le slot 1 ona sainia lea o se lu'i (numera fa'afuase'i) ma le ki fa'apitoa na gaosia.
Ona mafai lea e le tagata talimalo mamao ona faʻamaonia le saini i le ki faʻasalalau lautele.
O lenei faʻataʻitaʻiga e talitutusa ma le faʻamaoniga faʻamaonia e lua eseesega:

• O le paga autu i le faʻataʻitaʻiga Faʻamaonia ua uma ona faʻatupuina (i luga o le slot 0), ae, i lenei example, tatou gaosia le paga autu i luga o le slot 1. O le STSAFE-A110/STSAFE-A120 masini e mafai foi ona gaosia le paga autu i luga o le slot 0xFF, ae mo na o faamoemoega faavae autu.
• O le ki fa'alaua'itele i le fa'ata'ita'iga Authentication e maua mai i le tusi fa'amaonia i le sone 0. I lenei fa'ata'ita'igaample, o le ki lautele e toe auina atu ma le STSAFE-A110/STSAFE-A120 tali i le poloaiga Fausia Keypair.

Fa'atonuga
Mo faʻamoemoega faʻataʻitaʻiga, o 'au faʻapitonuʻu ma mamao mamao o le masini lava lea e tasi iinei.

1. E tu'uina atu e le 'aufaigaluega le fa'atonuga o le Generate Keypair i le STSAFE-A110/STSAFE-A120 lea e toe fa'afo'i atu ai le ki fa'alaua'itele i le MCU talimalo.
2. E faia e le talimalo se luʻi (48-byte numera faʻafuaseʻi) e faʻaaoga ai le Generate Random API. O le STSAFE-A110 e toe fa'afo'i le numera fa'afuase'i.
3. E fa'atatau e le 'au talimalo le hash o le numera fa'atupuina e fa'aaoga ai le faletusi fa'ata'oto.
4. E fesiligia e le talimalo le STSAFE-A110/STSAFE-A120 e fa'atupu se saini o le hash fa'atatau e fa'aaoga ai le
   Fausia Saini API. O le STSAFE-A110/STSAFE-A120 e toe lafo atu le saini na faia.
5. E fa'amaonia e le tagata talimalo le saini fa'atupuina ma le ki fa'alaua'itele na lafo mai e le STSAFE-A110/STSAFE-A120 ile Laasaga 1.
6. Ua lolomi le fa'ai'uga fa'amaonia saini.

Glossary

Faapuupuuga	Uiga
AES	Fa'ailoga Fa'ailoga Maualuga
ANSI	American National Standards Institute
API	Fa'aoga polokalame fa'aoga
BSP	Fonotaga lagolago a le Komiti
CA	Pulega Fa'ailoga
CC	Tulaga masani
C-MAC	Poloaiga fe'au fa'amaonia code
ECC	Elliptic curve cryptography
ECDH	Elliptic curve Diffie–Hellman
ECDHE	Elliptic curve Diffie-Hellman – ephemeral
EWARM	IAR Embedded Workbench® mo Arm®
HAL	Fa'apipi'i mea faigaluega
I/O	Ulufale/ulufale
IAR Systems®	Ta'ita'i ole lalolagi i meafaigaluega ma auaunaga mo le atina'eina o faiga fa'apipi'i.
IDE	Siosiomaga atina'e tu'ufa'atasi. Ose polokalame fa'akomepiuta e tu'uina atu ai nofoaga fa'apitoa i tagata fai polokalame komipiuta mo le atina'eina o polokalame.
IoT	Initaneti o mea
I²C	Feso'ota'iga fa'atasi (IIC)
LL	Avetaavale maualalo
MAC	Fa'ailoga fa'amaonia fe'au
MCU	Vaega microcontroller
MDK-ARM	Keil® microcontroller development kit mo Arm®
MPU	Vaega puipuiga manatua
NVM	Fa'amanatuga e le fa'afefeteina
OS	Faiga fa'agaioiga
SE	Elemene saogalemu
SHA	Saogalemu Hash algorithm
SLA	Maliega laisene polokalame
ST	STMicroelectronics
TLS	Saogalemu Laiga Felauaiga
USB	Fa'asalalau Fa'asalalau pasi

Toe iloilo tala'aga

Aso	Toe Iloiloga	Suiga
23-Iun-2025	1	Fa'asalalauga muamua.

FA'AALIGA TAUA – FAITAU MA LE FA'AMANATU

• STMicroelectronics NV ma ona lala ("ST") fa'aagaga le aia e fai ai suiga, fa'asa'oga, fa'aleleia, fa'aleleia, ma fa'aleleia atili i oloa ST ma/po'o lenei pepa i so'o se taimi e aunoa ma se fa'aaliga. E tatau i tagata fa'atau ona maua fa'amatalaga talafeagai lata mai i oloa ST a'o le'i tu'uina atu oka. O oloa ST o lo'o fa'atau atu e tusa ai ma tu'utu'uga ma aiaiga a le ST o lo'o fa'atau atu i le taimi e fa'ailoa ai le oka.
• E na'o le au fa'atau le filifiliga, filifiliga, ma le fa'aogaina o oloa ST ma e leai se noataga a le ST mo fesoasoani talosaga po'o le mamanu o oloa a tagata fa'atau.
• Leai se laisene, fa'aalia pe fa'aalia, i so'o se aia tatau tau le atamai ua fa'atagaina e ST i totonu.
• Toe fa'atauina atu oloa ST ma aiaiga e ese mai fa'amatalaga o lo'o fa'ailoa mai i inei e tatau ona fa'aleaogaina ai so'o se fa'ataga na tu'uina atu e ST mo ia oloa.
• ST ma le logo ST o fa'ailoga fa'ailoga a ST. Mo fa'amatalaga fa'aopoopo e uiga i fa'ailoga tau ST, va'ai ile www.st.com/trademarks. O isi igoa uma o oloa po'o auaunaga o le meatotino a latou lava tagata.
• O fa'amatalaga i totonu o lenei pepa e suitulaga ma suia fa'amatalaga na tu'uina atu muamua i so'o se lomiga muamua o lenei pepa.
• © 2025 STMicroelectronics – Ua taofia aia tatau uma

Pepa / Punaoa

ST X-CUBE-STSE01 Polokalame Polokalama [pdf] Tusi Taiala X-CUBE-STSE01 Polokalame Polokalama, Polokalama Polokalama, Polokalama

Fa'asinomaga

• Tusi Taiala