Update documentation

README.md

@@ -8,7 +8,11 @@
 
 ## Documentation
 
-Documentation covering installation and usage can be found here http://yarr.rtfd.org (for devel branch http://yarr.readthedocs.org/en/devel/ )
+For details please refer to the documentation covering installation and usage, which can be found here http://yarr.rtfd.org 
+
+This README only includes quick install guide.
+
+(If you are working with the devel branch refer to http://yarr.readthedocs.org/en/devel/ )
 
 ## Mailing list
 
@@ -18,10 +22,6 @@ Developers and potential developers please refer to [Contribution](CONTRIBUTING.
 
 ## Requirements
 
-### Hardware:
-
-- Please refer to the [documentation](http://readthedocs.org/projects/yarr/badge/?version=latest) for details
-
 ### Software:
 
 - CentOS 7

docs/fw_guide.md

@@ -11,25 +11,4 @@ For the XpressK7 there will always be two version (black), one -**160** and one
 - ``bram_rd53a_quad_ohio-XXX/rd53a_quad_ohio_160Mbps.bit`` => Single RD53A channel enabled on Port A
 - ``bram_rd53a_quad_ohio-XXX/rd53a_quad_ohio_160Mbps_4chip.bit`` => To enable all four channels.
 - ``bram_rd53a_quad_ohio-XXX/rd53a_quad_ohio_160Mbps_2chip2trig.bit`` => To enable two channels for chip readout and two channels for HitOr (to be added).
-- In order to power correctly the adapter card, a jumper needs to be added to **3V PCI** pin, as shown on picture below.
-
-![Jumper on FMC Multi-Module Adapter Card ](images/Ohio_jumper.png)
-
-When the board is powered correctly, a red LED should light up. More information about the adapter card can be found [Multi Chip Adapter Card](https://twiki.cern.ch/twiki/bin/viewauth/RD53/RD53ATesting#Multi_Chip_FMC).
-
-On a SCC [Single Chip Card](https://twiki.cern.ch/twiki/bin/viewauth/RD53/RD53ATesting#RD53A_Single_Chip_Card_SCC) the CMD line is AC coupled. On the older Ohio card (before 2019 and serial number < 200) there is additional AC coupling as shown on the picture. This is corrected for the newer Ohio cards from 2019 on with serial number starting from 200.
-
-![Ohio Unmodified CMD ](images/OhioUnmodified_Cmd.png)
-
-To avoid double AC coupling on the CMD line, one should replace the capacitors with jumpers and remove the termination, as shown on the picture.
-
-![Ohio Modified CMD ](images/OhioModified_Cmd.png)
-
-In order to read the HitOrs from Port B and Port D, one has to modify the AC coupling of the data lines on the Ohio card:
-
-![Ohio Unmodified Data ](images/OhioUnmodified_Data.png)
-
-The capacitors should be replaced with jummpers as shown on the picture:
-
-![Ohio Modified Data ](images/OhioModified_Data.png)
 

docs/pcie.md

@@ -86,7 +86,7 @@ source /opt/Xilinx/Vivado_Lab/2016.4/settings64.sh
 
 Details can be found in the [Yarr-FW](https://github.com/Yarr/Yarr-fw/blob/master/syn/xpressk7/README.md). The following will describe the simplest way:
 
-- Execute the ``flash.py`` python script:
+- Execute the ``flash.py`` python script if you use the XpressK7 and the ``flash-trenz.py`` id you are using the Trenz card:
 ```bash
 $ cd Yarr-fw/script
 $ python flash.py
@@ -133,3 +133,28 @@ Success! No errors.
 
 - Your system is now ready to use
 
+## Adapter Cards
+
+### Ohio RD53A Multi Module Adapter
+
+- In order to power correctly the adapter card, a jumper needs to be added to **3V PCI** pin, as shown on picture below.
+
+![Jumper on FMC Multi-Module Adapter Card ](images/Ohio_jumper.png)
+
+When the board is powered correctly, a red LED should light up. More information about the adapter card can be found [Multi Chip Adapter Card](https://twiki.cern.ch/twiki/bin/viewauth/RD53/RD53ATesting#Multi_Chip_FMC).
+
+On a SCC [Single Chip Card](https://twiki.cern.ch/twiki/bin/viewauth/RD53/RD53ATesting#RD53A_Single_Chip_Card_SCC) the CMD line is AC coupled. On the older Ohio card (before 2019 and serial number < 200) there is additional AC coupling as shown on the picture. This is corrected for the newer Ohio cards from 2019 on with serial number starting from 200.
+
+![Ohio Unmodified CMD ](images/OhioUnmodified_Cmd.png)
+
+To avoid double AC coupling on the CMD line, one should replace the capacitors with jumpers and remove the termination, as shown on the picture.
+
+![Ohio Modified CMD ](images/OhioModified_Cmd.png)
+
+In order to read the HitOrs from Port B and Port D, one has to modify the AC coupling of the data lines on the Ohio card:
+
+![Ohio Unmodified Data ](images/OhioUnmodified_Data.png)
+
+The capacitors should be replaced with jummpers as shown on the picture:
+
+![Ohio Modified Data ](images/OhioModified_Data.png)