> For the complete documentation index, see [llms.txt](https://docs.unwaste.energy/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.unwaste.energy/en/unwaste-robot-operation/technical-details/storage-control.md).

# Storage control

Learn how Unwaste decides when to request battery charging from the grid.

## What is storage control

**Storage control** describes how the **Unwaste Robot** decides *when to request charging an energy storage from the grid*.

The Unwaste Robot does **not** control whether surplus energy from local production (for example photovoltaic panels) is stored.

**Any surplus production that is not consumed immediately is always stored**, regardless of settings or prices.

What the Unwaste Robot controls is the **Force Charge mode**, which is effectively a signal meaning:

> "Charge the storage from the grid now."

The purpose of storage control is to request grid charging only when it is economically justified.

***

## How it works (high level)

The Unwaste Robot evaluates three main factors:

* **Energy usage forecast** An estimate of how much energy the household is likely to consume.
* **Energy production forecast** An estimate of expected local production (for example from solar PV).
* **Energy price** Information about whether grid energy is currently cheap or expensive.

Based on these inputs, the Unwaste Robot decides **whether or not to activate Force Charge**.

In general, it:

* **enables Force Charge when grid energy is cheap**, and future energy demand is expected,
* **avoids Force Charge when grid energy is expensive**,
* **avoids Force Charge if significant local production is expected**, even if the storage is not currently full.

***

## What this means in practice

* Surplus photovoltaic energy is **always stored automatically** if storage capacity is available.
* The Unwaste Robot does **not block or delay PV charging** in any way.
* The only decision made by the Unwaste Robot is whether to **actively charge the storage from the grid**.
* If high solar production is expected later, the system may intentionally **leave the storage partially empty**, waiting to fill it with local energy instead of grid energy.

This helps reduce costs while preserving full use of locally produced energy.

***

## Important notes

**Signal, not direct control**\nThe Unwaste Robot sends a **Force Charge signal**.\nThe storage device:

* decides how to execute it,
* may limit charging power,
* may ignore it for safety, health, or internal logic reasons.

**Device and installation dependency**\nActual behavior depends on:

* whether the storage supports Force Charge from external control,
* correct installation and configuration,
* availability of production forecasts and price data.

If required data is missing, the system may fall back to conservative behavior.

***

## Example

A household with:

* a battery,
* solar panels,
* a dynamic electricity tariff.

If:

* electricity is expensive now,
* high solar production is expected later today,

the Unwaste Robot will:

* **not enable Force Charge**, even if the battery is not full,
* allow the battery to fill later using surplus solar energy.

If:

* electricity becomes cheap at night,
* no production is expected,

the Unwaste Robot may enable **Force Charge** to prepare for next-day consumption.

***

## Surplus mode for devices (separate topic)

**Device Surplus mode** (when enabled on the connection) increases load during PV export. It is unrelated to storage Force Charge and is described in [Connection](https://docs.unwaste.energy/en/unwaste-robot-configuration/connection.md#surplus-mode) and [Device control](https://docs.unwaste.energy/en/unwaste-robot-configuration/device/device-control.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.unwaste.energy/en/unwaste-robot-operation/technical-details/storage-control.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
