PKG-SNF-SDK-WIN/CodeBlocks/SNFMultiTest/README

README file for building the SNFMultiTest application using Code::Blocks

Copyright (c) 2009 ARM Research Laboratories

This is the README file for the Code::Blocks project for building the
64-bit SNFMultiTest application using Code::Blocks.  These directions
are for building the SNFMultiTest linked with the SNFMulti DLL using
the 64-bit MinGW compiler.

This README file should be in the CodeBlocks\SNFMultiTest directory of
the SNF_CS developer distribution.

To build the application:

  1) Install the 64-bit MinGW as described in the README file in the
  above directory.

  2) Build the SNFMulti DLL (see ../SNFMulti/README).

  3) Ensure that the SNFMulti and CodeDweller source directories are
  in the correct location.  They should be in ..\..\SNFMulti and
  ..\..\CodeDweller (relative to this directory).

  4) Open the SNFMultiTest Code::Blocks project (SNFMultiTest.cbp).

  5) Select the Debug or Release targets.

  6) Build the application.  The application is created in bin\Debug
  or bin\Release relative to this directory.

Before running the application, copy the SNFServer configuration file
to prescale.xml in this directory (e.g. from the prescale.xml file in
the MinGW-32 directory).

Creating the SNFMultiTest project file
-----------------------------------

  1) Create a Code::Blocks Console project.  Create the project file
  in this directory, and name it SNFMultiTest.

  2) Select a 64-bit compiler (MinGW-64; see the README file in the
  parent directory for setting up Code::Blocks to use a 64-bit MinGW
  compiler).

  3) Select the Debug target (Build->Select target->Debug).

  4) Add the following files (Right-click on the SNFMultiTest project
  in the projects window, and choose "Add files"):

     i) SNFMultiTest/main.cpp

     ii) include/snfmultidll.h

     iii) In CodeDweller:

       a) threading.cpp

       b) threading.hpp

       c) timing.cpp

       d) timing.hpp

  5) Add the link directories contining the SNFMulti.dll:

    a) Open the Build Options window (Projects->Build Options).

    b) Choose the Search Directories tab.

    c) Select the Linker tab.

    d) Click on "Debug", and add the library directory
    "..\SNFMulti\bin\Debug".

    e) Click on "Release", and add the library directory
    "..\SNFMulti\bin\Release".

  6) Add the SNFMulti library:

     a) Open the Build Options window.

     b) Click on SNFMultiTest.

     c) Choose the Linker settings tab.

     d) Add the library "SNFMulti" to the Link libraries window.

  7) Add the compiler options:

     a) Open the Build Options window.

     b) Click on "SNFMulti".

     c) Select the Compiler settings tab.

     d) Select the Other options tab.

     e) Add "-mthreads".