diff --git a/src/content/docs/cs/reference/plugins.mdx b/src/content/docs/cs/reference/plugins.mdx index e2ae7b886..770ed1df9 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 4a3f12b57..698d96cd5 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 9383f07e7..c354313ed 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 e3e9e99e3..02c09b89c 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 02d1c7293..b9cf4d13a 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 bc819569d..0b5eac49b 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/en/reference/plugins.mdx b/src/content/docs/en/reference/plugins.mdx index 3a558965f..6794b715c 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 161eb222a..61b6dc2bb 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\} diff --git a/src/content/docs/fr/reference/plugins.mdx b/src/content/docs/fr/reference/plugins.mdx index 3057961a3..873b3e4b6 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 b2133fccf..30c1cba88 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 fb0526e05..64d8e1e0b 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 6f93e97bc..bf47aff10 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 2ddcd4157..f2c89c3ba 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 3acee4f73..dcaf2d455 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\}