McuSelect.h

Go to the documentation of this file.

 
#pragma once
 
//==============================================================================
// USAGE INSTRUCTIONS - HOW TO SELECT YOUR MCU
//==============================================================================
/*
 * STEP 1: Select your target MCU by uncommenting exactly ONE define below
 * STEP 2: Comment out all other MCU defines (they should have // in front)
 * STEP 3: Build your project - all platform-specific code will be configured automatically
 *
 * EXAMPLES:
 * - For ESP32-C6:  uncomment "#define HF_TARGET_MCU_ESP32C6"
 * - For ESP32:      uncomment "#define HF_TARGET_MCU_ESP32"
 * - For STM32F4:    uncomment "#define HF_TARGET_MCU_STM32F4"
 *
 * NOTE: If you get "Multiple target MCUs" error, you have more than one uncommented.
 *       If you get "No target MCU" error, you need to uncomment exactly one.
 */
 
//==============================================================================
// CENTRAL MCU SELECTION - SELECT EXACTLY ONE MCU
//==============================================================================
// Auto-detect from ESP-IDF build system (CONFIG_IDF_TARGET_*).
// If building with ESP-IDF, the correct target is set automatically.
// For non-IDF builds, uncomment exactly ONE define below.
// Uses #ifndef guards so CMake -D definitions take priority without warnings.
 
#if defined(CONFIG_IDF_TARGET_ESP32C6) && !defined(HF_TARGET_MCU_ESP32C6)
  #define HF_TARGET_MCU_ESP32C6
#elif defined(CONFIG_IDF_TARGET_ESP32) && !defined(HF_TARGET_MCU_ESP32)
  #define HF_TARGET_MCU_ESP32
#elif defined(CONFIG_IDF_TARGET_ESP32S2) && !defined(HF_TARGET_MCU_ESP32S2)
  #define HF_TARGET_MCU_ESP32S2
#elif defined(CONFIG_IDF_TARGET_ESP32S3) && !defined(HF_TARGET_MCU_ESP32S3)
  #define HF_TARGET_MCU_ESP32S3
#elif defined(CONFIG_IDF_TARGET_ESP32C3) && !defined(HF_TARGET_MCU_ESP32C3)
  #define HF_TARGET_MCU_ESP32C3
#elif defined(CONFIG_IDF_TARGET_ESP32C2) && !defined(HF_TARGET_MCU_ESP32C2)
  #define HF_TARGET_MCU_ESP32C2
#elif defined(CONFIG_IDF_TARGET_ESP32H2) && !defined(HF_TARGET_MCU_ESP32H2)
  #define HF_TARGET_MCU_ESP32H2
#endif
 
// Fallback: if nothing auto-detected and no manual override, leave unset.
// The "No MCU Selected" section below will handle the NONE case or error.
// NOTE: For ESP-IDF builds, auto-detection above always succeeds.
 
// Manual override (uncomment ONE to override auto-detection):
// #define HF_TARGET_MCU_ESP32C6     // ESP32-C6 RISC-V MCU
// #define HF_TARGET_MCU_ESP32       // ESP32 Classic Xtensa MCU
// #define HF_TARGET_MCU_ESP32S2     // ESP32-S2 Xtensa LX7 MCU
// #define HF_TARGET_MCU_ESP32S3     // ESP32-S3 Xtensa LX7 MCU
// #define HF_TARGET_MCU_ESP32C3     // ESP32-C3 RISC-V MCU
// #define HF_TARGET_MCU_ESP32C2     // ESP32-C2 RISC-V MCU
// #define HF_TARGET_MCU_ESP32H2     // ESP32-H2 RISC-V MCU
// #define HF_TARGET_MCU_STM32F4     // STM32F4 series ARM Cortex-M4
// #define HF_TARGET_MCU_STM32H7     // STM32H7 series ARM Cortex-M7
// #define HF_TARGET_MCU_RP2040      // Raspberry Pi Pico RP2040
// #define HF_TARGET_MCU_NONE        // No MCU — software-only / unit-test build
 
// Optional thread safety support using RTOS-based mutexes
// Uncomment to enable mutex protection in MCU drivers
#ifndef HF_THREAD_SAFE
#define HF_THREAD_SAFE // Enable thread safety for SPI, I2C, UART operations
#endif
 
//==============================================================================
// AUTOMATIC PLATFORM CONFIGURATION BASED ON SELECTION
//==============================================================================
 
// ESP32-C6 Configuration
#ifdef HF_TARGET_MCU_ESP32C6
#ifndef HF_MCU_ESP32C6
#define HF_MCU_ESP32C6
#endif
#ifndef HF_MCU_FAMILY_ESP32
#define HF_MCU_FAMILY_ESP32
#endif
#define HF_MCU_NAME "ESP32-C6"
#define HF_MCU_ARCHITECTURE "RISC-V RV32IMAC"
#define HF_MCU_VARIANT_C6
 
// ESP32 Classic Configuration
#elif defined(HF_TARGET_MCU_ESP32)
#ifndef HF_MCU_ESP32
#define HF_MCU_ESP32
#endif
#ifndef HF_MCU_FAMILY_ESP32
#define HF_MCU_FAMILY_ESP32
#endif
#define HF_MCU_NAME "ESP32"
#define HF_MCU_ARCHITECTURE "Xtensa LX6"
#define HF_MCU_VARIANT_CLASSIC
 
// ESP32-S2 Configuration
#elif defined(HF_TARGET_MCU_ESP32S2)
#ifndef HF_MCU_ESP32S2
#define HF_MCU_ESP32S2
#endif
#ifndef HF_MCU_FAMILY_ESP32
#define HF_MCU_FAMILY_ESP32
#endif
#define HF_MCU_NAME "ESP32-S2"
#define HF_MCU_ARCHITECTURE "Xtensa LX7"
#define HF_MCU_VARIANT_S2
 
