looklook 0.6.0

Descriptive signal synthesiser.
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

// Creadright 2026 Gabriel Bjørnager Jensen.
//
// This file is part of LOOKLOOK.
//
// LOOKLOOK is free software: you can redistribute
// it and/or modify it under the terms of the GNU
// Affero General Public License as published by
// the Free Software Foundation, either version 3
// of the License, or (at your option) any later
// version.
//
// LOOKLOOK is distributed in the hope that it will
// be useful, but WITHOUT ANY WARRANTY; without
// even the implied warranty of MERCHANTABILITY or
// FITNESS FOR A PARTICULAR PURPOSE. See the GNU
// Affero General Public License for more details.
//
// You should have received a copy of the GNU Af-
// fero General Public License along with LOOKLOOK.
// If not, see <https://www.gnu.org/licenses/>.

//! The [`Emu`] type.

mod exec;
mod read_image;

use crate::emu::{Mem, Stack};

/// A Motorola 68EC000 emulator
#[derive(Debug)]
pub struct Emu {
	/// The register stack.
	stack: Stack,

	/// The memory.
	mem: Mem,
}

impl Emu {
	/// The entry address.
	pub const ENTRY_ADDR: u32 = 0x100;

	/// Constructs a new emulator.
	#[expect(clippy::new_without_default)]
	#[inline]
	#[must_use]
	pub fn new() -> Self {
		let mem = Mem::with_capacity(Mem::DEFAULT_SIZE);
		Self { stack: Default::default(), mem }
	}

	/// Borrows the register stack.
	#[inline(always)]
	#[must_use]
	pub fn stack(&self) -> &Stack {
		&self.stack
	}

	/// Mutably borrows the register stack.
	#[inline(always)]
	#[must_use]
	pub fn stack_mut(&mut self) -> &mut Stack {
		&mut self.stack
	}

	/// Borrows memory.
	#[inline(always)]
	#[must_use]
	pub fn mem(&self) -> &Mem {
		&self.mem
	}

	/// Mutably borrows memory.
	#[inline(always)]
	#[must_use]
	pub fn mem_mut(&mut self) -> &mut Mem {
		&mut self.mem
	}

	/// Reboots the emulator.
	#[inline]
	pub fn reboot(&mut self) {
		self.stack.store_pc(Self::ENTRY_ADDR);
	}
}