The script now uses the same library files used by mass-multiboot.py, but is a
bit more interactive to the user than mass-multiboot.py.

mass-multiboot.py is intended to be used from the server directly to update
cards in a crate.

multiboot.py is intended to be used locally by a user, either to update a single
card, or to debug which gateware versions are loaded on the card's flash.

Changes:
- added progress string to output of read & write, instead of long address dumps
- more descriptive output in read and write
- increased timeout on IPROG command

This essential module is missing when cloning the repo, probably due to some
misunderstanding in the module's history of being added and removed from
.gitignore, for the sake of it being added ONCE and only ONCE and not having
to be modified ever again.

Hoping this issue will be once and FOR ALL solved...

The script now checks the board ID and if the board's a BLO PR, it checks the
version of the gateware and adapts the starting address of the MultiBoot
hardware module according to the gateware's memory map.

This is necessary due to the fact that the (soon-to-be-released) v3.0 gateware
changes the memory map and places the MultiBoot module at a different address.

NOTE: not yet tested with old gateware versions, but should work

Two scripts were implemented. The first reads out the channel and the second
clears them.

Apart from that, a small change was added to pulsetest, which now displays a
correct message when the board ID is not the ASCII for "TBLO".

- corrected small errors (readreg instead of writereg in "Remote reset"
  section, various typos
- added a little bit of info
- made "Revision history", "List of abbreviations" and "References"
  sections appear in the Contents and the bookmarks of the .pdf
- also made Contents appear in bookmarks, without it appearing in the
  actual Contents

The modifications can be read from the .pdf doc, Revision history
section. First `make' the ug, then go to this section to see the
modifications

Also added channel frequency in output file.
Signed-off-by: Theodor Stana <t.stana@cern.ch>

Signed-off-by: Theodor Stana <t.stana@cern.ch>

Signed-off-by: Theodor Stana <t.stana@cern.ch>

Signed-off-by: Theodor Stana <t.stana@cern.ch>

Signed-off-by: Theodor Stana <t.stana@cern.ch>

Signed-off-by: Theodor Stana <t.stana@cern.ch>

Signed-off-by: Theodor Stana <t.stana@cern.ch>

This .gitignore will avoid headaches when changing your ei2cdefine.py to
contain username and passwords for your ELMA crate.
Signed-off-by: Theodor Stana <t.stana@cern.ch>

The old gwvers.py script has been changed to getsr.py, which
lists the fields of the board status register in a more comprehensive
manner.

Then, the setsr.py script has been added as a means to clear set error
bits.

Note that unlike what the git commit output below states, the
gwvers.py was actually renamed (and changed to) getsr.py.
Signed-off-by: Theodor Stana <t.stana@cern.ch>

The script was reporting a success in writing the .mcs file even though
PROMGEN exits with an error and an .mcs file is not generated. This
error is now fixed by checking the return value of the PROMGEN command.
Signed-off-by: Theodor Stana <t.stana@cern.ch>

Signed-off-by: Theodor Stana <t.stana@cern.ch>

Signed-off-by: Theodor Stana <t.stana@cern.ch>

Signed-off-by: Theodor Stana <t.stana@cern.ch>

Signed-off-by: Theodor Stana <t.stana@cern.ch>

Signed-off-by: Theodor Stana <t.stana@cern.ch>