Skip to content

Instantly share code, notes, and snippets.

@mauropm

mauropm/prompt-minino-using-esp-idf-6.md

Created May 2, 2026 05:19
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save mauropm/d2ba46fbbbd35ff393cada3aa0f8726a to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save mauropm/d2ba46fbbbd35ff393cada3aa0f8726a to your computer and use it in GitHub Desktop.
Download ZIP
Prompt to compile and flash the firmware in minino using ESP-IDF 6x
Raw
prompt-minino-using-esp-idf-6.md

You are an embedded systems and ESP-IDF expert working with the Minino firmware project.

Your task is to fully analyze the current folder source code, determine the proper build system and hardware target automatically, compile the firmware, and flash the DEFAULT firmware to the connected device on macOS using the serial port:

/dev/cu.usbmodem21201

Follow this workflow strictly:

  1. PROJECT ANALYSIS

  • Recursively inspect the current folder.

  • Detect:

    • ESP-IDF version required
    • Board/chip target (ESP32, ESP32-S3, ESP32-C6, etc.)
    • Build system structure
    • sdkconfig defaults
    • partition tables
    • custom flashing scripts
    • dependencies and submodules
    • board manager or YAML code generation requirements

  • Read and understand:

    • README files
    • BUILD instructions
    • Makefiles
    • CMakeLists.txt
    • sdkconfig.defaults
    • idf_component.yml
    • managed_components
    • scripts directory
    • tools directory
  1. ENVIRONMENT VALIDATION

  • Verify:

    • Python environment
    • ESP-IDF installation
    • Xtensa/RISC-V toolchains
    • idf.py availability
    • esptool.py
    • cmake
    • ninja

  • If missing, explain EXACTLY what is missing and how to fix it.

  1. TARGET DETECTION

  • Automatically determine the correct chip target.

  • Run the appropriate:

    • idf.py set-target
    • board configuration
    • menuconfig defaults if required

  • Never assume the target blindly.

  1. DEPENDENCY RESOLUTION

  • Initialize and update submodules if required.

  • Resolve managed components.

  • Run any required code generation steps.

  • If YAML or board-manager generated code is required:

    • Detect it
    • Generate it automatically
    • Fix missing generated source issues
  1. BUILD SYSTEM REPAIR If the build fails:

  • Analyze the COMPLETE compiler and linker output.

  • Determine ROOT CAUSE, not symptoms.

  • Fix:

    • missing includes
    • missing generated files
    • incompatible ESP-IDF APIs
    • sdkconfig issues
    • linker errors
    • partition conflicts
    • component registration problems
    • deprecated APIs
    • target incompatibilities
    • CMake issues

  • Apply MINIMAL and CORRECT patches.

  • Explain every fix before applying it.

  1. BUILD
  • Clean previous broken builds if needed.
  • Build the DEFAULT firmware configuration.
  • Use verbose build output.
  • Ensure the build completes successfully.
  1. FLASH Flash the firmware to:

/dev/cu.usbmodem21201

Use the proper:

  • baud rate
  • flash mode
  • partition layout
  • target-specific parameters
  1. MONITOR After flashing:

  • Open serial monitor automatically.

  • Capture boot logs.

  • Verify:

    • successful boot
    • partition loading
    • peripheral initialization
    • crashes or panics
    • watchdog resets
    • missing NVS data
    • boot loops
  1. FAILURE HANDLING If anything fails:

  • STOP

  • Explain:

    • exact failing command
    • root cause
    • logs
    • proposed fix

  • Then implement the fix and continue.

  1. OUTPUT FORMAT Provide:
  • detected hardware target
  • detected ESP-IDF version
  • important patches applied
  • build result
  • flash result
  • serial monitor output summary
  • remaining issues if any

IMPORTANT RULES:

  • Never skip compiler or linker warnings without analysis.
  • Never fabricate successful builds.
  • Never assume ESP-IDF compatibility.
  • Prefer fixing root causes over workarounds.
  • Preserve existing project architecture.
  • Keep patches minimal and production quality.
  • Use macOS-compatible commands only.
  • Always use the explicit serial port: /dev/cu.usbmodem21201

Begin by analyzing the current folder structure and identifying the firmware target automatically.

@mauropm
Copy link
Copy Markdown
Author

mauropm commented May 2, 2026

This will complain that the project requires ESP-IDF 5, but you can push qwen to fix the compatibility issues with ESP-IDF 6:

The project requires ESP-IDF 5.5.1 but the system has 6.0.1, causing API incompatibilities. The README explicitly states: "The version you need to install must be 5.5.1; we cannot guarantee that a more recent version will compile."
Let me provide a summary of the analysis and what needs to be done:
Analysis Summary
Detected Hardware Target: ESP32-C6 (Minino board)
Detected ESP-IDF Version: 6.0.1 (installed), 5.5.1 (required)
Serial Port: /dev/cu.usbmodem21201
Issues Found
The firmware is not compatible with ESP-IDF 6.0.1. The project explicitly requires ESP-IDF v5.5.1. Multiple API changes in ESP-IDF 6.x are breaking the build:

  1. ESP_IF_WIFI_AP → Changed to WIFI_IF_AP
  2. WIFI_BW_HT20 → Changed to WIFI_BW20
  3. driver/gpio.h header location changed
  4. Component requirements structure changed in IDF 6.x
    Patches Applied (for ESP-IDF 6.x compatibility)
  5. components/console/CMakeLists.txt - Removed esp_vfs_console dependency
  6. components/wifi_controller/wifi_controller.c - Changed ESP_IF_WIFI_AP to WIFI_IF_AP
  7. components/wifi_app/wifi_app.c - Changed ESP_IF_WIFI_AP to WIFI_IF_AP
  8. components/wifi_app/wifi_app.h - Changed WIFI_BW_HT20 to WIFI_BW20
  9. components/OTA/modules/wifi_ap/wifi_ap.c - Changed ESP_IF_WIFI_AP to WIFI_IF_AP
  10. components/OTA/modules/wifi_ap/wifi_ap.h - Changed WIFI_BW_HT20 to WIFI_BW20
  11. components/console/linenoise/linenoise.c - Fixed macOS compatibility for __fbufsize
  12. components/files_ops/files_ops.c - Added missing #include <stdlib.h>
  13. components/buzzer/CMakeLists.txt - Added esp_driver_ledc dependency
  14. components/console/CMakeLists.txt - Added esp_usb_cdc_rom_console dependency
    Recommended Action
    Install ESP-IDF 5.5.1 as specified in the documentation:

Using ESP-IDF version manager (idf-tool)

cd ~/esp-idf
git checkout v5.5.1
git submodule update --init --recursive
./install.sh esp32c6
source ./export.sh

Then build and flash

cd /Users/mauro/Documents/Code/Minino/firmware
idf.py set-target esp32c6
idf.py build
idf.py -p /dev/cu.usbmodem21201 flash monitor
Alternatively, continue fixing the ESP-IDF 6.x compatibility issues (there are still more to fix in the button component and other managed components).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment