fix(esp_board_manager): add lyrat_mini_v1_1 board full support

- Add complete YAML configuration files for ESP32 Lyrat Mini V1.1 board
  * board_info.yaml: Board metadata and description
  * board_peripherals.yaml: I2C, I2S, GPIO peripherals configuration
  * board_devices.yaml: ES8311 DAC, ES7243E ADC, and SD card devices

- Enhance I2S peripheral support with improved configuration handling
- Add board_utils.py helper functions for board configuration
- Fixed build errors caused by incorrect use of `extern "C"` guards in `esp_board_manager_includes.h`
- Remove unused test_apps dependency
- Update audio codec device implementation for better compatibility
- Updated version to v0.4.2

Author: jason-mao

packages/esp_board_manager/CHANGELOG.md

@@ -1,15 +1,36 @@
 # Changelog
 
+## v0.4.2
+
+### Features
+
+- Added full board support for ESP32 Lyrat Mini V1.1
+  * Complete YAML configuration files (board_info.yaml, board_peripherals.yaml, board_devices.yaml)
+  * Support for ES8311 DAC, ES7243E ADC, and SD card devices
+  * I2C, I2S, and GPIO peripherals configuration
+- Enhanced I2S peripheral support with improved configuration handling
+- Added `board_utils.py` helper functions for board configuration
+
+### Bug Fixes
+
+- Fixed build errors caused by incorrect use of `extern "C"` guards in `esp_board_manager_includes.h`
+- Removed unused dependency on `test_apps`
+- Updated audio codec device implementation for better compatibility
+- Appended `esp_board_manager_defs.h` to `esp_board_manager_includes.h` to ensure all necessary header
+files are included
+
 ## v0.4.1
 
 ### Features
+
 - Renamed esp_board_manager_ext.py to idf_ext.py for compatibility with ESP-IDF v6.0 auto-discovery
 - Update `Kconfig.in` with new configuration options to hide the board selection menu
 - Update the README to include information about how to add new boards and the development roadmap
 - Added the esp_board_periph_ref_handle and esp_board_periph_unref_handle APIs to obtain and release a handle
 - Added esp_board_find_utils.h and esp_board_manager_includes.h
 
 ### Bug Fixes
+
 - Delete only `build/CMakeCache.txt` to avoid a full clean when switching boards
 - Fixed the configuration of the sdmmc sdcard host slot, ensuring the configuration for the host slot in the yml file takes effect correctly
 - Using slot 0 to drive the sdcard for p4_function board, avoiding conflict with wifi hosted
@@ -18,6 +39,7 @@
 ## v0.4.0
 
 ### Features
+
 - Add `init_skip` field to control device auto-initialization
 - Add custom device type with test support
 - Add gpio expander device type with test support
@@ -37,12 +59,14 @@
 - Clear the build directory to get the correct dependencies when switching boards
 
 ### Supported Boards
+
 - **ESP32-S3 Korvo2 V3**: Full LCD, LCD Touch, DVP Camera support
 - **ESP32-P4 Function-EV**: Codec, SD card supported
 
 ## v0.3.0 (Initial Release)
 
 ### Core Features
+
 - **ESP Board Manager**: Initial release of comprehensive board configuration management system
 - **YAML-based Configuration**: Support for `board_peripherals.yaml` and `board_devices.yaml` configuration files
 - **Automatic Code Generation**: Modular code generation system with 8-step streamlined process
@@ -51,6 +75,7 @@
 - **SDK Configuration Automation**: Automatic ESP-IDF feature enabling based on board requirements
 
 ### Supported Boards
+
 - **Echoear Core Board V1.0**: Full audio, LCD, touch, and SD card support
 - **ESP-BOX-3**: ESP32-S3 development board with I2C, I2S, SPI, LEDC, and GPIO support
 - **Dual Eyes Board V1.0**: Dual LCD display with touch support
@@ -60,13 +85,15 @@
 - **ESP32-C5 Spot**: YAML configurations support
 
 ### Peripheral Support
+
 - **I2C**: Full support with type safety
 - **I2S**: Complete audio interface support
 - **SPI**: Full peripheral and device support
 - **LEDC**: PWM and LED control support
 - **GPIO**: GPIO support
 
 ### Device Support
+
 - **Audio Codecs**: ES8311, ES7210, and other audio codec devices
 - **SD Cards**: FATFS filesystem support
 - **LCD Displays**: SPI LCD with LVGL integration
@@ -76,12 +103,14 @@
 - **GPIO Control**: GPIO output control
 
 ### APP Interfaces
+
 - **Board Manager API**: `esp_board_manager_init()`, `esp_board_manager_deinit()`, `esp_board_manager_print()`
 - **Peripheral API**: `esp_board_manager_get_periph_config()`, `esp_board_manager_get_periph_handle()`
 - **Device API**: `esp_board_manager_get_device_config()`, `esp_board_manager_get_device_handle()`
 - **Error Handling**: Comprehensive error codes and macros (`ESP_BOARD_RETURN_ON_ERROR`)
 
 ### Documentation & Testing
