...

• PGP Generation 3 Card (available from SLAC)
• Xilinx KCU105 evaluation board

Getting Firmware

...

From GIT

First download the project from git. Requires git >= x.x.x and lfs.

...

> git submodule update --recursive

...

Alternatively you can download a tarball from here:

dev-board-examples-v1.0.0.tgz

Pre-Compiled

A pre-compiled image is included in:

dev-board-examples-v1.0.0/firmware/targets/XilinxKC705DevBoard/Kc705Pgp/images/xxxx.mcsKcu105Pgp-0x00000001-20170330105909-ruckman-dirty.bit.gz

Uncompress the bit file with:

> gzip -d Kcu105Pgp-0x00000001-20170330105909-ruckman-dirty.bit.gz

and load into the evaluation board using vivado.

Build Your Own

Compile the project. Requires linux and vivado 2016.4

> cd dev-board-examples-v1.0.0/firmware

Our build system requires a local build directory for the compile. You can either 

...

The output will be in the images directory. I.E. images/.mcs. 

PGPCard Driver

Download the driver package from github.com

> wget https://github.com/slaclab/aes-stream-drivers/archive/v1.0.1.tar.gz

> tar -xvvzpf v1.0.0.1.tgz 

go to the pgpcard directory and build the driver:

> aes-stream-drivers-1.0.1/pgpcard/driver/

> make

You will end up with a file pgpcard.ko

Load the driver as root:

> sudo insmod pgpcard.ko

Verify the card loaded:

> cat /proc/pgpcard_0

You will see a dump of information. With the eval board image loaded and the board fibers properly connected you should see the following lines:

-------------- Lane 0 --------------------
 LoopBack : 0 
 LocLinkReady : 1 
 RemLinkReady : 1

The aes-stream-drivers/include directory will be needed for the next step. Make note of the full directory path.

Test Software Compile

...