From 355582592e00f21979d92ca99a0872d09b9a3da9 Mon Sep 17 00:00:00 2001
From: dansmathers <63661035+dansmathers@users.noreply.github.com>
Date: Thu, 8 Apr 2021 14:06:06 -0600
Subject: [PATCH] attempt at a DTS entry for CLIC for issue #91

recreating a pull because pull #130 had merge issues.
---
 clic.adoc | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/clic.adoc b/clic.adoc
index 419db26..f4fe7f5 100644
--- a/clic.adoc
+++ b/clic.adoc
@@ -2223,3 +2223,27 @@ Interrupt map with PLIC recommendation:
 The CLIC specification does not dictate how CLIC memory-mapped registers are split between M/S/U regions as well as the layout of multiple harts as this is generally a platform issue and each platform needs to define a discovery mechanism to determine the memory map locations. Some considerations for platforms to consider are selecting regions that allow for efficient PMP and virtual memory configuration.
 For example, it may desired that the bases of each S/U-mode CLIC region is VM page (4k) aligned so they can be mapped through the TLBs.
 
+== Appendix
+
+=== Prototype DTS Entry
+Modified from Example at https://elinux.org/Device_Tree_Usage
+
+/dts-v1/;
+
+/ {
+    ...
+    
+    interrupt-parent = <&intc>;
+    
+    ...
+
+    intc: interrupt-controller@MCLICBASE {
+        compatible = "xxx,xxx";
+        reg = <MCLICBASE 0x5000 >;
+        interrupt-controller;
+        #interrupt-cells = <NUM_INTERRUPT>;
+    };
+    
+    ...
+    
+};