Programming Howto:Building BCI2000

2007-07-25T17:25:32Z

Mayaudlo: /* Compiling BCI2000 with Borland C++ Builder 2006 */

This document describes how to build BCI2000, i.e. how to create the BCI2000 executables from their source code.

== Why to build ==
Typically, you will install BCI2000 from its binary distribution, and do not need to build BCI2000, unless
*you want to always use its most current SVN version,
*you create your own module by modifying an existing one, or create a new one from scratch.

== Tools required ==
As of BCI2000 version 2.0, building all parts of BCI2000 requires Borland's C++ Builder 6, or a more recent version.
The operator GUI and Application modules currently require the Borland VCL library.
Non-GUI related parts of BCI2000 can be built using the freely available Borland C++ compiler:
*[[Command line tools]]
*[[Matlab mex files]]

Matlab mex files can also be built on platforms other than Win32. Please use the src/tools/mex/buildmex.m Matlab script (tested with gcc).

==How to build==
===Compiling BCI2000 from the command line===
# Open a Windows cmd shell, e.g. by choosing "Run..." from the Start Menu and entering "cmd".
# Change to the "src" directory where this document resides.
# Execute "make" from the command prompt.
# If you updated or edited any of the source files, and experience linker errors or other unexpected behavior, execute "make clean && make all".

===Compiling BCI2000 using the Borland C++ Builder 6 IDE===
# Open the file "BCI2000.bpg" with the IDE by double-clicking it.
# Make sure the "ProjectManager" view is visible to the left.
# Right-click the topmost project (located immediately below the line reading "BCI2000"), and choose "Make all from here".
# To get rid of possible inconsistencies from earlier builds, choose "Build all from here" rather than "Make all from here".

===Starting up BCI2000===
# After compilation, a desired configuration of BCI2000 may be started by executing an appropriate batch file from the top level "batch" directory. Once a particular configuration of BCI2000 is started, simply load a parameter file with the same name as the batch file from the "parms" directory.
# If you need a configuration for which no batch file exists, just modify a copy of a batch file that is close to your needs.

===Compiling BCI2000 with Borland C++ Builder 2006===
# Open the file "BCI2000.bpg" from within Borland Developer Studio. This will import all existing projects into BDS project files.
# For each project, open the "Options..." dialog, go to "C++ Compiler->Precompiled Headers", and uncheck all check boxes. Then, go to "Link (ilink32)->Path and Definitions", and add "$(BDS)\lib\psdk" to "Library Research Path (-L)".
# In the project manager (at the top right), right-click the topmost project and choose "Make all from here".
# To get rid of possible inconsistencies from earlier builds, choose "Build all from here" instead of "Make all from here".
# Command-line builds cannot be done with Borland C++ Builder 2006 because it lacks a project-to-makefile conversion utility.

BCI2000 Wiki - User contributions [en]

Programming Howto:Building BCI2000