STM32MPx Series Signing Tool Software Manual User

Example 1: Fifantenana sy famoahana algorithm default file famoronana.
Example 2: Fanasoniavana binary file miaraka amin'ny lohapejy 2 sy fanalahidin'ny daholobe maro.

Fomba tokana:
Rehefa mampiasa STM32MP-SignTool amin'ny fomba mitokana dia araho ireto dingana ireto:

Ampidiro aloha ny lalana tanteraka.
Omeo ny fampahalalana ilaina toy ny fifantenana algorithm, ny dikan-tsary, ny fidirana ary ny adiresy entana.

Fanontaniana matetika (FAQ)

Ahoana no hanamarinana ny Output sary file?
Azonao atao ny manamarina ny sary vokarina amin'ny alàlan'ny fanaparitahana ny vokatra file ary manamarina ny saha lohapejy tsirairay. Ampiasao ny baiko: ./STM32MP_SigningTool_CLI.exe -dump /home/user/output.stm32
Inona no maha samy hafa ny dikan-teny ho an'ny sonia?
Ny dikan-lohateny dia mamaritra ny isan'ny fanalahidin'ny daholobe ilaina amin'ny fanamarinana. Ho an'ny exampNy lohatenin'ny lohapejy 1 dia mitaky lalana manan-danja iray ho an'ny vokatra STM32MP15xx, raha ny dikan-teny 2 sy lehibe kokoa kosa dia mila lalana manan-danja valo ho an'ny hafa.

Sava lalana

