Struct pc_keyboard::ScancodeSet1

pub struct ScancodeSet1 { /* private fields */ }

Contains the implementation of Scancode Set 1.

See the OS dev wiki: https://wiki.osdev.org/PS/2_Keyboard#Scan_Code_Set_1

Implementations

impl ScancodeSet1

pub const fn new() -> ScancodeSet1

Construct a new ScancodeSet1 decoder.

Examples found in repository

examples/scancodes.rs (line 4)

fn main() {
    let mut s = ScancodeSet1::new();
    // [ 0x01 ] means "Pressed Escape" in Set 1
    match s.advance_state(0x01) {
        Ok(Some(KeyEvent { code, state })) => {
            println!("Scancode Set 1 0x01 is KeyCode '{code:?}' KeyState '{state:?}'");
        }
        Ok(None) => {
            println!("This is wrong, we didn't think that was a complete sequence");
        }
        Err(e) => {
            println!("There was an error: {e:?}");
        }
    }
    // [ 0x81 ] means "Released Escape" in Set 1
    match s.advance_state(0x81) {
        Ok(Some(KeyEvent { code, state })) => {
            println!("Scancode Set 1 0x81 is KeyCode '{code:?}' KeyState '{state:?}'");
        }
        Ok(None) => {
            println!("This is wrong, we didn't think that was a complete sequence");
        }
        Err(e) => {
            println!("There was an error: {e:?}");
        }
    }

    let mut s = ScancodeSet2::new();
    // [ 0x01 ] means "Pressed F9" in Set 2
    match s.advance_state(0x01) {
        Ok(Some(KeyEvent { code, state })) => {
            println!("Scancode Set 2 0x01 is KeyCode '{code:?}' KeyState '{state:?}'");
        }
        Ok(None) => {
            println!("This is wrong, we didn't think that was a complete sequence");
        }
        Err(e) => {
            println!("There was an error: {e:?}");
        }
    }
    // [ 0xF0, 0x01 ] means "Released F9" in Set 2
    assert_eq!(Ok(None), s.advance_state(0xF0));
    match s.advance_state(0x01) {
        Ok(Some(KeyEvent { code, state })) => {
            println!("Scancode Set 2 0xF0 0x01 is KeyCode '{code:?}' KeyState '{state:?}'");
        }
        Ok(None) => {
            println!("This is wrong, we didn't think that was a complete sequence");
        }
        Err(e) => {
            println!("There was an error: {e:?}");
        }
    }
}

Trait Implementations

impl Default for ScancodeSet1

fn default() -> Self

Returns the “default value” for a type.

impl ScancodeSet for ScancodeSet1

fn advance_state(&mut self, code: u8) -> Result<Option<KeyEvent>, Error>

Implements state logic for scancode set 1

Start:

• E0 => Goto Extended
• E1 => Goto Extended 2
• < 0x80 => Key Down
• >= 0x80 => Key Up

Extended:

• < 0x80 => Extended Key Down
• >= 0x80 => Extended Key Up

Extended 2:

• < 0x80 => Extended 2 Key Down
• >= 0x80 => Extended 2 Key Up