From 5f66544e630ea0172f8571c745de5b2905b47c9d Mon Sep 17 00:00:00 2001
From: premultiply <4681172+premultiply@users.noreply.github.com>
Date: Tue, 17 Nov 2026 22:36:54 +0100
Subject: [PATCH 1/2] GPIO: document activelow, bias and chip
---
src/content/docs/en/reference/plugins.mdx | 35 ++++++++++++++++----
src/content/docs/en/user-defined-devices.mdx | 3 ++
2 files changed, 32 insertions(+), 6 deletions(-)
diff --git a/src/content/docs/en/reference/plugins.mdx b/src/content/docs/en/reference/plugins.mdx
index 3a558965f3..6794b715c6 100644
--- a/src/content/docs/en/reference/plugins.mdx
+++ b/src/content/docs/en/reference/plugins.mdx
@@ -110,23 +110,37 @@ It is particularly suitable for Raspberry Pi and similar single-board computers.
**Parameters**:
-| Parameter | Type | Required | Description |
-| --------- | ------ | -------- | ---------------------------------------- |
-| function | string | yes | Mode: `read` (input) or `write` (output) |
-| pin | int | yes | Pin number (BCM numbering, e.g. GPIO 17) |
+| Parameter | Type | Required | Description |
+| --------- | ------ | -------- | ----------------------------------------------------------------------------------- |
+| function | string | yes | Mode: `read` (input) or `write` (output) |
+| pin | int | yes | Pin number (BCM numbering, e.g. GPIO 17) |
+| activelow | bool | no | Inverts the logic: `true` = LOW, `false` = HIGH. Default `false` |
+| bias | string | no | Internal resistor: `pull-up`, `pull-down`, `disabled` or `as-is`. Default see below |
+| chip | string | no | GPIO chip. Default `gpiochip0` |
**How it works**:
- **Reading** (`function: read`): Reads the state of a GPIO pin as a boolean value (`true` = HIGH, `false` = LOW)
- **Writing** (`function: write`): Sets a GPIO pin to HIGH (`true`) or LOW (`false`)
-Inputs always use the internal pull-up resistor, so a switch contact is wired between the pin and ground (GND).
+With `activelow: true` both directions are inverted: a LOW pin reads as `true`, and `true` sets the pin to LOW.
+Outputs start in the inactive state, i.e. LOW, or HIGH with `activelow`.
+
+Inputs use the internal pull-up resistor by default, outputs leave the resistor unchanged.
+Set `bias` to change this, e.g. `pull-down` for a contact wired between the pin and 3.3 V.
+If several configurations use the same pin, their `bias` values must not differ.
+
+With the default settings, a switch contact is wired between the pin and ground (GND).
An open contact reads as `true` (HIGH), a closed contact as `false` (LOW).
For a limit signal, use the normally closed (NC) contact of the relay.
During normal operation the contact is closed and the pin reads `false`.
When the limit is activated, the contact opens and the pin reads `true`.
A broken cable also reads as `true`, so the limit kicks in as a fail-safe.
+If your control box only provides a normally open (NO) contact, wire it the same way and set `activelow: true`.
+The closed contact then reads as `true`.
+This wiring is not fail-safe: a broken cable reads as `false` and the limit is not applied.
+
Pin numbering follows the BCM scheme (Broadcom numbers, not the physical pin position).
For a Raspberry Pi pinout, see e.g. [pinout.xyz](https://pinout.xyz/).
@@ -138,6 +152,15 @@ function: read
pin: 17 # BCM pin number
```
+**Reading Example** (normally open contact):
+
+```yaml
+source: gpio
+function: read
+pin: 17 # BCM pin number
+activelow: true # closed contact reads as true
+```
+
**Writing Example**:
```yaml
@@ -147,7 +170,7 @@ pin: 27 # BCM pin number
```
:::note
-This plugin only works on Linux systems with access to `/dev/gpiomem`.
+This plugin only works on Linux systems with access to the GPIO chip, e.g. `/dev/gpiochip0`.
:::
### Go \{#go\}
diff --git a/src/content/docs/en/user-defined-devices.mdx b/src/content/docs/en/user-defined-devices.mdx
index 161eb222a8..61b6dc2bb5 100644
--- a/src/content/docs/en/user-defined-devices.mdx
+++ b/src/content/docs/en/user-defined-devices.mdx
@@ -611,6 +611,8 @@ limit:
Wire the normally closed (NC) contact of the relay between the pin and ground (GND).
An open contact or a broken cable then activates the limit.
+If the control box only provides a normally open (NO) contact, add `activelow: true`.
+This wiring is not fail-safe, a broken cable does not activate the limit.
For more details on the GPIO plugin, see the [plugin documentation](/en/reference/plugins#gpio).
@@ -706,6 +708,7 @@ s1:
```
With GPIO, use the normally closed (NC) contact of each relay, so an open contact or a broken cable reads as active.
+For normally open (NO) contacts, add `activelow: true` to each signal. A broken cable is then no longer detected.
See the [GPIO plugin](/en/reference/plugins#gpio) for details.
### EEBUS \{#external-limit-eebus\}
From a4bb5cdbdcb46f097f06a254c44ed9946fb16a12 Mon Sep 17 00:00:00 2001
From: premultiply <4681172+premultiply@users.noreply.github.com>
Date: Tue, 17 Nov 2026 23:07:24 +0100
Subject: [PATCH 2/2] GPIO: translate activelow, bias and chip
---
src/content/docs/cs/reference/plugins.mdx | 37 ++++++++++++++----
src/content/docs/cs/user-defined-devices.mdx | 5 ++-
src/content/docs/da/reference/plugins.mdx | 37 ++++++++++++++----
src/content/docs/da/user-defined-devices.mdx | 5 ++-
src/content/docs/de/reference/plugins.mdx | 37 ++++++++++++++----
src/content/docs/de/user-defined-devices.mdx | 5 ++-
src/content/docs/fr/reference/plugins.mdx | 37 ++++++++++++++----
src/content/docs/fr/user-defined-devices.mdx | 5 ++-
src/content/docs/it/reference/plugins.mdx | 37 ++++++++++++++----
src/content/docs/it/user-defined-devices.mdx | 5 ++-
src/content/docs/nl/reference/plugins.mdx | 40 +++++++++++++++-----
src/content/docs/nl/user-defined-devices.mdx | 5 ++-
12 files changed, 205 insertions(+), 50 deletions(-)
diff --git a/src/content/docs/cs/reference/plugins.mdx b/src/content/docs/cs/reference/plugins.mdx
index e2ae7b8863..770ed1df95 100644
--- a/src/content/docs/cs/reference/plugins.mdx
+++ b/src/content/docs/cs/reference/plugins.mdx
@@ -3,7 +3,7 @@ title: Pluginy
description: "Pluginy, které čtou a zapisují jednotlivé hodnoty přes Modbus, HTTP, MQTT, skripty a další rozhraní, tvoří stavební kameny zařízení definovaných uživatelem."
tableOfContents:
maxHeadingLevel: 4
-translatedFrom: "3a558965f35f"
+translatedFrom: "6794b715c615"
---
import { Badge } from "@astrojs/starlight/components";
@@ -111,23 +111,37 @@ Hodí se zejména pro Raspberry Pi a podobné jednodeskové počítače.
**Parametry**:
-| Parametr | Typ | Povinný | Popis |
-| -------- | ------ | ------- | ------------------------------------------- |
-| function | string | ano | Režim: `read` (vstup) nebo `write` (výstup) |
-| pin | int | ano | Číslo pinu (číslování BCM, např. GPIO 17) |
+| Parametr | Typ | Povinný | Popis |
+| --------- | ------ | ------- | ----------------------------------------------------------------------------------- |
+| function | string | ano | Režim: `read` (vstup) nebo `write` (výstup) |
+| pin | int | ano | Číslo pinu (číslování BCM, např. GPIO 17) |
+| activelow | bool | ne | Invertuje logiku: `true` = LOW, `false` = HIGH. Výchozí `false` |
+| bias | string | ne | Interní rezistor: `pull-up`, `pull-down`, `disabled` nebo `as-is`. Výchozí viz níže |
+| chip | string | ne | Čip GPIO. Výchozí `gpiochip0` |
**Jak to funguje**:
- **Čtení** (`function: read`): Čte stav pinu GPIO jako logickou hodnotu (`true` = HIGH, `false` = LOW)
- **Zápis** (`function: write`): Nastaví pin GPIO na HIGH (`true`) nebo LOW (`false`)
-Vstupy vždy používají interní pull-up rezistor, takže se spínací kontakt zapojuje mezi pin a zem (GND).
+S `activelow: true` se invertují oba směry: pin ve stavu LOW se čte jako `true` a `true` nastaví pin na LOW.
+Výstupy začínají v neaktivním stavu, tj. LOW, nebo HIGH s `activelow`.
+
+Vstupy ve výchozím nastavení používají interní pull-up rezistor, výstupy rezistor ponechávají beze změny.
+Chcete-li to změnit, nastavte `bias`, např. `pull-down` pro kontakt zapojený mezi pin a 3,3 V.
+Pokud stejný pin používá více konfigurací, jejich hodnoty `bias` se nesmějí lišit.
+
+Při výchozím nastavení se spínací kontakt zapojuje mezi pin a zem (GND).
Rozpojený kontakt se čte jako `true` (HIGH), sepnutý kontakt jako `false` (LOW).
Pro signál limitu použijte rozpínací kontakt (NC) relé.
Za běžného provozu je kontakt sepnutý a z pinu se čte `false`.
Když se limit aktivuje, kontakt se rozpojí a z pinu se čte `true`.
Přerušený kabel se také čte jako `true`, takže limit bezpečně zapůsobí i při poruše.
+Pokud vaše řídicí jednotka poskytuje pouze spínací kontakt (NO), zapojte jej stejně a nastavte `activelow: true`.
+Sepnutý kontakt se pak čte jako `true`.
+Toto zapojení není bezpečné při poruše: přerušený kabel se čte jako `false` a limit se neuplatní.
+
Číslování pinů se řídí schématem BCM (čísla Broadcom, nikoli fyzická pozice pinu).
Rozložení pinů Raspberry Pi najdete např. na [pinout.xyz](https://pinout.xyz/).
@@ -139,6 +153,15 @@ function: read
pin: 17 # číslo pinu BCM
```
+**Příklad čtení** (spínací kontakt):
+
+```yaml
+source: gpio
+function: read
+pin: 17 # číslo pinu BCM
+activelow: true # sepnutý kontakt se čte jako true
+```
+
**Příklad zápisu**:
```yaml
@@ -148,7 +171,7 @@ pin: 27 # číslo pinu BCM
```
:::note
-Tento plugin funguje pouze v systémech Linux s přístupem k `/dev/gpiomem`.
+Tento plugin funguje pouze v systémech Linux s přístupem k čipu GPIO, např. `/dev/gpiochip0`.
:::
### Go \{#go\}
diff --git a/src/content/docs/cs/user-defined-devices.mdx b/src/content/docs/cs/user-defined-devices.mdx
index 4a3f12b576..698d96cd53 100644
--- a/src/content/docs/cs/user-defined-devices.mdx
+++ b/src/content/docs/cs/user-defined-devices.mdx
@@ -3,7 +3,7 @@ title: Zařízení definovaná uživatelem
description: "Připojte nabíječku, měřič, vozidlo nebo topení, pro které neexistuje vestavěná šablona, a jejich hodnoty i ovládání si definujte sami přes HTTP, MQTT nebo Modbus."
tableOfContents:
maxHeadingLevel: 4
-translatedFrom: "161eb222a89c"
+translatedFrom: "61b6dc2bb5b9"
---
import { Tabs, TabItem } from "@astrojs/starlight/components";
@@ -612,6 +612,8 @@ limit:
Rozpínací kontakt (NC) relé zapojte mezi pin a zem (GND).
Rozpojený kontakt nebo přerušený kabel pak limit aktivuje.
+Pokud řídicí jednotka poskytuje pouze spínací kontakt (NO), přidejte `activelow: true`.
+Toto zapojení není bezpečné při poruše: přerušený kabel limit neaktivuje.
Další podrobnosti o pluginu GPIO najdete v [dokumentaci pluginů](/cs/reference/plugins#gpio).
@@ -707,6 +709,7 @@ s1:
```
U GPIO použijte rozpínací kontakt (NC) každého relé, aby se rozpojený kontakt nebo přerušený kabel vyhodnotil jako aktivní signál.
+U spínacích kontaktů (NO) přidejte ke každému signálu `activelow: true`. Přerušený kabel pak už není rozpoznán.
Podrobnosti najdete u [pluginu GPIO](/cs/reference/plugins#gpio).
### EEBUS \{#external-limit-eebus\}
diff --git a/src/content/docs/da/reference/plugins.mdx b/src/content/docs/da/reference/plugins.mdx
index 9383f07e73..c354313eda 100644
--- a/src/content/docs/da/reference/plugins.mdx
+++ b/src/content/docs/da/reference/plugins.mdx
@@ -3,7 +3,7 @@ title: Plugins
description: "Plugins læser og skriver enkelte værdier via Modbus, HTTP, MQTT, scripts m.m. og udgør byggestenene i brugerdefinerede enheder."
tableOfContents:
maxHeadingLevel: 4
-translatedFrom: "3a558965f35f"
+translatedFrom: "6794b715c615"
---
import { Badge } from "@astrojs/starlight/components";
@@ -111,23 +111,37 @@ Det er særligt velegnet til Raspberry Pi og lignende enkeltkortcomputere.
**Parametre**:
-| Parameter | Type | Påkrævet | Beskrivelse |
-| --------- | ------ | -------- | ----------------------------------------------- |
-| function | string | ja | Tilstand: `read` (input) eller `write` (output) |
-| pin | int | ja | Pinnummer (BCM-nummerering, f.eks. GPIO 17) |
+| Parameter | Type | Påkrævet | Beskrivelse |
+| --------- | ------ | -------- | ---------------------------------------------------------------------------------------- |
+| function | string | ja | Tilstand: `read` (input) eller `write` (output) |
+| pin | int | ja | Pinnummer (BCM-nummerering, f.eks. GPIO 17) |
+| activelow | bool | nej | Inverterer logikken: `true` = LOW, `false` = HIGH. Standard `false` |
+| bias | string | nej | Intern modstand: `pull-up`, `pull-down`, `disabled` eller `as-is`. Standard, se nedenfor |
+| chip | string | nej | GPIO-chip. Standard `gpiochip0` |
**Sådan fungerer det**:
- **Læsning** (`function: read`): Læser tilstanden af en GPIO-pin som en boolsk værdi (`true` = HIGH, `false` = LOW)
- **Skrivning** (`function: write`): Sætter en GPIO-pin til HIGH (`true`) eller LOW (`false`)
-Indgange bruger altid den interne pull-up-modstand, så en kontakt forbindes mellem pinnen og stel (GND).
+Med `activelow: true` inverteres begge retninger: en LOW-pin læses som `true`, og `true` sætter pinnen til LOW.
+Udgange starter i inaktiv tilstand, dvs. LOW, eller HIGH med `activelow`.
+
+Indgange bruger som standard den interne pull-up-modstand, udgange lader modstanden være uændret.
+Indstil `bias` for at ændre dette, f.eks. `pull-down` for en kontakt, der er forbundet mellem pinnen og 3,3 V.
+Hvis flere konfigurationer bruger den samme pin, må deres `bias`-værdier ikke være forskellige.
+
+Med standardindstillingerne forbindes en kontakt mellem pinnen og stel (GND).
En åben kontakt læses som `true` (HIGH), en lukket kontakt som `false` (LOW).
Til et begrænsningssignal bruger du relæets normalt lukkede (NC) kontakt.
Under normal drift er kontakten lukket, og pinnen aflæses som `false`.
Når grænsen aktiveres, åbner kontakten, og pinnen aflæses som `true`.
Et kabelbrud læses også som `true`, så grænsen træder i kraft som fejlsikring.
+Hvis din styreboks kun har en normalt åben (NO) kontakt, så forbind den på samme måde og indstil `activelow: true`.
+Den lukkede kontakt læses så som `true`.
+Denne ledningsføring er ikke fejlsikker: et kabelbrud læses som `false`, og grænsen anvendes ikke.
+
Pinnummereringen følger BCM-skemaet (Broadcom-numre, ikke den fysiske pinposition).
Et pinout-diagram til Raspberry Pi finder du f.eks. på [pinout.xyz](https://pinout.xyz/).
@@ -139,6 +153,15 @@ function: read
pin: 17 # BCM-pinnummer
```
+**Eksempel på læsning** (normalt åben kontakt):
+
+```yaml
+source: gpio
+function: read
+pin: 17 # BCM-pinnummer
+activelow: true # lukket kontakt læses som true
+```
+
**Eksempel på skrivning**:
```yaml
@@ -148,7 +171,7 @@ pin: 27 # BCM-pinnummer
```
:::note
-Dette plugin virker kun på Linux-systemer med adgang til `/dev/gpiomem`.
+Dette plugin virker kun på Linux-systemer med adgang til GPIO-chippen, f.eks. `/dev/gpiochip0`.
:::
### Go \{#go\}
diff --git a/src/content/docs/da/user-defined-devices.mdx b/src/content/docs/da/user-defined-devices.mdx
index e3e9e99e3a..02c09b89c3 100644
--- a/src/content/docs/da/user-defined-devices.mdx
+++ b/src/content/docs/da/user-defined-devices.mdx
@@ -3,7 +3,7 @@ title: Brugerdefinerede enheder
description: "Du kan integrere en oplader, en måler, et køretøj eller en varmeenhed uden indbygget skabelon ved selv at definere aflæsning og styring via HTTP, MQTT eller Modbus."
tableOfContents:
maxHeadingLevel: 4
-translatedFrom: "161eb222a89c"
+translatedFrom: "61b6dc2bb5b9"
---
import { Tabs, TabItem } from "@astrojs/starlight/components";
@@ -612,6 +612,8 @@ limit:
Forbind relæets normalt lukkede (NC) kontakt mellem pinnen og stel (GND).
En åben kontakt eller et kabelbrud aktiverer dermed grænsen.
+Hvis styreboksen kun har en normalt åben (NO) kontakt, så tilføj `activelow: true`.
+Denne ledningsføring er ikke fejlsikker, da et kabelbrud ikke aktiverer grænsen.
Flere detaljer om GPIO-pluginet finder du i [plugindokumentationen](/da/reference/plugins#gpio).
@@ -707,6 +709,7 @@ s1:
```
Med GPIO bruger du den normalt lukkede (NC) kontakt på hvert relæ, så en åben kontakt eller et kabelbrud aflæses som aktivt.
+Ved normalt åbne (NO) kontakter tilføjer du `activelow: true` til hvert signal. Et kabelbrud registreres så ikke længere.
Se [GPIO-pluginet](/da/reference/plugins#gpio) for detaljer.
### EEBUS \{#external-limit-eebus\}
diff --git a/src/content/docs/de/reference/plugins.mdx b/src/content/docs/de/reference/plugins.mdx
index 02d1c72935..b9cf4d13a8 100644
--- a/src/content/docs/de/reference/plugins.mdx
+++ b/src/content/docs/de/reference/plugins.mdx
@@ -3,7 +3,7 @@ title: Plugins
description: "Plugins lesen und schreiben einzelne Werte über Modbus, HTTP, MQTT, Skripte und mehr und sind die Bausteine für benutzerdefinierte Geräte."
tableOfContents:
maxHeadingLevel: 4
-translatedFrom: "3a558965f35f"
+translatedFrom: "6794b715c615"
---
import { Badge } from "@astrojs/starlight/components";
@@ -111,23 +111,37 @@ Es eignet sich besonders für den Raspberry Pi und ähnliche Einplatinencomputer
**Parameter**:
-| Parameter | Typ | Erforderlich | Beschreibung |
-| --------- | ------ | ------------ | ---------------------------------------------- |
-| function | string | ja | Modus: `read` (Eingang) oder `write` (Ausgang) |
-| pin | int | ja | Pin-Nummer (BCM-Nummerierung, z. B. GPIO 17) |
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ------ | ------------ | ------------------------------------------------------------------------------------------ |
+| function | string | ja | Modus: `read` (Eingang) oder `write` (Ausgang) |
+| pin | int | ja | Pin-Nummer (BCM-Nummerierung, z. B. GPIO 17) |
+| activelow | bool | nein | Invertiert die Logik: `true` = LOW, `false` = HIGH. Standard `false` |
+| bias | string | nein | Interner Widerstand: `pull-up`, `pull-down`, `disabled` oder `as-is`. Standard siehe unten |
+| chip | string | nein | GPIO-Chip. Standard `gpiochip0` |
**Funktionsweise**:
- **Lesen** (`function: read`): Liest den Zustand eines GPIO-Pins als booleschen Wert (`true` = HIGH, `false` = LOW)
- **Schreiben** (`function: write`): Setzt einen GPIO-Pin auf HIGH (`true`) oder LOW (`false`)
-Eingänge nutzen immer den internen Pull-up-Widerstand, daher wird ein Schaltkontakt zwischen Pin und Masse (GND) angeschlossen.
+Mit `activelow: true` werden beide Richtungen invertiert: Ein LOW-Pin ergibt `true`, und `true` setzt den Pin auf LOW.
+Ausgänge starten im inaktiven Zustand, d. h. LOW, bzw. HIGH mit `activelow`.
+
+Eingänge nutzen standardmäßig den internen Pull-up-Widerstand, Ausgänge lassen den Widerstand unverändert.
+Setze `bias`, um das zu ändern, z. B. auf `pull-down` für einen Kontakt zwischen Pin und 3,3 V.
+Nutzen mehrere Konfigurationen denselben Pin, dürfen sich ihre `bias`-Werte nicht unterscheiden.
+
+Mit den Standardeinstellungen wird ein Schaltkontakt zwischen Pin und Masse (GND) angeschlossen.
Ein offener Kontakt ergibt `true` (HIGH), ein geschlossener `false` (LOW).
Für ein Begrenzungssignal nutze den Öffnerkontakt (NC) des Relais.
Im Normalbetrieb ist der Kontakt geschlossen und der Pin liefert `false`.
Wird die Begrenzung aktiviert, öffnet der Kontakt und der Pin liefert `true`.
Auch ein Kabelbruch ergibt `true`, sodass die Begrenzung ausfallsicher greift.
+Stellt deine Steuerbox nur einen Schließerkontakt (NO) bereit, schließe ihn genauso an und setze `activelow: true`.
+Der geschlossene Kontakt ergibt dann `true`.
+Diese Verdrahtung ist nicht ausfallsicher: Ein Kabelbruch ergibt `false` und die Begrenzung greift nicht.
+
Die Pin-Nummerierung folgt dem BCM-Schema (Broadcom-Nummern, nicht die physische Pin-Position).
Eine Pinbelegung des Raspberry Pi findest du z. B. auf [pinout.xyz](https://pinout.xyz/).
@@ -139,6 +153,15 @@ function: read
pin: 17 # BCM-Pin-Nummer
```
+**Beispiel Lesen** (Schließerkontakt):
+
+```yaml
+source: gpio
+function: read
+pin: 17 # BCM-Pin-Nummer
+activelow: true # geschlossener Kontakt ergibt true
+```
+
**Beispiel Schreiben**:
```yaml
@@ -148,7 +171,7 @@ pin: 27 # BCM-Pin-Nummer
```
:::note
-Dieses Plugin funktioniert nur auf Linux-Systemen mit Zugriff auf `/dev/gpiomem`.
+Dieses Plugin funktioniert nur auf Linux-Systemen mit Zugriff auf den GPIO-Chip, z. B. `/dev/gpiochip0`.
:::
### Go \{#go\}
diff --git a/src/content/docs/de/user-defined-devices.mdx b/src/content/docs/de/user-defined-devices.mdx
index bc819569d6..0b5eac49b5 100644
--- a/src/content/docs/de/user-defined-devices.mdx
+++ b/src/content/docs/de/user-defined-devices.mdx
@@ -3,7 +3,7 @@ title: Benutzerdefinierte Geräte
description: "Zeigt, wie du Wallboxen, Zähler, Fahrzeuge oder Heizungen ohne eingebaute Vorlage einbindest und Messwerte und Steuerung selbst per HTTP, MQTT oder Modbus definierst."
tableOfContents:
maxHeadingLevel: 4
-translatedFrom: "161eb222a89c"
+translatedFrom: "61b6dc2bb5b9"
---
import { Tabs, TabItem } from "@astrojs/starlight/components";
@@ -612,6 +612,8 @@ limit:
Schließe den Öffnerkontakt (NC) des Relais zwischen Pin und Masse (GND) an.
Ein geöffneter Kontakt oder ein Kabelbruch aktiviert dann die Begrenzung.
+Stellt die Steuerbox nur einen Schließerkontakt (NO) bereit, ergänze `activelow: true`.
+Diese Verdrahtung ist nicht ausfallsicher: Ein Kabelbruch aktiviert die Begrenzung nicht.
Weitere Details zum GPIO-Plugin findest du in der [Plugin-Dokumentation](/de/reference/plugins#gpio).
@@ -707,6 +709,7 @@ s1:
```
Verwende bei GPIO den Öffnerkontakt (NC) jedes Relais, damit ein geöffneter Kontakt oder ein Kabelbruch als aktiv erkannt wird.
+Für Schließerkontakte (NO) ergänze bei jedem Signal `activelow: true`. Ein Kabelbruch wird dann nicht mehr erkannt.
Details findest du beim [GPIO-Plugin](/de/reference/plugins#gpio).
### EEBUS \{#external-limit-eebus\}
diff --git a/src/content/docs/fr/reference/plugins.mdx b/src/content/docs/fr/reference/plugins.mdx
index 3057961a39..873b3e4b66 100644
--- a/src/content/docs/fr/reference/plugins.mdx
+++ b/src/content/docs/fr/reference/plugins.mdx
@@ -3,7 +3,7 @@ title: Plugins
description: "Les plugins lisent et écrivent des valeurs individuelles via Modbus, HTTP, MQTT ou des scripts et servent de briques de base aux appareils personnalisés."
tableOfContents:
maxHeadingLevel: 4
-translatedFrom: "3a558965f35f"
+translatedFrom: "6794b715c615"
---
import { Badge } from "@astrojs/starlight/components";
@@ -111,23 +111,37 @@ Il convient particulièrement au Raspberry Pi et aux ordinateurs monocartes simi
**Paramètres** :
-| Paramètre | Type | Obligatoire | Description |
-| --------- | ------ | ----------- | --------------------------------------------------- |
-| function | string | oui | Mode : `read` (entrée) ou `write` (sortie) |
-| pin | int | oui | Numéro de broche (numérotation BCM, p. ex. GPIO 17) |
+| Paramètre | Type | Obligatoire | Description |
+| --------- | ------ | ----------- | ----------------------------------------------------------------------------------------------- |
+| function | string | oui | Mode : `read` (entrée) ou `write` (sortie) |
+| pin | int | oui | Numéro de broche (numérotation BCM, p. ex. GPIO 17) |
+| activelow | bool | non | Inverse la logique : `true` = LOW, `false` = HIGH. Par défaut `false` |
+| bias | string | non | Résistance interne : `pull-up`, `pull-down`, `disabled` ou `as-is`. Par défaut, voir ci-dessous |
+| chip | string | non | Puce GPIO. Par défaut `gpiochip0` |
**Fonctionnement** :
- **Lecture** (`function: read`) : lit l’état d’une broche GPIO sous forme de valeur booléenne (`true` = HIGH, `false` = LOW)
- **Écriture** (`function: write`) : met une broche GPIO à HIGH (`true`) ou LOW (`false`)
-Les entrées utilisent toujours la résistance de rappel interne (pull-up), un contact de commutation se câble donc entre la broche et la masse (GND).
+Avec `activelow: true`, les deux sens sont inversés : une broche à LOW est lue comme `true`, et `true` met la broche à LOW.
+Les sorties démarrent à l’état inactif, c.-à-d. LOW, ou HIGH avec `activelow`.
+
+Les entrées utilisent par défaut la résistance de rappel interne (pull-up), les sorties laissent la résistance inchangée.
+Définissez `bias` pour modifier ce comportement, p. ex. `pull-down` pour un contact câblé entre la broche et 3,3 V.
+Si plusieurs configurations utilisent la même broche, leurs valeurs `bias` ne doivent pas différer.
+
+Avec les paramètres par défaut, un contact de commutation se câble entre la broche et la masse (GND).
Un contact ouvert est lu comme `true` (HIGH), un contact fermé comme `false` (LOW).
Pour un signal de limite, utilisez le contact normalement fermé (NF) du relais.
En fonctionnement normal, le contact est fermé et la broche est lue comme `false`.
Lorsque la limite est activée, le contact s’ouvre et la broche est lue comme `true`.
Un câble coupé est également lu comme `true`, la limite s’applique donc par sécurité.
+Si votre boîtier de commande ne fournit qu’un contact normalement ouvert (NO), câblez-le de la même manière et définissez `activelow: true`.
+Le contact fermé est alors lu comme `true`.
+Ce câblage n’est pas sûr en cas de défaut : un câble coupé est lu comme `false` et la limite n’est pas appliquée.
+
La numérotation des broches suit le schéma BCM (numéros Broadcom, pas la position physique de la broche).
Pour le brochage d’un Raspberry Pi, voir p. ex. [pinout.xyz](https://pinout.xyz/).
@@ -139,6 +153,15 @@ function: read
pin: 17 # numéro de broche BCM
```
+**Exemple de lecture** (contact normalement ouvert) :
+
+```yaml
+source: gpio
+function: read
+pin: 17 # numéro de broche BCM
+activelow: true # un contact fermé est lu comme true
+```
+
**Exemple d’écriture** :
```yaml
@@ -148,7 +171,7 @@ pin: 27 # numéro de broche BCM
```
:::note
-Ce plugin ne fonctionne que sur les systèmes Linux ayant accès à `/dev/gpiomem`.
+Ce plugin ne fonctionne que sur les systèmes Linux ayant accès à la puce GPIO, p. ex. `/dev/gpiochip0`.
:::
### Go \{#go\}
diff --git a/src/content/docs/fr/user-defined-devices.mdx b/src/content/docs/fr/user-defined-devices.mdx
index b2133fccfd..30c1cba888 100644
--- a/src/content/docs/fr/user-defined-devices.mdx
+++ b/src/content/docs/fr/user-defined-devices.mdx
@@ -3,7 +3,7 @@ title: Appareils personnalisés
description: "Intégrez un chargeur, un compteur, un véhicule ou un chauffage sans modèle intégré en définissant vous-même ses valeurs et commandes via HTTP, MQTT ou Modbus."
tableOfContents:
maxHeadingLevel: 4
-translatedFrom: "161eb222a89c"
+translatedFrom: "61b6dc2bb5b9"
---
import { Tabs, TabItem } from "@astrojs/starlight/components";
@@ -612,6 +612,8 @@ limit:
Câblez le contact normalement fermé (NF) du relais entre la broche et la masse (GND).
Un contact ouvert ou un câble coupé active alors la limite.
+Si le boîtier de commande ne fournit qu’un contact normalement ouvert (NO), ajoutez `activelow: true`.
+Ce câblage n’est pas sûr en cas de défaut : un câble coupé n’active pas la limite.
Pour plus de détails sur le plugin GPIO, consultez la [documentation des plugins](/fr/reference/plugins#gpio).
@@ -707,6 +709,7 @@ s1:
```
Avec GPIO, utilisez le contact normalement fermé (NF) de chaque relais, afin qu’un contact ouvert ou un câble coupé soit lu comme actif.
+Pour des contacts normalement ouverts (NO), ajoutez `activelow: true` à chaque signal. Un câble coupé n’est alors plus détecté.
Consultez le [plugin GPIO](/fr/reference/plugins#gpio) pour plus de détails.
### EEBUS \{#external-limit-eebus\}
diff --git a/src/content/docs/it/reference/plugins.mdx b/src/content/docs/it/reference/plugins.mdx
index fb0526e054..64d8e1e0b0 100644
--- a/src/content/docs/it/reference/plugins.mdx
+++ b/src/content/docs/it/reference/plugins.mdx
@@ -3,7 +3,7 @@ title: Plugin
description: "I plugin leggono e scrivono singoli valori tramite Modbus, HTTP, MQTT, script e altre sorgenti e sono i mattoni dei dispositivi definiti dall’utente."
tableOfContents:
maxHeadingLevel: 4
-translatedFrom: "3a558965f35f"
+translatedFrom: "6794b715c615"
---
import { Badge } from "@astrojs/starlight/components";
@@ -111,23 +111,37 @@ Il plugin `gpio` permette l’accesso diretto ai pin GPIO (General Purpose Input
**Parametri**:
-| Parametro | Tipo | Obbligatorio | Descrizione |
-| --------- | ------ | ------------ | ------------------------------------------------ |
-| function | string | sì | Modalità: `read` (ingresso) o `write` (uscita) |
-| pin | int | sì | Numero del pin (numerazione BCM, ad es. GPIO 17) |
+| Parametro | Tipo | Obbligatorio | Descrizione |
+| --------- | ------ | ------------ | ----------------------------------------------------------------------------------------- |
+| function | string | sì | Modalità: `read` (ingresso) o `write` (uscita) |
+| pin | int | sì | Numero del pin (numerazione BCM, ad es. GPIO 17) |
+| activelow | bool | no | Inverte la logica: `true` = LOW, `false` = HIGH. Predefinito `false` |
+| bias | string | no | Resistenza interna: `pull-up`, `pull-down`, `disabled` o `as-is`. Predefinito: vedi sotto |
+| chip | string | no | Chip GPIO. Predefinito `gpiochip0` |
**Funzionamento**:
- **Lettura** (`function: read`): legge lo stato di un pin GPIO come valore booleano (`true` = HIGH, `false` = LOW)
- **Scrittura** (`function: write`): imposta un pin GPIO su HIGH (`true`) o LOW (`false`)
-Gli ingressi usano sempre la resistenza di pull-up interna, quindi un contatto di commutazione si collega tra il pin e la massa (GND).
+Con `activelow: true` entrambe le direzioni sono invertite: un pin LOW viene letto come `true` e `true` imposta il pin su LOW.
+Le uscite partono nello stato inattivo, cioè LOW, oppure HIGH con `activelow`.
+
+Per impostazione predefinita gli ingressi usano la resistenza di pull-up interna, mentre le uscite lasciano la resistenza invariata.
+Imposta `bias` per cambiare questo comportamento, ad es. `pull-down` per un contatto collegato tra il pin e 3,3 V.
+Se più configurazioni usano lo stesso pin, i loro valori di `bias` non devono essere diversi.
+
+Con le impostazioni predefinite, un contatto di commutazione si collega tra il pin e la massa (GND).
Un contatto aperto viene letto come `true` (HIGH), un contatto chiuso come `false` (LOW).
Per un segnale di limitazione usa il contatto normalmente chiuso (NC) del relè.
Durante il normale funzionamento il contatto è chiuso e il pin viene letto come `false`.
Quando la limitazione viene attivata, il contatto si apre e il pin viene letto come `true`.
Anche un cavo interrotto viene letto come `true`, quindi la limitazione interviene come misura di sicurezza (fail-safe).
+Se la tua centralina di controllo fornisce solo un contatto normalmente aperto (NO), collegalo allo stesso modo e imposta `activelow: true`.
+Il contatto chiuso viene quindi letto come `true`.
+Questo collegamento non è fail-safe: un cavo interrotto viene letto come `false` e la limitazione non viene applicata.
+
La numerazione dei pin segue lo schema BCM (numeri Broadcom, non la posizione fisica del pin).
Per la piedinatura del Raspberry Pi vedi ad es. [pinout.xyz](https://pinout.xyz/).
@@ -139,6 +153,15 @@ function: read
pin: 17 # numero di pin BCM
```
+**Esempio di lettura** (contatto normalmente aperto):
+
+```yaml
+source: gpio
+function: read
+pin: 17 # numero di pin BCM
+activelow: true # il contatto chiuso viene letto come true
+```
+
**Esempio di scrittura**:
```yaml
@@ -148,7 +171,7 @@ pin: 27 # numero di pin BCM
```
:::note
-Questo plugin funziona solo su sistemi Linux con accesso a `/dev/gpiomem`.
+Questo plugin funziona solo su sistemi Linux con accesso al chip GPIO, ad es. `/dev/gpiochip0`.
:::
### Go \{#go\}
diff --git a/src/content/docs/it/user-defined-devices.mdx b/src/content/docs/it/user-defined-devices.mdx
index 6f93e97bce..bf47aff102 100644
--- a/src/content/docs/it/user-defined-devices.mdx
+++ b/src/content/docs/it/user-defined-devices.mdx
@@ -3,7 +3,7 @@ title: Dispositivi definiti dall’utente
description: "Mostra come integrare un caricabatterie, un contatore, un veicolo o un riscaldatore senza template integrato, definendo letture e comandi via HTTP, MQTT o Modbus."
tableOfContents:
maxHeadingLevel: 4
-translatedFrom: "161eb222a89c"
+translatedFrom: "61b6dc2bb5b9"
---
import { Tabs, TabItem } from "@astrojs/starlight/components";
@@ -612,6 +612,8 @@ limit:
Collega il contatto normalmente chiuso (NC) del relè tra il pin e la massa (GND).
Un contatto aperto o un cavo interrotto attivano quindi la limitazione.
+Se la centralina di controllo fornisce solo un contatto normalmente aperto (NO), aggiungi `activelow: true`.
+Questo collegamento non è fail-safe: un cavo interrotto non attiva la limitazione.
Per maggiori dettagli sul plugin GPIO, consulta la [documentazione dei plugin](/it/reference/plugins#gpio).
@@ -707,6 +709,7 @@ s1:
```
Con GPIO usa il contatto normalmente chiuso (NC) di ogni relè, così un contatto aperto o un cavo interrotto viene letto come attivo.
+Per i contatti normalmente aperti (NO), aggiungi `activelow: true` a ogni segnale. Un cavo interrotto non viene quindi più rilevato.
Per i dettagli vedi il [plugin GPIO](/it/reference/plugins#gpio).
### EEBUS \{#external-limit-eebus\}
diff --git a/src/content/docs/nl/reference/plugins.mdx b/src/content/docs/nl/reference/plugins.mdx
index 2ddcd4157e..f2c89c3bac 100644
--- a/src/content/docs/nl/reference/plugins.mdx
+++ b/src/content/docs/nl/reference/plugins.mdx
@@ -3,7 +3,7 @@ title: Plugins
description: "Plugins lezen en schrijven afzonderlijke waarden via Modbus, HTTP, MQTT, scripts en meer, en vormen de bouwstenen van gebruikersgedefinieerde apparaten."
tableOfContents:
maxHeadingLevel: 4
-translatedFrom: "3a558965f35f"
+translatedFrom: "6794b715c615"
---
import { Badge } from "@astrojs/starlight/components";
@@ -111,23 +111,37 @@ Hij is vooral geschikt voor de Raspberry Pi en vergelijkbare singleboardcomputer
**Parameters**:
-| Parameter | Type | Verplicht | Beschrijving |
-| --------- | ------ | --------- | ------------------------------------------- |
-| function | string | ja | Modus: `read` (invoer) of `write` (uitvoer) |
-| pin | int | ja | Pinnummer (BCM-nummering, bijv. GPIO 17) |
+| Parameter | Type | Verplicht | Beschrijving |
+| --------- | ------ | --------- | ----------------------------------------------------------------------------------------- |
+| function | string | ja | Modus: `read` (invoer) of `write` (uitvoer) |
+| pin | int | ja | Pinnummer (BCM-nummering, bijv. GPIO 17) |
+| activelow | bool | nee | Keert de logica om: `true` = LOW, `false` = HIGH. Standaard `false` |
+| bias | string | nee | Interne weerstand: `pull-up`, `pull-down`, `disabled` of `as-is`. Standaard zie hieronder |
+| chip | string | nee | GPIO-chip. Standaard `gpiochip0` |
**Werking**:
- **Lezen** (`function: read`): Leest de toestand van een GPIO-pin als booleaanse waarde (`true` = HIGH, `false` = LOW)
- **Schrijven** (`function: write`): Zet een GPIO-pin op HIGH (`true`) of LOW (`false`)
-Ingangen gebruiken altijd de interne pull-upweerstand, dus een schakelcontact wordt tussen de pin en massa (GND) aangesloten.
+Met `activelow: true` worden beide richtingen omgekeerd: een LOW-pin wordt gelezen als `true`, en `true` zet de pin op LOW.
+Uitgangen starten in de inactieve toestand, d.w.z. LOW, of HIGH met `activelow`.
+
+Ingangen gebruiken standaard de interne pull-upweerstand, uitgangen laten de weerstand ongewijzigd.
+Stel `bias` in om dit te wijzigen, bijv. `pull-down` voor een contact dat tussen de pin en 3,3 V is aangesloten.
+Als meerdere configuraties dezelfde pin gebruiken, mogen hun `bias`-waarden niet verschillen.
+
+Met de standaardinstellingen wordt een schakelcontact tussen de pin en massa (GND) aangesloten.
Een open contact wordt gelezen als `true` (HIGH), een gesloten contact als `false` (LOW).
Gebruik voor een limietsignaal het normaal gesloten (NC) contact van het relais.
Tijdens normaal bedrijf is het contact gesloten en leest de pin `false`.
Wanneer de limiet wordt geactiveerd, gaat het contact open en leest de pin `true`.
Bij een kabelbreuk wordt ook `true` gelezen, zodat de limiet als fail-safe ingrijpt.
+Als uw stuurbox alleen een normaal open (NO) contact heeft, sluit u het op dezelfde manier aan en stelt u `activelow: true` in.
+Het gesloten contact wordt dan gelezen als `true`.
+Deze bedrading is niet fail-safe: bij een kabelbreuk wordt `false` gelezen en wordt de limiet niet toegepast.
+
De pinnummering volgt het BCM-schema (Broadcom-nummers, niet de fysieke positie van de pin).
Een pinoverzicht van de Raspberry Pi vindt u bijv. op [pinout.xyz](https://pinout.xyz/).
@@ -139,6 +153,15 @@ function: read
pin: 17 # BCM-pinnummer
```
+**Leesvoorbeeld** (normaal open contact):
+
+```yaml
+source: gpio
+function: read
+pin: 17 # BCM-pinnummer
+activelow: true # gesloten contact wordt gelezen als true
+```
+
**Schrijfvoorbeeld**:
```yaml
@@ -148,7 +171,7 @@ pin: 27 # BCM-pinnummer
```
:::note
-Deze plugin werkt alleen op Linux-systemen met toegang tot `/dev/gpiomem`.
+Deze plugin werkt alleen op Linux-systemen met toegang tot de GPIO-chip, bijv. `/dev/gpiochip0`.
:::
### Go \{#go\}
@@ -599,8 +622,7 @@ De plugin ondersteunt de basisbewerkingen optellen (add), vermenigvuldigen (mul)
Met `scale: -1` op een van de waarden kan eenvoudig worden afgetrokken, met `scale: 0.001` gedeeld, bijv. voor de omrekening van Wh naar kWh.
-Met `sign:` wordt elk positief getal +1, elk negatief getal -1 en blijft 0 gelijk.
-In combinatie met `mul` kan zo het teken op andere waarden worden overgedragen.
+Met `sign:` (elk positief getal wordt +1, elk negatief getal -1, 0 blijft 0) kan het teken in combinatie met `mul` op andere waarden worden overgedragen.
Zo kan bijv. bij meters de “richting” van het vermogen (teruglevering of netafname) op de gemeten stromen worden overgedragen.
Met `abs:` wordt de absolute waarde van een getal berekend.
diff --git a/src/content/docs/nl/user-defined-devices.mdx b/src/content/docs/nl/user-defined-devices.mdx
index 3acee4f73b..dcaf2d4551 100644
--- a/src/content/docs/nl/user-defined-devices.mdx
+++ b/src/content/docs/nl/user-defined-devices.mdx
@@ -3,7 +3,7 @@ title: Gebruikersgedefinieerde apparaten
description: "Toont hoe u een lader, meter, voertuig of verwarmingstoestel zonder ingebouwde template koppelt door uitlezen en aansturen zelf via HTTP, MQTT of Modbus in te stellen."
tableOfContents:
maxHeadingLevel: 4
-translatedFrom: "161eb222a89c"
+translatedFrom: "61b6dc2bb5b9"
---
import { Tabs, TabItem } from "@astrojs/starlight/components";
@@ -612,6 +612,8 @@ limit:
Sluit het rustcontact (NC) van het relais aan tussen de pin en massa (GND).
Een open contact of een gebroken kabel activeert dan de limiet.
+Als de stuurbox alleen een werkcontact (NO) heeft, voegt u `activelow: true` toe.
+Deze bedrading is niet fail-safe: een gebroken kabel activeert de limiet niet.
Meer details over de GPIO-plugin vindt u in de [plugindocumentatie](/nl/reference/plugins#gpio).
@@ -707,6 +709,7 @@ s1:
```
Gebruik bij GPIO het rustcontact (NC) van elk relais, zodat een open contact of een gebroken kabel als actief wordt gelezen.
+Voeg bij werkcontacten (NO) aan elk signaal `activelow: true` toe. Een gebroken kabel wordt dan niet meer gedetecteerd.
Zie de [GPIO-plugin](/nl/reference/plugins#gpio) voor details.
### EEBUS \{#external-limit-eebus\}