driver/quartushpsdriver: add support for Quartus HPS

[Bastian-Krause]

Adds the driver itself, an example strategy and documentation.

The example strategy can be used like this:

targets
  my-target:
    resources:
      RemotePlace:
        name: 'my-target'
    drivers:
      - QuartusHPSDriver: {}
      - SerialDriver:
          txdelay: 0.01
      - NetworkPowerDriver:
          delay: 5.0
      - BareboxDriver:
          prompt: 'barebox@[^:]+:[^ ]+ '
          autoboot: "abort autoboot"
          interrupt: "\x03"
      - ShellDriver:
          prompt: 'root@[^:]+:[^ ]+'
          login_prompt: ' login: '
          username: 'root'
      - QuartusHPSStrategy:
          image_xload: /path/to/barebox-xload.img
          image: /path/to/barebox.img

imports:
- examples/strategy/quartusstrategy.py

Signed-off-by: Bastian Stender bst@pengutronix.de

[Bastian-Krause]

Should I include the configuration snippet from the commit message in the docs or is it self-explanatory enough? If yes, where should I include it?

[codecov-io]

Codecov Report

Merging #206 into master will decrease coverage by <.1%.
The diff coverage is 44.2%.

@@           Coverage Diff            @@
##           master    #206     +/-   ##
========================================
- Coverage    52.7%   52.6%   -0.1%     
========================================
  Files          91      92      +1     
  Lines        5161    5213     +52     
========================================
+ Hits         2722    2745     +23     
- Misses       2439    2468     +29

Impacted Files	Coverage Δ
labgrid/driver/__init__.py	100% <100%> (ø)	⬆️
labgrid/driver/quartushpsdriver.py	43.1% <43.1%> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update da27e4f...b044f96. Read the comment docs.

[Emantor]

Looks good, except your are not implementing a protocol.

I am not sure we want to include the strategy or start a seperate repository with examples. This way we could have the basic examples in here and more elaborate Strategies in another repo, splitting out that complexity from the actual library.

[Emantor]

This needs to implement a Protocol. BootstrapProtocol would be the obvious choice, however your driver implements an additional feature: choosing the address of where to load the file. I am not sure that we want to extend the existing protocol or define a new one for this.

[Bastian-Krause]

Pushed changes:

• add FlashProtocol
• let QuartusHPSDriver implement FlashProtocol
• adjust docs accordingly

I have no strong opinion if more elaborate strategies should be in another repository. @jluebbe ?

[jluebbe]

We discussed this internally and decided that having the FlashProtocol with this simple implementation doesn't help us much currently. Also, it would cause more churn when we add a more general FlashProtocol later. So we prefer to use the QuartusHPSDriver directly for now.

[Bastian-Krause]

Pushed changes:

• remove FlashProtocol

Should the QuartusHPSStrategy be part of Labgrid or do you want it in a separate repo?

[jluebbe]

Having the strategy in examples/ makes it easier to find, so I'll merge this as is.