STM32CubeU5

https://github.com/stmicroelectronics/stm32cubeu5
Admin
STM32CubeU5 is an embedded software platform for STM32U5 microcontrollers that includes HAL/LL...
Tokens:290,855
Snippets:4,687
Trust Score:9.8
Update:3 months ago
Show doc for...
Tokens:
Raw
### Install AppliCfg dependencies

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Utilities/PC_Software/ROT_AppliConfig/README.md

Run the setup script to install all required Python module dependencies.

```bash
python setup.py install
```

--------------------------------

### CMake Configuration Examples

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/NN/README.md

Additional examples for configuring CMSIS-NN builds with different toolchains and target CPUs.

```bash
cmake .. -DCMAKE_TOOLCHAIN_FILE=~/ethos-u-core-platform/cmake/toolchain/arm-none-eabi-gcc.cmake -DTARGET_CPU=cortex-m55
cmake .. -DCMAKE_TOOLCHAIN_FILE=~/ethos-u-core-platform/cmake/toolchain/arm-none-eabi-gcc.cmake -DTARGET_CPU=cortex-m7
cmake .. -DCMAKE_TOOLCHAIN_FILE=~/ethos-u-core-platform/cmake/toolchain/armclang.cmake -DTARGET_CPU=cortex-m3
```

--------------------------------

### Library and Executable Setup

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Examples/ARM/arm_bayes_example/CMakeLists.txt

Adds the DSP subdirectory and configures the test application executable.

```cmake
add_subdirectory(../../../Source bin_dsp)


################################### 
#
# TEST APPLICATION
#
###################################


add_executable(arm_bayes_example)


include(config)
configApp(arm_bayes_example ${ROOT})

target_sources(arm_bayes_example PRIVATE arm_bayes_example_f32.c)

### Sources and libs

target_link_libraries(arm_bayes_example PRIVATE CMSISDSP)
```

--------------------------------

### Binary File Renaming Examples

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Utilities/PC_Software/ROT_AppliConfig/README.md

Examples of file path and name modifications required for different project configurations.

```text
rot_tz_s_app_enc_sign.hex --> rot_tz_s_app_sign.hex
```

```text
ROT_Appli_TrustZone/EWARM/Secure/STM32H573I-DK_S/Exe/Project.bin --> ROT_Appli_TrustZone/EWARM/Binary/rot_app.bin
```

```text
rot_tz_ns_app_enc_sign.hex to --> rot_tz_app_enc_sign.hex
```

--------------------------------

### Library and Executable Setup

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Examples/ARM/arm_svm_example/CMakeLists.txt

Adds the DSP subdirectory, defines the executable, and links the necessary libraries.

```cmake
add_subdirectory(../../../Source bin_dsp)

add_executable(arm_svm_example)

include(config)
configApp(arm_svm_example ${ROOT})

target_sources(arm_svm_example PRIVATE arm_svm_example_f32.c)

target_link_libraries(arm_svm_example PRIVATE CMSISDSP)
```

--------------------------------

### Library and Executable Setup

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Examples/ARM/arm_fft_bin_example/CMakeLists.txt

Adds the CMSIS-DSP subdirectory and defines the test application executable.

```cmake
add_subdirectory(../../../Source bin_dsp)


################################### 
#
# TEST APPLICATION
#
###################################


add_executable(arm_fft_bin_example)
```

--------------------------------

### XML parameter structure examples

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Utilities/PC_Software/ROT_AppliConfig/README.md

Examples of the XML structure for parameters being removed or added.

```xml
	<Param>
		<Name>Encryption key</Name>
      ....
        ....
	</Param>
```

```xml
	<Param>
		<Name>Encryption key</Name>
		<Link>GetPublic</Link>
		<Type>File</Type>
		<Command>-E</Command>
		<Hidden>0</Hidden>
	</Param>
```

--------------------------------

### XML Configuration Parameters

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Utilities/PC_Software/ROT_AppliConfig/README.md

Example of XML parameter blocks before and after processing by the iofile utility.

```xml
	<Param>
		<Name>Encryption key</Name>
		<Link>GetPublic</Link>
		<Type>File</Type>
		<Command>-E</Command>
		<Enable>1</Enable>
		<Hidden>1</Hidden>
		<Default></Default>
	</Param>
	<Param>
		<Name>Firmware binary input file</Name>
		<Value>../../ROT_Appli_TrustZone/EWARM/NonSecure/STM32H573I-DK_NS/Exe/Project.bin</Value>
		<Type>File</Type>
		<Default>../../ROT_Appli_TrustZone/EWARM/NonSecure/STM32H573I-DK_NS/Exe/Project.bin</Default>
		<Tooltip>Select the firmware binary file to be processed for the image generation</Tooltip>
	</Param>
	<Output>
		<Name>Image output file</Name>
		<Value>../../ROT_Appli_TrustZone/Binary/rot_tz_ns_app_enc_sign.he</Value>
		<Default>../../ROT_Appli_TrustZone/Binary/rot_tz_ns_app_enc_sign.hex</Default>
	</Output>
```

```xml
	<Param>
		<Name>Encryption key</Name>
		<Link>GetPublic</Link>
		<Type>File</Type>
		<Command>-E</Command>
		<Enable>0</Enable>
		<Hidden>1</Hidden>
		<Default></Default>
	</Param>
	<Param>
		<Name>Firmware binary input file</Name>
		<Value>../../ROT_Appli_TrustZone/Binary/rot_app.bin</Value>
		<Type>File</Type>
		<Default>../../ROT_Appli_TrustZone/EWARM/NonSecure/STM32H573I-DK_NS/Exe/Project.bin</Default>
		<Tooltip>Select the firmware binary file to be processed for the image generation</Tooltip>
	</Param>
	<Output>
		<Name>Image output file</Name>
		<Value>../../ROT_Appli_TrustZone/Binary/rot_tz_app_enc_sign.hex</Value>
		<Default>../../ROT_Appli_TrustZone/Binary/rot_tz_ns_app_enc_sign.hex</Default>
	</Output>
```

--------------------------------

### Example file and configuration data

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Utilities/PC_Software/ROT_AppliConfig/README.md

Sample content for CSV and XML files used during the file modification process.

```csv
OPTSR_PRG,0x30f0edf8
```

```xml
<List>
    <Name>Product state minimal allowed</Name>
    <Value>0xC6</Value>
    .....
    ....
</List>
```

```text
8
```

