dcpu 0.5.0

An assembler, debugger and emulator for the DCPU-16
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

pub mod clock;
pub mod dummy;
pub mod eeprom;
pub mod hic;
pub mod keyboard;
pub mod lem1802;
pub mod m35fd;

#[cfg(feature = "glium")]
pub mod glium_backend;

use std::any::Any;
use std::fmt::Debug;

use emulator::cpu::Cpu;

pub enum TickResult {
    Nothing,
    Interrupt(u16),
}

pub type InterruptDelay = u16;

error_chain!(
    errors {
        InvalidCommand(cmd: u16) {
            description("invalid hardware command")
            display("invalid hardware command: {:#x}", cmd)
        }
        BackendStopped(which: String) {
            description("the backend stopped")
            display("the {} backend stopped", which)
        }
    }
);

pub trait Device: Debug + Send + Any {
    fn hardware_id(&self) -> u32;
    fn hardware_version(&self) -> u16;
    fn manufacturer(&self) -> u32;

    fn interrupt(&mut self, &mut Cpu) -> Result<InterruptDelay>;
    fn tick(&mut self, &mut Cpu, current_tick: u64) -> Result<TickResult>;

    fn inspect(&self);
    fn as_any(&mut self) -> &mut Any;
}