This is documentation for the old, first-generation Kaa platform v0.x.
Next generation Kaa Enterprise IoT platform is now available! Try it free with a 30-days trial.
Kaa Enterprise documentation is here.
. . .

Windows

This section describes how to build Kaa C++ SDK for Microsoft Windows.

NOTE: This guide is verified against:

  • Host OS: Windows 7, 8, 10
  • IDE: MS Visual Studio 2013, 2015

Prerequisites

Prior to building Kaa C++ SDK, install the following components on your machine:

  1. Wget and libarchive.

  2. Cmake 3.5.1.

    NOTE: Make sure that you choose one Add CMake to system path… for all users or for current user on the Install options step.

  3. Python 2.7 32-bit or 64-bit depending on your system architecture.

  4. Boost 1.60 32-bit or 64-bit.

  5. 7-Zip 32-bit or 64-bit. Add the directory where the 7-Zip is stored to your PATH.

  6. Bzip2 1.0.6 32-bit or 64-bit. Unzip downloaded archive, add the directory where the unzipped libbz2.dll is stored to your PATH.

SDK Prerequisites

Download Kaa C++ SDK tar.gz archive from the Administration UI and unpack it. In the example below, it is unpacked to the KAA_BUILD_DIR directory.

You can configure installation by editing the KAA_BUILD_DIR\tools\env.bat file. See table below.

Parameter Description Example values Default value
BUILD_PLATFORM Target architecture. x86, x64 x64
MSVC_VERSION MSVC++ Version. 14 Visual Studio 2015
12 Visual Studio 2013
11 Visual Studio 2012
10 Visual Studio 2010
9 Visual Studio 2008
8 Visual Studio 2005
14
BOOST_ROOT Installation path for Boost libraries.   C:\local\boost_1_60_0\
ROOT_PATH Path where all packages will be installed.   C:\local\

Open the Developer Command Prompt and proceed as follows:

  1. Switch to KAA_BUILD_DIR.

    cd KAA_BUILD_DIR
    
  2. Build third-party components.

    cd tools
    build_sdk_thirdparty.bat
    

    NOTE: By default, the debug configuration is used. To build release versions, use the release argument:

    build_sdk_thirdparty.bat release
    

Build C++ SDK

To build the Kaa C++ SDK:

  1. Open the Developer Command Prompt and run the following commands.

    cd KAA_BUILD_DIR
    tools\env.bat
    avrogen.bat
    mkdir build && cd build
    
  2. Build Kaa C++ SDK with nmake.

    cmake -G "NMake Makefiles" -DCMAKE_FIND_ROOT_PATH=%ROOT_PATH% -DCMAKE_BUILD_TYPE=Debug -DKAA_MAX_LOG_LEVEL=3 ..
    nmake
    
  3. Generate Visual Studio Project and build it from command line:

    cmake -G "Visual Studio 14" -DCMAKE_FIND_ROOT_PATH=%ROOT_PATH% -DCMAKE_BUILD_TYPE=Debug -DKAA_MAX_LOG_LEVEL=3 ..
    msbuild kaacpp.vcxproj /property:Platform=%BUILD_PLATFORM%
    
    cmake -G "Visual Studio 14 Win64" -DCMAKE_FIND_ROOT_PATH=%ROOT_PATH% -DCMAKE_BUILD_TYPE=Debug -DKAA_MAX_LOG_LEVEL=3 ..
    msbuild kaacpp.vcxproj /property:Platform=%BUILD_PLATFORM%
    

For additional CMake options, see CMakeLists.txt file located in the C++ SDK root.

Build Kaa application

After you installed the required dependencies and built the C++ SDK, you can build and run your Kaa application.

Use the Linux guide to build and run your application.