```csv
OPTSR_PRG,0x30f0c6f8
```

--------------------------------

### Execute iofile Configuration

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Utilities/PC_Software/ROT_AppliConfig/README.md

Command-line example for processing binary files using the iofile utility with specific layout and macro arguments.

```bash
iofile --layout image_macros_preprocessed_bl2.c -mi RE_APP_IMAGE_NUMBER -me RE_ENCRYPTION --xml OEMiRoT_NonSecure_Code.xml -in "Firmware binary input file" -i ../../ROT_Appli_TrustZone/Binary/rot_app.bin -on "Image output file" -en "Encryption key" -b ns_code_image ob_flash_programming.bat
```

--------------------------------

### Library and Executable Setup

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Examples/ARM/arm_graphic_equalizer_example/CMakeLists.txt

Adds the CMSIS-DSP subdirectory, defines the executable, and links required source files and libraries.

```cmake
################################### 
#
# LIBRARIES
#
###################################

########### 
#
# CMSIS DSP
#

add_subdirectory(../../../Source bin_dsp)


################################### 
#
# TEST APPLICATION
#
###################################


add_executable(arm_graphic_equalizer_example)


include(config)
configApp(arm_graphic_equalizer_example ${ROOT})

target_sources(arm_graphic_equalizer_example PRIVATE math_helper.c arm_graphic_equalizer_data.c arm_graphic_equalizer_example_q31.c)

### Sources and libs

target_link_libraries(arm_graphic_equalizer_example PRIVATE CMSISDSP)
```

--------------------------------

### Install PyInstaller

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Utilities/PC_Software/ROT_AppliConfig/README.md

Commands to install the PyInstaller dependency for different Python environments.

```bash
pip install pyinstaller
```

```bash
python3 -m pip install pyinstaller
```

--------------------------------

### CMake project configuration for CMSIS-DSP example

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Examples/ARM/arm_class_marks_example/CMakeLists.txt

Sets up the project environment, includes the CMSIS-DSP library, and defines the executable target.

```cmake
cmake_minimum_required (VERSION 3.14)
project (arm_class_marks_example VERSION 0.1)


# Needed to include the configBoot module
# Define the path to CMSIS-DSP (ROOT is defined on command line when using cmake)
set(ROOT ${CMAKE_CURRENT_SOURCE_DIR}/../../../../..)
set(DSP ${ROOT}/CMSIS/DSP)

# Add DSP folder to module path
list(APPEND CMAKE_MODULE_PATH ${DSP})

################################### 
#
# LIBRARIES
#
###################################

########### 
#
# CMSIS DSP
#

add_subdirectory(../../../Source bin_dsp)


################################### 
#
# TEST APPLICATION
#
###################################


add_executable(arm_class_marks_example)


include(config)
configApp(arm_class_marks_example ${ROOT})

target_sources(arm_class_marks_example PRIVATE arm_class_marks_example_f32.c)

### Sources and libs

target_link_libraries(arm_class_marks_example PRIVATE CMSISDSP)
```

--------------------------------

### CMake Configuration for ARM Matrix Example

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Examples/ARM/arm_matrix_example/CMakeLists.txt

Defines the project, sets up module paths for CMSIS-DSP, and configures the executable build process.

```cmake
cmake_minimum_required (VERSION 3.14)
project (arm_matrix_example VERSION 0.1)


# Needed to include the configBoot module
# Define the path to CMSIS-DSP (ROOT is defined on command line when using cmake)
set(ROOT ${CMAKE_CURRENT_SOURCE_DIR}/../../../../..)
set(DSP ${ROOT}/CMSIS/DSP)

# Add DSP folder to module path
list(APPEND CMAKE_MODULE_PATH ${DSP})

################################### 
#
# LIBRARIES
#
###################################

########### 
#
# CMSIS DSP
#

add_subdirectory(../../../Source bin_dsp)


################################### 
#
# TEST APPLICATION
#
###################################


add_executable(arm_matrix_example)


include(config)
configApp(arm_matrix_example ${ROOT})

target_sources(arm_matrix_example PRIVATE math_helper.c arm_matrix_example_f32.c)

### Sources and libs

target_link_libraries(arm_matrix_example PRIVATE CMSISDSP)
```

--------------------------------

### CMake Configuration for Linear Interpolation Example

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Examples/ARM/arm_linear_interp_example/CMakeLists.txt

Defines the project, sets up CMSIS-DSP paths, adds the DSP library, and configures the executable target.

```cmake
cmake_minimum_required (VERSION 3.14)
project (arm_linear_interp_example VERSION 0.1)


# Needed to include the configBoot module
# Define the path to CMSIS-DSP (ROOT is defined on command line when using cmake)
set(ROOT ${CMAKE_CURRENT_SOURCE_DIR}/../../../../..)
set(DSP ${ROOT}/CMSIS/DSP)

# Add DSP folder to module path
list(APPEND CMAKE_MODULE_PATH ${DSP})

################################### 
#
# LIBRARIES
#
###################################

########### 
#
# CMSIS DSP
#

add_subdirectory(../../../Source bin_dsp)


################################### 
#
# TEST APPLICATION
#
###################################


add_executable(arm_linear_interp_example)


include(config)
configApp(arm_linear_interp_example ${ROOT})

target_sources(arm_linear_interp_example PRIVATE math_helper.c arm_linear_interp_data.c arm_linear_interp_example_f32.c)

### Sources and libs

target_link_libraries(arm_linear_interp_example PRIVATE CMSISDSP)
```

--------------------------------

### CMake Configuration for ARM FIR Example

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Examples/ARM/arm_fir_example/CMakeLists.txt

Defines the project, sets up paths for CMSIS-DSP, adds the DSP library subdirectory, and configures the executable target.

```cmake
cmake_minimum_required (VERSION 3.14)
project (arm_fir_example VERSION 0.1)


# Needed to include the configBoot module
# Define the path to CMSIS-DSP (ROOT is defined on command line when using cmake)
set(ROOT ${CMAKE_CURRENT_SOURCE_DIR}/../../../../..)
set(DSP ${ROOT}/CMSIS/DSP)

# Add DSP folder to module path
list(APPEND CMAKE_MODULE_PATH ${DSP})

################################### 
#
# LIBRARIES
#
###################################

########### 
#
# CMSIS DSP
#

add_subdirectory(../../../Source bin_dsp)


################################### 
#
# TEST APPLICATION
#
###################################


add_executable(arm_fir_example)


include(config)
configApp(arm_fir_example ${ROOT})

target_sources(arm_fir_example PRIVATE arm_fir_data.c math_helper.c arm_fir_example_f32.c)

### Sources and libs

target_link_libraries(arm_fir_example PRIVATE CMSISDSP)
```

