The Open NFC Core Edition is a superset of the SDK edition: it contains the Open NFC SDK (for Win32) and also the source code of the hardware-independent core of the Open NFC stack, and the source code of the NFC HAL module for NFC Simulator.

Here is the detailed list of the contents:

• The documents for this release (/core, /core/documents)
• The portable source code of Open NFC (/core/sources, /core/interfaces)
• The Win32 porting of Open NFC core (/core/porting)
• The NFC HAL for simulator (sources and Win32 porting)
• The Win32 porting of NFC HAL for MicroRead (Win32 porting only)
• The Win32 example applications
• A few Win32 applications associated with Open NFC: the Connection Center, the NFC Simulator
• The AC File Generator tool for the Security Stack (/core/security/aclgen)

What you can do with this edition:

• Compile the Open NFC software stack for Win32 (using the win32 porting files). Note that if you want to recompile the NFC HAL for MicroRead module, you will need also the NFC HAL for MicroRead Edition that contains the source code.
• Use this edition as a basis for a new porting, if no other edition is closer to your target environment.
• Compile a Win32 application that uses Open NFC. A few examples are provided (require Microsoft Visual Studio Express for compilation). See below for the complete quick howto.
• Test this application with the NFC Simulator

What you cannot do:

• You cannot recompile the nfc_hal_microread DLL with this edition only; you will need to get the source files from the NFC HAL for MicroRead Edition.

Please check the documents included in this Edition (in particular SIS_NFC_0707-003 “Open NFC – API Specification” and SIS_NFC_0709-014 “Open NFC Core Edition – Porting Guide”) for important general information on the Open NFC software stack.

In order to compile the stack, you need the software environment described in the Requirements section below. Then, you should compile the projects in the following order (the following procedure assumes you build all the projects in “release” mode):

1. \core\porting\win32\win32_nfc_hal_simulator.sln: this builds the NFC HAL module for interacting with the NFC Simulator via the Connection Center.
2. \core\porting\win32\win32_monolithic.sln (project: monolithic_porting): this builds the Open NFC stack as a single DLL (monolithic_porting) that can be used to build the examples.
3. \core\porting\win32\win32_examples\win32_test.sln: This contains all the test applications. You can for example build the test_reader project. First go to the project properties, under Linker / Input, and replace the “..\client_porting.lib” with “..\..\release\monolithic_porting.lib” you just compiled, then build the project.
4. Copy the nfc_hal_simulator.dll, monolithic_porting.dll from \core\porting\win32\release and test_reader.exe from \core\porting\win32\win32_examples\release in one single directory.
5. Start the Connection Center executable
6. Start the NFC Simulator executable (this adds some logs in the Connection Center windows)
7. Run the command:
   

   test_reader.exe cc:nfcc_hal

8. Emulate a tag presentation in front of the antenna by double-clicking on a virtual card file in the NFC simulator; the test_reader application should read and display its contents.
9. Refer to the Connection Center, NFC Simulator, and Win32 Examples documentation for more information

Congratulation! You are now able to use the Open NFC stack in Win32 environment.

The source code of Open NFC is portable C code that should compile with any C99-compliant compiler.

You will need the Microsoft Visual C++ 2010 Redistributable Package (x86, x64) to execute the pre-compiled applications under Windows.

In order to build and compile the stack in the Win32 environment, we provide the porting files. You will need:

• Win32 environment (Open NFC >= 4.3.0 uses the Windows SDK 7.1).
• Microsoft Visual Studio Express
  • 2008 for Open NFC <= 4.2.x
  • 2010 for Open NFC >= 4.3.x

A few Win32 example applications are provided in the porting. You can re-compile and run these applications. For doing so, you need to:

• Running the Connection Center tool.
• Using the NFC Simulator or a real NFC device connected to the Connection Center, such as the Evaluation Kit.
• Depending on how Open NFC was compiled, you will need to start a “server_porting.exe” application before starting the examples (that are linked with the “client_porting.dll” by default).

Please check the embedded documentation on running the Win32 examples for details on the command-line arguments.