UM2542 STM32MPx Series Software Generator Key
Informazione di u produttu
Specificazioni
- Nome di u produttu: software generatore di chjave di a serie STM32MPx
- Versione: UM2542 - Rev 3
- Data di uscita: ghjugnu 2024
- Produttore: STMicroelectronics
Istruzzioni per l'usu di u produttu
1. Installa STM32MP-KeyGen
Per installà u software STM32MP-KeyGen, seguitate a stallazione
istruzioni fornite in u manuale d'usu.
2. STM32MP-KeyGen Command Line Interface
U software STM32MP-KeyGen pò esse usatu da a linea di cummanda
interfaccia. Quì sottu sò i cumandamenti dispunibili:
- -chjave privata (-prvk)
- -chjave publica (-pubk)
- –public-key-hash (-hash)
- – percorsu assolutu (-abs)
- -password (-pwd)
- –prvkey-enc (-pe)
- –ecc-algo (-ecc)
- -aiutu (-h è -?)
- -versione (-v)
- –chiave numerica (-n)
3. Esamples
Eccu alcuni exampless di cumu utilizà STM32MP-KeyGen:
-
- Example 1: -abs /home/user/KeyFolder/ -pwd azerty
- Example 2: -abs /home/user/KeyFolder/ -pwd azerty -pe
aes128
FAQ
Q: Quante coppie chjave ponu esse generate à una volta?
A: Pudete generà finu à ottu coppie chjave simultaneamente da
furnisce ottu password.
Q: Chì algoritmi di criptografia sò supportati?
A: U software supporta a criptografia aes256 è aes128
algoritmi.
UM 2542
Manuale d'usu
Descrizione di u software di generatore di chjave di a serie STM32MPx
Introduzione
U software generatore di chjave di a serie STM32MPx (chjamatu STM32MP-KeyGen in stu documentu) hè integratu in u STM32CubeProgrammer (STM32CubeProg). STM32MP-KeyGen hè un strumentu chì genera a coppia di chjave ECC necessaria per firmà l'imaghjini binari. I chjavi generati sò utilizati da u strumentu di firma STM32 per u prucessu di firma. STM32MP-KeyGen genera una chjave publica file, una chjave privata file è una chjave publica hash file. A chjave publica file cuntene a chjave publica ECC generata in formatu PEM. A chjave privata file cuntene a chjave privata ECC criptata in formatu PEM. A criptografia pò esse fatta cù l'aes 128 cbc o aes 256 cbc ciphers. A selezzione di cifru hè fatta cù l'opzione -prvkey-enc. A chjave publica hash file cuntene l'hash SHA-256 di a chjave publica in formatu binariu. L'hash SHA-256 hè calculatu basatu annantu à a chjave publica senza formatu di codificazione. U primu byte di a chjave publica hè prisente solu per indicà s'ellu a chjave publica hè in formatu cumpressatu o micca cumpressatu. Siccomu solu u furmatu micca cumpressatu hè supportatu, stu byte hè eliminatu.
DT51280V1
UM2542 - Rev 3 - ghjugnu 2024 Per più infurmazione cuntattate u vostru uffiziu di vendita STMicroelectronics locale.
www.st.com
1
Nota:
UM 2542
Installa STM32MP-KeyGen
Installa STM32MP-KeyGen
Stu strumentu hè stallatu cù u pacchettu STM32CubeProgrammer (STM32CubeProg). Per più infurmazione nantu à a prucedura di cunfigurazione, riferite à a sezione 1.2 di a descrizzione di u software STM32CubeProgrammer (UM2237). Stu software si applica à i MPU basati in Arm® di a serie STM32MPx. Arm hè una marca registrata di Arm Limited (o i so filiali) in i Stati Uniti è / o in altrò.
UM2542 - Rev 3
pagina 2/8
UM 2542
Interfaccia di linea di cummanda STM32MP-KeyGen
2
Interfaccia di linea di cummanda STM32MP-KeyGen
I seguenti sezzioni descrizanu cumu utilizà STM32MP-KeyGen da a linea di cummanda.
2.1
Cumandamenti
I cumandamenti dispunibili sò elencati quì sottu:
·
-chjave privata (-prvk)
Descrizzione: chjave privata file percorso (estensione .pem)
Sintassi: -prvkfile_path>
Esample: -prvk ../privateKey.pem
·
-chjave publica (-pubk)
Descrizzione: Chjave publica file percorso (estensione .pem)
Sintassi: -pubkfile_path>
Esample: -pubk C:publicKey.pem
·
–public-key-hash (-hash)
Descrizzione: Hash image file percorso (estensione .bin)
Sintassi: -hashfile_path>
·
– percorsu assolutu (-abs)
Descrizzione: Percorsu assolutu per l'output files
Sintassi: -abs
Esample: -abs C:KeyFolder
·
-password (-pwd)
Descrizzione: Password di a chjave privata (sta password deve cuntene almenu quattru caratteri)
Esample: -pwd azerty
Nota:
Includite ottu password per generà ottu coppie di chjave.
Sintaxi 1:-pwd
Sintaxi 2: -pwd
·
–prvkey-enc (-pe)
Descrizzione: Algoritmu di criptografia di chjave privata (aes128 / aes256) (l'algoritmu aes256 hè l'algoritmu predeterminatu)
Sintassi: -pe aes128
·
–ecc-algo (-ecc)
Descrizzione: Algoritmu ECC per a generazione di chjave (prime256v1/brainpoolP256t1) (prime256v1 hè l'algoritmu predeterminatu)
Sintassi: -ecc prime256v1
·
-aiutu (-h è -?)
Descrizzione: Mostra aiutu.
·
-versione (-v)
Descrizzione: Mostra a versione di u strumentu.
·
–chiave numerica (-n)
Descrizzione: Generate numeru di coppie chjave {1 o 8} cù Hash of table file
Sintassi: -n
UM2542 - Rev 3
pagina 3/8
UM 2542
Interfaccia di linea di cummanda STM32MP-KeyGen
2.2
Examples
I seguenti exampmostranu cumu utilizà STM32MP-KeyGen:
·
Examplu 1
-abs /home/user/KeyFolder/ -pwd azerty
Tuttu files (publicKey.pem, privateKey.pem è publicKeyhash.bin) sò creati in u cartulare /home/user/KeyFolder/. A chjave privata hè criptata cù l'algoritmu predeterminatu aes256.
·
Examplu 2
-abs /home/user/keyFolder/ -pwd azerty pe aes128
Tuttu files (publicKey.pem, privateKey.pem è publicKeyhash.bin) sò creati in u cartulare /home/user/KeyFolder/. A chjave privata hè criptata cù l'algoritmu aes128.
·
Examplu 3
-pubk /home/user/public.pem prvk /home/user/Folder1/Folder2/private.pem hash /home/user/pubKeyHash.bin pwd azerty
Ancu s'è u Folder1 è Folder2 ùn esiste micca, sò creati.
·
Examplu 4
Generate ottu coppie di chjave in u cartulare di travagliu:
./STM32MP_KeyGen_CLI.exe -abs . -pwd abc1 abc2 abc3 abc4 abc5 abc6 abc7 abc8 -n 8
L'output dà i seguenti files: ottu chjave publica files: publicKey0x{0..7}.pem ottu chjave privata files: privateKey0x{0..7}.pem ottu hash di chjave publica files: publicKeyHash0x{0..7}.bin unu file di PKTH: publicKeysHashHashes.bin
·
Examplu 5
Generate una coppia di chjave in u cartulare di travagliu:
./STM32MP_KeyGen_CLI.exe -abs . -pwd abc1 -n 1
L'output dà i seguenti files: una chjave publica file: publicKey.pem una chjave privata file: privateKey.pem un hash di chjave publica file: publicKeyHash.bin unu file di PKTH: publicKeysHashHashes.bin
UM2542 - Rev 3
pagina 4/8
UM 2542
Interfaccia di linea di cummanda STM32MP-KeyGen
2.3
Modu standalone
Quandu eseguisce STM32MP-KeyGen in modalità Standalone, una strada assoluta è una password sò dumandate cum'è mostra in a figura sottu.
Figura 1. STM32MP-KeyGen in modu Standalone
Quandu l'utilizatore pressu , u files sò generati in u cartulare.
Dopu inserite a password duie volte è selezziunate unu di i dui algoritmi (prime256v1 o brainpoolP256t1) pressu a chjave rispettiva (1 o 2).
Infine selezziunate un algoritmu di criptografia (aes256 o aes128) premendu a chjave rispettiva (1 o 2).
UM2542 - Rev 3
pagina 5/8
Storia di rivisione
Data 14-Feb-2019 24-Nov-2021
26-ghjugnu-2024
Table 1. Storia di rivisione di documenti
Versione 1 2
3
Cambiamenti
Liberazione iniziale.
Actualizatu: · Sezzione 2.1: Cumandamenti · Sezzione 2.2: Esamples
Sustituitu in tuttu u ducumentu: · Serie STM32MP1 da serie STM32MPx · STM32MP1-KeyGen da STM32MP-KeyGen
UM 2542
UM2542 - Rev 3
pagina 6/8
UM 2542
Cuntenuti
Cuntenuti
1 Installa STM32MP-KeyGen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 2 STM32MP-KeyGen interfaccia di linea di cumanda. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2.1 Cumandamenti. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2.2 Esamples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 2.3 Modu standalone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Storia di rivisione. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
UM2542 - Rev 3
pagina 7/8
UM 2542
AVVISU IMPORTANTE LEGGIU ATTENTAMENTE STMicroelectronics NV è e so filiali ("ST") si riservanu u dirittu di fà cambiamenti, correzioni, miglioramenti, mudificazioni è migliure à i prudutti ST è / o à stu documentu in ogni mumentu senza avvisu. I cumpratori anu da ottene l'ultime informazioni pertinenti nantu à i prudutti ST prima di fà ordini. I prudutti ST sò venduti in cunfurmità cù i termini è e cundizioni di vendita di ST in vigore à u mumentu di a ricunniscenza di l'ordine. I cumpratori sò solu rispunsevuli di a scelta, a selezzione è l'usu di i prudutti ST è ST ùn assume micca responsabilità per l'assistenza di l'applicazione o u disignu di i prudutti di l'acquirente. Nisuna licenza, espressa o implicita, à qualsiasi dirittu di pruprietà intellettuale hè cuncessa da ST quì. A rivendita di i prudutti ST cù disposizioni diverse da l'infurmazioni stabilite quì annullerà ogni garanzia accordata da ST per tali pruduttu. ST è u logo ST sò marchi di ST. Per infurmazioni supplementari nantu à i marchi ST, riferite à www.st.com/trademarks. Tutti l'altri prudutti o nomi di serviziu sò a pruprietà di i so rispettivi pruprietarii. L'infurmazioni in stu documentu rimpiazzanu è rimpiazzanu l'infurmazioni furnite prima in qualsiasi versione precedente di stu documentu.
© 2024 STMicroelectronics Tutti i diritti riservati
UM2542 - Rev 3
pagina 8/8
Documenti / Risorse
 |
Software di generatore di chjave di a serie STMicroelectronics UM2542 STM32MPx [pdfManuale d'usu UM2542, DT51280V1, UM2542 STM32MPx Series Software Generator Key, UM2542, Software Generator Key Series STM32MPx, Software Generator Key Series, Software Generator Key, Software Generator, Software |
