refactor: extract ports/drivers/bins layers — clean dependency inversion

Separate abstractions from implementations following DIP:

  servers/              drivers/
      │                     │
      ▼                     ▼
    ports/  (trait-only crates, zero deps)

New crates:

ports/ (abstractions):
  - port-framebuffer: Framebuffer trait
  - port-block-device: BlockDevice trait + SectorId
  - port-input-device: InputDevice trait + InputEvent types

drivers/ (implementations depend on ports/):
  - driver-framebuffer-virtio: VirtIO GPU framebuffer
  - driver-framebuffer-mock: test double
  - driver-block-virtio: VirtIO block device

bins/ (composition roots wire server + driver):
  - display-qemu: DisplayServer<VirtioFramebuffer>
  - storage-qemu: storage server with VirtIO block

Servers no longer own their hardware traits or driver code.
Neither server nor driver depends on the other — both point
inward to the port abstraction.
This commit is contained in:
2026-10-18 13:13:53 +02:00
parent 38f20cc3c4
commit 5766c6f7f7
39 changed files with 272 additions and 217 deletions

View File

@@ -0,0 +1,6 @@
[package]
name = "port-input-device"
version = "0.1.0"
edition = "2024"
[dependencies]

View File

@@ -0,0 +1,54 @@
#![no_std]
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum Key {
Up,
Down,
Left,
Right,
Enter,
Escape,
Space,
Backspace,
Tab,
Char(u8),
}
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum GamepadButton {
South,
East,
North,
West,
DpadUp,
DpadDown,
DpadLeft,
DpadRight,
Start,
Select,
}
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum Axis {
LeftX,
LeftY,
RightX,
RightY,
}
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum InputEvent {
KeyDown(Key),
KeyUp(Key),
PointerDown { id: u8, x: u16, y: u16 },
PointerMove { id: u8, x: u16, y: u16 },
PointerUp { id: u8, x: u16, y: u16 },
Scroll { dx: i16, dy: i16 },
GamepadButton { button: GamepadButton, pressed: bool },
GamepadAxis { axis: Axis, value: i16 },
}
pub trait InputDevice {
fn poll(&mut self) -> Option<InputEvent>;
fn has_event(&self) -> bool;
}