homebridge-sony-adcp-projector/config.schema.json

Homebridge accessory to control Sony projectors over ADCP (IP). Exposes a HomeKit Television tile with input sources.

{
  "pluginAlias": "SonyProjector",
  "pluginType": "accessory",
  "singular": true,
  "headerDisplay": "Control your Sony projector over IP using Sony's ADCP protocol. Exposes a HomeKit Television tile with inputs.",
  "schema": {
    "type": "object",
    "properties": {
      "name": {
        "title": "Accessory Name",
        "type": "string",
        "default": "Sony Projector",
        "required": false
      },
      "ip": {
        "title": "Projector IP Address",
        "type": "string",
        "format": "ipv4",
        "placeholder": "192.168.1.101",
        "required": true,
        "description": "Set a DHCP reservation for reliability."
      },
      "adcpPort": {
        "title": "ADCP Port",
        "type": "integer",
        "default": 53595,
        "placeholder": "53595",
        "required": false,
        "description": "TCP port for ADCP (default 53595)."
      },
      "useAuth": {
        "title": "Requires Authentication",
        "type": "boolean",
        "default": false,
        "required": false,
        "description": "Enable only if ADCP ▶︎ Requires Authentication is ON in the projector web UI."
      },
      "password": {
        "title": "ADCP Password",
        "type": "string",
        "required": false,
        "description": "Used to compute the SHA-256 response to the projector's nonce when ADCP authentication is enabled.",
        "condition": { "functionBody": "return model.useAuth === true;" }
      },
      "timeout": {
        "title": "Timeout (seconds)",
        "type": "integer",
        "default": 5,
        "minimum": 1,
        "maximum": 60,
        "required": false,
        "description": "How long to wait for projector replies before failing."
      },
      "inputs": {
        "title": "Input Sources",
        "type": "array",
        "description": "Define inputs to appear in the Home app. Each input must have a unique Identifier.",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "title": "Identifier",
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 1,
              "description": "Numeric ID used by HomeKit (1..50). Must be unique across inputs."
            },
            "name": {
              "title": "Display Name",
              "type": "string",
              "default": "HDMI 1"
            },
            "adcp": {
              "title": "ADCP Source Key",
              "type": "string",
              "default": "hdmi1",
              "oneOf": [
                { "title": "HDMI 1", "enum": ["hdmi1"] },
                { "title": "HDMI 2", "enum": ["hdmi2"] },
                { "title": "HDMI 3", "enum": ["hdmi3"] },
                { "title": "HDMI 4", "enum": ["hdmi4"] },
                { "title": "Custom (enter manually)", "enum": [""] }
              ],
              "description": "ADCP input token (e.g., hdmi1, hdmi2). If 'Custom', replace with the exact ADCP value supported by your model."
            }
          },
          "required": ["id", "name", "adcp"]
        },
        "default": [
          { "id": 1, "name": "HDMI 1", "adcp": "hdmi1" },
          { "id": 2, "name": "HDMI 2", "adcp": "hdmi2" }
        ]
      },
      "staticModel": {
        "title": "Static Model (optional)",
        "type": "string",
        "required": false,
        "description": "If set, this value is used for the Model characteristic instead of querying the projector at startup."
      },
      "staticSerial": {
        "title": "Static Serial (optional)",
        "type": "string",
        "required": false,
        "description": "If set, this value is used for the Serial Number characteristic instead of querying the projector at startup."
      },
      "logging": {
        "title": "Logging Level",
        "type": "string",
        "default": "standard",
        "oneOf": [
          { "title": "None", "enum": ["none"] },
          { "title": "Standard", "enum": ["standard"] },
          { "title": "Debug", "enum": ["debug"] }
        ],
        "required": false,
        "description": "Controls verbosity of plugin logs."
      }
    },
    "required": ["ip"]
  },
  "layout": [
    {
      "type": "fieldset",
      "title": "Connection",
      "items": ["name", "ip", "adcpPort", "useAuth", "password", "timeout"]
    },
    {
      "type": "fieldset",
      "title": "Inputs",
      "items": ["inputs"]
    },
    {
      "type": "fieldset",
      "title": "Device Info (optional)",
      "items": ["staticModel", "staticSerial"]
    },
    {
      "type": "fieldset",
      "title": "Advanced",
      "items": ["logging"]
    }
  ]
}