Change Serial Channels during a running job

For the general usage of FPGA Serial Channels visit the main documentation page.

Sometimes a previously configured topology needs to be reconfigured, either because the topology was specified incorrectly or a different topology is required. This would entail saving the state of the job, canceling the running job and submitting a new job. By using the tool changeFPGAlinks mid-job you can change the topology on-the-fly without canceling the running allocation. This tool can also be used as a quick and handy way to visualize the current configuration with the FPGA-Link-GUI.

Usage

• The tool currently only works directly on the FPGA-Nodes during a running job.

• When the tool returns, the topology is changed to the requested one.

• After changing the topology, make sure to reset or reprogram your FPGA designs. Otherwise the network interfaces may get stuck in an undefined state.

• You can run the tool as often as you need topology changes.

Preparation

First submit a job like normal. You can start without any intial links set:

...

Then you can run the commandchangeFPGAlinks. The command names might be subject to changes in the near future. You can run the command to specify a new topology, or run it without topology arguments to check the current status.

Examples for running the command without a topology

This will only generate a overview and not change anything, but can be useful for documenting the current status:

...

fpga-tester@n2fpga17:~
$ changeFPGAlinks # Not changing anything, just checking
Your current link-setup:
       n2fpga17:acl0:ch1-n2fpga17:acl1:ch0
       n2fpga17:acl0:ch3-n2fpga17:acl1:ch2
       n2fpga17:acl1:ch1-n2fpga17:acl0:ch0
       n2fpga17:acl1:ch3-n2fpga17:acl0:ch2

To visualize this configuration click here:
https://pc2.github.io/fpgalink-gui/index.html?import=n2fpga17%3Aacl0%3Ach1-n2fpga17%3Aacl1%3Ach0%20n2fpga17%3Aacl0%3Ach3-n2fpga17%3Aacl1%3Ach2%20n2fpga17%3Aacl1%3Ach1-n2fpga17%3Aacl0%3Ach0%20n2fpga17%3Aacl1%3Ach3-n2fpga17%3Aacl0%3Ach2%20

Your nodes in this Job (901745):
       n2fpga17
No configuration change requested. Goodbye.

Visualize here: Click!

Examples for running the command to specify a topology

with the --fpgalink= syntax to set the links:

...