--------------------------------

### MQTT Client Console Output

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/NetXDuo/Nx_MQTT_Client/README.md

Example output displayed on the HyperTerminal showing successful connection, message reception, and disconnection.

```text
MQTT client connected to broker < broker.hivemq.com > at PORT 8883 :
Message 1 received: TOPIC = Temperature, MESSAGE = 34
Message 2 received: TOPIC = Temperature, MESSAGE = 35
Message 3 received: TOPIC = Temperature, MESSAGE = 35
Message 4 received: TOPIC = Temperature, MESSAGE = 34
Message 5 received: TOPIC = Temperature, MESSAGE = 33
client disconnected from server
```

--------------------------------

### Identify Board Specific Configuration Tags

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/STM32U5x9J-DK/Templates_LL/TrustZoneDisabled/README.md

Use these tags to delineate board-specific code when porting LL examples to the template.

```c
/* ==============   BOARD SPECIFIC CONFIGURATION CODE BEGIN    ============== */

/* ==============   BOARD SPECIFIC CONFIGURATION CODE END      ============== */
```

--------------------------------

### Identify Board Specific Configuration Tags

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/NUCLEO-U5A5ZJ-Q/Templates_LL/TrustZoneDisabled/readme.html

Use these tags to delineate code that must be preserved when porting LL examples to the target board.

```c
/* ============== BOARD SPECIFIC CONFIGURATION CODE BEGIN ============== */

/* ============== BOARD SPECIFIC CONFIGURATION CODE END ============== */
```

--------------------------------

### CMake Configuration for ARM Convolution Example

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Examples/ARM/arm_convolution_example/CMakeLists.txt

Defines the project requirements, includes the CMSIS-DSP library, and configures the executable target with necessary source files and dependencies.

```cmake
cmake_minimum_required (VERSION 3.14)
project (arm_convolution_example VERSION 0.1)


# Needed to include the configBoot module
# Define the path to CMSIS-DSP (ROOT is defined on command line when using cmake)
set(ROOT ${CMAKE_CURRENT_SOURCE_DIR}/../../../../..)
set(DSP ${ROOT}/CMSIS/DSP)

# Add DSP folder to module path
list(APPEND CMAKE_MODULE_PATH ${DSP})

################################### 
#
# LIBRARIES
#
###################################

########### 
#
# CMSIS DSP
#

add_subdirectory(../../../Source bin_dsp)


################################### 
#
# TEST APPLICATION
#
###################################


add_executable(arm_convolution_example)


include(config)
configApp(arm_convolution_example ${ROOT})

target_sources(arm_convolution_example PRIVATE arm_convolution_example_f32.c math_helper.c)

### Sources and libs

target_link_libraries(arm_convolution_example PRIVATE CMSISDSP)
```

--------------------------------

### Add CMSIS-DSP Library and Application Executable

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Examples/ARM/arm_dotproduct_example/CMakeLists.txt

Adds the CMSIS-DSP library subdirectory and defines the executable target for the dot product example.

```cmake
################################### 
#
# LIBRARIES
#
###################################

########### 
#
# CMSIS DSP
#

add_subdirectory(../../../Source bin_dsp)


################################### 
#
# TEST APPLICATION
#
###################################


add_executable(arm_dotproduct_example)


include(config)
configApp(arm_dotproduct_example ${ROOT})

target_sources(arm_dotproduct_example PRIVATE arm_dotproduct_example_f32.c)

### Sources and libs

target_link_libraries(arm_dotproduct_example PRIVATE CMSISDSP)
```

--------------------------------

### Display AppliCfg help

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Utilities/PC_Software/ROT_AppliConfig/README.md

Access the command-line help interface for the tool.

```bash
python AppliCfg.py --help
```

--------------------------------

### Display success message

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/NetXDuo/Nx_TCP_Echo_Client/README.md

Example output printed on the HyperTerminal upon successful packet transmission.

```text
  SUCCESS : 100 / 100 packets sent
```

--------------------------------

### Initialize CMSIS DSP Fast Math Library

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/FastMathFunctions/CMakeLists.txt

Sets up the library target and includes necessary configuration modules.

```cmake
cmake_minimum_required (VERSION 3.14)

project(CMSISDSPFastMath)

include(configLib)
include(configDsp)


add_library(CMSISDSPFastMath STATIC)
configLib(CMSISDSPFastMath ${ROOT})
configDsp(CMSISDSPFastMath ${ROOT})

include(interpol)
interpol(CMSISDSPFastMath)
```

--------------------------------

### EchoTool Console Output

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/NetXDuo/Nx_TCP_Echo_Server/README.md

Example output observed on the console when using the EchoTool utility to communicate with the server.

```text
Reply from 192.168.1.2:6000, time 47 ms OK
Reply from 192.168.1.2:6000, time 42 ms OK
Reply from 192.168.1.2:6000, time 44 ms OK
Reply from 192.168.1.2:6000, time 46 ms OK
Reply from 192.168.1.2:6000, time 47 ms OK
```

--------------------------------

### Initialize CMSIS DSP Controller Library

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/ControllerFunctions/CMakeLists.txt

Sets up the project requirements, library definition, and configuration modules.

```cmake
cmake_minimum_required (VERSION 3.14)

project(CMSISDSPController)

include(configLib)
include(configDsp)

add_library(CMSISDSPController STATIC)

configLib(CMSISDSPController ${ROOT})
configDsp(CMSISDSPController ${ROOT})

include(interpol)
interpol(CMSISDSPController)
```

--------------------------------

### Initialize CMSIS-DSP Complex Math Library

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/ComplexMathFunctions/CMakeLists.txt

Sets up the project, includes configuration modules, and defines the static library target.

```cmake
cmake_minimum_required (VERSION 3.14)

project(CMSISDSPComplexMath)

include(configLib)
include(configDsp)

add_library(CMSISDSPComplexMath STATIC)

configLib(CMSISDSPComplexMath ${ROOT})
configDsp(CMSISDSPComplexMath ${ROOT})


include(interpol)
interpol(CMSISDSPComplexMath)
```

--------------------------------

### Clone the repository with submodules

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/README.md

