lib: stm32wba: 802.15.4 driver integration

Add 802.15.4 driver integration

Signed-off-by: Vincent Tardy <vincent.tardy@st.com>

Author: vtardy-st

lib/CMakeLists.txt

@@ -7,6 +7,8 @@
 
 if(CONFIG_HAS_STM32LIB)
   add_subdirectory_ifdef(CONFIG_BT_STM32_IPM stm32wb)
-  add_subdirectory_ifdef(CONFIG_BT_STM32WBA stm32wba)
+  if(DEFINED CONFIG_BT_STM32WBA OR DEFINED CONFIG_IEEE802154_STM32WBA)
+    add_subdirectory(stm32wba)
+  endif()
   add_subdirectory_ifdef(CONFIG_BT_STM32WB0 stm32wb0)
 endif()

lib/README.rst

@@ -8,4 +8,4 @@ Available libraries:
   * stm32wb0:
       STM32WB0 BLE controller interfacing library.
   * stm32wba:
-      STM32WBA BLE controller interfacing library.
+      STM32WBA BLE and 802.15.4 controller interfacing libraries.

lib/stm32wba/CMakeLists.txt

@@ -1,41 +1,22 @@
-# Copyright (c) 2024 STMicroelectronics
+# Copyright (c) 2025 STMicroelectronics
 #
 # SPDX-License-Identifier: Apache-2.0
-
-zephyr_compile_definitions( -DBLE )
-
-zephyr_include_directories(BLE_TransparentMode/Core/Inc)
-zephyr_include_directories(BLE_TransparentMode/STM32_WPAN/Target)
-zephyr_include_directories(BLE_TransparentMode/System/Config/Debug_GPIO)
-zephyr_include_directories(BLE_TransparentMode/System/Config/Log)
 zephyr_include_directories(Common/WPAN/Interfaces)
 zephyr_include_directories(Common/WPAN/Modules)
 zephyr_include_directories(Common/WPAN/Modules/Flash)
 zephyr_include_directories(Common/WPAN/Modules/RTDebug)
 zephyr_include_directories(Common/WPAN/Modules/Log)
-zephyr_include_directories(STM32_WPAN)
-zephyr_include_directories(STM32_WPAN/ble/stack/include)
-zephyr_include_directories(STM32_WPAN/ble/stack/include/auto)
-zephyr_include_directories(STM32_WPAN/link_layer/ll_cmd_lib/config/ble_full)
-zephyr_include_directories(STM32_WPAN/link_layer/ll_cmd_lib/inc)
-zephyr_include_directories(STM32_WPAN/link_layer/ll_cmd_lib/inc/_40nm_reg_files)
-zephyr_include_directories(STM32_WPAN/link_layer/ll_sys/inc)
+if (CONFIG_IEEE802154_STM32WBA)
+zephyr_include_directories(Common/WPAN/Modules/BasicAES)
+endif()
 zephyr_include_directories(Utilities/misc)
 zephyr_include_directories(Utilities/tim_serv)
-zephyr_include_directories(Utilities/trace/adv_trace)
+zephyr_include_directories(STM32_WPAN)
 
-zephyr_sources(BLE_TransparentMode/STM32_WPAN/Target/bpka.c)
-zephyr_sources(BLE_TransparentMode/STM32_WPAN/Target/linklayer_plat.c)
-zephyr_sources(BLE_TransparentMode/STM32_WPAN/Target/ll_sys_if.c)
-zephyr_sources(BLE_TransparentMode/STM32_WPAN/Target/power_table.c)
-zephyr_sources(Common/WPAN/Modules/Log/log_module.c)
 zephyr_sources(Common/WPAN/Interfaces/hw_pka.c)
 zephyr_sources(Common/WPAN/Interfaces/hw_pka_p256.c)
 zephyr_sources(Common/WPAN/Modules/RTDebug/RTDebug.c)
-zephyr_sources(STM32_WPAN/link_layer/ll_sys/src/ll_sys_cs.c)
-zephyr_sources(STM32_WPAN/link_layer/ll_sys/src/ll_sys_dp_slp.c)
-zephyr_sources(STM32_WPAN/link_layer/ll_sys/src/ll_sys_intf.c)
-zephyr_sources(STM32_WPAN/link_layer/ll_sys/src/ll_sys_startup.c)
+
 
 if(CONFIG_FLASH)
   zephyr_sources(Common/WPAN/Modules/Flash/flash_manager.c)
@@ -44,6 +25,31 @@ if(CONFIG_FLASH)
   zephyr_sources(Common/WPAN/Modules/Flash/rf_timing_synchro.c)
 endif()
 
