This guide explains how to build applications for Samsung Artik 5 (further, the Artik) based on the Kaa C++ endpoint SDK (further, the C++ SDK).
Configuring Artik 5 board
If this is the first time you use the Artik board, you have to start with configuring your board. For this purpose, refer to the official Artik getting started guide.
After finishing with the guide, you will be able to access your board through both a serial terminal and an ssh client.
Installing third-party components for C++ SDK
The following third-party components must be installed before building the C++ SDK.
- Mandatory: Boost (1.54 min.v.), Avro (1.7.5), and Botan (only v.1.10) libraries.
- Optional: To build Avro version higher than 1.7.5, you will need Boost with the iostream library. To build Boost with iostreams, you will need to build the zlib and the libbz2 libraries as described below.
Install the third-party components as follows:
Install the toolchain.
Install zlib & libbz2 (for Avro version higher than 1.7.5).
Install Boost (1.54 or higher).
Edit the project-config.jam file. Add 'using gcc : artik : arm-linux-gnueabihf-gcc ;' after 'using gcc ;'
Install Avro (1.7.5-1.7.7).
The path for the Avro patch is provided below:
Install Botan (1.10).
Creating applications based on C++ SDK
To create an application based on the C++ SDK, at first you need to build static/shared Kaa libraries from the generated SDK and then link your application to those libraries. You can either do it manually or create some build script to automate the building process (see the Example section).
To quickly start with the Kaa IoT platform, you can download one of the Kaa demo applications from the Kaa Sandbox and run it on the Artik board. In this example, we use the Notification demo from the Kaa Sandbox.
After downloading the application to your host machine, you will need to build it and then copy libraries and the application to the device. For copying files to the device you can use, for example, the scp utility.
The instructions on how to build and run the application are the following:
Find the IP address assigned to the Artik WiFi interface.
Build the Notification demo.
Copy the demo application and the library to the Artik device from your host machine.
For the first time, copy the Boost, Avro and Botan libraries
Then copy the application and the Kaa library