OpenLogi

0x4520 · keyboardLayout

Query or override the physical keyboard locale — identifies the regional key-cap arrangement (QWERTY, AZERTY, QWERTZ, etc.) stored in the device.

keyboardLayout reports, and on some devices configures, the physical layout a keyboard is set to: QWERTY, AZERTY, QWERTZ, and other regional arrangements. It appears on Logitech keyboards that ship in multiple regional variants. The declared layout tells host software which key-cap legends are physically present, which matters for key-remapping UIs and on-screen overlays. Associating a layout with each paired host is the job of 0x4540 keyboardInternationalLayouts.

Not implemented in OpenLogi

OpenLogi's vendored hidpp crate does not provide a typed wrapper for this feature yet. The notes below summarise the HID++ feature in general terms, not OpenLogi behaviour. OpenLogi instead relies on 0x4540 keyboardInternationalLayouts where applicable.

What it does

  • Queries the layout stored in the device, typically a locale or region code naming the physical key arrangement.
  • Some versions can set or override the reported layout, for keyboards whose firmware default does not match the key caps actually fitted.
  • The layout is informational: it does not alter which HID scan codes the device generates.
  • 0x4521 disableKeys and 0x4522 disableKeysByUsage act on individual keys; this feature concerns the layout as a whole.
  • For per-host layout preferences across a multi-host device, prefer 0x4540 keyboardInternationalLayouts.

Status: Not implemented · Feature ID: 0x4520 · See also: 0x4540 keyboardInternationalLayouts

On this page

What it does