// ESP32-S3 Configuration
#elif defined(HF_TARGET_MCU_ESP32S3)
#ifndef HF_MCU_ESP32S3
#define HF_MCU_ESP32S3
#endif
#ifndef HF_MCU_FAMILY_ESP32
#define HF_MCU_FAMILY_ESP32
#endif
#define HF_MCU_NAME "ESP32-S3"
#define HF_MCU_ARCHITECTURE "Xtensa LX7"
#define HF_MCU_VARIANT_S3
 
// ESP32-C3 Configuration
#elif defined(HF_TARGET_MCU_ESP32C3)
#ifndef HF_MCU_ESP32C3
#define HF_MCU_ESP32C3
#endif
#ifndef HF_MCU_FAMILY_ESP32
#define HF_MCU_FAMILY_ESP32
#endif
#define HF_MCU_NAME "ESP32-C3"
#define HF_MCU_ARCHITECTURE "RISC-V RV32IMC"
#define HF_MCU_VARIANT_C3
 
// ESP32-C2 Configuration
#elif defined(HF_TARGET_MCU_ESP32C2)
#ifndef HF_MCU_ESP32C2
#define HF_MCU_ESP32C2
#endif
#ifndef HF_MCU_FAMILY_ESP32
#define HF_MCU_FAMILY_ESP32
#endif
#define HF_MCU_NAME "ESP32-C2"
#define HF_MCU_ARCHITECTURE "RISC-V RV32IMC"
#define HF_MCU_VARIANT_C2
 
// ESP32-H2 Configuration
#elif defined(HF_TARGET_MCU_ESP32H2)
#ifndef HF_MCU_ESP32H2
#define HF_MCU_ESP32H2
#endif
#ifndef HF_MCU_FAMILY_ESP32
#define HF_MCU_FAMILY_ESP32
#endif
#define HF_MCU_NAME "ESP32-H2"
#define HF_MCU_ARCHITECTURE "RISC-V RV32IMC"
#define HF_MCU_VARIANT_H2
 
// STM32F4 Configuration — stub implementations in inc/mcu/stm32/
#elif defined(HF_TARGET_MCU_STM32F4)
#define HF_MCU_STM32F4
#define HF_MCU_FAMILY_STM32
#define HF_MCU_NAME "STM32F4"
#define HF_MCU_ARCHITECTURE "ARM Cortex-M4"
#define HF_MCU_VARIANT_F4
 
// STM32H7 Configuration — stub implementations in inc/mcu/stm32/
#elif defined(HF_TARGET_MCU_STM32H7)
#define HF_MCU_STM32H7
#define HF_MCU_FAMILY_STM32
#define HF_MCU_NAME "STM32H7"
#define HF_MCU_ARCHITECTURE "ARM Cortex-M7"
#define HF_MCU_VARIANT_H7
 
// RP2040 Configuration — stub implementations (future)
#elif defined(HF_TARGET_MCU_RP2040)
#define HF_MCU_RP2040
#define HF_MCU_FAMILY_RP2040
#define HF_MCU_NAME "RP2040"
#define HF_MCU_ARCHITECTURE "ARM Cortex-M0+"
 
// NONE Configuration — software-only / unit-test / host build
#elif defined(HF_TARGET_MCU_NONE)
#define HF_MCU_NONE
#define HF_MCU_FAMILY_NONE
#define HF_MCU_NAME "None (software-only)"
#define HF_MCU_ARCHITECTURE "Host"
 
// No MCU Selected - Error
#else
#error "No MCU selected! Define HF_TARGET_MCU_* via CMake or uncomment one in McuSelect.h"
#endif
 
//==============================================================================
// PLATFORM VALIDATION - ENSURE ONLY ONE TARGET IS SELECTED
//==============================================================================
 
// Count the number of selected target MCUs (portable version)
#if defined(HF_TARGET_MCU_ESP32C6) + defined(HF_TARGET_MCU_ESP32) +                                \
        defined(HF_TARGET_MCU_ESP32S2) + defined(HF_TARGET_MCU_ESP32S3) +                          \
        defined(HF_TARGET_MCU_ESP32C3) + defined(HF_TARGET_MCU_ESP32C2) +                          \
        defined(HF_TARGET_MCU_ESP32H2) + defined(HF_TARGET_MCU_STM32F4) +                          \
        defined(HF_TARGET_MCU_STM32H7) + defined(HF_TARGET_MCU_RP2040) +                           \
        defined(HF_TARGET_MCU_NONE) >                                                              \
    1
#error                                                                                             \
    "Multiple target MCUs are selected. Please define exactly ONE HF_TARGET_MCU_* macro."
#elif !defined(HF_TARGET_MCU_ESP32C6) && !defined(HF_TARGET_MCU_ESP32) &&                          \
    !defined(HF_TARGET_MCU_ESP32S2) && !defined(HF_TARGET_MCU_ESP32S3) &&                          \
    !defined(HF_TARGET_MCU_ESP32C3) && !defined(HF_TARGET_MCU_ESP32C2) &&                          \
    !defined(HF_TARGET_MCU_ESP32H2) && !defined(HF_TARGET_MCU_STM32F4) &&                          \
    !defined(HF_TARGET_MCU_STM32H7) && !defined(HF_TARGET_MCU_RP2040) &&                           \
    !defined(HF_TARGET_MCU_NONE)
#error                                                                                             \
    "No target MCU is selected. Define exactly ONE HF_TARGET_MCU_* macro via CMake -D or McuSelect.h"
#endif
 
// Validate that the selected MCU has a corresponding platform family defined
#if !defined(HF_MCU_FAMILY_ESP32) && !defined(HF_MCU_FAMILY_STM32) && \
    !defined(HF_MCU_FAMILY_RP2040) && !defined(HF_MCU_FAMILY_NONE)
#error "No MCU family is defined. This indicates an error in McuSelect.h configuration."
#endif
 
//==============================================================================
// MCU CAPABILITY DEFINITIONS
//==============================================================================
 
