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.



The SNFMulti.dll is built using the .CMD files from the 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.

The import and export files are built using the VS2019 command line.



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



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

  built with solution file VS20198CPPSample/VS2019CPPSample.sln.



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

  with solution file VS2019CSSample/VS2019CSSample.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.