2. Makefile.connectal.build

The target Makefile, which generated by makefilegen.py (which is invoked by Makefile.connectal), includes Makefile.connectal.build.

2.1. Make targets

bits

Builds the FPGA bitstream.

exe

Builds the application software (executable or shared library).

run

Programs the FPGA and Runs the application.

2.2. Board-specific targets

ubuntu.exe

Builds the application for boards using Ubuntu/Debian/CentOS Linux. Also used with xsim.

android.exe

Builds the application for boards using Android (e.g., zedboard).

bsim_exe

Builds the application for use with bluesim

bsim

Builds the hardware for Bluespec bluesim simulator

xsim

Builds the hardware for Xilinx xsim simulator

2.3. Environment Variables

RUNPARAM

Specifies the name or address of the host on which to run the application.

NOFPGAJTAG

(Deprecated, use :envvar::NOPROGRAM. See also See also noprogram.) If NOFPGAJTAG is defined, then fpgajtag is not called by ubuntu.exe or android.exe.

NOPROGRAM

If NOPROGRAM is defined, then the FPGA is not automatically programmed by ubuntu.exe or android.exe. See also noprogram.

2.4. Variables Controlling the Build

V

Binding V=1 makes the build verbose, displaying the commands that are run while building the project.

CONNECTAL_SHARED

Bind to 1 to build a shared library instead of an executable application.

CONNECTAL_NOHARDWARE

Binding to 1 suppresses creation of FPGA bitstream.

CONNECTAL_NDK_PARAM

Specifies options to pass to ndk-build.

2.5. Variables Controlling the Bluespec Compiler

BSCOPTFLAGS

Specifies bsc optimization flags.

BSCPATHFLAGS

Specifies directories used to store output files from Bluespec compilation.

BSCFLAGS_COMMON

Specifies Connectal-specific bsc flags.

BSCFLAGS_PROJECT

Specifies project-specific bsc flags, -p argument passed to makefilegen.py via CONNECTALFLAGS.

BSCFLAGS_EXTRA

Specifies additional flags to pass to bsc.

2.9. Variables Controlling the Application

CONNECTAL_DEBUG

Bind CONNECTAL_DEBUG=1 to run the application under gdb.

RUN_ARGS

Specifies arguments to pass to the application when invoking it.