Release 0.1.10: add unified device configuration

Author: Maksym Shtembuliak

.github/workflows/ci.yml

@@ -19,29 +19,14 @@ jobs:
         run: python -m pip install "esphome==${ESPHOME_VERSION}" pyyaml
       - name: Host tests
         run: make -C host_tests test
+      - name: Protocol cross-check
+        run: python host_tests/cross_check.py
       - name: Validate YAML and docs links
-        run: |
-          python - <<'PY'
-          from pathlib import Path
-          import re
-          import yaml
-
-          class Loader(yaml.SafeLoader):
-              pass
-          Loader.add_constructor("!secret", lambda loader, node: loader.construct_scalar(node))
-          for path in sorted(Path("examples").glob("*.yaml")):
-              if path.name == "secrets.yaml":
-                  raise SystemExit("examples/secrets.yaml must not be committed")
-              yaml.load(path.read_text(), Loader=Loader)
-
-          link_re = re.compile(r"\[[^\]]+\]\(([^)]+)\)")
-          for path in [Path("README.md"), Path("README.uk.md"), *Path("docs").glob("*.md")]:
-              for match in link_re.finditer(path.read_text()):
-                  target = match.group(1).split("#", 1)[0]
-                  if not target or "://" in target:
-                      continue
-                  if not (path.parent / target).exists():
-                      raise SystemExit(f"{path}: broken link {target}")
-          PY
-      - name: Compile release presets
-        run: python tools/build_web_release.py --compile --local-source --version ci
+        run: python tools/validate_repo.py
+      - name: Compile release presets and YAML-only profiles
+        run: >-
+          python tools/build_web_release.py
+          --compile
+          --compile-yaml-profiles
+          --local-source
+          --version ci

.github/workflows/release.yml

@@ -28,14 +28,31 @@ jobs:
         run: python -m pip install "esphome==${ESPHOME_VERSION}" pyyaml
       - name: Host tests
         run: make -C host_tests test
+      - name: Protocol cross-check
+        run: python host_tests/cross_check.py
+      - name: Validate YAML and docs links
+        run: python tools/validate_repo.py
       - name: Build web release
