rz80 0.1.1

Z80 chip family emulation
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

use RegT;
use CTC;

/// system bus trait
///
/// The system bus must be implemented by the higher level parts
/// of an emulator and is used as central callback facility for the
/// various Z80 chips. If anything happens in the chips that
/// need to be communicated to other chips or the higher-level
/// parts of the emulator (such as port I/O), one of the
/// trait functions will be called.
#[allow(unused_variables)]
pub trait Bus {
    /// CPU reads from I/O port
    fn cpu_inp(&self, port: RegT) -> RegT {
        0
    }
    /// CPU writes to I/O port
    fn cpu_outp(&self, port: RegT, val: RegT) {}

    /// request an interrupt, called by a device to generate interrupt
    fn irq(&self, ctrl_id: usize, vec: u8) {}
    /// forward an interrupt-request to CPU, called by daisychain
    fn irq_cpu(&self) {}
    /// interrupt request acknowledge (called by CPU), return interrupt vector
    fn irq_ack(&self) -> RegT {
        0
    }
    /// notify interrupt daisy chain that CPU executed a RETI
    fn irq_reti(&self) {}

    /// PIO output callback
    fn pio_outp(&self, pio: usize, chn: usize, data: RegT) {}
    /// PIO input callback
    fn pio_inp(&self, pio: usize, chn: usize) -> RegT {
        0
    }
    /// PIO channel rdy line has changed
    fn pio_rdy(&self, pio: usize, chn: usize, rdy: bool) {}
    /// interrupt request from PIO
    fn pio_irq(&self, pio: usize, chn: usize, int_vector: RegT) {}

    /// CTC write callback
    fn ctc_write(&self, chn: usize, ctc: &CTC) {}
    /// CTC counter/timer reached zero
    fn ctc_zero(&self, chn: usize, ctc: &CTC) {}
    /// interrupt request from CTC
    fn ctc_irq(&self, ctc: usize, chn: usize, int_vector: RegT) {}
}