Skip to content

Commit 2043b63

Browse files
author
Maximilian
committed
Merge branch 'master' of https://github.com/fpgasystems/Coyote
2 parents 6c4ad9a + eed59f0 commit 2043b63

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

README.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -131,6 +131,24 @@ Coyote already comes with a number of pre-configured example applications that c
131131

132132
#### tcp_iperf
133133

134+
## Deploying on the ETHZ HACC-cluster
135+
The ETHZ HACC is a premiere cluster for research in systems, architecture and applications (https://github.com/fpgasystems/hacc/tree/main). Its hardware equipment provides the ideal environment to run Coyote-based experiments, since users can book up to 10 servers with U55C-accelerator cards connected via a fully switched 100G-network. User accounts for this platform can be obtained following the explanation on the previously cited homepage.
136+
137+
The interaction with the HACC-cluster can be simplified by using the sgutil-run time commands. They also allow to easily program the accelerator with a Coyote-bitstreamd and insert the driver. For this purpose, the script `program_coyote.sh` has been generated. Under the assumption that the hardware-project has been created in `examples_hw/build` and the driver is already compiled in `driver`, the workflow should look like this:
138+
139+
~~~
140+
$ bash program_coyote.sh examples_hw/build/bitstreams/cyt_top.bit driver/coyote_drv.ko
141+
~~~
142+
143+
Obviously, the paths to `cyt_top.bit` and `coyote_drv.ko` need to be adapted if a different build-structure has been chosen before.
144+
A successful completion of this process can be checked via a call to
145+
146+
~~~
147+
$ dmesg
148+
~~~
149+
150+
If the driver insertion went through, the last printed message should be `probe returning 0`. Furthermore, the dmesg-printout should contain a line `set network ip XXXXXXXX, mac YYYYYYYYYYYY`, which displays IP and MAC of the Coyote-NIC if networking has been enabled in the system configuration.
151+
134152
## Publication
135153

136154
#### If you use Coyote, cite us :

0 commit comments

Comments
 (0)