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
"voltcyclone-fpga not found" in the container
The image build failed to clone the repository. Rebuild with network access: