Bug fixes and test coverage

boards/peripheral/wolfHAL_peripheral.c

@@ -53,6 +53,7 @@ whal_PeripheralFlash_Cfg g_peripheralFlash[] = {
         .name = "spi_nor_w25q64",
         .dev = &g_whalSpiNorW25q64,
         .sectorSz = 4096,
+        .pageSz = 256,
     },
 #endif
     {0}, /* sentinel */

boards/peripheral/wolfHAL_peripheral.h

@@ -44,6 +44,7 @@ typedef struct {
     const char *name;
     whal_Flash *dev;
     size_t sectorSz;     /* Sector (erase) size in bytes */
+    size_t pageSz;       /* Program page size in bytes */
 } whal_PeripheralFlash_Cfg;
 
 /* Peripheral sensor device test configuration */

boards/stm32f091rc_nucleo/wolfHAL_board.h

@@ -92,6 +92,7 @@ enum {
     .cfg    = (void *)&(const whal_Stm32f0_Flash_Cfg){ \
         .startAddr = 0x08000000, \
         .size      = 0x40000, \
+        .pageSz    = 0x800, \
         .timeout   = &g_whalTimeout, \
     }, \
 }

boards/stm32f302r8_nucleo/wolfHAL_board.h

@@ -94,6 +94,7 @@ enum {
     .cfg    = (void *)&(const whal_Stm32f3_Flash_Cfg){ \
         .startAddr = 0x08000000, \
         .size      = 0x10000, \
+        .pageSz    = 0x800, \
         .timeout   = &g_whalTimeout, \
     }, \
 }

boards/stm32wb55xx_nucleo/wolfHAL_board.h

@@ -32,6 +32,9 @@ extern whal_Spi g_whalSpi;
 extern whal_Crypto g_whalCrypto;
 extern whal_I2c g_whalI2c;
 extern whal_Pwm g_whalPwm;
+#ifdef BOARD_DMA
+extern whal_Dma g_whalDma1;
+#endif
 
 extern whal_Timeout g_whalTimeout;
 extern volatile uint32_t g_tick;

docs/writing_a_driver.md

@@ -1180,7 +1180,7 @@ the HMAC key for the outer hash pass).
 Each algorithm defines a vtable with typed function pointers. The available
 operations depend on the algorithm category:
 
-**Block ciphers** have `Oneshot`, `Start`, and `Process`:
+**Block ciphers** have `Oneshot`, `Start`, `Process`, and `Stop`:
 
 ```c
 typedef struct {
@@ -1193,6 +1193,7 @@ typedef struct {
                         const void *iv);
     whal_Error (*Process)(whal_AesCbc *dev,
                           const void *in, void *out, size_t sz);
+    whal_Error (*Stop)(whal_AesCbc *dev);
 } whal_AesCbcDriver;
 ```
 
@@ -1272,6 +1273,8 @@ typedef struct {
   for AEAD, digest for hash/HMAC). Only present on algorithms that need a
   finalization step. Block ciphers (ECB, CBC, CTR) do not have Finalize
   because each Process call produces complete output.
+- **Stop** ends a block cipher (ECB, CBC, CTR) streaming session. It disables
+  the engine and clears the key and IV from the hardware.
 
 Unsupported parameter combinations (e.g. AES-192 on hardware that only
 supports 128/256) return `WHAL_ENOTSUP`.
@@ -1332,6 +1335,7 @@ Streaming (block cipher):
 whal_AesCbc_Start(BOARD_AES_CBC_DEV, WHAL_CRYPTO_ENCRYPT, key, 32, iv);
 whal_AesCbc_Process(BOARD_AES_CBC_DEV, block1, out1, 16);
 whal_AesCbc_Process(BOARD_AES_CBC_DEV, block2, out2, 16);
+whal_AesCbc_Stop(BOARD_AES_CBC_DEV);
 ```
 
 ### Math Primitives

src/block/sdhc_spi_block.c

@@ -188,7 +188,7 @@ whal_Error whal_SdhcSpi_Init(whal_Block *blockDev)
     cfg = (whal_SdhcSpi_Cfg *)blockDev->cfg;
 #endif
 
-    if (!cfg->spiDev || !cfg->spiComCfg || !cfg->gpioDev)
+    if (!cfg->spiComCfg)
         return WHAL_EINVAL;
 
     slow = *cfg->spiComCfg;

src/crypto/aes_cbc.c

@@ -53,3 +53,12 @@ whal_Error whal_AesCbc_Process(whal_AesCbc *dev,
         return WHAL_ENOTSUP;
     return dev->driver->Process(dev, in, out, sz);
 }
+
+whal_Error whal_AesCbc_Stop(whal_AesCbc *dev)
+{
+    if (!dev)
+        return WHAL_EINVAL;
+    if (!dev->driver || !dev->driver->Stop)
+        return WHAL_ENOTSUP;
+    return dev->driver->Stop(dev);
+}

src/crypto/aes_ctr.c

@@ -53,3 +53,12 @@ whal_Error whal_AesCtr_Process(whal_AesCtr *dev,
         return WHAL_ENOTSUP;
     return dev->driver->Process(dev, in, out, sz);
 }
+
+whal_Error whal_AesCtr_Stop(whal_AesCtr *dev)
+{
+    if (!dev)
+        return WHAL_EINVAL;
+    if (!dev->driver || !dev->driver->Stop)
+        return WHAL_ENOTSUP;
+    return dev->driver->Stop(dev);
+}

src/crypto/aes_ecb.c

@@ -51,3 +51,12 @@ whal_Error whal_AesEcb_Process(whal_AesEcb *dev,
         return WHAL_ENOTSUP;
     return dev->driver->Process(dev, in, out, sz);
 }
+
+whal_Error whal_AesEcb_Stop(whal_AesEcb *dev)
+{
+    if (!dev)
+        return WHAL_EINVAL;
+    if (!dev->driver || !dev->driver->Stop)
+        return WHAL_ENOTSUP;
+    return dev->driver->Stop(dev);
+}