-        run: python tools/build_web_release.py --compile --local-source --version "${GITHUB_REF_NAME}"
+        run: >-
+          python tools/build_web_release.py
+          --compile
+          --compile-yaml-profiles
+          --local-source
+          --version "${GITHUB_REF_NAME}"
+      - name: Generate checksums
+        run: >-
+          sha256sum
+          dist/web-release/web/firmware/*.bin
+          dist/web-release/web/manifest-*.json
+          > dist/web-release/SHA256SUMS
       - name: Upload release artifacts
         uses: softprops/action-gh-release@v3
         with:
+          generate_release_notes: true
           files: |
             dist/web-release/web/firmware/*.bin
             dist/web-release/web/manifest-*.json
+            dist/web-release/SHA256SUMS
       - name: Upload Pages artifact
         uses: actions/upload-pages-artifact@v5
         with:

CHANGELOG.md

@@ -4,6 +4,54 @@ All notable changes to this project are documented here. The format is based on
 [Keep a Changelog](https://keepachangelog.com/), and this project adheres to
 [Semantic Versioning](https://semver.org/).
 
+## [0.1.10] - 2026-07-10
+
+### Added
+- **Unified local configuration page.** `/` now combines Wi-Fi provisioning,
+  Home Assistant endpoint settings, complete inverter UART framing and web OTA.
+  It is available on both the normal LAN address and `192.168.4.1` in setup mode.
+- **Complete persisted UART framing.** ESP8266 and ESP32 now persist data bits,
+  parity and stop bits together with baud rate. Existing baud-only preferences
+  migrate automatically. On BK72xx, UART settings remain build-time-only and can
+  be changed only by rebuilding and reflashing the firmware.
+- **Hardware identity overview.** The page shows the compiled TX/RX and RS485
+  direction/status/communication LED pins, collector PN and ESPHome hostname.
+  Build-time fields remain read-only until a platform-safe boot-time
+  hardware-profile mechanism is available.
+- **Interactive Wi-Fi scan.** Nearby networks retain the stock captive-portal
+  behavior: SSID, a signal-strength indicator and lock state are displayed, and
+  selecting a row copies its SSID into the Wi-Fi form. Exact RSSI is available
+  from the indicator tooltip. The configured network remains visible and is
+  clearly marked as connected or currently unavailable.
+- **Configurable collector PN.** The default PN remains protected by a checked
+  toggle. Disabling it allows a validated custom PN; re-enabling it restores the
+  default. Identity changes are persisted and applied after a safe restart.
+- **Local page translations.** English, Ukrainian and Russian can be selected on
+  the device page. The browser remembers the selected language.
+- **ESPHome Dashboard adoption.** Ready-made ESP8266, ESP32 and BK72xx builds
+  publish project metadata and a board-specific `dashboard_import` package over
+  mDNS. The Dashboard can create a local YAML for a device flashed from a
+  prebuilt binary; no server-specific ownership key is required.
+- **UART / RS485 diagnostics.** The local page shows passive live counters for
+  transmitted bytes and requests, total physical receive bytes and the age of
+  the last TX/RX activity. Developer-only response/stale counters remain in the
+  diagnostics JSON. Counters reset at boot and never influence transport behavior.
+- **Dark and light themes.** The local page uses the dark theme by default and
+  remembers the user's theme toggle alongside the language preference.
+
+### Fixed
+- The always-on local web server is initialized only after the network stack is
+  ready. Starting AsyncTCP from the component's pre-Wi-Fi setup priority caused
+  an ESP32 boot loop; captive-portal registration remains available before Wi-Fi.
+
+### Changed
+- Collector identity, Home Assistant endpoint and UART framing now have separate
+  save actions. PN changes require explicit browser confirmation and explain the
+  Home Assistant re-add requirement.
+- UART persistence wording now explicitly states that settings are stored in
+  non-volatile device memory and used after every restart.
+- `BRIDGE_VERSION` bumped to `0.1.10`.
+
 ## [0.1.8] - 2026-07-04
 
 ### Fixed
@@ -114,6 +162,8 @@ Home Assistant integration. Highlights:
 - Status LED indication and the `AT+VDTU` virtual-bridge capability probe.
 - Web installer (GitHub Pages) for the ESP8266 and ESP32 presets.
 
+[0.1.10]: https://github.com/groove-max/esp-eybond-collector/compare/v0.1.8...v0.1.10
+[0.1.8]: https://github.com/groove-max/esp-eybond-collector/compare/v0.1.7...v0.1.8
 [0.1.7]: https://github.com/groove-max/esp-eybond-collector/compare/v0.1.6...v0.1.7
 [0.1.6]: https://github.com/groove-max/esp-eybond-collector/compare/v0.1.5...v0.1.6
 [0.1.5]: https://github.com/groove-max/esp-eybond-collector/compare/v0.1.4...v0.1.5

README.md

@@ -180,6 +180,31 @@ For the custom ESP bridge, EyeBond Local also exposes **Change inverter UART spe
 
 The bridge can use normal ESPHome Wi-Fi setup and captive portal behavior. When it opens the setup portal, its temporary Wi-Fi network is named like its virtual collector PN, for example `V00000...`.
 
+Open `http://<collector-ip>/` on the normal local network. The unified page
+configures Wi-Fi, the Home Assistant endpoint and inverter UART, and can upload
+an OTA firmware image. The same page is available at `http://192.168.4.1/` while
+connected to the setup network.
+It also shows the collector PN, compiled pin mapping and hostname. Nearby Wi-Fi
+networks remain selectable and include a signal indicator, exact RSSI tooltip
+and lock state; the configured network is marked even when it is temporarily
+unavailable. The PN can be switched from its protected default to a validated
+custom value. Changing it restarts the collector and requires removing and
+re-adding an existing Home Assistant device. The page is available
+in English, Ukrainian and Russian. It uses a dark theme by default and remembers
+the light/dark toggle. Passive UART / RS485 diagnostics show TX/RX byte counters,
+request count and the age of the last activity.
+ESP8266/ESP32 builds can change and persist the complete UART framing there.
+BK72xx shows UART as read-only because that platform requires a YAML change and
+reflash. Custom YAML builds enable the page with `web_configuration: true`
+under `eybond_collector:` and must also include `captive_portal:`.
+
+Ready-made board profiles also support ESPHome Dashboard adoption. A device
+flashed from a prebuilt binary advertises its project, board and package URL over
+mDNS, allowing the Dashboard to create a local YAML. This uses ESPHome
+`dashboard_import`; there is no Dashboard-specific pairing key to enter on the
+collector page. The Dashboard host must be able to receive the device's mDNS
+announcements.
+
 EyeBond Local can also change collector Wi-Fi settings for the bridge. If the new credentials are wrong, the bridge should fall back to its setup portal instead of becoming permanently unreachable.
 
 The nearby-network list can show only the current network on the first read. Refresh after a few seconds to see the full scan result.

README.uk.md

@@ -180,6 +180,33 @@ select:
 
 Міст підтримує звичайне налаштування Wi-Fi через ESPHome і сторінку налаштування. Коли міст відкриває сторінку налаштування, його тимчасова Wi-Fi-мережа має назву як віртуальний PN колектора, наприклад `V00000...`.
 
+У звичайній локальній мережі відкрийте `http://<ip-колектора>/`. Єдина сторінка
+налаштовує Wi-Fi, endpoint Home Assistant та UART інвертора, а також дозволяє
+завантажити OTA-прошивку. Після підключення до точки доступу налаштування вона доступна
+за `http://192.168.4.1/`. На цій
+сторінці можна налаштувати endpoint Home Assistant і параметри UART інвертора.
+Там також показано PN колектора, піни поточної збірки та hostname. Типовий PN
+захищено перемикачем; після його вимкнення можна задати власний валідний PN.
+Його зміна перезапускає колектор і потребує видалити та повторно додати вже
+створений пристрій у Home Assistant.
+Список доступних Wi-Fi-мереж показує індикатор сигналу й ознаку захисту;
+точний RSSI доступний у підказці, натискання мережі копіює її SSID у форму, а
+налаштована мережа залишається позначеною навіть за тимчасової відсутності зв’язку.
+Сторінка має англійську, українську та російську мови.
+За замовчуванням використовується темна тема; перемикач світлої/темної теми
+запам’ятовує вибір. Пасивна діагностика UART / RS485 показує загальні лічильники
+TX/RX, кількість запитів та час останньої активності.
+На ESP8266/ESP32 зберігається повний UART framing.
+Для BK72xx параметри UART доступні лише для перегляду: швидкість змінюється в
+YAML із повторним прошиванням. У власному YAML сторінка вмикається через
+`web_configuration: true` у `eybond_collector:` і потребує секції
+`captive_portal:`.
+
+Готові профілі плат також підтримують додавання до ESPHome Dashboard. Пристрій,
+прошитий готовим бінарником, публікує через mDNS проєкт, тип плати та URL пакета,
+після чого Dashboard може створити локальний YAML. Окремого ключа прив’язки до
+Dashboard немає. Сервер Dashboard має отримувати mDNS-повідомлення пристрою.
+
 EyeBond Local також може змінювати Wi-Fi-налаштування моста. Якщо нові дані неправильні, міст має перейти на сторінку налаштування, а не зникнути назавжди.
 
 Список мереж може спочатку показати тільки поточну мережу. Оновіть через кілька секунд, щоб побачити повний результат сканування.

components/eybond_collector/__init__.py

@@ -13,7 +13,7 @@
 import esphome.final_validate as fv
 from esphome import pins
 from esphome.components import uart
-from esphome.const import CONF_ID
+from esphome.const import CONF_ID, CONF_NUMBER, CONF_RX_PIN, CONF_TX_PIN, CONF_UART_ID
 from esphome.core import CORE
 
 CODEOWNERS = ["@groove-max"]
@@ -33,6 +33,7 @@
 CONF_STATUS_LED_PIN = "status_led_pin"
 CONF_COM_LED_PIN = "com_led_pin"
 CONF_BLE_PROVISIONING = "ble_provisioning"
+CONF_WEB_CONFIGURATION = "web_configuration"
 
 eybond_collector_ns = cg.esphome_ns.namespace("eybond_collector")
 EybondCollector = eybond_collector_ns.class_("EybondCollector", cg.Component, uart.UARTDevice)
@@ -68,6 +69,7 @@ def _validate_pn(value):
             cv.Optional(CONF_STATUS_LED_PIN): pins.gpio_output_pin_schema,
             cv.Optional(CONF_COM_LED_PIN): pins.gpio_output_pin_schema,
             cv.Optional(CONF_BLE_PROVISIONING, default=False): cv.boolean,
+            cv.Optional(CONF_WEB_CONFIGURATION, default=False): cv.boolean,
         }
     )
     .extend(cv.COMPONENT_SCHEMA)
@@ -77,20 +79,24 @@ def _validate_pn(value):
 
 
 def _final_validate(config):
-    """ble_provisioning needs ESP32 BLE and the esp32_ble_server GATT server."""
-    if not config.get(CONF_BLE_PROVISIONING):
-        return config
-    if not CORE.is_esp32:
-        raise cv.Invalid(
-            "ble_provisioning is only supported on ESP32 (it needs on-chip BLE); "
-            "ESP8266 and BK72xx/LibreTiny have no usable BLE server."
-        )
     full_config = fv.full_config.get()
-    if "esp32_ble_server" not in full_config:
+    if config.get(CONF_BLE_PROVISIONING):
+        if not CORE.is_esp32:
+            raise cv.Invalid(
+                "ble_provisioning is only supported on ESP32 (it needs on-chip BLE); "
+                "ESP8266 and BK72xx/LibreTiny have no usable BLE server."
+            )
+        if "esp32_ble_server" not in full_config:
+            raise cv.Invalid(
+                "ble_provisioning requires an 'esp32_ble_server:' entry in your YAML — "
+                "it provides the BLE GATT server the bridge attaches to. Add an empty "
+                "'esp32_ble_server:' block (see examples/esp32-ble.yaml)."
+            )
+    if config.get(CONF_WEB_CONFIGURATION) and "captive_portal" not in full_config:
         raise cv.Invalid(
-            "ble_provisioning requires an 'esp32_ble_server:' entry in your YAML — "
-            "it provides the BLE GATT server the bridge attaches to. Add an empty "
-            "'esp32_ble_server:' block (see examples/esp32-ble.yaml)."
+            "web_configuration requires a 'captive_portal:' entry; the settings "
+            "page reuses its stock Wi-Fi setup handlers on both the normal LAN "
+            "and the fallback access point"
         )
     return config
 
@@ -103,6 +109,21 @@ async def to_code(config):
     await cg.register_component(var, config)
     await uart.register_uart_device(var, config)
 
+    # Keep the generated UART component authoritative. These values are only
+    # metadata for the local configuration page; arbitrary pin remapping is not
+    # universally reloadable by ESPHome's platform UART implementations.
+    uart_tx_pin = -1
+    uart_rx_pin = -1
+    for uart_config in CORE.config.get("uart", []):
+        if uart_config.get(CONF_ID) != config[CONF_UART_ID]:
+            continue
+        if CONF_TX_PIN in uart_config:
+            uart_tx_pin = uart_config[CONF_TX_PIN][CONF_NUMBER]
+        if CONF_RX_PIN in uart_config:
+            uart_rx_pin = uart_config[CONF_RX_PIN][CONF_NUMBER]
+        break
+    cg.add(var.set_uart_pin_numbers(uart_tx_pin, uart_rx_pin))
+
     if CONF_PN in config:
         cg.add(var.set_pn(config[CONF_PN]))
     cg.add(var.set_udp_port(config[CONF_UDP_PORT]))
@@ -126,3 +147,6 @@ async def to_code(config):
     if config[CONF_BLE_PROVISIONING]:
         cg.add_define("USE_EYBOND_BLE")
         cg.add(var.set_ble_provisioning(True))
+    if config[CONF_WEB_CONFIGURATION]:
+        cg.add_define("USE_EYBOND_WEB_CONFIG")
+        cg.add(var.set_web_configuration(True))

components/eybond_collector/core.cpp

@@ -10,6 +10,15 @@ constexpr size_t HEARTBEAT_PN_LEN = 14;
 constexpr size_t MAX_UART_RESPONSE = 512;
 }  // namespace
 
+bool valid_collector_pn(const std::string &value) {
+  if (value.size() != 14 && value.size() != 18) return false;
+  if (value[0] < 'A' || value[0] > 'Z') return false;
+  for (size_t i = 1; i < value.size(); i++) {
+    if (value[i] < '0' || value[i] > '9') return false;
+  }
+  return true;
+}
+
 bool parse_uart_settings(const std::string &value, UartSettings *out) {
   // Split on commas into up to 4 fields: baud, data, stop, parity.
   std::string fields[4];
@@ -39,10 +48,16 @@ bool parse_uart_settings(const std::string &value, UartSettings *out) {
   UartSettings settings;
   settings.baud = baud;
   if (count >= 2 && !fields[1].empty()) {
-    settings.data_bits = static_cast<uint8_t>(std::atoi(fields[1].c_str()));
+    if (fields[1].size() != 1 || fields[1][0] < '5' || fields[1][0] > '8') {
+      return false;
+    }
+    settings.data_bits = static_cast<uint8_t>(fields[1][0] - '0');
   }
   if (count >= 3 && !fields[2].empty()) {
-    settings.stop_bits = static_cast<uint8_t>(std::atoi(fields[2].c_str()));
+    if (fields[2] != "1" && fields[2] != "2") {
+      return false;
+    }
+    settings.stop_bits = static_cast<uint8_t>(fields[2][0] - '0');
   }
   if (count >= 4 && !fields[3].empty()) {
     std::string parity = fields[3];
@@ -53,8 +68,10 @@ bool parse_uart_settings(const std::string &value, UartSettings *out) {
       settings.parity = UartParity::EVEN;
     } else if (parity == "ODD" || parity == "O") {
       settings.parity = UartParity::ODD;
-    } else {
+    } else if (parity == "NONE" || parity == "N") {
       settings.parity = UartParity::NONE;
+    } else {
+      return false;
     }
   }
   *out = settings;
@@ -100,14 +117,30 @@ bool parse_server_endpoint(const std::string &value, std::string *host, uint16_t
       return false;
     }
   }
-  if (parsed_port == 0 || host_text.empty()) {
+  if (!valid_server_endpoint(host_text, static_cast<uint16_t>(parsed_port))) {
     return false;
   }
   *host = host_text;
   *port = static_cast<uint16_t>(parsed_port);
   return true;
 }
 
+bool valid_server_endpoint(const std::string &host, uint16_t port) {
+  // PersistedEndpoint stores a NUL-terminated host in char[64]. Reject values
+  // that would otherwise be silently truncated after appearing to save.
+  if (port == 0 || host.empty() || host.size() > 63 || host.front() == '.' || host.back() == '.') {
+    return false;
+  }
+  for (const char ch : host) {
+    // Underscore is intentionally accepted: known factory endpoints include
+    // names such as dtu_ess.eybond.com.
+    if (!(std::isalnum(static_cast<unsigned char>(ch)) || ch == '.' || ch == '-' || ch == '_')) {
+      return false;
+    }
+  }
+  return true;
+}
+
 CollectorCore::CollectorCore(Actions *actions, CollectorProfile profile, CoreConfig config)
     : actions_(actions), profile_(std::move(profile)), config_(config) {
   splitter_.on_at_line = [this](const std::string &line) { this->handle_at_line_(line); };