{
  "openapi": "3.1.0",
  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
  "info": {
    "title": "PoE RGB WCH HTTP API",
    "version": "1.0.0",
    "description": "Authoritative v1 board contract over the existing controller. Board API uses HTTP port 80 and relative /api/v1 paths. Board requests: <=1024 bytes total, <=128 JSON body bytes except MQTT <=768; complete unique Content-Length, exact application/json, no transfer/content coding, no pipelining. Host and any Origin must name the device IP or its current own .local name at HTTP port 80. No authentication/TLS is provided. Temperature limit and channel layout persist through the OFF-only device journal; other settings remain in RAM. GET reads never renew board control intent or leases. Do not automatically retry PUT/POST after an unknown outcome. See http-api-v1.md for state, safety and compatibility details."
  },
  "servers": [
    {
      "url": "/",
      "description": "Current board origin."
    }
  ],
  "security": [],
  "tags": [
    {
      "name": "Board API",
      "description": "WCH board; optional MQTT/BLE/Art-Net/sACN can report unavailable. The native HTTP API is always enabled."
    }
  ],
  "paths": {
    "/api/v1/status": {
      "get": {
        "operationId": "getDeviceStatus",
        "summary": "Read the complete board snapshot",
        "tags": [
          "Board API"
        ],
        "description": "Read only. Does not extend any lease, acknowledge faults or create/refresh a light intent. Background control can progress while this immutable snapshot is serialized.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/DeviceStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        }
      }
    },
    "/api/v1/diagnostics": {
      "get": {
        "operationId": "getDiagnostics",
        "summary": "Read runtime diagnostics",
        "tags": [
          "Board API"
        ],
        "description": "Read only. Never changes outputs, leases, faults or settings; replaces the former UDP text diagnostics.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/DiagnosticsResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        }
      }
    },
    "/api/v1/firmware": {
      "get": {
        "operationId": "getFirmware",
        "summary": "Read firmware identity and committed image",
        "tags": [
          "Board API"
        ],
        "description": "Read only. Firmware is installed only by the recovery loader (POST /api/v1/recovery); the app rejects every direct image write.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/FirmwareStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        }
      }
    },
    "/api/v1/power": {
      "get": {
        "operationId": "getPower",
        "summary": "Read power settings",
        "tags": [
          "Board API"
        ],
        "description": "Read only; does not extend a lease or create control intent. LED-output user target. max_led_mw in the response is the largest currently accepted user target; the same key in PUT supplies the new stored target. Dynamic board ceiling <=30000 mW. PUT does not create an ON or ACK command; 0 deletes an active board scene intent.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/PowerStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        }
      },
      "put": {
        "operationId": "putPower",
        "summary": "Set power settings",
        "tags": [
          "Board API"
        ],
        "description": "LED-output user target. max_led_mw in the response is the largest currently accepted user target; the same key in PUT supplies the new stored target. Dynamic board ceiling <=30000 mW. A target above the Type-2 compliance budget (compliance_led_budget_mw) selects PoE overdrive; one at or below it ends overdrive. There is no separate overdrive setting. Overdrive needs confirmed Type 2 and healthy admission, otherwise 400. An efficiency change never switches overdrive on. PUT does not create an ON or ACK command; 0 deletes an active board scene intent.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/PowerStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        },
        "requestBody": {
          "required": true,
          "description": "Exactly the documented JSON object; no duplicate or unknown keys. At most 128 body bytes on board, including whitespace. Content-Length is required; complete board request including headers is at most 1024 bytes.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PowerRequest"
              },
              "example": {
                "max_led_mw": 5000
              }
            }
          }
        },
        "x-max-body-bytes": 128
      }
    },
    "/api/v1/temperature": {
      "get": {
        "operationId": "getTemperature",
        "summary": "Read temperature settings",
        "tags": [
          "Board API"
        ],
        "description": "Read only; does not extend a lease or create control intent. MCU threshold in millidegrees Celsius, 30000..80000; hysteresis 5000. Raising the threshold does not acknowledge a latched fault or restart light.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/TemperatureStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        }
      },
      "put": {
        "operationId": "putTemperature",
        "summary": "Set temperature settings",
        "tags": [
          "Board API"
        ],
        "description": "MCU threshold in millidegrees Celsius, 30000..80000; hysteresis 5000. Raising the threshold does not acknowledge a latched fault or restart light.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/TemperatureStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        },
        "requestBody": {
          "required": true,
          "description": "Exactly the documented JSON object; no duplicate or unknown keys. At most 128 body bytes on board, including whitespace. Content-Length is required; complete board request including headers is at most 1024 bytes.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TemperatureRequest"
              },
              "example": {
                "max_temperature_mc": 50000
              }
            }
          }
        },
        "x-max-body-bytes": 128
      }
    },
    "/api/v1/eco": {
      "get": {
        "operationId": "getEco",
        "summary": "Read eco settings",
        "tags": [
          "Board API"
        ],
        "description": "Read only; does not extend a lease or create control intent. Set stage 0..3 and integer auto flag 0/1. A continuous scene can be preserved through a qualified transition; learning contexts can be cancelled. No new ON intent.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/DeviceStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        }
      },
      "put": {
        "operationId": "putEco",
        "summary": "Set eco settings",
        "tags": [
          "Board API"
        ],
        "description": "Set stage 0..3 and integer auto flag 0/1. A continuous scene can be preserved through a qualified transition; learning contexts can be cancelled. No new ON intent.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/DeviceStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        },
        "requestBody": {
          "required": true,
          "description": "Exactly the documented JSON object; no duplicate or unknown keys. At most 128 body bytes on board, including whitespace. Content-Length is required; complete board request including headers is at most 1024 bytes.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EcoRequest"
              },
              "example": {
                "stage": 3,
                "auto": 0
              }
            }
          }
        },
        "x-max-body-bytes": 128
      }
    },
    "/api/v1/efficiency": {
      "get": {
        "operationId": "getEfficiency",
        "summary": "Read efficiency settings",
        "tags": [
          "Board API"
        ],
        "description": "Read only; does not extend a lease or create control intent. Assumed total LED-output / PoE-input efficiency, 100..1000; default 930. Can reduce the stored user budget; raising it does not restore an earlier larger target or start output.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/DeviceStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        }
      },
      "put": {
        "operationId": "putEfficiency",
        "summary": "Set efficiency settings",
        "tags": [
          "Board API"
        ],
        "description": "Assumed total LED-output / PoE-input efficiency, 100..1000; default 930. Can reduce the stored user budget; raising it does not restore an earlier larger target or start output.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/DeviceStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        },
        "requestBody": {
          "required": true,
          "description": "Exactly the documented JSON object; no duplicate or unknown keys. At most 128 body bytes on board, including whitespace. Content-Length is required; complete board request including headers is at most 1024 bytes.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EfficiencyRequest"
              },
              "example": {
                "efficiency_permille": 930
              }
            }
          }
        },
        "x-max-body-bytes": 128
      }
    },
    "/api/v1/mqtt": {
      "get": {
        "operationId": "getMqtt",
        "summary": "Read mqtt settings",
        "tags": [
          "Board API"
        ],
        "description": "Read only; does not extend a lease or create control intent. Optional board MQTT configuration. GET never allocates. PUT enabled:true replaces the complete configuration and can reconnect. Empty password retains a previous secret; reset_password:true clears it. Disable is exactly {\"enabled\":false} and can remain internally pending for <=1 s while shutdown is serviced. Disabled after reboot.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/MqttStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        }
      },
      "put": {
        "operationId": "putMqtt",
        "summary": "Set mqtt settings",
        "tags": [
          "Board API"
        ],
        "description": "Optional board MQTT configuration. GET never allocates. PUT enabled:true replaces the complete configuration and can reconnect. Empty password retains a previous secret; reset_password:true clears it. Disable is exactly {\"enabled\":false} and can remain internally pending for <=1 s while shutdown is serviced. Disabled after reboot.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/MqttStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        },
        "requestBody": {
          "required": true,
          "description": "Exactly the documented JSON object; no duplicate or unknown keys. At most 128 body bytes on board, including whitespace. Content-Length is required; complete board request including headers is at most 1024 bytes.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MqttRequest"
              },
              "example": {
                "enabled": true,
                "broker": "192.168.1.2",
                "port": 1883,
                "username": "",
                "password": "",
                "telemetry_interval_s": 10
              }
            }
          }
        },
        "x-max-body-bytes": 128
      }
    },
    "/api/v1/ble": {
      "get": {
        "operationId": "getBle",
        "summary": "Read ble settings",
        "tags": [
          "Board API"
        ],
        "description": "Read only; does not extend a lease or create control intent. Optional experimental board BLE configuration. GET never initializes. Initial enable requires outputs/tests OFF; already enabled true is a no-op. Disable can retain SDK allocation. Hardware startup/pairing failures can require restart. Disabled and bonds forgotten after reboot.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/BleStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        }
      },
      "put": {
        "operationId": "putBle",
        "summary": "Set ble settings",
        "tags": [
          "Board API"
        ],
        "description": "Optional experimental board BLE configuration. GET never initializes. Initial enable requires outputs/tests OFF; already enabled true is a no-op. Disable can retain SDK allocation. Hardware startup/pairing failures can require restart. Disabled and bonds forgotten after reboot.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/BleStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        },
        "requestBody": {
          "required": true,
          "description": "Exactly the documented JSON object; no duplicate or unknown keys. At most 128 body bytes on board, including whitespace. Content-Length is required; complete board request including headers is at most 1024 bytes.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BleRequest"
              },
              "example": {
                "enabled": true
              }
            }
          }
        },
        "x-max-body-bytes": 128
      }
    },
    "/api/v1/scene": {
      "post": {
        "operationId": "postScene",
        "summary": "Replace the full continuous scene",
        "tags": [
          "Board API"
        ],
        "description": "Explicit nonzero five-channel request may turn output on after all admission checks. Optional transition_ms fades to the new scene over 0..60000 ms, default 0. Five zeros mean immediate OFF regardless of a valid transition_ms. OFF and protection reductions remain immediate. Accepted board scene persists without browser/network heartbeat. OFF, reset, 0 W or protection deletes intent; later settings/ACK never revive it.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/DeviceStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        },
        "requestBody": {
          "required": true,
          "description": "Exactly the documented JSON object; no duplicate or unknown keys. At most 128 body bytes on board, including whitespace. Content-Length is required; complete board request including headers is at most 1024 bytes.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SceneRequest"
              },
              "example": {
                "r": 0,
                "g": 0,
                "b": 0,
                "cw": 200,
                "ww": 200,
                "transition_ms": 1500
              }
            }
          }
        },
        "x-max-body-bytes": 128
      }
    },
    "/api/v1/off": {
      "post": {
        "operationId": "postOff",
        "summary": "Stop output and discard pending light intent",
        "tags": [
          "Board API"
        ],
        "description": "Global OFF/STOP, including during a pending start or learning job. Discards continuous scene intent and pending admission. Does not acknowledge faults.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/DeviceStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        },
        "requestBody": {
          "required": true,
          "description": "Exactly the documented JSON object; no duplicate or unknown keys. At most 128 body bytes on board, including whitespace. Content-Length is required; complete board request including headers is at most 1024 bytes.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EmptyRequest"
              },
              "example": {}
            }
          }
        },
        "x-max-body-bytes": 128
      }
    },
    "/api/v1/ack": {
      "post": {
        "operationId": "postAck",
        "summary": "Explicitly acknowledge healthy latched faults",
        "tags": [
          "Board API"
        ],
        "description": "Requires physical OFF and healthy fresh feedback. Temperature fault additionally requires temperature <= limit-5000. Cannot revive a watchdog failure and never restarts a deleted scene.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/DeviceStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        },
        "requestBody": {
          "required": true,
          "description": "Exactly the documented JSON object; no duplicate or unknown keys. At most 128 body bytes on board, including whitespace. Content-Length is required; complete board request including headers is at most 1024 bytes.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EmptyRequest"
              },
              "example": {}
            }
          }
        },
        "x-max-body-bytes": 128
      }
    },
    "/api/v1/recovery": {
      "post": {
        "operationId": "postRecovery",
        "summary": "Restart into the recovery loader for an update",
        "tags": [
          "Board API"
        ],
        "description": "Switches all outputs OFF, requests the recovery loader for the next boot and resets after a short reply grace. Repeats keep the first deadline. The loader serves the update page at / under the same hostname and DHCP identity.",
        "requestBody": {
          "required": true,
          "description": "Exactly the documented JSON object; no duplicate or unknown keys. At most 128 body bytes on board, including whitespace. Content-Length is required; complete board request including headers is at most 1024 bytes.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EmptyRequest"
              },
              "example": {}
            }
          }
        },
        "x-max-body-bytes": 128,
        "responses": {
          "202": {
            "$ref": "#/components/responses/RecoveryAcceptedResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        }
      }
    },
    "/api/v1/factory-reset": {
      "post": {
        "operationId": "postFactoryReset",
        "summary": "Restore the delivery state and restart",
        "tags": [
          "Board API"
        ],
        "description": "Requires {\"confirm\":1}. Switches all outputs OFF, ends a running strip check and stops BLE, stores the delivery state (5 W, 70 degC, 93 %, Eco 3 manual, spots, BLE/MQTT/WLED/Art-Net/sACN off, no strip profile; Hue pairings stay) in the device journal once the outputs are OFF and restarts. 202 carries the FirmwareStatus before the restart; a completed reset shows a new boot_generation. If the journal cannot be written, the device keeps running with its settings. The same delivery state applies automatically at boot when the stored settings fail their CRC, range or version checks (status settings_reset=1).",
        "requestBody": {
          "required": true,
          "description": "Exactly the documented JSON object; no duplicate or unknown keys. At most 128 body bytes on board, including whitespace. Content-Length is required; complete board request including headers is at most 1024 bytes.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FactoryResetRequest"
              },
              "example": {
                "confirm": 1
              }
            }
          }
        },
        "x-max-body-bytes": 128,
        "responses": {
          "202": {
            "$ref": "#/components/responses/RecoveryAcceptedResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        }
      }
    },
    "/api/v1/learn": {
      "get": {
        "operationId": "getLearnStatus",
        "summary": "Read autonomous learning status",
        "tags": [
          "Board API"
        ],
        "description": "Read only; no browser heartbeat or deadline extension. A candidate and the active profile exist only in board RAM.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/LearnStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        }
      }
    },
    "/api/v1/learn/begin": {
      "post": {
        "operationId": "postLearnBegin",
        "summary": "Begin a complete four-stage by five-channel job",
        "tags": [
          "Board API"
        ],
        "description": "Requires physical OFF and qualified healthy feedback. Creates a new generation and autonomous job; the immediate status is not a completed profile. The legal test frame may exceed ordinary user_led_mw without enabling implicit overdrive. Absolute whole-job deadline 120 s, per-cell deadline 5 s.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/LearnStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        },
        "requestBody": {
          "required": true,
          "description": "Exactly the documented JSON object; no duplicate or unknown keys. At most 128 body bytes on board, including whitespace. Content-Length is required; complete board request including headers is at most 1024 bytes.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EmptyRequest"
              },
              "example": {}
            }
          }
        },
        "x-max-body-bytes": 128
      }
    },
    "/api/v1/learn/commit": {
      "post": {
        "operationId": "postLearnCommit",
        "summary": "Publish the complete candidate as the active RAM profile",
        "tags": [
          "Board API"
        ],
        "description": "Generation must match a complete candidate; outputs must be physically OFF. Explicit atomic publication; does not turn light on. Repeating commit for the already committed generation is idempotent while that same context remains present.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/LearnStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        },
        "requestBody": {
          "required": true,
          "description": "Exactly the documented JSON object; no duplicate or unknown keys. At most 128 body bytes on board, including whitespace. Content-Length is required; complete board request including headers is at most 1024 bytes.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenerationRequest"
              },
              "example": {
                "generation": 1
              }
            }
          }
        },
        "x-max-body-bytes": 128
      }
    },
    "/api/v1/learn/abort": {
      "post": {
        "operationId": "postLearnAbort",
        "summary": "Abort the named candidate and stop its output",
        "tags": [
          "Board API"
        ],
        "description": "Generation-bound abort. Stale/unrelated generation is rejected. An existing previously active profile is retained. Use global /off for an unconditional stop of current output.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/LearnStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        },
        "requestBody": {
          "required": true,
          "description": "Exactly the documented JSON object; no duplicate or unknown keys. At most 128 body bytes on board, including whitespace. Content-Length is required; complete board request including headers is at most 1024 bytes.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenerationRequest"
              },
              "example": {
                "generation": 1
              }
            }
          }
        },
        "x-max-body-bytes": 128
      }
    },
    "/api/v1/learn/result/{generation}": {
      "get": {
        "operationId": "getLearnProfile",
        "summary": "Read the learned characteristic of one generation",
        "tags": [
          "Board API"
        ],
        "description": "Positive generation of the single learning report: running, finished, aborted or committed. Returns the four stage voltages and, for every stage*5+channel cell, the currents at 10..100 % PWM. A running generation shows the cells measured so far. No new test is requested. Any other generation is a conflict.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/LearnProfileResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        },
        "parameters": [
          {
            "$ref": "#/components/parameters/Generation"
          }
        ]
      }
    },
    "/api/v1/light": {
      "get": {
        "operationId": "getLightLayout",
        "summary": "Read channel layout",
        "tags": [
          "Board API"
        ],
        "description": "Shared by web, MQTT Home Assistant discovery and the optional WLED JSON facade. Layout 0 = five individual lights, 1 = RGB, 2 = RGB plus CCT, 3 = CCT. Selecting a layout does not change or mask active outputs, renew a light lease, or submit an ON/OFF command. Changed settings persist when all outputs are OFF and the radio permits flash writes. Older version-1 records default to layout 0 and preserve learned profiles.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/LightLayoutResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        }
      },
      "put": {
        "operationId": "putLightLayout",
        "summary": "Set channel layout",
        "tags": [
          "Board API"
        ],
        "description": "Shared by web, MQTT Home Assistant discovery and the optional WLED JSON facade. Layout 0 = five individual lights, 1 = RGB, 2 = RGB plus CCT, 3 = CCT. Selecting a layout does not change or mask active outputs, renew a light lease, or submit an ON/OFF command. Changed settings persist when all outputs are OFF and the radio permits flash writes. Older version-1 records default to layout 0 and preserve learned profiles.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/LightLayoutResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LightLayout"
              },
              "example": {
                "layout": 2
              }
            }
          }
        },
        "x-max-body-bytes": 128
      }
    },
    "/api/v1/wled": {
      "get": {
        "operationId": "getWled",
        "summary": "Read WLED JSON settings",
        "tags": [
          "Board API"
        ],
        "description": "Optional WLED JSON compatibility facade. The native /api/v1 HTTP API is always available. GET does not allocate or renew light intent. PUT accepts exactly {\"enabled\":true} or {\"enabled\":false}; repeated values are idempotent. The facade is disabled after every boot. Enabling allocates its RAM state; disabling frees it and cancels only pending WLED requests, while an already admitted scene continues. Disabled /json paths and /presets.json return 404. See wled-json.md for the supported subset; this is not WLED firmware.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/WledStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        }
      },
      "put": {
        "operationId": "putWled",
        "summary": "Set WLED JSON settings",
        "tags": [
          "Board API"
        ],
        "description": "Optional WLED JSON compatibility facade. The native /api/v1 HTTP API is always available. GET does not allocate or renew light intent. PUT accepts exactly {\"enabled\":true} or {\"enabled\":false}; repeated values are idempotent. The facade is disabled after every boot. Enabling allocates its RAM state; disabling frees it and cancels only pending WLED requests, while an already admitted scene continues. Disabled /json paths and /presets.json return 404. See wled-json.md for the supported subset; this is not WLED firmware.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/WledStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        },
        "requestBody": {
          "required": true,
          "description": "Exactly {\"enabled\":true} or {\"enabled\":false}; no duplicate or unknown keys. At most 128 body bytes including whitespace. Content-Length is required; the complete board request including headers is at most 1024 bytes.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WledEnabledRequest"
              },
              "example": {
                "enabled": true
              }
            }
          }
        },
        "x-max-body-bytes": 128
      }
    },
    "/api/v1/artnet": {
      "get": {
        "operationId": "getArtNet",
        "summary": "Read Art-Net settings",
        "tags": [
          "Board API"
        ],
        "description": "Optional Art-Net receiver. The native /api/v1 HTTP API is always available. GET does not allocate, enable, rearm or renew control intent. After boot both receivers are disabled. PUT requires enabled: false alone disables this receiver; enabled:true accepts optional universe and start_address, retains omitted values, and explicitly rearms only this receiver. Rearm discards cached data and requires a new packet. Configurations are not persistent. The last disable frees shared engine RAM and resets both configurations. Changing/disabling the currently DMX-owned protocol turns off that stream's output; a manual scene is preserved. Manual control, STOP or a safety shutdown suspends DMX until explicit rearm. Five consecutive slots map to physical R/G/B/CW/WW independently of light_layout. See artnet-sacn.md for source merging, selection, discovery and loss policy.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/ArtNetStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        }
      },
      "put": {
        "operationId": "putArtNet",
        "summary": "Set/rearm Art-Net settings",
        "tags": [
          "Board API"
        ],
        "description": "Optional Art-Net receiver. The native /api/v1 HTTP API is always available. GET does not allocate, enable, rearm or renew control intent. After boot both receivers are disabled. PUT requires enabled: false alone disables this receiver; enabled:true accepts optional universe and start_address, retains omitted values, and explicitly rearms only this receiver. Rearm discards cached data and requires a new packet. Configurations are not persistent. The last disable frees shared engine RAM and resets both configurations. Changing/disabling the currently DMX-owned protocol turns off that stream's output; a manual scene is preserved. Manual control, STOP or a safety shutdown suspends DMX until explicit rearm. Five consecutive slots map to physical R/G/B/CW/WW independently of light_layout. See artnet-sacn.md for source merging, selection, discovery and loss policy.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/ArtNetStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        },
        "requestBody": {
          "required": true,
          "description": "Exactly {\"enabled\":false}, or enabled:true with optional integer universe/start_address. No unknown or duplicate keys. At most 128 body bytes including whitespace; complete HTTP request at most 1024 bytes.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ArtNetRequest"
              },
              "examples": {
                "disable": {
                  "value": {
                    "enabled": false
                  }
                },
                "rearm": {
                  "value": {
                    "enabled": true
                  }
                },
                "configure": {
                  "value": {
                    "enabled": true,
                    "universe": 0,
                    "start_address": 1
                  }
                }
              }
            }
          }
        },
        "x-max-body-bytes": 128
      }
    },
    "/api/v1/sacn": {
      "get": {
        "operationId": "getSacn",
        "summary": "Read sACN settings",
        "tags": [
          "Board API"
        ],
        "description": "Optional sACN receiver. The native /api/v1 HTTP API is always available. GET does not allocate, enable, rearm or renew control intent. After boot both receivers are disabled. PUT requires enabled: false alone disables this receiver; enabled:true accepts optional universe and start_address, retains omitted values, and explicitly rearms only this receiver. Rearm discards cached data and requires a new packet. Configurations are not persistent. The last disable frees shared engine RAM and resets both configurations. Changing/disabling the currently DMX-owned protocol turns off that stream's output; a manual scene is preserved. Manual control, STOP or a safety shutdown suspends DMX until explicit rearm. Five consecutive slots map to physical R/G/B/CW/WW independently of light_layout. See artnet-sacn.md for source merging, selection, discovery and loss policy.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/SacnStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        }
      },
      "put": {
        "operationId": "putSacn",
        "summary": "Set/rearm sACN settings",
        "tags": [
          "Board API"
        ],
        "description": "Optional sACN receiver. The native /api/v1 HTTP API is always available. GET does not allocate, enable, rearm or renew control intent. After boot both receivers are disabled. PUT requires enabled: false alone disables this receiver; enabled:true accepts optional universe and start_address, retains omitted values, and explicitly rearms only this receiver. Rearm discards cached data and requires a new packet. Configurations are not persistent. The last disable frees shared engine RAM and resets both configurations. Changing/disabling the currently DMX-owned protocol turns off that stream's output; a manual scene is preserved. Manual control, STOP or a safety shutdown suspends DMX until explicit rearm. Five consecutive slots map to physical R/G/B/CW/WW independently of light_layout. See artnet-sacn.md for source merging, selection, discovery and loss policy.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/SacnStatusResponse"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "405": {
            "$ref": "#/components/responses/Error405"
          },
          "409": {
            "$ref": "#/components/responses/Error409"
          },
          "413": {
            "$ref": "#/components/responses/Error413"
          },
          "431": {
            "$ref": "#/components/responses/Error431"
          },
          "503": {
            "$ref": "#/components/responses/Error503"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        },
        "requestBody": {
          "required": true,
          "description": "Exactly {\"enabled\":false}, or enabled:true with optional integer universe/start_address. No unknown or duplicate keys. At most 128 body bytes including whitespace; complete HTTP request at most 1024 bytes.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SacnRequest"
              },
              "examples": {
                "disable": {
                  "value": {
                    "enabled": false
                  }
                },
                "rearm": {
                  "value": {
                    "enabled": true
                  }
                },
                "configure": {
                  "value": {
                    "enabled": true,
                    "universe": 1,
                    "start_address": 1
                  }
                }
              }
            }
          }
        },
        "x-max-body-bytes": 128
      }
    }
  },
  "components": {
    "schemas": {
      "UInt32": {
        "type": "integer",
        "minimum": 0,
        "maximum": 4294967295,
        "description": "Unsigned 32-bit integer."
      },
      "Int32": {
        "type": "integer",
        "minimum": -2147483648,
        "maximum": 2147483647,
        "description": "Signed 32-bit integer."
      },
      "Flag": {
        "type": "integer",
        "enum": [
          0,
          1
        ],
        "description": "Device wire flag: integer 0 or 1, not a JSON Boolean."
      },
      "Promille": {
        "type": "integer",
        "minimum": 0,
        "maximum": 1000,
        "description": "Channel request or applied PWM in promille; 1000 is 100%."
      },
      "TemperatureLimit": {
        "type": "integer",
        "minimum": 30000,
        "maximum": 80000,
        "description": "MCU temperature threshold in millidegrees Celsius, 30 to 80 degC in 5 degC steps; default 70000.",
        "enum": [
          30000,
          35000,
          40000,
          45000,
          50000,
          55000,
          60000,
          65000,
          70000,
          75000,
          80000
        ]
      },
      "Generation": {
        "type": "integer",
        "minimum": 1,
        "maximum": 4294967295,
        "description": "Positive job generation. Zero is never a valid request generation."
      },
      "EmptyRequest": {
        "type": "object",
        "required": [],
        "properties": {},
        "additionalProperties": false,
        "description": "Exactly the empty JSON object {}."
      },
      "PowerRequest": {
        "type": "object",
        "required": [
          "max_led_mw"
        ],
        "properties": {
          "max_led_mw": {
            "type": "integer",
            "minimum": 0,
            "maximum": 30000,
            "description": "New LED-output user target in mW. Board also enforces current max_led_mw from PowerStatus."
          }
        },
        "additionalProperties": false
      },
      "TemperatureRequest": {
        "type": "object",
        "required": [
          "max_temperature_mc"
        ],
        "properties": {
          "max_temperature_mc": {
            "$ref": "#/components/schemas/TemperatureLimit"
          }
        },
        "additionalProperties": false
      },
      "EcoRequest": {
        "type": "object",
        "required": [
          "stage",
          "auto"
        ],
        "properties": {
          "stage": {
            "type": "integer",
            "minimum": 0,
            "maximum": 3
          },
          "auto": {
            "$ref": "#/components/schemas/Flag"
          }
        },
        "additionalProperties": false,
        "description": "Set Eco stage and automatic selection flag; both keys are required."
      },
      "EfficiencyRequest": {
        "type": "object",
        "required": [
          "efficiency_permille"
        ],
        "properties": {
          "efficiency_permille": {
            "type": "integer",
            "minimum": 100,
            "maximum": 1000
          }
        },
        "additionalProperties": false,
        "description": "Assumed total LED-output / PoE-input efficiency, default 930; not a measurement."
      },
      "SceneRequest": {
        "type": "object",
        "required": [
          "r",
          "g",
          "b",
          "cw",
          "ww"
        ],
        "properties": {
          "r": {
            "$ref": "#/components/schemas/Promille"
          },
          "g": {
            "$ref": "#/components/schemas/Promille"
          },
          "b": {
            "$ref": "#/components/schemas/Promille"
          },
          "cw": {
            "$ref": "#/components/schemas/Promille"
          },
          "ww": {
            "$ref": "#/components/schemas/Promille"
          },
          "transition_ms": {
            "type": "integer",
            "minimum": 0,
            "maximum": 60000,
            "default": 0,
            "description": "Optional fade duration in milliseconds; omitted or zero applies the scene immediately. A zero-valued five-channel scene always stops immediately, including with a nonzero valid transition."
          }
        },
        "additionalProperties": false,
        "description": "All five channel keys are required. Optional transition_ms is an integer from 0 to 60000, default 0. Five zeros mean immediate OFF. A nonzero explicit request can start continuous output after admission; fades use the same protection path and never delay OFF or a protection reduction."
      },
      "GenerationRequest": {
        "type": "object",
        "required": [
          "generation"
        ],
        "properties": {
          "generation": {
            "$ref": "#/components/schemas/Generation"
          }
        },
        "additionalProperties": false
      },
      "BleRequest": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/BleEnabledRequest"
          },
          {
            "$ref": "#/components/schemas/BleClearBondsRequest"
          }
        ]
      },
      "BleEnabledRequest": {
        "type": "object",
        "required": [
          "enabled"
        ],
        "properties": {
          "enabled": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "BleClearBondsRequest": {
        "type": "object",
        "required": [
          "clear_bonds"
        ],
        "properties": {
          "clear_bonds": {
            "const": true
          }
        },
        "additionalProperties": false,
        "description": "Erase every stored BLE bond once no peer is connected; a connected peer is disconnected first. 409 until the BLE stack has started once."
      },
      "ApiError": {
        "type": "object",
        "required": [
          "error",
          "code"
        ],
        "properties": {
          "error": {
            "type": "string",
            "description": "Human-readable diagnostic text; not a stable machine contract."
          },
          "code": {
            "type": "string",
            "enum": [
              "invalid_request",
              "forbidden",
              "not_found",
              "method_not_allowed",
              "conflict",
              "request_too_large",
              "headers_too_large",
              "unavailable",
              "internal_error"
            ]
          }
        },
        "additionalProperties": false,
        "description": "Uniform non-2xx v1 API error. code is selected by HTTP status. A malformed request rejected before its v1 target is recognizable may only receive a transport close or a legacy framing error."
      },
      "PowerStatus": {
        "type": "object",
        "required": [
          "user_led_mw",
          "effective_led_mw",
          "max_led_mw",
          "measured_led_mw",
          "measured_valid",
          "limiting",
          "faults"
        ],
        "properties": {
          "user_led_mw": {
            "type": "integer",
            "minimum": 0,
            "maximum": 30000,
            "description": "Stored user target in mW at the LED output."
          },
          "effective_led_mw": {
            "type": "integer",
            "minimum": 0,
            "maximum": 30000,
            "description": "Effective target after present supply/protection restrictions; never exceeds user_led_mw."
          },
          "max_led_mw": {
            "type": "integer",
            "minimum": 0,
            "maximum": 30000,
            "description": "Largest currently accepted user target, not the stored user target. Dynamic with PoE class, mode and efficiency."
          },
          "measured_led_mw": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 4294967295,
            "description": "LED-output measured power in mW; null if invalid."
          },
          "measured_valid": {
            "type": "boolean",
            "description": "On board: adc_valid && mean_valid."
          },
          "limiting": {
            "type": "boolean",
            "description": "True for current, power or measurement limiting (DeviceStatus.limits bits 0, 1 or 3)."
          },
          "faults": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Latched output-fault bitmask; zero means no latched fault."
          }
        },
        "additionalProperties": true,
        "description": "Board power resource. GET and successful PUT return this same shape.",
        "examples": [
          {
            "user_led_mw": 5000,
            "effective_led_mw": 5000,
            "max_led_mw": 23715,
            "measured_led_mw": 0,
            "measured_valid": true,
            "limiting": false,
            "faults": 0
          }
        ]
      },
      "TemperatureStatus": {
        "type": "object",
        "required": [
          "temperature_mc",
          "temperature_valid",
          "max_temperature_mc",
          "temperature_hysteresis_mc",
          "faults"
        ],
        "properties": {
          "temperature_mc": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": -2147483648,
            "maximum": 2147483647,
            "description": "MCU temperature in millidegrees Celsius; null if invalid."
          },
          "temperature_valid": {
            "type": "boolean"
          },
          "max_temperature_mc": {
            "$ref": "#/components/schemas/TemperatureLimit"
          },
          "temperature_hysteresis_mc": {
            "type": "integer",
            "const": 5000
          },
          "faults": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Latched output-fault bitmask."
          }
        },
        "additionalProperties": false,
        "description": "Board temperature resource. GET and successful PUT return this same shape.",
        "examples": [
          {
            "temperature_mc": 30000,
            "temperature_valid": true,
            "max_temperature_mc": 50000,
            "temperature_hysteresis_mc": 5000,
            "faults": 0
          }
        ]
      },
      "DeviceStatus": {
        "type": "object",
        "required": [
          "mvp",
          "now_ms",
          "deadline_ms",
          "pulse_active",
          "cw_requested",
          "ww_requested",
          "cw_applied",
          "ww_applied",
          "r_requested",
          "g_requested",
          "b_requested",
          "r_applied",
          "g_applied",
          "b_applied",
          "user_led_mw",
          "effective_led_mw",
          "measured_led_mw",
          "estimated_poe_input_mw",
          "compliance_led_budget_mw",
          "overdrive_led_budget_mw",
          "current_ma",
          "rail_mv",
          "current_uncal_ma",
          "temperature_mc",
          "temperature_raw_mc",
          "temperature_valid",
          "ready",
          "adc_valid",
          "t2p",
          "avg_valid",
          "zero_valid",
          "mean_valid",
          "scene_active",
          "overdrive",
          "auto_eco",
          "eco_settling",
          "cpu_valid",
          "ram_stack_valid",
          "ram_layout_valid",
          "loop_valid",
          "temperature_sample_ms",
          "adc_sample_ms",
          "mean_start_ms",
          "mean_sample_ms",
          "max_temperature_mc",
          "limits",
          "faults",
          "bsp_fault",
          "max_current_ma",
          "protection_led_mw",
          "avg_current_ma",
          "avg_rail_mv",
          "avg_led_mw",
          "mean_count",
          "adc_i_raw",
          "adc_v_raw",
          "peak_i_raw",
          "zero_raw",
          "safety_irq_lag_ms",
          "target_led_mw",
          "max_led_budget_mw",
          "poe_input_limit_mw",
          "mean_i_raw",
          "mean_v_raw",
          "poe_input_estimated",
          "efficiency_permille",
          "eco_stage",
          "eco_requested",
          "cpu_permille",
          "ram_free_bytes",
          "ram_stack_reserve_bytes",
          "ram_stack_used_bytes",
          "loop_mean_us",
          "loop_max_us",
          "light_layout",
          "settings_reset"
        ],
        "properties": {
          "mvp": {
            "type": "integer",
            "const": 1
          },
          "now_ms": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Snapshot uptime in milliseconds modulo 2^32; not UTC."
          },
          "deadline_ms": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Absolute end of the current output lease on the same wrapping millisecond clock; zero if none."
          },
          "pulse_active": {
            "$ref": "#/components/schemas/Flag",
            "description": "A bounded output lease is active: a continuous scene or the strip check."
          },
          "cw_requested": {
            "$ref": "#/components/schemas/Promille",
            "description": "Requested cold-white level."
          },
          "ww_requested": {
            "$ref": "#/components/schemas/Promille",
            "description": "Requested warm-white level."
          },
          "cw_applied": {
            "$ref": "#/components/schemas/Promille",
            "description": "Applied cold-white level."
          },
          "ww_applied": {
            "$ref": "#/components/schemas/Promille",
            "description": "Applied warm-white level."
          },
          "r_requested": {
            "$ref": "#/components/schemas/Promille",
            "description": "Requested red level."
          },
          "g_requested": {
            "$ref": "#/components/schemas/Promille",
            "description": "Requested green level."
          },
          "b_requested": {
            "$ref": "#/components/schemas/Promille",
            "description": "Requested blue level."
          },
          "r_applied": {
            "$ref": "#/components/schemas/Promille",
            "description": "Applied red level."
          },
          "g_applied": {
            "$ref": "#/components/schemas/Promille",
            "description": "Applied green level."
          },
          "b_applied": {
            "$ref": "#/components/schemas/Promille",
            "description": "Applied blue level."
          },
          "user_led_mw": {
            "type": "integer",
            "minimum": 0,
            "maximum": 30000,
            "description": "Stored LED-output user target in mW."
          },
          "effective_led_mw": {
            "type": "integer",
            "minimum": 0,
            "maximum": 30000,
            "description": "Effective LED-output target in mW after present restrictions."
          },
          "measured_led_mw": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 4294967295,
            "description": "Measured LED-output power in mW; null unless adc_valid and mean_valid are 1."
          },
          "estimated_poe_input_mw": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 4294967295,
            "description": "Estimated PoE-input power in mW, rounded up from measured LED power / efficiency; null unless adc_valid and mean_valid are 1. Not an input measurement."
          },
          "compliance_led_budget_mw": {
            "type": "integer",
            "minimum": 0,
            "maximum": 30000,
            "description": "Normal-mode LED-output budget in mW for detected supply and assumed efficiency; the label does not certify PoE compliance."
          },
          "overdrive_led_budget_mw": {
            "type": "integer",
            "minimum": 0,
            "maximum": 30000,
            "description": "Maximum LED-output budget in mW if the current supply permits overdrive."
          },
          "current_ma": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 4294967295,
            "description": "Current in mA; null unless adc_valid is 1."
          },
          "rail_mv": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 4294967295,
            "description": "Measured supply rail in mV; null unless adc_valid is 1."
          },
          "current_uncal_ma": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 4294967295,
            "description": "Uncorrected current in mA; null unless adc_valid is 1."
          },
          "temperature_mc": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": -2147483648,
            "maximum": 2147483647,
            "description": "Smoothed MCU temperature in millidegrees Celsius; null unless temperature_valid is 1."
          },
          "temperature_raw_mc": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": -2147483648,
            "maximum": 2147483647,
            "description": "Latest raw MCU temperature in millidegrees Celsius; null unless temperature_valid is 1. ACK uses raw health as well as the filtered value."
          },
          "temperature_valid": {
            "$ref": "#/components/schemas/Flag",
            "description": "Temperature data are valid."
          },
          "ready": {
            "$ref": "#/components/schemas/Flag",
            "description": "Controller feedback is ready; not by itself authorization to energize."
          },
          "adc_valid": {
            "$ref": "#/components/schemas/Flag",
            "description": "Current/rail ADC data are valid."
          },
          "t2p": {
            "$ref": "#/components/schemas/Flag",
            "description": "PoE Type-2 signal: 1 confirmed Type 2, 0 Type 1 or not confirmed; not an LLDP class."
          },
          "avg_valid": {
            "$ref": "#/components/schemas/Flag",
            "description": "Averaged measurement group is valid."
          },
          "zero_valid": {
            "$ref": "#/components/schemas/Flag",
            "description": "A complete current-zero qualification succeeded, including a valid numerical zero of 0."
          },
          "mean_valid": {
            "$ref": "#/components/schemas/Flag",
            "description": "The mean block is valid."
          },
          "scene_active": {
            "$ref": "#/components/schemas/Flag",
            "description": "Continuous scene intent is active."
          },
          "overdrive": {
            "$ref": "#/components/schemas/Flag",
            "description": "Overdrive selection is active."
          },
          "auto_eco": {
            "$ref": "#/components/schemas/Flag",
            "description": "Automatic Eco selection is enabled."
          },
          "eco_settling": {
            "$ref": "#/components/schemas/Flag",
            "description": "Eco transition is settling."
          },
          "cpu_valid": {
            "$ref": "#/components/schemas/Flag",
            "description": "CPU-load estimate is valid."
          },
          "ram_stack_valid": {
            "$ref": "#/components/schemas/Flag",
            "description": "Stack-use estimate is valid."
          },
          "ram_layout_valid": {
            "$ref": "#/components/schemas/Flag",
            "description": "RAM/stack layout check is valid."
          },
          "loop_valid": {
            "$ref": "#/components/schemas/Flag",
            "description": "Loop timing estimate is valid."
          },
          "temperature_sample_ms": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Temperature acquisition timestamp on the wrapping uptime clock, ms."
          },
          "adc_sample_ms": {
            "$ref": "#/components/schemas/UInt32",
            "description": "ADC acquisition timestamp on the wrapping uptime clock, ms."
          },
          "mean_start_ms": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Start of the mean acquisition window on the wrapping uptime clock, ms."
          },
          "mean_sample_ms": {
            "$ref": "#/components/schemas/UInt32",
            "description": "End/sample timestamp of the mean window on the wrapping uptime clock, ms."
          },
          "max_temperature_mc": {
            "$ref": "#/components/schemas/TemperatureLimit"
          },
          "limits": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Current output-limiting bitmask; see reference."
          },
          "faults": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Latched output-fault bitmask; see reference."
          },
          "bsp_fault": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Board-platform fault bitmask; zero means none."
          },
          "max_current_ma": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Current output-protection bound in mA."
          },
          "protection_led_mw": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Power output-protection bound in mW."
          },
          "avg_current_ma": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 4294967295,
            "description": "Averaged current in mA; null unless adc_valid and avg_valid are 1."
          },
          "avg_rail_mv": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 4294967295,
            "description": "Averaged rail in mV; null unless adc_valid and avg_valid are 1."
          },
          "avg_led_mw": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 4294967295,
            "description": "Averaged LED power in mW; null unless adc_valid and avg_valid are 1."
          },
          "mean_count": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Number of scans represented by the averaged block, normally 64."
          },
          "adc_i_raw": {
            "type": "integer",
            "minimum": 0,
            "maximum": 4095,
            "description": "Latest raw 12-bit current ADC count."
          },
          "adc_v_raw": {
            "type": "integer",
            "minimum": 0,
            "maximum": 4095,
            "description": "Latest raw 12-bit rail ADC count."
          },
          "peak_i_raw": {
            "type": "integer",
            "minimum": 0,
            "maximum": 4095,
            "description": "Peak raw 12-bit current ADC count."
          },
          "zero_raw": {
            "type": "integer",
            "minimum": 0,
            "maximum": 64,
            "description": "Qualified current-zero raw ADC count. Validity is zero_valid, never zero_raw != 0."
          },
          "safety_irq_lag_ms": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Age of the independent safety interrupt in ms."
          },
          "target_led_mw": {
            "type": "integer",
            "minimum": 0,
            "maximum": 30000,
            "description": "Regulator LED-output target in mW, including internal reserve."
          },
          "max_led_budget_mw": {
            "type": "integer",
            "minimum": 0,
            "maximum": 30000,
            "description": "Largest presently accepted LED-output user target in mW."
          },
          "poe_input_limit_mw": {
            "type": "integer",
            "minimum": 0,
            "maximum": 30000,
            "description": "Assumed PoE-input frame in mW: 12950, 25500 or 30000 depending on supply/overdrive."
          },
          "mean_i_raw": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 4095,
            "description": "Mean raw current count; null unless adc_valid and mean_valid are 1."
          },
          "mean_v_raw": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 4095,
            "description": "Mean raw rail count; null unless adc_valid and mean_valid are 1."
          },
          "poe_input_estimated": {
            "type": "integer",
            "const": 1,
            "description": "Input power is estimated, never directly measured."
          },
          "efficiency_permille": {
            "type": "integer",
            "minimum": 100,
            "maximum": 1000,
            "description": "Assumed total LED-output / PoE-input efficiency in promille."
          },
          "eco_stage": {
            "type": "integer",
            "minimum": 0,
            "maximum": 3,
            "description": "Applied Eco voltage stage."
          },
          "eco_requested": {
            "type": "integer",
            "minimum": 0,
            "maximum": 3,
            "description": "Requested Eco voltage stage."
          },
          "cpu_permille": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000,
            "description": "Estimated CPU load in promille; interpret only when cpu_valid is 1."
          },
          "ram_free_bytes": {
            "$ref": "#/components/schemas/UInt32",
            "description": "RAM in bytes that the heap has not claimed yet (static gap minus BLE/MQTT and other allocations); a lower bound, memory freed back to the allocator is not counted."
          },
          "ram_stack_reserve_bytes": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Reserved stack size in bytes."
          },
          "ram_stack_used_bytes": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Observed stack usage in bytes; interpret only when ram_stack_valid is 1."
          },
          "loop_mean_us": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Mean foreground iteration time in microseconds; interpret only when loop_valid is 1."
          },
          "loop_max_us": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Maximum foreground iteration time in microseconds; interpret only when loop_valid is 1."
          },
          "light_layout": {
            "type": "integer",
            "minimum": 0,
            "maximum": 3,
            "description": "Server-owned channel layout shared by web and MQTT: 0 individual, 1 RGB, 2 RGB/CCT, 3 CCT."
          },
          "settings_reset": {
            "$ref": "#/components/schemas/Flag",
            "description": "1: the stored settings failed their CRC, range or version checks at boot; the delivery state applies and was stored again."
          },
          "scene_transition_max_ms": {
            "type": "integer",
            "const": 60000,
            "readOnly": true,
            "description": "Optional capability: maximum HTTP scene fade duration in milliseconds. Current firmware always reports 60000; absence identifies older firmware without HTTP fades."
          }
        },
        "additionalProperties": false,
        "description": "Complete immutable board snapshot. All flags are integers 0/1. Validity flags determine nullable measurement fields; raw diagnostics and counters remain numeric. Optional scene_transition_max_ms advertises HTTP scene fades; older firmware may omit this capability.",
        "examples": [
          {
            "mvp": 1,
            "now_ms": 1234,
            "deadline_ms": 0,
            "pulse_active": 0,
            "cw_requested": 0,
            "ww_requested": 0,
            "cw_applied": 0,
            "ww_applied": 0,
            "r_requested": 0,
            "g_requested": 0,
            "b_requested": 0,
            "r_applied": 0,
            "g_applied": 0,
            "b_applied": 0,
            "user_led_mw": 5000,
            "effective_led_mw": 5000,
            "measured_led_mw": 0,
            "estimated_poe_input_mw": 0,
            "compliance_led_budget_mw": 23715,
            "overdrive_led_budget_mw": 27900,
            "current_ma": 0,
            "rail_mv": 24400,
            "current_uncal_ma": 0,
            "temperature_mc": 30000,
            "temperature_raw_mc": 30000,
            "temperature_valid": 1,
            "ready": 1,
            "adc_valid": 1,
            "t2p": 1,
            "avg_valid": 1,
            "zero_valid": 1,
            "mean_valid": 1,
            "scene_active": 0,
            "overdrive": 0,
            "auto_eco": 0,
            "eco_settling": 0,
            "cpu_valid": 0,
            "ram_stack_valid": 0,
            "ram_layout_valid": 1,
            "loop_valid": 0,
            "temperature_sample_ms": 1230,
            "adc_sample_ms": 1234,
            "mean_start_ms": 1230,
            "mean_sample_ms": 1234,
            "max_temperature_mc": 50000,
            "limits": 0,
            "faults": 0,
            "bsp_fault": 0,
            "max_current_ma": 1500,
            "protection_led_mw": 30000,
            "avg_current_ma": 0,
            "avg_rail_mv": 24400,
            "avg_led_mw": 0,
            "mean_count": 64,
            "adc_i_raw": 6,
            "adc_v_raw": 2890,
            "peak_i_raw": 6,
            "zero_raw": 6,
            "safety_irq_lag_ms": 0,
            "target_led_mw": 0,
            "max_led_budget_mw": 23715,
            "poe_input_limit_mw": 25500,
            "mean_i_raw": 6,
            "mean_v_raw": 2890,
            "poe_input_estimated": 1,
            "efficiency_permille": 930,
            "eco_stage": 3,
            "eco_requested": 3,
            "cpu_permille": 0,
            "ram_free_bytes": 20000,
            "ram_stack_reserve_bytes": 8192,
            "ram_stack_used_bytes": 0,
            "loop_mean_us": 0,
            "loop_max_us": 0,
            "light_layout": 0,
            "scene_transition_max_ms": 60000
          }
        ]
      },
      "MqttBroker": {
        "type": "string",
        "minLength": 7,
        "maxLength": 15,
        "pattern": "^(?!127\\.)(?:(?:[1-9]|[1-9][0-9]|1[0-9]{2}|2[01][0-9]|22[0-3])\\.)(?:(?:0|[1-9][0-9]?|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){2}(?:0|[1-9][0-9]?|1[0-9]{2}|2[0-4][0-9]|25[0-5])(?![\\s\\S])",
        "description": "Canonical dotted IPv4, no leading zeros; first octet 1..223 except 127. No DNS, TLS, IPv6 or multicast."
      },
      "MqttEnabledRequest": {
        "type": "object",
        "required": [
          "enabled",
          "broker",
          "port",
          "username",
          "password"
        ],
        "properties": {
          "enabled": {
            "type": "boolean",
            "const": true
          },
          "broker": {
            "$ref": "#/components/schemas/MqttBroker"
          },
          "port": {
            "type": "integer",
            "minimum": 1,
            "maximum": 65535
          },
          "username": {
            "type": "string",
            "maxLength": 32,
            "x-max-utf8-bytes": 32,
            "pattern": "^[^\\u0000-\\u001f\\u007f-\\u009f\\ud800-\\udfff]*(?![\\s\\S])",
            "description": "At most 32 UTF-8 bytes after JSON decoding; Unicode scalar values only, no C0/C1 controls. maxLength is a necessary character bound; x-max-utf8-bytes is the additional normative byte bound."
          },
          "password": {
            "type": "string",
            "maxLength": 64,
            "x-max-utf8-bytes": 64,
            "pattern": "^[^\\u0000-\\u001f\\u007f-\\u009f\\ud800-\\udfff]*(?![\\s\\S])",
            "description": "At most 64 UTF-8 bytes after JSON decoding; Unicode scalar values only, no C0/C1 controls. maxLength is a necessary character bound; x-max-utf8-bytes is the additional normative byte bound."
          },
          "reset_password": {
            "type": "boolean",
            "default": false,
            "description": "true clears the password even if a nonempty password is also supplied."
          },
          "telemetry_interval_s": {
            "type": "integer",
            "minimum": 1,
            "maximum": 3600,
            "description": "Optional; default 10 on every configuration. Not inherited from a previous configuration."
          }
        },
        "additionalProperties": false,
        "description": "A complete configuration, not a partial patch. username and password are required even if empty. Empty password retains the previous secret unless reset_password is true."
      },
      "MqttDisabledRequest": {
        "type": "object",
        "required": [
          "enabled"
        ],
        "properties": {
          "enabled": {
            "type": "boolean",
            "const": false
          }
        },
        "additionalProperties": false,
        "description": "Exactly {\"enabled\":false}; other fields are rejected."
      },
      "MqttRequest": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/MqttEnabledRequest"
          },
          {
            "$ref": "#/components/schemas/MqttDisabledRequest"
          }
        ]
      },
      "MqttStatus": {
        "type": "object",
        "required": [
          "enabled",
          "connected",
          "broker",
          "port",
          "username",
          "password_set",
          "telemetry_interval_s",
          "hostname",
          "ram_bytes",
          "error"
        ],
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "connected": {
            "type": "boolean"
          },
          "broker": {
            "type": "string",
            "maxLength": 15,
            "description": "Configured IPv4, or empty while disabled."
          },
          "port": {
            "type": "integer",
            "minimum": 0,
            "maximum": 65535,
            "description": "Zero while disabled."
          },
          "username": {
            "type": "string",
            "maxLength": 32,
            "x-max-utf8-bytes": 32,
            "pattern": "^[^\\u0000-\\u001f\\u007f-\\u009f\\ud800-\\udfff]*(?![\\s\\S])",
            "description": "At most 32 UTF-8 bytes after JSON decoding; Unicode scalar values only, no C0/C1 controls. maxLength is a necessary character bound; x-max-utf8-bytes is the additional normative byte bound."
          },
          "password_set": {
            "type": "boolean"
          },
          "telemetry_interval_s": {
            "type": "integer",
            "minimum": 0,
            "maximum": 3600,
            "description": "Zero while disabled; otherwise effective interval, 1..3600 seconds."
          },
          "hostname": {
            "type": "string",
            "description": "Current mDNS responder label without .local; can change after a name conflict."
          },
          "ram_bytes": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Allocated MQTT work area in bytes; zero while disabled."
          },
          "error": {
            "type": "string",
            "enum": [
              "",
              "stopping"
            ],
            "description": "Successful status: empty normally, stopping during bounded shutdown. Non-2xx v1 failures use ApiError instead."
          }
        },
        "additionalProperties": false,
        "description": "Existing redacted MQTT success object; never a password.",
        "examples": [
          {
            "enabled": false,
            "connected": false,
            "broker": "",
            "port": 0,
            "username": "",
            "password_set": false,
            "telemetry_interval_s": 0,
            "hostname": "poe-rgb-aabbcc",
            "ram_bytes": 0,
            "error": ""
          }
        ]
      },
      "BleStatus": {
        "type": "object",
        "required": [
          "enabled",
          "connected",
          "initialized",
          "restart_required",
          "ram_bytes",
          "name",
          "error",
          "link_count",
          "gap_status",
          "disconnect_reason",
          "pair_status",
          "bond_count",
          "library_code",
          "library_status",
          "recovering",
          "bond_dirty",
          "bond_error",
          "bond_generation"
        ],
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "connected": {
            "type": "boolean"
          },
          "initialized": {
            "type": "boolean"
          },
          "restart_required": {
            "type": "boolean",
            "description": "Fatal stack startup/library failure requires restart. An ordinary pairing rejection is recoverable."
          },
          "ram_bytes": {
            "$ref": "#/components/schemas/UInt32"
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 20,
            "description": "FE0F lamp name: 1..20 UTF-8 bytes. Before BLE initialization the default is PoE RGB."
          },
          "error": {
            "type": "integer",
            "minimum": 0,
            "maximum": 255,
            "description": "Last WCH status or local E0..E7 code encoded as decimal (224..231). Can be nonzero in a successful status response."
          },
          "link_count": {
            "type": "integer",
            "minimum": 0,
            "maximum": 65535
          },
          "gap_status": {
            "type": "integer",
            "minimum": 0,
            "maximum": 255
          },
          "disconnect_reason": {
            "type": "integer",
            "minimum": 0,
            "maximum": 255
          },
          "pair_status": {
            "type": "integer",
            "minimum": 0,
            "maximum": 255
          },
          "bond_count": {
            "type": "integer",
            "minimum": 0,
            "maximum": 255,
            "description": "Stored BLE bonds. Zero advertises the Hue \"no bondings\" flag."
          },
          "library_code": {
            "type": "integer",
            "minimum": 0,
            "maximum": 255,
            "description": "Code of the last WCH library status callback. 7 (LTK request outcome) and 8 (bond table full) are informational; other codes also set error and restart_required."
          },
          "library_status": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Status argument of the last WCH library status callback; for code 7, 1 means no LTK was found and encryption was rejected."
          },
          "recovering": {
            "type": "boolean"
          },
          "bond_dirty": {
            "type": "boolean",
            "description": "RAM bond/name changes await an OFF-only, disconnected flash commit."
          },
          "bond_error": {
            "type": "integer",
            "minimum": 0,
            "maximum": 255
          },
          "bond_generation": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Last verified atomic flash commit, independent of SDK BOND_SAVED events."
          }
        },
        "additionalProperties": false,
        "description": "Existing BLE success object, including all diagnostic fields. GET never initializes the stack. Disabling can retain SDK RAM until reset.",
        "examples": [
          {
            "enabled": false,
            "connected": false,
            "initialized": false,
            "restart_required": false,
            "ram_bytes": 0,
            "name": "PoE RGB",
            "error": 0,
            "link_count": 0,
            "gap_status": 0,
            "disconnect_reason": 0,
            "pair_status": 0,
            "bond_count": 0,
            "library_code": 0,
            "library_status": 0,
            "recovering": false,
            "bond_dirty": false,
            "bond_error": 0,
            "bond_generation": 0
          }
        ]
      },
      "LearnStatus": {
        "type": "object",
        "required": [
          "generation",
          "state",
          "reason",
          "completed",
          "stage",
          "channel",
          "active_generation",
          "active_valid",
          "relearn_needed",
          "phase",
          "point"
        ],
        "properties": {
          "generation": {
            "$ref": "#/components/schemas/UInt32"
          },
          "state": {
            "type": "integer",
            "minimum": 0,
            "maximum": 5,
            "description": "0 unused, 2 running, 3 committed, 4 aborted, 5 complete; 1 is not used."
          },
          "reason": {
            "type": "integer",
            "minimum": 0,
            "maximum": 8,
            "description": "0 OK, 1 stop, 2 protection, 3 budget, 4 deadline, 6 output, 7 rail, 8 context; 5 is not used."
          },
          "completed": {
            "type": "integer",
            "minimum": 0,
            "maximum": 20
          },
          "stage": {
            "type": "integer",
            "minimum": 0,
            "maximum": 3
          },
          "channel": {
            "type": "integer",
            "minimum": 0,
            "maximum": 4
          },
          "active_generation": {
            "$ref": "#/components/schemas/UInt32"
          },
          "active_valid": {
            "$ref": "#/components/schemas/Flag"
          },
          "relearn_needed": {
            "$ref": "#/components/schemas/Flag"
          },
          "phase": {
            "type": "integer",
            "minimum": 0,
            "maximum": 7,
            "description": "0 none, 1 wait OFF, 2 wait stage, 3 OFF baseline, 4 ramp, 5 cell OFF, 6 finished, 7 reserved."
          },
          "point": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10,
            "description": "Measured 10 % steps of the running cell."
          }
        },
        "additionalProperties": false,
        "description": "Autonomous four-stage by five-channel learning status of the single report. Generation 0 means none; a started run replaces the active profile, so active_valid is 0 until commit.",
        "examples": [
          {
            "generation": 1,
            "state": 2,
            "reason": 0,
            "completed": 0,
            "stage": 0,
            "channel": 0,
            "active_generation": 0,
            "active_valid": 0,
            "relearn_needed": 0,
            "phase": 1,
            "point": 0
          }
        ]
      },
      "LearnProfile": {
        "type": "object",
        "required": [
          "generation",
          "completed",
          "stage_mv",
          "current_ma"
        ],
        "properties": {
          "generation": {
            "$ref": "#/components/schemas/UInt32"
          },
          "completed": {
            "type": "integer",
            "minimum": 0,
            "maximum": 20,
            "description": "Finished cells in stage*5+channel order."
          },
          "stage_mv": {
            "type": "array",
            "minItems": 4,
            "maxItems": 4,
            "items": {
              "type": "integer",
              "minimum": 0,
              "maximum": 65535
            },
            "description": "Median OFF rail of each stage in mV, measured at its first cell; 0 until measured."
          },
          "current_ma": {
            "type": "array",
            "minItems": 20,
            "maxItems": 20,
            "items": {
              "type": "array",
              "minItems": 0,
              "maxItems": 10,
              "items": {
                "type": "integer",
                "minimum": 0,
                "maximum": 65534
              }
            },
            "description": "Per cell stage*5+channel (R, G, B, CW, WW) the median current in mA at 10, 20, ... 100 % PWM, never below the previous step. Only measured steps are listed; a shorter list ended at a limit or is still running."
          }
        },
        "additionalProperties": false,
        "description": "Electrical characteristic of one learning generation: 4 stage voltages and 200 currents. 0 % PWM is 0 mA.",
        "examples": [
          {
            "generation": 1,
            "completed": 2,
            "stage_mv": [
              21288,
              0,
              0,
              0
            ],
            "current_ma": [
              [
                16,
                32,
                48,
                64,
                80,
                97,
                113,
                129,
                145,
                161
              ],
              [
                22,
                45,
                67,
                90,
                112,
                135,
                157,
                180,
                202,
                225
              ],
              [],
              [],
              [],
              [],
              [],
              [],
              [],
              [],
              [],
              [],
              [],
              [],
              [],
              [],
              [],
              [],
              [],
              []
            ]
          }
        ]
      },
      "Diagnostics": {
        "type": "object",
        "required": [
          "service_max_us",
          "prepare_max_us",
          "transport_max_us",
          "service_gap_max_us",
          "status_json_max_us",
          "request_max_us",
          "status_gap_max_us",
          "asset_request_max_us",
          "irq_off_max_us",
          "protection_isr_max_us",
          "protection_timing_valid",
          "fault_source",
          "fault_time_us",
          "adc_until_ms",
          "adc_scan_ms",
          "mean_start_ms",
          "mean_sample_ms",
          "aux_sample_ms",
          "mean_epoch",
          "mean_valid",
          "mean_pending",
          "publish_attempts",
          "publish_rejections",
          "publish_max_us",
          "mean_pending_overwrites",
          "mean_boundary_rejections",
          "mean_radio_corrections",
          "mean_wait_max_us",
          "aux_live_count",
          "aux_last_us",
          "aux_max_us",
          "aux_max_ocp_gap_us",
          "fault_phase",
          "fault_gain",
          "fault_channel",
          "fault_elapsed_us",
          "fault_bits",
          "fault_raw",
          "fault_scan_raw",
          "fault_last_x1_raw",
          "fault_reference_raw",
          "fault_threshold_raw",
          "fault_adc_flags",
          "ble_available",
          "ble_initialized",
          "ble_restart_required",
          "ble_error",
          "ble_startup_line",
          "ble_library_code",
          "ble_library_status",
          "ble_snv_writes",
          "ble_snv_unaligned",
          "ble_snv_last_words",
          "ble_snv_tail_words",
          "refusal_count",
          "refusal_step",
          "refusal_bsp",
          "refusal_at_ms",
          "refusal_deadline_ms",
          "refusal_feedback_ms",
          "refusal_scan_ms",
          "refusal_cell",
          "refusal_phase",
          "refusal_r",
          "refusal_g",
          "refusal_b",
          "refusal_cw",
          "refusal_ww"
        ],
        "properties": {
          "service_max_us": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Longest controller service pass since start."
          },
          "prepare_max_us": {
            "$ref": "#/components/schemas/UInt32"
          },
          "transport_max_us": {
            "$ref": "#/components/schemas/UInt32"
          },
          "service_gap_max_us": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Longest gap between two controller service starts, including outer waits."
          },
          "status_json_max_us": {
            "$ref": "#/components/schemas/UInt32"
          },
          "request_max_us": {
            "$ref": "#/components/schemas/UInt32"
          },
          "status_gap_max_us": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Longest gap between controller services inside HTTP status serialization."
          },
          "asset_request_max_us": {
            "$ref": "#/components/schemas/UInt32"
          },
          "irq_off_max_us": {
            "$ref": "#/components/schemas/UInt32"
          },
          "protection_isr_max_us": {
            "$ref": "#/components/schemas/UInt32"
          },
          "protection_timing_valid": {
            "$ref": "#/components/schemas/Flag",
            "description": "1 when irq_off_max_us/protection_isr_max_us come from the instrumented BSP."
          },
          "fault_source": {
            "$ref": "#/components/schemas/UInt32",
            "description": "First latched fault capture: 0 none, 1 other, 2 AWD IRQ, 3 TIM1 OCP, 4 pending AWD at AUX, 5 cached scan OCP at AUX, 6 historical x1 OCP raw value. Retained until restart."
          },
          "fault_time_us": {
            "$ref": "#/components/schemas/UInt32"
          },
          "adc_until_ms": {
            "$ref": "#/components/schemas/UInt32"
          },
          "adc_scan_ms": {
            "$ref": "#/components/schemas/UInt32"
          },
          "mean_start_ms": {
            "$ref": "#/components/schemas/UInt32"
          },
          "mean_sample_ms": {
            "$ref": "#/components/schemas/UInt32"
          },
          "aux_sample_ms": {
            "$ref": "#/components/schemas/UInt32"
          },
          "mean_epoch": {
            "$ref": "#/components/schemas/UInt32"
          },
          "mean_valid": {
            "$ref": "#/components/schemas/Flag"
          },
          "mean_pending": {
            "$ref": "#/components/schemas/Flag"
          },
          "publish_attempts": {
            "$ref": "#/components/schemas/UInt32"
          },
          "publish_rejections": {
            "$ref": "#/components/schemas/UInt32"
          },
          "publish_max_us": {
            "$ref": "#/components/schemas/UInt32"
          },
          "mean_pending_overwrites": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Unpublished candidates replaced by a newer valid DMA boundary since boot; deliberate acquisition resets are excluded."
          },
          "mean_boundary_rejections": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Ambiguous, coalesced or mismatched DMA boundary events since boot; counts events rather than an inferred number of lost blocks."
          },
          "mean_radio_corrections": {
            "type": "integer",
            "minimum": 0,
            "maximum": 4294967295,
            "description": "Mean blocks scaled back since boot because a BLE radio burst lifted every ADC channel by the same factor. Only while the BLE radio is on: within one settled Eco stage a rail rise of 1/256 to 1/20 over the last clean block, lasting at most 20 ms, is divided out of rail and current. No block is delayed or averaged."
          },
          "mean_wait_max_us": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Maximum observed DMA-boundary-to-foreground-attempt wait, in microseconds, including rejected attempts; separate from publish_max_us processing time."
          },
          "aux_live_count": {
            "$ref": "#/components/schemas/UInt32"
          },
          "aux_last_us": {
            "$ref": "#/components/schemas/UInt32"
          },
          "aux_max_us": {
            "$ref": "#/components/schemas/UInt32"
          },
          "aux_max_ocp_gap_us": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Largest diagnostic gap from the last x4 current sample before AUX to the complete new x4 scan; not proof of continuous current monitoring."
          },
          "fault_phase": {
            "$ref": "#/components/schemas/UInt32",
            "description": "AUX phase of the first capture: 0 inactive, 1 x1 configuration, 2 TEMP, 3 VREFINT, 7 x4 configuration/settling, 8 x4 scan restart, 9 publication."
          },
          "fault_gain": {
            "$ref": "#/components/schemas/UInt32"
          },
          "fault_channel": {
            "$ref": "#/components/schemas/UInt32",
            "description": "255 = unknown."
          },
          "fault_elapsed_us": {
            "$ref": "#/components/schemas/UInt32"
          },
          "fault_bits": {
            "$ref": "#/components/schemas/UInt32"
          },
          "fault_raw": {
            "$ref": "#/components/schemas/UInt32"
          },
          "fault_scan_raw": {
            "$ref": "#/components/schemas/UInt32"
          },
          "fault_last_x1_raw": {
            "$ref": "#/components/schemas/UInt32"
          },
          "fault_reference_raw": {
            "$ref": "#/components/schemas/UInt32"
          },
          "fault_threshold_raw": {
            "$ref": "#/components/schemas/UInt32"
          },
          "fault_adc_flags": {
            "$ref": "#/components/schemas/UInt32"
          },
          "ble_available": {
            "$ref": "#/components/schemas/Flag",
            "description": "0 when the image has no BLE stack; all other ble_* fields are then 0."
          },
          "ble_initialized": {
            "$ref": "#/components/schemas/Flag"
          },
          "ble_restart_required": {
            "$ref": "#/components/schemas/Flag"
          },
          "ble_error": {
            "$ref": "#/components/schemas/UInt32"
          },
          "ble_startup_line": {
            "$ref": "#/components/schemas/UInt32"
          },
          "ble_library_code": {
            "$ref": "#/components/schemas/UInt32"
          },
          "ble_library_status": {
            "$ref": "#/components/schemas/UInt32"
          },
          "ble_snv_writes": {
            "$ref": "#/components/schemas/UInt32"
          },
          "ble_snv_unaligned": {
            "$ref": "#/components/schemas/UInt32"
          },
          "ble_snv_last_words": {
            "$ref": "#/components/schemas/UInt32"
          },
          "ble_snv_tail_words": {
            "$ref": "#/components/schemas/UInt32"
          },
          "refusal_count": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Output refusals during learning since start; the refusal_* fields describe the last one."
          },
          "refusal_step": {
            "$ref": "#/components/schemas/UInt32"
          },
          "refusal_bsp": {
            "$ref": "#/components/schemas/UInt32"
          },
          "refusal_at_ms": {
            "$ref": "#/components/schemas/UInt32"
          },
          "refusal_deadline_ms": {
            "$ref": "#/components/schemas/UInt32"
          },
          "refusal_feedback_ms": {
            "$ref": "#/components/schemas/UInt32"
          },
          "refusal_scan_ms": {
            "$ref": "#/components/schemas/UInt32"
          },
          "refusal_cell": {
            "$ref": "#/components/schemas/UInt32"
          },
          "refusal_phase": {
            "$ref": "#/components/schemas/UInt32"
          },
          "refusal_r": {
            "$ref": "#/components/schemas/UInt32"
          },
          "refusal_g": {
            "$ref": "#/components/schemas/UInt32"
          },
          "refusal_b": {
            "$ref": "#/components/schemas/UInt32"
          },
          "refusal_cw": {
            "$ref": "#/components/schemas/UInt32"
          },
          "refusal_ww": {
            "$ref": "#/components/schemas/UInt32"
          }
        },
        "additionalProperties": false,
        "description": "Read-only runtime diagnostics: timing maxima since start, ADC lease/mean state, live auxiliary measurement, first latched fault capture, BLE stack state and the last output refusal during learning. All values are unsigned integers; flags are 0/1."
      },
      "FirmwareUpdate": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "phase",
          "received",
          "total",
          "error"
        ],
        "description": "Recovery loader transfer state. The update ID detects retries; it is not authentication.",
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^([0-9a-f]{16})?$",
            "description": "Lowercase X-Update-Id of the last transfer, empty before the first one."
          },
          "phase": {
            "type": "string",
            "enum": [
              "idle",
              "receiving",
              "ready",
              "failed"
            ]
          },
          "received": {
            "$ref": "#/components/schemas/UInt32"
          },
          "total": {
            "$ref": "#/components/schemas/UInt32"
          },
          "error": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              null,
              "package_rejected",
              "length_mismatch",
              "flash_error",
              "verify_failed",
              "interrupted",
              "aborted"
            ]
          }
        }
      },
      "FirmwareStatus": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "mode",
          "abi",
          "services",
          "version",
          "board_id",
          "app_base",
          "app_max",
          "page_size",
          "app_valid",
          "app_kind",
          "app_size",
          "app_crc",
          "reset_flags",
          "sysclk",
          "mac",
          "boot_generation",
          "hostname",
          "update"
        ],
        "description": "Identity, flash layout and committed image. The app reads the committed metadata; the recovery loader checks the full image CRC.",
        "properties": {
          "mode": {
            "type": "string",
            "enum": [
              "app",
              "recovery"
            ]
          },
          "abi": {
            "type": "integer",
            "const": 3,
            "description": "Flash layout ABI shared by recovery and app."
          },
          "services": {
            "type": "integer",
            "minimum": 0,
            "maximum": 255,
            "description": "Major version of the resident recovery services (export table). Recovery: provided; app: imported (an app of kind 4 runs only with it). 0: none."
          },
          "version": {
            "type": "string",
            "pattern": "^[0-9]{1,3}\\.[0-9]{1,3}\\.[0-9]{1,3}$",
            "description": "Release version MAJOR.MINOR.PATCH of the running image (app or recovery, see mode)."
          },
          "board_id": {
            "$ref": "#/components/schemas/UInt32"
          },
          "app_base": {
            "$ref": "#/components/schemas/UInt32"
          },
          "app_max": {
            "$ref": "#/components/schemas/UInt32"
          },
          "page_size": {
            "type": "integer",
            "const": 256
          },
          "app_valid": {
            "type": "boolean"
          },
          "app_kind": {
            "$ref": "#/components/schemas/UInt32"
          },
          "app_size": {
            "$ref": "#/components/schemas/UInt32"
          },
          "app_crc": {
            "$ref": "#/components/schemas/UInt32"
          },
          "reset_flags": {
            "$ref": "#/components/schemas/UInt32"
          },
          "sysclk": {
            "$ref": "#/components/schemas/UInt32"
          },
          "mac": {
            "type": "string",
            "pattern": "^[0-9a-f]{2}(:[0-9a-f]{2}){5}$"
          },
          "boot_generation": {
            "type": "integer",
            "minimum": 0,
            "maximum": 65535
          },
          "hostname": {
            "type": "string",
            "maxLength": 39,
            "description": "mDNS label without .local; the recovery loader answers under the same name."
          },
          "update": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/FirmwareUpdate"
              }
            ],
            "description": "Always null in the app."
          }
        }
      },
      "LightLayout": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "layout"
        ],
        "properties": {
          "layout": {
            "type": "integer",
            "minimum": 0,
            "maximum": 3,
            "description": "0: five independent lights; 1: RGB; 2: RGB plus CCT; 3: CCT. Configuration only; no output command."
          }
        },
        "examples": [
          {
            "layout": 0
          },
          {
            "layout": 2
          }
        ]
      },
      "WledEnabledRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "enabled"
        ],
        "properties": {
          "enabled": {
            "type": "boolean"
          }
        },
        "description": "Exactly {\"enabled\":true} or {\"enabled\":false}. RAM-only; no light output command."
      },
      "WledStatus": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "enabled",
          "ram_bytes"
        ],
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "ram_bytes": {
            "type": "integer",
            "minimum": 0,
            "description": "Allocated WLED facade state in bytes; zero while disabled."
          }
        },
        "description": "Native switch status. Reading does not allocate. The native HTTP API stays enabled in every state.",
        "examples": [
          {
            "enabled": false,
            "ram_bytes": 0
          }
        ]
      },
      "NetworkDmxDisabledRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "enabled"
        ],
        "properties": {
          "enabled": {
            "type": "boolean",
            "const": false
          }
        },
        "description": "Disable only this receiver. No other keys are accepted. The shared engine is freed and both configurations reset to defaults after the last receiver is disabled."
      },
      "ArtNetEnabledRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "enabled"
        ],
        "properties": {
          "enabled": {
            "type": "boolean",
            "const": true
          },
          "universe": {
            "type": "integer",
            "minimum": 0,
            "maximum": 32767,
            "description": "Art-Net universe. Default 0."
          },
          "start_address": {
            "type": "integer",
            "minimum": 1,
            "maximum": 508,
            "description": "First of five consecutive DMX slots, mapped to R/G/B/CW/WW. Default 1."
          }
        },
        "description": "Enable or explicitly rearm only Art-Net. Omitted universe/start_address retain this receiver's current settings, or defaults if no engine is allocated. Rearm discards its cached sources; a new DMX packet is required."
      },
      "ArtNetRequest": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/NetworkDmxDisabledRequest"
          },
          {
            "$ref": "#/components/schemas/ArtNetEnabledRequest"
          }
        ]
      },
      "ArtNetStatus": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "enabled",
          "universe",
          "start_address",
          "active",
          "blocked",
          "sources",
          "packets",
          "dropped",
          "ram_bytes"
        ],
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "universe": {
            "type": "integer",
            "minimum": 0,
            "maximum": 32767,
            "description": "Art-Net universe. Default 0."
          },
          "start_address": {
            "type": "integer",
            "minimum": 1,
            "maximum": 508,
            "description": "First of five consecutive DMX slots, mapped to R/G/B/CW/WW. Default 1."
          },
          "active": {
            "type": "boolean",
            "description": "This receiver is the selected eligible input protocol. This does not confirm physical light output: an all-zero input is active, and safety/admission can refuse a nonzero scene."
          },
          "blocked": {
            "type": "boolean",
            "description": "This enabled receiver is suspended after manual control, STOP, signal loss or a safety shutdown. An explicit enabled:true PUT rearms only this receiver."
          },
          "sources": {
            "type": "integer",
            "minimum": 0,
            "maximum": 2,
            "description": "Currently retained sources for this receiver."
          },
          "packets": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Saturating ingress count on this enabled port, including discovery and data."
          },
          "dropped": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Saturating malformed/ignored count, including filtered universe, old sequence, preview, unsupported start code, blocked/short data and exhausted sources."
          },
          "ram_bytes": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Allocated shared Art-Net/sACN engine size, not a per-protocol allocation. Can be nonzero while this receiver is disabled; zero after the last receiver is disabled. Static transport bytes and allocator overhead are excluded."
          }
        },
        "description": "Exact native Art-Net settings/status object. GET never allocates, enables, rearms or renews a stream. Configuration and counters are RAM-only; boot and last-disable defaults are disabled, universe 0, start address 1.",
        "examples": [
          {
            "enabled": false,
            "universe": 0,
            "start_address": 1,
            "active": false,
            "blocked": false,
            "sources": 0,
            "packets": 0,
            "dropped": 0,
            "ram_bytes": 0
          }
        ]
      },
      "SacnEnabledRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "enabled"
        ],
        "properties": {
          "enabled": {
            "type": "boolean",
            "const": true
          },
          "universe": {
            "type": "integer",
            "minimum": 1,
            "maximum": 63999,
            "description": "sACN universe. Default 1."
          },
          "start_address": {
            "type": "integer",
            "minimum": 1,
            "maximum": 508,
            "description": "First of five consecutive DMX slots, mapped to R/G/B/CW/WW. Default 1."
          }
        },
        "description": "Enable or explicitly rearm only sACN. Omitted universe/start_address retain this receiver's current settings, or defaults if no engine is allocated. Rearm discards its cached sources; a new DMX packet is required."
      },
      "SacnRequest": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/NetworkDmxDisabledRequest"
          },
          {
            "$ref": "#/components/schemas/SacnEnabledRequest"
          }
        ]
      },
      "SacnStatus": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "enabled",
          "universe",
          "start_address",
          "active",
          "blocked",
          "sources",
          "packets",
          "dropped",
          "ram_bytes"
        ],
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "universe": {
            "type": "integer",
            "minimum": 1,
            "maximum": 63999,
            "description": "sACN universe. Default 1."
          },
          "start_address": {
            "type": "integer",
            "minimum": 1,
            "maximum": 508,
            "description": "First of five consecutive DMX slots, mapped to R/G/B/CW/WW. Default 1."
          },
          "active": {
            "type": "boolean",
            "description": "This receiver is the selected eligible input protocol. This does not confirm physical light output: an all-zero input is active, and safety/admission can refuse a nonzero scene."
          },
          "blocked": {
            "type": "boolean",
            "description": "This enabled receiver is suspended after manual control, STOP, signal loss or a safety shutdown. An explicit enabled:true PUT rearms only this receiver."
          },
          "sources": {
            "type": "integer",
            "minimum": 0,
            "maximum": 2,
            "description": "Currently retained sources for this receiver."
          },
          "packets": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Saturating ingress count on this enabled port, including discovery and data."
          },
          "dropped": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Saturating malformed/ignored count, including filtered universe, old sequence, preview, unsupported start code, blocked/short data and exhausted sources."
          },
          "ram_bytes": {
            "$ref": "#/components/schemas/UInt32",
            "description": "Allocated shared Art-Net/sACN engine size, not a per-protocol allocation. Can be nonzero while this receiver is disabled; zero after the last receiver is disabled. Static transport bytes and allocator overhead are excluded."
          }
        },
        "description": "Exact native sACN settings/status object. GET never allocates, enables, rearms or renews a stream. Configuration and counters are RAM-only; boot and last-disable defaults are disabled, universe 1, start address 1.",
        "examples": [
          {
            "enabled": false,
            "universe": 1,
            "start_address": 1,
            "active": false,
            "blocked": false,
            "sources": 0,
            "packets": 0,
            "dropped": 0,
            "ram_bytes": 0
          }
        ]
      },
      "FactoryResetRequest": {
        "type": "object",
        "required": [
          "confirm"
        ],
        "properties": {
          "confirm": {
            "type": "integer",
            "enum": [
              1
            ],
            "description": "Explicit confirmation; any other value is rejected (400)."
          }
        },
        "additionalProperties": false
      }
    },
    "responses": {
      "Error400": {
        "description": "Malformed or invalid request; no partial change from rejected input.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ApiError"
            },
            "example": {
              "error": "Request rejected; inspect status",
              "code": "invalid_request"
            }
          }
        }
      },
      "Error403": {
        "description": "Host, Origin or absolute request target is not a permitted device authority.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ApiError"
            },
            "example": {
              "error": "Request rejected; inspect status",
              "code": "forbidden"
            }
          }
        }
      },
      "Error404": {
        "description": "Unknown route; obsolete learn/cell has no v1 route.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ApiError"
            },
            "example": {
              "error": "Request rejected; inspect status",
              "code": "not_found"
            }
          }
        }
      },
      "Error405": {
        "description": "Unsupported method for this resource.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ApiError"
            },
            "example": {
              "error": "Request rejected; inspect status",
              "code": "method_not_allowed"
            }
          }
        },
        "headers": {
          "Allow": {
            "description": "Supported methods for this known v1 resource; GET, GET, PUT, or POST as applicable.",
            "schema": {
              "type": "string",
              "enum": [
                "GET",
                "GET, PUT",
                "POST"
              ]
            }
          }
        }
      },
      "Error409": {
        "description": "Current state, generation, protection or concurrent operation rejects the request.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ApiError"
            },
            "example": {
              "error": "Request rejected; inspect status",
              "code": "conflict"
            }
          }
        }
      },
      "Error413": {
        "description": "Body or complete request exceeds its byte limit.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ApiError"
            },
            "example": {
              "error": "Request rejected; inspect status",
              "code": "request_too_large"
            }
          }
        }
      },
      "Error431": {
        "description": "Header block fills the request limit before completion.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ApiError"
            },
            "example": {
              "error": "Request rejected; inspect status",
              "code": "headers_too_large"
            }
          }
        }
      },
      "Error503": {
        "description": "Hardware/configuration/status source unavailable or initialization failed.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ApiError"
            },
            "example": {
              "error": "Request rejected; inspect status",
              "code": "unavailable"
            }
          }
        }
      },
      "Error500": {
        "description": "Internal failure.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ApiError"
            },
            "example": {
              "error": "Request rejected; inspect status",
              "code": "internal_error"
            }
          }
        }
      },
      "DeviceStatusResponse": {
        "description": "Current resource status after successful read or accepted operation.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/DeviceStatus"
            },
            "example": {
              "mvp": 1,
              "now_ms": 1234,
              "deadline_ms": 0,
              "pulse_active": 0,
              "cw_requested": 0,
              "ww_requested": 0,
              "cw_applied": 0,
              "ww_applied": 0,
              "r_requested": 0,
              "g_requested": 0,
              "b_requested": 0,
              "r_applied": 0,
              "g_applied": 0,
              "b_applied": 0,
              "user_led_mw": 5000,
              "effective_led_mw": 5000,
              "measured_led_mw": 0,
              "estimated_poe_input_mw": 0,
              "compliance_led_budget_mw": 23715,
              "overdrive_led_budget_mw": 27900,
              "current_ma": 0,
              "rail_mv": 24400,
              "current_uncal_ma": 0,
              "temperature_mc": 30000,
              "temperature_raw_mc": 30000,
              "temperature_valid": 1,
              "ready": 1,
              "adc_valid": 1,
              "t2p": 1,
              "avg_valid": 1,
              "zero_valid": 1,
              "mean_valid": 1,
              "scene_active": 0,
              "overdrive": 0,
              "auto_eco": 0,
              "eco_settling": 0,
              "cpu_valid": 0,
              "ram_stack_valid": 0,
              "ram_layout_valid": 1,
              "loop_valid": 0,
              "temperature_sample_ms": 1230,
              "adc_sample_ms": 1234,
              "mean_start_ms": 1230,
              "mean_sample_ms": 1234,
              "max_temperature_mc": 50000,
              "limits": 0,
              "faults": 0,
              "bsp_fault": 0,
              "max_current_ma": 1500,
              "protection_led_mw": 30000,
              "avg_current_ma": 0,
              "avg_rail_mv": 24400,
              "avg_led_mw": 0,
              "mean_count": 64,
              "adc_i_raw": 6,
              "adc_v_raw": 2890,
              "peak_i_raw": 6,
              "zero_raw": 6,
              "safety_irq_lag_ms": 0,
              "target_led_mw": 0,
              "max_led_budget_mw": 23715,
              "poe_input_limit_mw": 25500,
              "mean_i_raw": 6,
              "mean_v_raw": 2890,
              "poe_input_estimated": 1,
              "efficiency_permille": 930,
              "eco_stage": 3,
              "eco_requested": 3,
              "cpu_permille": 0,
              "ram_free_bytes": 20000,
              "ram_stack_reserve_bytes": 8192,
              "ram_stack_used_bytes": 0,
              "loop_mean_us": 0,
              "loop_max_us": 0,
              "light_layout": 0,
              "scene_transition_max_ms": 60000
            }
          }
        }
      },
      "PowerStatusResponse": {
        "description": "Current resource status after successful read or accepted operation.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/PowerStatus"
            },
            "example": {
              "user_led_mw": 5000,
              "effective_led_mw": 5000,
              "max_led_mw": 23715,
              "measured_led_mw": 0,
              "measured_valid": true,
              "limiting": false,
              "faults": 0
            }
          }
        }
      },
      "TemperatureStatusResponse": {
        "description": "Current resource status after successful read or accepted operation.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/TemperatureStatus"
            },
            "example": {
              "temperature_mc": 30000,
              "temperature_valid": true,
              "max_temperature_mc": 50000,
              "temperature_hysteresis_mc": 5000,
              "faults": 0
            }
          }
        }
      },
      "MqttStatusResponse": {
        "description": "Current resource status after successful read or accepted operation.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/MqttStatus"
            },
            "example": {
              "enabled": false,
              "connected": false,
              "broker": "",
              "port": 0,
              "username": "",
              "password_set": false,
              "telemetry_interval_s": 0,
              "hostname": "poe-rgb-aabbcc",
              "ram_bytes": 0,
              "error": ""
            }
          }
        }
      },
      "BleStatusResponse": {
        "description": "Current resource status after successful read or accepted operation.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/BleStatus"
            },
            "example": {
              "enabled": false,
              "connected": false,
              "initialized": false,
              "restart_required": false,
              "ram_bytes": 0,
              "name": "PoE RGB",
              "error": 0,
              "link_count": 0,
              "gap_status": 0,
              "disconnect_reason": 0,
              "pair_status": 0,
              "bond_count": 0,
              "library_code": 0,
              "library_status": 0,
              "recovering": false,
              "bond_dirty": false,
              "bond_error": 0,
              "bond_generation": 0
            }
          }
        }
      },
      "LearnStatusResponse": {
        "description": "Current resource status after successful read or accepted operation.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/LearnStatus"
            },
            "example": {
              "generation": 1,
              "state": 2,
              "reason": 0,
              "completed": 0,
              "stage": 0,
              "channel": 0,
              "active_generation": 0,
              "active_valid": 0,
              "relearn_needed": 0,
              "phase": 1,
              "point": 0
            }
          }
        }
      },
      "LearnProfileResponse": {
        "description": "Current resource status after successful read or accepted operation.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/LearnProfile"
            },
            "example": {
              "generation": 1,
              "completed": 2,
              "stage_mv": [
                21288,
                0,
                0,
                0
              ],
              "current_ma": [
                [
                  16,
                  32,
                  48,
                  64,
                  80,
                  97,
                  113,
                  129,
                  145,
                  161
                ],
                [
                  22,
                  45,
                  67,
                  90,
                  112,
                  135,
                  157,
                  180,
                  202,
                  225
                ],
                [],
                [],
                [],
                [],
                [],
                [],
                [],
                [],
                [],
                [],
                [],
                [],
                [],
                [],
                [],
                [],
                [],
                []
              ]
            }
          }
        }
      },
      "DiagnosticsResponse": {
        "description": "Current diagnostics snapshot.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Diagnostics"
            },
            "example": {
              "service_max_us": 812,
              "prepare_max_us": 95,
              "transport_max_us": 640,
              "service_gap_max_us": 9300,
              "status_json_max_us": 4100,
              "request_max_us": 5200,
              "status_gap_max_us": 900,
              "asset_request_max_us": 7600,
              "irq_off_max_us": 14,
              "protection_isr_max_us": 9,
              "protection_timing_valid": 1,
              "fault_source": 0,
              "fault_time_us": 0,
              "adc_until_ms": 123456,
              "adc_scan_ms": 123451,
              "mean_start_ms": 123440,
              "mean_sample_ms": 123448,
              "aux_sample_ms": 123100,
              "mean_epoch": 48211,
              "mean_valid": 1,
              "mean_pending": 0,
              "publish_attempts": 48300,
              "publish_rejections": 89,
              "publish_max_us": 21,
              "mean_pending_overwrites": 12,
              "mean_boundary_rejections": 0,
              "mean_radio_corrections": 0,
              "mean_wait_max_us": 580,
              "aux_live_count": 31,
              "aux_last_us": 350,
              "aux_max_us": 380,
              "aux_max_ocp_gap_us": 130,
              "fault_phase": 0,
              "fault_gain": 0,
              "fault_channel": 255,
              "fault_elapsed_us": 0,
              "fault_bits": 0,
              "fault_raw": 0,
              "fault_scan_raw": 0,
              "fault_last_x1_raw": 0,
              "fault_reference_raw": 0,
              "fault_threshold_raw": 0,
              "fault_adc_flags": 0,
              "ble_available": 1,
              "ble_initialized": 1,
              "ble_restart_required": 0,
              "ble_error": 0,
              "ble_startup_line": 0,
              "ble_library_code": 0,
              "ble_library_status": 0,
              "ble_snv_writes": 3,
              "ble_snv_unaligned": 0,
              "ble_snv_last_words": 36,
              "ble_snv_tail_words": 4,
              "refusal_count": 0,
              "refusal_step": 0,
              "refusal_bsp": 0,
              "refusal_at_ms": 0,
              "refusal_deadline_ms": 0,
              "refusal_feedback_ms": 0,
              "refusal_scan_ms": 0,
              "refusal_cell": 0,
              "refusal_phase": 0,
              "refusal_r": 0,
              "refusal_g": 0,
              "refusal_b": 0,
              "refusal_cw": 0,
              "refusal_ww": 0
            }
          }
        }
      },
      "FirmwareStatusResponse": {
        "description": "Firmware identity and committed image.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/FirmwareStatus"
            },
            "example": {
              "mode": "app",
              "abi": 3,
              "services": 1,
              "version": "0.1.0",
              "board_id": 1347372337,
              "app_base": 134266880,
              "app_max": 372736,
              "page_size": 256,
              "app_valid": true,
              "app_kind": 4,
              "app_size": 291484,
              "app_crc": 1234567890,
              "reset_flags": 0,
              "sysclk": 120000000,
              "mac": "5c:53:10:a1:2b:3c",
              "boot_generation": 40,
              "hostname": "poe-rgb-0752",
              "update": null
            }
          }
        }
      },
      "RecoveryAcceptedResponse": {
        "description": "Outputs are OFF and the restart into the recovery loader is scheduled. The body names the host under which the loader will answer.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/FirmwareStatus"
            },
            "example": {
              "mode": "app",
              "abi": 3,
              "services": 1,
              "version": "0.1.0",
              "board_id": 1347372337,
              "app_base": 134266880,
              "app_max": 372736,
              "page_size": 256,
              "app_valid": true,
              "app_kind": 4,
              "app_size": 291484,
              "app_crc": 1234567890,
              "reset_flags": 0,
              "sysclk": 120000000,
              "mac": "5c:53:10:a1:2b:3c",
              "boot_generation": 40,
              "hostname": "poe-rgb-0752",
              "update": null
            }
          }
        }
      },
      "LightLayoutResponse": {
        "description": "Confirmed channel layout; GET and successful PUT share this exact response.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/LightLayout"
            },
            "example": {
              "layout": 2
            }
          }
        }
      },
      "WledStatusResponse": {
        "description": "Current WLED facade switch status after successful read or update.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/WledStatus"
            },
            "example": {
              "enabled": false,
              "ram_bytes": 0
            }
          }
        }
      },
      "ArtNetStatusResponse": {
        "description": "Current Art-Net settings and shared engine status after a successful read or change.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ArtNetStatus"
            },
            "example": {
              "enabled": false,
              "universe": 0,
              "start_address": 1,
              "active": false,
              "blocked": false,
              "sources": 0,
              "packets": 0,
              "dropped": 0,
              "ram_bytes": 0
            }
          }
        }
      },
      "SacnStatusResponse": {
        "description": "Current sACN settings and shared engine status after a successful read or change.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/SacnStatus"
            },
            "example": {
              "enabled": false,
              "universe": 1,
              "start_address": 1,
              "active": false,
              "blocked": false,
              "sources": 0,
              "packets": 0,
              "dropped": 0,
              "ram_bytes": 0
            }
          }
        }
      }
    },
    "parameters": {
      "Generation": {
        "name": "generation",
        "in": "path",
        "required": true,
        "schema": {
          "$ref": "#/components/schemas/Generation"
        }
      }
    }
  }
}
