From 5bdf28b83cdaec1c717cac484257efdbf2b4e024 Mon Sep 17 00:00:00 2001
From: Maze X <maze@booking.com>
Date: Fri, 27 Mar 2026 18:05:21 +0100
Subject: [PATCH] Add custom board definition for Heltec WiFi LoRa 32 V3

- Create boards/ directory with custom board JSON for Heltec V3
- Configure platformio.ini to use boards/ directory
- Resolves 'Unknown board ID' error during build
---
 boards/heltec_wifi_lora_32_v3.json | 32 ++++++++++++++++++++++++++++++
 platformio.ini                     |  2 ++
 2 files changed, 34 insertions(+)
 create mode 100644 boards/heltec_wifi_lora_32_v3.json

diff --git a/boards/heltec_wifi_lora_32_v3.json b/boards/heltec_wifi_lora_32_v3.json
new file mode 100644
index 0000000..cbb6156
--- /dev/null
+++ b/boards/heltec_wifi_lora_32_v3.json
@@ -0,0 +1,32 @@
+{
+  "build": {
+    "core": "esp32",
+    "extra_flags": "-DBOARD_HAS_PSRAM",
+    "f_cpu": "240000000L",
+    "f_flash": "80000000L",
+    "flash_mode": "qio",
+    "mcu": "esp32s3",
+    "variant": "esp32s3"
+  },
+  "connectivity": [
+    "wifi",
+    "ble"
+  ],
+  "debug": {
+    "openocd_board": "esp32s3-board.cfg"
+  },
+  "frameworks": [
+    "arduino",
+    "esp-idf"
+  ],
+  "name": "Heltec WiFi LoRa 32 V3",
+  "upload": {
+    "flash_size": "8MB",
+    "maximum_ram_size": 327680,
+    "maximum_size": 8388608,
+    "require_upload_port": true,
+    "speed": 460800
+  },
+  "url": "https://heltec.org/project/wifi-lora-32-v3/",
+  "vendor": "Heltec"
+}
diff --git a/platformio.ini b/platformio.ini
index 69d5eb2..5585902 100644
--- a/platformio.ini
+++ b/platformio.ini
@@ -8,6 +8,8 @@ default_envs =
     rak_rak4631
     heltec_v2
 
+boards_dir = boards
+
 extra_configs =
     soc/esp32/platformio.ini
     soc/esp32s3/platformio.ini