// ESP32-C6 Specific Capabilities (Primary Target)
#ifdef HF_MCU_ESP32C6
// GPIO capabilities
#define HF_MCU_HAS_GPIO 1
#define HF_MCU_GPIO_MAX_PINS 31 // ESP32-C6 has 31 GPIO pins (0-30)
#define HF_MCU_GPIO_HAS_PULLUP 1
#define HF_MCU_GPIO_HAS_PULLDOWN 1
#define HF_MCU_GPIO_HAS_INTERRUPTS 1
 
// ESP32-C6 Advanced GPIO Hardware Constants (ESP-IDF v5.5+)
#define HF_MCU_GPIO_PIN_COUNT 31            
#define HF_MCU_GPIO_MAX_PIN_NUMBER 30       
#define HF_MCU_GPIO_RTC_PIN_COUNT 8         
#define HF_MCU_GPIO_LP_IO_PIN_COUNT 8       
#define HF_MCU_GPIO_ADC_PIN_COUNT 7         
#define HF_MCU_GPIO_FLEX_FILTER_COUNT 8     
#define HF_MCU_GPIO_TOUCH_PIN_COUNT 0       
#define HF_MCU_GPIO_DAC_PIN_COUNT 0         
#define HF_MCU_GPIO_ETM_CHANNEL_COUNT 50    
#define HF_MCU_GPIO_ETM_EVENT_COUNT_MAX 100 
#define HF_MCU_GPIO_ETM_TASK_COUNT_MAX 100  
 
// ESP32-C6 Clock frequencies for glitch filter timing calculations
#define HF_MCU_GPIO_APB_CLK_FREQ_HZ 80000000UL     
#define HF_MCU_GPIO_RC_FAST_CLK_FREQ_HZ 17500000UL 
#define HF_MCU_GPIO_XTAL_CLK_FREQ_HZ 40000000UL    
 
// ESP32-C6 GPIO timing limits and characteristics
#define HF_MCU_GPIO_MAX_TOGGLE_FREQ_HZ 40000000UL  
#define HF_MCU_GPIO_MIN_GLITCH_FILTER_NS 25UL      
#define HF_MCU_GPIO_MAX_GLITCH_FILTER_NS 1000000UL 
 
// ESP32-C6 GPIO Feature Support Flags
#define HF_MCU_GPIO_HAS_GLITCH_FILTER 1  
#define HF_MCU_GPIO_HAS_RTC_GPIO 1       
#define HF_MCU_GPIO_HAS_LP_IO 1          
#define HF_MCU_GPIO_HAS_ETM 1            
#define HF_MCU_GPIO_HAS_HOLD_FUNCTION 1  
#define HF_MCU_GPIO_HAS_SLEEP_CONFIG 1   
#define HF_MCU_GPIO_HAS_WAKEUP_CONFIG 1  
#define HF_MCU_GPIO_HAS_DRIVE_STRENGTH 1 
 
// ADC capabilities (ESP32-C6 specific)
#define HF_MCU_HAS_ADC 1
#define HF_MCU_ADC_MAX_CHANNELS 7 // ESP32-C6 has 7 ADC channels (0-6)
#define HF_MCU_ADC_MAX_RESOLUTION 12
#define HF_MCU_ADC_HAS_ATTENUATION 1
#define HF_MCU_ADC_NUM_UNITS 1 // ESP32-C6 has only ADC1
 
// I2C capabilities
#define HF_MCU_HAS_I2C 1
#define HF_MCU_I2C_MAX_PORTS 1 // ESP32-C6 has 1 I2C port
#define HF_MCU_I2C_MAX_FREQ_HZ 1000000
#define HF_MCU_I2C_HAS_SLAVE_MODE 1
 
// SPI capabilities
#define HF_MCU_HAS_SPI 1
#define HF_MCU_SPI_MAX_HOSTS 2 // ESP32-C6 has SPI2 and SPI3
#define HF_MCU_SPI_MAX_FREQ_HZ 60000000
#define HF_MCU_SPI_HAS_DMA 1
 
// UART capabilities
#define HF_MCU_HAS_UART 1
#define HF_MCU_UART_MAX_PORTS 2 // ESP32-C6 has UART0 and UART1
#define HF_MCU_UART_MAX_BAUDRATE 5000000
#define HF_MCU_UART_HAS_FLOW_CONTROL 1
 
// CAN capabilities (TWAI)
#define HF_MCU_HAS_CAN 1
#define HF_MCU_CAN_MAX_CONTROLLERS 2
#define HF_MCU_CAN_HAS_LISTEN_ONLY 1
#define HF_MCU_CAN_HAS_SELF_TEST 1
#define HF_MCU_CAN_PROTOCOL "TWAI"
 
// PWM capabilities (LEDC)
#define HF_MCU_HAS_PWM 1
#define HF_MCU_PWM_MAX_CHANNELS 6 // ESP32-C6 has 6 LEDC channels
#define HF_MCU_PWM_MAX_FREQ_HZ 40000000
#define HF_MCU_PWM_MAX_RESOLUTION 14 // ESP32-C6 max is 14-bit
 
// RMT capabilities (not PIO)
#define HF_MCU_HAS_PIO 0
#define HF_MCU_HAS_RMT 1
#define HF_MCU_RMT_MAX_CHANNELS 4 // ESP32-C6 has 4 RMT channels
 
// ESP32 Classic Capabilities (Secondary Support)
#elif defined(HF_MCU_ESP32)
// GPIO capabilities
#define HF_MCU_HAS_GPIO 1
#define HF_MCU_GPIO_MAX_PINS 40 // ESP32 has 40 GPIO pins
#define HF_MCU_GPIO_HAS_PULLUP 1
#define HF_MCU_GPIO_HAS_PULLDOWN 1
#define HF_MCU_GPIO_HAS_INTERRUPTS 1
 
