chore: add automatic clang-format with pre-commit hooks

.clang-format

@@ -0,0 +1,17 @@
+BasedOnStyle: LLVM
+IndentWidth: 4
+TabWidth: 4
+UseTab: Never
+ColumnLimit: 100
+PointerAlignment: Left
+AccessModifierOffset: -4
+SortIncludes: Never
+AllowShortIfStatementsOnASingleLine: false
+AllowShortLoopsOnASingleLine: false
+Cpp11BracedListStyle: true
+BreakBeforeBraces: Attach
+BinPackArguments: false
+BinPackParameters: false
+AllowAllArgumentsOnNextLine: false
+AllowAllParametersOfDeclarationOnNextLine: false
+AlignAfterOpenBracket: BlockIndent

.github/workflows/format-checks.yml

@@ -0,0 +1,37 @@
+name: Format Checks
+
+on:
+  workflow_dispatch:
+  pull_request:
+    paths:
+      - '**.cpp'
+      - '**.hpp'
+      - '**.c'
+      - '**.h'
+      - '.pre-commit-config.yaml'
+      - '.clang-format'
+      - '.github/workflows/format-checks.yml'
+
+jobs:
+  format:
+    name: Check code format
+    runs-on: ubuntu-24.04
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install tools
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install pre-commit
+          sudo apt-get update
+          sudo apt-get install -y clang-format
+
+      - name: Run pre-commit
+        run: pre-commit run --all-files --show-diff-on-failure

.pre-commit-config.yaml

@@ -0,0 +1,14 @@
+minimum_pre_commit_version: "3.5.0"
+default_install_hook_types:
+  - pre-commit
+  - pre-push
+repos:
+  - repo: https://github.com/pre-commit/mirrors-clang-format
+    rev: v17.0.6
+    hooks:
+      - id: clang-format
+        files: ^(Core/|tools/).*
+        types_or:
+          - c
+          - c++
+        exclude: ^Core/Inc/Code_generation/Packet_generation/.*Template\.hpp$|^tools/binary_metadata_template\.cpp$

Core/Inc/main.h

@@ -1,21 +1,21 @@
 /* USER CODE BEGIN Header */
 /**
-  ******************************************************************************
-  * @file           : main.h
-  * @brief          : Header for main.c file.
-  *                   This file contains the common defines of the application.
-  ******************************************************************************
-  * @attention
-  *
-  * Copyright (c) 2022 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.
-  *
-  ******************************************************************************
-  */
+ ******************************************************************************
+ * @file           : main.h
+ * @brief          : Header for main.c file.
+ *                   This file contains the common defines of the application.
+ ******************************************************************************
+ * @attention
+ *
+ * Copyright (c) 2022 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.
+ *
+ ******************************************************************************
+ */
 /* USER CODE END Header */
 
 /* Define to prevent recursive inclusion -------------------------------------*/
