IO type DALI

JSON nastavení pro DALI IO v Controller configu

DALI IO – JSON nastavení (Controller config)

Tato kapitola popisuje všechna JSON pole podporovaná DALI IO v konfiguraci Controlleru.

Kde se nastavení definuje

• Vložte položku DALI do sekce io configu kontroleru. Příklad se štítkem DALI (max. 5 znaků):

{
  "controller": {
    "name": "SC_00",
    "led": 19,
    "!button": 22
  },
  "io": {
    "DALI": {
      "type": "DALI",
      "variant": "DT6",
      "order": "W",
      "tx": 23,
      "!rx": 18
    }
  },
  "segments": {
    "DIMMA": {
      "io": "DALI"
    }
  }
}

Povinná / běžná pole

• type: musí být "DALI".

• tx / pins:

  • "tx" určuje DALI TX GPIO (např. 23). Alternativně lze použít "pins": [..] s order pro mapování pinů na kanály; pro DALI se používá primárně TX.

  • Volitelný en pin lze použít jako enable.

  • Modifikátory pinů: ! inverze, + pull‑up, - pull‑down. Např. "!rx": 18 znamená RX na GPIO 18 s inverzí logiky.

• rx (volitelné):

  • "rx" (nebo "!rx" pro inverzi) pro příjem/monitoring (komisionování/diagnostika).

• order:

  • Určuje rozložení kanálů (parsuje utils::stringToPixelOrder()).

    • W (jeden DALI kanál na pixel)

    • WW (dva DALI kanály na pixel)

    • RGB (tři DALI kanály na pixel)

    • RGBW (čtyři DALI kanály na pixel)

  • Není‑li zadáno, výchozí je W.

DALI‑specifická pole

• variant:

  • Režimy zařízení: "DT6", "DT8_XY", "DT8_RGBWAF", "DT8_TC".

  • Servisní režimy: "MONITOR", "COMMISSION", "DECOMMISSION" (spouštějí se při bootu pro diagnostiku/adresaci).

  • Pozn.: DT6_ONOFF je rezervováno, není implementováno.

  • Není‑li zadáno, výchozí je DT6.

• mapping (pole čísel):

  • Mapuje kanály na krátké DALI adresy (0–63); význam závisí na order:

    • W: jedna hodnota na pixel.

    • WW: dvě hodnoty na pixel (např. warm → první, cool → druhá).

    • RGBW: čtyři hodnoty na pixel (R, G, B, W).

  • Záporné číslo zopakuje předchozí hodnotu abs(n)‑krát (např. [5,-3] → [5,5,5,5]).

  • Délka musí být dělitelná počtem kanálů dle order.

  • Používejte krátké adresy od 0 směrem nahoru; vynechávky jsou povoleny. Pořadí v poli sleduje rozložení pixelů/kanálů (nemusí být numericky seřazeno).

  • Pokud mapping chybí, port vysílá broadcast příkazy podle prvního pixelu vykresleného na tento IO.

• poweronlevel: 0–254. Úroveň při zapnutí. Hodnoty >254 se oříznou na 254 (255 = MASK/keep).

  • Poznámka: kombinace poweronlevel: 0 a systemfailurelevel: 0 je vhodná pro fázově řízená světla, která mají tendenci blikat při zapnutí/vypnutí sítě.

• systemfailurelevel: 0–254. Úroveň při systémové chybě. Hodnoty >254 se oříznou na 254.

  • Viz poznámka výše – nastavení 0 pomáhá eliminovat nechtěné blikání při změnách napájení.

• minlevel, maxlevel: 0–254. Limity úrovně aplikované při startu (ořez na 254).

• faderate: rychlost kroků/s, mapuje se na DALI index (0–15) dle tabulky.

• fadetime: doba v ms, mapuje se na DALI index (0–15) dle tabulky.

• mincolortemp, maxcolortemp (DT8_TC): v Kelvinech, rozsah 1000–10000 K; maxcolortemp ≥ mincolortemp.

Poznámky k chování

• DT6 (klasické řízení krátkých adres): mapping určuje, kterou krátkou adresu kanál ovládá. Jsou‑li všechny kanály stejné, firmware zefektivní vysílání broadcastem.

• DT8 režimy (DT8_RGBWAF, DT8_TC): pracují pomocí DT8 příkazů (bez mapping na adresy); první pixel se převádí na DT8 příkazy a vysílá se (aktuálně) broadcastem.

Příklady

DT6 – W (invertovaný RX, vzestupné adresy):

{
  "controller": {
    "name": "SC_00",
    "led": 19,
    "!button": 22
  },
  "temperature": {
    "type": "NTC",
    "pin": 35,
    "resistance": 47000
  },
  "io": {
    "DALI": {
      "type": "DALI",
      "variant": "DT6",
      "mapping": [0, 6, 1, 4, 2, 3, 5],
      "order": "W",
      "tx": 23,
      "!rx": 18,
      "fadetime": 700,
      "faderate": 358,
      "poweronlevel": 0,
      "systemfailurelevel": 254,
      "minlevel": 0,
      "maxlevel": 254
    }
  },
  "segments": {
    "DIMMA": {
      "io": "DALI",
      "size": 7
    }
  }
}

DT6 – RGBW:

{
  "controller": {
    "name": "SC_00",
    "led": 19,
    "!button": 22
  },
  "io": {
    "DALI": {
      "type": "DALI",
      "variant": "DT6",
      "order": "RGBW",
      "tx": 23,
      "!rx": 18,
      "mapping": [0, 1, 2, 3, 4, 5, 6, 7],
      "fadetime": 700,
      "faderate": 358
    }
  }
}

DT6 – WW:

{
  "controller": {
    "name": "SC_00",
    "led": 19,
    "!button": 22
  },
  "io": {
    "DALI": {
      "type": "DALI",
      "variant": "DT6",
      "order": "WW",
      "tx": 23,
      "!rx": 18,
      "mapping": [0, 1, 2, 3, 4, 5],
      "fadetime": 700,
      "faderate": 358
    }
  }
}

DT8 Tunable White (broadcast) s rozsahem teplot:

{
  "controller": {
    "name": "SC_00",
    "led": 19,
    "!button": 22
  },
  "io": {
    "DALI": {
      "type": "DALI",
      "variant": "DT8_TC",
      "tx": 23,
      "!rx": 18,
      "mincolortemp": 2700,
      "maxcolortemp": 6500,
      "fadetime": 700,
      "faderate": 358
    }
  }
}

Komisionování (spustí komisionování při bootu):

{
  "controller": {
    "name": "SC_00",
    "led": 19,
    "!button": 22
  },
  "io": {
    "DALI": {
      "type": "DALI",
      "variant": "COMMISSION",
      "tx": 23,
      "!rx": 18
    }
  }
}

Limity

• DALI port: až 24 logických pixelů.

• Úrovně se ořezávají na 254 (255 = „ponech aktuální“ v DALI).

• Délka štítku IO: max. 5 znaků.