PKG-SNF-SDK-WIN/readme

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

Copyright (c) 2009 - 2020 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.  For x32, copy *.dll from
     32bitDll to VS2008CPPSample.  For x64, copy *.dll from 64bitDll
     to VS2008CPPSample.

  4) Build and run VS2008CSSample, any, x32, and x64.  Copy
     snf_engine.xml to VS2008CSSample.  Modify main.cs to specify
     the location of snf_engine.xml and snfmulti.dll, which is
     different for any, x32, and x64.

  5) Build and run VS2008VBSample, any, x32, and x64.  Copy
     snf_engine.xml to VS2008VBSample.  Modify main.vb to specify
     the location of snf_engine.xml and snfmulti.dll, which is
     different for any, x32, and x64.

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.