From dcab2def05c93524006a429553a8e4dc14c47167 Mon Sep 17 00:00:00 2001
From: "J. Nick Koston" <nick@home-assistant.io>
Date: Sun, 1 Feb 2026 12:45:27 +0100
Subject: [PATCH] no scanf float

---
 esphome/components/esp8266/__init__.py        |  6 +++
 .../esp8266/remove_float_scanf.py.script      | 39 +++++++++++++++++++
 2 files changed, 45 insertions(+)
 create mode 100644 esphome/components/esp8266/remove_float_scanf.py.script

diff --git a/esphome/components/esp8266/__init__.py b/esphome/components/esp8266/__init__.py
index c7b5d5c130d..927a59fd616 100644
--- a/esphome/components/esp8266/__init__.py
+++ b/esphome/components/esp8266/__init__.py
@@ -205,6 +205,7 @@ async def to_code(config):
             "pre:testing_mode.py",
             "pre:exclude_updater.py",
             "pre:exclude_waveform.py",
+            "pre:remove_float_scanf.py",
             "post:post_build.py",
         ],
     )
@@ -342,3 +343,8 @@ def copy_files() -> None:
         exclude_waveform_file,
         CORE.relative_build_path("exclude_waveform.py"),
     )
+    remove_float_scanf_file = dir / "remove_float_scanf.py.script"
+    copy_file_if_changed(
+        remove_float_scanf_file,
+        CORE.relative_build_path("remove_float_scanf.py"),
+    )
diff --git a/esphome/components/esp8266/remove_float_scanf.py.script b/esphome/components/esp8266/remove_float_scanf.py.script
new file mode 100644
index 00000000000..f88e7531408
--- /dev/null
+++ b/esphome/components/esp8266/remove_float_scanf.py.script
@@ -0,0 +1,39 @@
+# pylint: disable=E0602
+Import("env")  # noqa
+
+# Remove float scanf support from linker flags
+# The Arduino ESP8266 framework unconditionally adds:
+#   -u _printf_float -u _scanf_float
+# ESPHome doesn't use scanf with %f, so _scanf_float is not needed.
+#
+# Savings:
+#   - _scanf_float: ~1.3KB
+#   - _strtod_l: ~3.7KB (string-to-double, only needed by scanf float)
+#   - Related float parsing helpers
+
+
+def remove_scanf_float_flag(source, target, env):
+    """Remove -u _scanf_float from linker flags.
+
+    This is called as a pre-action before the link step.
+    """
+    linkflags = env.get("LINKFLAGS", [])
+    new_linkflags = []
+    i = 0
+
+    while i < len(linkflags):
+        flag = linkflags[i]
+        if flag == "-u" and i + 1 < len(linkflags):
+            next_flag = linkflags[i + 1]
+            if next_flag == "_scanf_float":
+                print("ESPHome: Removing float scanf support (_scanf_float)")
+                i += 2  # Skip both -u and the symbol
+                continue
+        new_linkflags.append(flag)
+        i += 1
+
+    env.Replace(LINKFLAGS=new_linkflags)
+
+
+# Register the callback to run before the link step
+env.AddPreAction("$BUILD_DIR/${PROGNAME}.elf", remove_scanf_float_flag)