Use this command to clone the repository and initialize all linked submodules.

```bash
git clone --recursive https://github.com/STMicroelectronics/STM32CubeU5.git
```

--------------------------------

### Execute Device Initialization Regression Script

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/SBSFU/README.md

Run the appropriate regression script for your toolchain to initialize the device using STM32CubeProgrammer CLI.

```text
    EWARM:        SBSFU_Boot\EWARM\regression.bat
    MDK-ARM:      SBSFU_Boot\MDK-ARM\regression.bat
    STM32CubeIDE: SBSFU_Boot\STM32CubeIDE\regression.sh
```

--------------------------------

### Configure Wi-Fi and Network Settings

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/NetXDuo/Nx_UDP_Echo_Client/README.md

Update the Wi-Fi credentials and server port in the specified header files before building the application.

```c
Core/Inc/mx_wifi_conf.h
```

```c
NetXDuo/App/app_netxduo.h
```

--------------------------------

### Initialize CMSIS DSP Filtering Library

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/FilteringFunctions/CMakeLists.txt

Sets up the project, includes configuration modules, and defines the static library target.

```cmake
cmake_minimum_required (VERSION 3.14)

project(CMSISDSPFiltering)

include(configLib)
include(configDsp)

add_library(CMSISDSPFiltering STATIC)

include(interpol)
interpol(CMSISDSPFiltering)

configLib(CMSISDSPFiltering ${ROOT})
configDsp(CMSISDSPFiltering ${ROOT})
```

--------------------------------

### Include Configuration Module

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/CMakeLists.txt

Includes the external configuration library.

```cmake
include(configLib)
```

--------------------------------

### CMake Project Configuration

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Examples/ARM/arm_bayes_example/CMakeLists.txt

Initializes the CMake project and defines the minimum required version.

```cmake
cmake_minimum_required (VERSION 3.14)
project (arm_bayes_example VERSION 0.1)
```

--------------------------------

### Checkout a specific firmware version

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/README.md

Switch to a specific tagged version after cloning or updating the repository.

```bash
git checkout vX.Y.Z # Specify the targeted vX.Y.Z version
```

--------------------------------

### Configure Library and Includes

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/InterpolationFunctions/CMakeLists.txt

Applies library configuration and sets the public include directories for the interpolation module.

```cmake
configLib(CMSISDSPInterpolation ${ROOT})
configDsp(CMSISDSPInterpolation ${ROOT})

### Includes
target_include_directories(CMSISDSPInterpolation PUBLIC "${DSP}/Include")
```

--------------------------------

### Configure Build Definitions

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/ComplexMathFunctions/CMakeLists.txt

Applies preprocessor definitions based on table availability and hardware acceleration features.

```cmake
if (CONFIGTABLE AND ALLFAST)
    target_compile_definitions(CMSISDSPComplexMath PUBLIC ARM_ALL_FAST_TABLES)  
endif()

# Vectorized code is defining sqrt
# so fast tables required even if Fast Math not built.
if (CONFIGTABLE AND (HELIUM OR MVEF OR MVEI))
    target_compile_definitions(CMSISDSPComplexMath PUBLIC ARM_FAST_ALLOW_TABLES)  
endif()
```

--------------------------------

### Application Configuration and Linking

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Examples/ARM/arm_fft_bin_example/CMakeLists.txt

Includes configuration scripts, adds source files, and links the CMSISDSP library.

```cmake
include(config)
configApp(arm_fft_bin_example ${ROOT})

target_sources(arm_fft_bin_example PRIVATE arm_fft_bin_data.c arm_fft_bin_example_f32.c)

### Sources and libs

target_link_libraries(arm_fft_bin_example PRIVATE CMSISDSP)
```

--------------------------------

### Configure CMSIS-DSP Statistics Library

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/StatisticsFunctions/CMakeLists.txt

Initializes the library project and includes necessary configuration modules.

```cmake
cmake_minimum_required (VERSION 3.14)

project(CMSISDSPStatistics)

include(configLib)
include(configDsp)
```

--------------------------------

### Run EchoTool Utility

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/NetXDuo/Nx_UDP_Echo_Client/README.md

Execute the EchoTool utility on a Windows console to act as the UDP server.

```bash
c:\> .\echotool.exe /p udp /s <UDP_SERVER_PORT>
```

```bash
example : c:\> .\echotool.exe /p udp /s 6000
```

--------------------------------

### Define Build Options

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/CMakeLists.txt

Configures build-time flags for hardware acceleration and optimization features.

```cmake
option(NEON "Neon acceleration" OFF)
option(NEONEXPERIMENTAL "Neon experimental acceleration" OFF)
option(HELIUMEXPERIMENTAL "Helium experimental acceleration" OFF)
option(LOOPUNROLL "Loop unrolling" ON)
option(ROUNDING "Rounding" OFF)
option(MATRIXCHECK "Matrix Checks" OFF)
option(HELIUM "Helium acceleration (MVEF and MVEI supported)" OFF)
option(MVEF "MVEF intrinsics supported" OFF)
option(MVEI "MVEI intrinsics supported" OFF)
option(MVEFLOAT16 "Float16 MVE intrinsics supported" OFF)
option(DISABLEFLOAT16 "Disable building float16 kernels" OFF)
option(HOST "Build for host" OFF)
```

--------------------------------

### Configure CMake Project and CMSIS-DSP Paths

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Examples/ARM/arm_dotproduct_example/CMakeLists.txt

Initializes the project and sets the necessary paths for the CMSIS-DSP library modules.

```cmake
cmake_minimum_required (VERSION 3.14)
project (arm_dotproduct_example VERSION 0.1)


# Needed to include the configBoot module
# Define the path to CMSIS-DSP (ROOT is defined on command line when using cmake)
set(ROOT ${CMAKE_CURRENT_SOURCE_DIR}/../../../../..)
set(DSP ${ROOT}/CMSIS/DSP)

# Add DSP folder to module path
list(APPEND CMAKE_MODULE_PATH ${DSP})
```

--------------------------------

### Configure STM32CubeIDE Linker for ThreadX

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/FileX/Fx_NoR_Write_Read_File/README.md

Define a new heap section in the .ld file to provide memory for ThreadX.

```text
._threadx_heap :
  {
     . = ALIGN(8);
     __RAM_segment_used_end__ = .;
     . = . + 64K;
     . = ALIGN(8);
   } >RAM_D1 AT> RAM_D1
```

--------------------------------