// ESP32 Classic Advanced GPIO Hardware Constants
#define HF_MCU_GPIO_PIN_COUNT 40            
#define HF_MCU_GPIO_MAX_PIN_NUMBER 39       
#define HF_MCU_GPIO_RTC_PIN_COUNT 18        
#define HF_MCU_GPIO_LP_IO_PIN_COUNT 0       
#define HF_MCU_GPIO_ADC_PIN_COUNT 18        
#define HF_MCU_GPIO_FLEX_FILTER_COUNT 0     
#define HF_MCU_GPIO_TOUCH_PIN_COUNT 10      
#define HF_MCU_GPIO_DAC_PIN_COUNT 2         
#define HF_MCU_GPIO_ETM_CHANNEL_COUNT 0     
#define HF_MCU_GPIO_ETM_EVENT_COUNT_MAX 0
#define HF_MCU_GPIO_ETM_TASK_COUNT_MAX 0
 
#define HF_MCU_GPIO_APB_CLK_FREQ_HZ 80000000UL
#define HF_MCU_GPIO_RC_FAST_CLK_FREQ_HZ 8500000UL
#define HF_MCU_GPIO_XTAL_CLK_FREQ_HZ 40000000UL
#define HF_MCU_GPIO_MAX_TOGGLE_FREQ_HZ 40000000UL
#define HF_MCU_GPIO_MIN_GLITCH_FILTER_NS 0UL
#define HF_MCU_GPIO_MAX_GLITCH_FILTER_NS 0UL
 
#define HF_MCU_GPIO_HAS_GLITCH_FILTER 0
#define HF_MCU_GPIO_HAS_RTC_GPIO 1
#define HF_MCU_GPIO_HAS_LP_IO 0
#define HF_MCU_GPIO_HAS_ETM 0
#define HF_MCU_GPIO_HAS_HOLD_FUNCTION 1
#define HF_MCU_GPIO_HAS_SLEEP_CONFIG 1
#define HF_MCU_GPIO_HAS_WAKEUP_CONFIG 1
#define HF_MCU_GPIO_HAS_DRIVE_STRENGTH 1
 
// ADC capabilities
#define HF_MCU_HAS_ADC 1
#define HF_MCU_ADC_MAX_CHANNELS 18
#define HF_MCU_ADC_MAX_RESOLUTION 12
#define HF_MCU_ADC_HAS_ATTENUATION 1
#define HF_MCU_ADC_NUM_UNITS 2
 
// I2C capabilities
#define HF_MCU_HAS_I2C 1
#define HF_MCU_I2C_MAX_PORTS 2
#define HF_MCU_I2C_MAX_FREQ_HZ 1000000
#define HF_MCU_I2C_HAS_SLAVE_MODE 1
 
// SPI capabilities
#define HF_MCU_HAS_SPI 1
#define HF_MCU_SPI_MAX_HOSTS 3
#define HF_MCU_SPI_MAX_FREQ_HZ 80000000
#define HF_MCU_SPI_HAS_DMA 1
 
// UART capabilities
#define HF_MCU_HAS_UART 1
#define HF_MCU_UART_MAX_PORTS 3
#define HF_MCU_UART_MAX_BAUDRATE 5000000
#define HF_MCU_UART_HAS_FLOW_CONTROL 1
 
// CAN capabilities
#define HF_MCU_HAS_CAN 1
#define HF_MCU_CAN_MAX_CONTROLLERS 1
#define HF_MCU_CAN_HAS_LISTEN_ONLY 1
#define HF_MCU_CAN_HAS_SELF_TEST 1
#define HF_MCU_CAN_PROTOCOL "CAN"
 
// PWM capabilities
#define HF_MCU_HAS_PWM 1
#define HF_MCU_PWM_MAX_CHANNELS 16
#define HF_MCU_PWM_MAX_FREQ_HZ 40000000
#define HF_MCU_PWM_MAX_RESOLUTION 20
 
// RMT capabilities
#define HF_MCU_HAS_PIO 0
#define HF_MCU_HAS_RMT 1
#define HF_MCU_RMT_MAX_CHANNELS 8
 
// ESP32-S3 Capabilities
#elif defined(HF_MCU_ESP32S3)
#define HF_MCU_HAS_GPIO 1
#define HF_MCU_GPIO_MAX_PINS 49
#define HF_MCU_GPIO_HAS_PULLUP 1
#define HF_MCU_GPIO_HAS_PULLDOWN 1
#define HF_MCU_GPIO_HAS_INTERRUPTS 1
 
#define HF_MCU_GPIO_PIN_COUNT 49
#define HF_MCU_GPIO_MAX_PIN_NUMBER 48
#define HF_MCU_GPIO_RTC_PIN_COUNT 22
#define HF_MCU_GPIO_LP_IO_PIN_COUNT 0
#define HF_MCU_GPIO_ADC_PIN_COUNT 20
#define HF_MCU_GPIO_FLEX_FILTER_COUNT 8
#define HF_MCU_GPIO_TOUCH_PIN_COUNT 14
#define HF_MCU_GPIO_DAC_PIN_COUNT 0
#define HF_MCU_GPIO_ETM_CHANNEL_COUNT 50
#define HF_MCU_GPIO_ETM_EVENT_COUNT_MAX 100
#define HF_MCU_GPIO_ETM_TASK_COUNT_MAX 100
 
#define HF_MCU_GPIO_APB_CLK_FREQ_HZ 80000000UL
#define HF_MCU_GPIO_RC_FAST_CLK_FREQ_HZ 17500000UL
#define HF_MCU_GPIO_XTAL_CLK_FREQ_HZ 40000000UL
#define HF_MCU_GPIO_MAX_TOGGLE_FREQ_HZ 40000000UL
#define HF_MCU_GPIO_MIN_GLITCH_FILTER_NS 25UL
#define HF_MCU_GPIO_MAX_GLITCH_FILTER_NS 1000000UL
 
