X-CUBE-SAFEA1 Software Package
Fa'amatalaga
- Igoa Oloa: STSAFE-A110 Secure Element
- Fa'aliliuga: X-CUBE-SAFEA1 v1.2.1
- Fa'atasi i totonu: STM32CubeMX pusa polokalama
- Vaega Autu:
- Fa'amautu ala ala fa'atasi ma le talimalo mamao e aofia ai
felauaiga vaega saogalemu (TLS) lululima - Au'aunaga fa'amaonia saini (fa'amau fa'amau ma firmware
fa'aleleia) - Mata'ituina le fa'aoga 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
- Fa'amautu ala ala fa'atasi ma le talimalo mamao e aofia ai
Fa'atonuga o le Fa'aaogaina o Mea
1. Fa'amatalaga Lautele
O le elemene malupuipuia STSAFE-A110 ua mamanuina e tuʻuina atu
fa'amaoni ma fa'amaumauga fa'atonu auaunaga i le lotoifale po'o mamao
talimalo. E talafeagai mo talosaga eseese e pei o masini IoT,
faiga fa'apitoa-fale, fa'aoga fa'apisinisi, ma isi mea.
2. Amataina
Ina ia amata fa'aaoga le elemene saogalemu STSAFE-A110:
- Va'ai ile fa'amaumauga o lo'o maua ile STSAFE-A110
web itulau mo fa'amatalaga auiliili. - La'u mai le pusa polokalama faakomepiuta STSAFE-A1xx mai le
STSAFE-A110 itulau initaneti po'o STM32CubeMX. - Ia mautinoa le fetaui ma IDE lagolago pei ole STM32Cube IDE poʻo
System Workbench mo STM32.
3. Middleware Fa'amatalaga
3.1 Fa'amatalaga Lautele
O le STSAFE-A1xx middleware e faafaigofieina le fegalegaleaiga i le va
le masini elemene malupuipuia ma se MCU, e mafai ai ona faʻaaogaina mataupu eseese.
O lo'o tu'ufa'atasia i totonu o pusa polokalame ST e fa'aleleia ai le saogalemu
foliga.
3.2 Faufale
O le middleware e aofia ai vaega eseese polokalama,
e aofia ai:
- STSAFE-A1xx API (autu autu)
- CORE CRYPTO
- MbedTLS Cryptographic auaunaga fa'aoga SHA/AES
- Fa'aoga auaunaga meafaigaluega X-CUBECRYPTOLIB
Fesili e Fai soo (FAQ)
F: O fea e mafai ona ou maua ai le fa'amaumauga STSAFE-A110?
A: O lo'o maua le fa'amaumauga ile STSAFE-A110 web itulau mo
fa'amatalaga fa'aopoopo ile masini.
F: O a si'osi'omaga tu'ufa'atasia e lagolagoina
mo le STSAFE-A1xx middleware?
A: O IDE lagolago e aofia ai STM32Cube IDE ma System Workbench
mo STM32 (SW4STM32) i le X-CUBE-SAFEA1 v1.2.1 afifi.
UM2646
Fa'aoga tusi lesona
Amata i le X-CUBE-SAFEA1 pusa polokalama
Folasaga
O loʻo faʻamatalaina e lenei tusi lesona le auala e amata ai le X-CUBE-SAFEA1 pusa polokalama. O le X-CUBE-SAFEA1 software package o se vaega faakomepiuta e tuʻuina atu ai le tele o faʻataʻitaʻiga codes, lea e faʻaogaina ai le STSAFE-A110 masini faʻapitoa mai se microcontroller talimalo. O nei fa'ata'ita'iga tulafono fa'aogaina le STSAFE-A1xx middleware fausia i luga o le 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 fa'ata'ita'iga o lo'o fa'aalia ai vaega nei: · Fa'amaoniaga · Fa'atasiga · Fa'avae fa'atūlagaga · Fa'auma teutusi fa'alotoifale · Fa'atupuina o paga autu.
UM2646 – Rev 4 – Mati 2024 Mo nisi fa'amatalaga fa'afeso'ota'i lou ofisa fa'atau STMicroelectronics.
www.st.com
1
Fa'aaliga: Fa'aaliga:
UM2646
Fa'amatalaga lautele
Fa'amatalaga lautele
O le X-CUBE-SAFEA1 software package o se fa'asinomaga e tu'ufa'atasia le STSAFE-A110 saogalemu elemene tautua i totonu o le MCU's operating system (OS) ma lona fa'aogaina. O loʻo i ai le STSAFE-A110 avetaʻavale ma faʻataʻitaʻiga tulafono e faʻatino i luga ole STM32 32-bit microcontrollers 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-SAFEA1 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-A1xx polokalama faʻapipiʻi faʻapipiʻi i le X-CUBE-SAFEA1 v1.2.1 e pei o le middleware ma ua tuʻufaʻatasia e pei o le BSP mo le pusa polokalama mo le STM32CubeMX.
UM2646 – Faaaliga 4
itulau 2/23
UM2646
STSAFE-A110 elemene malupuipuia
2
STSAFE-A110 elemene malupuipuia
O le STSAFE-A110 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 e mafai ona tuʻufaʻatasia i le IoT (Initaneti o mea) masini, atamai-fale, atamai-aai ma alamanuia talosaga, tagata faʻatau mea tau eletise, faʻaaogaina ma mea faʻaoga. O ona uiga taua o:
·
Fa'amaoni (o peripheral, 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 firmware)
·
Mata'ituina le fa'aoga 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
Va'ai ile fa'amatalaga STSAFE-A110 o lo'o maua ile STSAFE-A110 web itulau mo fa'amatalaga fa'aopoopo ile masini.
UM2646 – Faaaliga 4
itulau 3/23
UM2646
STSAFE-A1xx middleware faʻamatalaga
3
STSAFE-A1xx middleware faʻamatalaga
O lenei vaega o loʻo faʻamatalaina le STSAFE-A1xx middleware software package content ma le auala e faʻaoga ai.
3.1
Fa'amatalaga lautele
O le STSAFE-A1xx middleware o se seti o vaega faakomepiuta ua fuafuaina e:
·
fa'afeso'ota'i le masini elemene malupuipuia STSAFE-A110 ma se MCU
·
fa'atino tulaga fa'aoga sili ona taatele STSAFE-A110
O le STSAFE-A1xx 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 faʻamautu elemene (mo example X-CUBE-SBSFU poʻo X-CUBE-SAFEA1).
E mafai ona sii mai i luga ole itulau initaneti STSAFE-A110 e ala ile Tools & Software tab pe mafai foi ona sii mai ile STM32CubeMX.
O lo'o tu'uina atu le polokalama fa'akomepiuta e fai ma fa'ailoga fa'apogai i lalo ole maliega laisene ST software (SLA0088) (silasila i fa'amatalaga Laisene mo nisi fa'amatalaga).
O si'osi'omaga tau atina'e fa'atasi nei e lagolagoina:
·
IAR Embedded Workbench® mo Arm® (EWARM)
·
Keil® Microcontroller Development Kit (MDK-ARM)
·
STM32Cube IDE (STM32CubeIDE)
·
System Workbench mo STM32 (SW4STM32) lagolagoina i le X-CUBE-SAFEA1 v1.2.1 paketi
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.
3.2
Fa'ataina
O lenei vaega o lo'o fa'amatalaina ai vaega fa'akomepiuta a le STSAFE-A1xx middleware software package.
O le ata o loʻo i lalo o loʻo faʻaalia ai a view o le STSAFE-A1xx middleware architecture ma fesoʻotaʻiga fesoʻotaʻi.
Ata 1. fausaga STSAFE-A1xx
STSAFE-A1xx API (autu autu)
CORE
CRYPTO
MbedTM TLS
Fa'asinomaga auaunaga fa'ata'oto SHA/AES
AUAUNA
Nofoaga tu'ufua
E fetaui lelei mo le puipuiga e ala ile MCU puipuiga
(MPU, Firewall, TrustZone®, ma isi)
Fa'aoga auaunaga meafaigaluega
X-CUBECRYPTOLIB
UM2646 – Faaaliga 4
itulau 4/23
Fa'aaliga:
UM2646
STSAFE-A1xx middleware faʻamatalaga
O le middleware o loʻo faʻaalia ai fesoʻotaʻiga eseese e tolu:
·
STSAFE-A1xx API: O le polokalame autu o polokalame faʻaoga (API), lea e maua ai avanoa atoatoa i tagata uma
'au'aunaga a le STSAFE-A110 na fa'atau atu i luga o fa'aoga (fa'aoga, faletusi ma fa'aputuga). O lenei atina'e e
e ta'ua foi o le autu autu aua o API uma e auina atu i fafo o loʻo faʻatinoina i le CORE module.
O le pito i luga e manaʻomia le tuʻufaʻatasia o le STSAFE-A1xx middleware e tatau ona maua le STSAFE-A110
foliga e ala i lenei fa'aoga.
·
Au'aunaga tautua meafaigaluega: O lenei fa'aoga e fa'aogaina e le STSAFE-A1xx middleware e o'o atu i le maualuga
tulaga tutoatasi meafaigaluega. E aofia ai se seti o galuega lautele e faʻafesoʻotaʻi le MCU patino, IO pasi
ma galuega tau taimi. O lenei fausaga e fa'aleleia ai le toe fa'aogaina o le code library ma fa'amautinoa le faigofie ona feavea'i
isi masini.
Fa'amatalaina o galuega vaivai, o nei galuega lautele e tatau ona fa'atinoina ile tulaga fa'aoga pe a mae'aample tu'uina atu i totonu o le stsafea_service_interface_template.c fa'ata'ita'iga na tu'uina atu mo le fa'afaigofie ona tu'ufa'atasia
ma aganu'u i totonu o vaega pito i luga.
·
Au'aunaga fa'akomepiuta: O lenei fa'aoga e fa'aogaina e le STSAFE-A1xx middleware e maua ai
tulaga po'o le faletusi galuega fa'ata'oto e pei ole SHA (secure hash algorithm) ma le AES (advanced
faʻailoga faʻailoga) e manaʻomia e le middleware mo nisi faʻataʻitaʻiga.
Fa'amatalaina o ni galuega vaivai, o nei galuega fa'ata'oto e tatau ona fa'atinoina i le tulaga o talosaga
mulimuli i le example tuʻuina atu ma faʻataʻitaʻiga eseese e lua:
stsafea_crypto_mbedtls_interface_template.c pe afai o le Arm® MbedTM TLS cryptographic faletusi; stsafea_crypto_stlib_interface_template.c pe a fa'aoga le potutusi fa'ata'otoga ST;
·
E mafai ona fa'aogaina isi faletusi fa'ata'oto e ala i le fa'avasegaina o le puna ata files. O le
mamanu files ua tu'uina atu mo le tu'ufa'atasiga faigofie ma le fa'avasegaina i totonu o laulau pito i luga.
O Arm ma Mbed o fa'ailoga fa'amaufa'ailoga po'o fa'ailoga tau fefa'ataua'iga a Arm Limited (po'o ona lala) i le US ma/po'o seisi nofoaga.
UM2646 – Faaaliga 4
itulau 5/23
UM2646
STSAFE-A1xx middleware faʻamatalaga
O le ata o loʻo i lalo o loʻo faʻaalia ai le STSAFE-A1xx 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 faʻapipiʻi i luga o se laupapa STM32 Nucleo.
Ata 2. STSAFE-A1xx fa'aoga poloka poloka
STSAFE-A1xx middleware i se talosaga STM32Cube
X-CUBE-SAFEA1 poloka ata mo STM32CubeMX
Ina ia tuʻuina atu meafaigaluega sili ona lelei ma tulaga tutoʻatasi, o le STSAFE-A1xx middleware e le o fesoʻotaʻi saʻo i le STM32Cube HAL, ae e ala i le atinaʻe files fa'atinoina i le tulaga o talosaga (stsafea_service_interface_template.c, stsafea_interface_conf.h).
UM2646 – Faaaliga 4
itulau 6/23
UM2646
STSAFE-A1xx middleware faʻamatalaga
3.3
module CORE
O le CORE module o le totonugalemu lea o le middleware. O lo'o fa'atinoina le fa'atonuga o lo'o ta'ua e pito i luga (fa'aoga, faletusi, fa'aputu ma isi mea) ina ia fa'aoga lelei ai foliga STSAFE-A1xx.
O le ata o loʻo i lalo o loʻo faʻaalia ai a view o le fausaga o le module CORE.
Ata 3. CORE module architecture
Lafo pito i luga (talosaga, faletusi, faaputuga, ma isi)
CORE
CRYPTO module totonu
SERVICE i totonu module
O le CORE module o se vaega tele-interface software e fesoʻotaʻi ma:
·
Laupapa pito i luga: feso'ota'iga i fafo e ala i API e auina atu i fafo o lo'o fa'amatalaina i laulau e lua o lo'o i lalo;
·
Cryptographic layer: fesoʻotaʻiga i totonu i le CRYPTO module;
·
Laega tautua meafaigaluega: feso'ota'iga i totonu ile SERVICE module;
O le STSAFE-A1xx middleware software package e maua ai se fa'amaumauga API atoa o le module CORE i le pusa a'a (silasila i le STSAFE-A1xx_Middleware.chm file).
Va'ai ile STSAFE-A110 fa'amatalaga mo se fa'amatalaga pu'upu'u o le fa'atonuga seti, lea e feso'ota'i ai le fa'atonuga o API o lo'o lisiina i le laulau o lo'o mulimuli mai.
Vaega API Fa'avae amata
Poloaiga fa'amoemoe lautele
Poloaiga vaeluaga o faamatalaga
Laulau 1. CORE module auina atu i fafo API
Fa'atino StSafeA_Init E fai, fa'amata ma tu'u le au masini STSAFE-A1xx. StSafeA_GetVersion E toe faafoi le STSAFE-A1xx middleware revision. StSafeA_Echo Ina ia maua faʻamatalaga na pasia i le poloaiga. StSafeA_Reset E toe fa'afo'i uiga fe'avea'i i o latou ulua'i tau. StSafeA_GenerateRandom E fa'atupuina ai se numera o bytes fa'afuase'i. StSafeA_Hibernate Tu'u le masini STSAFE-Axxx i le moe. StSafeA_DataPartitionQuery
UM2646 – Faaaliga 4
itulau 7/23
UM2646
STSAFE-A1xx middleware faʻamatalaga
API vaega
Fa'atonuga o le Query e toe aumai le fa'atulagaina o le vaeluaga o fa'amaumauga.
StSafeA_Decrement E fa'aitiitia le fata e tasi i totonu ole sone fa'ata.
Poloaiga vaeluaga o faamatalaga
StSafeA_Read E faitau fa'amatalaga mai se sone vaeluaga o fa'amaumauga.
StSafeA_Update E fa'afou fa'amaumauga e ala i le vaeluaga o sone.
StSafeA_GenerateSignature E toe faafoi le saini ECDSA i luga o se fa'amatalaga fe'au.
Poloaiga autu tumaoti ma lautele
StSafeA_GenerateKeyPair E fau ai se ki-paiga i totonu o se avanoa ki patino.
StSafeA_VerifyMessageSignature Ina ia faʻamaonia le faʻamaonia o le feʻau.
StSafeA_EstablishKey E fa'atūina se mealilo fa'asoa i le va o 'au e lua e ala i le fa'aogaina o fa'amatalaga asymmetric.
StSafeA_ProductDataQuery Query poloaiga e toe aumai fa'amaumauga o oloa.
StSafeA_I2cParameterQuery Query fa'atonuga e toe aumai le tuatusi I²C ma le fa'atulagaina o le faiga e maualalo le malosi.
StSafeA_LifeCycleStateQuery Query poloaiga e toe aumai le tulaga o le olaga (Fanau, Fa'agaioiga, Fa'amuta, Fanau ma Loka po'o Fa'agaioiga ma Loka).
Poloaiga tau pulega
StSafeA_HostKeySlotQuery Query fa'atonuga e toe aumai le fa'amatalaga autu o lo'o talimalo (fa'atasi ma talimalo C-MAC counter).
StSafeA_PutAttribute Tu'u uiga i le masini STSAFE-Axxx, e pei o ki, upu fa'amaonia, I²C parakalafa e tusa ai ma le uiga. TAG.
StSafeA_DeletePassword Ina ia tape le upu faataga mai lona avanoa.
StSafeA_VerifyPassword Ina ia faʻamaonia le upu faʻamaonia ma manatua le taunuʻuga o le faʻamaoniga mo le faʻatagaina o le poloaiga i le lumanaʻi.
StSafeA_RawCommand E fa'atino se fa'atonuga mata'utia ma maua le tali fa'atatau.
StSafeA_LocalEnvelopeKeySlotQuery Fa'atonuga ole Query e toe aumai fa'amatalaga autu ole teutusi i le lotoifale (numera o le avanoa, i ai ma le umi ki) mo avanoa autu avanoa.
Poloaiga teutusi fa'apitonu'u
StSafeA_GenerateLocalEnvelopeKey E fau ai se ki i totonu o se avanoa ki teutusi fa'apitonu'u.
StSafeA_WrapLocalEnvelope E afifi ai faʻamaumauga (masani ki) e pulea atoa e le tagata talimalo, faʻatasi ai ma se ki teutusi faʻapitonuʻu ma le [AES key wrap] algorithm.
StSafeA_UnwrapLocalEnvelope E tatala se teutusi fa'apitonu'u ma se ki teutusi fa'apitonu'u.
UM2646 – Faaaliga 4
itulau 8/23
UM2646
STSAFE-A1xx middleware faʻamatalaga
API vaega
Poloaiga fa'atonuga fa'atonuga
Laulau 2. Fa'atau atu i fafo STSAFE-A110 CORE module APIs
Galuega StSafeA_CommandAuthorizationConfigurationQuery Query poloaiga e toe aumai tulaga avanoa mo poloaiga e mafai ona fetuunai tulaga avanoa.
3.4
SERVICE module
O le SERVICE module o le vaega maualalo o le middleware. O loʻo faʻatinoina se faʻaogaina atoatoa o meafaigaluega i tulaga o le MCU ma meafaigaluega faʻavae.
O le ata o loʻo i lalo o loʻo faʻaalia ai a view o le fausaga o le SERVICE module.
Ata 4. SERVICE module architecture
CORE module totonu
AUAUNA
Lafo pito i lalo (BSP, HAL, LL, ma isi)
O le SERVICE module o se vaega e lua-interface software e fesoʻotaʻi ma:
·
La'ei pito i lalo: pei ole BSP, HAL po'o le LL. O galuega vaivai e tatau ona fa'atinoina i fafo maualuga
fa'avae ma fa'avae i luga ole fa'ata'ita'iga stsafea_service_interface_template.c file;
·
Laega autu: feso'ota'iga i totonu i le CORE module e ala i API e auina atu i fafo o loʻo faʻamatalaina i le laulau
lalo;
O le STSAFE-A1xx middleware software package e maua ai se fa'amaumauga API atoa o le SERVICE module i le a'a faila (silasila i le STSAFE-A1xx_Middleware.chm file).
Laulau 3. SERVICE module ua auina atu i fafo APIs
Vaega API Fa'avae amata
Fa'agaoioi tulaga maualalo
Galuega
StSafeA_BSP_Init Ina ia amataina le pasi feso'ota'iga ma pine IO e mana'omia e fa'agaioi ai le masini STSAFE-Axxx.
StSafeA_Transmit Ina ia saunia le poloaiga e tuʻuina atu, ma valaʻau le API pasi maualalo e faʻatino. Fa'atatau ma fa'atasi se CRC, pe a lagolagoina.
StSafeA_Receive Ina ia maua fa'amatalaga mai le STSAFE-Axxx e ala i le fa'aogaina o galuega pasi maualalo e toe aumai ai. Siaki le CRC, pe a lagolagoina.
UM2646 – Faaaliga 4
itulau 9/23
UM2646
STSAFE-A1xx middleware faʻamatalaga
3.5
CRYPTO module
O le CRYPTO module o loʻo faʻatusalia le vaega cryptographic o le middleware. E tatau ona fa'alagolago i punaoa fa'ata'otoga a le tulaga.
O le CRYPTO module e matua tuto'atasi lava mai isi modules middleware ma, mo lenei mafua'aga, e mafai ona faigofie ona fa'apipi'iina i totonu o se nofoaga malupuipuia e fetaui ma le puipuiga e MCU puipuiga fa'apitoa e pei o se vaega e puipuia ai manatua (MPU), se pa afi po'o se TrustZone®.
O le ata o loʻo i lalo o loʻo faʻaalia ai a view o le fausaga o le module CRYPTO.
Ata 5. CRYPTO module architecture
CORE module totonu
CRYPTO
Fa'asao fa'aata i fafo
(MbedTM TLS, X-CUBE-CRYPTOLIB)
O le CRYPTO module o se vaega lua-interface software e fesoʻotaʻi ma:
·
se faletusi fa'amatalaga mai fafo: Mbed TLS ma X-CUBE-CRYPTOLIB o lo'o lagolagoina nei. vaivai
galuega tauave e tatau ona faʻatinoina i fafo maualuga maualuga ma faʻavae i luga o:
stsafea_crypto_mbedtls_interface_template.c template file mo le Mbed TLS cryptographic library;
stsafea_crypto_stlib_interface_template.c template file mo le potutusi fa'ata'otoga ST;
E mafai ona faigofie ona lagolagoina faletusi fa'aopoopo fa'apitoa e ala i le fetu'una'i o le fa'ata'ita'iga fa'amatalaga
mamanu file.
·
le vaega autu: fesoʻotaʻiga i totonu i le CORE module e ala i API faʻatau atu o loʻo faʻamatalaina i le laulau
lalo;
O le STSAFE-A1xx middleware software package e maua ai se fa'amaumauga API atoa o le CRYPTO module i le pusa a'a (silasila i le STSAFE-A1xx_Middleware.chm file).
Laulau 4. CRYPTO module auina atu i fafo APIs
API vaega
Galuega
StSafeA_ComputeCMAC E fa'atatau le tau CMAC. Faʻaaogaina i luga o le poloaiga ua saunia.
StSafeA_ComputerRMAC E fa'atatau le tau o le RMAC. Fa'aoga ile tali maua.
StSafeA_DataEncryption Cryptographic APIs E fa'atino ai fa'amatalaga fa'amatalaga (AES CBC) i luga o le fa'amaumauga a le STSAFE-Axxx.
StSafeA_DataDecryption Ina ia fa'atino le fa'auigaina o fa'amaumauga (AES CBC) i luga o le fa'amaumauga a le STSAFE-Axxx.
StSafeA_MAC_SHA_PrePostProcess E muai fa'agasolo pe mae'a fa'agasolo le MAC ma/po'o le SHA a'o le'i fa'asalalauina, po'o le mae'a ona maua o fa'amaumauga mai le masini STSAFE_Axxx.
UM2646 – Faaaliga 4
itulau 10/23
3.6
Fa'aaliga:
UM2646
STSAFE-A1xx middleware faʻamatalaga
Fa'ata'ita'iga
O lenei vaega o loʻo tuʻuina atu ai faʻamatalaga auiliili o faʻataʻitaʻiga o loʻo maua i totonu ole STSAFE-A1xx middleware software package.
O faʻataʻitaʻiga uma o loʻo lisiina i le laulau o loʻo i lalo o loʻo tuʻuina atu i totonu o le Interface folder o loʻo maua i le aʻa o le middleware software package.
Fa'ata'ita'iga files ua saunia e pei o examples e kopiina ma faʻapipiʻi i totonu o le pito i luga, ina ia faigofie
faʻapipiʻi ma faʻapipiʻi le STSAFE-A1xx middleware:
·
Faiga fa'aoga files saunia example faʻatinoga o galuega __vaivai, ofoina atu e leai se mea poʻo
vaega gaogao i totonu ole middleware. E tatau ona faʻatinoina lelei i totonu ole avanoa faʻaoga poʻo totonu
o vaega pito i luga e tusa ai ma le potutusi cryptographic ma filifiliga meafaigaluega a le tagata faʻaoga.
·
Fa'ata'ita'iga fa'atusa files saunia se auala faigofie e configure le STSAFE-A1xx middleware ma foliga
e mafai ona fa'aoga i le fa'aoga fa'aoga, e pei o fa'atonuga po'o meafaigaluega fa'apitoa.
Vaega fa'atusa
Fa'ata'ita'iga fa'aoga
Fa'ata'ita'iga fa'atusa
Laulau 5. Fa'ata'ita'iga
Fa'ata'ita'iga file
stsafea_service_interface_template.c Example faʻataʻitaʻiga e faʻaalia ai le auala e lagolago ai auaunaga faʻapitoa e manaʻomia e le STSAFE-A middleware ma ofo mai e meafaigaluega faʻapitoa, faletusi maualalo poʻo le BSP filifilia i le avanoa e faʻaoga ai. stsafea_crypto_mbedtls_interface_template.c Example faʻataʻitaʻiga e faʻaalia ai le auala e lagolagoina ai auaunaga faʻapitoa e manaʻomia e le STSAFE-A middleware ma ofo mai e le Mbed TLS cryptographic library (faʻatonuga autu, SHA, AES, ma isi). stsafea_crypto_stlib_interface_template.c Example faʻataʻitaʻiga e faʻaalia ai pe faʻapefea ona lagolagoina le auaunaga faʻapitoa e manaʻomia e le STSAFE-A middleware ma ofoina mai e le STM32 faʻapipiʻi faʻapipiʻi polokalama faakomepiuta mo STM32Cube (XCUBE-CRYPTOLIB) (pulea ki, SHA, AES, ma isi). stsafea_conf_template.h Esoample faʻataʻitaʻiga e faʻaalia ai pe faʻafefea ona faʻapipiʻi le STSAFE-A middleware (aemaise mo faʻamoemoega sili ona lelei). stsafea_interface_conf_template.h Example faʻataʻitaʻiga e faʻaalia ai pe faʻafefea ona faʻapipiʻi ma faʻavasega le faʻaoga files lisiina i luga.
O faʻataʻitaʻiga o loʻo i luga e naʻo le pusa BSP o le X-CUBE-SAFEA1 afifi.
UM2646 – Faaaliga 4
itulau 11/23
UM2646
STSAFE-A1xx middleware faʻamatalaga
3.7
Faiga o faila
O le ata o loʻo i lalo o loʻo faʻaalia ai le fausaga o le pusa o le STSAFE-A1xx middleware software package v1.2.1.
Ata 6. Poloketi file fausaga
Poloketi file fausaga STSAFE-A1xx middleware
UM2646 – Faaaliga 4
Poloketi file fausaga mo X-CUBE-SAFEA1 mo STM32CubeMX
itulau 12/23
3.8
3.8.1
3.8.2
UM2646
STSAFE-A1xx middleware faʻamatalaga
Auala e: tu'ufa'atasia ma fa'atulagaina
O lenei vaega o loʻo faʻamatalaina pe faʻafefea ona tuʻufaʻatasia ma faʻapipiʻi le STSAFE-A1xx middleware i totonu o le tagata faʻaoga.
Laasaga tu'ufa'atasi
Mulimuli i laasaga nei e faʻapipiʻi ai le STSAFE-A1xx middleware i le talosaga manaʻomia:
·
Laasaga 1: Kopi (ma toe fa'aigoa) le stsafea_service_interface_template.c file ma se tasi o
stsafea_crypto_mbedtls_interface_template.c poʻo stsafea_crypto_stlib_interface_template.c i le tagata faʻaoga
avanoa e tusa ai ma le potutusi cryptographic ua faʻaopoopoina i le talosaga (po o le a lava le
cryptographic faletusi filifilia / faʻaogaina e tagata faʻaoga, e mafai foʻi ona latou fatuina / faʻatinoina a latou lava cryptographic
feso'ota'iga file mai le sasa e ala i le fetuutuunai o le mamanu talafeagai).
·
Laasaga 2: Kopi (ma sui le igoa) le stsafea_conf_template.h ma le stsafea_interface_conf_template.h
files i le avanoa fa'aoga.
·
Laasaga 3: Ia mautinoa e faʻaopoopo le saʻo e aofia ai i lau autu poʻo soʻo se isi avanoa avanoa file e mana'omia
fa'aoga le STSAFE-A1xx middleware:
#include “stsafea_core.h” #include “stsafea_interface_conf.h”
·
Laasaga 4: Fa'avasega le files fa'aoga i la'asaga e tolu i luga e tusa ai ma mana'oga o tagata fa'aoga.
Laasaga fetuutuunai
Ina ia mafai ona faʻapipiʻi lelei le STSAFE-A1xx middleware i le faʻaoga faʻaoga, e tuʻuina atu e ST ni mea eseese se lua
mamanu faatulagaina files e kopiina ma fa'avasega i le avanoa fa'aoga e tusa ai ma filifiliga a le tagata fa'aoga:
·
stsafea_interface_conf_template.h: O lenei example template e faʻaaogaina ma faʻaalia le auala e faʻapipiʻi ai le
feso'ota'iga fa'akomepiuta ma 'au'aunaga middleware i le avanoa fa'aoga e ala i le #define o lo'o mulimuli mai
fa'amatalaga:
USE_PRE_LOADED_HOST_KEYS
MCU_PLATFORM_INCLUDE
MCU_PLATFORM_BUS_INCLUDE
MCU_PLATFORM_CRC_INCLUDE
·
stsafea_conf_template.h: O lenei example faʻataʻitaʻiga e faʻaaogaina ma faʻaalia pe faʻafefea ona faʻapipiʻi le STSAFE-A
middleware e ala i faʻamatalaga #define nei:
STSAFEA_USE_OPTIMIZATION_SHARED_RAM
STSAFEA_USE_OPTIMIZATION_NO_HOST_MAC_ENCRYPT
STSAFEA_USE_FULL_ASSERT
USE_SIGNATURE_SESSION (mo STSAFE-A100 na'o)
Mulimuli i laasaga nei ina ia mafai ona tuʻufaʻatasia le STSAFE-A1xx middleware i le talosaga manaʻomia:
·
Laasaga 1: Kopi (ma sui le igoa) le stsafea_interface_conf_template.h ma le stsafea_conf_template.h
files i le avanoa fa'aoga.
·
Laasaga 2: Faʻamaonia pe suia le #define faʻamatalaga o le ulutala e lua o loʻo taʻua i luga files e tusa ai ma
le fa'aoga fa'aoga ma filifiliga cryptographic.
UM2646 – Faaaliga 4
itulau 13/23
4
4.1
Fa'aaliga:
4.2
Fa'aaliga:
UM2646
Polokalama fa'aaliga
Polokalama fa'aaliga
O lenei vaega o loʻo faʻaalia ai polokalame faʻataʻitaʻiga e faʻavae ile STSAFE-A1xx middleware.
Fa'amaoni
O lenei faʻataʻitaʻiga o loʻo faʻaalia ai le faʻatonuga o loʻo faʻapipiʻiina ai le STSAFE-A110 i luga o se masini e faʻamaonia i se nofoaga mamao (IoT device case), o loʻo faʻaogaina le talimalo i le lotoifale e avea o se pasi i le server mamao. O le fa'aaliga o lo'o fa'apipi'i ai le STSAFE-A110 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.
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. Ave'ese, va'ava'ai ma fa'amaonia le tusi fa'alaua'itele a le STSAFE-A110 o lo'o teuina i totonu o le sone vaeluaga o fa'amaumauga 0 o le masini.
ina ia maua le ki lautele: Faitau le tusi faamaonia e faaaoga ai le STSAFE-A1xx middleware e ala i le STSAFE-A110's sone 0. Fa'asalalau le tusipasi e fa'aaoga ai le parser a le cryptographic library. 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'asalalau mai le tusi pasi STSAFE-A110 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 avanoa ki patino a le STSAFE-A110 0 e ala i le
STSAFE-A1xx middleware. Fa'avasega le saini na faia e fa'aaoga ai le potutusi fa'ata'oto. Fa'amaonia le saini na faia e fa'aaoga ai le ki fa'alaua'itele a le STSAFE-A110 e ala i le faletusi fa'ata'oto. A faʻamaonia lenei mea, e iloa e le talimalo o le peripheral poʻo le IoT e moni.
Fa'atasi
Lenei code exampe fa'atuina se fa'atasiga i le va o se masini STSAFE-A110 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. O le fa'ailoga fa'atasiampe 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 e fa'aaoga ai le STSAFE-A1xx middleware. E ala i le faaletonu, ua fa'agaoioia lenei poloaiga. Ia nofouta o le le fa'ailoaina o mea nei e fa'amatala ai fa'amatalaga i le pa iring.c file fa'ate'aina le fa'atupuina o teutusi fa'alotoifale: /* #define _FORCE_DEFAULT_FLASH_ */
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.
UM2646 – Faaaliga 4
itulau 14/23
UM2646
Polokalama fa'aaliga
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. O lo'o iai a latou fa'atauga nei: 0x00,0x11,0x22,0x33,0x44,0x55,0x66,0x77,0x88,0x99,0xAA,0xBB,0xCC,0xDD,0xEE,0xFF / * Host MAC ki */ 0x11,0x11,0 22,0x22,0x33,0x33,0x44,0x44,0x55,0x55,0x66,0x66,0x77,0x77,0x88,0x88 / * Ki fa'aoga cipher */
Ina ia fa'agaoioia le fa'atupu fa'afuase'i, fa'aopoopo le fa'amatalaga fa'amalamalamaga lea i le pairing.c file: #define USE_HOST_KEYS_SET_BY_PAIRING_APP 1
3. Teu le ki MAC talimalo ma le ki fa'ailoga o lo'o fa'afeiloa'i i latou avanoa i le STSAFE-A110. 4. Teu le ki MAC talimalo ma le ki fa'aoga cipher ile STM32's flash memory.
4.3
Fa'avae autu (fa'avae mealilo)
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 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
Ata 7. 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'aunaga mamao e fa'amalo i le code example.
·
E auina atu e le tagata talimalo i le lotoifale le StSafeA_GenerateKeyPair poloaiga i le STSAFE-A110 e faʻatupu ai le
paga ki 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 (fa'atusalia
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 mamao mamao.
ki patino a le talimalo).
·
E auina atu e le STM32 le ki fa'alaua'itele a le tagata talimalo mamao i le STSAFE-A110 ma fai atu i le STSAFE-A110 e
fa'atatau le mealilo a le 'au fa'apitonu'u e fa'aaoga ai le StSafeA_EstablishKey API.
·
O le STSAFE-A110 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, o le mea lilo
ua manuia le faavaeina.
UM2646 – Faaaliga 4
itulau 15/23
Ata 7. Fa'atonuga fa'avae autu
UM2646
Polokalama fa'aaliga
Talimalo mamao
STM32
talimalo i le lotoifale
STSAFE
Fuafuaina o le mealilo a le talimalo mamao (fa'aoga le ki tumaoti a le talimalo mamao ma le ki lautele a le talimalo i le lotoifale (STSAFE slot 0xFF))
Mealilo a le talimalo mamao
Fausia Paaga Ki
Fa'atupu Pair Ki i luga ole slot 0xFF
Ole ki fa'alaua'itele a le STSAFE na fa'atupu ile
Fausia le ki fa'alaua'itele a le STSAFE
avanoa 0xFF
Ki lautele a le talimalo mamao
STM32 fa'atusatusa le mealilo talimalo mamao i le
mealilo a le talimalo i le lotoifale ma lolomi le iuga
Fa'atu Ki (ki fa'alaua'itele a Host)
Tuuina atu mealilo a le talimalo i le lotoifale
Fuafuaina o le mealilo a le tagata talimalo i le lotoifale (fa'aoga le ki patino a le tagata talimalo i le lotoifale (STSAFE slot 0xFF) ma le ki lautele a le talimalo mamao)
Mealilo a le talimalo i le lotoifale
4.4
Fa'aaliga:
4.5
Afifi/talatala teutusi i le lotoifale
O lenei faʻataʻitaʻiga o loʻo faʻaalia ai le tulaga lea e afifi ai / tatala e le STSAFE-A110 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'apea i se manatua fa'aopoopo po'o totonu ole manatua o fa'amaumauga a le tagata fa'aoga a le STSAFEA110. 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. Fausia fa'amatalaga fa'afuase'i e fa'atatau ile teutusi fa'apitonu'u. 2. Afifi le teutusi fa'apitonu'u e fa'aaoga ai le middleware a le STSAFE-A110. 3. Teu le teutusi ua afifi. 4. Tatala le teutusi afifi e fa'aaoga ai le middleware a le STSAFE-A110. 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 ai le masini STSAFE-A110 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,
matou te gaosia le paʻu ki i luga o le slot 1. O le STSAFE-A110 masini e mafai foi ona faʻatupuina le paʻu ki i luga ole slot 0xFF,
ae mo na o faamoemoega autu o le faavaeina.
·
O le ki lautele i le faʻataʻitaʻiga Authentication e maua mai le tusi faamaonia i le sone 0. I lenei
example, o le ki lautele e toe auina atu ma le STSAFE-A110 tali i le
StSafeA_GenerateKeyPair poloaiga.
UM2646 – Faaaliga 4
itulau 16/23
UM2646
Polokalama fa'aaliga
Fa'aaliga:
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 auina atu e le tagata talimalo le poloaiga StSafeA_GenerateKeyPair i le STSAFE-A110, lea e toe faafoi mai ai le
ki lautele i le MCU talimalo. 2. O le talimalo e fa'atupuina se lu'i (48-byte numera fa'afuase'i) fa'aaoga le StSafeA_GenerateRandom API. O le
STSAFE-A110 toe auina atu le numera fa'afuase'i. 3. E fa'atatau e le tagata talimalo le hash o le numera fa'atupuina e fa'aaoga ai le potutusi fa'ata'oto. 4. Fai atu le talimalo ile STSAFE-A110 e fa'atupu se saini ole hash fa'akomepiuta e fa'aaoga ai le
StSafeA_GenerateSignature API. O le STSAFE-A110 e toe lafo atu le saini na faia.
5. E fa'amaonia e le 'au'aunaga le saini fa'atupuina ma le ki fa'alaua'itele na lafo mai e le STSAFE-A110 i le la'asaga 1. 6. O lo'o lolomi le fa'ai'uga o fa'amaoniga saini.
UM2646 – Faaaliga 4
itulau 17/23
UM2646
Toe iloilo tala'aga
Laulau 6. Tala'aga o le toe iloiloga o pepa
Aso
Toe Iloiloga
Suiga
09-Tes-2019
1
Fa'asalalauga muamua.
13-Ian-2020
2
Aveese vaega fa'amatalaga o Laisene.
Lisi fa'afou o foliga o lo'o fa'aalia i fa'ata'ita'iga fa'ailoga i le Folasaga. Aveese Lisi o acronyms laulau ma faaofi i ai le lisi o upu i le pito.
Laiti suiga o tusitusiga ma lanu fa'afouina ile Ata 1. STSAFE-A1xx architecture.
Fa'afou Ata 2. STSAFE-A1xx fa'aoga poloka poloka.
Fa'afou Laulau 1. CORE module auina atu i fafo API.
07-Feb-2022
3
Aveese StSafeA_InitHASH ma StSafeA_ComputeHASH mai le Laulau 4. CRYPTO module na auina atu i fafo APIs.
Fa'afouina Vaega 3.8.2: Laasaga Fa'atonu.
Fa'afouina Vaega 4.2: Fa'atasi.
Fa'afouina Vaega 4.3: Fa'avae autu (fa'avae mealilo).
Fa'aopoopo Vaega 4.5: Fa'atupuina paga autu.
Suiga laiti tusitusiga.
Faʻaopoopo le STSAFE-A1xx software package ua tuʻufaʻatasia i le X-CUBE-SAFEA1 v1.2.1 e avea ma middleware
ma o loʻo tuʻufaʻatasia e pei o le BSP mo le pusa polokalama mo le STM32CubeMX. ma O faʻataʻitaʻiga o loʻo i luga
07-Mat-2024
4
e na'o le pusa BSP o le X-CUBE-SAFEA1 afifi..
Fa'afouina Vaega 3.1: Fa'amatalaga lautele, Vaega 3.2: Fa'ata'ita'iga ma le Vaega 3.7: Fa'atulagaina o faila.
UM2646 – Faaaliga 4
itulau 18/23
Glossary
AES Advanced encryption standard ANSI American National Standards Institute API Application programming interface BSP Board support package CA Certification Authority CC Common Criteria C-MAC Command message authentication code ECC Elliptic curve cryptography ECDH Elliptic curve DiffieHellman ECDHE Elliptic curve DiffieHellman – ephemeral EWARM IAR Embedded Workbench® Arm® HAL Hardware abstraction layer I/O Input/output IAR Systems® Ta'ita'i le lalolagi i meafaigaluega ma auaunaga mo le atina'eina o faiga. Siosiomaga atina'e tu'ufa'atasi IDE. 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 Inter-integrated circuit (IIC) LL Avetaavale tulaga maualalo MAC Feʻau faʻamaonia code MCU Microcontroller unit MDK-ARM Keil® microcontroller development kit mo Arm® MPU Iunite puipuiga o manatua NVM Nonvolatile memory
OS Faiga fa'agaoioiga SE Elemene malu SHA Secure Hash algorithm SLA Maliega laisene polokalame ST STMicroelectronics TLS Saogalemu lapisi fe'avea'i USB pasi fa'asalalau lautele
UM2646
Glossary
UM2646 – Faaaliga 4
itulau 19/23
UM2646
Mataupu
Mataupu
1 Fa'amatalaga lautele . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 2 STSAFE-A110 elemene malupuipuia. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 3 STSAFE-A1xx fa'amatalaga middleware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3.1 Fa'amatalaga lautele. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 3.2 Fausia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 3.3 module CORE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 3.4 Auaunaga module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 3.5 CRYPTO module. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 3.6 Fa'ata'ita'iga. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 3.7 Faiga o faila . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 3.8 Auala e: tu'ufa'atasia ma fa'atulagaina . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
3.8.1 Laasaga tu'ufa'atasi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 3.8.2 Laasaga o le fetuunaiga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
4 Fa'aaliga polokalame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14 4.1 Fa'amaoni . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 4.2 Fa'atasi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 4.3 Fa'avae autu (fa'avae mealilo) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 4.4 Afifi/talatala teutusi i le lotoifale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 4.5 Fausiaina paga autu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Toe iloilo tala'aga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18 Lisi o laulau . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21 Lisi o fuainumera. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
UM2646 – Faaaliga 4
itulau 20/23
UM2646
Lisi o laulau
Lisi o laulau
Laulau 1. Laulau 2. Laulau 3. Laulau 4. Laulau 5. Laulau 6.
CORE module auina atu i fafo API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Fa'atau atu i fafo STSAFE-A110 CORE module APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 SERVICE module ua auina atu i fafo APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 CRYPTO module auina atu i fafo APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Fa'ata'ita'iga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Talafaasolopito o le toe iloiloga o pepa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
UM2646 – Faaaliga 4
itulau 21/23
UM2646
Lisi o fuainumera
Lisi o fuainumera
Ata 1. Ata 2. Ata 3. Ata 4. Ata 5. Ata 6. Ata 7.
STSAFE-A1xx fausaga. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 STSAFE-A1xx fa'aoga poloka poloka . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 fa'ata'ita'iga fa'aoga fa'aoga fa'aoga CORE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Auaunaga faufale faufale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 CRYPTO module fausaga. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Poloketi file fausaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Fa'asologa o poloaiga fa'avae autu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
UM2646 – Faaaliga 4
itulau 22/23
UM2646
FA'AALIGA TAUA FAITAU FA'AFEAGAI STMicroelectronics NV ma ona lala (“ST”) fa'asaoina le aia tatau 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. O le toe fa'atauina atu o oloa ST ma aiaiga e ese mai fa'amatalaga o lo'o fa'ailoa mai i inei e tatau ona fa'aleaogaina 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 fa'ailoga ST, va'ai ile www.st.com/trademarks. O isi igoa uma o oloa po'o auaunaga o le meatotino a latou tagata e ona. O fa'amatalaga i totonu o lenei pepa e suitulaga ma sui ai fa'amatalaga na tu'uina atu muamua i so'o se lomiga muamua o lenei pepa.
© 2024 STMicroelectronics Ua taofia aia tatau uma
UM2646 – Faaaliga 4
itulau 23/23
Pepa / Punaoa
 |
STMicroelectronics X-CUBE-SAFEA1 Software Package [pdf] Taiala mo Tagata Fa'aoga STSAFE-A100, STSAFE-A110, X-CUBE-SAFEA1 Paketi Polokalama, X-CUBE-SAFEA1, Polokalama Polokalama, afifi |
