[lightning-ln882h] Add BLE SDK support gated on CFG_SUPPORT_BLE

LN882H is a WiFi+BLE combo SoC; this wires the BLE stack into the build
system using the same queue.AddLibrary() pattern as the rest of the file.

proj_config.h
- Add CFG_SUPPORT_BLE 0 (default off; BLE builds enable it via
  custom_options.proj_config: "CFG_SUPPORT_BLE=1").
- Guard with #ifndef so the command-line -D from custom_options wins
  without a redefinition warning on every compiled file.

builder/utils/config.py
- Fix env_load_config parser: split(None,2) -> split(None,1) + skip bare
  defines (include guards, macros with no value).  Old code crashed on
  #define _PROJ_CONFIG_H_ and multi-word values like ((size_t)(160*1024)).

builder/utils/env.py
- Add "proj_config": "proj_config.h" alias to env_parse_custom_options so
  custom_options.proj_config is recognised alongside the existing lwip /
  freertos aliases.

builder/family/lightning-ln882h.py
- Load proj_config.h via env.LoadConfig() (same pattern as beken-72xx.py).
- Merge custom_options.proj_config overrides into env["CONFIG"] so
  env.Cfg("CFG_SUPPORT_BLE") reflects user overrides at build time.
- New ln882h_ble library (active when CFG_SUPPORT_BLE=1):
    - 16 C sources from $SDK_DIR/components/ble/ (arch, port, GAP, GATT,
      connection/device manager, SMP, store, event, import).
    - +<.> include so #include "ble_arch/arch.h" resolves from base_dir.
    - All BLE SDK subdirectory include paths.
    - libln882h_ble_full_stack.a via -Wl,--whole-archive.
    - CFG_SUPPORT_BLE=1 in public CPPDEFINES.
- Default ble_app_user_cfg.h in cores/lightning-ln882h/ble/ (Central role,
  no auto-adv, plain-brace BLE_DEFAULT_PUBLIC_ADDR to avoid a GNU compound
  expression expanding inside a brace-initialiser).  Applications that
  prepend their own include path shadow this default automatically.

Flash / RAM (generic-ln882hki, ESPHome switch firmware):
  CFG_SUPPORT_BLE=0: 530,640 B flash / 100,328 B RAM
  CFG_SUPPORT_BLE=1: 535,600 B flash / 100,768 B RAM  (+4.9 KB / +440 B)
libln882h_ble_full_stack.a is built with -ffunction-sections; --gc-sections
strips BLE symbols not reached from the entry point, so the overhead in a
build that actively uses the BLE stack will be correspondingly larger.

Author: LN882H Fix

builder/family/lightning-ln882h.py

@@ -11,6 +11,21 @@
 queue = env.AddLibraryQueue("lightning-ln882h")
 env.ConfigureFamily()
 
+# Load chip config (CFG_SUPPORT_BLE, etc.) — same pattern as beken-72xx.py
+env.LoadConfig(join("$FAMILY_DIR", "base", "config", "proj_config.h"))
+# Merge any user overrides from custom_options.proj_config into CONFIG so
+# env.Cfg() reflects them (ParseCustomOptions already ran in base.py).
+_proj_overrides = (
+    env.PioPlatform().custom_opts.get("options", {}).get("proj_config#h", {})
+)
+if _proj_overrides:
+    env["CONFIG"].update(
+        {
+            k: int(v) if str(v).lstrip("-").isdigit() else v.encode()
+            for k, v in _proj_overrides.items()
+        }
+    )
+
 # Flags
 queue.AppendPublic(
     CCFLAGS=[
@@ -178,6 +193,95 @@
     ),
 )
 
