X-CUBE-SAFEA1 Software Package
Litlhaloso
- Lebitso la Sehlahisoa: STSAFE-A110 Secure Element
- Phetolelo: X-CUBE-SAFEA1 v1.2.1
- E kenyelelitsoe ho: STM32CubeMX software pack
- Likarolo tsa Bohlokoa:
- Sireletsa seteishene se nang le moamoheli oa hole ho kenyeletsoa
transport layer security (TLS) ho tsukutlana ka letsoho - Ts'ebeletso ea netefatso ea ho saena (boot e sireletsehileng le firmware
ntlafatsa) - Tlhokomelo ea tšebeliso e nang le li-counters tse sireletsehileng
- Ho kopanya le ho sireletsa kanale e nang le processor ea app e amohelang
- Ho phuthela le ho phutholla lienfelopo tsa lehae kapa tse hole
- Ho hlahisa li-key pair tsa on-chip
- Sireletsa seteishene se nang le moamoheli oa hole ho kenyeletsoa
Litaelo tsa Tšebeliso ea Sehlahisoa
1. Boitsebiso bo Akaretsang
Karolo e sireletsehileng ea STSAFE-A110 e etselitsoe ho fana ka
netefatso le lits'ebeletso tsa taolo ea data sebakeng sa lehae kapa se hole
mabotho. E loketse lits'ebetso tse fapaneng joalo ka lisebelisoa tsa IoT,
litsamaiso tse bohlale tsa lapeng, lits'ebetso tsa indasteri, le tse ling.
2. Ho Qala
Ho qala ho sebelisa ntho e sireletsehileng ea STSAFE-A110:
- Sheba datha e fumanehang ho STSAFE-A110 ea semmuso
web leqephe bakeng sa tlhaiso-leseling e batsi. - Khoasolla sephutheloana sa software sa STSAFE-A1xx middleware ho tsoa ho
STSAFE-A110 leqephe la inthanete kapa STM32CubeMX. - Netefatsa hore e tsamaellana le li-IDE tse tšehelitsoeng joalo ka STM32Cube IDE kapa
Sistimi ea Workbench bakeng sa STM32.
3. Tlhaloso ea Middleware
3.1 Tlhaloso e Akaretsang
STSAFE-A1xx middleware e thusa tšebelisano lipakeng tsa
sesebelisoa se bolokehileng le MCU, se nolofalletsang linyeoe tse fapaneng tsa ts'ebeliso.
E kopantsoe ka har'a liphutheloana tsa software tsa ST ho matlafatsa ts'ireletso
Likaroloana.
3.2 Boqapi ba Meaho
Middleware e na le likarolo tse fapaneng tsa software,
ho kenyelletsa:
- STSAFE-A1xx API (sehokelo sa mantlha)
- MOKHOPO CRYPTO
- MbedTLS Cryptographic service interface SHA/AES
- Sehokelo sa tšebeletso ea Hardware X-CUBECRYPTOLIB
Lipotso tse atisang ho botsoa (FAQ)
P: Nka fumana kae database ea STSAFE-A110?
A: Lethathamo la lintlha le teng ho STSAFE-A110 web leqepheng la
boitsebiso bo eketsehileng ka sesebelisoa.
P: Ke libaka life tse tšehetsoeng tsa ntlafatso e kopaneng
bakeng sa STSAFE-A1xx middleware?
A: Li-IDE tse tšehetsoeng li kenyelletsa STM32Cube IDE le System Workbench
bakeng sa STM32 (SW4STM32) ho X-CUBE-SAFEA1 v1.2.1 sephutheloana.
UM2646
Bukana ea mosebelisi
Ho qala ka X-CUBE-SAFEA1 software package
Selelekela
Bukana ena ea mosebedisi e hlalosa mokhoa oa ho qala ka X-CUBE-SAFEA1 software package. X-CUBE-SAFEA1 software package ke karolo ea software e fanang ka likhoutu tse 'maloa tsa lipontšo, tse sebelisang lisebelisoa tsa sesebelisoa sa STSAFE-A110 ho tsoa ho microcontroller e amohelang. Likhoutu tsena tsa lipontšo li sebelisa STSAFE-A1xx middleware e hahiloeng holim'a theknoloji ea software ea STM32Cube ho nolofatsa ts'ebetso ho li-microcontroller tse fapaneng tsa STM32. Ho feta moo, ke MCU-agnostic bakeng sa ho khoneha ho li-MCU tse ling. Likhoutu tsena tsa lipontšo li bonts'a likarolo tse latelang: · Netefatso · Ho kopanya · Ho theha lintlha tsa bohlokoa · Ho phuthela ha enfelopo · Ho hlahisa li-key
UM2646 - Rev 4 - Hlakubele 2024 Bakeng sa tlhaiso-leseling e batsi, ikopanye le ofisi ea hau ea thekiso ea STMicroelectronics ea lehae.
www.st.com
1
Tlhokomeliso:
UM2646
Lintlha tse akaretsang
Lintlha tse akaretsang
Sephutheloana sa software sa X-CUBE-SAFEA1 ke sesupo sa ho hokahanya lits'ebeletso tse sireletsehileng tsa STSAFE-A110 ho sistimi e sebetsang ea MCU (OS) le ts'ebeliso ea eona. E na le mokhanni oa STSAFE-A110 le likhoutu tsa lipontšo tse lokelang ho sebelisoa ho li-microcontroller tsa STM32 32-bit tse ipapisitseng le processor ea Arm® Cortex®-M. Arm ke lets'oao la khoebo le ngolisitsoeng la Arm Limited (kapa liofisiri tsa eona) Amerika le/kapa libakeng tse ling. Sephutheloana sa software sa X-CUBE-SAFEA1 se hlahisoa ho ANSI C. Leha ho le joalo, mohaho o ikemetseng oa sethaleng o lumella ho khoneha habonolo ho liforomo tse fapaneng tse fapaneng. Lethathamo le ka tlase le fana ka tlhaloso ea mantsoe a khutsufalitsoeng a bohlokoa bakeng sa kutloisiso e ntle ea tokomane ena.
Sephutheloana sa software sa STSAFE-A1xx se kopantsoe ho X-CUBE-SAFEA1 v1.2.1 e le middleware 'me e kopantsoe e le BSP bakeng sa pakete ea software bakeng sa STM32CubeMX.
UM2646 - Tšen 4
leqepheng la 2/23
UM2646
STSAFE-A110 ntho e sireletsehileng
2
STSAFE-A110 ntho e sireletsehileng
STSAFE-A110 ke tharollo e sireletsehileng haholo e sebetsang e le ntho e sireletsehileng e fanang ka litšebeletso tsa netefatso le taolo ea data ho moamoheli oa lehae kapa ea hole. E na le tharollo e felletseng ea turnkey e nang le sistimi e sireletsehileng ea ts'ebetso e sebetsang molokong oa morao-rao oa li-microcontrollers tse sireletsehileng.
STSAFE-A110 e ka kopanngoa le lisebelisoa tsa IoT (Inthaneteng ea lintho), smart-home, smart-city le industrial applications, lisebelisoa tsa elektronike tsa bareki, lisebelisoa le lisebelisoa. Likarolo tsa eona tsa bohlokoa ke:
·
Netefatso (ea li-peripherals, IoT le lisebelisoa tsa USB Type-C®)
·
Sireletsehile ho theha mocha o nang le moamoheli oa hole ho kenyeletsoa ho ts'oarana ka letsoho ka har'a transport layer security (TLS).
·
Ts'ebeletso ea netefatso ea ho tekenoa (sireletsehile bootle le ntlafatso ea firmware)
·
Tlhokomelo ea tšebeliso e nang le li-counters tse sireletsehileng
·
Ho kopanya le ho sireletsa kanale e nang le processor ea app e amohelang
·
Ho phuthela le ho phutholla lienfelopo tsa lehae kapa tse hole
·
Ho hlahisa li-key pair tsa on-chip
Sheba database ea STSAFE-A110 e fumanehang ho STSAFE-A110 web leqepheng la bakeng sa tlhahisoleseding e eketsehileng ka sesebediswa.
UM2646 - Tšen 4
leqepheng la 3/23
UM2646
STSAFE-A1xx tlhaloso ea mahareng
3
STSAFE-A1xx tlhaloso ea mahareng
Karolo ena e fana ka lintlha tsa STSAFE-A1xx middleware software package content le mokhoa oa ho e sebelisa.
3.1
Tlhaloso e akaretsang
STSAFE-A1xx middleware ke sete ea likarolo tsa software tse etselitsoeng ho:
·
sehokela sesebelisoa sa STSAFE-A110 se sireletsehileng se nang le MCU
·
kenya ts'ebeliso ea linyeoe tsa ts'ebeliso ea STSAFE-A110 ka ho fetesisa
STSAFE-A1xx middleware e kenyelelitsoe ka botlalo ka har'a liphutheloana tsa software tsa ST e le karolo ea middleware ho eketsa likarolo tse sireletsehileng tsa lintho (bakeng sa ex.ample X-CUBE-SBSFU kapa X-CUBE-SAFEA1).
E ka khoasolloa ho tsoa leqepheng la marang-rang la STSAFE-A110 ka har'a Tools & Software tab kapa e ka khoasolloa ho tsoa ho STM32CubeMX.
Software e fanoa e le khoutu ea mohloli tlas'a tumellano ea laesense ea ST software (SLA0088) (sheba lintlha tsa laesense bakeng sa lintlha tse ling).
Maemo a latelang a ntlafatso a kopaneng a tšehetsoa:
·
IAR Embedded Workbench® for Arm® (EWARM)
·
Keil® Microcontroller Development Kit (MDK-ARM)
·
STM32Cube IDE (STM32CubeIDE)
·
System Workbench ea STM32 (SW4STM32) e tšehelitsoeng ka har'a sephutheloana sa X-CUBE-SAFEA1 v1.2.1 feela
Sheba lintlha tsa tokollo tse fumanehang foldareng ea metso ea sephutheloana bakeng sa tlhahisoleseling mabapi le mefuta ea IDE e tšehetsoeng.
3.2
Meaho
Karolo ena e hlalosa likarolo tsa software tsa STSAFE-A1xx middleware software package.
Setšoantšo se ka tlase se hlahisa a view ea meralo ea STSAFE-A1xx middleware le lihokelo tse amanang.
Setšoantšo sa 1. STSAFE-A1xx mehaho
STSAFE-A1xx API (sehokelo sa mantlha)
MOHLOMI
CRYPTO
MbedTM TLS
Sehokelo sa litšebeletso tsa Cryptographic SHA/AES
TŠEBELETSO
Sebaka se ka thoko
E loketse ts'ireletso ka likarolo tsa ts'ireletso tsa MCU
(MPU, Firewall, TrustZone®, joalo-joalo)
Sehokelo sa tšebeletso ea Hardware
X-CUBECRYPTOLIB
UM2646 - Tšen 4
leqepheng la 4/23
Hlokomela:
UM2646
STSAFE-A1xx tlhaloso ea mahareng
Middleware e na le li-interfaces tse tharo tse fapaneng:
·
STSAFE-A1xx API: Ke sehokelo sa mantlha sa mananeo a kopo (API), se fanang ka phihlello e felletseng ho bohle.
lits'ebeletso tsa STSAFE-A110 tse romelloang kantle ho maemo a holimo (ts'ebeliso, lilaeborari le mekotla). Sehokelo sena ke
e boetse e bitsoa sebopeho sa mantlha hobane li-API tsohle tse romelloang kantle li kengoa tšebetsong mojuleng oa CORE.
Likarolo tse kaholimo tse hlokang ho kopanya STSAFE-A1xx middleware li tlameha ho fihlella STSAFE-A110
likarolo ka sebopeho sena.
·
Sebopeho sa tšebeletso ea hardware: Sebopeho sena se sebelisoa ke STSAFE-A1xx middleware ho fihla holimo
boikemelo sethaleng sa hardware. E kenyelletsa sehlopha sa mesebetsi e akaretsang ho hokela MCU e itseng, bese ea IO
le mesebetsi ea nako. Sebopeho sena se ntlafatsa ts'ebeliso ea khoutu ea laebrari hape e tiisa hore ho bonolo ho e sebelisa
lisebelisoa tse ling.
E hlalosoa e le mesebetsi e fokolang, mesebetsi ena e akaretsang e tlameha ho kengoa tšebetsong boemong ba kopo ho latela mohlalaampe fanoeng ka har'a stsafea_service_interface_template.c e fanoeng bakeng sa ho kopanya habonolo
le ho iketsetsa ka har'a lihlopha tse ka holimo.
·
Sehokelo sa litšebeletso tsa Cryptographic: Sehokelo sena se sebelisoa ke STSAFE-A1xx middleware ho fihlella
sethaleng kapa laeborari mesebetsi ea cryptographic joalo ka SHA (secure hash algorithm) le AES (e tsoetseng pele
encryption standard) e hlokoang ke middleware bakeng sa lipontšo tse ling.
E hlalosoa e le mesebetsi e fokolang, mesebetsi ena ea cryptographic e tlameha ho kenngoa ts'ebetsong boemong ba kopo
ho latela exampe fana ka li-template tse peli tse fapaneng:
stsafea_crypto_mbedtls_interface_template.c haeba ho sebelisoa laeborari ea litšoantšo ea Arm® MbedTM TLS; stsafea_crypto_stlib_interface_template.c haeba ho sebelisoa laeborari ea ST cryptographic;
·
Lilaebrari tse ling tsa li-cryptographic li ka sebelisoa ka ho iketsetsa mohloli oa template files. The
template files li fanoa bakeng sa ho kopanya habonolo le ho iketsetsa ka har'a lihlopha tse ka holimo.
Arm le Mbed ke matshwao a kgwebo a ngodisitsweng kapa matshwao a kgwebo a Arm Limited (kapa makalana a yona) ho la US le/kapa kae kapa kae.
UM2646 - Tšen 4
leqepheng la 5/23
UM2646
STSAFE-A1xx tlhaloso ea mahareng
Setšoantšo se ka tlase se bonts'a STSAFE-A1xx middleware e kenyellelitsoeng ts'ebelisong e tloaelehileng ea STM32Cube, e sebetsang holim'a boto ea katoloso ea X-NUCLEO-SAFEA1 e behiloeng holim'a boto ea STM32 Nucleo.
Setšoantšo sa 2. Setšoantšo sa STSAFE-A1xx thibela kopo
STSAFE-A1xx middleware ho sesebelisoa sa STM32Cube
X-CUBE-SAFEA1 Setšoantšo sa block bakeng sa STM32CubeMX
Ho fana ka lisebelisoa tse ntle ka ho fetisisa le boikemelo ba sethala, STSAFE-A1xx middleware ha e hokahane ka kotloloho le STM32Cube HAL, empa ka sehokelo. filee kenngwa tshebetsong boemong ba kopo (stsafea_service_interface_template.c, stsafea_interface_conf.h).
UM2646 - Tšen 4
leqepheng la 6/23
UM2646
STSAFE-A1xx tlhaloso ea mahareng
3.3
CORE module
Mojule oa CORE ke motheo oa lisebelisoa tse bohareng. E sebelisa litaelo tse bitsitsoeng ke likarolo tse kaholimo (ts'ebeliso, lilaeborari, stack joalo-joalo) molemong oa ho sebelisa likarolo tsa STSAFE-A1xx hantle.
Setšoantšo se ka tlase se hlahisa a view ea meralo ea mojule oa CORE.
Setšoantšo sa 3. Mehaho ea module ea CORE
Likarolo tse kaholimo tsa kantle (ts'ebeliso, lilaeborari, mekotla, jj.)
MOHLOMI
Mojule oa ka hare oa CRYPTO
TŠEBELETSO ea ka hare ea module
Mojule oa CORE ke karolo ea software ea li-interface tse ngata e hokahaneng le:
·
Likarolo tse ka holimo: khokahanyo ea kantle ka li-API tse romelloang kantle ho naha tse hlalositsoeng litafoleng tse peli tse ka tlase;
·
Cryptographic layer: khokahano ea ka hare ho module ea CRYPTO;
·
Lera la tšebeletso ea lisebelisoa: khokahanyo ea ka hare ho module ea SERVICE;
Sephutheloana sa software sa STSAFE-A1xx middleware se fana ka litokomane tse felletseng tsa API tsa module ea CORE foldareng ea metso (sheba STSAFE-A1xx_Middleware.chm file).
Sheba database ea STSAFE-A110 bakeng sa tlhaloso e khutšoanyane ea taelo e behiloeng, eo litaelo tsa API tse thathamisitsoeng tafoleng e latelang li amanang le tsona.
API tlhophiso ea ho qala
Litaelo tse akaretsang
Litaelo tsa karohano ea data
Lethathamo la 1. CORE module e romelloang kantle ho naha API
Mosebetsi StSafeA_Init Ho theha, ho qala le ho abela setshwaro sa sesebelisoa sa STSAFE-A1xx. StSafeA_GetVersion Ho khutlisetsa ntlafatso ea STSAFE-A1xx middleware. StSafeA_Echo Ho amohela data e fetisitsoeng ka taelo. StSafeA_Reset Ho tsosolosa litšoaneleho tse feto-fetohang ho boleng ba tsona ba pele. StSafeA_GenerateRandom Ho hlahisa palo ea li-byte tse sa reroang. StSafeA_Hibernate Ho kenya sesebelisoa sa STSAFE-Axxx hibernation. StSafeA_DataPartitionQuery
UM2646 - Tšen 4
leqepheng la 7/23
UM2646
STSAFE-A1xx tlhaloso ea mahareng
Sehlopha sa API
Taelo ea Function Query ho fumana tlhophiso ea karohano ea data.
StSafeA_Decrement Ho fokotsa k'haontareng ea tsela e le 'ngoe sebakeng sa khaonta.
Litaelo tsa karohano ea data
StSafeA_Read Ho bala lintlha tse tsoang sebakeng sa karohano ea data.
StSafeA_Update Ho nchafatsa lintlha ka ho arola libaka.
StSafeA_GenerateSignature Ho kgutlisetsa tshaeno ya ECDSA hodima tshilo ya molaetsa.
Litaelo tsa bohlokoa tsa lekunutu le tsa sechaba
StSafeA_GenerateKeyPair Ho hlahisa li-key-pair sebakeng sa senotlolo sa poraefete.
StSafeA_VerifyMessageSignature Ho netefatsa bonnete ba molaetsa.
StSafeA_EstablishKey Ho theha sephiri se arolelanoang pakeng tsa mabotho a mabeli ka ho sebelisa asymmetric cryptography.
StSafeA_ProductDataQuery Query taelo ea ho fumana lintlha tsa sehlahisoa.
StSafeA_I2cParameterQuery Query taelo ea ho khutlisa aterese ea I²C le litlhophiso tsa mokhoa oa matla a tlase.
StSafeA_LifeCycleStateQuery Query e laela ho khutlisa boemo ba bophelo (Ho Tsoaloa, ho sebetsa, ho felisitsoe, ho tsoaloa le ho notlelloa kapa ho sebetsa ebile ho notletsoe).
Litaelo tsa tsamaiso
StSafeA_HostKeySlotQuery Query taelo ea ho fumana lintlha tsa bohlokoa tsa moamoheli (boteng le k'haonte ea C-MAC e amohelang).
StSafeA_PutAttribute Ho kenya litšoaneleho sesebelisoa sa STSAFE-Axxx, joalo ka linotlolo, password, liparamente tsa I²C ho latela sebopeho. TAG.
StSafeA_DeletePassword Ho hlakola phasewete ho slot ea eona.
StSafeA_VerifyPassword Ho netefatsa phasewete le ho hopola sephetho sa netefatso bakeng sa tumello ea taelo ea nako e tlang.
StSafeA_RawCommand Ho phethahatsa taelo e tala le ho fumana karabo e amanang le eona.
StSafeA_LocalEnvelopeKeySlotQuery Query taelo ea ho khutlisa lintlha tsa bohlokoa tsa enfelopo ea lehae (nomoro ea slot, boteng le bolelele ba linotlolo) bakeng sa linotlolo tse fumanehang.
Litaelo tsa enfelopo ea lehae
StSafeA_GenerateLocalEnvelopeKey Ho hlahisa senotlolo sebakeng sa senotlolo sa enfelopo ea lehae.
StSafeA_WrapLocalEnvelope Ho phuthela data (hangata linotlolo) tse laoloang ka botlalo ke moamoheli, ka senotlolo sa sebaka sa enfelopo le [AES key wrap] algorithm.
StSafeA_UnwrapLocalEnvelope Ho manolla enfelopo ea lehae ka senotlolo sa sebakeng seo.
UM2646 - Tšen 4
leqepheng la 8/23
UM2646
STSAFE-A1xx tlhaloso ea mahareng
Sehlopha sa API
Taelo ea tumello ea taelo ea tlhophiso
Letlapa la 2. Li-API tsa module tsa STSAFE-A110 CORE tse romelloang kantle
Ts'ebetso ea StSafeA_CommandAuthorizationConfigurationQuery Taelo ea ho khutlisa maemo a phihlello bakeng sa litaelo tse nang le maemo a ka hlophisehang a phihlello.
3.4
TŠEBELETSO mojule
Mojule oa SERVICE ke karolo e tlase ea lisebelisoa tse bohareng. E sebelisa ts'ebetso e felletseng ea lisebelisoa ho latela MCU le sethala sa Hardware.
Setšoantšo se ka tlase se hlahisa a view ea meralo ea mojule oa TŠEBELETSO.
Setšoantšo sa 4. Sebopeho sa mojule oa TŠEBELETSO
CORE mojule oa ka hare
TŠEBELETSO
Mekhahlelo e ka tlase ea kantle (BSP, HAL, LL, joalo-joalo)
Mojule oa SERVICE ke karolo ea software ea li-dual-interface e hoketsoeng ho:
·
Mekhahlelo ea kantle e ka tlase: joalo ka BSP, HAL kapa LL. Mesebetsi e fokolang e tlameha ho kengoa ts'ebetsong maemong a holimo
layers 'me li thehiloe ho thempleite ea stsafea_service_interface_template.c file;
·
Core layer: khokahano ea ka hare ho module ea CORE ka li-API tse romelloang kantle tse hlalositsoeng tafoleng
ka tlase;
Sephutheloana sa software sa STSAFE-A1xx middleware se fana ka litokomane tse felletseng tsa API tsa module ea SERVICE ka har'a foldara ea metso (sheba STSAFE-A1xx_Middleware.chm file).
Lethathamo la 3. Mojule oa TŠEBELETSO o rometsoeng ka ntle ho li-API
API tlhophiso ea ho qala
Mesebetsi ea ts'ebetso ea boemo bo tlaase
Mosebetsi
StSafeA_BSP_Init Ho qala bese ea puisano le li-pin tsa IO tse hlokahalang ho sebelisa sesebelisoa sa STSAFE-Axxx.
StSafeA_Transmit Ho lokisa taelo e tla fetisoa, 'me u letsetse API ea libese ea boemo bo tlase hore e phethoe. Kopanya le ho kopanya CRC, haeba e tšehetsoa.
StSafeA_Receive Ho fumana data ho tsoa ho STSAFE-Axxx ka ho sebelisa lits'ebetso tse tlase tsa libese ho li lata.Hlahloba CRC, haeba e tšehetsoa.
UM2646 - Tšen 4
leqepheng la 9/23
UM2646
STSAFE-A1xx tlhaloso ea mahareng
3.5
Setšoantšo sa CRYPTO
Mojule oa CRYPTO o emela karolo ea "cryptographic" ea "middleware". E tlameha ho itšetleha ka lisebelisoa tsa sethala tsa cryptographic.
Mojule oa CRYPTO o ikemetse ka ho feletseng ho li-module tse ling tsa middleware 'me, ka lebaka lena, o ka kenngoa habonolo ka har'a sebaka se ka thōko se sireletsehileng se loketseng ho sireletsoa ke likarolo tsa ts'ireletso tsa MCU tse kang unit protection unit (MPU), firewall kapa TrustZone®.
Setšoantšo se ka tlase se hlahisa a view ea kaho ea mojule oa CRYPTO.
Setšoantšo sa 5. Mehaho ea module ea CRYPTO
CORE mojule oa ka hare
CRYPTO
Mekhahlelo ea kantle ea li-cryptographic
(MbedTM TLS, X-CUBE-CRYPTOLIB)
Mojule oa CRYPTO ke karolo ea software ea li-interface tse peli e hokahantsoeng le:
·
laeborari ea kantle ea mongolo o sirelelitsoeng: Mbed TLS le X-CUBE-CRYPTOLIB lia tšehetsoa hajoale. E fokolang
mesebetsi e tlameha ho kengoa maemong a holimo a kantle mme e ipapisitse le:
stsafea_crypto_mbedtls_interface_template.c template file bakeng sa laeborari ea li-cryptographic tsa Mbed TLS;
stsafea_crypto_stlib_interface_template.c template file bakeng sa laeborari ea ST cryptographic;
Lilaebrari tse ling tsa li-cryptographic li ka tšehetsoa habonolo ka ho ikamahanya le sebopeho sa li-cryptographic
template file.
·
karolo ea mantlha: khokahano ea ka hare ho module ea CORE ka li-API tse romelloang kantle tse hlalositsoeng tafoleng
ka tlase;
Sephutheloana sa software sa STSAFE-A1xx middleware se fana ka litokomane tse felletseng tsa API tsa mojule oa CRYPTO foldareng ea metso (sheba STSAFE-A1xx_Middleware.chm file).
Lethathamo la 4. Mojule oa CRYPTO o rometsoe ka ntle ho li-API
Sehlopha sa API
Mosebetsi
StSafeA_ComputeCMAC Ho kopanya boleng ba CMAC. E sebelisoa ka taelo e lokiselitsoeng.
StSafeA_ComputeRMAC Ho kopanya boleng ba RMAC. E sebelisitsoe karabong e fumanoeng.
StSafeA_DataEncryption Cryptographic APIs Ho sebelisa encryption ea data (AES CBC) ho STSAFE-Axxx data buffer.
StSafeA_DataDecryption Ho kenya ts'ebetso ea ho hlakola data (AES CBC) ho STSAFE-Axxx buffer data.
StSafeA_MAC_SHA_PrePostProcess Ho etsa pele kapa ka morao ho sebetsa MAC le/kapa SHA pele e fetisoa, kapa ka mor'a ho amohela data ho tsoa sesebelisoa sa STSAFE_Axxx.
UM2646 - Tšen 4
leqepheng la 10/23
3.6
Hlokomela:
UM2646
STSAFE-A1xx tlhaloso ea mahareng
Lithempleite
Karolo ena e fana ka tlhaloso e qaqileng ea litempele tse fumanehang ka har'a STSAFE-A1xx middleware software package.
Litempele tsohle tse thathamisitsoeng tafoleng e ka tlase li fanoe ka har'a fensetere ea Interface e fumanehang boemong ba motso oa sephutheloana sa software ea middleware.
Setšoantšo files li fanoe joalo ka mohlalaamples ho kopitsoa le customized ka mekhahlelo e ka holimo, e le hore ha bonolo
kopanya le ho lokisa STSAFE-A1xx middleware:
·
Template ea Interface files fana ka mohlalaample ts'ebetsong ea mesebetsi ea __weak, e fanoang e se na letho kapa
mesebetsi e sa sebetseng ka mokhoa o itseng ka har'a middleware. Li tlameha ho kenngoa ts'ebetsong ka nepo sebakeng sa mosebelisi kapa kahare
likarolo tse ka holimo ho latela laebrari ea li-cryptographic le likhetho tsa lisebelisoa tsa mosebelisi.
·
Setšoantšo sa tlhophiso files fana ka mokhoa o bonolo oa ho hlophisa STSAFE-A1xx middleware le likarolo
e ka sebelisoang ts'ebelisong ea mosebelisi, joalo ka optimizations kapa hardware e itseng.
Sehlopha sa template
Lithempleite tsa Interface
Lithempleite tsa tlhophiso
Lethathamo la 5. Lithempleite
Setšoantšo file
stsafea_service_interface_template.c Example template ho bontša mokhoa oa ho tšehetsa litšebeletso tsa hardware tse hlokoang ke STSAFE-A middleware le tse fanoang ke hardware e khethehileng, laebrari ea boemo bo tlaase kapa BSP e khethiloeng sebakeng sa mosebedisi. stsafea_crypto_mbedtls_interface_template.c Example template ho bonts'a mokhoa oa ho ts'ehetsa lits'ebeletso tsa "cryptographic" tse hlokoang ke STSAFE-A middleware mme li fanoa ke laeborari ea li-cryptographic tsa Mbed TLS (key management, SHA, AES, joalo-joalo). stsafea_crypto_stlib_interface_template.c Example template ho bonts'a mokhoa oa ho ts'ehetsa lits'ebeletso tsa sephiri tse hlokoang ke STSAFE-A middleware le tse fanoang ke STM32 cryptographic library library katoloso bakeng sa STM32Cube (XCUBE-CRYPTOLIB) (key management, SHA, AES, joalo-joalo). stsafea_conf_template.h Example template ho bonts'a mokhoa oa ho hlophisa STSAFE-A middleware (haholo-holo molemong oa ho ntlafatsa). stsafea_interface_conf_template.h Example template ho bonts'a mokhoa oa ho hlophisa le ho etsa sebopeho sa sebopeho files tse thathamisitsoeng ka holimo.
Lithempleite tse ka holimo li teng feela foldareng ea BSP ea sephutheloana sa X-CUBE-SAFEA1.
UM2646 - Tšen 4
leqepheng la 11/23
UM2646
STSAFE-A1xx tlhaloso ea mahareng
3.7
Sebopeho sa foldara
Palo e ka tlase e hlahisa sebopeho sa foldara ea STSAFE-A1xx middleware software package v1.2.1.
Setšoantšo sa 6. Morero file sebopeho
Morero file sebopeho STSAFE-A1xx middleware
UM2646 - Tšen 4
Morero file sebopeho sa X-CUBE-SAFEA1 bakeng sa STM32CubeMX
leqepheng la 12/23
3.8
3.8.1
3.8.2
UM2646
STSAFE-A1xx tlhaloso ea mahareng
Mokhoa oa ho: ho kopanya le ho hlophisa
Karolo ena e hlalosa mokhoa oa ho kopanya le ho lokisa STSAFE-A1xx middleware ts'ebelisong ea mosebelisi.
Mehato ea ho kopanya
Latela mehato ena ho kenyelletsa STSAFE-A1xx middleware ts'ebelisong eo u e batlang:
·
Mohato oa 1: Kopitsa ('me ka boikhethelo u rehe bocha) stsafea_service_interface_template.c file le efe kapa efe ea
stsafea_crypto_mbedtls_interface_template.c kapa stsafea_crypto_stlib_interface_template.c ho mosebelisi
sebaka ho latela laebrari ea li-cryptographic e kenyellelitsoeng ts'ebelisong (eng kapa eng
laebrari ea li-cryptographic e khethiloeng / e sebelisoang ke basebelisi, ba ka iketsetsa / ba kenya ts'ebetsong ea bona ea "cryptographic".
segokahanyi file ho tloha qalong ka ho ikamahanya le thempleite e loketseng).
·
Mohato oa 2: Kopitsa ('me ka boikhethelo u rehe bocha) stsafea_conf_template.h le stsafea_interface_conf_template.h
files sebakeng sa mosebedisi.
·
Hata 3: Etsa bonnete ba hore o kenyelletsa se nepahetseng ho kenyelletsa mohloling oa hau oa mantlha kapa o mong oa sebaka sa mosebelisi file seo se hloka ho
sehokela STSAFE-A1xx middleware:
#include “stsafea_core.h” #include “stsafea_interface_conf.h”
·
Mohato oa 4: Customize the files sebelisoa mehatong e meraro e ka holimo ho latela likhetho tsa mosebedisi.
Mehato ea phetolo
Bakeng sa ho hlophisa hantle STSAFE-A1xx middleware ts'ebelisong ea mosebelisi, ST e fana ka tse peli tse fapaneng
template ea tlhophiso filee lokela ho kopitsoa le ho etsoa ka mokhoa o ikhethileng sebakeng sa mosebelisi ho latela khetho ea mosebelisi:
·
stsafea_interface_conf_template.h: Example template e sebelisoa le ho bontša mokhoa oa ho hlophisa
cryptographic le service middleware interfaces sebakeng sa mosebelisi ka tse latelang #define
lipolelo:
USE_PRE_LOADED_HOST_KEYS
MCU_PLATFORM_INCLUDE
MCU_PLATFORM_BUS_INCLUDE
MCU_PLATFORM_CRC_INCLUDE
·
stsafea_conf_template.h: Examptemplate e sebelisoa le ho bonts'a mokhoa oa ho hlophisa STSAFE-A
middleware ka lipolelo tse latelang tsa #define:
STSAFEA_USE_OPTIMIZATION_SHARED_RAM
STSAFEA_USE_OPTIMIZATION_NO_HOST_MAC_ENCRYPT
STSAFEA_USE_FULL_ASERT
USE_SIGNATURE_SESSION (bakeng sa STSAFE-A100 feela)
Latela mehato ena ho kopanya STSAFE-A1xx middleware ts'ebelisong eo u e batlang:
·
Mohato oa 1: Kopitsa ('me ka boikhethelo u rehe bocha) stsafea_interface_conf_template.h le stsafea_conf_template.h
files sebakeng sa mosebedisi.
·
Mohato oa 2: Netefatsa kapa u fetole polelo ea #define ea lihlooho tse peli tse boletsoeng ka holimo files ho latela
sethala sa basebelisi le likhetho tsa cryptographic.
UM2646 - Tšen 4
leqepheng la 13/23
4
4.1
Hlokomela:
4.2
Hlokomela:
UM2646
Software ea lipontšo
Software ea lipontšo
Karolo ena e bonts'a software ea pontšo e thehiloeng ho STSAFE-A1xx middleware.
Netefatso
Pontšo ena e bontša phallo ea taelo moo STSAFE-A110 e kentsoeng sesebelisoa se netefatsang moamoheli o hole (kesi ea sesebelisoa sa IoT), moamoheli oa lehae a sebelisoa joalo ka mokhoa oa ho fetela ho seva e hole. Boemo moo STSAFE-A110 e behiloeng holim'a peripheral e netefatsang moamoheli oa lehae, bakeng sa ex.ample bakeng sa lipapali, lisebelisoa tsa mohala kapa lisebelisoa, li tšoana hantle.
Taelo e phallang Bakeng sa lipontšo, batho ba sebakeng sa heno le ba hole ke lisebelisoa tse tšoanang mona. 1. Ntša, hlahloba, 'me u netefatse setifikeiti sa STSAFE-A110 se bolokiloeng sebakeng sa karolo ea 0 ea sesebelisoa.
e le hore u fumane senotlolo sa sechaba: Bala setifikeiti u sebelisa STSAFE-A1xx middleware through the STSAFE-A110's zone 0. Hlakola setifikeiti u sebelisa parser cryptographic library. Bala setifikeiti sa CA (se fumanehang ka khoutu). Hlakola setifikeiti sa CA u sebelisa sekhechana sa laeborari ea li-cryptographic. Netefatsa bonnete ba setifikeiti ka ho sebelisa setifikeiti sa CA ka laeborari ea li-cryptographic. Fumana senotlolo sa sechaba ho tsoa ho setifikeiti sa STSAFE-A110 X.509. 2. Hlahisa le ho netefatsa tshaeno holim'a nomoro ea phephetso: Hlahisa nomoro ea phephetso (nomoro e sa reroang). Hash phephetso. Fumana tekeno holim'a phephetso e potlakileng u sebelisa senotlolo sa lekunutu sa STSAFE-A110 0 ka
STSAFE-A1xx bohareng. Hlakola tekeno e hlahisitsoeng u sebelisa laebrari ea li-cryptographic. Netefatsa mosaeno o hlahisitsoeng o sebelisa senotlolo sa sechaba sa STSAFE-A110 ka laeborari ea li-cryptographic. Ha sena se nepahetse, moamoheli oa tseba hore peripheral kapa IoT ke ea 'nete.
Ho kopanya
Khoutu ena exampe theha marang-rang pakeng tsa sesebelisoa sa STSAFE-A110 le MCU eo e hokahaneng le eona. Ho kopanya ho lumella phapanyetsano lipakeng tsa sesebelisoa le MCU hore e netefatsoe (ke hore, e saennoe le ho netefatsoa). Sesebelisoa sa STSAFE-A110 se sebetsa feela ha se kopane le MCU eo se pakiloeng ka eona. The pairing e na le MCU ea moamoheli ea romellang senotlolo sa MAC se amohelang le senotlolo sa cipher ho STSAFE-A110. Linotlolo ka bobeli li bolokiloe ho NVM e sirelelitsoeng ea STSAFE-A110 mme e lokela ho bolokoa mohopolong oa flash oa sesebelisoa sa STM32. Ka ho sa feleng, ho mohlala onaample, moamoheli MCU o romela linotlolo tse tsebahalang ho STSAFE-A110 (sheba phallo ea taelo e ka tlase) tse khothalelitsoeng haholo ho li sebelisa molemong oa lipontšo. Khoutu e boetse e lumella ho hlahisa linotlolo tse sa reroang. Ho feta moo, khoutu example hlahisa senotlolo sa enfelopo ea lehae ha sekotjana se tsamaisanang le sona se se se na le batho ba STSAFE-A110. Ha sekotjana sa enfelopo ea lehae se na le batho ba bangata, sesebelisoa sa STSAFE-A110 se lumella motho ea amohelang MCU ho phuthela/ho phutholla enfelopo ea lehae ho boloka senotlolo lehlakoreng la moamoheli oa MCU. The pairing khoutu exampe tlameha ho phethwa ka katleho pele o etsa khoutu e latelang examples.
Phallo ea taelo
1. Hlahisa senotlolo sa hau sa enfelopo ho STSAFE-A110 u sebelisa STSAFE-A1xx middleware. Ka kamehla, taelo ena e kentsoe tšebetsong. Hlokomela hore uncommenting tse latelang hlalosa lipolelo ho pa iring.c file e thibela tlhahiso ea hau ea enfelopo ea lehae: /* #define _FORCE_DEFAULT_FLASH_ */
Ts'ebetso ena e etsahala ha feela sekotjana sa senotlolo sa STSAFE-A110 sa sebakeng sa enfelopo se se se se se na le batho.
UM2646 - Tšen 4
leqepheng la 14/23
UM2646
Software ea lipontšo
2. Hlalosa linomoro tse peli tsa 128-bit tse tla sebelisoa e le senotlolo sa MAC se amohelang le senotlolo sa cipher. Ka tloaelo, ho sebelisoa linotlolo tse tsebahalang tsa khauta. Li na le litekanyetso tse latelang: 0x00,0x11,0x22,0x33,0x44,0x55,0x66,0x77,0x88,0x99,0xAA,0xBB,0xCC,0xDD,0xEE,0xFF / * Host MAC key */ 0x11,0x11,0 22,0x22,0x33,0x33,0x44,0x44,0x55,0x55,0x66,0x66,0x77,0x77,0x88,0x88 / * Senotlolo sa Host cipher */
Ho kenya tshebetsong tlhahiso ya dinotlolo e sa lebellwang, eketsa polelo e hlalosang e latelang ho pairing.c file: #define USE_HOST_KEYS_SET_BY_PAIRING_APP 1
3. Boloka senotlolo sa MAC se amohelang le senotlolo sa cipher ho sekotjana sa bona ho STSAFE-A110. 4. Boloka senotlolo sa MAC se amohelang le senotlolo sa "cipher" mohopolong oa flash oa STM32.
4.3
Theha ea bohlokoa (theha lekunutu)
Pontšo ena e bontša boemo boo sesebelisoa sa STSAFE-A110 se kentsoeng sesebelisoa (joaloka sesebelisoa sa IoT), se buisanang le seva se hole, 'me se hloka ho theha mocha o sireletsehileng oa ho fapanyetsana data le ona.
Ho sena mohlalaample, sesebelisoa sa STM32 se bapala karolo ea seva e hole (moamoheli o hole) le moamoheli oa lehae ea hokahaneng le sesebelisoa sa STSAFE-A110.
Sepheo sa nyeoe ena ea tšebeliso ke ho bontša mokhoa oa ho theha sephiri se arolelanoang pakeng tsa moamoheli oa lehae le seva se hole ho sebelisa sekema sa elliptic curve Diffie-Hellman se nang le senotlolo sa static (ECDH) kapa ephemeral (ECDHE) ho STSAFE-A110.
Lekunutu le arolelanoang le tlameha ho hlahisoa ho linotlolo tse le 'ngoe kapa tse ngata tse sebetsang (tse sa bonts'itsoeng mona). Linotlolo tsena tse sebetsang li ka sebelisoa liprothokholeng tsa puisano tse kang TLS, mohlalaample bakeng sa ho sireletsa lekunutu, botšepehi le bonnete ba lintlha tse fapanyetsanoang lipakeng tsa moamoheli oa lehae le seva e hole.
Phallo ea taelo
Setšoantšo sa 7. Phallo ea taelo ea bohlokoa ea ho theha e bonts'a phallo ea taelo.
·
Linotlolo tsa lekunutu le tsa bohle tsa remoutu li ngotsoe ka thata ho code example.
·
Moamoheli oa lehae o romela taelo ea StSafeA_GenerateKeyPair ho STSAFE-A110 ho hlahisa
key pair ka sekotjana sa eona sa ephemeral (slot 0xFF).
·
STSAFE-A110 e khutlisetsa senotlolo sa sechaba (se lumellanang le slot 0xFF) ho STM32 (e emelang
moamoheli ea hole).
·
STM32 e kopanya lekunutu la moamoheli ea hole (ho sebelisa senotlolo sa sechaba sa sesebelisoa sa STSAFE le remote.
senotlolo sa lekunutu sa moamoheli).
·
STM32 e romela senotlolo sa batho ba hole ho STSAFE-A110 mme e kopa STSAFE-A110 ho
bala lekunutu la moamoheli oa lehae u sebelisa StSafeA_EstablishKey API.
·
STSAFE-A110 e khutlisetsa lekunutu la moamoheli oa lehae ho STM32.
·
STM32 e bapisa liphiri tse peli, 'me e hatisa sephetho. Haeba liphiri li tšoana, sephiri
ho thehwa ho atlehile.
UM2646 - Tšen 4
leqepheng la 15/23
Setšoantšo sa 7. Phallo ea taelo ea mantlha ea ho theha
UM2646
Software ea lipontšo
Moamoheli ea hole
STM32
Moamoheli oa lehae
STSAFE
Ho bala makunutu a motho ea amohelang a le hole (ho sebelisa senotlolo sa lekunutu sa moamoheli ea hole le senotlolo sa batho ba sebakeng sa heno (STSAFE slot 0xFF)
Sephiri sa motho ea hole
Hlahisa Key Pair
Hlahisa Key Pair ho slot 0xFF
Senotlolo sa sechaba sa STSAFE se hlahisitsoe ka
E hlahisitsoe senotlolo sa sechaba sa STSAFE
sekotjana 0xFF
Senotlolo sa bohle sa remote host
STM32 e bapisa lekunutu la moamoheli ea hole le
lekunutu la moamoheli oa lehae mme o hatisa sephetho
Theha Senotlolo (senotlolo sa Host se hole)
Ho romella lekunutu la moamoheli oa lehae
Ho bala makunutu a moamoheli oa lehae (ho sebelisa senotlolo sa lekunutu sa moamoheli oa lehae (STSAFE slot 0xFF) le senotlolo sa batho ba hole.
Sephiri sa moamoheli oa lehae
4.4
Hlokomela:
4.5
Phuthela/ phutholla dienfelopo tsa lehae
Pontšo ena e bonts'a boemo boo STSAFE-A110 e phuthelang/e manollang enfelopo ea lehae e le ho boloka lekunutu la mohopolo ofe kapa ofe o sa fetoheng (NVM). Likonopo tsa encryption/decryption li ka bolokoa ka mokhoa o bolokehileng mohopolong o eketsehileng kapa mohopolong oa data oa mosebelisi oa STSAFEA110. Mokhoa oa ho phuthela o sebelisoa ho sireletsa mongolo oa lekunutu kapa o hlakileng. Sephetho sa ho phuthela ke enfelopo e kentsoeng ka algorithm ea senotlolo sa AES, 'me e na le senotlolo kapa mongolo o hlakileng o lokelang ho sireletsoa.
Phallo ea taelo
Baamoheli ba lehae le ba hole ke lisebelisoa tse tšoanang mona. 1. Hlahisa boitsebiso bo sa reroang bo kentsoeng ka enfelopong ea lehae. 2. Koahela enfelopo ea lehae u sebelisa STSAFE-A110's middleware. 3. Boloka enfelopo e phuthetsoeng. 4. Hlakola enfelopo e phuthetsoeng ka STSAFE-A110's middleware. 5. Bapisa enfelopo e sa phuthoang le enfelopo ea pele ea sebaka seo. Ba lokela ho lekana.
Key pair moloko
Pontšo ena e bontša phallo ea taelo moo sesebelisoa sa STSAFE-A110 se kentsoeng ho moamoheli oa lehae. Moamoheli ea hole o kopa moamoheli enoa oa lehae hore a hlahise li-key pair (senotlolo sa lekunutu le senotlolo sa sechaba) ho slot 1 ebe o saena phephetso (nomoro e sa reroang) ka senotlolo sa lekunutu se hlahisitsoeng.
Motho ea amohelang remoutu o khona ho netefatsa tshaeno ka senotlolo sa sechaba se hlahisitsoeng.
Pontšo ena e tšoana le pontšo ea Tiiso e nang le liphapang tse peli:
·
The pair ea bohlokoa ponts'ong ea netefatso e se e entsoe (ho slot 0), athe, ho ex ena.ample,
re hlahisa li-key pair ho slot 1. Sesebelisoa sa STSAFE-A110 se ka boela sa hlahisa para ea bohlokoa ho slot 0xFF,
empa feela bakeng sa merero ea mantlha ea ho theha.
·
Senotlolo sa setjhaba pontshong ya Netefatso e ntshitswe ho setifikeiti sebakeng sa 0. Ho sena
example, senotlolo sa sechaba se khutlisetsoa morao ka karabelo ea STSAFE-A110 ho
StSafeA_GenerateKeyPair taelo.
UM2646 - Tšen 4
leqepheng la 16/23
UM2646
Software ea lipontšo
Hlokomela:
Phallo ea taelo
Bakeng sa lipontšo, batho ba haufi le ba hole le ba bang ke lisebelisoa tse tšoanang mona. 1. Moamoheli o romela taelo ea StSafeA_GenerateKeyPair ho STSAFE-A110, e khutlisetsang
senotlolo sa sechaba ho MCU ea amohelang. 2. Moamoheli o hlahisa phephetso (48-byte random number) a sebelisa StSafeA_GenerateRandom API. The
STSAFE-A110 e khutlisetsa nomoro e hlahisitsoeng e sa reroang. 3. Moamoheli o bala hash ea nomoro e hlahisitsoeng a sebelisa laebrari ea li-cryptographic. 4. Moamoheli o kopa STSAFE-A110 ho etsa tekeno ea hash e entsoeng ka komporo
StSafeA_GenerateSignature API. STSAFE-A110 e khutlisetsa tekeno e entsoeng.
5. Moamoheli o netefatsa signature e hlahisitsoeng ka senotlolo sa sechaba se rometsoeng ke STSAFE-A110 mohatong oa 1. 6. Sephetho sa netefatso ea tekeno se hatisitsoe.
UM2646 - Tšen 4
leqepheng la 17/23
UM2646
Nalane ea ntlafatso
Lethathamo la 6. Histori ea ntlafatso ea litokomane
Letsatsi
Khatiso
Liphetoho
09-Dec-2019
1
Tokollo ea pele.
13-Jan-2020
2
E tlositsoe karolong ea lintlha tsa laesense.
Lethathamo le ntlafalitsoeng la likarolo tse bonts'itsoeng ka likhoutu tsa pontšo ho Selelekela. Ho tlositsoe Lethathamo la li-acronyms tafole le pokello ea mantsoe e kentsoeng qetellong.
Liphetoho tse nyane tsa mongolo le mebala e ntlafalitsoeng ho Setšoantšo sa 1. STSAFE-A1xx meralo.
Setšoantšo se ntlafalitsoeng sa 2. STSAFE-A1xx Setšoantšo sa thibelo ea kopo.
Lethathamo le ntlafalitsoeng la 1. CORE module e romelloang kantle ho naha API.
07-Feb-2022
3
E tlositsoe StSafeA_InitHASH le StSafeA_ComputeHASH ho Lethathamo la 4. Mojule oa CRYPTO o rometsoe ka ntle ho API.
E ntlafalitsoe Karolo ea 3.8.2: Mehato ea tlhophiso.
E ntlafalitsoe Karolo ea 4.2: Ho kopanya.
E ntlafalitsoe Karolo ea 4.3: Theha ea bohlokoa (theha lekunutu).
E Ekelitsoe Karolo ea 4.5: Ho hlahisa li-key pair.
Mongolo o monyane oa fetoha.
Sephutheloana sa software sa STSAFE-A1xx se kenyelelitsoe ho X-CUBE-SAFEA1 v1.2.1 e le middleware
'me e kopantsoe e le BSP bakeng sa pakete ea software bakeng sa STM32CubeMX. le Thempleite tse ka holimo
07-Mar-2024
4
li fumaneha feela foldareng ea BSP ea sephutheloana sa X-CUBE-SAFEA1.
E ntlafalitsoe Karolo ea 3.1: Tlhaloso e akaretsang, Karolo ea 3.2: Mehaho le Karolo ea 3.7: Sebopeho sa lifoldara.
UM2646 - Tšen 4
leqepheng la 18/23
Bukana ea mantsoe
AES Advanced encryption standard ANSI American National Standards Institute API application programming interface BSP Board sephutheloana CA Certification Authority CC Common Criteria C-MAC Command molaetsa khoutu ea netefatso ECC Elliptic curve cryptography ECDH Elliptic curve DiffieHellman ECDHE Elliptic curve DiffieHellman – ephemeral Work EWARM Arm® HAL Hardware abstraction layer I/O Input/output IAR Systems® Moetapele oa Lefatše oa lisebelisoa tsa software le lits'ebeletso bakeng sa nts'etsopele ea litsamaiso tse kenelletseng. IDE Tikoloho ea ntlafatso e kopaneng. Sesebelisoa sa software se fanang ka lisebelisoa tse felletseng ho baetsi ba mananeo a komporo bakeng sa nts'etsopele ea software. IoT Internet of things I²C Inter-integrated circuit (IIC) LL Bakhanni ba boemo bo tlase ba MAC Khouto ya netefatso ya Molaetsa MCU Microcontroller unit MDK-ARM Keil® microcontroller kit ya ntshetsopele ya Arm® MPU Memory protection unit NVM Nonvolatile memory
OS Sisteme ea ts'ebetso SE Secure element SHA Secure Hash algorithm SLA Software laesense agreement ST STMicroelectronics TLS Transport lera tshireletso USB Universal serial bus
UM2646
Bukana ea mantsoe
UM2646 - Tšen 4
leqepheng la 19/23
UM2646
Litaba
Litaba
1 Boitsebiso bo akaretsang . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 2 STSAFE-A110 ntho e sireletsehileng. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 3 STSAFE-A1xx middleware tlhaloso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3.1 Tlhaloso e akaretsang. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 3.2 Boqapi ba meralo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 3.3 Mojule oa CORE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 3.4 mojule oa TŠEBELETSO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 3.5 Mojule oa CRYPTO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 3.6 Dithempleite. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 3.7 Sebopeho sa foldara . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 3.8 Mokhoa oa ho: ho kopanya le ho hlophisa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
3.8.1 Mehato ea ho kopanya . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 3.8.2 Mehato ea tlhophiso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
4 Pontšo ea software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14 4.1 Netefatso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 4.2 Ho kopanya . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 4.3 Theha ya bohlokwa (theha sephiri) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 4.4 Phuthela/ phutholla dienfelopo tsa lehae . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 4.5 Ho hlahisa batho ka bobeli. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Nalane ea ntlafatso. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18 Lenane la litafole . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21 Lenane la lipalo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
UM2646 - Tšen 4
leqepheng la 20/23
UM2646
Lethathamo la litafole
Lethathamo la litafole
Letlapa la 1. Letlapa la 2. Lethathamo la 3. Lethathamo la 4. Lethathamo la 5. Lethathamo la 6.
CORE module e rometsoeng API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 E rometsoe kantle ho naha ea STSAFE-A110 CORE module APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 SERVICE module e romelloang kantle ho naha ea API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 CRYPTO module e romelloang kantle ho naha API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Dithempleite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Histori ea ntlafatso ea litokomane. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
UM2646 - Tšen 4
leqepheng la 21/23
UM2646
Lenane la lipalo
Lenane la lipalo
Setšoantšo sa 1. Setšoantšo sa 2. Setšoantšo sa 3. Setšoantšo sa 4. Setšoantšo sa 5. Setšoantšo sa 6. Setšoantšo sa 7.
STSAFE-A1xx ea meralo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Setšoantšo sa block block sa STSAFE-A1xx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 CORE module ea meralo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 TŠEBELETSO ea mohaho oa module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 CRYPTO meralo ea mojule. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Morero file sebopeho . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Keletso ea bohlokoa ea ho theha taelo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
UM2646 - Tšen 4
leqepheng la 22/23
UM2646
TSEBISO EA BOHLOKOA BALA KA HLOKO STMicroelectronics NV le litšehetso tsa eona ("ST") li na le tokelo ea ho etsa liphetoho, litokiso, lintlafatso, lintlafatso, le lintlafatso ho lihlahisoa tsa ST le/kapa tokomaneng ena ka nako efe kapa efe ntle le tsebiso. Bareki ba lokela ho fumana lintlha tsa morao-rao tse amanang le lihlahisoa tsa ST pele ba fana ka litaelo. Lihlahisoa tsa ST li rekisoa ho latela lipehelo le maemo a thekiso ea ST ka nako ea tumello ea taelo. Bareki ke bona feela ba ikarabellang bakeng sa khetho, khetho, le tšebeliso ea lihlahisoa tsa ST mme ST ha e nke e le molato bakeng sa thuso ea kopo kapa moralo oa lihlahisoa tsa bareki. Ha ho laesense, e hlalositsoeng kapa e boletsoeng, ea tokelo efe kapa efe ea thepa ea mahlale e fanoeng ke ST mona. Ho rekisoa ha lihlahisoa tsa ST ka litokisetso tse fapaneng le tlhahisoleseding e boletsoeng mona ho tla hlakola waranti leha e le efe e fanoeng ke ST bakeng sa sehlahisoa se joalo. ST le logo ea ST ke matšoao a khoebo a ST. Bakeng sa lintlha tse ling mabapi le matšoao a ST, sheba ho www.st.com/trademarks. Mabitso a mang kaofela a lihlahisoa kapa litšebeletso ke thepa ea beng ba tsona. Lintlha tse tokomaneng ena li nkela sebaka le ho nkela tlhahisoleseding e neng e fanoe pele liphetolelong tsa pele tsa tokomane ena.
© 2024 STMicroelectronics Litokelo tsohle li sirelelitsoe
UM2646 - Tšen 4
leqepheng la 23/23
Litokomane / Lisebelisoa
 |
STMicroelectronics X-CUBE-SAFEA1 Software Package [pdf] Bukana ea Mosebelisi STSAFE-A100, STSAFE-A110, X-CUBE-SAFEA1 Software Package, X-CUBE-SAFEA1, Software Package, Package |
