> For the complete documentation index, see [llms.txt](https://docs.smart-stuff.nl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smart-stuff.nl/gebruik/netswitch.md).

# NetSwitch

{% hint style="warning" %}
NetSwitch is beschikbaar in de firmware voor Ethernet Dongle Pro, Ethernet Dongle Pro+, Ultra en Ultra Mini. De functie is niet beschikbaar in de standaardfirmware voor P1 Dongle Pro en NRG Dongle Pro.
{% endhint %}

Met NetSwitch schakelt u een Shelly-relais of een lokale IO-uitgang van de dongle op basis van het netto vermogen bij de slimme meter. U kunt reageren op **teruglevering** of **afname**.

Bijvoorbeeld: een boiler inschakelen bij voldoende teruglevering, of een laadpaal uitschakelen bij hoge afname. NetSwitch gebruikt twee vermogensgrenzen en twee vertragingen om veelvuldig schakelen te voorkomen.

## Wat heeft u nodig?

* Een dongle en firmware met NetSwitch-ondersteuning.
* Voor schakelen via het netwerk: een bereikbaar Shelly-apparaat dat de HTTP-aanroep `/relay/<id>?turn=on` en `/relay/<id>?turn=off` ondersteunt.
* Voor lokaal schakelen: een geschikte, beschikbare IO-uitgang op uw dongle en een daarop aangesloten schakeling.

## Instellen

1. Zet **NetSwitch enabled** (`netsw-enabled`) aan in [Settings](https://docs.smart-stuff.nl/instellingen/settings.md).
2. Open het tabblad **NetSwitch** in het menu van de webinterface.
3. Kies bij **Reageer op** voor **Teruglevering** of **Afname**. Vul de vermogensgrenzen in als positieve waarden in watt; een minteken voor teruglevering is niet nodig.
4. Stel de schakelactie en terugschakelactie in volgens de tabel hieronder.
5. Kies de status bij opstarten en stel Shelly of dongle IO in.
6. Klik op **Opslaan**.

| Instelling                              | Betekenis                                                                                                                            |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Schakelactie – Vanaf**                | Bij dit vermogen of hoger begint de vertraging voor de schakelactie.                                                                 |
| **Schakelactie – Shelly/IO wordt**      | Kies **ON** of **OFF** als gewenste stand bij het bereiken van de bovenste grens.                                                    |
| **Schakelactie – Vertraging**           | Het aantal seconden dat de voorwaarde voor de schakelactie aaneengesloten moet gelden.                                               |
| **Terugschakelactie – Onder**           | Bij dit vermogen of lager begint de vertraging voor de terugschakelactie. Ook precies op deze grens geldt de terugschakelvoorwaarde. |
| **Terugschakelactie – Shelly/IO wordt** | Automatisch de tegenovergestelde stand van de schakelactie.                                                                          |
| **Terugschakelactie – Vertraging**      | Het aantal seconden dat de voorwaarde voor de terugschakelactie aaneengesloten moet gelden.                                          |
| **Status bij opstarten**                | De beginstand die de dongle bij het opstarten aanstuurt voordat de vermogensvoorwaarden een andere stand bepalen.                    |

De terugschakelgrens moet **lager** zijn dan de schakelgrens. Tussen beide grenzen blijft de laatst aangestuurde stand behouden. Dit heet hysterese. De balk onder de instellingen toont de twee grenzen en de standen aan weerszijden van het tussenliggende gebied.

Zodra het vermogen een grensgebied verlaat, vervalt de lopende vertraging voor dat gebied. In het gebied tussen de grenzen worden beide vertragingen gereset. De firmware beoordeelt de voorwaarden bij nieuwe P1-meetwaarden.

Bij **Teruglevering** gaat het om netto teruglevering aan het net, niet om de totale productie van uw zonnepanelen. Bij **Afname** gaat het om netto afname van het net. Als de energierichting omkeert, geldt de terugschakelvoorwaarde ook: afname bij een terugleverregeling, of teruglevering bij een afnameregeling.

## De huidige interface

<figure><img src="https://242210560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa0nbnZRi8AhAnCzcZmch%2Fuploads%2Fgit-blob-d610002ecd6365d79b86c259cdbb44ddfa4c8655%2Fnetswitch.png?alt=media" alt="NetSwitch met richtingkeuze, twee vermogensgrenzen, vertragingen en Shelly- of IO-instellingen"><figcaption><p>De huidige NetSwitch-interface.</p></figcaption></figure>

In deze screenshot staat **Reageer op** op **Teruglevering** en de schakelactie op **OFF**:

* Bij **100 watt of meer teruglevering** gedurende **60 seconden** wordt de uitgang **OFF**.
* Bij **0 watt teruglevering of afname van het net** gedurende **120 seconden** wordt de uitgang **ON**.
* Tussen **0 en 100 watt teruglevering** blijft de laatst aangestuurde stand behouden. De grijze zone in de balk geeft dit gebied aan.
* **Status bij opstarten** staat op **OFF** en **Dongle IO nummer** op **0**, dus deze instelling gebruikt een Shelly. Het IP-adres of de hostnaam moet nog worden ingevuld.

De kleuren in de balk geven de ingestelde uitgangsstanden aan: groen is **ON**, rood is **OFF**. Ze tonen geen actuele vermogensmeting of terugmelding van de Shelly.

## Voorbeeld: boiler inschakelen bij teruglevering

U wilt de boiler inschakelen nadat u minstens 60 seconden 1.000 watt of meer teruglevert. De boiler moet weer uit als de teruglevering minstens 120 seconden 200 watt of minder is.

| Instelling                          | Waarde            |
| ----------------------------------- | ----------------- |
| Reageer op                          | Teruglevering     |
| Schakelactie – Vanaf                | 1000 watt         |
| Schakelactie – Shelly/IO wordt      | ON                |
| Schakelactie – Vertraging           | 60 seconden       |
| Terugschakelactie – Onder           | 200 watt          |
| Terugschakelactie – Shelly/IO wordt | OFF (automatisch) |
| Terugschakelactie – Vertraging      | 120 seconden      |
| Status bij opstarten                | OFF               |

Tussen 200 en 1.000 watt teruglevering blijft de huidige stand behouden. Als de meter afname registreert, begint eveneens de vertraging voor uitschakelen.

## Voorbeeld: laadpaal uitschakelen bij hoge afname

U wilt de laadpaal uitschakelen bij minstens 5.000 watt afname gedurende 30 seconden. Bij 3.000 watt afname of minder gedurende 120 seconden mag de laadpaal weer aan.

| Instelling                          | Waarde           |
| ----------------------------------- | ---------------- |
| Reageer op                          | Afname           |
| Schakelactie – Vanaf                | 5000 watt        |
| Schakelactie – Shelly/IO wordt      | OFF              |
| Schakelactie – Vertraging           | 30 seconden      |
| Terugschakelactie – Onder           | 3000 watt        |
| Terugschakelactie – Shelly/IO wordt | ON (automatisch) |
| Terugschakelactie – Vertraging      | 120 seconden     |
| Status bij opstarten                | OFF              |

Hier betekent **Schakelactie** dus uitschakelen. De terugschakelactie wordt automatisch inschakelen.

## Shelly of dongle IO

### Shelly via het netwerk

* Zet **Dongle IO nummer** op **0**.
* Vul bij **IP-adres of hostnaam** het adres van de Shelly in, zonder `http://` of een pad.
* Vul het **Relais ID** in, meestal **0**.

De dongle gebruikt HTTP met het pad `/relay/<id>?turn=on` of `/relay/<id>?turn=off`. Controleer of uw Shelly deze aanroepen ondersteunt; de firmware gebruikt geen Shelly RPC-aanroepen. De interface heeft geen invoervelden voor een Shelly-gebruikersnaam of wachtwoord.

### Lokale IO-uitgang

Vul bij **Dongle IO nummer** een geschikt GPIO-nummer groter dan **0** in. De dongle stuurt dan deze uitgang aan en gebruikt de Shelly-instellingen niet. **ON** betekent een hoog uitgangssignaal; **OFF** betekent een laag uitgangssignaal. De uiteindelijke relaisstand hangt af van de aangesloten schakeling.

Gebruik alleen een uitgang die op uw hardware beschikbaar en geschikt is. Het invoerveld is geen overzicht van vrije GPIO-pinnen.

## Bestaande configuraties

De configuratie wordt opgeslagen in `netswitch.json`. Oudere bestanden met `value`, of met `value_on` en `value_off`, worden nog ingelezen. Zonder een expliciete richting betekent een negatieve oude schakelwaarde teruglevering en een positieve waarde afname.

Bij het openen zet de huidige interface deze waarden om naar een richting en positieve vermogensgrenzen. Had uw oude configuratie één grens, kies dan een lagere terugschakelgrens voordat u opnieuw opslaat. De huidige interface accepteert geen gelijke grenzen.
