PKG-SNF-SDK-WIN/readme

This is where the SNF SDK for Windows Package is kept.



Copyright (c) 2009 - 2011 ARM Research Laboratories



The 64-bit SNFMulti.dll file is built using MinGW-64, the 64-bit MinGW

toolchain.  The 32-bit SNFMulti.dll file is built using MinGW, the

32-bit MinGW toolchain.



There are two ways for building SNFMulti.dll:



  1) Use the Code::Blocks project (in the CodeBlocks directory).



  2) Use the .CMD files from the DOS command line (in the MinGW-64 or

  MinGW-32 directory).



In addition to building SNFMulti.dll, the libSNFMulti.a and

libSNFmulti.def files are created.



There are also applications for linking with SNFMulti.dll:



  1) The SNFMulti C++ test built with MinGW.  This can be built with a

  .CMD file in the MinGW-64 or MinGW-32 directory, or a Code::Blocks

  project in the CodeBlocks directory.



  2) The SNFMulti C++ test built with Visual Studio 2008.  This can be

  built with solution file

  VS2008CPPSample/VS2008CPPSample.sln.



  3) A Visual Studio 2008 C# example application.  This can be built

  with solution file VS2008CSSample/VS2008CSSample.sln.



  4) A Visual Studio 2008 VB example application.  This can be built

  with the solution file VS2008VBSample/VS2008VBSample.sln.



This package includes the following directories (each has a README

file with further information):



  MinGW-64--Contains .CMD files for building 64-bit SNFMulti.dll and

  associated files, and also the C++ application SNFMultiTest.  It

  uses the source files in the SNFMulti, CodeDweller, and SNFMultiTest

  directories.  These directories must be present.



  MinGW-32--Contains .CMD files for building 32-bit SNFMulti.dll and associated

  files, and also the C++ application SNFMultiTest.  It uses the

  source files in the SNFMulti, CodeDweller, and SNFMultiTest

  directories.  These directories must be present.



  CodeBlocks--Contains the Code::Blocks project files for building

  SNFMulti.dll and SNFMultiTest.  It uses the source files in the

  SNFMulti, CodeDweller, and SNFMultiTest directories.  These

  directories must be present.



  SNFMultiTest--Contains the source for the C++ test application

  SNFMultiTest.



  VS2008CSSample, VS2008VBSample, VS2008CPPSample--Contains the Visual

  Studio files for building the C# and VB example applications, and

  the C++ test.



To build the applications in the MinGW-64, MinGW-32, CodeBlocks, and

VS2008 directories:



  1) Ensure that the SNFMultiTest, SNFMulti, and CodeDweller

  directories are present.



  2) Install the 64-bit MinGW toolchain.  Unpack the 64-bit toolchain

  (e.g.  mingw-w64-bin_i686-mingw_20090220.zip) into c:\MinGW-64.  If

  done correctly, c:\MinGW-64 should have the directories bin,

  include, x86_64-pc-mingw32, and other directories.  The MinGW .CMD

  files and the Code::Blocks project files are configured to use the

  64-bit toolchain in c:\MinGW-64.



  3) Install the 32-bit MinGW toolchain to C:\MinGW.



  4) Install VS 2008.



  5) Follow the directions in each directorie's README file.



To build and test the SDK:



  1) In PKG-SNF-SDK-WIN/trunk/MinGW-32:



     a) compileSNFMultiDLL.cmd.



     b) buildSNFMultiDLL.cmd.



     c) buildSNFMultiTestDLL.cmd.



     d) buildvs2008SNFMultiImportLib.cmd (in vs2008 command prompt).



     e) SNFMultiTest.exe.



     f) installSNFMultiLibrary.cmd.



  2) Repeat in MinGW-64.



  3) Build and run VS2008CPPSample, x32 and x64.  First copy

     snf_engine.xml to VS2008CPPSample.  Needed to copy *.dll to

     VS2008CPPSample.



  4) Build and run VS2008CSSample, any, x32, and x64.  First copy

     snf_engine.xml to VS2008CSSample.



  5) Build and run VS2008VBSample, any, x32, and x64.  First copy

     snf_engine.xml to VS2008VBSample.



To create a zipfile distribution:



  1) Install jZip.



  2) Edit BuildDistribution.cmd to specify the DISTDIR variable, and

     optionally the TEMPDIR variable.



  3) Run BuildDistribution.  This creates a zip file in the current

     directory with the name %DISTDIR%.zip.



Note: When you run BuildDistribution, you will get a message saying

that %DISTDIR%.zip could not be found.  This message can be ignored.



Note: For more information on the procedure for creating a zipfile

distribution, see the BuildDistribution.cmd file and the

BuildDistribution\README file.