Merged in manu-191007_update_document_starting-kit (pull request #5)

Manu 191007 update document starting kit

Merged in manu-191007_update_document_starting-kit (pull request #5)
Manu 191007 update document starting kit
2c23e936 · Manuel Castilla · Benoit Rat · fab399bd · 88d3ff67 · fab399bd
Commit 2c23e936 authored Oct 08, 2019 by Manuel Castilla Committed by Benoit Rat Oct 08, 2019
11 changed files
--- a/doc/img/ssk_ txpps.png
+++ b/doc/img/ssk_ txpps.png
--- a/doc/img/ssk_100Hz.png
+++ b/doc/img/ssk_100Hz.png
--- a/doc/img/ssk_components.jpg
+++ b/doc/img/ssk_components.jpg
--- a/doc/img/ssk_configs.png
+++ b/doc/img/ssk_configs.png
--- a/doc/img/ssk_inside.jpg
+++ b/doc/img/ssk_inside.jpg
--- a/doc/img/ssk_lemo.jpg
+++ b/doc/img/ssk_lemo.jpg
--- a/doc/img/ssk_playdio.png
+++ b/doc/img/ssk_playdio.png
--- a/doc/img/ssk_pps-setup.png
+++ b/doc/img/ssk_pps-setup.png
--- a/doc/img/ssk_sfp.jpg
+++ b/doc/img/ssk_sfp.jpg
--- a/doc/img/ssk_usb.jpg
+++ b/doc/img/ssk_usb.jpg
--- a/doc/wr-starting-kit.md
+++ b/doc/wr-starting-kit.md
@@ -224,7 +224,7 @@ experiments you will need:
 This tutorial has been tested and verified with Ubuntu LTS 16.04.6 (kernel v.4.15.9) and Ubuntu LTS 18.04.2 (kernel v.4.18.0-17), this mean that standard support will only be given for these releases.
 However, the `spec-sw` driver should work with other releases, distributions and architectures.

-![Configuration with one or two PCs](img/ssk_configs.png)
+![Configuration with one two PCs](img/ssk_configs.png)

 Starting kit components
 -----------------
@@ -295,9 +295,9 @@ You should obtain something similar as:
 01:00.0 Non-VGA unclassified device: CERN/ECP/EDU Device 018d (rev 03)
 ~~~~~~~~~~

-Where `01` and `0b` represent the ID of the PCIe slot given by your motherboard.
+Where `01` represent the ID of the PCIe slot given by your motherboard.
 > **Note**: The PCIe slot numbering are normally ordered from top to bottom on the motherboard,
-this mean that the board with ID `01` will be above the one with index `0b`.
+this mean that the board with ID `01` will be above.


 Tools
@@ -549,7 +549,7 @@ The White Rabbit Core Shell

 Once you are in the UART you should obtain the White Rabit Core console (`wrc#`).
 A complete reference of the shell commands is included in the [wrpc.pdf] manual or
-you can read them in the [Wiki](http://www.ohwr.org/projects/wr-cores/wiki/Wrpc_shell)
+you can read them in the [Wiki](https://www.ohwr.org/project/wr-cores/wikis/home)

 The most useful commands are repeated here for your convenience

@@ -561,8 +561,8 @@ The most useful commands are repeated here for your convenience

 For the tutorial we will use the following names:

-* `wrc1#` for `wrc#` console of the main board (wri1/busID=0x0100) on the PC1
-* `wrc2#` for `wrc#` console of the main board (wri1/busID=0x0100) on the PC2
+* `wrc1#` for `wrc#` console of the main board (wri1/busID=0x0100) on the PC01
+* `wrc2#` for `wrc#` console of the main board (wri1/busID=0x0100) on the PC02


 Configure in slave & master mode
@@ -795,7 +795,7 @@ ch 4,       542.500000000
 ~~~~~~~~

 > ***Notes:*** If you see other timestampings messages coming from channel 2 this mean you don't
-have disabled the PPS mode. Check [Disabling PPS](#disabling-pps-on-channel-2) section.
+have disabled the PPS mode.


 ### Time stamping input & output.
@@ -846,6 +846,7 @@ However with the next experiment you will find out that the synchronization is b

 Synchronization of PPS
 ----------------------------------------------------------------------------------------
+<!--TODO: spec-sw.pdf does not exist -->

 This corresponds to the experiment from [spec-sw.pdf:6.8][spec-sw.pdf] document.
 Here we want to synchronize the PPS of the master and slave boards using WR protocol on a fiber.
@@ -1049,6 +1050,8 @@ The *ruler* waits for timestamps to appear on a specific input channel;
 when a positive-going edge occurs the *ruler* notifies it or replicates the edge on one or more outputs.
 Each output can be local or remote, and can use a different delay from the input pulse.

+<!--TODO: spec-sw.pdf does not exist -->
+
 For further details (deeper studies) the user is recommended to read the [spec-sw.pdf:6.8][spec-sw.pdf] document
 and to also take a look at the source code of `wr-dio-agent` and `wr-dio-ruler`

@@ -1224,7 +1227,7 @@ wrc# ptp start
 ~~~~~~~

 Then you should run the [WRS] in master or grandmaster mode as explained
- in [wr-switch-guide.pdf].
+ in (Resources) [wr-switch-guide.pdf].

 Finally you need to connect the slave SFPs (blue) to the [SPEC]s and the
 master SFP (violet) to the switch.
@@ -1371,6 +1374,8 @@ Run in standalone

 You can also run GM in a full standalone mode in order to transmit WR clock without the need of a PC.

+<!--TODO: The package does not exist -->
+
 First you need to flash the SPEC with the latest bitstream you can find the package:
 <http://www.sevensols.com/dl/wr-nic/bin/latest_stable.tar.gz>

@@ -1485,17 +1490,19 @@ However we provide here a simple resume of the steps required to compile the fir
 You should also look at the [wrpc.pdf] to understand how to use it and
 how to compile new firmware for other configurations.

-You can download it from [wr-nic-v2.0.tar.gz](http://www.ohwr.org/projects/wr-nic/files) file or you can try to compile it following the instructions below:

 You first need to install the **lm32** compiler as suggested in
 [wrpc.pdf], and then you need to compile it using the specific configuration as bellow:

+<!--TODO: update checkout and configure -->
+
 ~~~~~~{.sh}
 ## Set up CROSS_COMPILE variable for this terminal
 export CROSS_COMPILE="<your_path_to_lm32>/lm32/bin/lm32-elf-";

 ## Clone the repository
-git clone git://ohwr.org/hdl-core-lib/wr-cores/wrpc-sw.git
+git clone https://ohwr.org/project/wrpc-sw.git
+
 cd wrpc-sw

 ## Checkout the stable release
@@ -1531,10 +1538,13 @@ WR-NIC (HDL-gateware)
 This step shows us how to prepare the WR-NIC bitstream ([SPEC+FMCDIO]) with
 the wrpc-sw (`wrc.ram` file) embedded inside.

+<!--TODO: update checkout -->
+
 ~~~~~~{.bash}
 ## Checkout the code
-git clone git://ohwr.org/white-rabbit/wr-nic.git
+git https://ohwr.org/project/wr-nic.git
 cd wr-nic
+
 git checkout -b wr-nic-v2.0 wr-nic-v2.0

 ## Create and update the submodules
@@ -1551,11 +1561,6 @@ make

 You should finally obtain the bitstream to import in your [FMC] driver folder.

-> **Notes**: You must  have the proper version of hdlmake installed, please
-check the manual [wr-nic.pdf] for more information on how to synthesize the
-gateware.
-
-
 Frequently Added Questions
 ===========================

@@ -1570,7 +1575,7 @@ we strongly recommand you to visit the webpage:
 and you might also find information there:

 * <http://www.ohwr.org/projects/spec/wiki/FAQ>
-* <http://www.ohwr.org/projects/wr-cores/wiki/Wrpc_faq>
+* <https://www.ohwr.org/project/wr-cores/wikis/home>


 Resume
@@ -1583,30 +1588,17 @@ However, you will find a resume of the most asked questions below:

 In all of those cases the PLL has to be locked. That means your card has to be either in Master Mode, Grand Master or Slave Mode.

-When you have only one card (or some but unconnected) it should be working as Free Running Master. If you have two of them (or more), one of them has to work as master, the others as Slaves and all of them have to be synced via PTP as explained en section [4.3](#configure-in-slave-master-mode). To say that is running Grand Master Mode is to make sure the PLL has already been locked to the external reference (see [Appendix](#appendix)).
+When you have only one card (or some but unconnected) it should be working as Free Running Master. If you have two of them (or more), one of them has to work as master, the others as Slaves and all of them have to be synced via PTP as explained en section [4.3](#configure-in-slave-master-mode). To say that is running Grand Master Mode is to make sure the PLL has already been locked to the external reference.

 ### I don't see the interface using ifconfig

 Please check if you see them using `ifconfig -a`, if you see them by using the `-a` option you just need
-to bring them up. This is explained in the [Bring up the network interface](#bring-up-the-network-interface) section.
-
-### Compilation of spec-sw is impossible
-
-To compile you must have at least the 2.6.36 kernel (errors occurs with
-2.6.32, 2.6.34). We recommend you to use the latest version of your distribution.
-
-If you think you have the correct setup you can also use our automatic build
-script that also generate a report with your system information.
-
-	sudo scripts/wr-ssk-get --report
-
-After a few minutes your project should have been installed correctly, if you
-still have problems send us the generated `report.log` files in the main folder.
+to bring them up. This is explained in the [Check the network interface](#Check-the-network-interface) section.


 ### The starting kit is based on Ubuntu. How can I use it with Scientific Linux?

-The commands to execute in order to update the kernel using scientific linux (you need at least the 2.6.36 to compile the starting kit) are:
+The commands to execute in order to update the kernel using scientific linux (you need at least the 4.15.9 to compile the starting kit) are:

 ~~~~~{.bash}
 rpm --import http://elrepo.org/RPM-GPG-KEY-elrepo.org
@@ -1615,7 +1607,7 @@ sudo yum --enablerepo=elrepo-kernel --skip-broken install kernel-lt kernel-lt-de
 ~~~~~~~~~~

 You can have more information on how to do this by browsing the (http://elrepo.org/tiki/tiki-index.php "ELRepo Project")
-After this you should reboot your PC with the new kernel source and start from [section compile & install](#compile-install)
+After this you should reboot your PC with the new kernel source and start from [Compile & Install the project](#Compile-&-Install-the-project)


 ### I can't detect any level on my inputs.
@@ -1670,8 +1662,10 @@ following commands:

 ~~~~~~~{.sh}
 >:$ sudo insmod kernel/fmc.ko
+>:$ sudo insmod kernel/htvic.ko
 >:$ sudo insmod kernel/spec.ko
 >:$ sudo insmod kernel/wr-nic.ko
+>:$ sudo insmod kernel/wr-dio.ko
 ~~~~~~~~~~~~~

 ### The system hangs-up
@@ -1725,25 +1719,27 @@ WRC / WRPC
 : 	White Rabbit Switch


-[WR]:http://www.sevensols.com/whiterabbitsolution
-[WRS]: http://www.sevensols.com/en/products/wr-switch.html
+[WR]:https://www.ohwr.org/project/white-rabbit/wikis/home
+[WRS]: https://sevensols.com/index.php/products/white-rabbit-switch/
 [WRSSK]: http://www.sevensols.com/en/products/wr-starting-kit.html
 [SPEC+FMCDIO]: http://sevensols.com/index.php/kit-spec/
 [SPEC]: http://sevensols.com/index.php/products/spec/
 [FMC]: http://www.ohwr.org/projects/fmc-projects
 [FMC-DIO]: http://sevensols.com/index.php/fmc-dio/
 [FMCDIO]: http://sevensols.com/index.php/fmc-dio/
-[FMC fine-delay]: http://www.sevensols.com/en/products/fmc-del.html
+[FMC fine-delay]: https://sevensols.com/index.php/fmc-del/
 [OHWR]: http://www.ohwr.org/projects/white-rabbit
+[fmc-dio-5chttla]: https://ohwr.org/project/fmc-dio-5chttla/



 References
 ============

+<!--TODO: spec-sw.pdf link does not exist -->
+
 * [spec-sw.pdf] main documentation of the spec-sw
 * [wrpc.pdf] White Rabbit Core documentation
-* [fmc-bus.pdf] How the FMC bus driver works and how to write one for your own FMC board.
 * SFPs information <http://www.ohwr.org/projects/white-rabbit/wiki/SFP>
 * White Rabbit Calibration: <http://www.ohwr.org/documents/213>
 * [spec-2-spec]  SPEC-2-SPEC demo
@@ -1754,11 +1750,14 @@ References



-[wr-switch-guide.pdf]: http://www.sevensols.com/dl/wr-switch-sw/startupguide/latest_stable.pdf
+[wr-switch-guide.pdf]: https://sevensols.com/index.php/products/white-rabbit-switch/
 [wr-nic]: http://www.ohwr.org/projects/wr-nic/
 [wr-starting-kit]: http://www.ohwr.org/projects/wr-starting-kit/
 [spec-sw]: http://www.ohwr.org/projects/spec-sw/
 [wrpc-sw]: http://www.ohwr.org/projects/wrpc-sw/
+
+<!--TODO: spec-golden link does not exist -->
+
 [spec-golden]: http://www.ohwr.org/projects/spec/repository/show/trunk/hdl/golden
 [spec-2-spec]: http://www.ohwr.org/projects/wr-cores/wiki/spec-to-spec
 [spec-getting-started.pdf]:http://www.ohwr.org/projects/spec-getting-started/wiki
@@ -1768,4 +1767,4 @@ References
 [wr_external_reference.pdf]: http://www.ohwr.org/attachments/1647/wr_external_reference.pdf
 [wrpc.pdf]: http://www.ohwr.org/attachments/2559/wrpc-v2.1.pdf
 [wrpc-v2.1.pdf]: http://www.ohwr.org/attachments/2559/wrpc-v2.1.pdf
-[Seven Solutions]: http://www.sevensols.com
+[Seven Solutions]: http://www.sevensols.com
\ No newline at end of file