Documentation · 3.8.1

My devices

Inverters and batteries, their connections, the electricity meter and home equipment (charging station, water heater, heat pump…).

Documentation up to date with TedEnergy 3.8.1.

Inverters: controlled, monitored, solar

The Devices › Inverters page lists everything TedEnergy knows. Each battery inverter has a role:

  • Controlled: TedEnergy sets its charge and discharge.
  • Monitored: TedEnergy only reads it. Used when another system (a manufacturer's HEMS) keeps the commands: this is the basis of Assisted mode.
  • Solar: a panel inverter without battery (micro-inverters…): its production is measured and displayed.
  • Draft: a device being set up, never used until it is enabled.

Each line shows the battery, power, status and, in three-phase, the phase. A switch enables or disables the inverter; the ⋮ menu offers useful actions (take back control, force a retry, remove from regulation…). An inverter can be removed from regulation without its device sheet disappearing.

Declaring a device

In Settings › Devices, a device is declared once, with a unique name and reference. You choose the brand (one sheet per brand, or “Other brand”) and the model. The Inverters page then only gives it a role, a phase and a discharge priority, and enables it: no entity is entered there.

A device sheet has several tabs: connections, commands, measurements, battery levels, batteries and values read. For a known brand, an automatic fill suggests the entities; for others, a magnifier helps pick them. In every case, test the sheet before saving it: TedEnergy checks that measurements arrive and commands are accepted.

  • Command: two setpoints (charge and discharge, with or without a mode selector), one setpoint plus a direction selector, a signed setpoint, or Home Assistant actions; in W, kW, % or A.
  • Measurements: only the battery level is mandatory. Power, solar, battery power, AC output… are optional: each function that needs one is disabled, with an explanation, if the measurement is missing.
  • Consistency checks: TedEnergy refuses to save a sheet that reuses another device's command or battery level, checks that the requested actions exist and flags a device whose entities do not match.
  • Error 01 / 02 inhibition: a sheet checkbox for a device whose behaviour is legitimate (see How TedEnergy regulates).

A new controlled inverter is saved disabled, and the validation test (Diagnostic › Inverter test) is offered when you enable it.

A device's connections

The same device can be reached in several ways. TedEnergy uses the first one available in this order: local MQTT, local API, manufacturer cloud, Home Assistant (order adjustable per device). If the connection in use stops answering for some time, the next one takes over; the preferred connection comes back once it is stable again.

  • Local API: the device is queried directly on the home network (IP address), without Internet. Available for recent models (for example Zendure SolarFlow, Indevolt, IsyPower).
  • Local MQTT: the device publishes its values to TedEnergy's built-in MQTT server (see below), without Internet.
  • Manufacturer cloud: TedEnergy connects to the manufacturer's account (Zendure, EcoFlow). Convenient, but only one cloud access is possible per Zendure account: TedEnergy or the Zendure integration of Home Assistant.
  • Home Assistant: for every brand Home Assistant can read, using entities.

The Diagnostic page has one page per connection type (Home Assistant, cloud, local API, MQTT): values received, reading rate, setpoints sent and confirmed, events. A device that stays on a fallback connection is flagged.

A device in the inverter table always keeps at least one usable connection: the last one cannot be removed.

Brands and models

Supported brands and models, with their level (Operational, Compatible, Monitoring only) and their possible connections, are listed and kept up to date on the Compatibility page.

In short: Zendure is the most complete (cloud, local API, MQTT); EcoFlow is linked through its cloud; Indevolt and IsyPower through their local API; other brands go through Home Assistant or MQTT, with the “Other brand” sheet open to everyone. If your brand is missing, ask the community.

Device connectors

Settings › Device connectors links TedEnergy to brands that have direct access:

  • Zendure: paste the Zendure app token for the cloud, or add the device by IP address for the local API; the built-in MQTT server welcomes devices in “MQTT control”.
  • EcoFlow: through the manufacturer's developer account.
  • Indevolt and IsyPower: the device's IP address; a network search helps find it.
  • Other brands are under study; the page says why (for example local access that is too slow).

Devices added this way are then picked in the device sheet, like a Home Assistant entity.

The built-in MQTT server

TedEnergy contains an MQTT server that compatible devices can use instead of the cloud. Settings › MQTT connection guides the setup step by step: starting the server, opening the port (with a button for Home Assistant OS installations), testing, values to enter in the device, checking that the device is connected. Devices connecting to it appear with their values and attach to a device sheet.

Home Assistant

Home Assistant is one connection among others: it is only required for devices without a direct connection. With the Home Assistant OS app, the connection is automatic. With Docker, enter the Home Assistant address (with its port) and a long-lived access token in Settings › Home Assistant connection.

TedEnergy reads values in groups, or in real time when the link allows, so as not to overload Home Assistant. These fine settings are in Advanced communication; the defaults are fine.

Batteries and their levels

  • An inverter's batteries are declared in the Batteries tab of its sheet (automatic detection or manual entry): number, capacity in kWh, voltage. They feed the energy widgets, charge preparation and the cell-voltage gap alert.
  • The minimum and maximum levels protect the battery: the inverter does not discharge below the minimum nor charge above the maximum. They are set globally (Settings › Batteries and maximum power, with a draggable gauge, one arrow per inverter) and can be specific to each inverter.
  • A switch can apply the general levels to all inverters that have the matching entity: TedEnergy writes then checks and corrects the levels. The original levels are kept in memory and restored when you switch it off.
  • A restart margin avoids back-and-forth at the extremes: an almost full battery does not start charging again, an almost empty battery does not start discharging again, before it has left its limit zone by a few points. It is set globally and per inverter.
  • An automation can impose a level for a while; the imposed level is then locked and flagged.

Clusters, zones and phases

  • A cluster groups inverters that behave as one (shared setpoint, average level). Handy for several batteries behind the same connection point.
  • A zone sets a power cap shared by several inverters (for example the circuit breaker they share).
  • In three-phase, each inverter is attached to its phase (L1, L2, L3). For a controlled inverter, TedEnergy can identify the phase by itself: a button varies its power in steps and watches which phase reacts. For others, the phase is entered.

Testing an inverter

Diagnostic › Inverter test checks that a device really applies charge and discharge setpoints, outside regulation, at a small power of your choice. The result appears on the sheet (a badge flags devices never tested, to be revalidated or failed). The test can also detect the inverter's phase.

The electricity meter

All regulation relies on the power exchanged with the grid. Settings › Electricity meter says where it comes from:

  • a Home Assistant entity (positive when buying, negative when exporting);
  • a Shelly read directly by its IP address (single- or three-phase; a test shows each phase's power and suggests the right one);
  • the value of a device linked to TedEnergy (for example a Zendure meter).

You can declare several meters ranked by priority: if the first stops answering, the next one takes over, and the first comes back when it is stable. The sign of the measurement can be inverted.

Home equipment

Devices › Equipment declares what consumes or charges: car charging station, water heater, heat pump or air conditioner, pool, washing machine, radiator, smart plug, other. Equipment is tracked (power, energy per day), shown in the animated house and added to PDF reports. It does not act on regulation, except the charging station if you let TedEnergy control it.

How TedEnergy measures the equipment is your choice: a power measurement (W or kW), an energy counter (Wh or kWh: power is computed from its variation), a current (A) or a fixed power when the device is running. Several entities can be added together. Each piece of equipment can be hidden from the scene (display threshold) or excluded from reports.

  • An equipment's balance gives its energy, its share of the house's consumption, where that energy came from (solar, batteries, grid) and its cost at each moment's price.
  • Equipment already counted in another can be marked “included in…” to avoid double counting.

The controlled charging station

A charging station can be controlled by TedEnergy (checkbox in its sheet). You choose its goals in the sheet, written as sentences:

  • charging with surplus solar (with a minimum and maximum current);
  • charging during the subscription's advantageous hours;
  • a departure time with a level to reach;
  • a fallback level, and the Charge now, Pause, Automatic buttons.

The car never receives energy from the house batteries. The station respects the subscribed power (and sum-of-phases regulation if it is three-phase).

Discharging the car into the house (V2G) is possible on an experimental basis: TedEnergy then creates a virtual inverter, managed by the station's sheet. It has low priority and its minimum level is protected.

The station's sheet explains the effect of a wrong setting on the car battery's lifespan. The station's settings are only in its sheet, never in the Settings page.

Frequently asked questions

How many inverters can I control?

The number of controlled inverters depends on your license: it is shown in Settings › License. See License and account. Beyond it, extra inverters are treated as disabled.

Can I mix several brands?

Yes, it is TedEnergy's strong point: each brand keeps its connection, regulation shares the work among all controlled inverters.

My inverter is not in the list.

Choose “Other brand”: the sheet accepts the entities of any device exposed by Home Assistant or MQTT. Then run the validation test.

Why does a sheet refuse to save?

Probably because it reuses another device's command or battery level, or because a requested action does not exist in Home Assistant. The message names the field concerned.

A question, a special case? The community answers on Discord and Facebook. An AI can also analyse your installation: see “Tune with an AI” in TedEnergy's Settings. Discord · Facebook

Ready to make all your batteries work together?

Free download: your free license arrives as soon as your email address is confirmed, no credit card required.

Download for free