#define HF_MCU_GPIO_HAS_GLITCH_FILTER 1
#define HF_MCU_GPIO_HAS_RTC_GPIO 1
#define HF_MCU_GPIO_HAS_LP_IO 0
#define HF_MCU_GPIO_HAS_ETM 1
#define HF_MCU_GPIO_HAS_HOLD_FUNCTION 1
#define HF_MCU_GPIO_HAS_SLEEP_CONFIG 1
#define HF_MCU_GPIO_HAS_WAKEUP_CONFIG 1
#define HF_MCU_GPIO_HAS_DRIVE_STRENGTH 1
 
#define HF_MCU_HAS_ADC 1
#define HF_MCU_ADC_MAX_CHANNELS 20
#define HF_MCU_ADC_MAX_RESOLUTION 12
#define HF_MCU_ADC_HAS_ATTENUATION 1
#define HF_MCU_ADC_NUM_UNITS 2
 
#define HF_MCU_HAS_I2C 1
#define HF_MCU_I2C_MAX_PORTS 2
#define HF_MCU_I2C_MAX_FREQ_HZ 1000000
#define HF_MCU_I2C_HAS_SLAVE_MODE 1
 
#define HF_MCU_HAS_SPI 1
#define HF_MCU_SPI_MAX_HOSTS 3
#define HF_MCU_SPI_MAX_FREQ_HZ 80000000
#define HF_MCU_SPI_HAS_DMA 1
 
#define HF_MCU_HAS_UART 1
#define HF_MCU_UART_MAX_PORTS 3
#define HF_MCU_UART_MAX_BAUDRATE 5000000
#define HF_MCU_UART_HAS_FLOW_CONTROL 1
 
#define HF_MCU_HAS_CAN 1
#define HF_MCU_CAN_MAX_CONTROLLERS 1
#define HF_MCU_CAN_HAS_LISTEN_ONLY 1
#define HF_MCU_CAN_HAS_SELF_TEST 1
#define HF_MCU_CAN_PROTOCOL "TWAI"
 
#define HF_MCU_HAS_PWM 1
#define HF_MCU_PWM_MAX_CHANNELS 8
#define HF_MCU_PWM_MAX_FREQ_HZ 40000000
#define HF_MCU_PWM_MAX_RESOLUTION 14
 
#define HF_MCU_HAS_PIO 0
#define HF_MCU_HAS_RMT 1
#define HF_MCU_RMT_MAX_CHANNELS 8
 
// ESP32-S2 Capabilities
#elif defined(HF_MCU_ESP32S2)
#define HF_MCU_HAS_GPIO 1
#define HF_MCU_GPIO_MAX_PINS 47
#define HF_MCU_GPIO_HAS_PULLUP 1
#define HF_MCU_GPIO_HAS_PULLDOWN 1
#define HF_MCU_GPIO_HAS_INTERRUPTS 1
 
#define HF_MCU_GPIO_PIN_COUNT 47
#define HF_MCU_GPIO_MAX_PIN_NUMBER 46
#define HF_MCU_GPIO_RTC_PIN_COUNT 22
#define HF_MCU_GPIO_LP_IO_PIN_COUNT 0
#define HF_MCU_GPIO_ADC_PIN_COUNT 20
#define HF_MCU_GPIO_FLEX_FILTER_COUNT 0
#define HF_MCU_GPIO_TOUCH_PIN_COUNT 14
#define HF_MCU_GPIO_DAC_PIN_COUNT 2
#define HF_MCU_GPIO_ETM_CHANNEL_COUNT 0
#define HF_MCU_GPIO_ETM_EVENT_COUNT_MAX 0
#define HF_MCU_GPIO_ETM_TASK_COUNT_MAX 0
 
#define HF_MCU_GPIO_APB_CLK_FREQ_HZ 80000000UL
#define HF_MCU_GPIO_RC_FAST_CLK_FREQ_HZ 8500000UL
#define HF_MCU_GPIO_XTAL_CLK_FREQ_HZ 40000000UL
#define HF_MCU_GPIO_MAX_TOGGLE_FREQ_HZ 40000000UL
#define HF_MCU_GPIO_MIN_GLITCH_FILTER_NS 0UL
#define HF_MCU_GPIO_MAX_GLITCH_FILTER_NS 0UL
 
#define HF_MCU_GPIO_HAS_GLITCH_FILTER 0
#define HF_MCU_GPIO_HAS_RTC_GPIO 1
#define HF_MCU_GPIO_HAS_LP_IO 0
#define HF_MCU_GPIO_HAS_ETM 0
#define HF_MCU_GPIO_HAS_HOLD_FUNCTION 1
#define HF_MCU_GPIO_HAS_SLEEP_CONFIG 1
#define HF_MCU_GPIO_HAS_WAKEUP_CONFIG 1
#define HF_MCU_GPIO_HAS_DRIVE_STRENGTH 1
 
#define HF_MCU_HAS_ADC 1
#define HF_MCU_ADC_MAX_CHANNELS 20
#define HF_MCU_ADC_MAX_RESOLUTION 13
#define HF_MCU_ADC_HAS_ATTENUATION 1
#define HF_MCU_ADC_NUM_UNITS 2
 
#define HF_MCU_HAS_I2C 1
#define HF_MCU_I2C_MAX_PORTS 2
#define HF_MCU_I2C_MAX_FREQ_HZ 1000000
#define HF_MCU_I2C_HAS_SLAVE_MODE 1
 
#define HF_MCU_HAS_SPI 1
#define HF_MCU_SPI_MAX_HOSTS 3
#define HF_MCU_SPI_MAX_FREQ_HZ 80000000
#define HF_MCU_SPI_HAS_DMA 1
 
#define HF_MCU_HAS_UART 1
#define HF_MCU_UART_MAX_PORTS 2
#define HF_MCU_UART_MAX_BAUDRATE 5000000
#define HF_MCU_UART_HAS_FLOW_CONTROL 1
 
#define HF_MCU_HAS_CAN 1
#define HF_MCU_CAN_MAX_CONTROLLERS 1
#define HF_MCU_CAN_HAS_LISTEN_ONLY 1
#define HF_MCU_CAN_HAS_SELF_TEST 1
#define HF_MCU_CAN_PROTOCOL "TWAI"
 
