Skip to content

Board Repository Discovery

The board definitions, IP and constraints come from the voltcyclone-fpga repository. The generator finds them in one of three places depending on how you installed it.

Where boards come from

Install type Location
pip install Bundled inside the package (pcileechfwgenerator/voltcyclone_fpga). No checkout needed.
Source checkout The lib/voltcyclone-fpga git submodule.
Container (Stage 2) /app/lib/voltcyclone-fpga, cloned when the image is built.

A source checkout is searched first, then the container path, then the copy bundled in the pip package.

Source checkout setup

git clone --recurse-submodules https://github.com/VoltCyclone/PCILeechFWGenerator.git
# or, if already cloned:
git submodule update --init --recursive

Forgetting --recurse-submodules is the most common cause of "boards not found".

Container

The Containerfile clones voltcyclone-fpga during the image build, so the container needs no submodule. If boards are missing in the container, rebuild the image with network access.

Boards

The generator knows these board names (--board):

pcileech_35t325_x4, pcileech_35t325_x1, pcileech_35t484_x1, pcileech_75t484_x1, pcileech_100t484_x1, pcileech_100t484_m2, pcileech_100t484_x4, pcileech_enigma_x1, pcileech_squirrel, pcileech_pciescreamer_xc7a35, pcileech_gbox, pcileech_netv2_35t, pcileech_netv2_100t, pcileech_screamer_m2, pcileech_ac701.

A board is listed only if its directory exists in the repository. pcileech_100t484_m2 (CaptainDMA M2 100T) uses the same project as pcileech_100t484_x1. See Supported Devices.

Troubleshooting

"voltcyclone-fpga not found" in a source checkout

git submodule update --init --recursive

"voltcyclone-fpga not found" in the container

The image build failed to clone the repository. Rebuild with network access:

podman build -t pcileech-fwgen -f Containerfile .

Boards missing

ls lib/voltcyclone-fpga/CaptainDMA/
pip show pcileechfwgenerator

See Also