README.md 2.34 KB
Newer Older
Leonardo Solis's avatar
Leonardo Solis committed
1
2
3
4
5
6
7
8
# Description

OpenCL task-parallel version of AutoDock4 for Xilinx FPGAs.

## Development tool

SDAccel v17.4.

Leonardo Solis's avatar
Leonardo Solis committed
9
This can be initialized via: `source init_sdx174.sh`. Then choose the server to work on: either _local_ or _remote_.
10

Leonardo Solis's avatar
Leonardo Solis committed
11
### Documentation
12

Leonardo Solis's avatar
Leonardo Solis committed
13
14
* For the tool used in this branch: 
	* [SDAccel Environment Tutorial: Introduction (UG1021)](https://www.xilinx.com/support/documentation/sw_manuals/xilinx2017_4/ug1021-sdaccel-intro-tutorial.pdf) -> Chapter 2 (_Flow Overview_) -> Lab 2 (_Introduction to the SDAccel Makefile_)
15

Leonardo Solis's avatar
Leonardo Solis committed
16
17
* For the latest tool available: 
	* [SDAccel Development Environment Help](https://www.xilinx.com/html_docs/xilinx2018_2/sdaccel_doc/zrq1526323398130.html)
Leonardo Solis's avatar
Leonardo Solis committed
18
19


Leonardo Solis's avatar
Leonardo Solis committed
20
## Important commands
21
22

* See basic rules under [Makefile](./ofdock_taskpar_xl/Makefile)
Leonardo Solis's avatar
Leonardo Solis committed
23
24
* See user compilation flags under [boards.mk](./SDAccel_Examples/utility/boards.mk)
* See OpenCL ICD options under [opencl.mk](./SDAccel_Examples/libs/opencl/opencl.mk)
25

Leonardo Solis's avatar
Leonardo Solis committed
26
### SW and HW Emulation (in local server)
27
28
29
30
31

```zsh
make swemu
```

Leonardo Solis's avatar
Leonardo Solis committed
32
33
34
35
```zsh
make hwemu
```

Leonardo Solis's avatar
Leonardo Solis committed
36
### FPGA building (in local server)
37
38
39
40

```zsh
make hw
```
41

Leonardo Solis's avatar
Leonardo Solis committed
42
### Where to find reports
43

Leonardo Solis's avatar
Leonardo Solis committed
44
45
46
47
48
A Makefile flow is used. A system estimate can be generated this way:

```zsh
make kerrpt-sw
```
49

Leonardo Solis's avatar
Leonardo Solis committed
50
51
* A [`sdaccel_ini`](./ofdock_taskpar_xl/sdaccel.ini) was created to generate additional reports. Its specific format is documented in: 
	* [SDAccel Environment User Guide (UG1023)](https://www.xilinx.com/support/documentation/sw_manuals/xilinx2017_4/ug1023-sdaccel-user-guide.pdf) -> Appendix H (_Using the Runtime Initialization File_)
52

Leonardo Solis's avatar
Leonardo Solis committed
53
### FPGA evaluation (in remote server)
Leonardo Solis's avatar
Leonardo Solis committed
54
55
56
57
58

```zsh
make eva
```

Leonardo Solis's avatar
Leonardo Solis committed
59
* Contrary to the other Altera-based branches, this rule is not set as `make exe`. This is because another `exe` rule is already used internally by the scripts provided by SDAccel.
Leonardo Solis's avatar
Leonardo Solis committed
60

Leonardo Solis's avatar
Leonardo Solis committed
61
62
* Information on how to setup the system for evaluation: 
	* [SDAccel Environment Tutorial: Introduction (UG1021)](https://www.xilinx.com/support/documentation/sw_manuals/xilinx2017_4/ug1021-sdaccel-intro-tutorial.pdf) -> Chapter 2 (_Flow Overview_) -> Lab 2 (_Introduction to the SDAccel Makefile_) -> Step 5: Running System Run
Leonardo Solis's avatar
Leonardo Solis committed
63
64
	* [SDAccel Environment User Guide (UG1023)](https://www.xilinx.com/support/documentation/sw_manuals/xilinx2017_4/ug1023-sdaccel-user-guide.pdf) -> Appendix J (_Board Installations_) -> Installing the VCU1525 Card -> Step 5: Verifying Successful Board Installation