### Configure FileX for Standalone Mode

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/NUCLEO-U545RE-Q/Applications/FileX/Fx_File_Edit_Standalone/README.md

Required preprocessor definitions in fx_user.h to enable standalone operation without ThreadX.

```c
#define FX_SINGLE_THREAD
#define FX_STANDALONE_ENABLE
```

--------------------------------

### Flash Web Content Command

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/NetXDuo/Nx_WebServer/README.md

Command to flash the web demo binary to the OctoSPI flash memory using the STM32CubeProgrammer CLI.

```bash
<INSTALL_PATH>/STM32_Programmer_CLI.exe -c port=swd -w "Web_Content/web_demo.bin" 0x70000000 -v -el "<INSTALL_PATH>/STM32CubeProgrammer/bin/ExternalLoader/MX25LM51245G_STM32U585I-IOT02A.stldr"
```

--------------------------------

### Configure Number of Application Images

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/SBSFU/README.md

Sets the number of application images managed by the bootloader.

```c
#define MCUBOOT_APP_IMAGE_NUMBER 1 /* 1: S and NS application binaries are assembled in one single image.
                                      2: Two separated images for S and NS application binaries. */
```

--------------------------------

### Configure Board Role via Preprocessor Definition

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/NUCLEO-U545RE-Q/Examples/USART/USART_SlaveMode_DMA/readme.html

Toggle the SLAVE_BOARD definition to switch between Master and Slave firmware configurations before building.

```c
#define SLAVE_BOARD
```

--------------------------------

### Configure MDK-ARM Linker for ThreadX

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/USBPD/USBPD_SNK_UX_Device_HID_CDC_ACM/README.md

Define the memory region or update the initialization file to match the required memory layout.

```text
either define the RW_IRAM1 region in the ".sct" file
or modify the line below in "tx_low_level_initilize.s to match the memory region being used
    LDR r1, =|Image$$RW_IRAM1$$ZI$$Limit|
```

--------------------------------

### Configure CMSIS-DSP Matrix Library Build

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/MatrixFunctions/CMakeLists.txt

Initializes the project, includes configuration modules, and collects source files for various data types.

```cmake
cmake_minimum_required (VERSION 3.14)

project(CMSISDSPMatrix)

include(configLib)
include(configDsp)

file(GLOB SRCF64 "./*_f64.c")
file(GLOB SRCF32 "./*_f32.c")
file(GLOB SRCF16 "./*_f16.c")
file(GLOB SRCQ31 "./*_q31.c")
file(GLOB SRCQ15 "./*_q15.c")
file(GLOB SRCQ7  "./*_q7.c")

file(GLOB SRCU32 "./*_u32.c")
file(GLOB SRCU16 "./*_u16.c")
file(GLOB SRCU8  "./*_u8.c")

add_library(CMSISDSPMatrix STATIC ${SRCF64})
target_sources(CMSISDSPMatrix PRIVATE ${SRCF32})

if ((NOT ARMAC5) AND (NOT DISABLEFLOAT16))
target_sources(CMSISDSPMatrix PRIVATE ${SRCF16})
endif()

target_sources(CMSISDSPMatrix PRIVATE ${SRCQ31})
target_sources(CMSISDSPMatrix PRIVATE ${SRCQ15})
target_sources(CMSISDSPMatrix PRIVATE ${SRCQ7})

target_sources(CMSISDSPMatrix PRIVATE ${SRCU32})
target_sources(CMSISDSPMatrix PRIVATE ${SRCU16})
target_sources(CMSISDSPMatrix PRIVATE ${SRCU8})

configLib(CMSISDSPMatrix ${ROOT})
configDsp(CMSISDSPMatrix ${ROOT})
```

--------------------------------

### Configure EWARM Linker for ThreadX

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/FileX/Fx_NoR_Write_Read_File/README.md

Add the FREE_MEM section to the .icf file to support dynamic memory allocation.

```text
place in RAM_region    { last section FREE_MEM };
```

--------------------------------

### Configure CMSIS-DSP Transform Library

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/TransformFunctions/CMakeLists.txt

Initializes the library target and includes necessary configuration modules.

```cmake
cmake_minimum_required (VERSION 3.14)

project(CMSISDSPTransform)

include(configLib)
include(configDsp)

add_library(CMSISDSPTransform STATIC)
configLib(CMSISDSPTransform ${ROOT})
configDsp(CMSISDSPTransform ${ROOT})

include(fft)
fft(CMSISDSPTransform)
```

--------------------------------

### Configure Image Upgrade Strategy

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/SBSFU/README.md

Selects between overwrite-based or swap-based image upgrade methods.

```c
#define MCUBOOT_OVERWRITE_ONLY     /* Defined: the FW installation uses overwrite method.
                                      UnDefined: The FW installation uses swap mode. */
```

--------------------------------

### Use Default USART Interface Commands

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/OpenBootloader/README.md

Initialize the USART handle by retrieving the default command list provided by the middleware.

```c
        /* Register USART interfaces */
        USART_Handle.p_Ops = &USART_Ops;
        USART_Handle.p_Cmd = OPENBL_USART_GetCommandsList();  /* Initialize the USART handle with the default list osupported commands */
```

--------------------------------

### Hardware-Specific Source Configuration

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/CommonTables/CMakeLists.txt

Conditionally adds source files based on NEON or Helium/MVE hardware support.

```cmake
if (NEON OR NEONEXPERIMENTAL)
    target_sources(CMSISDSPCommon PRIVATE "${DSP}/ComputeLibrary/Source/arm_cl_tables.c")
endif()

if (HELIUM OR MVEF)
    target_sources(CMSISDSPCommon PRIVATE "${DSP}/Source/CommonTables/arm_mve_tables.c")
    target_sources(CMSISDSPCommon PRIVATE "${DSP}/Source/CommonTables/arm_mve_tables_f16.c")
endif()
```

--------------------------------

### Build executable with PyInstaller

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Utilities/PC_Software/ROT_AppliConfig/README.md

Generates the application executable in the dist folder using the specified configuration.

```bash
pyinstaller AppliCfg.py --onedir --name AppliCfg
```

--------------------------------

### Define Test Application Target

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Examples/ARM/arm_variance_example/CMakeLists.txt

Creates the executable target and configures its sources and library dependencies.

```cmake
add_executable(arm_variance_example)


include(config)
configApp(arm_variance_example ${ROOT})

target_sources(arm_variance_example PRIVATE arm_variance_example_f32.c)

### Sources and libs

target_link_libraries(arm_variance_example PRIVATE CMSISDSP)
```

