Installation

Table of Content:

1. Heading 1
2. Heading 2
3. Heading 3

---

All Windows command line instructions are intended for Windows PowerShell, if not marked otherwise. So executing the following instructions in Windows Command Prompt (cmd.exe) won't function or result in errors! See the requirements wiki page on where to download or update PowerShell.

1. Heading 1

2. Configuring PoC on a Local System

To explore PoC's full potential, it's required to configure some paths and synthesis or simulation tool chains. See Configuration for more details.

cd <ExamplesRoot>\lib\PoC\
.\poc.ps1 --configure

3. Creating PoC's my_project file

The PoC-Library needs two VHDL files for it's configuration. These files are used to determine the most suitable implementation depending on the provided platform information. A set of my_config files is provided within the collection, but a per host my_project.vhdl needs to be created.

The my_project file can be created from a template provided by PoC in <ExamplesRoot>lib\PoC\src\common\my_project.vhdl.template.

The file should to be copyed into PoC's testbench source directory (<ExamplesRoot>lib\PoC\tb\common) and rename into my_project.vhdl. my_project.vhdl defines two global constants, which need to be adjusted:

constant MY_PROJECT_DIR       : string  := "CHANGE THIS";   -- e.g. "d:/vhdl/myproject/", "/home/me/projects/myproject/"
constant MY_OPERATING_SYSTEM  : string  := "CHANGE THIS";   -- e.g. "WINDOWS", "LINUX"

Example 1: A Windows System:

constant MY_PROJECT_DIR       : string  := "D:/git/GitHub/PoC-Examples/lib/PoC/";
constant MY_OPERATING_SYSTEM  : string  := "WINDOWS";

Example 2: A Debian System:

constant MY_PROJECT_DIR       : string  := "/home/lehmann/git/GitHub/PoC-Examples/lib/PoC/";
constant MY_OPERATING_SYSTEM  : string  := "LINUX";

4. Compiling shipped Xilinx IPCores (*.xco files) to Netlists

The embedded PoC-Library is shipped with some pre-configured IPCores from Xilinx. These IPCores are shipped as *.xco files and need to be compiled to netlists (*.ngc files) and there auxillary files (*.ncf files; *.vhdl files; ...). This can be done by invoking PoC's Netlist.py through one of the provided wrapper scripts: netlist.[sh|ps1].

Compiling needed IPCores from PoC for a KC705 board:

cd <ExamplesRoot>\lib\PoC\netlist
foreach ($i in 1..15) {
  .\netlist.ps1 --coregen PoC.xil.ChipScopeICON_$i --board KC705
}

See also

• Download
• Requirements
• Change Log