+# Sources - BLE SDK
+# Compiled when CFG_SUPPORT_BLE=1.  libln882h_ble_full_stack.a is built with
+# -ffunction-sections, so --gc-sections removes all BLE functions that are not
+# reachable from the application entry point.  A WiFi-only build with no BLE
+# application code adds only ~5 KB (startup hooks); a build with active BLE
+# usage retains all scanner/GAP/GATT code it calls.
+if env.Cfg("CFG_SUPPORT_BLE"):
+    queue.AddLibrary(
+        name="ln882h_ble",
+        base_dir=join("$SDK_DIR", "components", "ble"),
+        srcs=[
+            "+<ble_lib_import/ble_port.c>",
+            "+<ble_arch/ble_arch_main.c>",
+            "+<ble_profiles/prf_common/prf_ble.c>",
+            "+<ble_profiles/prf_common/prf_utils.c>",
+            "+<ble_app/ble_store/ln_ble_app_kv.c>",
+            "+<ble_app/ble_event/ln_ble_event_manager.c>",
+            "+<ble_app/ble_gap/gap_misc/ln_ble_gap.c>",
+            "+<ble_app/ble_gap/gap_misc/ln_ble_gap_ind_handler.c>",
+            "+<ble_app/ble_gap/gap_scan/ln_ble_scan.c>",
+            "+<ble_app/ble_gap/gap_advertising/*.c>",
+            "+<ble_app/ble_gatt/gatt_common/ln_ble_gatt.c>",
+            "+<ble_app/ble_gatt/gatt_common/ln_ble_gatt_ind_handler.c>",
+            "+<ble_app/ble_connection_manager/ln_ble_connection_manager.c>",
+            "+<ble_app/ble_device_manager/*.c>",
+            "+<ble_app/ble_smp/ln_ble_smp.c>",
+            "+<ble_app/ble_import/ln_ble_rw_app_task.c>",
+        ],
+        includes=[
+            # base_dir itself so that #include "ble_arch/arch.h" resolves correctly
+            "+<.>",
+            "+<ble_arch>",
+            "+<ble_lib_import>",
+            "+<ble_profiles/prf_common>",
+            "+<ble_app/ble_common>",
+            "+<ble_app/ble_connection_manager>",
+            "+<ble_app/ble_device_manager>",
+            "+<ble_app/ble_event>",
+            "+<ble_app/ble_gap/gap_advertising>",
+            "+<ble_app/ble_gap/gap_misc>",
+            "+<ble_app/ble_gap/gap_scan>",
+            "+<ble_app/ble_gatt/gatt_client>",
+            "+<ble_app/ble_gatt/gatt_common>",
+            "+<ble_app/ble_gatt/gatt_server>",
+            "+<ble_app/ble_import>",
+            "+<ble_app/ble_smp>",
+            "+<ble_app/ble_store>",
+            "+<ble_app/ble_test>",
+            "+<mac/ble/hl/api>",
+            "+<mac/ble/hl/inc>",
+            "+<mac/ble/ll/api>",
+            "+<mac/ble/ll/import>",
+            "+<mac/ble/ll/src>",
+            "+<mac/ble/ll/src/llm>",
+            "+<mac/em/api>",
+            "+<mac/hci/api>",
+            "+<mac/sch/api>",
+            "+<mac/sch/import>",
+            "+<modules/aes/api>",
+            "+<modules/common/api>",
+            "+<modules/dbg/api>",
+            "+<modules/ecc_p256/api>",
+            "+<modules/h4tl/api>",
+            "+<modules/ke/api>",
+            "+<modules/lib_ver/api>",
+            "+<modules/nvds/api>",
+            "+<modules/rf/api>",
+            "+<modules/rwip/api>",
+        ],
+        options=dict(
+            CPPDEFINES=["LN882H_SDK", "CFG_SUPPORT_BLE=1"],
+            CFLAGS=["-w"],
+        ),
+    )
+    # Provide a default ble_app_user_cfg.h so the SDK compiles without an
+    # application-supplied header.  Application components (e.g. ln882h_ble_tracker)
+    # that prepend their own include path will shadow this default automatically.
+    queue.AppendPublic(
+        CPPPATH=[join("$FAMILY_DIR", "ble")],
+    )
+    queue.AppendPublic(
+        CPPDEFINES=["CFG_SUPPORT_BLE=1"],
+        LINKFLAGS=[
+            "-Wl,--whole-archive",
+            "-lln882h_ble_full_stack",
+            "-Wl,--no-whole-archive",
+        ],
+    )
+
 
 # Sources - FreeRTOS
 env.Replace(FREERTOS_PORT=env["FAMILY_NAME"], FREERTOS_PORT_DEFINE="LIGHTNING_LN882H")

builder/utils/config.py

@@ -53,8 +53,11 @@ def env_load_config(env: Environment, path: str):
         if not line.startswith("#define"):
             continue
         line = line[7:].strip(STRIP_CHARS)
-        key, value = line.split(None, 2)
-        value = value.strip(STRIP_CHARS)
+        parts = line.split(None, 1)
+        if len(parts) < 2:
+            # bare define with no value (e.g. include guards, feature flags)
+            continue
+        key, value = parts[0], parts[1].strip(STRIP_CHARS)
         if value.isnumeric():
             value = int(value, 0)
         elif value.startswith('"') and value.endswith('"'):

builder/utils/env.py

@@ -138,6 +138,7 @@ def env_parse_custom_options(env: Environment, platform: PlatformBase):
     headers = {
         "lwip": "lwipopts.h",
         "freertos": "FreeRTOSConfig.h",
+        "proj_config": "proj_config.h",
     }
     for header, options in list(opts.items()):
         if not isinstance(options, str):

cores/lightning-ln882h/base/config/proj_config.h

@@ -51,6 +51,17 @@
 #define FLASH_IMAGE_VER_MINOR 1
 #define SOC_CRP_FLAG		  0
 
+/*
+ * BLE support.
+ * All LN882H variants have integrated BLE hardware.  Set to 1 to include the
+ * BLE SDK; leave at 0 for WiFi-only builds.
+ * Guard allows custom_options.proj_config to override this via -D on the
+ * command line without triggering a redefinition warning.
+ */
+#ifndef CFG_SUPPORT_BLE
+#define CFG_SUPPORT_BLE 0
+#endif
+
 /*
  * Hardware config
  */

cores/lightning-ln882h/ble/ble_app_user_cfg.h

@@ -0,0 +1,16 @@
+#pragma once
+
+// Default BLE application user configuration for LibreTiny LN882H.
+// All settings here are defaults; ln_ble_app_default_cfg.h guards every value
+// with #if !defined, so applications that need different settings can prepend
+// their own include path and this file will be shadowed by their version.
+
+// Observer / Central role — no advertising, scanning only.
+#define BLE_DEFAULT_ROLE	BLE_ROLE_CENTRAL
+#define BLE_CONFIG_AUTO_ADV (0)
+
+// Override the SDK default which uses a GNU compound expression ({...}) that
+// breaks when expanded inside a brace-initialiser: ln_bd_addr_t addr = {MACRO}.
+// Use a plain brace-list instead — the NIC bytes are a placeholder; applications
+// that need a real MAC must override this file via a higher-priority include path.
+#define BLE_DEFAULT_PUBLIC_ADDR {0x00, 0x50, 0xC2, 0x00, 0x00, 0x00}