sw-emulator: Add dilithium peripheral (#1623)

This change contains the Dilithium peripheral.

Cargo.toml

@@ -146,6 +146,7 @@ dpe = { path = "dpe/dpe", default-features = false, features = ["dpe_profile_p38
 crypto = { path = "dpe/crypto", default-features = false }
 platform = { path = "dpe/platform", default-features = false }
 elf = "0.7.2"
+fips204 = "0.2.1"
 gdbstub = "0.6.3"
 gdbstub_arch = "0.2.4"
 getrandom = "0.2"

sw-emulator/lib/periph/Cargo.toml

@@ -18,7 +18,9 @@ caliptra-emu-derive.workspace = true
 caliptra-emu-types.workspace = true
 caliptra-hw-model-types.workspace = true
 caliptra-registers.workspace = true
+fips204.workspace = true
 lazy_static.workspace = true
+rand.workspace = true
 sha3.workspace = true
 smlang.workspace = true
 tock-registers.workspace = true

sw-emulator/lib/periph/src/helpers.rs

@@ -23,7 +23,9 @@ pub trait U32Array: AsRef<[u32]> {
 }
 pub trait U32ArrayBytes: AsRef<[u8]> {
     const WORD_LEN: usize;
-    type WordArray: AsMut<[u32]> + Default;
+    type WordArray: AsMut<[u32]>;
+    // Required because Default isn't implemented for [u32; 64 and higher]
+    fn default_result() -> Self::WordArray;
 }
 macro_rules! u32_array_impl {
     ($word_len:literal) => {
@@ -37,6 +39,9 @@ macro_rules! u32_array_impl {
         impl U32ArrayBytes for [u8; $word_len * 4] {
             const WORD_LEN: usize = $word_len;
             type WordArray = [u32; $word_len];
+            fn default_result() -> Self::WordArray {
+                [0u32; $word_len]
+            }
         }
     };
 }
@@ -58,17 +63,20 @@ u32_array_impl!(14);
 u32_array_impl!(15);
 u32_array_impl!(16);
 u32_array_impl!(32);
+u32_array_impl!(648);
+u32_array_impl!(1157);
+u32_array_impl!(1224);
 
 pub fn words_from_bytes_le<A: U32ArrayBytes>(arr: &A) -> A::WordArray {
-    let mut result = A::WordArray::default();
+    let mut result = A::default_result();
     for i in 0..result.as_mut().len() {
         result.as_mut()[i] = u32::from_le_bytes(arr.as_ref()[i * 4..][..4].try_into().unwrap())
     }
     result
 }
 
 pub fn words_from_bytes_be<A: U32ArrayBytes>(arr: &A) -> A::WordArray {
-    let mut result = A::WordArray::default();
+    let mut result = A::default_result();
     for i in 0..result.as_mut().len() {
         result.as_mut()[i] = u32::from_be_bytes(arr.as_ref()[i * 4..][..4].try_into().unwrap())
     }

sw-emulator/lib/periph/src/lib.rs

@@ -25,6 +25,7 @@ mod hmac_sha384;
 mod iccm;
 mod key_vault;
 mod mailbox;
+mod ml_dsa87;
 mod root_bus;
 mod sha512_acc;
 pub mod soc_reg;