#define HF_MCU_HAS_PWM 1
#define HF_MCU_PWM_MAX_CHANNELS 8
#define HF_MCU_PWM_MAX_FREQ_HZ 40000000
#define HF_MCU_PWM_MAX_RESOLUTION 14
 
#define HF_MCU_HAS_PIO 0
#define HF_MCU_HAS_RMT 1
#define HF_MCU_RMT_MAX_CHANNELS 4
 
// ESP32-C3 Capabilities
#elif defined(HF_MCU_ESP32C3)
#define HF_MCU_HAS_GPIO 1
#define HF_MCU_GPIO_MAX_PINS 22
#define HF_MCU_GPIO_HAS_PULLUP 1
#define HF_MCU_GPIO_HAS_PULLDOWN 1
#define HF_MCU_GPIO_HAS_INTERRUPTS 1
 
#define HF_MCU_GPIO_PIN_COUNT 22
#define HF_MCU_GPIO_MAX_PIN_NUMBER 21
#define HF_MCU_GPIO_RTC_PIN_COUNT 6
#define HF_MCU_GPIO_LP_IO_PIN_COUNT 0
#define HF_MCU_GPIO_ADC_PIN_COUNT 6
#define HF_MCU_GPIO_FLEX_FILTER_COUNT 8
#define HF_MCU_GPIO_TOUCH_PIN_COUNT 0
#define HF_MCU_GPIO_DAC_PIN_COUNT 0
#define HF_MCU_GPIO_ETM_CHANNEL_COUNT 0
#define HF_MCU_GPIO_ETM_EVENT_COUNT_MAX 0
#define HF_MCU_GPIO_ETM_TASK_COUNT_MAX 0
 
#define HF_MCU_GPIO_APB_CLK_FREQ_HZ 80000000UL
#define HF_MCU_GPIO_RC_FAST_CLK_FREQ_HZ 17500000UL
#define HF_MCU_GPIO_XTAL_CLK_FREQ_HZ 40000000UL
#define HF_MCU_GPIO_MAX_TOGGLE_FREQ_HZ 40000000UL
#define HF_MCU_GPIO_MIN_GLITCH_FILTER_NS 25UL
#define HF_MCU_GPIO_MAX_GLITCH_FILTER_NS 1000000UL
 
#define HF_MCU_GPIO_HAS_GLITCH_FILTER 1
#define HF_MCU_GPIO_HAS_RTC_GPIO 1
#define HF_MCU_GPIO_HAS_LP_IO 0
#define HF_MCU_GPIO_HAS_ETM 0
#define HF_MCU_GPIO_HAS_HOLD_FUNCTION 1
#define HF_MCU_GPIO_HAS_SLEEP_CONFIG 1
#define HF_MCU_GPIO_HAS_WAKEUP_CONFIG 1
#define HF_MCU_GPIO_HAS_DRIVE_STRENGTH 1
 
#define HF_MCU_HAS_ADC 1
#define HF_MCU_ADC_MAX_CHANNELS 6
#define HF_MCU_ADC_MAX_RESOLUTION 12
#define HF_MCU_ADC_HAS_ATTENUATION 1
#define HF_MCU_ADC_NUM_UNITS 2
 
#define HF_MCU_HAS_I2C 1
#define HF_MCU_I2C_MAX_PORTS 1
#define HF_MCU_I2C_MAX_FREQ_HZ 1000000
#define HF_MCU_I2C_HAS_SLAVE_MODE 1
 
#define HF_MCU_HAS_SPI 1
#define HF_MCU_SPI_MAX_HOSTS 2
#define HF_MCU_SPI_MAX_FREQ_HZ 60000000
#define HF_MCU_SPI_HAS_DMA 1
 
#define HF_MCU_HAS_UART 1
#define HF_MCU_UART_MAX_PORTS 2
#define HF_MCU_UART_MAX_BAUDRATE 5000000
#define HF_MCU_UART_HAS_FLOW_CONTROL 1
 
#define HF_MCU_HAS_CAN 1
#define HF_MCU_CAN_MAX_CONTROLLERS 1
#define HF_MCU_CAN_HAS_LISTEN_ONLY 1
#define HF_MCU_CAN_HAS_SELF_TEST 1
#define HF_MCU_CAN_PROTOCOL "TWAI"
 
#define HF_MCU_HAS_PWM 1
#define HF_MCU_PWM_MAX_CHANNELS 6
#define HF_MCU_PWM_MAX_FREQ_HZ 40000000
#define HF_MCU_PWM_MAX_RESOLUTION 14
 
#define HF_MCU_HAS_PIO 0
#define HF_MCU_HAS_RMT 1
#define HF_MCU_RMT_MAX_CHANNELS 4
 
// ESP32-C2 Capabilities
#elif defined(HF_MCU_ESP32C2)
#define HF_MCU_HAS_GPIO 1
#define HF_MCU_GPIO_MAX_PINS 21
#define HF_MCU_GPIO_HAS_PULLUP 1
#define HF_MCU_GPIO_HAS_PULLDOWN 1
#define HF_MCU_GPIO_HAS_INTERRUPTS 1
 
#define HF_MCU_GPIO_PIN_COUNT 21
#define HF_MCU_GPIO_MAX_PIN_NUMBER 20
#define HF_MCU_GPIO_RTC_PIN_COUNT 5
#define HF_MCU_GPIO_LP_IO_PIN_COUNT 0
#define HF_MCU_GPIO_ADC_PIN_COUNT 5
#define HF_MCU_GPIO_FLEX_FILTER_COUNT 0
#define HF_MCU_GPIO_TOUCH_PIN_COUNT 0
#define HF_MCU_GPIO_DAC_PIN_COUNT 0
#define HF_MCU_GPIO_ETM_CHANNEL_COUNT 0
#define HF_MCU_GPIO_ETM_EVENT_COUNT_MAX 0
#define HF_MCU_GPIO_ETM_TASK_COUNT_MAX 0
 
