From cb00f021981cefe3d0a58fe2020fcf5dcabb3e85 Mon Sep 17 00:00:00 2001
From: Ian Moffett <ian@osmora.org>
Date: Sun, 4 Aug 2024 20:58:18 -0400
Subject: soc: Add peripheral memory map

Signed-off-by: Ian Moffett <ian@osmora.org>
---
 sv/soc/bus/bus.md     | 24 ++++++++++++++++++++++++
 sv/soc/irq/irqchip.md |  2 +-
 sv/soc/irq/pimc.sv    |  2 +-
 3 files changed, 26 insertions(+), 2 deletions(-)
 create mode 100644 sv/soc/bus/bus.md

(limited to 'sv/soc')

diff --git a/sv/soc/bus/bus.md b/sv/soc/bus/bus.md
new file mode 100644
index 0000000..8179518
--- /dev/null
+++ b/sv/soc/bus/bus.md
@@ -0,0 +1,24 @@
+# Device Memory Map
+
+Device memory begins at physical address `0x1000000`, below is a table showing which devices
+each range is assigned to.
+
+| Physical Address | Device                           | Size (bytes) |
+| ---------------- | -------------------------------- | ------------ |
+| 0x1000000        | PIMC IRQ Table (pin 0)           | 4            |
+| 0x1000004        | PIMC IRQ Table (pin 1)           | 4            |
+| 0x1000008        | PIMC IRQ Table (pin 2)           | 4            |
+| 0x100000C        | PIMC IRQ Table (pin 3)           | 4            |
+| 0x1000010        | PIMC IRQ Table (pin 4)           | 4            |
+| 0x1000014        | PIMC IRQ Table (pin 5)           | 4            |
+| 0x1000018        | PIMC IRQ Table (pin 6)           | 4            |
+| 0x100001C        | PIMC IRQ Table (pin 7)           | 4            |
+| 0x1000020        | PIMC IRQ Table (pin 8)           | 4            |
+| 0x1000024        | PIMC IRQ Table (pin 9)           | 4            |
+| 0x1000028        | PIMC IRQ Table (pin 10)          | 4            |
+| 0x100002C        | PIMC IRQ Table (pin 11)          | 4            |
+| 0x1000030        | PIMC IRQ Table (pin 12)          | 4            |
+| 0x1000034        | PIMC IRQ Table (pin 13)          | 4            |
+| 0x1000038        | PIMC IRQ Table (pin 14)          | 4            |
+| 0x100003C        | PIMC IRQ Table (pin 15)          | 4            |
+| 0x1000040        | Reserved                         | 4096         |
diff --git a/sv/soc/irq/irqchip.md b/sv/soc/irq/irqchip.md
index d011e15..7f3ce1a 100644
--- a/sv/soc/irq/irqchip.md
+++ b/sv/soc/irq/irqchip.md
@@ -47,7 +47,7 @@ is pulled high and LINENO[7:0] is cleared to zero.
 ## MMIO Interface
 
 Some registers within the PIMC chip are memory mapped and can be accessed through the MMIO interface. For example,
-the IRQ table is accessed through physical address 0x1000 + OFFSET.
+the IRQ table is accessed through physical address 0x1000000 + OFFSET.
 
 ### MMIO Interface Semantics
 
diff --git a/sv/soc/irq/pimc.sv b/sv/soc/irq/pimc.sv
index 8bed807..15b82c9 100644
--- a/sv/soc/irq/pimc.sv
+++ b/sv/soc/irq/pimc.sv
@@ -35,7 +35,7 @@
 module pimc #(
         parameter IRQ_PIN_COUNT = 16,
         parameter IRQTAB_ENTSIZE = 32,
-        parameter IRQTAB_MMIOBASE = 48'h1000
+        parameter IRQTAB_MMIOBASE = 48'h1000000
     ) (
         input wire clk,         /* 50 MHz */
         input logic [IRQ_PIN_COUNT-1:0] irq_in,
-- 
cgit v1.2.3