From 6c3c5d831bcba38f2c23731566437adbdf112dc6 Mon Sep 17 00:00:00 2001
From: Lothar Rubusch <l.rubusch@gmx.ch>
Date: Sat, 19 Sep 2020 23:51:07 +0200
Subject: [PATCH 1/2] sopc2dts: fix compatibility for altera_pll

---
 sopc_components_altera.xml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/sopc_components_altera.xml b/sopc_components_altera.xml
index ead5c26..501e036 100644
--- a/sopc_components_altera.xml
+++ b/sopc_components_altera.xml
@@ -139,6 +139,10 @@
 		compatDevice="pll">
 		<CompatibleVersion value="1.0"></CompatibleVersion>
 	</S2DComponent>
+	<S2DComponent classname="altera_pll" group="clock"
+		compatDevice="pll">
+		<CompatibleVersion value="1.0"></CompatibleVersion>
+	</S2DComponent>
 	<S2DComponent classname="altera_avalon_timer" group="timer"
 		compatDevice="timer">
 		<parameter dtsName="clock-frequency"></parameter>

From 25a6d582b715fa48ac0e4a7d44ccb1a54a1f9e18 Mon Sep 17 00:00:00 2001
From: Lothar Rubusch <l.rubusch@gmx.ch>
Date: Tue, 3 Nov 2020 10:18:21 +0100
Subject: [PATCH 2/2] README: update

---
 README.md | 51 ++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 50 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 705f3d9..319712b 100644
--- a/README.md
+++ b/README.md
@@ -4,5 +4,54 @@ sopc2dts
 Tool to create a devicetree from a sopcinfo file generated by Altera
 
 More info available at:
-http://www.alterawiki.com/wiki/Sopc2dts
+http://www.alterawiki.com/wiki/Sopc2dts [R.I.P. alterawiki]
 http://rocketboards.org/foswiki/Documentation/DeviceTreeGenerator140
+
+
+Build
+=====
+
+Build the sopc2dts tool:  
+
+```
+$ git clone http<git remote>/sopc2dts.git
+$ cd sopc2dts
+$ make
+```
+
+Test the sopc2dts tool: test with `--gui`, in case fix typical errors.  
+
+```
+$ java -jar sopc2dts.jar --gui
+```
+
+
+Usage
+=====
+
+```
+$ java -jar ./sopc2dts.jar --force-altr -i ./<my project name>.sopcinfo -o <my project name>.dts
+```
+
+
+Issues
+======
+
+*  Installation verification fails as follows  
+
+```
+$ java -jar sopc2dts.jar --gui
+    Refusing to load . It does not exist
+```
+
+Fix typical sopc2dts errors: in case configure another java version  
+
+```
+$ sudo update-alternatives --config java
+```
+
+*  `Component sdram_pll of class altera_pll is unknown`
+alt_pll changed name to altera_pll -> in case may fix it in the java, or setup pll section yourself  
+
+*  addresses in DTS are decimal -> may edit the addresses to hex yourself  
+