Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 30 additions & 7 deletions src/content/docs/cs/reference/plugins.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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";
Expand Down Expand Up @@ -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/).

Expand All @@ -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
Expand All @@ -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 <Badge text="čtení" variant="tip" size="small" /> <Badge text="zápis" variant="caution" size="small" /> \{#go\}
Expand Down
5 changes: 4 additions & 1 deletion src/content/docs/cs/user-defined-devices.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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";
Expand Down Expand Up @@ -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).

</TabItem>
Expand Down Expand Up @@ -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\}
Expand Down
37 changes: 30 additions & 7 deletions src/content/docs/da/reference/plugins.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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";
Expand Down Expand Up @@ -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/).

Expand All @@ -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
Expand All @@ -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 <Badge text="læsning" variant="tip" size="small" /> <Badge text="skrivning" variant="caution" size="small" /> \{#go\}
Expand Down
5 changes: 4 additions & 1 deletion src/content/docs/da/user-defined-devices.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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";
Expand Down Expand Up @@ -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).

</TabItem>
Expand Down Expand Up @@ -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\}
Expand Down
37 changes: 30 additions & 7 deletions src/content/docs/de/reference/plugins.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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";
Expand Down Expand Up @@ -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/).

Expand All @@ -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
Expand All @@ -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 <Badge text="lesen" variant="tip" size="small" /> <Badge text="schreiben" variant="caution" size="small" /> \{#go\}
Expand Down
5 changes: 4 additions & 1 deletion src/content/docs/de/user-defined-devices.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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";
Expand Down Expand Up @@ -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).

</TabItem>
Expand Down Expand Up @@ -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\}
Expand Down
35 changes: 29 additions & 6 deletions src/content/docs/en/reference/plugins.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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/).

Expand All @@ -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
Expand All @@ -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 <Badge text="read" variant="tip" size="small" /> <Badge text="write" variant="caution" size="small" /> \{#go\}
Expand Down
Loading
Loading