From 8940376db66e5ad06d5e23f6542d0cac261f7108 Mon Sep 17 00:00:00 2001
From: Alex Hope-O'Connor <alex.hope.oconnor@pomonaqld.au>
Date: Sun, 19 Apr 2026 21:17:03 +1000
Subject: [PATCH] Pin ESP8266 Arduino core for postmortem relocation fix

Use framework-arduinoespressif8266 from esp8266/Arduino@521ae60 in root
and example PlatformIO envs (matches Device Framework workaround).
---
 examples/AsyncDashboardDemo/platformio.ini | 4 +++-
 examples/HelloPlaceholder/platformio.ini   | 2 ++
 examples/NestedLayouts/platformio.ini      | 2 ++
 examples/StreamingAsync/platformio.ini     | 4 +++-
 platformio.ini                             | 3 +++
 5 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/examples/AsyncDashboardDemo/platformio.ini b/examples/AsyncDashboardDemo/platformio.ini
index 22b974f..fb86f7d 100644
--- a/examples/AsyncDashboardDemo/platformio.ini
+++ b/examples/AsyncDashboardDemo/platformio.ini
@@ -8,12 +8,14 @@ build_flags =
 lib_extra_dirs = ../../
 lib_deps =
   DFTE=symlink://../../
-  ESP32Async/ESPAsyncWebServer
+  ESP32Async/ESPAsyncWebServer@^3.9.1
 monitor_speed = 115200
 
 [env:dashboard_esp8266]
 platform = espressif8266
 board = d1_mini
+platform_packages =
+  platformio/framework-arduinoespressif8266 @ https://github.com/esp8266/Arduino.git#521ae60a89e64bb0d1eb7a0b7addf620ced5cad3
 lib_deps =
   ${env.lib_deps}
   ESP32Async/ESPAsyncTCP
diff --git a/examples/HelloPlaceholder/platformio.ini b/examples/HelloPlaceholder/platformio.ini
index 60dac4d..5c7e4a3 100644
--- a/examples/HelloPlaceholder/platformio.ini
+++ b/examples/HelloPlaceholder/platformio.ini
@@ -11,6 +11,8 @@ monitor_speed = 115200
 [env:example_esp8266]
 platform = espressif8266
 board = d1_mini
+platform_packages =
+  platformio/framework-arduinoespressif8266 @ https://github.com/esp8266/Arduino.git#521ae60a89e64bb0d1eb7a0b7addf620ced5cad3
 
 [env:example_esp32]
 platform = espressif32
diff --git a/examples/NestedLayouts/platformio.ini b/examples/NestedLayouts/platformio.ini
index 60dac4d..5c7e4a3 100644
--- a/examples/NestedLayouts/platformio.ini
+++ b/examples/NestedLayouts/platformio.ini
@@ -11,6 +11,8 @@ monitor_speed = 115200
 [env:example_esp8266]
 platform = espressif8266
 board = d1_mini
+platform_packages =
+  platformio/framework-arduinoespressif8266 @ https://github.com/esp8266/Arduino.git#521ae60a89e64bb0d1eb7a0b7addf620ced5cad3
 
 [env:example_esp32]
 platform = espressif32
diff --git a/examples/StreamingAsync/platformio.ini b/examples/StreamingAsync/platformio.ini
index d43e251..972740f 100644
--- a/examples/StreamingAsync/platformio.ini
+++ b/examples/StreamingAsync/platformio.ini
@@ -6,7 +6,7 @@ framework = arduino
 lib_extra_dirs = ../../
 lib_deps =
   DFTE=symlink://../../
-  ESP32Async/ESPAsyncWebServer
+  ESP32Async/ESPAsyncWebServer@^3.9.1
 build_flags =
   -O2
 monitor_speed = 115200
@@ -14,6 +14,8 @@ monitor_speed = 115200
 [env:example_esp8266]
 platform = espressif8266
 board = d1_mini
+platform_packages =
+  platformio/framework-arduinoespressif8266 @ https://github.com/esp8266/Arduino.git#521ae60a89e64bb0d1eb7a0b7addf620ced5cad3
 lib_deps =
   ${env.lib_deps}
   ESP32Async/ESPAsyncTCP
diff --git a/platformio.ini b/platformio.ini
index c587c88..9b1852d 100644
--- a/platformio.ini
+++ b/platformio.ini
@@ -2,6 +2,9 @@
 platform = espressif8266
 board = d1_mini
 framework = arduino
+; Postmortem jump relocation fix (see ESP8266-LINKER-WORKAROUND.md in arduino-home-assistant)
+platform_packages =
+    platformio/framework-arduinoespressif8266 @ https://github.com/esp8266/Arduino.git#521ae60a89e64bb0d1eb7a0b7addf620ced5cad3
 test_framework = unity
 test_build_src = yes