feat: init acpi generator

packages/harbor/lib/harbor.dart

@@ -47,7 +47,9 @@ export 'src/clock/clock_domain.dart';
 export 'src/clock/clock_gate.dart';
 
 // SoC
+export 'src/soc/acpi.dart';
 export 'src/soc/boot_sequencer.dart';
+export 'src/soc/cpu.dart';
 export 'src/soc/device_tree.dart';
 export 'src/soc/graph.dart';
 export 'src/soc/harbor_soc.dart';

packages/harbor/lib/src/debug/debug_module.dart

@@ -3,6 +3,7 @@ import 'package:rohd_bridge/rohd_bridge.dart';
 
 import '../bus/bus.dart';
 import '../bus/bus_slave_port.dart';
+import '../soc/acpi.dart';
 import '../soc/device_tree.dart';
 
 /// RISC-V Debug Module (DM) per the RISC-V Debug Specification 1.0.
@@ -22,7 +23,8 @@ import '../soc/device_tree.dart';
 /// - 0x12: haltsum1     0x16: abstracts    0x17: command
 /// - 0x18: abstractauto 0x20-0x2F: progbuf  0x38: sbcs
 /// - 0x39: sbaddress0   0x3C: sbdata0
-class HarborDebugModule extends BridgeModule with HarborDeviceTreeNodeProvider {
+class HarborDebugModule extends BridgeModule
+    with HarborDeviceTreeNodeProvider, HarborAcpiDeviceProvider {
   /// Base address for the debug module's memory-mapped registers.
   final int baseAddress;
 
@@ -239,4 +241,16 @@ class HarborDebugModule extends BridgeModule with HarborDeviceTreeNodeProvider {
     reg: BusAddressRange(baseAddress, 0x1000),
     properties: {'num-harts': numHarts, 'progbuf-size': progBufSize},
   );
+
+  @override
+  HarborAcpiDevice get acpiDevice => HarborAcpiDevice(
+    hid: 'PRP0001',
+    uid: 0,
+    memory: [BusAddressRange(baseAddress, 0x1000)],
+    properties: {
+      'compatible': ['harbor,debug-module', 'riscv,debug-013'],
+      'num-harts': numHarts,
+      'progbuf-size': progBufSize,
+    },
+  );
 }

packages/harbor/lib/src/debug/trace.dart

@@ -3,6 +3,7 @@ import 'package:rohd_bridge/rohd_bridge.dart';
 
 import '../bus/bus.dart';
 import '../bus/bus_slave_port.dart';
+import '../soc/acpi.dart';
 import '../soc/device_tree.dart';
 
 /// Trace packet type.
@@ -45,7 +46,7 @@ enum HarborTracePacketType {
 /// - 0x18: BUF_WR   (current write pointer, read-only)
 /// - 0x1C: SYNC_CNT (sync packet interval in branches)
 class HarborTraceEncoder extends BridgeModule
-    with HarborDeviceTreeNodeProvider {
+    with HarborDeviceTreeNodeProvider, HarborAcpiDeviceProvider {
   /// Base address for trace registers.
   final int baseAddress;
 
@@ -245,4 +246,16 @@ class HarborTraceEncoder extends BridgeModule
     reg: BusAddressRange(baseAddress, 0x1000),
     properties: {'buffer-size': bufferSize, 'sync-interval': syncInterval},
   );
+
+  @override
+  HarborAcpiDevice get acpiDevice => HarborAcpiDevice(
+    hid: 'PRP0001',
+    uid: 0,
+    memory: [BusAddressRange(baseAddress, 0x1000)],
+    properties: {
+      'compatible': ['riscv,trace'],
+      'buffer-size': bufferSize,
+      'sync-interval': syncInterval,
+    },
+  );
 }

packages/harbor/lib/src/media/audio.dart

@@ -3,6 +3,7 @@ import 'package:rohd_bridge/rohd_bridge.dart';
 
 import '../bus/bus.dart';
 import '../bus/bus_slave_port.dart';
+import '../soc/acpi.dart';
 import '../soc/device_tree.dart';
 
 /// Audio sample format.
@@ -109,7 +110,7 @@ enum HarborAudioCodecFormat {
 /// - 0x84: CODEC_STATUS  (codec busy/done/error)
 /// - 0x88: CODEC_CAPS   (supported codecs bitmask, read-only)
 class HarborAudioController extends BridgeModule
-    with HarborDeviceTreeNodeProvider {
+    with HarborDeviceTreeNodeProvider, HarborAcpiDeviceProvider {
   /// Base address in the SoC memory map.
   final int baseAddress;
 
@@ -516,4 +517,24 @@ class HarborAudioController extends BridgeModule
       'harbor,rx-fifo-depth': rxFifoDepth,
     },
   );
+
+  @override
+  HarborAcpiDevice get acpiDevice => HarborAcpiDevice(
+    hid: 'PRP0001',
+    uid: 0,
+    memory: [BusAddressRange(baseAddress, 0x1000)],
+    properties: {
+      'compatible': ['harbor,audio'],
+      '#sound-dai-cells': 0,
+      'harbor,interfaces': audioInterfaces.map((i) => i.name).join(', '),
+      'harbor,max-channels': maxChannels,
+      'harbor,sample-rates': sampleRates.map((r) => '$r').join(', '),
+      'harbor,formats': formats.map((f) => f.name).join(', '),
+      if (hwCodecs.isNotEmpty)
+        'harbor,codecs': hwCodecs.map((c) => c.displayName).join(', '),
+      if (hasSrc) 'harbor,has-src': true,
+      'harbor,tx-fifo-depth': txFifoDepth,
+      'harbor,rx-fifo-depth': rxFifoDepth,
+    },
+  );
 }

packages/harbor/lib/src/media/media_engine.dart

@@ -3,6 +3,7 @@ import 'package:rohd_bridge/rohd_bridge.dart';
 
 import '../bus/bus.dart';
 import '../bus/bus_slave_port.dart';
+import '../soc/acpi.dart';
 import '../soc/device_tree.dart';
 import 'codec.dart';
 
@@ -52,7 +53,8 @@ import 'codec.dart';
 /// - +0x44: SESS_LEVEL      (codec level)
 /// - +0x48: SESS_BYTES_DONE (bytes processed, read-only)
 /// - +0x4C: SESS_FRAMES_DONE (frames processed, read-only)
-class HarborMediaEngine extends BridgeModule with HarborDeviceTreeNodeProvider {
+class HarborMediaEngine extends BridgeModule
+    with HarborDeviceTreeNodeProvider, HarborAcpiDeviceProvider {
   /// Base address in the SoC memory map.
   final int baseAddress;
 
@@ -329,4 +331,24 @@ class HarborMediaEngine extends BridgeModule with HarborDeviceTreeNodeProvider {
       ),
     },
   );
+
+  @override
+  HarborAcpiDevice get acpiDevice => HarborAcpiDevice(
+    hid: 'PRP0001',
+    uid: 0,
+    memory: [BusAddressRange(baseAddress, 0x1000)],
+    properties: {
+      'compatible': ['harbor,media-engine'],
+      'max-sessions': maxSessions,
+      'harbor,codecs': codecs.map((c) => c.format.displayName).join(', '),
+      'harbor,max-width': codecs.fold<int>(
+        0,
+        (max, c) => c.maxWidth > max ? c.maxWidth : max,
+      ),
+      'harbor,max-height': codecs.fold<int>(
+        0,
+        (max, c) => c.maxHeight > max ? c.maxHeight : max,
+      ),
+    },
+  );
 }

packages/harbor/lib/src/peripherals/aplic.dart

@@ -3,6 +3,7 @@ import 'package:rohd_bridge/rohd_bridge.dart';
 
 import '../bus/bus.dart';
 import '../bus/bus_slave_port.dart';
+import '../soc/acpi.dart';
 import '../soc/device_tree.dart';
 
 /// RISC-V Advanced Platform-Level Interrupt Controller (APLIC).
@@ -20,7 +21,8 @@ import '../soc/device_tree.dart';
 /// - `target[i]`:     0x3004 + (i-1)*4
 /// - IDC per hart:    0x4000 + hart*32
 ///   - `idelivery` +0x00, `iforce` +0x04, `ithreshold` +0x08, `claimi` +0x1C
-class HarborAplic extends BridgeModule with HarborDeviceTreeNodeProvider {
+class HarborAplic extends BridgeModule
+    with HarborDeviceTreeNodeProvider, HarborAcpiDeviceProvider {
   final int sources;
   final int harts;
   final int priorityBits;
@@ -318,4 +320,17 @@ class HarborAplic extends BridgeModule with HarborDeviceTreeNodeProvider {
     interruptCells: 2,
     properties: {'riscv,num-sources': sources},
   );
+
+  @override
+  HarborAcpiDevice get acpiDevice => HarborAcpiDevice(
+    hid: 'PRP0001',
+    uid: 0,
+    memory: [BusAddressRange(baseAddress, 0x8000)],
+    properties: {
+      'compatible': ['riscv,aplic'],
+      'riscv,num-sources': sources,
+      'interrupt-controller': true,
+      '#interrupt-cells': 2,
+    },
+  );
 }

packages/harbor/lib/src/peripherals/clint.dart

@@ -3,6 +3,7 @@ import 'package:rohd_bridge/rohd_bridge.dart';
 
 import '../bus/bus.dart';
 import '../bus/bus_slave_port.dart';
+import '../soc/acpi.dart';
 import '../soc/device_tree.dart';
 
 /// RISC-V Core Local Interruptor (CLINT), SiFive-compatible.
@@ -16,7 +17,8 @@ import '../soc/device_tree.dart';
 /// - `mtime`:          0xBFF8           (8 bytes, machine timer)
 ///
 /// Address space: 64 KB (0x10000).
-class HarborClint extends BridgeModule with HarborDeviceTreeNodeProvider {
+class HarborClint extends BridgeModule
+    with HarborDeviceTreeNodeProvider, HarborAcpiDeviceProvider {
   final int? busDataWidth;
 
   /// Number of harts this CLINT serves.
@@ -168,4 +170,15 @@ class HarborClint extends BridgeModule with HarborDeviceTreeNodeProvider {
     reg: BusAddressRange(baseAddress, 0x10000),
     properties: {'reg-names': 'control'},
   );
+
+  @override
+  HarborAcpiDevice get acpiDevice => HarborAcpiDevice(
+    hid: 'PRP0001',
+    uid: 0,
+    memory: [BusAddressRange(baseAddress, 0x10000)],
+    properties: {
+      'compatible': ['riscv,clint0'],
+      'reg-names': 'control',
+    },
+  );
 }

packages/harbor/lib/src/peripherals/ddr.dart

@@ -5,6 +5,7 @@ import '../bus/bus.dart';
 import 'ddr_phy_ecp5.dart';
 import 'ddr_sequencer.dart';
 import '../bus/bus_slave_port.dart';
+import '../soc/acpi.dart';
 import '../soc/device_tree.dart';
 import '../util/pretty_string.dart';
 
@@ -164,7 +165,7 @@ class HarborDdrConfig with HarborPrettyString {
 /// unimplemented shells until their PHYs exist; a Xilinx 7-series PHY for
 /// the Arty S7 reuses the sequencer.
 class HarborDdrController extends BridgeModule
-    with HarborDeviceTreeNodeProvider {
+    with HarborDeviceTreeNodeProvider, HarborAcpiDeviceProvider {
   final int? busDataWidth;
 
   /// Memory configuration.
@@ -391,4 +392,23 @@ class HarborDdrController extends BridgeModule
       'clock-frequency': config.frequency,
     },
   );
+
+  @override
+  HarborAcpiDevice get acpiDevice => HarborAcpiDevice(
+    hid: 'PRP0001',
+    uid: 0,
+    memory: [BusAddressRange(baseAddress, config.size)],
+    properties: {
+      'compatible': [
+        'harbor,sdram-controller',
+        if (config.isSdr) 'harbor,sdr-sdram',
+        if (config.type == HarborDdrType.ddr3 ||
+            config.type == HarborDdrType.ddr3l)
+          'harbor,ddr3-sdram',
+      ],
+      'sdram-type': config.type.name,
+      'data-width': config.dataWidth,
+      'clock-frequency': config.frequency,
+    },
+  );
 }

packages/harbor/lib/src/peripherals/display.dart

@@ -3,6 +3,7 @@ import 'package:rohd_bridge/rohd_bridge.dart';
 
 import '../bus/bus.dart';
 import '../bus/bus_slave_port.dart';
+import '../soc/acpi.dart';
 import '../soc/device_tree.dart';
 import '../util/pretty_string.dart';
 
@@ -226,7 +227,7 @@ class HarborDisplayConfig with HarborPrettyString {
 /// - 0x20: INT_STATUS (W1C: vblank, underrun)
 /// - 0x24: INT_ENABLE
 class HarborDisplayController extends BridgeModule
-    with HarborDeviceTreeNodeProvider {
+    with HarborDeviceTreeNodeProvider, HarborAcpiDeviceProvider {
   /// Display configuration.
   final HarborDisplayConfig config;
 
@@ -487,4 +488,17 @@ class HarborDisplayController extends BridgeModule
       'max-height': config.maxHeight,
     },
   );
+
+  @override
+  HarborAcpiDevice get acpiDevice => HarborAcpiDevice(
+    hid: 'PRP0001',
+    uid: 0,
+    memory: [BusAddressRange(baseAddress, 0x1000)],
+    properties: {
+      'compatible': ['harbor,display'],
+      'output-interface': config.interface_.name,
+      'max-width': config.maxWidth,
+      'max-height': config.maxHeight,
+    },
+  );
 }

packages/harbor/lib/src/peripherals/dma.dart

@@ -3,6 +3,7 @@ import 'package:rohd_bridge/rohd_bridge.dart';
 
 import '../bus/bus.dart';
 import '../bus/bus_slave_port.dart';
+import '../soc/acpi.dart';
 import '../soc/device_tree.dart';
 import '../util/pretty_string.dart';
 
@@ -81,7 +82,7 @@ class HarborDmaChannelConfig with HarborPrettyString {
 /// - 0x004: INT_STATUS (per-channel interrupt status, W1C)
 /// - 0x008: INT_ENABLE (per-channel interrupt enable)
 class HarborDmaController extends BridgeModule
-    with HarborDeviceTreeNodeProvider {
+    with HarborDeviceTreeNodeProvider, HarborAcpiDeviceProvider {
   /// Number of DMA channels.
   final int channels;
 
@@ -343,4 +344,16 @@ class HarborDmaController extends BridgeModule
     reg: BusAddressRange(baseAddress, 0x1000),
     properties: {'dma-channels': channels, '#dma-cells': 1},
   );
+
+  @override
+  HarborAcpiDevice get acpiDevice => HarborAcpiDevice(
+    hid: 'PRP0001',
+    uid: 0,
+    memory: [BusAddressRange(baseAddress, 0x1000)],
+    properties: {
+      'compatible': ['harbor,dma'],
+      'dma-channels': channels,
+      '#dma-cells': 1,
+    },
+  );
 }

packages/harbor/lib/src/peripherals/efuse.dart

@@ -3,6 +3,7 @@ import 'package:rohd_bridge/rohd_bridge.dart';
 
 import '../bus/bus.dart';
 import '../bus/bus_slave_port.dart';
+import '../soc/acpi.dart';
 import '../soc/device_tree.dart';
 
 /// eFuse bank configuration.
@@ -189,7 +190,8 @@ class HarborEfuseBlock extends BridgeModule {
 /// - 0x14: LOCK       (per-region lock bits, write-1-to-lock)
 /// - 0x18: TIMING     (program pulse width in clock cycles)
 /// - 0x1C: KEY        (write 0x4F545021 to unlock programming)
-class HarborEfuseDevice extends BridgeModule with HarborDeviceTreeNodeProvider {
+class HarborEfuseDevice extends BridgeModule
+    with HarborDeviceTreeNodeProvider, HarborAcpiDeviceProvider {
   /// Base address in the SoC memory map.
   final int baseAddress;
 
@@ -446,4 +448,20 @@ class HarborEfuseDevice extends BridgeModule with HarborDeviceTreeNodeProvider {
       '#size-cells': 1,
     },
   );
+
+  @override
+  HarborAcpiDevice get acpiDevice => HarborAcpiDevice(
+    hid: 'PRP0001',
+    uid: 0,
+    memory: [BusAddressRange(baseAddress, 0x1000)],
+    properties: {
+      'compatible': ['harbor,efuse', 'harbor,otp'],
+      'harbor,total-bits': config.totalBits,
+      'harbor,bits-per-word': config.bitsPerWord,
+      'harbor,regions': config.regions,
+      'harbor,unlock-key': programUnlockKey,
+      '#address-cells': 1,
+      '#size-cells': 1,
+    },
+  );
 }