Ny rindrambaiko fitaovana sonia andiany STM32MPx (antsoina hoe STM32MP-SignTool ato amin'ity antontan-taratasy ity) dia tafiditra ao amin'ny STM32CubeProgrammer (STM32CubeProg).
STM32MP-SignTool dia fitaovana manan-danja izay miantoka sehatra azo antoka ary miantoka ny fanasoniavana sary mimari-droa amin'ny alàlan'ny fanalahidin'ny ECC novokarin'ny rindrambaiko STM32MP-KeyGen (jereo ny torolàlana mpampiasa STM32MPx andian-dahatsoratra momba ny rindrambaiko mpamokatra fanalahidy (UM2542) raha mila fanazavana fanampiny).

Ireo sary mimari-droa nosoniavina dia ampiasaina mandritra ny andiany STM32MPx MPU azo antoka ny filaharana boot izay manohana rojo baoty azo itokisana. Ity hetsika ity dia miantoka ny fanamarinana sy ny fahamendrehan'ny sary voarakitra.
STM32MP-SignTool dia mamorona sary mimari-droa file, fanalahidin'ny daholobe file, ary fanalahidy manokana file.

Ny sary binary file mirakitra ny angon-drakitra mimari-droa hoprograma ho an'ny fitaovana.
Ny fanalahidin'ny daholobe file misy ny fanalahidin'ny daholobe ECC amin'ny endrika PEM, novokarina tamin'ny STM32MP-KeyGen.

Ny fanalahidy manokana file mirakitra ny fanalahidy manokana ECC voafono amin'ny endrika PEM, novokarina tamin'ny STM32MP-KeyGen.
Binary voasonia file azo vokarina avy amin'ny efa nosoniavina ihany koa file miaraka amin'ny batch file fomba. Amin'ity tranga ity dia tsy voatery ireto mari-pamantarana manaraka ireto: ny toerana idirana sary, ny adiresin'ny entana ary ny mari-pamantarana dikan-tsary.

Ampidiro ny STM32MP-SignTool

Ity fitaovana ity dia napetraka miaraka amin'ny fonosana STM32CubeProgrammer (STM32CubeProg). Raha mila fanazavana fanampiny momba ny fomba fanamboarana dia jereo ny fizarana 1.2 amin'ny boky torolalana ho an'ny mpampiasa STM32CubeProgrammer famaritana rindrambaiko (UM2237).
Ity rindrambaiko ity dia mihatra amin'ny MPU miorina amin'ny Arm® andiany STM32MPx.
Fanamarihana: Arm dia marika voasoratra anarana ao amin'ny Arm Limited (na ny sampany) any Etazonia sy/na any an-kafa.

Ireo singa mifandraika amin'ny STM32MP-SignTool

Ireto fizarana manaraka ireto dia mamaritra ny fomba fampiasana STM32MP-SignTool avy amin'ny baiko baiko.

didy
Ny baiko misy dia voatanisa eto ambany:

–sary binary(-bin), –input(-in)
- Famaritana: sary binary file lalana (.bin extension)
- Syntax: 1 -bin /home/User/binaryFile.bin
- Syntaxe :2 -in /home/User/binaryFile.bin
-sary-version (-iv)
- Famaritana: miditra amin'ny dikan-tsary amin'ny sary voasonia file
- Syntax: -iv
-fanalahidy manokana (-prvk)
- Famaritana: fanalahidy manokana file lalana (.pem extension)
- Syntax: -prvkfile_lalana>
- Example: -prvk ../privateKey.pem
–public-key -pubk
- Famaritana: fanalahidin'ny daholobe file lalana
- Syntax: -pubkFile_Lalana{1..8}>
  - Ho an'ny lohapejy v1: mampiasa lalana manan-danja iray fotsiny ho an'ny vokatra STM32MP15xx
  - Ho an'ny lohapejy v2 sy lehibe kokoa: ampiasao lalana manan-danja valo ho an'ny hafa
- tenimiafina (-pwd)
- Famaritana: tenimiafina an'ny fanalahidy manokana (tsy maintsy misy tarehintsoratra efatra farafahakeliny io tenimiafina io)
- Example: -pwd azerty
-adiresy entana (-la)
- Famaritana: adiresy entana sary
- Example: -la
– teboka fidirana (-ep)
- Famaritana: teboka fidirana sary
- Example: -ep
-safidy-faneva (-ny)
- Famaritana: saina safidin'ny sary (value default = 0)
- Example: -ny
- algorithm (-a)
- Famaritana: mamaritra ny iray amin'ny prime256v1 (sanda 1, default) na brainpoolP256t1 (sanda 2)
- Example: -a <2>
- vokatra (-o)
- Famaritana: vokatra file lalana. Tsy voatery io paramètre io. Raha tsy voalaza, ny vokatra file dia novokarina tamin'ny loharano iray ihany file lalana (ohatraample, ny sary mimari-droa file dia C:\BinaryFile.bin). Ny binary sonia file dia C:\BinaryFile_Signed.bin.
- Syntax: -oFile_Lalana>
-karazana (-t)
- Famaritana: karazana binary. Ny sanda azo atao dia ssbl, fsbl, teeh, teed, teex ary copro
- Syntax: -t
– mangina (-s)
Famaritana: tsy misy hafatra naseho hanoloana vokatra efa misy file
–fanampiana (-h sy -?)
Famaritana: mampiseho fanampiana

-version (-v)
Famaritana: mampiseho ny dikan-fitaovana
–enc-dc (-encdc)
- Famaritana: encryption derivation constant for FSBL encryption [header v2]
- Syntax: -encdc
-enc-key (-enck)
- Famaritana: OEM secret file ho an'ny fanafenana FSBL [header v2]
- Syntax: -enck
– lohatenin'ny fanariam-pako (–fary)
- Famaritana: parse sy manary lohapejy sary
- Syntax: - manaryFile_Lalana>
–header-version (-hv)
- Famaritana: dikan-teny sonia, sanda azo atao: 1, 2, 2.1, 2.2
- Example ho an'ny STM32MP15: -hv 2
- Example ho an'ny STM32MP25: -hv 2.2
-tsy misy fanalahidy (-nk)
- Famaritana: manampy lohapejy foana tsy misy safidy fototra
- Fanamarihana: mila manafoana ny safidy fanamarinana miaraka amin'ny baiko Option flags.

ExampIreo singa mifandraika amin'ny STM32MP-SignTool
Ny manaraka exampAsehoy ny fomba fampiasana STM32MP-SignTool:

Example 1

Ny algorithm default (prime256v1) dia voafantina ary ny sandan'ny sainam-pirenena dia 0 (sarobidy default). Ny binary nivoaka sonia file (BinaryFile_Signed.bin) dia noforonina ao amin'ny lahatahiry /home/user/
Example 2
Ny algorithm BrainpoolP256t1 dia voafantina amin'ity tranga ity. Na dia tsy misy aza ny Folder2 sy Folder3 dia noforonina izy ireo. Miaraka amin'ny baiko –s, na dia a file misy miaraka amin'ny anarana voafaritra mitovy, dia soloina ho azy tsy misy hafatra.
Example 3
Manasonia binary file mampiasa lohapejy 2 izay misy fanalahidin'ny daholobe valo ho an'ny fikorianan'ny fanamarinana.
Example 4
Manasonia binary file mampiasa lohapejy 2 izay misy fanalahidin'ny daholobe valo ho an'ny fanamarinana miampy fikorianan'ny encryption.

Example 5
Hamarino ny sary vokarina amin'ny alàlan'ny famakafakana ny vokatra file ary jereo ny saha lohapejy tsirairay.
Example 6
Manampia lohapejy tsy misy sonia ary tsy mampiasa fanalahidy.

Fomba tokana
Rehefa manatanteraka STM32MP-SignTool amin'ny fomba Mijoro dia tsy maintsy ampidirina voalohany ny lalana tanteraka. Ny tenimiafina dia angatahina indroa ho fanamafisana, araka ny aseho amin'ny sary etsy ambany.

Ny dingana manaraka dia ireto manaraka ireto:

Mifidiana iray amin'ireo algorithms roa.

Ampidiro ny dikan-tsary, ny toerana idirana sary, ary ny adiresin'ny entana.
Ampidiro ny sandan'ny faneva safidy.
Output hafa file azo faritana ny lalana raha ilaina, na tsindrio ny Enter raha hanohy ny efa misy.

Vahaolana PKCS#11

Ireo sary mimari-droa nosoniavina dia ampiasaina mandritra ny filaharana baoty azo antoka STM32MP izay manohana rojo baoty azo itokisana. Ity hetsika ity dia miantoka ny fanamarinana sy ny fahamendrehan'ny sary voarakitra.

Ny baiko fanaovana sonia mahazatra dia mangataka ny hanomezana ny fanalahidy rehetra ho an'ny daholobe sy manokana ho fampidirana files. Ireo dia azon'ny olona avela hanao sonia. Amin'ny farany dia azo raisina ho toy ny leaka fiarovana izany. Misy vahaolana maromaro hiarovana ny fanalahidy amin'ny fikasana hangalatra angon-drakitra. Amin'ity toe-javatra ity, ny vahaolana PKCS #11 dia noraisina.
Ny API PKCS#11 dia azo ampiasaina amin'ny fitantanana sy fitahirizana ny fanalahidy kriptografika. Ity interface ity dia mamaritra ny fomba hifandraisana amin'ny fitaovana kriptografika toy ny HSMs (module fiarovana amin'ny fitaovana) sy smartcards. Ny tanjon'ireo fitaovana ireo dia ny hamokatra fanalahidin'ny kriptografika sy hanasonia vaovao nefa tsy mampiseho fitaovana fanalahidy manokana amin'ny tontolo ivelany.
Ny rindranasa rindrambaiko dia afaka miantso ny API hampiasa ireto zavatra ireto ho an'ny:
- Mamorona fanalahidy symmetrika/asymmetrika
- Encryption sy decryption
- Kajy sy fanamarinana ny sonia nomerika

Ny PKCS #11 dia manolotra ny fampiharana mahazatra, lojika view amin'ny fitaovana antsoina hoe famantarana kriptografika ary manome ID slot ho an'ny famantarana tsirairay. Ny fampiharana iray dia mamaritra ny mari-pamantarana tiany hidirana amin'ny alàlan'ny famaritana ny ID slot mety.
Ny STM32SigningTool dia ampiasaina hitantana ireo zavatra manan-danja voatahiry amin'ny carte marani-tsaina sy famantarana fiarovana PKCS#11 mitovy amin'izany izay tsy miala amin'ny fitaovana mihitsy ny fanalahidy manokana saro-pady.
Ny STM32SigningTool dia mampiasa ny seha-pifandraisana PKCS#11 hanodinkodinana sy hanasonia ny binaries fampidirana mifototra amin'ny fanalahidin'ny ECDSA public/private. Ireo fanalahidy ireo dia voatahiry ao amin'ny mari-pamantarana fiarovana (fitaovana na rindrambaiko).

Didy fanampiny PKCS#11

-module (-m)
- Famaritana: mamaritra ny PKCS#11 module/Library lalan'ny entana (dll, so)
- Syntax:-m
-key-index (-ki)
- -key-index (-ki)
- Famaritana: lisitry ny fanondroana fanalahidy ampiasaina amin'ny endrika hex
  Mampiasà fanondroana iray ho an'ny lohapejy v1 ary fanondro valo ho an'ny lohapejy v2 (sarahan'ny habaka)
- Syntax: -ki
–slot-index (-si)
- Famaritana: mamaritra ny fanondroan'ny slot hampiasaina (default 0x0)
- Syntax:-si
–active-keyIndex (-aki)
- Famaritana: ambarao ny tondro fanalahidy mavitrika (default 0)
- Syntax: -aki < hexValue >

PKH/PKTH file TARANAKA
Aorian'ny fikarakarana ny asa sonia, ny fitaovana dia mamoaka ny PKH files ampiasaina aorian'ny OTP fuse.

PKH file nomena anarana pkcsHashPublicKey0x{active_key_index}.bin ho an'ny lohapejy v1
PKTH file nomena anarana pkcsPublicKeysHashHashes.bin ho an'ny lohapejy v2

Exampl'
Ny fitaovana dia afaka manao sonia fidirana files ho an'ny lohapejy v1 sy lohapejy v2, misy fahasamihafana kely eo amin'ny andalana baiko.

Lohateny v1
Lohateny v2
- Ny fahadisoana eo amin'ny baiko baiko, na ny tsy fahafahan'ny fitaovana hamantatra ireo zavatra manan-danja mifanandrify, dia miteraka hafatra diso. Izany dia manondro ny loharanon'ny olana.
- Ny SigningTool dia tsy afaka mampiasa afa-tsy HSM efa voarindra, ary tsy natao hitantana na hamorona zavatra fiarovana vaovao. Noho izany dia ilaina ny mametraka rindrambaiko maimaim-poana mba hananganana tontolo mety. Avy eo dia azo amboarina ny fanalahidy, ary azo ny fampahalalana momba ny zavatra.

Error examples:

Fanondroana slot tsy mety
Zavatra fototra tsy fantatra izay voalaza ao amin'ny baiko –key-index
Ny fitaovana dia mikarakara ireo zavatra araka ny filaharany. Raha tsy afaka mamantatra ireo zavatra manan-danja mifanandrify amin'ny andrana voalohany izy, dia atsahatra ny fizotry ny fanaovana sonia. Hafatra diso no aseho avy eo mba hanondroana ny loharanon'ny olana.

Tantara fanavaozana

Daty	Malagasy Bible	FIOVANA
14-Feb-2019	1	Famoahana voalohany.
26-Nov-2021	2	Nohavaozina: • Fizarana 2.1: Didy • Fizarana 2.2: EksampIreo singa mifandraika amin'ny STM32MP-SignTool • Nampiana Fizarana 2.4: Vahaolana PKCS#11
27-Jona-2022	3	Fizarana 2.1 nohavaozina: Didy
26-Jona-2024	4	Nosoloina ny antontan-taratasy manontolo: • andiany STM32MP1 amin'ny andiany STM32MPx • STM32MP1-SignTool avy amin'ny STM32MP-SignTool • STM32MP1-KeyGen avy amin'ny STM32MP-KeyGen Nohavaozina –public-key -pubk ary nampiana –header-version (-hv) sy –no-keys (- nk) ao amin'ny fizarana 2.1: baiko. Nampiana “Ohatra 6” ao amin’ny Fizarana 2.2: EksampIreo singa mifandraika amin'ny STM32MP-SignTool.

FANAMARIHANA MANDRAKIZAY – vakio tsara

Ny STMicroelectronics NV sy ny sampany (“ST”) dia manana zo hanao fanovana, fanitsiana, fanatsarana, fanovana ary fanatsarana ny vokatra ST sy/na ity antontan-taratasy ity amin'ny fotoana rehetra tsy misy filazana. Ny mpividy dia tokony hahazo ny vaovao farany mifandraika amin'ny vokatra ST alohan'ny hametrahana baiko. Ny vokatra ST dia amidy araka ny fepetra sy fepetra momba ny fivarotana ST amin'ny fotoana fanekena ny kaomandy.
Ny mpividy dia tompon'andraikitra amin'ny safidy, ny fisafidianana ary ny fampiasana ny vokatra ST ary ny ST dia tsy mandray andraikitra amin'ny fanampiana amin'ny fampiharana na ny famolavolana ny vokatra avy amin'ny mpividy.
Tsy misy fahazoan-dàlana, na mazava na an-kolaka, amin'ny zon'ny fananana ara-tsaina omen'ny ST eto.

Ny fivarotana indray ny vokatra ST miaraka amin'ny fepetra hafa amin'ny fampahalalana voalaza eto dia hanafoana ny fiantohana omen'ny ST ho an'ny vokatra toy izany.
ST sy ny logo ST dia marika famantarana ny ST. Raha mila fanazavana fanampiny momba ny marika ST, jereo ny www.st.com/trademarks. Ny anaran'ny vokatra na serivisy hafa rehetra dia fananan'ny tompony tsirairay avy.
Ny fampahalalana ato amin'ity antontan-taratasy ity dia manolo sy manolo ny fampahalalana efa nomena tamin'ny dikan-teny teo aloha amin'ity antontan-taratasy ity.
© 2024 STMicroelectronics – Zo rehetra voatokana

Documents / Loharano

ST STM32MPx Series Signing Tool Software [pdf] Boky Torolàlana
STM32MPx Series Fanaovana sonia Software, STM32MPx Series, Fanasoniavana Software Software, Tool Software, Software

References

User Manual

STM32MPx Series Signing Tool Software

Product Information

Torolàlana momba ny fampiasana vokatra