#hid #usb-hid #keyboard

no-std keycode

A Rust crate for translating keycodes based on Chrome's mapping of keys

8 releases

0.4.0 Sep 1, 2022
0.3.0 Jan 2, 2020
0.2.2 Jul 8, 2019
0.1.2 Jun 18, 2019
0.1.1 Jan 27, 2019

#1485 in Hardware support

Download history 610/week @ 2024-06-17 548/week @ 2024-06-24 446/week @ 2024-07-01 462/week @ 2024-07-08 339/week @ 2024-07-15 209/week @ 2024-07-22 171/week @ 2024-07-29 344/week @ 2024-08-05 383/week @ 2024-08-12 661/week @ 2024-08-19 582/week @ 2024-08-26 1191/week @ 2024-09-02 447/week @ 2024-09-09 275/week @ 2024-09-16 756/week @ 2024-09-23 1162/week @ 2024-09-30

2,644 downloads per month
Used in 3 crates (2 directly)

MIT license

17KB
191 lines

keycode

A Rust crate for translating keycodes based on Chrome's mapping of keys.

Easily convert, generate, listen for, or map keycodes for Linux, Windows, Mac, USB, and browsers! Includes a struct to manage the state of pressed keys and generate USB HID reports. Can be used for #![no_std] crates.

Source Data

Source of keycodes data:

How to update source file:

curl -sL 'https://chromium.googlesource.com/chromium/src/+/master/ui/events/keycodes/dom/keycode_converter_data.inc?format=TEXT' | base64 --decode > keycode_converter_data.inc

Examples

Get a key mapping

use keycode::{KeyMap, KeyMappingId};

// Check the USB HID value of the "a" key
fn main() {
    let a = KeyMap::from(KeyMappingId::UsA);
    assert_eq!(a.usb, 0x0004);
    assert_eq!(a.evdev, 0x001e);
    assert_eq!(a.xkb, 0x0026);
    assert_eq!(a.win, 0x001e);
    assert_eq!(a.mac, 0x0000);
}

Generate a USB HID report

use keycode::{KeyboardState, KeyMap, KeyMappingId, KeyState};

// Press and release the "A" key
fn main() {
    // Generate a keyboard state with n-key rollover
    let mut keyboard_state = KeyboardState::new(None);

    // Get key mappings
    let a = KeyMap::from(KeyMappingId::UsA);
    let shift = KeyMap::from(KeyMappingId::ShiftLeft);

    // USB HID report for "no keys pressed"
    assert_eq!(keyboard_state.usb_input_report(), &[0; 8]);

    // Press "shift" and "a" keys
    keyboard_state.update_key(a, KeyState::Pressed);
    keyboard_state.update_key(shift, KeyState::Pressed);

    // USB HID report for "'A' is pressed"
    assert_eq!(
        keyboard_state.usb_input_report(),
        &[shift.modifier.unwrap().bits(), 0, a.usb as u8, 0, 0, 0, 0, 0]
    );

    // Release "shift" and "a" keys
    keyboard_state.update_key(a, KeyState::Released);
    keyboard_state.update_key(shift, KeyState::Released);

    // USB HID report for "no keys pressed"
    assert_eq!(keyboard_state.usb_input_report(), &[0; 8]);
}

Supported Rust Versions

Requires Rust 1.34.0 or newer due to use of TryFrom.

Dependencies

~0.7–1MB
~18K SLoC