#define HF_MCU_GPIO_APB_CLK_FREQ_HZ 40000000UL
#define HF_MCU_GPIO_RC_FAST_CLK_FREQ_HZ 17500000UL
#define HF_MCU_GPIO_XTAL_CLK_FREQ_HZ 40000000UL
#define HF_MCU_GPIO_MAX_TOGGLE_FREQ_HZ 20000000UL
#define HF_MCU_GPIO_MIN_GLITCH_FILTER_NS 0UL
#define HF_MCU_GPIO_MAX_GLITCH_FILTER_NS 0UL
 
#define HF_MCU_GPIO_HAS_GLITCH_FILTER 0
#define HF_MCU_GPIO_HAS_RTC_GPIO 1
#define HF_MCU_GPIO_HAS_LP_IO 0
#define HF_MCU_GPIO_HAS_ETM 0
#define HF_MCU_GPIO_HAS_HOLD_FUNCTION 1
#define HF_MCU_GPIO_HAS_SLEEP_CONFIG 1
#define HF_MCU_GPIO_HAS_WAKEUP_CONFIG 1
#define HF_MCU_GPIO_HAS_DRIVE_STRENGTH 1
 
#define HF_MCU_HAS_ADC 1
#define HF_MCU_ADC_MAX_CHANNELS 5
#define HF_MCU_ADC_MAX_RESOLUTION 12
#define HF_MCU_ADC_HAS_ATTENUATION 1
#define HF_MCU_ADC_NUM_UNITS 1
 
#define HF_MCU_HAS_I2C 1
#define HF_MCU_I2C_MAX_PORTS 1
#define HF_MCU_I2C_MAX_FREQ_HZ 1000000
#define HF_MCU_I2C_HAS_SLAVE_MODE 1
 
#define HF_MCU_HAS_SPI 1
#define HF_MCU_SPI_MAX_HOSTS 2
#define HF_MCU_SPI_MAX_FREQ_HZ 60000000
#define HF_MCU_SPI_HAS_DMA 1
 
#define HF_MCU_HAS_UART 1
#define HF_MCU_UART_MAX_PORTS 2
#define HF_MCU_UART_MAX_BAUDRATE 5000000
#define HF_MCU_UART_HAS_FLOW_CONTROL 1
 
#define HF_MCU_HAS_CAN 0
#define HF_MCU_CAN_MAX_CONTROLLERS 0
#define HF_MCU_CAN_HAS_LISTEN_ONLY 0
#define HF_MCU_CAN_HAS_SELF_TEST 0
#define HF_MCU_CAN_PROTOCOL "NONE"
 
#define HF_MCU_HAS_PWM 1
#define HF_MCU_PWM_MAX_CHANNELS 6
#define HF_MCU_PWM_MAX_FREQ_HZ 40000000
#define HF_MCU_PWM_MAX_RESOLUTION 14
 
#define HF_MCU_HAS_PIO 0
#define HF_MCU_HAS_RMT 0
#define HF_MCU_RMT_MAX_CHANNELS 0
 
// ESP32-H2 Capabilities
#elif defined(HF_MCU_ESP32H2)
#define HF_MCU_HAS_GPIO 1
#define HF_MCU_GPIO_MAX_PINS 28
#define HF_MCU_GPIO_HAS_PULLUP 1
#define HF_MCU_GPIO_HAS_PULLDOWN 1
#define HF_MCU_GPIO_HAS_INTERRUPTS 1
 
#define HF_MCU_GPIO_PIN_COUNT 28
#define HF_MCU_GPIO_MAX_PIN_NUMBER 27
#define HF_MCU_GPIO_RTC_PIN_COUNT 8
#define HF_MCU_GPIO_LP_IO_PIN_COUNT 8
#define HF_MCU_GPIO_ADC_PIN_COUNT 5
#define HF_MCU_GPIO_FLEX_FILTER_COUNT 8
#define HF_MCU_GPIO_TOUCH_PIN_COUNT 0
#define HF_MCU_GPIO_DAC_PIN_COUNT 0
#define HF_MCU_GPIO_ETM_CHANNEL_COUNT 50
#define HF_MCU_GPIO_ETM_EVENT_COUNT_MAX 100
#define HF_MCU_GPIO_ETM_TASK_COUNT_MAX 100
 
#define HF_MCU_GPIO_APB_CLK_FREQ_HZ 32000000UL
#define HF_MCU_GPIO_RC_FAST_CLK_FREQ_HZ 17500000UL
#define HF_MCU_GPIO_XTAL_CLK_FREQ_HZ 32000000UL
#define HF_MCU_GPIO_MAX_TOGGLE_FREQ_HZ 16000000UL
#define HF_MCU_GPIO_MIN_GLITCH_FILTER_NS 25UL
#define HF_MCU_GPIO_MAX_GLITCH_FILTER_NS 1000000UL
 
#define HF_MCU_GPIO_HAS_GLITCH_FILTER 1
#define HF_MCU_GPIO_HAS_RTC_GPIO 1
#define HF_MCU_GPIO_HAS_LP_IO 1
#define HF_MCU_GPIO_HAS_ETM 1
#define HF_MCU_GPIO_HAS_HOLD_FUNCTION 1
#define HF_MCU_GPIO_HAS_SLEEP_CONFIG 1
#define HF_MCU_GPIO_HAS_WAKEUP_CONFIG 1
#define HF_MCU_GPIO_HAS_DRIVE_STRENGTH 1
 
#define HF_MCU_HAS_ADC 1
#define HF_MCU_ADC_MAX_CHANNELS 5
#define HF_MCU_ADC_MAX_RESOLUTION 12
#define HF_MCU_ADC_HAS_ATTENUATION 1
#define HF_MCU_ADC_NUM_UNITS 1
 
