Hardpoint

Devices / Keyboard / 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

AbilityLabelChecked
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
readunverified commit
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
readunverified commit
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
reversibleunverified commit
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
gatedunverified commit

Before it will work

PlatformNeeds
anySole use of the keyboard's control channelExpected, as on the Moonlander: ZSA's Keymapp holds the same channel. Not checked on this model.

How it is recognised

BusIdentifiers
usbvendor_id=3297 product_id=1977

Sources

In a standard form

The same card as a W3C Web of Things Thing Model, for tools that read that standard. Hardpoint's added terms.

The card

This page is made from catalog/devices/zsa/voyager.toml. If something is wrong, or you have checked more of it, edit that file.

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"