lambdaOS 0.1.0

A simple operating system written in Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

use spin::Mutex;
use device::io::Port;

pub struct Ps2 {
    pub controller: Port<u8>,
    pub device: Port<u8>,
}

impl Ps2 {
    pub const unsafe fn new(controller: u16, device: u16) -> Ps2 {
        Ps2 {
            controller: Port::new(controller),
            device: Port::new(device),
        }
    }

    /// Poll bit 0 of status register: "Output buffer empty/full"
    pub fn wait_then_read(&mut self) -> u8 {
        while self.controller.read() & 0x1 == 0 {}
        self.device.read()
    }

    /// Poll bit 1 of status register: "Input buffer empty/full"
    pub fn wait_then_write(&mut self, data: u8) {
        while self.controller.read() & 0x2 == 1 {}
        self.device.write(data);
    }

    pub fn init(&mut self) {
        // Disable devices.
        self.controller.write(0xAD);
        self.controller.write(0xA7);

        // Flush output buffer.
        self.device.read();

        // Setup Controller Config Byte.
        self.controller.write(0x20);
        let mut config_byte: u8 = self.wait_then_read();

        // Disable IRQs.
        config_byte &= !(1 << 0);
        config_byte &= !(1 << 1);

        // Write back the modified config.
        self.controller.write(0x60);
        self.wait_then_write(config_byte);

        // Controller self test.
        self.controller.write(0xAA);
        assert!(self.wait_then_read() == 0x55, "PS/2 self test failed");

        // Interface tests.
        self.controller.write(0xAB);
        assert!(self.wait_then_read() == 0x0, "Interface tests failed",);

        // Enable devices.
        self.controller.write(0xAE);

        // Config byte.
        self.controller.write(0x20);
        let mut enable: u8 = self.wait_then_read();

        // Re-enable IRQs.
        enable |= 1 << 0;

        self.controller.write(0x60);
        self.wait_then_write(enable);

        // Clear output buffer.
        self.device.read();

        println!("[ OK ] PS/2 driver.");
    }

    pub fn read_char(&mut self) -> u8 {
        self.device.read()
    }
}

pub static PS2: Mutex<Ps2> = Mutex::new(unsafe { Ps2::new(0x64, 0x60) });

pub fn read_char() -> u8 {
    PS2.lock().read_char()
}