Controller config

Controller config is the JSON document loaded by firmware when a Controller starts. This section joins the previously separate guides into one version-matched map.

Config is versioned

Use the reference matching the WASM/firmware version selected for the Network. Studio loads the schema from the active WASM. If the contract is missing or unsupported, Studio marks the config as unvalidated, but a syntactically valid JSON object can still be written. Schema and semantic mismatches are warnings, not write blockers.

Complete reference

• Every top-level section and keyword in FW 0.12.11
• Every available I/O type, variant and field
• WASM schema, Studio validation and autocomplete
• Detailed Ethernet example
• Detailed DALI example

Recommended shape

{
  "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
    }
  ]
}

Prefer the object-map form of io, where each key is a 1–5 character label. Firmware 0.12.11 still reads legacy ports, array-form io and sensors, but new configs should not be based on them. ports and sensors are scheduled for removal in firmware 0.13.

GPIO decorators

GPIO keywords may use ! (invert), + (internal pull-up) and - (internal pull-down). The parser removes decorators at any position, so !pin+, p!i+n and -pin! all resolve to pin. Use a conventional form such as !pin+ for readability. A leading _ must be the first character and disables the whole GPIO member while preserving its real pin and decorators in JSON, for example _led!. Use _btn for a disabled button. Only bare deprecated button remains valid; replace !button, button! and other decorated forms with the same decorators on btn. For safe upgrades of existing installations, firmware 0.12.11 still reads them and logs a warning, but the schema deliberately does not suggest them and Studio marks them as unknown keywords. A separate _btn does not override a legacy button member next to it; remove the legacy member or rename it to _btn when disabling the button.

The _ prefix applies to a GPIO member, not to an I/O label. A label such as _PIX is still active. Disable a complete I/O with "type": "NC"; firmware then preserves its former metadata but creates no runtime I/O.

What is not Controller config

Network fields signature and key are not Controller config. JSON inputs to the WASM connection parser are also separate. Studio therefore marks them as unknown-keyword warnings in the Controller Config Editor without blocking a syntactically valid JSON object from being written.

Generated from the versioned Spectoda/firmware contract for FW 0.12.11. Do not maintain these tables separately from the firmware contract.