@@ -49,7 +49,7 @@ extern "C" {
 
 /* USER CODE END EM */
 
-void HAL_TIM_MspPostInit(TIM_HandleTypeDef *htim);
+void HAL_TIM_MspPostInit(TIM_HandleTypeDef* htim);
 
 /* Exported functions prototypes ---------------------------------------------*/
 void Error_Handler(void);

Core/Inc/stm32h7xx_hal_conf.h

@@ -108,8 +108,8 @@ extern "C" {
  * PLL).
  */
 #if !defined(HSE_VALUE)
-#define HSE_VALUE                                                             \
-    (8000000UL) /*!< Value of the External oscillator in Hz : FPGA case fixed \
+#define HSE_VALUE                                                                                  \
+    (8000000UL) /*!< Value of the External oscillator in Hz : FPGA case fixed                      \
                    to 60MHZ */
 #endif          /* HSE_VALUE */
 
@@ -150,19 +150,20 @@ extern "C" {
 
 #if !defined(LSI_VALUE)
 #define LSI_VALUE (32000UL) /*!< LSI Typical Value in Hz*/
-#endif /* LSI_VALUE */ /*!< Value of the Internal Low Speed oscillator in Hz \
-                         The real value may vary depending on the variations \
-                         in voltage and temperature.*/
+#endif /* LSI_VALUE */      /*!< Value of the Internal Low Speed oscillator in Hz                  \
+                              The real value may vary depending on the variations                  \
+                              in voltage and temperature.*/
 
 /**
  * @brief External clock source for I2S peripheral
  *        This value is used by the I2S HAL module to compute the I2S clock
  * source frequency, this source is inserted directly through I2S_CKIN pad.
  */
 #if !defined(EXTERNAL_CLOCK_VALUE)
-#define EXTERNAL_CLOCK_VALUE 12288000UL /*!< Value of the External clock in \
-                                           Hz*/
-#endif                                  /* EXTERNAL_CLOCK_VALUE */
+#define EXTERNAL_CLOCK_VALUE                                                                       \
+    12288000UL /*!< Value of the External clock in                                                 \
+                  Hz*/
+#endif         /* EXTERNAL_CLOCK_VALUE */
 
 /* Tip: To avoid modifying this file each time you need to use different HSE,
    ===  you can define the HSE value in your toolchain compiler preprocessor. */
@@ -177,102 +178,54 @@ extern "C" {
 #define USE_SD_TRANSCEIVER 0U /*!< use uSD Transceiver */
 #define USE_SPI_CRC 0U        /*!< use CRC in SPI */
 
-#define USE_HAL_ADC_REGISTER_CALLBACKS \
-    0U /* ADC register callback disabled     */
-#define USE_HAL_CEC_REGISTER_CALLBACKS \
-    0U /* CEC register callback disabled     */
-#define USE_HAL_COMP_REGISTER_CALLBACKS \
-    0U /* COMP register callback disabled    */
-#define USE_HAL_CORDIC_REGISTER_CALLBACKS \
-    0U /* CORDIC register callback disabled  */
-#define USE_HAL_CRYP_REGISTER_CALLBACKS \
-    0U /* CRYP register callback disabled    */
-#define USE_HAL_DAC_REGISTER_CALLBACKS \
-    0U /* DAC register callback disabled     */
-#define USE_HAL_DCMI_REGISTER_CALLBACKS \
-    0U /* DCMI register callback disabled    */
-#define USE_HAL_DFSDM_REGISTER_CALLBACKS \
-    0U /* DFSDM register callback disabled   */
-#define USE_HAL_DMA2D_REGISTER_CALLBACKS \
-    0U /* DMA2D register callback disabled   */
-#define USE_HAL_DSI_REGISTER_CALLBACKS \
-    0U /* DSI register callback disabled     */
-#define USE_HAL_DTS_REGISTER_CALLBACKS \
-    0U /* DTS register callback disabled     */
-#define USE_HAL_ETH_REGISTER_CALLBACKS \
-    0U /* ETH register callback disabled     */
-#define USE_HAL_FDCAN_REGISTER_CALLBACKS \
-    0U /* FDCAN register callback disabled   */
-#define USE_HAL_FMAC_REGISTER_CALLBACKS \
-    0U /* FMAC register callback disabled  */
-#define USE_HAL_NAND_REGISTER_CALLBACKS \
-    0U /* NAND register callback disabled    */
-#define USE_HAL_NOR_REGISTER_CALLBACKS \
-    0U /* NOR register callback disabled     */
-#define USE_HAL_SDRAM_REGISTER_CALLBACKS \
-    0U /* SDRAM register callback disabled   */
-#define USE_HAL_SRAM_REGISTER_CALLBACKS \
-    0U /* SRAM register callback disabled    */
-#define USE_HAL_HASH_REGISTER_CALLBACKS \
-    0U /* HASH register callback disabled    */
-#define USE_HAL_HCD_REGISTER_CALLBACKS \
-    0U /* HCD register callback disabled     */
-#define USE_HAL_GFXMMU_REGISTER_CALLBACKS \
-    0U /* GFXMMU register callback disabled  */
-#define USE_HAL_HRTIM_REGISTER_CALLBACKS \
-    0U /* HRTIM register callback disabled   */
-#define USE_HAL_I2C_REGISTER_CALLBACKS \
-    0U /* I2C register callback disabled     */
-#define USE_HAL_I2S_REGISTER_CALLBACKS \
-    0U /* I2S register callback disabled     */
-#define USE_HAL_IRDA_REGISTER_CALLBACKS \
-    0U /* IRDA register callback disabled    */
-#define USE_HAL_JPEG_REGISTER_CALLBACKS \
-    0U /* JPEG register callback disabled    */
-#define USE_HAL_LPTIM_REGISTER_CALLBACKS \
-    0U /* LPTIM register callback disabled   */
-#define USE_HAL_LTDC_REGISTER_CALLBACKS \
-    0U /* LTDC register callback disabled    */
-#define USE_HAL_MDIOS_REGISTER_CALLBACKS \
-    0U /* MDIO register callback disabled    */
-#define USE_HAL_MMC_REGISTER_CALLBACKS \
-    0U /* MMC register callback disabled     */
-#define USE_HAL_OPAMP_REGISTER_CALLBACKS \
-    0U /* MDIO register callback disabled    */
-#define USE_HAL_OSPI_REGISTER_CALLBACKS \
-    0U /* OSPI register callback disabled    */
-#define USE_HAL_OTFDEC_REGISTER_CALLBACKS \
-    0U /* OTFDEC register callback disabled  */
-#define USE_HAL_PCD_REGISTER_CALLBACKS \
-    0U /* PCD register callback disabled     */
-#define USE_HAL_QSPI_REGISTER_CALLBACKS \
-    0U /* QSPI register callback disabled    */
-#define USE_HAL_RNG_REGISTER_CALLBACKS \
-    0U /* RNG register callback disabled     */
-#define USE_HAL_RTC_REGISTER_CALLBACKS \
-    0U /* RTC register callback disabled     */
-#define USE_HAL_SAI_REGISTER_CALLBACKS \
-    0U /* SAI register callback disabled     */
-#define USE_HAL_SD_REGISTER_CALLBACKS \
-    0U /* SD register callback disabled      */
-#define USE_HAL_SMARTCARD_REGISTER_CALLBACKS \
-    0U /* SMARTCARD register callback disabled */
-#define USE_HAL_SPDIFRX_REGISTER_CALLBACKS \
-    0U /* SPDIFRX register callback disabled */
-#define USE_HAL_SMBUS_REGISTER_CALLBACKS \
-    0U /* SMBUS register callback disabled   */
-#define USE_HAL_SPI_REGISTER_CALLBACKS \
-    0U /* SPI register callback disabled     */
-#define USE_HAL_SWPMI_REGISTER_CALLBACKS \
-    0U /* SWPMI register callback disabled   */
-#define USE_HAL_TIM_REGISTER_CALLBACKS \
-    0U /* TIM register callback disabled     */
-#define USE_HAL_UART_REGISTER_CALLBACKS \
-    0U /* UART register callback disabled    */
-#define USE_HAL_USART_REGISTER_CALLBACKS \
-    0U /* USART register callback disabled   */
-#define USE_HAL_WWDG_REGISTER_CALLBACKS \
-    0U /* WWDG register callback disabled    */
+#define USE_HAL_ADC_REGISTER_CALLBACKS 0U       /* ADC register callback disabled     */
+#define USE_HAL_CEC_REGISTER_CALLBACKS 0U       /* CEC register callback disabled     */
+#define USE_HAL_COMP_REGISTER_CALLBACKS 0U      /* COMP register callback disabled    */
+#define USE_HAL_CORDIC_REGISTER_CALLBACKS 0U    /* CORDIC register callback disabled  */
+#define USE_HAL_CRYP_REGISTER_CALLBACKS 0U      /* CRYP register callback disabled    */
+#define USE_HAL_DAC_REGISTER_CALLBACKS 0U       /* DAC register callback disabled     */
+#define USE_HAL_DCMI_REGISTER_CALLBACKS 0U      /* DCMI register callback disabled    */
+#define USE_HAL_DFSDM_REGISTER_CALLBACKS 0U     /* DFSDM register callback disabled   */
+#define USE_HAL_DMA2D_REGISTER_CALLBACKS 0U     /* DMA2D register callback disabled   */
+#define USE_HAL_DSI_REGISTER_CALLBACKS 0U       /* DSI register callback disabled     */
+#define USE_HAL_DTS_REGISTER_CALLBACKS 0U       /* DTS register callback disabled     */
+#define USE_HAL_ETH_REGISTER_CALLBACKS 0U       /* ETH register callback disabled     */
+#define USE_HAL_FDCAN_REGISTER_CALLBACKS 0U     /* FDCAN register callback disabled   */
+#define USE_HAL_FMAC_REGISTER_CALLBACKS 0U      /* FMAC register callback disabled  */
+#define USE_HAL_NAND_REGISTER_CALLBACKS 0U      /* NAND register callback disabled    */
+#define USE_HAL_NOR_REGISTER_CALLBACKS 0U       /* NOR register callback disabled     */
+#define USE_HAL_SDRAM_REGISTER_CALLBACKS 0U     /* SDRAM register callback disabled   */
+#define USE_HAL_SRAM_REGISTER_CALLBACKS 0U      /* SRAM register callback disabled    */
+#define USE_HAL_HASH_REGISTER_CALLBACKS 0U      /* HASH register callback disabled    */
+#define USE_HAL_HCD_REGISTER_CALLBACKS 0U       /* HCD register callback disabled     */
+#define USE_HAL_GFXMMU_REGISTER_CALLBACKS 0U    /* GFXMMU register callback disabled  */
+#define USE_HAL_HRTIM_REGISTER_CALLBACKS 0U     /* HRTIM register callback disabled   */
+#define USE_HAL_I2C_REGISTER_CALLBACKS 0U       /* I2C register callback disabled     */
+#define USE_HAL_I2S_REGISTER_CALLBACKS 0U       /* I2S register callback disabled     */
+#define USE_HAL_IRDA_REGISTER_CALLBACKS 0U      /* IRDA register callback disabled    */
+#define USE_HAL_JPEG_REGISTER_CALLBACKS 0U      /* JPEG register callback disabled    */
+#define USE_HAL_LPTIM_REGISTER_CALLBACKS 0U     /* LPTIM register callback disabled   */
+#define USE_HAL_LTDC_REGISTER_CALLBACKS 0U      /* LTDC register callback disabled    */
+#define USE_HAL_MDIOS_REGISTER_CALLBACKS 0U     /* MDIO register callback disabled    */
+#define USE_HAL_MMC_REGISTER_CALLBACKS 0U       /* MMC register callback disabled     */
+#define USE_HAL_OPAMP_REGISTER_CALLBACKS 0U     /* MDIO register callback disabled    */
+#define USE_HAL_OSPI_REGISTER_CALLBACKS 0U      /* OSPI register callback disabled    */
+#define USE_HAL_OTFDEC_REGISTER_CALLBACKS 0U    /* OTFDEC register callback disabled  */
+#define USE_HAL_PCD_REGISTER_CALLBACKS 0U       /* PCD register callback disabled     */
+#define USE_HAL_QSPI_REGISTER_CALLBACKS 0U      /* QSPI register callback disabled    */
+#define USE_HAL_RNG_REGISTER_CALLBACKS 0U       /* RNG register callback disabled     */
+#define USE_HAL_RTC_REGISTER_CALLBACKS 0U       /* RTC register callback disabled     */
+#define USE_HAL_SAI_REGISTER_CALLBACKS 0U       /* SAI register callback disabled     */
+#define USE_HAL_SD_REGISTER_CALLBACKS 0U        /* SD register callback disabled      */
+#define USE_HAL_SMARTCARD_REGISTER_CALLBACKS 0U /* SMARTCARD register callback disabled */
+#define USE_HAL_SPDIFRX_REGISTER_CALLBACKS 0U   /* SPDIFRX register callback disabled */
+#define USE_HAL_SMBUS_REGISTER_CALLBACKS 0U     /* SMBUS register callback disabled   */
+#define USE_HAL_SPI_REGISTER_CALLBACKS 0U       /* SPI register callback disabled     */
+#define USE_HAL_SWPMI_REGISTER_CALLBACKS 0U     /* SWPMI register callback disabled   */
+#define USE_HAL_TIM_REGISTER_CALLBACKS 0U       /* TIM register callback disabled     */
+#define USE_HAL_UART_REGISTER_CALLBACKS 0U      /* UART register callback disabled    */
+#define USE_HAL_USART_REGISTER_CALLBACKS 0U     /* USART register callback disabled   */
+#define USE_HAL_WWDG_REGISTER_CALLBACKS 0U      /* WWDG register callback disabled    */
 
 /* ########################### Ethernet Configuration #########################
  */
@@ -552,10 +505,9 @@ extern "C" {
  *         If expr is true, it returns no value.
  * @retval None
  */
-#define assert_param(expr) \
-    ((expr) ? (void)0U : assert_failed((uint8_t *)__FILE__, __LINE__))
+#define assert_param(expr) ((expr) ? (void)0U : assert_failed((uint8_t*)__FILE__, __LINE__))
 /* Exported functions ------------------------------------------------------- */
-void assert_failed(uint8_t *file, uint32_t line);
+void assert_failed(uint8_t* file, uint32_t line);
 #else
 #define assert_param(expr) ((void)0U)
 #endif /* USE_FULL_ASSERT */
@@ -565,4 +517,3 @@ void assert_failed(uint8_t *file, uint32_t line);
 #endif
 
 #endif /* STM32H7xx_HAL_CONF_H */
-

Core/Inc/stm32h7xx_it.h

@@ -1,28 +1,28 @@
 /* USER CODE BEGIN Header */
 /**
-  ******************************************************************************
-  * @file    stm32h7xx_it.h
-  * @brief   This file contains the headers of the interrupt handlers.
-  ******************************************************************************
-  * @attention
-  *
-  * Copyright (c) 2022 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.
-  *
  ******************************************************************************
-  */
+ * @file    stm32h7xx_it.h
+ * @brief   This file contains the headers of the interrupt handlers.
+ ******************************************************************************
+ * @attention
+ *
+ * Copyright (c) 2022 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.
+ *
+ ******************************************************************************
+ */
 /* USER CODE END Header */
 
 /* Define to prevent recursive inclusion -------------------------------------*/
 #ifndef __STM32H7xx_IT_H
 #define __STM32H7xx_IT_H
 
 #ifdef __cplusplus
- extern "C" {
+extern "C" {
 #endif
 
 /* Private includes ----------------------------------------------------------*/