+if (CONFIG_IEEE802154_STM32WBA)
+zephyr_sources(Common/WPAN/Modules/BasicAES/baes_ccm.c)
+zephyr_sources(Common/WPAN/Modules/BasicAES/baes_cmac.c)
+zephyr_sources(Common/WPAN/Modules/BasicAES/baes_ecb.c)
+endif()
+
+if (CONFIG_IEEE802154_STM32WBA)
+add_library(stm32wba_ll_lib STATIC IMPORTED GLOBAL)
+if(CONFIG_OPENTHREAD)
+  message(STATUS "WBA6_LinkLayer_Thread_lib.a lib selected")
+  set_target_properties(
+    stm32wba_ll_lib PROPERTIES IMPORTED_LOCATION ${CMAKE_CURRENT_SOURCE_DIR}/../../zephyr/blobs/stm32wba/lib/WBA6_LinkLayer_Thread_lib.a
+  )
+else()
+  message(STATUS "WBA6_LinkLayer15_4.a lib selected")
+	set_target_properties(
+    stm32wba_ll_lib PROPERTIES IMPORTED_LOCATION ${CMAKE_CURRENT_SOURCE_DIR}/../../zephyr/blobs/stm32wba/lib/WBA6_LinkLayer15_4.a
+  )
+endif()
+set(STM32WBA_LL_LIB_INCLUDE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/STM32_WPAN/link_layer/ll_cmd_lib)
+set_target_properties(stm32wba_ll_lib PROPERTIES INTERFACE_INCLUDE_DIRECTORIES ${STM32WBA_LL_LIB_INCLUDE_DIR})
+target_link_libraries(app PUBLIC stm32wba_ll_lib)
+endif()
+
+if (CONFIG_BT_STM32WBA)
 if (CONFIG_BT_EXT_ADV
     OR (CONFIG_BT_PER_ADV OR CONFIG_BT_PER_ADV_SYNC)
     OR CONFIG_BT_SCA_UPDATE
@@ -63,7 +69,6 @@ else()
   set(BLE_LIB_TYPE "BLE_LIB_BASIC")
 endif()
 
-	
 set(STM32WBA_BLE_LIB_DIR ${CMAKE_CURRENT_SOURCE_DIR}/../../zephyr/blobs/stm32wba/lib)
 set(STM32WBA_BLE_LIB_INCLUDE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/STM32_WPAN/ble/stack)
 set(STM32WBA_LL_LIB_INCLUDE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/STM32_WPAN/link_layer/ll_cmd_lib)
@@ -118,3 +123,9 @@ set_target_properties(stm32wba_ll_lib PROPERTIES INTERFACE_INCLUDE_DIRECTORIES $
 
 target_link_libraries(app PUBLIC stm32wba_ble_lib)
 target_link_libraries(app PUBLIC stm32wba_ll_lib)
+endif()
+
+add_subdirectory(STM32_WPAN)
+
+add_subdirectory_ifdef(CONFIG_BT_STM32WBA ble)
+add_subdirectory_ifdef(CONFIG_IEEE802154_STM32WBA IEEE802154)

lib/stm32wba/Common/WPAN/Modules/BasicAES/baes.h

@@ -0,0 +1,73 @@
+/**
+  ******************************************************************************
+  * @file    baes.h 
+  * @author  MCD Application Team
+  * @brief   This file contains the interface of the basic AES software module.
+  ******************************************************************************
+  * @attention
+  *
+  * Copyright (c) 2024 STMicroelectronics.
+  * All rights reserved.
+  *
+  * This software is licensed under terms that can be found in the LICENSE file
+  * in the root directory of this software component.
+  * If no LICENSE file comes with this software, it is provided AS-IS.
+  *
+  ******************************************************************************
+  */
+
+#ifndef BAES_H__
+#define BAES_H__
+
+#include <stdint.h>
+
+/* Basic AES module dedicated to BLE stack with the following features:
+ *   - AES ECB encryption
+ *   - AES CMAC computation
+ *
+ * Configuration: the file "app_common.h" is included in this module.
+ * It must define:
+ *   - CFG_BAES_SW equals to 1 for software implementation
+ *   - CFG_BAES_SW equals to 0 for use of hardware accelerator
+ *
+ * Notes:
+ *   - only 128-bit key is supported
+ *   - re-entrance is not supported
+ */
+
+/* General interface */
+
+extern void BAES_Reset( void );
+
+/* AES ECB interface */
+
+extern void BAES_EcbCrypt( const uint8_t* key,
+                           const uint8_t* input,
+                           uint8_t* output,
+                           int enc );
+
+/* AES CMAC interface */
+
+extern void BAES_CmacSetKey( const uint8_t* key );
+
+extern void BAES_CmacSetVector( const uint8_t * pIV );
+
+extern void BAES_CmacCompute( const uint8_t* input,
+                              uint32_t size,
+                              uint8_t* output );
+
+/* AES CCM interface */
+
+extern int BAES_CcmCrypt( uint8_t mode,
+                          const uint8_t* key,
+                          uint8_t iv_length,
+                          const uint8_t* iv,
+                          uint16_t add_length,
+                          const uint8_t* add,
+                          uint16_t input_length,
+                          const uint8_t* input,
+                          uint8_t tag_length,
+                          uint8_t* tag,
+                          uint8_t* output );
+
+#endif /* BAES_H__ */

lib/stm32wba/Common/WPAN/Modules/BasicAES/baes_ccm.c

@@ -0,0 +1,120 @@
+/*****************************************************************************
+ * @file    baes_ccm.c
+ *
+ * @brief   This file contains the AES CCM implementation.
+ *****************************************************************************
+ * @attention
+ *
+ * Copyright (c) 2018-2024 STMicroelectronics.
+ * All rights reserved.
+ *
+ * This software is licensed under terms that can be found in the LICENSE file
+ * in the root directory of this software component.
+ * If no LICENSE file comes with this software, it is provided AS-IS.
+ *
+ *****************************************************************************
+ */
+
+#include "baes_global.h"
+
+/*****************************************************************************/
+
+/* ---------------------------------------------------------------------------
+ *  Byte/word manipulation macro definitions
+ * ---------------------------------------------------------------------------
+ */
+
+/* Returns the least significant byte from a word */
+#define BYTE0(w)               ((uint8_t)((w) >>  0))
+
+/* Returns the second least significant byte from a word */
+#define BYTE1(w)               ((uint8_t)((w) >>  8))
+
+/* Macro to set a 16-bit word into a byte table in big endian */
+#define SET_U16_BE( b, i, v )  M_BEGIN uint16_t v_ = (uint16_t)(v); \
+                                       uint8_t *b_ = &((uint8_t*)(b))[i]; \
+                                       b_[1] = BYTE0(v_); \
+                                       b_[0] = BYTE1(v_); M_END
+
+int BAES_CcmCrypt( uint8_t mode,
+                   const uint8_t* key,
+                   uint8_t iv_length,
+                   const uint8_t* iv,
+                   uint16_t add_length,
+                   const uint8_t* add,
+                   uint16_t input_length,
+                   const uint8_t* input,
+                   uint8_t tag_length,
+                   uint8_t* tag,
+                   uint8_t* output )
+{
+#if CFG_BAES_SW == 0
+
+  /* This implementation of AES CCM only supports HW AES and it also only
+   * supports the following range for input parameters:
+   *  - tag_length: 4..16 (multiple of 2)
+   *  - iv_length:  7..13
+   *  - add_length: 1..14
+   */
+  uint32_t left_len, b0[4], bx[4];
+  uint8_t len, *b;
+
+  /* Build B0 */
+  b = (uint8_t*)b0;
+  memset( b0, 0, 16 );
+  b[0] = (1U << 6) | (((tag_length - 2) / 2) << 3) | (14U - iv_length);
+  memcpy( b + 1, iv, iv_length );
+  SET_U16_BE( b, 14, input_length );
+
+  /* Build B1 */
+  b = (uint8_t*)bx;
+  memset( bx, 0, 16 );
+  b[1] = add_length;
+  memcpy( b + 2, add, add_length );
+
+  /* Start CCM process with Init and Header phases */
+  HW_AES_Enable( );
+  HW_AES_InitCcm( mode, key, b0, bx );
+
+  /* Continue CCM process with Payload Phase */
+  left_len = input_length;
+  while ( left_len > 0 )
+  {
+    len = 16;
+    if ( left_len < 16 )
+    {
+      len = (uint8_t)left_len;
+      memset( bx, 0, 16 );
+
+      if ( mode )
+        HW_AES_SetLast( len );
+    }
+
+    memcpy( b, input, len );
+    HW_AES_Crypt( bx, bx );
+    memcpy( output, b, len );
+    input += len;
+    output += len;
+    left_len -= len;
+  }
+
+  /* End CCM process with Final Phase */
+  HW_AES_EndCcm( tag_length, mode ? b : tag );
+  HW_AES_Disable( );
+
+  /* Verification of the tag in case of decryption */
+  if ( mode )
+  {
+    uint8_t diff = 0;
+    for ( int i = 0; i < tag_length; i++ )
+      diff |= tag[i] ^ b[i];
+
+    return (int)diff;
+  }
+
+#endif /* CFG_BAES_SW == 0 */
+
+  return 0;
+}
+
+/*****************************************************************************/