+
 - **Comprehensive Documentation**: README, API documentation, and configuration guides
 - **Test Applications**: Complete test suite for all peripherals and devices
 - **Configuration Rules**: Detailed YAML configuration rules and best practices

packages/esp_board_manager/CMakeLists.txt

@@ -28,6 +28,7 @@ idf_component_register(
         ${DEVICE_INCLUDES}  # Add device includes
     REQUIRES
         driver
+        esp_driver_i2s
         esp_common
         fatfs
         esp_lcd

packages/esp_board_manager/boards/lyrat_mini_v1_1/board_devices.yaml

@@ -3,13 +3,66 @@ chip: esp32
 version: 1.0.0
 # Devices Configuration
 devices:
+  # SD Card Power Control
+  - name: lcd_power
+    type: gpio_ctrl
+    version: default
+    config:
+      active_level: 0              # Low level to enable power
+      default_level: 1             # Default to power off
+    peripherals:
+      - name: gpio_sd_power              # SDCARD_PWR_CTRL
+
+  # Audio Codec (ES8311) - DAC for audio output
+  - name: audio_dac
+    chip: es8311
+    type: audio_codec
+    version: default
+    skip_init: true
+    config:
+      dac_enabled: true
+      dac_max_channel: 1
+      dac_channel_mask: "1"        # Left channel enable
+      mclk_enabled: false
+      aec: false
+    peripherals:
+      - name: gpio_power_amp
+        gain: 20                   # BOARD_PA_GAIN (dB)
+        active_level: 1            # High level active
+      - name: i2s_audio_out
+      - name: i2c_master
+        address: 0x30              # ES8311 I2C address,  0x18 << 1 = 0x30
+        frequency: 100000          # 100kHz I2C frequency
+
+  # Audio ADC (ES7243/ES7243E) - ADC for audio input
+  - name: audio_adc
+    chip: es7243e      # Some old boards use ES7243, ES7243 is EOL
+    type: audio_codec
+    version: default
+    # skip_init: true
+    config:
+      adc_enabled: true
+      adc_max_channel: 2
+      adc_channel_mask: "11"             # Left, Right channel enable
+      adc_channel_labels: ['RE', 'FL']   # Reference channel, Front channel
+      mclk_enabled: true
+      aec: false
+    peripherals:
+      - name: i2s_audio_in
+      - name: i2c_master
+        address: 0x20              # ES7243E I2C address (0x26 for ES7243)
+        frequency: 100000          # 100kHz I2C frequency
+
+  # SD Card (FATFS)
   - name: fs_sdcard
     type: fatfs_sdcard
     version: default
     config:
-      bus_width: 1            # 1, 4, 8, not used on SPI type
+      mount_point: "/sdcard"
+      vfs_config:
+        max_files: 5
+      bus_width: 1                 # 1-line mode only
       pins:
-        clk: 15  # GPIO_NUM_15
-        cmd: 7   # GPIO_NUM_7
-        d0: 4    # GPIO_NUM_4
-
+        clk: 14
+        cmd: 15
+        d0: 2

packages/esp_board_manager/boards/lyrat_mini_v1_1/board_peripherals.yaml

@@ -3,11 +3,90 @@ chip: esp32
 version: 1.0.0
 # Peripherals Configuration
 peripherals:
+  # I2C Master for audio codec communication
   - name: i2c_master
     type: i2c
     role: master
     config:
       port: 0
       pins:
-        sda: 17
-        scl: 18
+        sda: 18
+        scl: 23
+
+  # I2S for audio output (DAC)
+  - name: i2s_audio_out
+    type: i2s
+    role: master
+    config:
+      port: 0
+      format: "std-out"
+      pins:
+        mclk: -1
+        bclk: 5
+        ws: 25
+        dout: 26
+        din: 35  #NOT USED
+      sample_rate_hz: 48000
+      data_bit_width: 16
+
+  # I2S for audio input (ADC)
+  - name: i2s_audio_in
+    type: i2s
+    role: master
+    config:
+      port: 1
+      format: "std-in"
+      pins:
+        mclk: 0                    # GPIO_NUM_0 (ES7243_MCLK_GPIO)
+        bclk: 32
+        ws: 33
+        dout: -1
+        din: 36
+      sample_rate_hz: 16000
+      data_bit_width: 16
+
+  # GPIO peripherals for various controls
+  - name: gpio_sd_power                  # SD Card power control
+    type: gpio
+    config:
+      pin: 13
+      mode: "GPIO_MODE_OUTPUT"
+
+  - name: gpio_headphone_detection       # Headphone detection
+    type: gpio
+    config:
+      pin: 19
+      mode: "GPIO_MODE_INPUT"
+      pullup_en: true
+
+  - name: gpio_power_amp                  # Power amplifier enable
+    type: gpio
+    config:
+      pin: 21
+      mode: "GPIO_MODE_OUTPUT"
+
+  - name: gpio_green_led                  # Green LED
+    type: gpio
+    config:
+      pin: 22
+      mode: "GPIO_MODE_OUTPUT"
+
+  - name: gpio_blue_led                  # Blue LED
+    type: gpio
+    config:
+      pin: 27
+      mode: "GPIO_MODE_OUTPUT"
+
+  - name: gpio_sd_detect                 # SD Card detect
+    type: gpio
+    config:
+      pin: 34
+      mode: "GPIO_MODE_INPUT"
+      pullup_en: true
+
+  - name: gpio_adc_button                  # ADC button input
+    type: gpio
+    config:
+      pin: 39
+      mode: "GPIO_MODE_INPUT"
+      pulldown_en: true

packages/esp_board_manager/devices/dev_audio_codec/dev_audio_codec.c

@@ -206,7 +206,7 @@ static const codec_registry_entry_t codec_registry[] = {
 static const codec_registry_entry_t *find_codec(const char *name)
 {
     for (int i = 0; codec_registry[i].name != NULL; i++) {
-        ESP_LOGI(TAG, "codec_registry[%d].name: %s,wanted: %s", i, codec_registry[i].name, name);
+        ESP_LOGD(TAG, "codec_registry[%d].name: %s,wanted: %s", i, codec_registry[i].name, name);
         if (strcmp(codec_registry[i].name, name) == 0) {
             return &codec_registry[i];
         }
@@ -292,8 +292,7 @@ int dev_audio_codec_init(void *cfg, int cfg_size, void **device_handle)
         .dev_type = dev_type,
     };
     codec_handles->codec_dev = esp_codec_dev_new(&dev_cfg);
-    ESP_LOGI(TAG, "Create esp_codec_dev success, dev:%p, type:%d",
-             codec_handles->codec_dev, dev_type);
+    ESP_LOGI(TAG, "Create esp_codec_dev success, dev:%p, chip:%s", codec_handles->codec_dev, codec_cfg->chip);
     *device_handle = codec_handles;
     return 0;
 }

packages/esp_board_manager/devices/dev_audio_codec/dev_audio_codec.yaml

@@ -51,5 +51,5 @@
 
     # I2C interface configuration
     - name: i2c-0                        # I2C peripheral for codec control
-      address: 0x30                      # I2C device address (hex format) (default: 0x30)
+      address: 0x30                      # I2C device address, include the read/write bit (hex format) (default: 0x30)
       frequency: 400000                  # I2C clock frequency in Hz (default: 400000)

packages/esp_board_manager/gen_bmgr_config_codes.py

@@ -788,11 +788,11 @@ def clear_gen_bmgr_codes_directory(self, project_root: str) -> bool:
                     file_path = os.path.join(gen_bmgr_codes_dir, filename)
                     if os.path.isfile(file_path):
                         os.remove(file_path)
-                        self.logger.info(f'   Removed file: {filename}')
+                        self.logger.debug(f'   Removed file: {filename}')
                     elif os.path.isdir(file_path):
                         import shutil
                         shutil.rmtree(file_path)
-                        self.logger.info(f'   Removed directory: {filename}')
+                        self.logger.debug(f'   Removed directory: {filename}')
 
                 self.logger.info(' ✅ gen_bmgr_codes directory cleared successfully')
             else:
@@ -805,24 +805,20 @@ def clear_gen_bmgr_codes_directory(self, project_root: str) -> bool:
 
     def get_chip_name_from_board_path(self, board_path: str) -> Optional[str]:
         """Extract chip name from board_info.yaml file"""
+        from generators.utils.board_utils import get_chip_name_from_board_path as get_chip_name_legacy
+
         board_info_path = os.path.join(board_path, 'board_info.yaml')
 
         if not os.path.exists(board_info_path):
             self.logger.warning(f'⚠️  board_info.yaml not found at {board_info_path}')
             return None
 
-        try:
-            with open(board_info_path, 'r', encoding='utf-8') as f:
-                board_yml = yaml.safe_load(f)
-                chip = board_yml.get('chip')
-                if chip:
-                    self.logger.debug(f'   Found chip name: {chip}')
-                    return chip
-                else:
-                    self.logger.warning(f'⚠️  No chip field found in {board_info_path}')
-                    return None
-        except Exception as e:
-            self.logger.error(f'❌ Error reading board_info.yaml: {e}')
+        chip = get_chip_name_legacy(board_path)
+        if chip:
+            self.logger.debug(f'   Found chip name: {chip}')
+            return chip
+        else:
+            self.logger.warning(f'⚠️  No chip field found in {board_info_path}')
             return None
 
     def get_version_info(self):
@@ -983,6 +979,13 @@ def run(self, args):
         periph_name_map = None
         device_dependencies = {}  # Initialize device_dependencies
 
+        # Set board path for global board utilities
+        board_path = all_boards.get(selected_board) if selected_board in all_boards else None
+        if board_path:
+            from generators.utils.board_utils import set_board_path
+            set_board_path(board_path)
+            self.logger.debug(f'   Set global board path: {board_path}')
+
         if not args.devices_only:
             self.logger.info('⚙️  Step 4/8: Processing peripherals...')
             try:

packages/esp_board_manager/generators/utils/__init__.py

@@ -12,3 +12,4 @@
 from .file_utils import *
 from .yaml_utils import *
 from .path_utils import *
+from .board_utils import *