add possibility to add board specific script (#291)

Author: Jason2866

boards/m5stack-tab5-p4.json

@@ -0,0 +1,39 @@
+{
+  "build": {
+    "core": "esp32",
+    "extra_flags": [
+      "-DBOARD_HAS_PSRAM",
+      "-DARDUINO_USB_CDC_ON_BOOT=1",
+      "-DARDUINO_USB_MODE=1"
+    ],
+    "f_cpu": "360000000L",
+    "f_flash": "80000000L",
+    "flash_mode": "qio",
+    "mcu": "esp32p4",
+    "variant": "m5stack_tab5"
+  },
+  "arduino": {
+    "partitions": "default_16MB.csv"
+  },
+  "connectivity": [
+    "bluetooth",
+    "openthread"
+  ],
+  "debug": {
+    "openocd_target": "esp32p4.cfg"
+  },
+  "frameworks": [
+    "arduino",
+    "espidf"
+  ],
+  "name": "M5STACK Tab5 esp32-p4 Board",
+  "upload": {
+    "flash_size": "16MB",
+    "maximum_ram_size": 512000,
+    "maximum_size": 16777216,
+    "require_upload_port": true,
+    "speed": 1500000
+  },
+  "url": "https://docs.m5stack.com/en/core/Tab5",
+  "vendor": "M5STACK"
+}

boards/m5stack-tab5-p4.py

@@ -0,0 +1,12 @@
+def configure_board(env):
+    if "arduino" in env.get("PIOFRAMEWORK", []):
+        deps = ["https://github.com/M5Stack/M5Unified.git"]
+        # Install libraries using PlatformIO Library Manager
+        from pathlib import Path
+        from platformio.package.manager.library import LibraryPackageManager
+
+        lib_dir = Path(env.subst("$PROJECT_DIR")) / ".pio" / "libdeps" / env.subst("$PIOENV")
+        lm = LibraryPackageManager(package_dir=lib_dir)
+
+        for lib in deps:
+            lm.install(lib)

builder/main.py

@@ -20,6 +20,7 @@
 import sys
 from os.path import isfile, join
 from pathlib import Path
+import importlib.util
 
 from SCons.Script import (
     ARGUMENTS,
@@ -40,12 +41,43 @@
 platform = env.PioPlatform()
 projectconfig = env.GetProjectConfig()
 terminal_cp = locale.getpreferredencoding().lower()
-FRAMEWORK_DIR = platform.get_package_dir("framework-arduinoespressif32")
-platformio_dir = projectconfig.get("platformio", "core_dir")
+platform_dir = Path(env.PioPlatform().get_dir())
+framework_dir = platform.get_package_dir("framework-arduinoespressif32")
+core_dir = projectconfig.get("platformio", "core_dir")
+build_dir = Path(projectconfig.get("platformio", "build_dir"))
 
 # Setup Python virtual environment and get executable paths
-PYTHON_EXE, esptool_binary_path = setup_python_environment(env, platform, platformio_dir)
+PYTHON_EXE, esptool_binary_path = setup_python_environment(env, platform, core_dir)
 
+# Initialize board configuration and MCU settings
+board = env.BoardConfig()
+board_id = env.subst("$BOARD")
+mcu = board.get("build.mcu", "esp32")
+is_xtensa = mcu in ("esp32", "esp32s2", "esp32s3")
+toolchain_arch = "xtensa-%s" % mcu
+filesystem = board.get("build.filesystem", "littlefs")
+
+
+def load_board_script(env):
+    if not board_id:
+        return
+
+    script_path = platform_dir / "boards" / f"{board_id}.py"
+
+    if script_path.exists():
+        try:
+            spec = importlib.util.spec_from_file_location(
+                f"board_{board_id}", 
+                str(script_path)
+            )
+            board_module = importlib.util.module_from_spec(spec)
+            spec.loader.exec_module(board_module)
+
+            if hasattr(board_module, 'configure_board'):
+                board_module.configure_board(env)
+
+        except Exception as e:
+            print(f"Error loading board script {board_id}.py: {e}")
 
 def BeforeUpload(target, source, env):
     """
@@ -412,12 +444,8 @@ def switch_off_ldf():
         projectconfig.set(env_section, "lib_ldf_mode", "off")
 
 
-# Initialize board configuration and MCU settings
-board = env.BoardConfig()
-mcu = board.get("build.mcu", "esp32")
-is_xtensa = mcu in ("esp32", "esp32s2", "esp32s3")
-toolchain_arch = "xtensa-%s" % mcu
-filesystem = board.get("build.filesystem", "littlefs")
+# Board specific script
+load_board_script(env)
 
 # Set toolchain architecture for RISC-V based ESP32 variants
 if not is_xtensa:
@@ -706,7 +734,7 @@ def firmware_metrics(target, source, env):
             "espressif32.html#over-the-air-ota-update\n"
         )
     env.Replace(
-        UPLOADER=str(Path(FRAMEWORK_DIR).resolve() / "tools" / "espota.py"),
+        UPLOADER=str(Path(framework_dir).resolve() / "tools" / "espota.py"),
         UPLOADERFLAGS=["--debug", "--progress", "-i", "$UPLOAD_PORT"],
         UPLOADCMD=f'"{PYTHON_EXE}" "$UPLOADER" $UPLOADERFLAGS -f $SOURCE',
     )

examples/arduino-blink/platformio.ini

@@ -206,10 +206,10 @@ custom_component_remove = espressif/esp_hosted
                           espressif/rmaker_common
                           chmorgan/esp-libhelix-mp3
 
-[env:esp32-p4]
+[env:m5stack-tab5-p4]
 platform                = espressif32
 framework               = arduino
-board                   = esp32-p4
+board                   = m5stack-tab5-p4
 build_flags             = -DLED_BUILTIN=2
 lib_ignore              = wifi
                           ble