[Devices](https://dotcipher.github.io/hardpoint/devices.html) / [Keyboard](https://dotcipher.github.io/hardpoint/devices.html?kind=keyboard) / [ZSA](https://dotcipher.github.io/hardpoint/devices.html?maker=ZSA)

# ZSA Voyager

Low-profile split ergonomic keyboard with per-key lighting. Consult each ability's verification record separately from this product description.

zsa/voyager · Model match: A named public model or model identifier; this does not verify every configuration or operation.

## What it can do

| Ability | Label | Checked |
| --- | --- | --- |
| Firmware version or layout identifier the device reports. identity.firmware Details:   Checked on:  macos What was checked:  ZSA publishes one protocol for its keyboards. Not tried on this model. Route:  oryx-hid (implemented) Value:  reading, string  | read | unverified [commit](https://github.com/dotCipher/hardpoint/commit/28ddef25a53296ecc6bcb0d5ccb9a6547b53542c) |
| Let me answer my agent by pressing a spare key. keys.position_events Details:   Checked on:  macos What was checked:  ZSA publishes one protocol for its keyboards. Not tried on this model. Route:  oryx-hid (implemented) Value:  event, key position, down or up Privacy:  aggregate  | read | unverified [commit](https://github.com/dotCipher/hardpoint/commit/28ddef25a53296ecc6bcb0d5ccb9a6547b53542c) |
| Glow amber whenever an agent is waiting on me. light.global Details:   Checked on:  macos What was checked:  ZSA publishes one protocol for its keyboards. Not tried on this model. Route:  oryx-hid (implemented) Value:  control, rgb  | reversible | unverified [commit](https://github.com/dotCipher/hardpoint/commit/28ddef25a53296ecc6bcb0d5ccb9a6547b53542c) |
| Update its software. firmware.flash Details:   Checked on:  macos What was checked:  Taken from ZSA's documentation and the keyboard's QMK definition. Not tried. 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. If done carelessly:  If an update fails part-way, the device may not start again. Route:  manual (implemented) Value:  action, firmware image  | gated | unverified [commit](https://github.com/dotCipher/hardpoint/commit/fbea830e40e94846282c5054ab71bdd287b7959e) |

## Before it will work

| Platform | Needs |
| --- | --- |
| any | Sole use of the keyboard's control channel Expected, as on the Moonlander: ZSA's Keymapp holds the same channel. Not checked on this model. |

## How it is recognised

| Bus | Identifiers |
| --- | --- |
| usb | vendor_id=3297 product_id=1977 |

## Sources

- [ZSA: Voyager product specifications](https://www.zsa.io/voyager)
- [Oryx raw-HID protocol (zsa/qmk_modules)](https://github.com/zsa/qmk_modules/blob/main/oryx/oryx.h)
- [QMK keyboard definition, for the USB identifiers](https://github.com/qmk/qmk_firmware/blob/master/keyboards/zsa/voyager/keyboard.json)

## In a standard form

The same card as a [W3C Web of Things Thing Model](https://dotcipher.github.io/hardpoint/models/zsa-voyager.tm.jsonld), for tools that read that standard. [Hardpoint's added terms](https://dotcipher.github.io/hardpoint/ns.html).

## The card

This page is made from [catalog/devices/zsa/voyager.toml](https://github.com/dotCipher/hardpoint/blob/main/catalog/devices/zsa/voyager.toml). If something is wrong, or you have checked more of it, [edit that file](https://dotcipher.github.io/hardpoint/add.html).

```
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 = 0x3297
product_id = 0x1977

# There is no [keys] section yet: the key numbers have to be read from a
# real keyboard. Until then software can light the whole board, not one key.

[[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." }]

[[capability]]
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." }]

[[capability]]
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." }]

[[capability]]
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"

[[sources]]
title = "Oryx raw-HID protocol (zsa/qmk_modules)"
url = "https://github.com/zsa/qmk_modules/blob/main/oryx/oryx.h"

[[sources]]
title = "QMK keyboard definition, for the USB identifiers"
url = "https://github.com/qmk/qmk_firmware/blob/master/keyboards/zsa/voyager/keyboard.json"

```