#define HF_MCU_HAS_I2C 1
#define HF_MCU_I2C_MAX_PORTS 2
#define HF_MCU_I2C_MAX_FREQ_HZ 1000000
#define HF_MCU_I2C_HAS_SLAVE_MODE 1
 
#define HF_MCU_HAS_SPI 1
#define HF_MCU_SPI_MAX_HOSTS 2
#define HF_MCU_SPI_MAX_FREQ_HZ 60000000
#define HF_MCU_SPI_HAS_DMA 1
 
#define HF_MCU_HAS_UART 1
#define HF_MCU_UART_MAX_PORTS 2
#define HF_MCU_UART_MAX_BAUDRATE 5000000
#define HF_MCU_UART_HAS_FLOW_CONTROL 1
 
#define HF_MCU_HAS_CAN 0
#define HF_MCU_CAN_MAX_CONTROLLERS 0
#define HF_MCU_CAN_HAS_LISTEN_ONLY 0
#define HF_MCU_CAN_HAS_SELF_TEST 0
#define HF_MCU_CAN_PROTOCOL "NONE"
 
#define HF_MCU_HAS_PWM 1
#define HF_MCU_PWM_MAX_CHANNELS 6
#define HF_MCU_PWM_MAX_FREQ_HZ 40000000
#define HF_MCU_PWM_MAX_RESOLUTION 14
 
#define HF_MCU_HAS_PIO 0
#define HF_MCU_HAS_RMT 1
#define HF_MCU_RMT_MAX_CHANNELS 4
 
#endif
 
//==============================================================================
// MCU CONFIGURATION CONSTANTS
//==============================================================================
 
// ESP32-C6 Configuration Constants
#ifdef HF_MCU_ESP32C6
// Default timeout values
#define HF_MCU_DEFAULT_TIMEOUT_MS 1000
#define HF_MCU_I2C_TIMEOUT_MS 500 // Reduced for faster response
#define HF_MCU_SPI_TIMEOUT_MS 1000
#define HF_MCU_UART_TIMEOUT_MS 1000
#define HF_MCU_CAN_TIMEOUT_MS 500
 
// Buffer sizes (optimized for ESP32-C6)
#define HF_MCU_UART_RX_BUFFER_SIZE 512 // Increased for motor control
#define HF_MCU_UART_TX_BUFFER_SIZE 256
#define HF_MCU_I2C_BUFFER_SIZE 64 // Reduced for ESP32-C6
#define HF_MCU_SPI_BUFFER_SIZE 256
#define HF_MCU_CAN_RX_QUEUE_SIZE 16 // Optimized for ESP32-C6
#define HF_MCU_CAN_TX_QUEUE_SIZE 16
 
// Stack sizes for tasks (optimized for RISC-V)
#define HF_MCU_TASK_STACK_SIZE 3072 // Reduced for RISC-V efficiency
#define HF_MCU_TASK_PRIORITY 5
 
// ADC specific constants
#define HF_MCU_ADC_DEFAULT_VREF 1100 // mV, ESP32-C6 default
#define HF_MCU_ADC_MAX_VOLTAGE 3300  // mV, with 11dB attenuation
 
// ESP32 Classic Configuration Constants
#elif defined(HF_MCU_ESP32)
// Default timeout values
#define HF_MCU_DEFAULT_TIMEOUT_MS 1000
#define HF_MCU_I2C_TIMEOUT_MS 1000
#define HF_MCU_SPI_TIMEOUT_MS 1000
#define HF_MCU_UART_TIMEOUT_MS 1000
#define HF_MCU_CAN_TIMEOUT_MS 1000
 
// Buffer sizes
#define HF_MCU_UART_RX_BUFFER_SIZE 256
#define HF_MCU_UART_TX_BUFFER_SIZE 256
#define HF_MCU_I2C_BUFFER_SIZE 128
#define HF_MCU_SPI_BUFFER_SIZE 256
#define HF_MCU_CAN_RX_QUEUE_SIZE 32
#define HF_MCU_CAN_TX_QUEUE_SIZE 32
 
// Stack sizes for tasks
#define HF_MCU_TASK_STACK_SIZE 4096
#define HF_MCU_TASK_PRIORITY 5
 
// ADC specific constants
#define HF_MCU_ADC_DEFAULT_VREF 1100 // mV
#define HF_MCU_ADC_MAX_VOLTAGE 3900  // mV, with 11dB attenuation
 
// ESP32-S3 / S2 / C3 / C2 / H2 Configuration Constants (shared defaults)
#elif defined(HF_MCU_ESP32S3) || defined(HF_MCU_ESP32S2) || defined(HF_MCU_ESP32C3) || \
      defined(HF_MCU_ESP32C2) || defined(HF_MCU_ESP32H2)
#define HF_MCU_DEFAULT_TIMEOUT_MS 1000
#define HF_MCU_I2C_TIMEOUT_MS 500
#define HF_MCU_SPI_TIMEOUT_MS 1000
#define HF_MCU_UART_TIMEOUT_MS 1000
#define HF_MCU_CAN_TIMEOUT_MS 500
 
#define HF_MCU_UART_RX_BUFFER_SIZE 512
#define HF_MCU_UART_TX_BUFFER_SIZE 256
#define HF_MCU_I2C_BUFFER_SIZE 64
#define HF_MCU_SPI_BUFFER_SIZE 256
#define HF_MCU_CAN_RX_QUEUE_SIZE 16
#define HF_MCU_CAN_TX_QUEUE_SIZE 16
 
#if defined(HF_MCU_ESP32S3) || defined(HF_MCU_ESP32S2)
#define HF_MCU_TASK_STACK_SIZE 4096  // Xtensa
#else
#define HF_MCU_TASK_STACK_SIZE 3072  // RISC-V
#endif
#define HF_MCU_TASK_PRIORITY 5
 
#define HF_MCU_ADC_DEFAULT_VREF 1100
#define HF_MCU_ADC_MAX_VOLTAGE 3300
#endif
 
//==============================================================================
// END OF MCU SELECT HEADER
//==============================================================================