Controller Config

Kompletní mapa Controller configu pro firmware 0.12.11, včetně vazby na Studio a WASM schema.

Controller config je JSON dokument, který firmware načte při startu Controlleru. Tato sekce spojuje dříve oddělené návody do jedné verzi odpovídající mapy.

Co je kompletně pokryté

Doporučený tvar

{
  "controller": {
    "name": "MAIN",
    "brightness": 255,
    "power": 180,
    "fps": 60,
    "ups": 60,
    "!btn+": 0,
    "led": 2
  },
  "wifi": { "channel": 1 },
  "io": {
    "PIXEL": {
      "type": "NEOPIXEL",
      "variant": "WS2812B",
      "order": "GRB",
      "pin": 16,
      "brightness": 255,
      "power": 120
    },
    "INPUT": {
      "type": "GPI",
      "variant": "BUTTON",
      "!pin+": 17,
      "debounce": 50
    }
  },
  "segments": {
    "MAIN": { "io": "PIXEL", "size": 120 }
  },
  "plugins": [
    {
      "type": "PowerManage",
      "en": 25,
      "!btn+": 26,
      "holdtime": 1000
    }
  ]
}

io zapisujte přednostně jako objektovou mapu, kde klíč je 1–5 znakový label. Firmware 0.12.11 ještě čte staré tvary ports, io jako pole a sensors, ale nové configy na nich nestavte. ports a sensors budou ve firmware 0.13 odstraněné.

GPIO dekorátory

GPIO keyword lze dekorovat znaky ! (invertovat), + (interní pull-up) a - (interní pull-down). Parser je odstraňuje bez ohledu na pozici, takže například !pin+, p!i+n a -pin! míří na stejný základ pin. Pro čitelnost používejte ustálený tvar jako !pin+. Prefix _ musí být prvním znakem a celý GPIO keyword vypne, aniž by se z JSON ztratil skutečný pin nebo dekorátory: například _led!. Pro deaktivované tlačítko použijte _btn; pouze holý deprecated button je nadále platný, zatímco !button, button! a jiné dekorované tvary nahraďte stejnými dekorátory na btn. Kvůli bezpečnému upgradu existujících instalací je firmware 0.12.11 ještě načte a zaloguje varování, ale schema je záměrně nenašeptává a Studio je označí jako neznámý keyword. Samostatný _btn nepřebije vedle něj uvedený legacy button; při deaktivaci proto legacy položku odstraňte nebo přejmenujte na _btn.

Prefix _ se vztahuje na GPIO keyword, ne na I/O label. Například label _PIX je stále aktivní label. Celé I/O se vypíná přes "type": "NC"; firmware pak zachová i jeho původní metadata, ale nevytvoří žádné runtime I/O.

Co do Controller configu nepatří

Network pole signature a key nejsou Controller config. Stejně tak sem nepatří JSON vstupy WASM connection parseru. Studio je proto v Controller Config Editoru označí jako neznámé keywords, ale zápis syntakticky platného JSON objektu zůstane dostupný.

Generováno z verzovaného kontraktu Spectoda/firmware pro FW 0.12.11. Ručně neupravujte tabulky odděleně od firmware kontraktu.