# homebridge-moebios-energy

Homebridge plugin for real-time monitoring of **Moebios Energy** systems, including

solar generation, grid usage, home consumption, and battery status.

This plugin exposes Moebios Energy data to Apple HomeKit using native HomeKit services.

## Features

- Solar generation monitoring

- Home consumption status

- Battery state of charge (SOC)

- Grid import/export awareness

- Read-only and safe by design

- Optimized for low-latency polling

## Requirements

- Node.js >= 18

- Homebridge >= 1.7

- A valid Moebios Energy account and API token

## Installation

npm install -g homebridge-moebios-energy


Or install via Homebridge UI → Plugins.

Configuration

Add the plugin through the Homebridge UI or manually in config.json.

Example
{
  "platforms": [
    {
      "platform": "MoebiosEnergy",
      "apiUrl": "https://energy.moebios.com.br/api",
      "apiToken": "YOUR_API_TOKEN",
      "pollInterval": 30
    }
  ]
}

Options
Option	Description	Required	Default
apiUrl	Moebios Energy API base URL	Yes	—
apiToken	API authentication token	Yes	—
pollInterval	Polling interval in seconds	No	30
Exposed HomeKit Services
Feature	HomeKit Service
Solar Generation	Light Sensor
Home Consumption	Outlet
Battery SOC	Battery

Power values are normalized and mapped to HomeKit-compatible characteristics.

Security

All communication is done over HTTPS

Tokens are stored locally in Homebridge

No control or write operations are performed

Roadmap

Multiple devices / inverters

MQTT or WebSocket support

Individual circuit monitoring

Write actions (load control)

Energy history via Eve app

Support

For issues, feature requests, or integration support:

https://moebios.com.br

https://github.com/moebios

License

MIT © Moebios Energy


---

## Próximo passo recomendado

Agora você está **pronto para publicar**.

Sugiro seguir com **uma dessas evoluções**:

1. Criar o **endpoint Laravel real** (`HomebridgeTelemetryController`)
2. Adicionar **suporte multi-device** no plugin
3. Evoluir para **push (MQTT/WebSocket)** usando sua infra atual
4. Preparar **Eve Energy / PowerMeter mapping** (muito valorizado)

Diga qual deles você quer fazer primeiro e eu avanço direto no código.