--------------------------------

### Configure CMSIS-DSP Bayes Library

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/BayesFunctions/CMakeLists.txt

Initializes the library project, includes configuration modules, and defines the static library target.

```cmake
cmake_minimum_required (VERSION 3.14)

project(CMSISDSPBayes)

include(configLib)
include(configDsp)

file(GLOB SRC "./*_*.c")

add_library(CMSISDSPBayes STATIC)

target_sources(CMSISDSPBayes PRIVATE arm_gaussian_naive_bayes_predict_f32.c)

configLib(CMSISDSPBayes ${ROOT})
configDsp(CMSISDSPBayes ${ROOT})
```

--------------------------------

### Define CMSIS DSP Support Library

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/SupportFunctions/CMakeLists.txt

Initializes the library project, includes configuration modules, and adds source files using globbing.

```cmake
cmake_minimum_required (VERSION 3.14)

project(CMSISDSPSupport)

include(configLib)
include(configDsp)

file(GLOB SRC "./*_*.c")

add_library(CMSISDSPSupport STATIC ${SRC})

configLib(CMSISDSPSupport ${ROOT})
configDsp(CMSISDSPSupport ${ROOT})
```

--------------------------------

### Configure MDK-ARM Linker for ThreadX

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/FileX/Fx_NoR_Write_Read_File/README.md

Define the RW_IRAM1 region in the .sct file or update the memory limit pointer in tx_initialize_low_level.S.

```text
either define the RW_IRAM1 region in the ".sct" file
or modify the line below in "tx_initialize_low_level.S to match the memory region being used
    LDR r1, =|Image$$RW_IRAM1$$ZI$$Limit|
```

--------------------------------

### Configure Number of Images and Data Images

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/SBSFU/readme.html

Defines the number of application and data images managed by the bootloader.

```c
#define MCUBOOT_APP_IMAGE_NUMBER 1 /* 1: S and NS application binaries are assembled in one single image.
                                      2: Two separated images for S and NS application binaries. */

#define MCUBOOT_S_DATA_IMAGE_NUMBER 1   /* 1: S data image for S application.
                                           0: No S data image. */

#define MCUBOOT_NS_DATA_IMAGE_NUMBER 1  /* 1: NS data image for NS application.
                                           0: No NS data image. */
```

--------------------------------

### Add Source Files and Include Directories

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/CommonTables/CMakeLists.txt

Registers additional source files and sets the public include directory for the library.

```cmake
target_sources(CMSISDSPCommon PRIVATE arm_const_structs.c)
target_sources(CMSISDSPCommon PRIVATE arm_const_structs_f16.c)


### Includes
target_include_directories(CMSISDSPCommon PUBLIC "${DSP}/Include")
```

--------------------------------

### Generate and Convert MQTT TLS Certificates

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/NetXDuo/Nx_MQTT_Client/README.md

Commands to retrieve a broker certificate chain, convert it to DER format, and generate a C header file for inclusion in the project.

```bash
openssl s_client -showcerts -servername broker.hivemq.com -connect broker.hivemq.com:8883 < NUL
```

```bash
openssl x509 -in starfield_services_root_ca_g2.pem -outform DER -out starfield_services_root_ca_g2.der
```

```bash
xxd -i starfield_services_root_ca_g2.der > starfield_services_root_ca_g2.cert.h
```

--------------------------------

### Configure MDK-ARM linker file

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/NetXDuo/Nx_TCP_Echo_Client/README.md

Modify the memory region definition or the tx_initialize_low_level.S file for MDK-ARM.

```text
    either define the RW_IRAM1 region in the ".sct" file
    or modify the line below in "tx_initialize_low_level.S to match the memory region being used
        LDR r1, =|Image$$RW_IRAM1$$ZI$$Limit|
```

--------------------------------

### CMSIS-NN CMake Configuration

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/NN/CMakeLists.txt

Initializes the project, sets the CMSIS path, and conditionally includes the source subdirectory based on the BUILD_CMSIS_NN_FUNCTIONS option.

```cmake
cmake_minimum_required(VERSION 3.15.6)

project(CMSISNN)

set(CMSIS_PATH "${CMAKE_CURRENT_SOURCE_DIR}/../..")

option(BUILD_CMSIS_NN_FUNCTIONS "Build CMSIS-NN Source." ON)

if(BUILD_CMSIS_NN_FUNCTIONS)
    add_subdirectory(Source)
endif()
```

--------------------------------

### Configure SNTP Client Parameters

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/NetXDuo/Nx_SNTP_Client/README.md

Adjust these definitions in nx_user.h if the default values are incompatible with specific SNTP servers.

```c
#define NX_SNTP_CLIENT_MAX_ROOT_DISPERSION    500000

#define NX_SNTP_CLIENT_MIN_SERVER_STRATUM     5
```

--------------------------------

### Run EchoTool Utility

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/NetXDuo/Nx_TCP_Echo_Server/README.md

Command line usage for the echotool utility to test the TCP echo server connection.

```bash
c:\> echotool.exe  <the board IP address> /p tcp  /r  <DEFAULT_PORT> /n 10 /d "Hello World"
```

```bash
Example : c:\> echotool.exe 192.168.1.2 /p tcp /r 6000 /n 10 /d "Hello World"
```

--------------------------------

### Configure Master and Slave Board Roles

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/NUCLEO-U575ZI-Q/Examples/I2C/I2C_TwoBoards_ComDMA_LowPower/README.md

Toggle the MASTER_BOARD definition to switch between Master and Slave roles before building the project.

```c
#define MASTER_BOARD
```

--------------------------------

### Configure EWARM Linker Memory

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/NetXDuo/Nx_HTTP_SSE/README.md

Add the FREE_MEM section to the .icf file to support dynamic memory allocation.

```text
    place in RAM_region    { last section FREE_MEM };
```

--------------------------------

### Assemble secure and non-secure binaries

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Utilities/PC_Software/ROT_AppliConfig/README.md

Concatenates two binary files into one with specified padding for the first image.

```bash
oneimage -fb ...\Secure\STM32H573I-DK_S\Exe\Project.bin -sb ...\NonSecure\STM32H573I-DK_NS\Exe\Project.bin -o 0x6000 rot_app.bin
```

--------------------------------

### Configure CMSIS-NN Library Target

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/NN/Source/CMakeLists.txt

