Skip to content

Backlog

Jump to bottom
stephan-xyz edited this page Sep 13, 2026 · 1 revision

HomeNode Ecosystem & Server Backlog

This backlog tracks planned feature requests, protocol modules, and integration milestones for HomeNode Server and the wider HomeNode ecosystem.

📋 Backlog Items

1. 📡 BTHome Protocol Module (homenode-module-bthome)

  • Priority: High (Next development focus)
  • Component: HomeNode Server Module (modules/bthome or built into BLE stack)
  • Goal: Ingest and parse BTHome V1/V2 BLE broadcast advertisements from battery-operated sensors and beacons (Shelly BLU devices like BLU Button, BLU Door/Window, BLU Motion, BTHome DIY ESP32 sensors, thermometers).
  • Key Features:
    • Passive BLE scanner listening to service data UUID 0xFCD2 (BTHome V2) and 0x181C / 0x181E (BTHome V1).
    • Support for encrypted BTHome advertisements using pre-shared Binds / Encryption Keys (AES-CCM).
    • Support for unencrypted BTHome sensor telemetry (temperature, humidity, illuminance, battery %, motion, button press events).
    • Auto-discovery and creation of HomeNode device entities under Sensors & Detectors or Smart Home & IoT.
    • Integration into the HomeNode Supervisor event bus / gRPC upsert.
    • Forwarding / bridging to Matter fabric as Matter Sensor or Switch endpoints.

2. 🔌 Tuya Local & Cloud Integration Architecture

  • Priority: Medium / Backlog
  • Component: HomeNode Server (homenode-module-tuya / definitions) & mHomeNode iOS App
  • Goal: Full local control and telemetry ingestion for Tuya-based OEM devices (e.g., LSC Smart Connect Micro Solar Inverters, Tuya smart plugs, Wi-Fi relays) on local port 6668.
  • Key Features:
    • Server Module Settings (config/modules/tuya.toml):
      • Optional Cloud API credentials (client_id / Access ID, secret / Access Secret, endpoint e.g. https://openapi.tuyaeu.com).
      • Device registry mapping Virtual IDs (device_id), IP addresses, and 16-byte local_keys.
    • Home Assistant Bridge / Key Extraction:
      • Automatic import of local_key and entities from local Home Assistant (http://192.168.178.100:8123) via .storage/core.config_entries or REST API.
    • mHomeNode iOS Companion App User Flow:
      • Native Tuya authorization flow in the iOS app (e.g. via QR code scan or Tuya OAuth login).
      • Automatic token exchange and device key retrieval directly from Tuya Cloud on iOS.
      • End-to-end encrypted synchronization of retrieved local_keys and device_ids from the iOS app to HomeNode Server.
    • Local Inverter Poller:
      • Native Rust Tuya 3.3 / 3.4 protocol client connecting directly to device IP on port 6668.
      • Live polling of PV generation wattage ($W$), daily yield ($kWh$), and grid voltage ($V$).
      • Feed live solar data into the HomeNode Server Energy Dashboard.

📈 Status Overview

Item Component Status Next Step
BTHome Module HomeNode Server 🟡 Planned (Next) Design BLE advertisement receiver & BTHome parser
Tuya Local & Solar Inverter HomeNode Server & iOS 📝 Documented / Backlog Settings schema in server + iOS App Tuya login flow
Matter Controller & Bridge HomeNode Server 🟢 In Progress Multi-Admin fabric tracker & operational node bridge
Network Discovery & Classification HomeNode Server 🟢 Active L2/L3 scanner, switches, FRITZ!Box TR-064, Rhai rules

(c) Stephan Zehrer 2025

Clone this wiki locally