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  
+
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>