All EyeBond Local documentation is publicly readable, but it serves two different audiences. Use the first section for installation and day-to-day operation. The maintainer references describe implementation boundaries and release work; they are not required to use the integration.
- Main README — installation, setup, connection settings, troubleshooting, and support flow
- Known cloud telemetry issue — cloud updates may pause while local readings continue; current status and useful support evidence
- Testing the unreleased main branch — manual installation of a maintainer-requested test build
- Setup and Discovery — collector-first setup, scan results, address confirmation, background discovery, and manual setup
- Runtime Detection and Entities — driver detection, Fast and Full protocol checks, polling, controls, and entity availability
- Kevolt / Deye-Compatible Advanced Controls — opt-in testing, read-back behavior, and intentionally excluded operations for the experimental 8 kW control surface
- Collector Management — cloud connection profiles, Wi-Fi, restart, UART, virtual bridges, and proxy-capture basics
- Device Learning — read-only cloud evidence and active verification of extra sensors and controls
- Diagnostic Commands — advanced, developer-provided read/write scenarios and shareable results
- Support Archive — what to attach when asking for hardware support
- Collector Proxy Capture — use this only when support asks for a temporary capture
- Remote / NAT Setup Guide — only for collectors outside the normal Home Assistant network
- Inverter Model Catalog — supported and partially supported inverter models
- Interface Screenshot Guide — examples from current and earlier interfaces, with notes about controls that moved
- ESP EyeBond Collector — community firmware bridge for inverters without a factory collector (detected and supported automatically; see Collector Management)
Ukrainian readers can also use the Ukrainian README.
If you are extending or maintaining the project, use ../CONTRIBUTING.md.
- Adding Drivers — driver structure, registration, tests, and documentation updates
- Validation — focused tests, quality gate, and Home Assistant compatibility lanes
- Releasing — maintainer-only release preparation and publication checklist
- Issue Triage — manual status labels, evidence requests, retest handling, and closing rules
- Graphify — regenerating and querying the local architecture knowledge graph
- Graphify Architecture Audit — findings and follow-up work from the current graph snapshot
- SMG Protocol Maps — evidence, independent protocol branches, generic controls, and model-specific overrides.
- Sumry/GES 0x7530 Qualification — exact-match read-only binding for Anenji GES48120, nine-field subset, and remaining telemetry/control limits.
- Collector Connection Architecture — maintainer reference for the connection axes, session/PN ownership,
callback_on_demand, endpoint ownership rules, and what must not be reintroduced. - Cloud Learning Architecture — provider-neutral learning methods, typed API sources, trust boundaries, and read-only metadata evidence.
- Typed Telemetry Migration — staged replacement of the broad runtime value mapping with a strict measurement contract.