How jelmervos/envoy-reader works
Envoy Reader is a hosted Enphase Envoy-S monitoring service. Its main cycle checks daylight, reads inverter production and optionally net frequency, then dispatches readings to configured output writers; the hosted service also maintains a healthcheck file. The README is brief, so details of the major integrations come mainly from the source index and sampled code. In particular, PVOutput and healthcheck writer internals were not sampled; their external interactions are shown only where documented or marked unverified.
Main entry points: Aggregator.cs Aggregator · EnvoyReaderService.cs Polling service · Program.cs CLI host · InputReaders.cs Input readers
Components 20
Hosted runtime
- CLI host
EnvoyReader2/Program.cs - Polling service
EnvoyReader2/Service/EnvoyReaderService.cs - Service wiring
EnvoyReader2/Service/EnvoyReaderServiceConfigurator.cs
Collection and timing
- Aggregator
EnvoyReader2/Aggregator/Aggregator.cs - Inverter readings
EnvoyReader2/Aggregator/InverterData.cs - Input readers
EnvoyReader2/Readers/InputReaders.cs - Envoy reader
EnvoyReader2/Envoy/EnvoyReader.cs - Envoy client factory
EnvoyReader2/Envoy/EnvoyClientFactory.cs - Sunrise and sunset
EnvoyReader2/SunriseSunset/SunriseSunset.cs - Sunrise calculations
EnvoyReader2/SunriseSunset/Sunriset.cs
Output integrations
- Net frequency reader
EnvoyReader2/HomeAssistant/HomeAssistant.cs - Home Assistant API
EnvoyReader2/HomeAssistant/IHomeAssistantApi.cs - PVOutput writer
EnvoyReader2/PvOutput/PvOutputWriter.cs
Health monitoring
- Healthcheck writer
EnvoyReader2/Healthcheck/HealthcheckWriter.cs - Healthcheck command
EnvoyReader2/Healthcheck/HealthcheckService.cs
Other components
- Operator
- Home Assistant
- PVOutput
- Healthcheck file
- Enphase Envoy-S
Connections 20
- Operator → CLI host: starts
EnvoyReader2/Program.cs - CLI host → Polling service: configures default
EnvoyReader2/Program.cs - CLI host → Healthcheck command: configures command
EnvoyReader2/Program.cs - Service wiring → Polling service: registers
EnvoyReader2/Service/EnvoyReaderServiceConfigurator.cs - Service wiring → Aggregator: registers
EnvoyReader2/Service/EnvoyReaderServiceConfigurator.cs - Polling service → Aggregator: runs periodically
EnvoyReader2/Service/EnvoyReaderService.cs - Polling service → Healthcheck writer: updates health
EnvoyReader2/Service/EnvoyReaderService.cs - Aggregator → Sunrise and sunset: checks daylight
EnvoyReader2/Aggregator/Aggregator.cs - Aggregator → Input readers: reads inputs
EnvoyReader2/Aggregator/Aggregator.cs - Aggregator → PVOutput writer: dispatches output
EnvoyReader2/Aggregator/Aggregator.cs - Input readers → Envoy reader: reads production
EnvoyReader2/Service/EnvoyReaderServiceConfigurator.cs - Input readers → Net frequency reader: reads frequency
EnvoyReader2/Service/EnvoyReaderServiceConfigurator.cs - Envoy reader → Envoy client factory: creates client
EnvoyReader2/Envoy/EnvoyReader.cs - Envoy client factory → Enphase Envoy-S: authenticates and reads
- Sunrise and sunset → Sunrise calculations: uses calculations
EnvoyReader2/SunriseSunset/SunriseSunset.cs - Net frequency reader → Home Assistant API: requests state
EnvoyReader2/HomeAssistant/HomeAssistant.cs - Home Assistant API → Home Assistant: queries state
- PVOutput writer → PVOutput: submits readings
- Healthcheck writer → Healthcheck file: writes status
- Healthcheck command → Healthcheck file: checks freshness
EnvoyReader2/Healthcheck/HealthcheckService.cs