X-CUBE-SAFEA1 Software Pob
Specifications
- Khoom npe: STSAFE-A110 Ruaj Ntseg Element
- Version: X-CUBE-SAFEA1 v1.2.1
- Kev koom ua ke hauv: STM32CubeMX software pob
- Cov yam ntxwv tseem ceeb:
- Kev ruaj ntseg channel tsim nrog cov chaw taws teeb tswj hwm suav nrog
thauj txheej ruaj ntseg (TLS) tuav tes - Kev pabcuam kos npe pov thawj (kev ruaj ntseg khau raj thiab firmware
upgrade) - Kev saib xyuas kev siv nrog cov txee ruaj ntseg
- Pairing thiab ruaj ntseg channel nrog tus tswv tsev thov processor
- Wrapping thiab unwrapping ntawm lub hnab ntawv hauv zos lossis chaw nyob deb
- On-chip tseem ceeb khub tiam
- Kev ruaj ntseg channel tsim nrog cov chaw taws teeb tswj hwm suav nrog
Cov lus qhia siv khoom
1. Cov ntaub ntawv dav dav
Lub STSAFE-A110 ruaj ntseg lub ntsiab yog tsim los muab
authentication thiab kev tswj cov ntaub ntawv kev pabcuam rau hauv zos lossis chaw taws teeb
tus tswv. Nws yog tsim rau ntau yam kev siv xws li IoT li,
ntse-tsev systems, kev siv hauv tsev, thiab lwm yam.
2. Pib
Txhawm rau pib siv STSAFE-A110 ruaj ntseg caij:
- Xa mus rau cov ntaub ntawv muaj nyob rau ntawm STSAFE-A110
web nplooj ntawv kom paub meej. - Rub tawm STSAFE-A1xx Middleware software pob los ntawm
STSAFE-A110 nplooj ntawv internet lossis STM32CubeMX. - Xyuas kom muaj kev sib raug zoo nrog IDEs txhawb xws li STM32Cube IDE lossis
System Workbench rau STM32.
3. Middleware Description
3.1 Kev piav qhia dav dav
STSAFE-A1xx middleware pab txhawb kev sib cuam tshuam ntawm
cov khoom siv ruaj ntseg thiab MCU, ua kom muaj ntau yam kev siv.
Nws tau koom ua ke hauv ST software pob los txhim kho kev ruaj ntseg
nta.
3.2 Architecture
Cov khoom nruab nrab muaj cov khoom sib txawv ntawm cov software,
suav nrog:
- STSAFE-A1xx API (tub ntxhais interface)
- COV CRYPTO
- MbedTLS Cryptographic service interface SHA/AES
- Hardware service interface X-CUBECRYPTOLIB
Cov lus nug nquag nug (FAQ)
Q: Kuv tuaj yeem nrhiav STSAFE-A110 datasheet nyob qhov twg?
A: Cov ntaub ntawv muaj nyob rau ntawm STSAFE-A110 web paj rau
cov ntaub ntawv ntxiv ntawm lub cuab yeej.
Q: Dab tsi yog qhov kev txhawb nqa kev txhim kho ib puag ncig
rau STSAFE-A1xx Middleware?
A: Cov IDEs txhawb nqa suav nrog STM32Cube IDE thiab System Workbench
rau STM32 (SW4STM32) hauv X-CUBE-SAFEA1 v1.2.1 pob.
UWM 2646
Cov neeg siv phau ntawv
Pib nrog X-CUBE-SAFEA1 software pob
Taw qhia
Cov neeg siv phau ntawv no piav qhia yuav ua li cas pib nrog X-CUBE-SAFEA1 software pob. X-CUBE-SAFEA1 software pob yog ib qho software tivthaiv uas muab ntau qhov kev ua qauv qhia, uas siv STSAFE-A110 ntaus ntawv nta los ntawm tus tswv microcontroller. Cov lej ua qauv qhia no siv STSAFE-A1xx cov khoom nruab nrab tsim los ntawm STM32Cube software thev naus laus zis kom yooj yim txav mus los thoob plaws STM32 microcontrollers. Tsis tas li ntawd, nws yog MCU-agnostic rau kev txav mus rau lwm yam MCUs. Cov lej ua qauv qhia no qhia txog cov yam ntxwv hauv qab no: · Kev lees paub · Kev sib koom ua ke · Kev tsim lag luam tseem ceeb · Lub hnab ntawv hauv zos qhwv · Cov khub tseem ceeb
UM2646 - Rev 4 - Peb Hlis 2024 Yog xav paub ntxiv hu rau koj lub chaw muag khoom hauv STMicroelectronics.
www.st.com
1
Nco tseg: Nco tseg:
UWM 2646
Cov ntaub ntawv dav dav
Cov ntaub ntawv dav dav
X-CUBE-SAFEA1 software pob yog ib qho kev siv los koom ua ke STSAFE-A110 kev ruaj ntseg cov kev pabcuam rau hauv tus tswv MCU lub operating system (OS) thiab nws daim ntawv thov. Nws muaj STSAFE-A110 tus tsav tsheb thiab cov lej ua qauv qhia kom ua tiav ntawm STM32 32-ntsis microcontrollers raws li Arm® Cortex®-M processor. Arm yog ib lub cim lag luam ntawm Arm Limited (lossis nws cov koom tes) hauv Asmeskas thiab / lossis lwm qhov. X-CUBE-SAFEA1 software pob yog tsim nyob rau hauv ANSI C. Txawm li cas los xij, lub platform-independent architecture tso cai yooj yim txav mus rau ntau lub platform sib txawv. Cov lus hauv qab no nthuav tawm cov ntsiab lus ntawm cov lus sau uas cuam tshuam rau kev nkag siab zoo ntawm daim ntawv no.
STSAFE-A1xx software pob yog kev koom ua ke hauv X-CUBE-SAFEA1 v1.2.1 ua cov khoom nruab nrab thiab nws tau koom ua ke ua BSP rau cov software pob rau STM32CubeMX.
UM2646 – Rev 4
paj 2/23
UWM 2646
STSAFE-A110 ruaj ntseg yam
2
STSAFE-A110 ruaj ntseg yam
STSAFE-A110 yog ib qho kev ruaj ntseg zoo heev uas ua raws li lub hauv paus ruaj ntseg muab kev lees paub thiab kev tswj xyuas cov ntaub ntawv rau ib lub zos lossis chaw nyob deb. Nws muaj cov kev daws teeb meem tag nrho nrog rau kev ua haujlwm ruaj ntseg khiav ntawm lub cim tshiab ntawm kev ruaj ntseg microcontrollers.
STSAFE-A110 tuaj yeem ua ke hauv IoT (Internet ntawm yam khoom) cov khoom siv, ntse-tsev, ntse-lub nroog thiab kev lag luam siv, cov khoom siv hluav taws xob siv hluav taws xob, khoom siv thiab khoom siv. Nws cov yam ntxwv tseem ceeb yog:
·
Authentication (ntawm peripherals, IoT thiab USB Type-C® li)
·
Kev ruaj ntseg channel tsim nrog cov chaw taws teeb tswj nrog rau kev thauj txheej ruaj ntseg (TLS) tuav tes
·
Kos npe pov thawj kev pabcuam (kev ruaj ntseg khau raj thiab hloov kho firmware)
·
Kev saib xyuas kev siv nrog cov txee ruaj ntseg
·
Pairing thiab ruaj ntseg channel nrog tus tswv tsev thov processor
·
Wrapping thiab unwrapping ntawm lub hnab ntawv hauv zos lossis chaw nyob deb
·
On-chip tseem ceeb khub tiam
Xa mus rau STSAFE-A110 cov ntaub ntawv muaj nyob ntawm STSAFE-A110 web nplooj ntawv rau cov lus qhia ntxiv ntawm lub cuab yeej.
UM2646 – Rev 4
paj 3/23
UWM 2646
STSAFE-A1xx Middleware piav qhia
3
STSAFE-A1xx Middleware piav qhia
Tshooj lus no qhia meej txog STSAFE-A1xx nruab nrab software pob cov ntsiab lus thiab txoj hauv kev siv nws.
3.1
Kev piav qhia dav dav
Lub STSAFE-A1xx Middleware yog ib txheej ntawm cov khoom siv software tsim los rau:
·
interface STSAFE-A110 ruaj ntseg khoom siv nrog MCU
·
siv STSAFE-A110 feem ntau siv rooj plaub
STSAFE-A1xx middleware yog tag nrho kev koom ua ke nyob rau hauv ST software tej pob khoom raws li ib tug middleware tivthaiv ntxiv kev ruaj ntseg yam nta (rau example X-CUBE-SBSFU or X-CUBE-SAFEA1).
Nws tuaj yeem rub tawm los ntawm STSAFE-A110 nplooj ntawv internet los ntawm Cov Cuab Yeej & Software tab lossis tuaj yeem rub tawm los ntawm STM32CubeMX.
Cov software yog muab los ua qhov chaws raws li daim ntawv cog lus ST software daim ntawv tso cai (SLA0088) (saib daim ntawv tso cai cov ntaub ntawv kom paub meej ntxiv).
Cov kev sib koom ua ke hauv qab no tau txais kev txhawb nqa:
·
IAR Embedded Workbench® rau Arm® (EWARM)
·
Keil® Microcontroller Development Kit (MDK-ARM)
·
STM32Cube IDE (STM32CubeIDE)
·
System Workbench rau STM32 (SW4STM32) txhawb nqa hauv X-CUBE-SAFEA1 v1.2.1 pob nkaus xwb
Xa mus rau cov ntawv tso tawm muaj nyob rau hauv pob hauv paus nplaub tshev rau cov ntaub ntawv hais txog cov kev txhawb nqa IDE.
3.2
Kev tsim vaj tsev
Tshooj lus no piav qhia txog cov khoom siv software ntawm STSAFE-A1xx middleware software pob.
Daim duab hauv qab no nthuav tawm a view ntawm STSAFE-A1xx Middleware architecture thiab lwm yam cuam tshuam.
Daim duab 1. STSAFE-A1xx architecture
STSAFE-A1xx API (tub ntxhais interface)
COV
CRYPTO
MbedTM TLS
Cryptographic service interface SHA/AES
Kev Pabcuam
Ib cheeb tsam cais
Haum rau kev tiv thaiv los ntawm MCU kev ruaj ntseg nta
(MPU, Firewall, TrustZone®, thiab lwm yam)
Kev pab cuam kho vajtse interface
X-CUBECRYPTOLIB
UM2646 – Rev 4
paj 4/23
Nco tseg:
UWM 2646
STSAFE-A1xx Middleware piav qhia
Cov khoom nruab nrab muaj peb qhov sib txawv interfaces:
·
STSAFE-A1xx API: Nws yog qhov tseem ceeb ntawm daim ntawv thov programming interface (API), uas muab kev nkag mus rau txhua tus.
STSAFE-A110 cov kev pabcuam xa tawm mus rau cov khaubncaws sab nraud povtseg (daim ntawv thov, tsev qiv ntawv thiab pawg). Qhov no interface yog
kuj tseem hu ua qhov tseem ceeb interface vim hais tias tag nrho cov exported APIs yog siv nyob rau hauv lub CORE module.
Cov khaubncaws sab nraud povtseg uas yuav tsum tau ua ke nrog STSAFE-A1xx Middleware yuav tsum nkag mus rau STSAFE-A110
nta ntawm no interface.
·
Hardware service interface: Qhov kev sib txuas no yog siv los ntawm STSAFE-A1xx middleware kom ncav cuag qhov siab tshaj plaws
kho vajtse platform kev ywj pheej. Nws suav nrog cov txheej txheem dav dav los txuas rau MCU, IO tsheb npav tshwj xeeb
thiab lub sijhawm ua haujlwm. Cov qauv no txhim kho lub tsev qiv ntawv code re-usability thiab lav tau yooj yim portability rau
lwm yam khoom siv.
Txhais raws li kev ua haujlwm tsis muaj zog, cov haujlwm tseem ceeb no yuav tsum tau ua tiav ntawm qib kev thov tom qab example muab nyob rau hauv stsafea_service_interface_template.c template muab rau kev sib koom ua ke yooj yim
thiab customization nyob rau hauv lub Upper txheej.
·
Cryptographic service interface: Qhov kev sib txuas no yog siv los ntawm STSAFE-A1xx Middleware nkag mus
platform lossis tsev qiv ntawv cryptographic ua haujlwm xws li SHA (kev nyab xeeb hash algorithm) thiab AES (advanced
tus qauv encryption) xav tau los ntawm cov khoom nruab nrab rau qee qhov kev ua qauv qhia.
Txhais raws li kev ua haujlwm tsis muaj zog, cov haujlwm cryptographic no yuav tsum tau ua raws li qib kev thov
raws li example tau muab ob qho tib si templates:
stsafea_crypto_mbedtls_interface_template.c yog siv Arm® MbedTM TLS cryptographic Library; stsafea_crypto_stlib_interface_template.c yog siv ST cryptographic tsev qiv ntawv;
·
Lwm cov tsev qiv ntawv cryptographic tuaj yeem siv los ntawm kev hloov kho tus qauv tsim files. Cov
tus qauv files yog muab rau kev sib koom ua ke yooj yim thiab kho kom haum rau hauv cov khaubncaws sab nraud povtseg.
Arm thiab Mbed yog cov cim lag luam lossis cov cim lag luam ntawm Arm Limited (lossis nws cov koom tes) hauv Asmeskas thiab / lossis lwm qhov.
UM2646 – Rev 4
paj 5/23
UWM 2646
STSAFE-A1xx Middleware piav qhia
Daim duab hauv qab no qhia tau hais tias STSAFE-A1xx cov khoom nruab nrab sib xyaw ua ke hauv tus qauv STM32Cube daim ntawv thov, khiav ntawm X-NUCLEO-SAFEA1 expansion board mounted ntawm STM32 Nucleo board.
Daim duab 2. STSAFE-A1xx daim duab thaiv daim duab
STSAFE-A1xx middleware hauv ib daim ntawv thov STM32Cube
X-CUBE-SAFEA1 thaiv daim duab rau STM32CubeMX
Txhawm rau muab qhov zoo tshaj plaws kho vajtse thiab platform kev ywj pheej, STSAFE-A1xx nruab nrab tsis txuas ncaj qha mus rau STM32Cube HAL, tab sis los ntawm kev sib tshuam files siv nyob rau hauv daim ntawv thov (stsafea_service_interface_template.c, stsafea_interface_conf.h).
UM2646 – Rev 4
paj 6/23
UWM 2646
STSAFE-A1xx Middleware piav qhia
3.3
CORE module
CORE module yog qhov tseem ceeb ntawm cov khoom nruab nrab. Nws siv cov lus txib hu ua los ntawm cov khaubncaws sab nraud povtseg (daim ntawv thov, tsev qiv ntawv, pawg thiab lwm yam) txhawm rau kom siv cov yam ntxwv STSAFE-A1xx kom zoo.
Daim duab hauv qab no nthuav tawm a view ntawm CORE module architecture.
Daim duab 3. CORE module architecture
Sab saum toj txheej (daim ntawv thov, tsev qiv ntawv, pawg, thiab lwm yam)
COV
CRYPTO sab hauv module
SERVICE internal module
Lub CORE module yog ntau qhov sib txuas software txuas nrog:
·
Cov khaubncaws sab nraud povtseg: kev sib txuas sab nraud los ntawm kev xa tawm APIs tau piav qhia hauv ob lub rooj hauv qab no;
·
Cryptographic txheej: sab hauv kev sib txuas rau CRYPTO module;
·
Cov txheej txheem kho vajtse: kev sib txuas sab hauv rau SERVICE module;
STSAFE-A1xx middleware software pob muab cov ntaub ntawv API tiav ntawm CORE module hauv cov hauv paus nplaub tshev (saib STSAFE-A1xx_Middleware.chm file).
Xa mus rau STSAFE-A110 datasheet rau kev piav qhia luv luv ntawm cov lus txib teeb tsa, uas cov lus txib APIs teev nyob rau hauv cov lus hauv qab no muaj feem xyuam.
API qeb Initialization configuration
General-purpose commands
Cov ntaub ntawv muab faib commands
Table 1. CORE module exported API
Function StSafeA_Init Los tsim, pib thiab muab STSAFE-A1xx ntaus ntawv kov. StSafeA_GetVersion Kom rov qab kho STSAFE-A1xx nruab nrab. StSafeA_Echo Kom tau txais cov ntaub ntawv dhau los hauv cov lus txib. StSafeA_Reset Txhawm rau rov pib dua cov yam ntxwv tsis hloov pauv rau lawv cov nqi pib. StSafeA_GenerateRandom Los tsim ib tug xov tooj ntawm random bytes. StSafeA_Hibernate Txhawm rau muab STSAFE-Axxx ntaus ntawv hauv hibernation. StSafeA_DataPartitionQuery
UM2646 – Rev 4
paj 7/23
UWM 2646
STSAFE-A1xx Middleware piav qhia
API qeb
Function Query command kom retrieve cov ntaub ntawv muab faib configuration.
StSafeA_Decrement Kom decrement lub txee ib-txoj kev hauv ib cheeb tsam txee.
Cov ntaub ntawv muab faib commands
StSafeA_Read Mus nyeem cov ntaub ntawv los ntawm ib cheeb tsam cov ntaub ntawv muab faib.
StSafeA_Update Txhawm rau hloov kho cov ntaub ntawv los ntawm thaj chaw muab faib.
StSafeA_GenerateSignature Kom xa rov qab ECDSA kos npe hla cov lus digest.
Private thiab public key commands
StSafeA_GenerateKeyPair Txhawm rau tsim kom muaj tus yuam sij-pair hauv qhov chaw ntiag tug.
StSafeA_VerifyMessageSignature Txhawm rau txheeb xyuas cov ntawv pov thawj.
StSafeA_EstablishKey Txhawm rau tsim kom muaj kev sib koom zais cia ntawm ob tus tswv los ntawm kev siv asymmetric cryptography.
StSafeA_ProductDataQuery Query cov lus txib kom khaws cov ntaub ntawv khoom.
StSafeA_I2cParameterQuery Query cov lus txib kom rov qab tau qhov chaw nyob I²C thiab kev teeb tsa hluav taws xob qis.
StSafeA_LifeCycleStateQuery Query cov lus txib kom rov qab tau lub neej voj voog (Yug, Ua Haujlwm, Txiav, Yug thiab Xauv lossis Ua Haujlwm thiab Xauv).
Cov lus txib
StSafeA_HostKeySlotQuery Query cov lus txib kom khaws cov ntaub ntawv tseem ceeb ntawm tus tswv tsev (nyob thiab tus tswv C-MAC txee).
StSafeA_PutAttribute Txhawm rau muab cov cwj pwm hauv STSAFE-Axxx ntaus ntawv, xws li cov yuam sij, lo lus zais, I²C tsis raws li tus cwj pwm TAG.
StSafeA_DeletePassword Txhawm rau rho tawm tus password los ntawm nws qhov.
StSafeA_VerifyPassword Txhawm rau txheeb xyuas tus password thiab nco ntsoov cov txiaj ntsig ntawm kev pov thawj rau kev tso cai rau yav tom ntej.
StSafeA_RawCommand Kom ua tiav cov lus txib raw thiab tau txais cov lus teb cuam tshuam.
StSafeA_LocalEnvelopeKeySlotQuery Query cov lus txib kom khaws cov ntaub ntawv tseem ceeb hauv lub hnab ntawv (qhov naj npawb, nyob thiab qhov ntev) rau cov qhov tseem ceeb muaj.
Cov lus txib hauv lub hnab ntawv
StSafeA_GenerateLocalEnvelopeKey Txhawm rau tsim kom muaj tus yuam sij hauv lub hnab ntawv hauv zos qhov tseem ceeb.
StSafeA_WrapLocalEnvelope Los qhwv cov ntaub ntawv (feem ntau cov yuam sij) uas yog tswj hwm los ntawm tus tswv tsev, nrog lub hnab ntawv hauv zos thiab [AES key qhwv] algorithm.
StSafeA_UnwrapLocalEnvelope Txhawm rau tshem lub hnab ntawv hauv zos nrog tus yuam sij hauv lub hnab ntawv.
UM2646 – Rev 4
paj 8/23
UWM 2646
STSAFE-A1xx Middleware piav qhia
API qeb
Command tso cai configuration command
Table 2. Exported STSAFE-A110 CORE module APIs
Function StSafeA_CommandAuthorizationConfigurationQuery Query cov lus txib kom khaws cov xwm txheej nkag rau cov lus txib nrog cov xwm txheej nkag tau.
3.4
SERVICE module
SERVICE module yog txheej qis ntawm cov khoom nruab nrab. Nws siv tag nrho kho vajtse abstraction raws li MCU thiab kho vajtse platform.
Daim duab hauv qab no nthuav tawm a view ntawm SERVICE module architecture.
Daim duab 4. SERVICE module architecture
CORE sab hauv module
Kev Pabcuam
Sab nrauv sab nrauv (BSP, HAL, LL, thiab lwm yam)
SERVICE module yog dual-interface software tivthaiv txuas nrog:
·
Sab nrauv sab nrauv: xws li BSP, HAL lossis LL. Kev ua haujlwm tsis muaj zog yuav tsum tau ua nyob rau sab nraud siab dua
cov khaubncaws sab nraud povtseg thiab ua raws li stsafea_service_interface_template.c template file;
·
Core txheej: sab hauv kev sib txuas mus rau CORE module los ntawm kev xa tawm APIs tau piav qhia hauv lub rooj
hauv qab no;
STSAFE-A1xx middleware software pob muab cov ntaub ntawv API tiav ntawm SERVICE module hauv cov ntawv hauv paus (saib STSAFE-A1xx_Middleware.chm file).
Table 3. SERVICE module exported APIs
API qeb Initialization configuration
Tsawg-qib ua haujlwm ua haujlwm
Muaj nuj nqi
StSafeA_BSP_Init Txhawm rau pib lub tsheb npav sib txuas lus thiab IO pins xav tau los ua haujlwm STSAFE-Axxx ntaus ntawv.
StSafeA_Transmit Txhawm rau npaj cov lus txib kom xa mus, thiab hu rau lub npav API qis kom ua tiav. suav thiab sib txuas CRC, yog tias muaj kev txhawb nqa.
StSafeA_Receive Kom tau txais cov ntaub ntawv los ntawm STSAFE-Axxx los ntawm kev siv cov tsheb npav qis qis kom rov qab tau lawv.Check CRC, yog tias muaj kev txhawb nqa.
UM2646 – Rev 4
paj 9/23
UWM 2646
STSAFE-A1xx Middleware piav qhia
3.5
CRYPTO module
CRYPTO module sawv cev rau cryptographic ib feem ntawm cov khoom nruab nrab. Nws yuav tsum vam khom rau lub platform cov peev txheej cryptographic.
CRYPTO module yog ywj siab ntawm lwm cov khoom siv nruab nrab thiab, vim li no, tuaj yeem nkag tau yooj yim hauv thaj chaw ruaj ntseg uas haum rau kev tiv thaiv los ntawm MCU kev ruaj ntseg nta xws li lub cim xeeb tiv thaiv (MPU), firewall lossis TrustZone®.
Daim duab hauv qab no nthuav tawm a view ntawm CRYPTO module architecture.
Daim duab 5. CRYPTO module architecture
CORE sab hauv module
CRYPTO
Sab nraud cryptographic txheej
(MbedTM TLS, X-CUBE-CRYPTOLIB)
CRYPTO module yog dual-interface software txuas nrog:
·
lub tsev qiv ntawv cryptography sab nraud: Mbed TLS thiab X-CUBE-CRYPTOLIB tam sim no tau txais kev txhawb nqa. Tsis muaj zog
Kev ua haujlwm yuav tsum tau ua los ntawm cov txheej txheem siab dua sab nraud thiab ua raws li:
stsafea_crypto_mbedtls_interface_template.c template file rau lub tsev qiv ntawv Mbed TLS cryptographic;
stsafea_crypto_stlib_interface_template.c template file rau ST cryptographic tsev qiv ntawv;
Cov tsev qiv ntawv cryptographic ntxiv tuaj yeem tau txais kev txhawb nqa yooj yim los ntawm kev hloov kho lub cryptographic interface
tus qauv file.
·
cov txheej txheem tseem ceeb: kev sib txuas sab hauv rau CORE module los ntawm kev xa tawm APIs tau piav qhia hauv cov lus
hauv qab no;
STSAFE-A1xx middleware software pob muab cov ntaub ntawv API tiav ntawm CRYPTO module hauv cov hauv paus nplaub tshev (saib STSAFE-A1xx_Middleware.chm file).
Table 4. CRYPTO module exported APIs
API qeb
Muaj nuj nqi
StSafeA_ComputeCMAC Los xam tus nqi CMAC. Siv rau ntawm cov lus txib npaj.
StSafeA_ComputeRMAC Los xam tus nqi RMAC. Siv rau ntawm cov lus teb tau txais.
StSafeA_DataEncryption Cryptographic APIs Txhawm rau ua cov ntaub ntawv encryption (AES CBC) ntawm STSAFE-Axxx cov ntaub ntawv tsis nyob.
StSafeA_DataDecryption Txhawm rau ua cov ntaub ntawv decryption (AES CBC) ntawm STSAFE-Axxx cov ntaub ntawv tsis.
StSafeA_MAC_SHA_PrePostProcess Txhawm rau ua ntej lossis tom qab txheej txheem MAC thiab/lossis SHA ua ntej xa, lossis tom qab tau txais cov ntaub ntawv los ntawm STSAFE_Axxx ntaus ntawv.
UM2646 – Rev 4
paj 10/23
3.6
Nco tseg:
UWM 2646
STSAFE-A1xx Middleware piav qhia
Cov qauv
Tshooj lus no muab cov lus piav qhia ntxaws ntxaws ntawm cov qauv muaj nyob hauv STSAFE-A1xx nruab nrab software pob.
Tag nrho cov templates teev nyob rau hauv cov lus hauv qab no yog muab nyob rau hauv lub Interface nplaub tshev muaj nyob rau hauv lub hauv paus theem ntawm lub nruab nrab software pob.
Template files yog muab raws li examples yuav tsum tau theej thiab kho rau hauv cov khaubncaws sab nraud povtseg, thiaj li yooj yim
integrate thiab configure STSAFE-A1xx middleware:
·
Interface template files muab example kev siv ntawm __weak functions, muaj raws li khoob los yog
ib nrab khoob ua haujlwm hauv nruab nrab. Lawv yuav tsum tau ua kom zoo nyob rau hauv cov neeg siv qhov chaw los yog nyob rau hauv
cov khaubncaws sab nraud povtseg raws li lub tsev qiv ntawv cryptographic thiab rau cov neeg siv cov kev xaiv kho vajtse.
·
Configuration template files muab txoj hauv kev yooj yim los teeb tsa STSAFE-A1xx nruab nrab thiab nta
uas tuaj yeem siv rau hauv cov neeg siv daim ntawv thov, xws li kev ua kom zoo lossis kho vajtse tshwj xeeb.
Template qeb
Interface templates
Configuration templates
Rooj 5. Templates
Template file
stsafea_service_interface_template.c Example template los qhia txog kev txhawb nqa cov kev pabcuam kho vajtse yuav tsum tau ua los ntawm STSAFE-A nruab nrab thiab muab los ntawm cov khoom siv tshwj xeeb, cov tsev qiv ntawv qis lossis BSP xaiv hauv qhov chaw siv. stsafea_crypto_mbedtls_interface_template.c Example template los qhia yuav ua li cas los txhawb cov kev pabcuam cryptographic uas yuav tsum tau ua los ntawm STSAFE-A nruab nrab thiab muab los ntawm Mbed TLS cryptographic tsev qiv ntawv (tseem ceeb tswj, SHA, AES, thiab lwm yam). stsafea_crypto_stlib_interface_template.c Example template los qhia yuav ua li cas los txhawb cov kev pabcuam cryptographic uas yuav tsum tau ua los ntawm STSAFE-A nruab nrab thiab muab los ntawm STM32 cryptographic tsev qiv ntawv software nthuav dav rau STM32Cube (XCUBE-CRYPTOLIB) (kev tswj hwm tseem ceeb, SHA, AES, thiab lwm yam). stsafea_conf_template.h Example template qhia yuav ua li cas rau configure STSAFE-A middleware (tshwj xeeb yog rau optimizations lub hom phiaj). stsafea_interface_conf_template.h Example template qhia yuav ua li cas rau configure thiab customize lub interface files teev saum toj no.
Cov qauv saum toj no tsuas muaj nyob hauv BSP nplaub tshev ntawm X-CUBE-SAFEA1 pob.
UM2646 – Rev 4
paj 11/23
UWM 2646
STSAFE-A1xx Middleware piav qhia
3.7
Folder qauv
Daim duab hauv qab no nthuav tawm cov qauv ntawv tais ceev tseg ntawm STSAFE-A1xx middleware software pob v1.2.1.
Daim duab 6. Qhov project file qauv
Qhov project file qauv STSAFE-A1xx Middleware
UM2646 – Rev 4
Qhov project file qauv rau X-CUBE-SAFEA1 rau STM32CubeMX
paj 12/23
3.8
3.8.1
3.8.2
UWM 2646
STSAFE-A1xx Middleware piav qhia
Yuav ua li cas: kev koom ua ke thiab configuration
Tshooj lus no piav qhia txog kev sib koom ua ke thiab teeb tsa STSAFE-A1xx cov khoom nruab nrab hauv cov neeg siv daim ntawv thov.
Kev koom ua ke cov kauj ruam
Ua raws li cov kauj ruam no los koom ua ke STSAFE-A1xx middleware hauv daim ntawv thov xav tau:
·
Kauj ruam 1: Luam (thiab xaiv hloov npe) lub stsafea_service_interface_template.c file thiab ib qho ntawm
stsafea_crypto_mbedtls_interface_template.c lossis stsafea_crypto_stlib_interface_template.c rau tus neeg siv
qhov chaw raws li lub tsev qiv ntawv cryptographic uas tau ntxiv rau daim ntawv thov (txawm li cas los xij
cryptographic tsev qiv ntawv xaiv / siv los ntawm cov neeg siv, lawv tuaj yeem tsim / siv lawv tus kheej cryptographic
interface file los ntawm kos los ntawm kev hloov cov qauv tsim nyog).
·
Kauj ruam 2: Luam (thiab xaiv hloov npe) lub stsafea_conf_template.h thiab stsafea_interface_conf_template.h
files rau qhov chaw siv.
·
Kauj ruam 3: Nco ntsoov ntxiv txoj cai suav nrog hauv koj lub ntsiab lossis lwm tus neeg siv qhov chaw file uas yuav tsum tau
interface lub STSAFE-A1xx Middleware:
#include “stsafea_core.h” #include “stsafea_interface_conf.h”
·
Kauj ruam 4: Customize lub files siv nyob rau hauv peb kauj ruam saum toj no raws li cov neeg siv nyiam.
Cov txheej txheem teeb tsa
Txhawm rau txhawm rau txhim kho STSAFE-A1xx cov khoom nruab nrab hauv cov neeg siv daim ntawv thov, ST muab ob qhov sib txawv
configuration template files yuav tsum tau theej thiab kho nyob rau hauv cov neeg siv qhov chaw raws li tus neeg siv cov kev xaiv:
·
stsafea_interface_conf_template.h: Qhov no example template yog siv rau thiab qhia yuav ua li cas rau configure lub
cryptographic thiab kev pabcuam nruab nrab ntawm cov neeg siv khoom siv los ntawm cov hauv qab no #define
nqe lus:
USE_PRE_LOADED_HOST_KEYS
MCU_PLATFORM_INCLUDE
MCU_PLATFORM_BUS_INCLUDE
MCU_PLATFORM_CRC_INCLUDE
·
stsafea_conf_template.h: Qhov no example template yog siv rau thiab qhia yuav ua li cas rau configure STSAFE-A
Middleware los ntawm cov hauv qab no #define nqe lus:
STSAFEA_USE_OPTIMIZATION_SHARED_RAM
STSAFEA_USE_OPTIMIZATION_NO_HOST_MAC_ENCRYPT
STSAFEA_USE_FULL_ASSERT
USE_SIGNATURE_SESSION (rau STSAFE-A100 nkaus xwb)
Ua raws li cov kauj ruam no txhawm rau txhawm rau koom nrog STSAFE-A1xx Middleware hauv daim ntawv thov xav tau:
·
Kauj ruam 1: Luam (thiab xaiv hloov npe) lub stsafea_interface_conf_template.h thiab stsafea_conf_template.h
files rau qhov chaw siv.
·
Kauj ruam 2: Paub meej lossis hloov kho qhov #define nqe lus ntawm ob lub ntsiab lus saum toj no files raws
tus neeg siv platform thiab kev xaiv cryptographic.
UM2646 – Rev 4
paj 13/23
4
4.1
Nco tseg:
4.2
Nco tseg:
UWM 2646
Demonstration software
Demonstration software
Tshooj lus no qhia txog kev ua qauv qhia software raws li STSAFE-A1xx middleware.
Kev lees paub tseeb
Qhov kev ua qauv qhia no qhia txog cov lus txib khiav qhov twg STSAFE-A110 tau teeb tsa rau ntawm lub cuab yeej uas lees paub rau tus tswv tsev nyob deb (IoT cov ntaub ntawv), tus tswv tsev hauv zos tau siv los ntawm kev hla mus rau cov chaw taws teeb tswj. Qhov xwm txheej qhov twg STSAFE-A110 yog mounted ntawm lub peripheral uas authenticates rau ib lub zos host, example rau kev ua si, mobile accessories los yog consumables, yog raws nraim tib yam.
Command flow Rau kev ua qauv qhia, cov tswv hauv zos thiab cov chaw taws teeb yog tib lub cuab yeej ntawm no. 1. Extract, txheeb xyuas thiab txheeb xyuas STSAFE-A110 daim ntawv pov thawj pej xeem khaws cia hauv cov ntaub ntawv muab faib 0 ntawm lub cuab yeej
txhawm rau kom tau txais tus yuam sij pej xeem: Nyeem daim ntawv pov thawj siv STSAFE-A1xx Middleware los ntawm STSAFE-A110's zone 0. Parse daim ntawv pov thawj siv lub tsev qiv ntawv cryptographic parser. Nyeem daim ntawv pov thawj CA (muaj los ntawm txoj cai). Parse daim ntawv pov thawj CA siv lub tsev qiv ntawv cryptographic parser. Txheeb xyuas daim ntawv pov thawj siv tau siv daim ntawv pov thawj CA los ntawm lub tsev qiv ntawv cryptographic. Tau txais tus yuam sij pej xeem los ntawm STSAFE-A110 X.509 daim ntawv pov thawj. 2. Tsim thiab txheeb xyuas qhov kos npe hla tus lej sib tw: Tsim tus lej sib tw (tus lej lej). Hash qhov kev sib tw. Nqa daim ntawv kos npe hla qhov kev sib tw hashed siv STSAFE-A110 tus kheej qhov tseem ceeb 0 los ntawm
STSAFE-A1xx Middleware. Parse lub generated kos npe siv lub tsev qiv ntawv cryptographic. Txheeb xyuas qhov kos npe tsim los siv STSAFE-A110 tus yuam sij pej xeem los ntawm lub tsev qiv ntawv cryptographic. Thaum qhov no siv tau, tus tswv tsev paub tias lub peripheral lossis IoT yog qhov tseeb.
Ua khub
Qhov no code example tsim kev sib koom ua ke ntawm STSAFE-A110 ntaus ntawv thiab MCU nws txuas nrog. Kev sib koom ua ke tso cai rau kev sib pauv ntawm cov cuab yeej thiab MCU kom muaj kev lees paub (uas yog, kos npe thiab txheeb xyuas). Lub STSAFE-A110 cov cuab yeej siv tau tsuas yog ua ke nrog MCU nws tau ua ke nrog. Kev sib koom ua ke muaj xws li tus tswv tsev MCU xa tus tswv tsev MAC tus yuam sij thiab tus tswv tsev tus yuam sij rau STSAFE-A110. Ob tus yuam sij raug muab khaws cia rau hauv kev tiv thaiv NVM ntawm STSAFE-A110 thiab yuav tsum muab khaws cia rau lub cim xeeb flash ntawm STM32 ntaus ntawv. Los ntawm default, nyob rau hauv no example, tus tswv tsev MCU xa cov yuam sij zoo mus rau STSAFE-A110 (saib cov lus txib hauv qab no) uas tau pom zoo siv rau kev ua qauv qhia. Txoj cai kuj tso cai rau tiam ntawm cov yuam sij random. Ntxiv mus, lub code example tsim ib lub hnab ntawv hauv zos thaum qhov sib txuas tsis tau muaj nyob hauv STSAFE-A110. Thaum lub hnab ntawv hauv zos muaj neeg nyob, STSAFE-A110 ntaus ntawv tso cai rau tus tswv tsev MCU los qhwv / unwrap lub hnab ntawv hauv zos kom ruaj ntseg khaws tus yuam sij ntawm tus tswv tsev MCU sab. Qhov sib txuas code example yuav tsum tau ua tiav ua ntej ua tiav tag nrho cov cai hauv qab no examples.
Hais kom ntws
1. Tsim lub hnab ntawv hauv zos hauv STSAFE-A110 siv STSAFE-A1xx middleware. Los ntawm lub neej ntawd, cov lus txib no tau qhib. Nco ntsoov tias kev tsis tawm tswv yim hauv qab no txhais cov lus hauv pa iring.c file deactivates lub zos lub hnab ntawv tseem ceeb tiam: /* #define _FORCE_DEFAULT_FLASH_ */
Qhov kev ua haujlwm no tsuas yog tshwm sim yog tias STSAFE-A110 lub hnab ntawv hauv zos qhov tseem ceeb tsis tau muaj nyob.
UM2646 – Rev 4
paj 14/23
UWM 2646
Demonstration software
2. Txhais ob tus lej 128-ntsis siv los ua tus tswv tsev MAC tus yuam sij thiab tus tswv tsev tus yuam sij cipher. Los ntawm lub neej ntawd, cov yuam sij golden paub siv. Lawv muaj cov txiaj ntsig hauv qab no: 0x00,0x11,0x22,0x33,0x44,0x55,0x66,0x77,0x88,0x99,0xAA,0xBB,0xCC,0xDD,0xEE,0xFF / * Host MAC key */ 0x11,0,x11,0, 22,0x22,0x33,0x33,0x44,0x44,0x55,0x55,0x66,0x66,0x77,0x77,0x88,0x88 / * Host cipher key */
Txhawm rau qhib lub cim tseem ceeb, ntxiv cov lus qhia hauv qab no rau lub pairing.c file: #define USE_HOST_KEYS_SET_BY_PAIRING_APP 1
3. Khaws tus tswv tsev MAC tus yuam sij thiab tus tswv tsev cipher tus yuam sij rau lawv qhov chaw nyob hauv STSAFE-A110. 4. Khaws tus tswv tsev MAC tus yuam sij thiab tus tswv tsev cipher tus yuam sij rau STM32 lub cim xeeb flash.
4.3
Kev lag luam tseem ceeb (tsim tsis pub leej twg paub)
Qhov kev ua qauv qhia no qhia txog qhov xwm txheej uas STSAFE-A110 ntaus ntawv tau teeb tsa rau ntawm lub cuab yeej (xws li IoT ntaus ntawv), uas sib txuas lus nrog cov chaw taws teeb tswj, thiab yuav tsum tsim kom muaj kev ruaj ntseg channel los pauv cov ntaub ntawv nrog nws.
Hauv no example, STM32 ntaus ntawv ua lub luag haujlwm ntawm ob lub chaw ua haujlwm nyob deb (chaw taws teeb chaw taws teeb) thiab tus tswv tsev hauv zos uas txuas nrog STSAFE-A110 ntaus ntawv.
Lub hom phiaj ntawm cov ntaub ntawv siv no yog los qhia yuav ua li cas los tsim kom muaj kev sib koom zais cia ntawm tus tswv tsev hauv zos thiab cov chaw taws teeb tswj kev siv lub elliptic nkhaus Diffie-Hellman scheme nrog qhov zoo li qub (ECDH) lossis ephemeral (ECDHE) tus yuam sij hauv STSAFE-A110.
Cov ntaub ntawv qhia tsis pub lwm tus paub yuav tsum tau muab ntxiv mus rau ib lossis ntau tus yuam sij ua haujlwm (tsis tau piav qhia ntawm no). Cov yuam sij ua haujlwm no tuaj yeem siv tau hauv kev sib txuas lus xws li TLS, piv txwv liample rau kev tiv thaiv kev tsis pub lwm tus paub, kev ncaj ncees thiab qhov tseeb ntawm cov ntaub ntawv uas tau pauv ntawm tus tswv tsev hauv zos thiab cov chaw taws teeb tswj.
Hais kom ntws
Daim duab 7. Lub hauv paus tseem ceeb hais kom ua ntws qhia txog cov lus txib khiav.
·
Tus tswv tsev tej thaj chaw deb tus ntiag tug thiab pej xeem cov yuam sij yog nyuaj-coded nyob rau hauv lub code example.
·
Tus tswv tsev hauv zos xa cov lus txib StSafeA_GenerateKeyPair mus rau STSAFE-A110 los tsim cov
khub tseem ceeb ntawm nws qhov ephemeral (qhov 0xFF).
·
STSAFE-A110 xa rov qab rau pej xeem tus yuam sij (uas sib raug rau qhov 0xFF) rau STM32 ( sawv cev
cov chaw taws teeb tswj).
·
STM32 suav cov chaw taws teeb tswj qhov zais cia (siv STSAFE ntaus ntawv tus yuam sij pej xeem thiab cov chaw taws teeb
host tus yuam sij ntiag tug).
·
STM32 xa tus tswv tsev nyob deb nroog tus yuam sij rau STSAFE-A110 thiab nug STSAFE-A110 rau
suav tus tswv tsev hauv zos qhov zais cia siv StSafeA_EstablishKey API.
·
STSAFE-A110 xa rov qab tus tswv tsev hauv zos qhov zais cia rau STM32.
·
STM32 sib piv ob qhov zais cia, thiab luam tawm qhov tshwm sim. Yog hais tias cov secrets yog tib yam, qhov zais cia
kev tsim muaj kev vam meej.
UM2646 – Rev 4
paj 15/23
Daim duab 7. Lub chaw tsim khoom tseem ceeb hais kom ua ntws
UWM 2646
Demonstration software
Tus tswv tsev nyob deb
SWB 32
Local host
STSAFE
Muab xam cov chaw taws teeb tswj qhov zais cia (siv cov chaw taws teeb tswj tus kheej tus yuam sij thiab tus tswv tsev hauv zos (STSAFE qhov 0xFF) pej xeem tus yuam sij)
Tej thaj chaw deb host qhov zais cia
Tsim Pair Key
Tsim Pair Key ntawm qhov 0xFF
STSAFE's public key generated on
Tsim STSAFE's public key
cev 0xff
Tej thaj chaw deb host's public key
STM32 piv cov chaw taws teeb tswj zais cia rau lub
local host zais cia thiab luam tawm qhov tshwm sim
Tsim Cov Ntsiab Lus (cov chaw taws teeb tswj hwm tus yuam sij pej xeem)
Xa tus tswv tsev zais cia
Kev suav cov tswv tsev hauv zos tsis pub leej twg paub (siv tus tswv tsev hauv zos tus yuam sij ntiag tug (STSAFE qhov 0xFF) thiab tus tswv tsev tej thaj chaw deb qhov tseem ceeb)
Local host tus zais cia
4.4
Nco tseg:
4.5
Qhwv / unwrap lub hnab ntawv hauv zos
Qhov kev ua qauv qhia no qhia txog qhov xwm txheej uas STSAFE-A110 qhwv / unwraps lub hnab ntawv hauv zos kom ruaj ntseg khaws cia tsis pub lwm tus paub rau ib qho kev nco tsis muaj zog (NVM). Cov yuam sij encryption / decryption tuaj yeem khaws cia zoo li ntawd rau kev nco ntxiv lossis hauv STSAFEA110 tus neeg siv cov ntaub ntawv nco. Lub tshuab wrapping yog siv los tiv thaiv cov ntawv zais lossis cov ntawv dawb. Cov zis ntawm qhwv yog ib lub hnab ntawv encrypted nrog AES key qhwv algorithm, thiab uas muaj tus yuam sij lossis cov ntawv dawb los tiv thaiv.
Hais kom ntws
Cov tswv tsev hauv zos thiab thaj chaw deb yog tib lub cuab yeej ntawm no. 1. Tsim cov ntaub ntawv random assimilated rau ib lub hnab ntawv hauv zos. 2. qhwv lub hnab ntawv hauv zos siv STSAFE-A110's middleware. 3. Khaws lub hnab ntawv. 4. Unwrap lub hnab ntawv uas siv STSAFE-A110's middleware. 5. Sib piv lub hnab ntawv uas tsis tau qhwv rau lub hnab ntawv thawj zaug hauv zos. Lawv yuav tsum sib npaug.
Tseem ceeb khub tiam
Qhov kev ua qauv qhia no qhia txog cov lus txib khiav qhov twg STSAFE-A110 ntaus ntawv tau teeb tsa ntawm tus tswv tsev hauv zos. Tus tswv tsev nyob deb nug tus tswv tsev hauv zos no los tsim ib khub tseem ceeb (tus yuam sij ntiag tug thiab tus yuam sij pej xeem) ntawm qhov 1 thiab tom qab ntawd kos npe rau qhov kev sib tw (tus naj npawb random) nrog tus yuam sij tsim tawm.
Tus tswv tsev nyob deb nroog tuaj yeem txheeb xyuas qhov kos npe nrog tus yuam sij pej xeem tsim.
Qhov kev ua qauv qhia no zoo ib yam li Kev Tshawb Fawb Kev Tshawb Fawb nrog ob qhov sib txawv:
·
Cov khub tseem ceeb hauv qhov kev ua pov thawj tseeb tau tsim tawm (ntawm qhov 0), hos, hauv qhov example,
peb tsim cov khub tseem ceeb ntawm qhov 1. Lub STSAFE-A110 ntaus ntawv kuj tuaj yeem tsim cov khub tseem ceeb ntawm qhov 0xFF,
tab sis tsuas yog rau lub hom phiaj tseem ceeb ntawm kev tsim.
·
Tus yuam sij rau pej xeem nyob rau hauv qhov kev qhia ua pov thawj yog muab rho tawm los ntawm daim ntawv pov thawj hauv cheeb tsam 0. Hauv qhov no
example, tus yuam sij pej xeem raug xa rov qab nrog STSAFE-A110 cov lus teb rau qhov
StSafeA_GenerateKeyPair hais kom ua.
UM2646 – Rev 4
paj 16/23
UWM 2646
Demonstration software
Nco tseg:
Hais kom ntws
Rau kev ua qauv qhia, cov tswv hauv zos thiab cov chaw taws teeb yog tib lub cuab yeej ntawm no. 1. Tus tswv tsev xa cov lus txib StSafeA_GenerateKeyPair mus rau STSAFE-A110, uas xa rov qab rau
pej xeem tus yuam sij rau tus tswv tsev MCU. 2. Tus tswv tsev tsim kev sib tw (48-byte random tus lej) siv StSafeA_GenerateRandom API. Cov
STSAFE-A110 xa rov qab tus lej tsim tawm. 3. Tus tswv tsev suav cov hash ntawm tus lej tsim los siv lub tsev qiv ntawv cryptographic. 4. Tus tswv tsev nug STSAFE-A110 los tsim ib qho kos npe ntawm kev suav hash siv lub
StSafeA_GenerateSignature API. STSAFE-A110 xa rov qab cov npe kos npe.
5. Tus tswv tsev txheeb xyuas qhov kos npe tsim nrog tus yuam sij pej xeem xa los ntawm STSAFE-A110 hauv kauj ruam 1. 6. Daim ntawv pov thawj kos npe tau luam tawm.
UM2646 – Rev 4
paj 17/23
UWM 2646
Kev kho keeb kwm
Table 6. Cov ntaub ntawv kho dua tshiab
Hnub tim
Kev kho dua
Hloov
09-Nov-2019
1
Kev tso tawm thawj zaug.
13- Peb Hlis-2020
2
Removed License information section.
Hloov kho cov npe ntawm cov yam ntxwv uas tau piav qhia los ntawm cov lej ua qauv qhia hauv Kev Taw Qhia. Tshem tawm Daim ntawv teev cov lus luv luv thiab muab cov lus piav qhia thaum kawg.
Hloov cov ntawv me me thiab hloov xim hauv daim duab 1. STSAFE-A1xx architecture.
Hloov kho daim duab 2. STSAFE-A1xx daim ntawv thov thaiv daim duab.
Hloov tshiab Table 1. CORE module exported API.
07- Peb-2022
3
Tshem tawm StSafeA_InitHASH thiab StSafeA_ComputeHASH los ntawm Table 4. CRYPTO module exported APIs.
Hloov Kho Ntu 3.8.2: Cov kauj ruam teeb tsa.
Hloov Kho Ntu 4.2: Pairing.
Hloov Kho Ntu 4.3: Kev lag luam tseem ceeb (tsim kom tsis pub leej twg paub).
Ntxiv Ntu 4.5: Cov cim tseem ceeb.
Hloov cov ntawv me me.
Ntxiv STSAFE-A1xx software pob yog kev koom ua ke hauv X-CUBE-SAFEA1 v1.2.1 li nruab nrab
thiab nws tau koom ua ke raws li BSP rau cov software pob rau STM32CubeMX. thiab cov templates saum toj no
07 - Peb 2024
4
tsuas yog muaj nyob hauv BSP nplaub tshev ntawm X-CUBE-SAFEA1 pob..
Hloov Kho Ntu 3.1: Cov lus piav qhia dav dav, Ntu 3.2: Kev tsim vaj tsev thiab ntu 3.7: Cov qauv txheej txheem.
UM2646 – Rev 4
paj 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 nkhaus DiffieHellman – ephemeralbed EWARM IWARM Arm® HAL Hardware abstraction txheej I/O Input/output IAR Systems® Ntiaj teb tus thawj coj hauv cov cuab yeej software thiab cov kev pabcuam rau kev tsim kho tshuab. IDE Integrated Development ib puag ncig. Ib daim ntawv thov software uas muab cov chaw zoo rau cov khoos phis tawj programmer rau kev txhim kho software. IoT Internet ntawm yam I²C Inter-integrated circuit (IIC) LL Low-level drivers MAC Message authentication code MCU Microcontroller unit MDK-ARM Keil® microcontroller development kit for Arm® MPU Memory protection unit NVM Nonvolatile memory
OS Operating system SE Secure element SHA Secure Hash algorithm SLA Software daim ntawv tso cai daim ntawv cog lus ST STMicroelectronics TLS Thauj txheej ruaj ntseg USB Universal serial tsheb npav
UWM 2646
Glossary
UM2646 – Rev 4
paj 19/23
UWM 2646
Cov ntsiab lus
Cov ntsiab lus
1 Cov ntaub ntawv dav dav. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 2 STSAFE-A110 ruaj ntseg element. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 3 STSAFE-A1xx Middleware piav qhia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3.1 Kev piav qhia dav dav. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 3.2 Architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 3.3 CORE module. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 3.4 SERVICE module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 3.5 CRYPTO module. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 3.6 Cov. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 3.7 Folder structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 3.8 Yuav ua li cas: kev koom ua ke thiab kev teeb tsa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
3.8.1 Cov kauj ruam sib xyaw. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 3.8.2 Configuration kauj ruam . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
4 Demonstration software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14 4.1 Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 4.2 Sib. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 4.3 Kev lag luam tseem ceeb (tsim tsis pub leej twg paub). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 4.4 Ntim / unwrap lub hnab ntawv hauv zos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 4.5 Qhov tseem ceeb khub tiam. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Kev kho keeb kwm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18 Daim ntawv teev . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21 Daim ntawv teev cov duab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
UM2646 – Rev 4
paj 20/23
UWM 2646
Daim ntawv teev cov rooj
Daim ntawv teev cov rooj
Table 1. Table 2. Table 3. Table 4. Table 5. Table 6.
CORE module exported API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Exported STSAFE-A110 CORE module APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 SERVICE module exported APIs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 CRYPTO module exported APIs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Cov Templates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Cov ntaub ntawv hloov kho keeb kwm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
UM2646 – Rev 4
paj 21/23
UWM 2646
Daim ntawv teev cov duab
Daim ntawv teev cov duab
Daim duab 1. Daim duab 2. Daim duab 3. Daim duab 4. Daim duab 5. Daim duab 6. Daim duab 7.
STSAFE-A1xx architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 STSAFE-A1xx daim duab thaiv daim duab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 CORE module architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 SERVICE module architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 CRYPTO module architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Qhov project file qauv. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Qhov tseem ceeb tsim cov lus txib khiav. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
UM2646 – Rev 4
paj 22/23
UWM 2646
TSEEM CEEB CEEB TOOM NYEEM CEEB TOOM STMicroelectronics NV thiab nws cov chaw ua haujlwm (“ST”) muaj cai hloov pauv, kho, txhim kho, hloov kho, thiab kev txhim kho rau cov khoom ST thiab / lossis cov ntaub ntawv no txhua lub sijhawm yam tsis muaj ntawv ceeb toom. Cov neeg yuav khoom yuav tsum tau txais cov ntaub ntawv tseem ceeb ntawm ST cov khoom ua ntej muab xaj. ST cov khoom raug muag raws li ST cov nqe lus thiab cov xwm txheej ntawm kev muag khoom nyob rau hauv qhov chaw thaum lub sijhawm lees paub kev txiav txim. Cov neeg yuav khoom tsuas yog lub luag haujlwm rau kev xaiv, xaiv, thiab siv cov khoom ST thiab ST xav tias tsis muaj kev lav phib xaub rau daim ntawv thov kev pab lossis kev tsim khoom ntawm cov neeg yuav khoom. Tsis muaj daim ntawv tso cai, qhia lossis qhia, rau txhua txoj cai kev txawj ntse tau tso cai los ntawm ST ntawm no. Kev muag khoom ntawm ST nrog cov kev cai sib txawv ntawm cov ntaub ntawv tau teev tseg hauv no yuav tsis muaj kev lav phib xaub los ntawm ST rau cov khoom no. ST thiab ST logo yog cov cim lag luam ntawm ST. Yog xav paub ntxiv txog ST cov cim lag luam, xa mus rau www.st.com/trademarks. Tag nrho lwm yam khoom lossis kev pabcuam npe yog cov cuab yeej ntawm lawv cov tswv. Cov ntaub ntawv hauv daim ntawv no hloov pauv thiab hloov cov ntaub ntawv yav dhau los uas tau muab rau hauv ib qho ua ntej ntawm daim ntawv no.
© 2024 STMicroelectronics All rights reserved
UM2646 – Rev 4
paj 23/23
Cov ntaub ntawv / Cov ntaub ntawv
 |
STMicroelectronics X-CUBE-SAFEA1 Software Pob [ua pdf] Cov neeg siv phau ntawv qhia STSAFE-A100, STSAFE-A110, X-CUBE-SAFEA1 Software Pob, X-CUBE-SAFEA1, Software Pob, Pob |
