{
  "format": 1,
  "terms": {
    "risk": {
      "read": {
        "meaning": "Nothing changes. The value is only read.",
        "does": "It looks, and tells you."
      },
      "reversible": {
        "meaning": "Changes take effect at once, can be undone at once, and cannot stop you using the machine.",
        "does": "It makes the change, and can put it back."
      },
      "guarded": {
        "meaning": "Could get in the way of using the machine, so the change is reverted unless you confirm it within a few seconds.",
        "does": "It makes the change, then asks you to keep it."
      },
      "gated": {
        "meaning": "Cannot be undone, or needs a physical step. Nothing happens until you approve that exact action, and a step that needs your hands stays yours.",
        "does": "It gets everything ready and asks first. Nothing happens until you say yes."
      }
    },
    "status": {
      "tested": {
        "meaning": "Someone exercised this through the named adapter on that platform."
      },
      "observed": {
        "meaning": "Seen working or present on a real device, but not yet through the adapter."
      },
      "imported": {
        "meaning": "Taken from another project's data. Nobody here has tried it."
      },
      "unverified": {
        "meaning": "Documented somewhere. Nobody here has tried it."
      }
    },
    "privacy": {
      "open": {
        "meaning": "The value can be passed on as it is."
      },
      "aggregate": {
        "meaning": "Only counts and coarse states may leave the adapter, never the raw stream."
      },
      "presence": {
        "meaning": "Only whether it is in use or present may leave the adapter, never the content."
      }
    },
    "kind": {
      "reading": {
        "meaning": "A value you can read."
      },
      "event": {
        "meaning": "A stream of things that happen."
      },
      "control": {
        "meaning": "A value you can set."
      },
      "action": {
        "meaning": "Something you can trigger once."
      }
    }
  },
  "vocabulary": {
    "identity.firmware": {
      "kind": "reading",
      "value": "string",
      "summary": "Firmware version or layout identifier the device reports.",
      "min_risk": "read"
    },
    "keys.position_events": {
      "kind": "event",
      "value": "key position, down or up",
      "summary": "Every key press and release, by physical position.",
      "min_risk": "read",
      "privacy": "aggregate",
      "ask": "Let me answer my agent by pressing a spare key.",
      "example": "spare key pressed"
    },
    "keys.layer": {
      "kind": "event",
      "value": "layer number",
      "summary": "The active keymap layer, reported when it changes.",
      "min_risk": "read"
    },
    "keys.layer_set": {
      "kind": "control",
      "value": "layer number",
      "summary": "Switch the active keymap layer from the host.",
      "min_risk": "guarded",
      "harm": "Every key suddenly types something else, including the keys you would use to switch back."
    },
    "light.per_key": {
      "kind": "control",
      "value": "rgb per key",
      "summary": "Set the colour of an individual key.",
      "min_risk": "reversible",
      "ask": "Light up a key when my agent needs me.",
      "example": "amber",
      "example_before": "off",
      "swatch": "#ffa000"
    },
    "light.global": {
      "kind": "control",
      "value": "rgb",
      "summary": "Set every light on the device to one colour, or hand lighting back to the firmware.",
      "min_risk": "reversible",
      "ask": "Glow amber whenever an agent is waiting on me.",
      "swatch": "#ffa000",
      "example": "amber",
      "example_before": "off"
    },
    "light.status": {
      "kind": "control",
      "value": "on or off per indicator",
      "summary": "Switch the device's separate indicator lights.",
      "min_risk": "reversible"
    },
    "firmware.flash": {
      "kind": "action",
      "value": "firmware image",
      "summary": "Replace the device's firmware.",
      "min_risk": "gated",
      "ask": "Update its software.",
      "example": "updated",
      "harm": "If an update fails part-way, the device may not start again."
    },
    "battery.level": {
      "kind": "reading",
      "value": "percent",
      "summary": "Charge remaining.",
      "min_risk": "read",
      "ask": "Put it on my keyboard when this is about to die.",
      "example": "20%"
    },
    "battery.charging": {
      "kind": "reading",
      "value": "boolean",
      "summary": "Whether the battery is charging.",
      "min_risk": "read"
    },
    "battery.cycles": {
      "kind": "reading",
      "value": "count",
      "summary": "Charge cycles so far.",
      "min_risk": "read"
    },
    "battery.health": {
      "kind": "reading",
      "value": "percent",
      "summary": "Capacity now, relative to when the battery was new.",
      "min_risk": "read",
      "ask": "Is this battery worn enough to replace?",
      "example": "92%"
    },
    "storage.health": {
      "kind": "reading",
      "value": "status",
      "summary": "The drive's own health verdict.",
      "min_risk": "read",
      "ask": "Check the drive's reported health before this backup.",
      "example": "healthy"
    },
    "thermal.pressure": {
      "kind": "reading",
      "value": "level",
      "summary": "Whether the system is limiting performance because of heat.",
      "min_risk": "read",
      "ask": "Is heat slowing my computer down right now?",
      "example": "no"
    },
    "audio.output_volume": {
      "kind": "control",
      "value": "percent",
      "summary": "Output volume.",
      "min_risk": "reversible",
      "ask": "Drop the volume whenever an agent needs me.",
      "example": "30%",
      "example_before": "50%"
    },
    "pointer.dpi": {
      "kind": "control",
      "value": "dots per inch",
      "summary": "Pointer sensitivity.",
      "min_risk": "guarded",
      "ask": "Slow the pointer right down while I draw this.",
      "harm": "A pointer that is suddenly far too fast or too slow can be too hard to steer to undo it.",
      "example": "slow",
      "example_before": "normal"
    },
    "pointer.buttons": {
      "kind": "control",
      "value": "button to software",
      "summary": "Send a button's presses to software instead of its built-in action.",
      "min_risk": "guarded",
      "ask": "Make the side button mute my microphone.",
      "example": "mutes the mic",
      "example_before": "goes back",
      "harm": "A button stops doing what your hand expects, and it may be the one you would undo it with."
    },
    "pointer.host": {
      "kind": "control",
      "value": "host number",
      "summary": "Move the device to another paired computer.",
      "min_risk": "gated",
      "harm": "The device leaves this computer, and nothing here can reach it to bring it back."
    },
    "scroll.mode": {
      "kind": "control",
      "value": "ratchet or free-spin",
      "summary": "How the scroll wheel behaves.",
      "min_risk": "reversible",
      "ask": "Let the wheel spin freely while I read this long file.",
      "example": "free-spin",
      "example_before": "ratchet"
    },
    "display.input": {
      "kind": "control",
      "value": "input source",
      "summary": "Which video input the display shows.",
      "min_risk": "guarded",
      "ask": "Switch the screen to my other computer.",
      "example": "other computer",
      "example_before": "this computer",
      "harm": "The picture leaves the computer that asked, so you cannot see what you are doing to switch back."
    },
    "display.brightness": {
      "kind": "control",
      "value": "percent",
      "summary": "Display brightness.",
      "min_risk": "reversible",
      "ask": "Dim the screen at eight every evening.",
      "example": "40%",
      "example_before": "80%"
    },
    "media.playing": {
      "kind": "reading",
      "value": "playing or idle",
      "summary": "Whether something is playing.",
      "min_risk": "read",
      "privacy": "presence",
      "ask": "Is anything still playing in the other room?",
      "example": "yes"
    },
    "climate.temperature": {
      "kind": "reading",
      "value": "degrees",
      "summary": "The temperature the device measures.",
      "min_risk": "read"
    },
    "climate.target": {
      "kind": "control",
      "value": "degrees",
      "summary": "The temperature the device aims for.",
      "min_risk": "reversible",
      "ask": "Make it cooler in here.",
      "example": "21\u00b0",
      "example_before": "24\u00b0"
    },
    "power.switch": {
      "kind": "control",
      "value": "on or off",
      "summary": "Switch the device itself on or off.",
      "min_risk": "reversible",
      "ask": "Switch it off. I am heading out.",
      "example": "off",
      "example_before": "on"
    },
    "power.outlet": {
      "kind": "control",
      "value": "on or off",
      "summary": "Switch power to whatever is plugged into the device.",
      "min_risk": "gated",
      "ask": "Turn off the plug by my desk.",
      "example": "off",
      "example_before": "on",
      "harm": "Whatever is plugged in loses power at once. It may be a lamp. It may be a computer, a fridge or a server."
    },
    "light.brightness": {
      "kind": "control",
      "value": "percent",
      "summary": "How bright a light is.",
      "min_risk": "reversible",
      "ask": "Dim the lights for the film.",
      "example": "30%",
      "example_before": "100%"
    },
    "access.unlock": {
      "kind": "action",
      "value": "none",
      "summary": "Unlock a door.",
      "min_risk": "gated",
      "ask": "Unlock the front door.",
      "example": "unlocked",
      "harm": "The door stays open to anyone until somebody locks it again."
    }
  },
  "adapters": {
    "oryx-hid": {
      "summary": "ZSA keyboards over ZSA's published raw-HID protocol.",
      "platforms": [
        "macos",
        "linux",
        "windows"
      ],
      "status": "implemented",
      "implementation": "src/device/oryx.rs",
      "params": [],
      "notes": "Only one program can hold the channel, so the vendor's own app must be closed. Run on macOS only so far."
    },
    "hidpp": {
      "summary": "Logitech devices over HID++ 2.0.",
      "platforms": [
        "macos",
        "linux",
        "windows"
      ],
      "status": "implemented",
      "implementation": "src/hidpp.rs",
      "params": [
        "feature"
      ],
      "notes": "Reaches devices connected directly over Bluetooth, not ones behind a USB receiver. Works for battery level, pointer speed and scroll-wheel mode; reads which host is in use. On macOS the program needs Input Monitoring permission. Run on macOS only so far."
    },
    "macos-system": {
      "summary": "What macOS already reports about a device: power, storage, audio, thermal state, Bluetooth, Thunderbolt, USB and display details.",
      "platforms": [
        "macos"
      ],
      "status": "implemented",
      "implementation": "src/system.rs",
      "params": [
        "source",
        "field"
      ],
      "notes": "A card names a source (power, bluetooth, thunderbolt, usb, displays, storage, thermal or audio) and a field, and the adapter finds that field in what macOS reports about the device. A new card for something macOS already reports needs no new code. Serial numbers and addresses are never passed on."
    },
    "ddc-ci": {
      "summary": "A display's own controls, over the video cable.",
      "platforms": [
        "macos",
        "linux"
      ],
      "status": "implemented",
      "implementation": "src/ddc.rs",
      "params": [
        "vcp"
      ],
      "notes": "Uses m1ddc on Apple Silicon or ddcutil on Linux. Intel Mac and Windows backends are not implemented. Targets the helper's default external display; general multi-monitor target routing is not implemented. Displays answer unreliably through docks, so every reading is taken twice and every change is confirmed. Run on macOS only so far.",
      "tool": [
        {
          "platform": "macos",
          "arches": [
            "aarch64"
          ],
          "binary": "m1ddc",
          "packages": {
            "brew": "m1ddc"
          },
          "note": "Needs an Apple Silicon Mac and a supported display connection. Other display apps may also write brightness; choose one owner for that setting."
        },
        {
          "platform": "linux",
          "arches": [],
          "binary": "ddcutil",
          "packages": {
            "apt-get": "ddcutil",
            "dnf": "ddcutil",
            "pacman": "ddcutil",
            "zypper": "ddcutil",
            "apk": "ddcutil"
          },
          "note": "Installing the package alone may not give access: the i2c-dev module and I2C device permissions must be configured by a person. Linux hardware is not tested yet."
        }
      ]
    },
    "mdns": {
      "summary": "Facts a device announces about itself on the local network.",
      "platforms": [
        "macos",
        "linux",
        "windows"
      ],
      "status": "planned",
      "params": [
        "service",
        "field"
      ],
      "notes": "It only listens. Announcements can say what a device is doing, so a card marks those readings as presence only."
    },
    "home-assistant": {
      "summary": "Anything Home Assistant controls, reached through a Home Assistant server you already run.",
      "platforms": [
        "macos",
        "linux",
        "windows"
      ],
      "status": "planned",
      "params": [],
      "notes": "Home Assistant finds, pairs and talks to the device. Hardpoint adds the label and the approval. Not written yet."
    },
    "fwupd": {
      "summary": "Firmware updates through fwupd, the firmware service on Linux.",
      "platforms": [
        "linux"
      ],
      "status": "planned",
      "params": [],
      "notes": "fwupd already knows how to update thousands of devices. Hardpoint asks first, shows the exact version, and records the result. Not written yet."
    },
    "manual": {
      "summary": "A person performs the step. The daemon only explains what to do.",
      "platforms": [
        "macos",
        "linux",
        "windows"
      ],
      "status": "implemented",
      "params": [],
      "notes": "Used where only a person can do it, such as an update that only the maker's own app can write."
    }
  },
  "identities": {
    "format": 1,
    "makers": {
      "apple": {
        "name": "Apple",
        "aliases": [
          "Apple Inc.",
          "Apple Computer, Inc."
        ]
      },
      "bose": {
        "name": "Bose",
        "aliases": [
          "Bose Corporation"
        ]
      },
      "caldigit": {
        "name": "CalDigit",
        "aliases": [
          "CalDigit, Inc.",
          "CalDigit Inc."
        ]
      },
      "ge": {
        "name": "GE Appliances",
        "aliases": [
          "GE",
          "GE Appliances, a Haier company"
        ]
      },
      "google": {
        "name": "Google",
        "aliases": [
          "Google Inc.",
          "Google LLC"
        ]
      },
      "home-assistant": {
        "name": "Home Assistant",
        "aliases": [
          "HomeAssistant"
        ]
      },
      "lg": {
        "name": "LG",
        "aliases": [
          "LG Electronics",
          "LG Electronics Inc."
        ]
      },
      "logitech": {
        "name": "Logitech",
        "aliases": [
          "Logitech Inc.",
          "Logitech, Inc."
        ]
      },
      "samsung": {
        "name": "Samsung",
        "aliases": [
          "Samsung Electronics",
          "Samsung Electronics Co., Ltd."
        ]
      },
      "seagate": {
        "name": "Seagate",
        "aliases": [
          "Seagate Technology",
          "Seagate Technology LLC"
        ]
      },
      "western-digital": {
        "name": "Western Digital",
        "aliases": [
          "WD",
          "WDC",
          "Western Digital Technologies, Inc.",
          "Western Digital Corporation"
        ]
      },
      "zsa": {
        "name": "ZSA",
        "aliases": [
          "ZSA Technology Labs",
          "ZSA Technology Labs, Inc."
        ]
      }
    },
    "categories": {
      "keyboard": {
        "label": "Keyboard",
        "scene": "keyboard",
        "icon": "keyboard",
        "aliases": []
      },
      "mouse": {
        "label": "Mouse",
        "scene": "mouse",
        "icon": "mouse",
        "aliases": [
          "pointing device"
        ]
      },
      "laptop": {
        "label": "Laptop",
        "scene": "laptop",
        "icon": "laptop",
        "aliases": [
          "notebook"
        ]
      },
      "desktop": {
        "label": "Desktop computer",
        "scene": "computer",
        "icon": "desktop",
        "aliases": [
          "desktop computer"
        ]
      },
      "display": {
        "label": "Monitor",
        "scene": "screen",
        "icon": "display",
        "aliases": [
          "monitor",
          "screen"
        ]
      },
      "dock": {
        "label": "Dock",
        "scene": "dock",
        "icon": "dock",
        "aliases": [
          "docking station"
        ]
      },
      "audio": {
        "label": "Audio device",
        "scene": "audio device",
        "icon": "audio",
        "icons": [
          "earbuds"
        ],
        "aliases": [
          "headphones",
          "earbuds",
          "headset"
        ],
        "alias_icons": {
          "earbuds": "earbuds"
        }
      },
      "cooling": {
        "label": "Cooling device",
        "scene": "cooling device",
        "icon": "cooling",
        "aliases": [
          "fan"
        ]
      },
      "lighting": {
        "label": "Light",
        "scene": "light",
        "icon": "lighting",
        "aliases": [
          "light",
          "lamp"
        ]
      },
      "storage": {
        "label": "Storage",
        "scene": "external drive",
        "icon": "storage",
        "aliases": [
          "drive",
          "external drive",
          "hard drive",
          "ssd"
        ]
      },
      "card-reader": {
        "label": "Card reader",
        "scene": "card reader",
        "icon": "card-reader",
        "aliases": [
          "memory card reader",
          "sd card reader"
        ]
      },
      "television": {
        "label": "Television",
        "scene": "TV",
        "icon": "television",
        "aliases": [
          "tv"
        ]
      },
      "media": {
        "label": "Media player",
        "scene": "media player",
        "icon": "media",
        "aliases": [
          "media player",
          "streaming device"
        ]
      },
      "speaker": {
        "label": "Speaker",
        "scene": "speaker",
        "icon": "speaker",
        "aliases": [
          "loudspeaker"
        ]
      },
      "plug": {
        "label": "Outlet / smart plug",
        "scene": "smart plug",
        "icon": "plug",
        "aliases": [
          "outlet",
          "smart plug"
        ]
      },
      "climate": {
        "label": "Climate control",
        "scene": "climate control",
        "icon": "climate",
        "aliases": [
          "air conditioner",
          "climate control"
        ]
      },
      "hub": {
        "label": "Hub",
        "scene": "hub",
        "icon": "hub",
        "aliases": []
      },
      "sensor": {
        "label": "Sensor",
        "scene": "sensor",
        "icon": "sensor",
        "aliases": []
      },
      "lock": {
        "label": "Lock",
        "scene": "door lock",
        "icon": "lock",
        "aliases": [
          "door lock"
        ]
      },
      "camera": {
        "label": "Camera",
        "scene": "camera",
        "icon": "camera",
        "aliases": [
          "webcam"
        ]
      },
      "other": {
        "label": "Other device",
        "scene": "device",
        "icon": "other",
        "aliases": [
          "other device"
        ]
      }
    },
    "identity": {
      "model": {
        "label": "Model match",
        "meaning": "A named public model or model identifier; this does not verify every configuration or operation."
      },
      "family": {
        "label": "Family match",
        "meaning": "The family is identified, but the exact retail model, generation, size or configuration is not established."
      },
      "class": {
        "label": "Class card",
        "meaning": "An integration entity class, not a physical manufacturer/model or a promise that its adapter works."
      }
    }
  },
  "devices": [
    {
      "card": 1,
      "device": {
        "id": "apple/airpods-pro-200e",
        "vendor": "Apple",
        "name": "AirPods Pro",
        "identity": "family",
        "icon": "earbuds",
        "kind": "audio",
        "summary": "AirPods Pro earbuds reporting Bluetooth product ID 0x200e. The family is identified; the generation and charging-case variant are not established by this card. Check the public A-model number before narrowing the identity.",
        "links": [
          "https://support.apple.com/en-us/109525"
        ]
      },
      "sources": [
        {
          "title": "Apple: identify AirPods and their charging case by public model number",
          "url": "https://support.apple.com/en-us/109525"
        }
      ],
      "match": [
        {
          "bus": "bluetooth",
          "vendor_id": 76,
          "product_id": 8206
        }
      ],
      "capability": [
        {
          "id": "identity.firmware",
          "adapter": "macos-system",
          "risk": "read",
          "params": {
            "source": "bluetooth",
            "field": "firmware_version"
          },
          "verification": [
            {
              "status": "tested",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-15",
              "note": "Read through the adapter."
            },
            {
              "status": "observed",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-14",
              "note": "macOS reports a version for the paired earbuds, even when they are not connected. Read by hand."
            }
          ]
        },
        {
          "id": "battery.level",
          "adapter": "macos-system",
          "risk": "read",
          "params": {
            "source": "bluetooth",
            "field": "battery_level"
          },
          "note": "macOS reports separate levels for each earbud and the case while they are connected.",
          "verification": [
            {
              "status": "unverified",
              "platform": "macos",
              "note": "The earbuds were not connected when this card was written."
            }
          ]
        }
      ]
    },
    {
      "card": 1,
      "device": {
        "id": "apple/macbook-pro-mac16-6",
        "vendor": "Apple",
        "name": "MacBook Pro (14-inch, 2024)",
        "identity": "model",
        "aliases": [
          "Mac16,6"
        ],
        "kind": "laptop",
        "summary": "14-inch MacBook Pro from the 2024 M4 Pro / M4 Max range, matched by the public Mac16,6 model identifier. The model card does not identify a unit's memory, storage or other configured options.",
        "links": [
          "https://support.apple.com/en-us/108052",
          "https://support.apple.com/en-us/121553"
        ]
      },
      "sources": [
        {
          "title": "Apple: identify your MacBook Pro model (Mac16,6 / Mac16,8)",
          "url": "https://support.apple.com/en-us/108052"
        },
        {
          "title": "Apple: MacBook Pro (14-inch, M4 Pro or M4 Max, 2024) specifications",
          "url": "https://support.apple.com/en-us/121553"
        }
      ],
      "match": [
        {
          "bus": "builtin",
          "model": "Mac16,6"
        }
      ],
      "capability": [
        {
          "id": "battery.level",
          "adapter": "macos-system",
          "risk": "read",
          "params": {
            "source": "power",
            "field": "state_of_charge"
          },
          "verification": [
            {
              "status": "tested",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-15",
              "note": "Read through the adapter."
            },
            {
              "status": "observed",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-13",
              "note": "Read from the system by hand. The adapter is not written yet."
            }
          ]
        },
        {
          "id": "battery.charging",
          "adapter": "macos-system",
          "risk": "read",
          "params": {
            "source": "power",
            "field": "is_charging"
          },
          "verification": [
            {
              "status": "tested",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-15",
              "note": "Read through the adapter."
            },
            {
              "status": "observed",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-13",
              "note": "Read from the system by hand. The adapter is not written yet."
            }
          ]
        },
        {
          "id": "battery.cycles",
          "adapter": "macos-system",
          "risk": "read",
          "params": {
            "source": "power",
            "field": "cycle_count"
          },
          "verification": [
            {
              "status": "tested",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-15",
              "note": "Read through the adapter."
            },
            {
              "status": "observed",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-13",
              "note": "Read from the system by hand. The adapter is not written yet."
            }
          ]
        },
        {
          "id": "battery.health",
          "adapter": "macos-system",
          "risk": "read",
          "params": {
            "source": "power",
            "field": "maximum_capacity"
          },
          "verification": [
            {
              "status": "tested",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-15",
              "note": "Read through the adapter."
            },
            {
              "status": "observed",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-13",
              "note": "Read from the system by hand. The adapter is not written yet."
            }
          ]
        },
        {
          "id": "storage.health",
          "adapter": "macos-system",
          "risk": "read",
          "params": {
            "source": "storage",
            "field": "smart_status"
          },
          "verification": [
            {
              "status": "tested",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-15",
              "note": "Read through the adapter."
            },
            {
              "status": "observed",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-13",
              "note": "Read from the system by hand. The adapter is not written yet."
            }
          ]
        },
        {
          "id": "thermal.pressure",
          "adapter": "macos-system",
          "risk": "read",
          "params": {
            "source": "thermal",
            "field": "warning_level"
          },
          "note": "macOS exposes a coarse warning level without special permission. Individual temperatures and fan speeds need elevated access.",
          "verification": [
            {
              "status": "tested",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-15",
              "note": "Read through the adapter."
            },
            {
              "status": "observed",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-13",
              "note": "Read from the system by hand. The adapter is not written yet."
            }
          ]
        },
        {
          "id": "audio.output_volume",
          "adapter": "macos-system",
          "risk": "reversible",
          "params": {
            "source": "audio",
            "field": "output_volume"
          },
          "range": [
            0,
            100
          ],
          "verification": [
            {
              "status": "tested",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-15",
              "note": "Read, changed and put back through the gatekeeper."
            },
            {
              "status": "observed",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-13",
              "note": "The current value was read. Setting it was not exercised."
            }
          ]
        }
      ]
    },
    {
      "card": 1,
      "device": {
        "id": "bose/nc-700",
        "vendor": "Bose",
        "name": "Noise Cancelling Headphones 700",
        "identity": "model",
        "aliases": [
          "NC 700",
          "Bose 700"
        ],
        "kind": "audio",
        "summary": "Wireless over-ear headphones.",
        "links": [
          "https://www.bose.com/pressroom/bose-new-era-headphones"
        ]
      },
      "sources": [
        {
          "title": "Bose: introducing Noise Cancelling Headphones 700",
          "url": "https://www.bose.com/pressroom/bose-new-era-headphones"
        }
      ],
      "match": [
        {
          "bus": "bluetooth",
          "vendor_id": 158,
          "product_id": 16420
        }
      ],
      "capability": [
        {
          "id": "identity.firmware",
          "adapter": "macos-system",
          "risk": "read",
          "params": {
            "source": "bluetooth",
            "field": "firmware_version"
          },
          "verification": [
            {
              "status": "tested",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-15",
              "note": "Read through the adapter."
            },
            {
              "status": "observed",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-14",
              "note": "macOS reports a version for the paired headphones, even when they are not connected. Read by hand."
            }
          ]
        },
        {
          "id": "battery.level",
          "adapter": "macos-system",
          "risk": "read",
          "params": {
            "source": "bluetooth",
            "field": "battery_level"
          },
          "verification": [
            {
              "status": "unverified",
              "platform": "macos",
              "note": "The headphones were not connected when this card was written."
            }
          ]
        }
      ]
    },
    {
      "card": 1,
      "device": {
        "id": "caldigit/ts3-plus",
        "vendor": "CalDigit",
        "name": "TS3 Plus",
        "identity": "model",
        "aliases": [
          "Thunderbolt Station 3 Plus"
        ],
        "kind": "dock",
        "summary": "Thunderbolt 3 dock with display, USB, audio and network ports.",
        "links": [
          "https://www.caldigit.com/ts3-plus/"
        ]
      },
      "sources": [
        {
          "title": "CalDigit: TS3 Plus Thunderbolt 3 dock",
          "url": "https://www.caldigit.com/ts3-plus/"
        }
      ],
      "match": [
        {
          "bus": "usb",
          "vendor_id": 8584,
          "product_id": 25907
        }
      ],
      "capability": [
        {
          "id": "identity.firmware",
          "adapter": "macos-system",
          "risk": "read",
          "params": {
            "source": "thunderbolt",
            "field": "switch_version"
          },
          "verification": [
            {
              "status": "tested",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-15",
              "note": "Read through the adapter."
            },
            {
              "status": "observed",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-14",
              "note": "macOS reports a version for the dock. Read by hand; the adapter is not written yet."
            }
          ]
        }
      ]
    },
    {
      "card": 1,
      "device": {
        "id": "ge/window-ac",
        "vendor": "GE Appliances",
        "name": "Window air conditioner",
        "identity": "family",
        "aliases": [
          "Window AC"
        ],
        "kind": "climate",
        "summary": "Window air-conditioner family advertised as Window AC. That announcement does not establish the exact retail model or a working control route. GE says it discontinued HomeKit support; a legacy announcement is not proof of current compatibility.",
        "links": [
          "https://products.geappliances.com/appliance/gea-support-search-content?contentId=37108"
        ]
      },
      "requires": [
        {
          "platform": "any",
          "what": "Confirm the public model and its actual integration route. The maker's discontinued HomeKit support must not be inferred from an announcement alone."
        },
        {
          "platform": "any",
          "what": "The air conditioner added to a Home Assistant server",
          "note": "Home Assistant pairs with it as a HomeKit device, using the setup code on the unit."
        }
      ],
      "sources": [
        {
          "title": "GE Appliances: current smart-air-conditioner / HomeKit support notice",
          "url": "https://products.geappliances.com/appliance/gea-support-search-content?contentId=37108"
        },
        {
          "title": "Home Assistant: climate devices",
          "url": "https://www.home-assistant.io/integrations/climate/"
        }
      ],
      "match": [
        {
          "bus": "network",
          "service": "_hap._tcp",
          "model": "Window AC"
        }
      ],
      "capability": [
        {
          "id": "climate.temperature",
          "adapter": "home-assistant",
          "risk": "read",
          "verification": [
            {
              "status": "unverified",
              "platform": "macos",
              "note": "Home Assistant offers this for an air conditioner. The unit was seen on the network but not added to Home Assistant, so nothing was read."
            }
          ]
        },
        {
          "id": "climate.target",
          "adapter": "home-assistant",
          "risk": "reversible",
          "verification": [
            {
              "status": "unverified",
              "platform": "macos",
              "note": "Home Assistant offers this for an air conditioner. Not tried."
            }
          ]
        },
        {
          "id": "power.switch",
          "adapter": "home-assistant",
          "risk": "reversible",
          "verification": [
            {
              "status": "unverified",
              "platform": "macos",
              "note": "Home Assistant offers this for an air conditioner. Not tried."
            }
          ]
        }
      ]
    },
    {
      "card": 1,
      "device": {
        "id": "google/chromecast",
        "vendor": "Google",
        "name": "Chromecast",
        "identity": "family",
        "kind": "media",
        "summary": "Google Cast media-player family advertised as Chromecast. The announcement does not establish its generation, enclosure shape or resolution; do not assume a stick-shaped device or a particular video specification.",
        "links": [
          "https://support.google.com/chromecast/answer/3046409?hl=en"
        ]
      },
      "sources": [
        {
          "title": "Google: Chromecast and Google TV Streamer specifications (models differ)",
          "url": "https://support.google.com/chromecast/answer/3046409?hl=en"
        },
        {
          "title": "Home Assistant: Google Cast",
          "url": "https://www.home-assistant.io/integrations/cast/"
        }
      ],
      "match": [
        {
          "bus": "network",
          "service": "_googlecast._tcp",
          "model": "Chromecast"
        }
      ],
      "capability": [
        {
          "id": "media.playing",
          "adapter": "mdns",
          "risk": "read",
          "privacy": "presence",
          "params": {
            "service": "_googlecast._tcp",
            "field": "rs"
          },
          "note": "The device announces what it is playing to everyone on the network. Only whether something is playing may be passed on.",
          "verification": [
            {
              "status": "observed",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-14",
              "note": "The announcement changed with what was playing. Read by listening once; the adapter is not written yet."
            }
          ]
        },
        {
          "id": "audio.output_volume",
          "adapter": "home-assistant",
          "risk": "reversible",
          "verification": [
            {
              "status": "unverified",
              "platform": "macos",
              "note": "Home Assistant offers volume for Cast devices. Not tried."
            }
          ]
        }
      ]
    },
    {
      "card": 1,
      "device": {
        "id": "home-assistant/light",
        "vendor": "Home Assistant",
        "name": "Light",
        "identity": "class",
        "kind": "lighting",
        "summary": "A light entity exposed through Home Assistant. This describes an integration class, not a manufacturer or physical model; availability depends on the entity's route and supported features.",
        "links": [
          "https://www.home-assistant.io/integrations/light/"
        ]
      },
      "match": [
        {
          "bus": "home-assistant",
          "domain": "light"
        }
      ],
      "requires": [
        {
          "platform": "any",
          "what": "A Home Assistant server that this computer may talk to"
        }
      ],
      "capability": [
        {
          "id": "power.switch",
          "adapter": "home-assistant",
          "risk": "reversible",
          "verification": [
            {
              "status": "unverified",
              "platform": "macos",
              "note": "Home Assistant documents turning a light on and off. Not tried: the adapter is not written."
            }
          ]
        },
        {
          "id": "light.brightness",
          "adapter": "home-assistant",
          "risk": "reversible",
          "verification": [
            {
              "status": "unverified",
              "platform": "macos",
              "note": "Home Assistant documents setting a light's brightness. Not tried: the adapter is not written."
            }
          ]
        }
      ]
    },
    {
      "card": 1,
      "device": {
        "id": "home-assistant/lock",
        "vendor": "Home Assistant",
        "name": "Lock",
        "identity": "class",
        "kind": "lock",
        "summary": "A lock entity exposed through Home Assistant. This describes an integration class, not a manufacturer or physical model; availability depends on the entity's route and supported features.",
        "links": [
          "https://www.home-assistant.io/integrations/lock/"
        ]
      },
      "match": [
        {
          "bus": "home-assistant",
          "domain": "lock"
        }
      ],
      "requires": [
        {
          "platform": "any",
          "what": "A Home Assistant server that this computer may talk to"
        }
      ],
      "capability": [
        {
          "id": "access.unlock",
          "adapter": "home-assistant",
          "risk": "gated",
          "verification": [
            {
              "status": "unverified",
              "platform": "macos",
              "note": "Home Assistant documents unlocking a lock. Not tried: the adapter is not written."
            }
          ]
        }
      ]
    },
    {
      "card": 1,
      "device": {
        "id": "home-assistant/outlet",
        "vendor": "Home Assistant",
        "name": "Outlet / smart plug",
        "identity": "class",
        "kind": "plug",
        "summary": "A Home Assistant switch entity classified as an outlet. This is an integration class, not a physical manufacturer/model or a promise of connected-device availability.",
        "links": [
          "https://www.home-assistant.io/integrations/switch/"
        ]
      },
      "match": [
        {
          "bus": "home-assistant",
          "domain": "switch",
          "device_class": "outlet"
        }
      ],
      "requires": [
        {
          "platform": "any",
          "what": "A Home Assistant server that this computer may talk to"
        }
      ],
      "capability": [
        {
          "id": "power.outlet",
          "adapter": "home-assistant",
          "risk": "gated",
          "note": "A plug cannot know what is plugged into it, so cutting its power always waits for a yes.",
          "verification": [
            {
              "status": "unverified",
              "platform": "macos",
              "note": "Home Assistant documents switching an outlet on and off. Not tried: the adapter is not written."
            }
          ]
        }
      ]
    },
    {
      "card": 1,
      "device": {
        "id": "lg/ultrawide-76fe",
        "vendor": "LG",
        "name": "UltraWide display",
        "identity": "family",
        "kind": "display",
        "summary": "An LG UltraWide-family display matched by public display ID 1e6d:76fe. The retail model and physical size are unconfirmed; the family reference does not identify a specific monitor.",
        "links": [
          "https://www.lg.com/us/ultrawide-monitors"
        ]
      },
      "sources": [
        {
          "title": "LG: UltraWide monitor family (not an exact-model identification)",
          "url": "https://www.lg.com/us/ultrawide-monitors"
        }
      ],
      "match": [
        {
          "bus": "display",
          "vendor_id": 7789,
          "product_id": 30462
        }
      ],
      "requires": [
        {
          "platform": "any",
          "what": "DDC/CI switched on in the display's own menu"
        }
      ],
      "capability": [
        {
          "id": "display.brightness",
          "adapter": "ddc-ci",
          "risk": "reversible",
          "params": {
            "vcp": 16
          },
          "range": [
            0,
            100
          ],
          "verification": [
            {
              "status": "tested",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-15",
              "note": "Read, changed and put back through the gatekeeper, twice, through a Thunderbolt dock. The display sometimes drops a command or answers the previous question, so the adapter reads everything twice and confirms every change."
            },
            {
              "status": "observed",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-14",
              "note": "Read as 97 of 100 twice with a one-off tool, through a Thunderbolt dock. A third read came back invalid, so reads need retrying. Setting it was not exercised."
            }
          ]
        },
        {
          "id": "display.input",
          "adapter": "ddc-ci",
          "risk": "gated",
          "params": {
            "vcp": 96
          },
          "note": "Switching input takes the picture away from the computer that asked. Many displays stop listening on the input they have left, so putting it back cannot be relied on: this card asks first instead.",
          "verification": [
            {
              "status": "observed",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-14",
              "note": "The current input was read twice with a one-off tool. Switching was not exercised."
            }
          ]
        }
      ]
    },
    {
      "card": 1,
      "device": {
        "id": "logitech/mx-master-3",
        "vendor": "Logitech",
        "name": "MX Master 3",
        "identity": "model",
        "aliases": [
          "MX Master 3 Advanced Wireless Mouse"
        ],
        "kind": "mouse",
        "summary": "Wireless mouse with a thumb wheel, a gesture button and three host slots.",
        "links": [
          "https://ir.logitech.com/news/news-details/2019/Logitech-Enables-Advanced-Users-to-Achieve-Peak-Performance-with-MX-Master-3-and-MX-Keys"
        ]
      },
      "sources": [
        {
          "title": "Logitech: MX Master 3 product announcement and model features",
          "url": "https://ir.logitech.com/news/news-details/2019/Logitech-Enables-Advanced-Users-to-Achieve-Peak-Performance-with-MX-Master-3-and-MX-Keys"
        },
        {
          "title": "Solaar capabilities",
          "url": "https://pwr-solaar.github.io/Solaar/capabilities/"
        },
        {
          "title": "ArchWiki: Logitech MX Master",
          "url": "https://wiki.archlinux.org/title/Logitech_MX_Master"
        },
        {
          "title": "OpenLogi",
          "url": "https://openlogi.org/"
        }
      ],
      "match": [
        {
          "bus": "bluetooth",
          "vendor_id": 1133,
          "product_id": 45091
        }
      ],
      "requires": [
        {
          "platform": "macos",
          "what": "Input Monitoring permission for the program that opens the device",
          "note": "Without it the control channel refuses to open (\"not permitted\"). With it, the channel opened. Checked both ways on macOS 27.2."
        }
      ],
      "capability": [
        {
          "id": "identity.firmware",
          "adapter": "macos-system",
          "risk": "read",
          "params": {
            "source": "bluetooth",
            "field": "firmware_version"
          },
          "verification": [
            {
              "status": "tested",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-15",
              "note": "Read through the adapter."
            },
            {
              "status": "observed",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-13",
              "note": "macOS reports a firmware version for this mouse. Not read through an adapter yet."
            }
          ]
        },
        {
          "id": "battery.level",
          "adapter": "hidpp",
          "risk": "read",
          "params": {
            "feature": 4096
          },
          "note": "This model answers on the older battery feature (0x1000), not the unified one (0x1004). macOS does not report this mouse's battery itself.",
          "verification": [
            {
              "status": "tested",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-15",
              "note": "Read through the adapter, over Bluetooth."
            },
            {
              "status": "observed",
              "platform": "macos",
              "os": "27.2",
              "firmware": "HID++ 4.5",
              "date": "2026-11-13",
              "note": "A charge level was read with a one-off HID++ query. The adapter is not written yet."
            }
          ]
        },
        {
          "id": "pointer.dpi",
          "adapter": "hidpp",
          "risk": "guarded",
          "params": {
            "feature": 8705
          },
          "note": "Other open tools document a 4000 DPI ceiling for this model.",
          "verification": [
            {
              "status": "tested",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-15",
              "note": "Read; then raised through the gatekeeper, which put it back by itself when nobody kept it."
            },
            {
              "status": "observed",
              "platform": "macos",
              "os": "27.2",
              "firmware": "HID++ 4.5",
              "date": "2026-11-13",
              "note": "The current and default values were read (both 1000). Setting it was not exercised."
            }
          ]
        },
        {
          "id": "pointer.buttons",
          "adapter": "hidpp",
          "risk": "guarded",
          "params": {
            "feature": 6916
          },
          "note": "The thumb and gesture buttons can be handed to software.",
          "verification": [
            {
              "status": "observed",
              "platform": "macos",
              "os": "27.2",
              "firmware": "HID++ 4.5",
              "date": "2026-11-13",
              "note": "The mouse reports eight reprogrammable controls. Redirecting one was not exercised."
            }
          ]
        },
        {
          "id": "scroll.mode",
          "adapter": "hidpp",
          "risk": "reversible",
          "params": {
            "feature": 8464
          },
          "verification": [
            {
              "status": "tested",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-15",
              "note": "Read, changed and put back through the gatekeeper."
            },
            {
              "status": "observed",
              "platform": "macos",
              "os": "27.2",
              "firmware": "HID++ 4.5",
              "date": "2026-11-13",
              "note": "The current mode was read with a one-off query. Changing it was not exercised."
            }
          ]
        },
        {
          "id": "pointer.host",
          "adapter": "hidpp",
          "risk": "gated",
          "params": {
            "feature": 6164
          },
          "note": "Moves the mouse to another paired computer, so the computer that sent the change loses it.",
          "verification": [
            {
              "status": "observed",
              "platform": "macos",
              "os": "27.2",
              "firmware": "HID++ 4.5",
              "date": "2026-11-13",
              "note": "Three host slots and the current slot were read. Switching was not exercised."
            }
          ]
        }
      ]
    },
    {
      "card": 1,
      "device": {
        "id": "samsung/tu690t",
        "vendor": "Samsung",
        "name": "TU690T Crystal UHD 4K TV",
        "identity": "family",
        "aliases": [
          "UTU690T"
        ],
        "kind": "television",
        "summary": "TU690T Crystal UHD television family advertised as UTU690T. The announcement does not establish screen size or regional model suffix. The reference is a family member, not proof of the matched unit's size.",
        "links": [
          "https://www.samsung.com/ca/support/model/UN43TU690TFXZC/"
        ]
      },
      "sources": [
        {
          "title": "Samsung: TU690T family-member support page (size is not inferred)",
          "url": "https://www.samsung.com/ca/support/model/UN43TU690TFXZC/"
        }
      ],
      "match": [
        {
          "bus": "network",
          "service": "_airplay._tcp",
          "model": "UTU690T"
        }
      ],
      "capability": [
        {
          "id": "identity.firmware",
          "adapter": "mdns",
          "risk": "read",
          "params": {
            "service": "_airplay._tcp",
            "field": "fv"
          },
          "verification": [
            {
              "status": "observed",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-14",
              "note": "The TV announces a firmware version on the local network. Read by listening once; the adapter is not written yet."
            }
          ]
        }
      ]
    },
    {
      "card": 1,
      "device": {
        "id": "seagate/expansion-2322",
        "vendor": "Seagate",
        "name": "Expansion external drive",
        "identity": "family",
        "kind": "storage",
        "summary": "Expansion-family external USB storage reporting product ID 0x2322. The card does not establish capacity or a portable-versus-desktop enclosure; do not infer those from the family name.",
        "links": [
          "https://www.seagate.com/support/kb/how-to-use-your-seagate-expansion-drive-007769en/"
        ]
      },
      "sources": [
        {
          "title": "Seagate: using Expansion drives (family reference, not enclosure identification)",
          "url": "https://www.seagate.com/support/kb/how-to-use-your-seagate-expansion-drive-007769en/"
        }
      ],
      "match": [
        {
          "bus": "usb",
          "vendor_id": 3010,
          "product_id": 8994
        }
      ],
      "requires": [
        {
          "platform": "macos",
          "what": "When run as a login service, Hardpoint may need removable-volume access in System Settings, Privacy & Security, Files and Folders"
        }
      ],
      "capability": [
        {
          "id": "storage.health",
          "adapter": "macos-system",
          "risk": "read",
          "params": {
            "source": "storage",
            "field": "smart_status"
          },
          "note": "Not every USB drive passes its health verdict through to the computer. This one does.",
          "verification": [
            {
              "status": "tested",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-15",
              "note": "Read through the adapter."
            },
            {
              "status": "observed",
              "platform": "macos",
              "os": "27.2",
              "date": "2026-11-14",
              "note": "macOS reported the drive's own verdict over USB. Read by hand; the adapter is not written yet."
            }
          ]
        }
      ]
    },
    {
      "card": 1,
      "device": {
        "id": "zsa/moonlander-mk1",
        "vendor": "ZSA",
        "name": "Moonlander Mark I",
        "identity": "model",
        "aliases": [
          "Moonlander MK1",
          "Moonlander"
        ],
        "kind": "keyboard",
        "summary": "Split ergonomic keyboard with a light under every key and an open control protocol.",
        "links": [
          "https://www.zsa.io/moonlander"
        ]
      },
      "match": [
        {
          "bus": "usb",
          "vendor_id": 12951,
          "product_id": 6505
        }
      ],
      "keys": {
        "numbering": "Oryx key index: left half first, then right; within a half, row by row, then the thumb cluster",
        "matrix": [
          [
            0,
            0
          ],
          [
            0,
            1
          ],
          [
            0,
            2
          ],
          [
            0,
            3
          ],
          [
            0,
            4
          ],
          [
            0,
            5
          ],
          [
            0,
            6
          ],
          [
            1,
            0
          ],
          [
            1,
            1
          ],
          [
            1,
            2
          ],
          [
            1,
            3
          ],
          [
            1,
            4
          ],
          [
            1,
            5
          ],
          [
            1,
            6
          ],
          [
            2,
            0
          ],
          [
            2,
            1
          ],
          [
            2,
            2
          ],
          [
            2,
            3
          ],
          [
            2,
            4
          ],
          [
            2,
            5
          ],
          [
            2,
            6
          ],
          [
            3,
            0
          ],
          [
            3,
            1
          ],
          [
            3,
            2
          ],
          [
            3,
            3
          ],
          [
            3,
            4
          ],
          [
            3,
            5
          ],
          [
            4,
            0
          ],
          [
            4,
            1
          ],
          [
            4,
            2
          ],
          [
            4,
            3
          ],
          [
            4,
            4
          ],
          [
            5,
            3
          ],
          [
            5,
            0
          ],
          [
            5,
            1
          ],
          [
            5,
            2
          ],
          [
            6,
            0
          ],
          [
            6,
            1
          ],
          [
            6,
            2
          ],
          [
            6,
            3
          ],
          [
            6,
            4
          ],
          [
            6,
            5
          ],
          [
            6,
            6
          ],
          [
            7,
            0
          ],
          [
            7,
            1
          ],
          [
            7,
            2
          ],
          [
            7,
            3
          ],
          [
            7,
            4
          ],
          [
            7,
            5
          ],
          [
            7,
            6
          ],
          [
            8,
            0
          ],
          [
            8,
            1
          ],
          [
            8,
            2
          ],
          [
            8,
            3
          ],
          [
            8,
            4
          ],
          [
            8,
            5
          ],
          [
            8,
            6
          ],
          [
            9,
            1
          ],
          [
            9,
            2
          ],
          [
            9,
            3
          ],
          [
            9,
            4
          ],
          [
            9,
            5
          ],
          [
            9,
            6
          ],
          [
            10,
            2
          ],
          [
            10,
            3
          ],
          [
            10,
            4
          ],
          [
            10,
            5
          ],
          [
            10,
            6
          ],
          [
            11,
            3
          ],
          [
            11,
            4
          ],
          [
            11,
            5
          ],
          [
            11,
            6
          ]
        ],
        "leds": [
          0,
          5,
          10,
          15,
          20,
          25,
          29,
          1,
          6,
          11,
          16,
          21,
          26,
          30,
          2,
          7,
          12,
          17,
          22,
          27,
          31,
          3,
          8,
          13,
          18,
          23,
          28,
          4,
          9,
          14,
          19,
          24,
          35,
          32,
          33,
          34,
          65,
          61,
          56,
          51,
          46,
          41,
          36,
          66,
          62,
          57,
          52,
          47,
          42,
          37,
          67,
          63,
          58,
          53,
          48,
          43,
          38,
          64,
          59,
          54,
          49,
          44,
          39,
          60,
          55,
          50,
          45,
          40,
          71,
          70,
          69,
          68
        ],
        "grid": [
          [
            0,
            0
          ],
          [
            1,
            0
          ],
          [
            2,
            0
          ],
          [
            3,
            0
          ],
          [
            4,
            0
          ],
          [
            5,
            0
          ],
          [
            6,
            0
          ],
          [
            0,
            1
          ],
          [
            1,
            1
          ],
          [
            2,
            1
          ],
          [
            3,
            1
          ],
          [
            4,
            1
          ],
          [
            5,
            1
          ],
          [
            6,
            1
          ],
          [
            0,
            2
          ],
          [
            1,
            2
          ],
          [
            2,
            2
          ],
          [
            3,
            2
          ],
          [
            4,
            2
          ],
          [
            5,
            2
          ],
          [
            6,
            2
          ],
          [
            0,
            3
          ],
          [
            1,
            3
          ],
          [
            2,
            3
          ],
          [
            3,
            3
          ],
          [
            4,
            3
          ],
          [
            5,
            3
          ],
          [
            0,
            4
          ],
          [
            1,
            4
          ],
          [
            2,
            4
          ],
          [
            3,
            4
          ],
          [
            4,
            4
          ],
          [
            6,
            5
          ],
          [
            3,
            5
          ],
          [
            4,
            5
          ],
          [
            5,
            5
          ],
          [
            8,
            0
          ],
          [
            9,
            0
          ],
          [
            10,
            0
          ],
          [
            11,
            0
          ],
          [
            12,
            0
          ],
          [
            13,
            0
          ],
          [
            14,
            0
          ],
          [
            8,
            1
          ],
          [
            9,
            1
          ],
          [
            10,
            1
          ],
          [
            11,
            1
          ],
          [
            12,
            1
          ],
          [
            13,
            1
          ],
          [
            14,
            1
          ],
          [
            8,
            2
          ],
          [
            9,
            2
          ],
          [
            10,
            2
          ],
          [
            11,
            2
          ],
          [
            12,
            2
          ],
          [
            13,
            2
          ],
          [
            14,
            2
          ],
          [
            9,
            3
          ],
          [
            10,
            3
          ],
          [
            11,
            3
          ],
          [
            12,
            3
          ],
          [
            13,
            3
          ],
          [
            14,
            3
          ],
          [
            10,
            4
          ],
          [
            11,
            4
          ],
          [
            12,
            4
          ],
          [
            13,
            4
          ],
          [
            14,
            4
          ],
          [
            8,
            5
          ],
          [
            9,
            5
          ],
          [
            10,
            5
          ],
          [
            11,
            5
          ]
        ]
      },
      "requires": [
        {
          "platform": "any",
          "what": "Sole use of the keyboard's control channel",
          "note": "ZSA's Keymapp holds the same channel, so it has to be closed. Checked on macOS."
        }
      ],
      "capability": [
        {
          "id": "identity.firmware",
          "adapter": "oryx-hid",
          "firmware": {
            "family": "zsa-oryx"
          },
          "risk": "read",
          "note": "Reports the Oryx layout id and revision id that were flashed.",
          "verification": [
            {
              "status": "tested",
              "platform": "macos",
              "os": "27.2",
              "firmware": "Oryx protocol v4",
              "date": "2026-11-12"
            }
          ]
        },
        {
          "id": "keys.position_events",
          "adapter": "oryx-hid",
          "firmware": {
            "family": "zsa-oryx"
          },
          "risk": "read",
          "privacy": "aggregate",
          "note": "Reported for every key, including keys with nothing assigned, so unused keys can be given meaning without reflashing.",
          "verification": [
            {
              "status": "tested",
              "platform": "macos",
              "os": "27.2",
              "firmware": "Oryx protocol v4",
              "date": "2026-11-12",
              "note": "A press on a physical key was received and acted on."
            }
          ]
        },
        {
          "id": "keys.layer",
          "adapter": "oryx-hid",
          "firmware": {
            "family": "zsa-oryx"
          },
          "risk": "read",
          "verification": [
            {
              "status": "tested",
              "platform": "macos",
              "os": "27.2",
              "firmware": "Oryx protocol v4",
              "date": "2026-11-12",
              "note": "The layer reported on connecting was received. A layer change was not exercised."
            }
          ]
        },
        {
          "id": "light.per_key",
          "adapter": "oryx-hid",
          "firmware": {
            "family": "zsa-oryx"
          },
          "risk": "reversible",
          "note": "While the host controls lighting it must set every key; there is no overlay on the keyboard's own effects.",
          "verification": [
            {
              "status": "tested",
              "platform": "macos",
              "os": "27.2",
              "firmware": "Oryx protocol v4",
              "date": "2026-11-13",
              "note": "Six keys confirmed by eye. The order of the other 66 follows QMK's published table."
            }
          ]
        },
        {
          "id": "light.global",
          "adapter": "oryx-hid",
          "firmware": {
            "family": "zsa-oryx"
          },
          "risk": "reversible",
          "verification": [
            {
              "status": "tested",
              "platform": "macos",
              "os": "27.2",
              "firmware": "Oryx protocol v4",
              "date": "2026-11-12",
              "note": "Taking and releasing control was confirmed by the keyboard's own reply."
            }
          ]
        },
        {
          "id": "light.status",
          "adapter": "oryx-hid",
          "firmware": {
            "family": "zsa-oryx"
          },
          "risk": "reversible",
          "verification": [
            {
              "status": "unverified",
              "platform": "macos",
              "note": "In the published protocol. Not tried."
            }
          ]
        },
        {
          "id": "keys.layer_set",
          "adapter": "oryx-hid",
          "firmware": {
            "family": "zsa-oryx"
          },
          "risk": "guarded",
          "verification": [
            {
              "status": "unverified",
              "platform": "macos",
              "note": "In the published protocol. Not tried."
            }
          ]
        },
        {
          "id": "firmware.flash",
          "adapter": "manual",
          "risk": "gated",
          "note": "You put the keyboard into update mode with its reset button, and ZSA's app writes the firmware. Hardpoint explains the steps.",
          "verification": [
            {
              "status": "unverified",
              "platform": "macos",
              "note": "Taken from ZSA's documentation. Not tried."
            }
          ]
        }
      ],
      "sources": [
        {
          "title": "ZSA: Moonlander product family",
          "url": "https://www.zsa.io/moonlander"
        },
        {
          "title": "Oryx raw-HID protocol (zsa/qmk_modules)",
          "url": "https://github.com/zsa/qmk_modules/blob/main/oryx/oryx.h"
        },
        {
          "title": "QMK keyboard definition, including LED order",
          "url": "https://github.com/qmk/qmk_firmware/blob/master/keyboards/zsa/moonlander/keyboard.json"
        }
      ]
    },
    {
      "card": 1,
      "device": {
        "id": "zsa/voyager",
        "vendor": "ZSA",
        "name": "Voyager",
        "identity": "model",
        "kind": "keyboard",
        "summary": "Low-profile split ergonomic keyboard with per-key lighting. Consult each ability's verification record separately from this product description.",
        "links": [
          "https://www.zsa.io/voyager"
        ]
      },
      "match": [
        {
          "bus": "usb",
          "vendor_id": 12951,
          "product_id": 6519
        }
      ],
      "requires": [
        {
          "platform": "any",
          "what": "Sole use of the keyboard's control channel",
          "note": "Expected, as on the Moonlander: ZSA's Keymapp holds the same channel. Not checked on this model."
        }
      ],
      "capability": [
        {
          "id": "identity.firmware",
          "adapter": "oryx-hid",
          "risk": "read",
          "verification": [
            {
              "status": "unverified",
              "platform": "macos",
              "note": "ZSA publishes one protocol for its keyboards. Not tried on this model."
            }
          ]
        },
        {
          "id": "keys.position_events",
          "adapter": "oryx-hid",
          "risk": "read",
          "privacy": "aggregate",
          "verification": [
            {
              "status": "unverified",
              "platform": "macos",
              "note": "ZSA publishes one protocol for its keyboards. Not tried on this model."
            }
          ]
        },
        {
          "id": "light.global",
          "adapter": "oryx-hid",
          "risk": "reversible",
          "verification": [
            {
              "status": "unverified",
              "platform": "macos",
              "note": "ZSA publishes one protocol for its keyboards. Not tried on this model."
            }
          ]
        },
        {
          "id": "firmware.flash",
          "adapter": "manual",
          "risk": "gated",
          "note": "This keyboard uses ZSA's own update mode, which ZSA's app writes to after you press the reset button. Hardpoint explains the steps.",
          "verification": [
            {
              "status": "unverified",
              "platform": "macos",
              "note": "Taken from ZSA's documentation and the keyboard's QMK definition. Not tried."
            }
          ]
        }
      ],
      "sources": [
        {
          "title": "ZSA: Voyager product specifications",
          "url": "https://www.zsa.io/voyager"
        },
        {
          "title": "Oryx raw-HID protocol (zsa/qmk_modules)",
          "url": "https://github.com/zsa/qmk_modules/blob/main/oryx/oryx.h"
        },
        {
          "title": "QMK keyboard definition, for the USB identifiers",
          "url": "https://github.com/qmk/qmk_firmware/blob/master/keyboards/zsa/voyager/keyboard.json"
        }
      ]
    }
  ]
}