Sets up the static library target, compiler flags, and include directories for CMSIS-NN.

```cmake
SET(NN ${ROOT}/CMSIS/NN)

list(APPEND CMAKE_MODULE_PATH ${NN}/Source)

add_library(cmsis-nn STATIC)

target_compile_options(cmsis-nn PRIVATE -Ofast)

### Includes
target_include_directories(cmsis-nn PUBLIC "${NN}/Include")
target_include_directories(cmsis-nn PUBLIC "${ROOT}/CMSIS/Core/Include")
target_include_directories(cmsis-nn PUBLIC "${ROOT}/CMSIS/DSP/Include")
```

--------------------------------

### Execute SBSFU Update Scripts

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/SBSFU/README.md

Run the appropriate update script for your toolchain to program the SBSFU bootloader and images into the internal flash.

```text
    EWARM:        SBSFU_Boot\EWARM\SBSFU_UPDATE.bat
    MDK-ARM:      SBSFU_Boot\MDK-ARM\SBSFU_UPDATE.bat
    STM32CubeIDE: SBSFU_Boot\STM32CubeIDE\SBSFU_UPDATE.sh
```

--------------------------------

### Add Controller Source Files

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/ControllerFunctions/CMakeLists.txt

Registers PID and trigonometric source files to the library target.

```cmake
target_sources(CMSISDSPController PRIVATE arm_pid_init_f32.c)
target_sources(CMSISDSPController PRIVATE arm_pid_init_q15.c)
target_sources(CMSISDSPController PRIVATE arm_pid_init_q31.c)
target_sources(CMSISDSPController PRIVATE arm_pid_reset_f32.c)
target_sources(CMSISDSPController PRIVATE arm_pid_reset_q15.c)
target_sources(CMSISDSPController PRIVATE arm_pid_reset_q31.c)

if (NOT CONFIGTABLE OR ALLFAST OR ARM_SIN_COS_F32)
target_sources(CMSISDSPController PRIVATE arm_sin_cos_f32.c)
endif()

if (NOT CONFIGTABLE OR ALLFAST OR ARM_SIN_COS_Q31)
target_sources(CMSISDSPController PRIVATE arm_sin_cos_q31.c)
endif()
```

--------------------------------

### Path and Module Configuration

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Examples/ARM/arm_bayes_example/CMakeLists.txt

Sets the root directory for CMSIS-DSP and updates the module path.

```cmake
# Needed to include the configBoot module
# Define the path to CMSIS-DSP (ROOT is defined on command line when using cmake)
set(ROOT ${CMAKE_CURRENT_SOURCE_DIR}/../../../../..)
set(DSP ${ROOT}/CMSIS/DSP)

# Add DSP folder to module path
list(APPEND CMAKE_MODULE_PATH ${DSP})
```

--------------------------------

### Add Standard and Floating Point Fast Math Sources

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/FastMathFunctions/CMakeLists.txt

Adds vector log, exponential, and division source files, with conditional support for float16 operations.

```cmake
target_sources(CMSISDSPFastMath PRIVATE arm_vlog_f32.c)
target_sources(CMSISDSPFastMath PRIVATE arm_vlog_f64.c)
target_sources(CMSISDSPFastMath PRIVATE arm_vexp_f32.c)
target_sources(CMSISDSPFastMath PRIVATE arm_vexp_f64.c)

target_sources(CMSISDSPFastMath PRIVATE arm_vlog_q31.c)
target_sources(CMSISDSPFastMath PRIVATE arm_vlog_q15.c)


if ((NOT ARMAC5) AND (NOT DISABLEFLOAT16))
target_sources(CMSISDSPFastMath PRIVATE arm_vlog_f16.c)
target_sources(CMSISDSPFastMath PRIVATE arm_vexp_f16.c)
target_sources(CMSISDSPFastMath PRIVATE arm_vinverse_f16.c)
target_sources(CMSISDSPFastMath PRIVATE arm_atan2_f16.c)
endif()

target_sources(CMSISDSPFastMath PRIVATE arm_divide_q15.c)
target_sources(CMSISDSPFastMath PRIVATE arm_divide_q31.c)

target_sources(CMSISDSPFastMath PRIVATE arm_atan2_f32.c)
target_sources(CMSISDSPFastMath PRIVATE arm_atan2_q31.c)
target_sources(CMSISDSPFastMath PRIVATE arm_atan2_q15.c)
```

--------------------------------

### Define CMSIS-DSP Quaternion Math Library

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/QuaternionMathFunctions/CMakeLists.txt

Initializes the CMake project and defines the static library target with its primary source files.

```cmake
cmake_minimum_required (VERSION 3.14)

project(CMSISDSPQuaternionMath)

include(configLib)
include(configDsp)



add_library(CMSISDSPQuaternionMath STATIC arm_quaternion_norm_f32.c)
target_sources(CMSISDSPQuaternionMath PRIVATE arm_quaternion_inverse_f32.c)
target_sources(CMSISDSPQuaternionMath PRIVATE arm_quaternion_conjugate_f32.c)
target_sources(CMSISDSPQuaternionMath PRIVATE arm_quaternion_normalize_f32.c)
target_sources(CMSISDSPQuaternionMath PRIVATE arm_quaternion_product_single_f32.c)
target_sources(CMSISDSPQuaternionMath PRIVATE arm_quaternion_product_f32.c)
target_sources(CMSISDSPQuaternionMath PRIVATE arm_quaternion2rotation_f32.c)
target_sources(CMSISDSPQuaternionMath PRIVATE arm_rotation2quaternion_f32.c)
```

--------------------------------

### Set Include Directories

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/ControllerFunctions/CMakeLists.txt

Configures the public include path for the library.

```cmake
target_include_directories(CMSISDSPController PUBLIC "${DSP}/Include")
```

--------------------------------

### Configure CMSIS-NN Activation Function Sources

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/NN/Source/ActivationFunctions/CMakeLists.txt

Glob all files ending in _s8.c within the current directory and add them to the cmsis-nn library target.

```cmake
file(GLOB SRC "./*_s8.c")
target_sources(cmsis-nn PRIVATE ${SRC})
```

--------------------------------

### Finalize Library Configuration

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/StatisticsFunctions/CMakeLists.txt

Applies library and DSP-specific configurations to the target.

```cmake
configLib(CMSISDSPStatistics ${ROOT})
configDsp(CMSISDSPStatistics ${ROOT})
```

--------------------------------

### User Application Main Menu

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/SBSFU/README.md

The menu interface displayed by the user application for testing protections and controlling hardware.

```text
   1 - Test protections
   2 - Test Secure LED
```

--------------------------------

### Build CMSIS-NN with CMake

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/NN/README.md

Commands to configure and build the CMSIS-NN library for a specific target CPU.

```bash
cd </path/to/CMSIS_5>/CMSIS/NN
mkdir build
cd build
cmake .. -DCMAKE_TOOLCHAIN_FILE=</path/to/ethos-u-core-platform>/cmake/toolchain/arm-none-eabi-gcc.cmake -DTARGET_CPU=cortex-m55
make
```

--------------------------------

### Configure Include Directories and Conditional Sources

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/SupportFunctions/CMakeLists.txt

Sets public include directories and conditionally adds float16 source files if the ARMAC5 compiler is not used and float16 is not disabled.

```cmake
### Includes
target_include_directories(CMSISDSPSupport PUBLIC "${DSP}/Include")

if ((NOT ARMAC5) AND (NOT DISABLEFLOAT16))
target_sources(CMSISDSPSupport PRIVATE arm_copy_f16.c)
target_sources(CMSISDSPSupport PRIVATE arm_fill_f16.c)
target_sources(CMSISDSPSupport PRIVATE arm_f16_to_q15.c)
target_sources(CMSISDSPSupport PRIVATE arm_q15_to_f16.c)
target_sources(CMSISDSPSupport PRIVATE arm_float_to_f16.c)
target_sources(CMSISDSPSupport PRIVATE arm_f16_to_float.c)
target_sources(CMSISDSPSupport PRIVATE arm_weighted_sum_f16.c)
target_sources(CMSISDSPSupport PRIVATE arm_barycenter_f16.c)
endif()
```

--------------------------------

### Conditional Configuration and Include Directories

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/QuaternionMathFunctions/CMakeLists.txt

Applies library configuration and sets public include directories for the target.

```cmake
if ((NOT ARMAC5) AND (NOT DISABLEFLOAT16))
endif()


configLib(CMSISDSPQuaternionMath ${ROOT})
configDsp(CMSISDSPQuaternionMath ${ROOT})

### Includes
target_include_directories(CMSISDSPQuaternionMath PUBLIC "${DSP}/Include")
```

--------------------------------

### Manage Common DSP Tables

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/CMakeLists.txt

Adds the CommonTables subdirectory and configures definitions for FFT and fast math tables based on enabled features.

```cmake
if (FILTERING OR CONTROLLER OR FASTMATH OR TRANSFORM OR SVM OR DISTANCE)
  add_subdirectory(CommonTables)
  if (TRANSFORM)
    # FFT tables inclusion is allowed
    if (CONFIGTABLE)
      target_compile_definitions(CMSISDSPCommon PUBLIC ARM_FFT_ALLOW_TABLES)
    endif()
  endif()
  if (FILTERING OR CONTROLLER OR FASTMATH)
    # Select which tables to include
    if (CONFIGTABLE)
      target_compile_definitions(CMSISDSPCommon PUBLIC ARM_FAST_ALLOW_TABLES)
    endif()
  endif()
  target_link_libraries(CMSISDSP INTERFACE CMSISDSPCommon)
  # Common project is adding ComputeLibrary tables used by SVM and Distance
  # when NEon is ON.
endif()
```

--------------------------------

### Configure EchoTool for TCP Server

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/NetXDuo/Nx_TCP_Echo_Client/README.md

Command to launch the EchoTool utility on a Windows console to act as a TCP server for the client application.

```bash
c:\> .\echotool.exe /p tcp /s <TCP_SERVER_PORT>
```

```bash
c:\> .\echotool.exe /p tcp /s 6001
```

--------------------------------

### Configure XML options with xmlen

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Utilities/PC_Software/ROT_AppliConfig/README.md

Use the xmlen utility to enable or disable XML parameters based on macro definitions or forced values.

```bash
xmlen -l image_macros_preprocessed_bl2.c -m RE_ENCRYPTION -c E OEMiRoT_Secure_Code.xml
```

```bash
xmlen -e 0 -c E OEMiRoT_Secure_Code.xml
```

--------------------------------

### Set Include Directories and Conditional Sources

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/BayesFunctions/CMakeLists.txt

Configures public include directories and conditionally adds f16 source files based on compiler and feature flags.

```cmake
### Includes
target_include_directories(CMSISDSPBayes PUBLIC "${DSP}/Include")

if ((NOT ARMAC5) AND (NOT DISABLEFLOAT16))
target_sources(CMSISDSPBayes PRIVATE arm_gaussian_naive_bayes_predict_f16.c)
endif()
```

--------------------------------

### Include FFT and Interpolation Modules

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/CommonTables/CMakeLists.txt

Integrates FFT and interpolation functionality into the library build.

```cmake
include(fft)
fft(CMSISDSPCommon)

include(interpol)
interpol(CMSISDSPCommon)
```

--------------------------------

### Define Cryptography Scheme

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/SBSFU/README.md

Sets the default cryptographic scheme for the bootloader.

```c
#define CRYPTO_SCHEME_EC256      0x2 /* ECDSA-256 signature, AES-CTR-128 encryption with key ECIES-P256 encrypted */
#define CRYPTO_SCHEME            CRYPTO_SCHEME_EC256  /* Default crypto scheme */
```

--------------------------------

### Directly clone a specific firmware version

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/README.md

Clone a specific version directly to avoid manual checkout steps. The --depth 1 option is optional.

```bash
git clone --recursive  --depth 1 --branch vX.Y.Z https://github.com/STMicroelectronics/STM32CubeU5.git
```

--------------------------------

### Configure MDK-ARM Linker Memory

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Projects/B-U585I-IOT02A/Applications/NetXDuo/Nx_HTTP_SSE/README.md

Update the memory limit reference in the low-level initialization file.

```assembly
    LDR r1, =|Image$$RW_IRAM1$$ZI$$Limit|
```

--------------------------------

### Set Include Directories

Source: https://github.com/stmicroelectronics/stm32cubeu5/blob/main/Drivers/CMSIS/DSP/Source/MatrixFunctions/CMakeLists.txt

Adds the DSP include directory to the library's public include path.

```cmake
target_include_directories(CMSISDSPMatrix PUBLIC "${DSP}/Include")
```
Tokens:
Raw