This guide explains how to build applications for BeagleBone based on the Kaa C++ endpoint SDK (further, the C++ SDK).
Configuring BeagleBone board
If this is the first time you use the BeagleBone technology, you have to start with configuring your board. For this purpose, refer to the official BeagleBone getting started guide.
Installing third-party components for C++ SDK
The following third-party components must be installed on the BeagleBone board before building the C++ SDK.
- Mandatory: Boost (1.54 min.v.), Avro (1.7.5 - 1.7.7 v.), and Botan (only v.1.11) libraries.
- Optional: SQLite library. It should be installed only if you are going to use a persistent log storage for the Kaa data collection feature.
NOTE: The further instructions are expected to be executed in the order given, directly on the BeagleBone board, and with Linux installation and root permissions.
To install these libraries, proceed as follows:
- Connect to the board via an ssh client. Refer to the official BeagleBone getting started guide for any help required.
Install common prerequisites:
Install Boost (1.54 or higher).
Install Avro (1.7.5-1.7.7).
Install Botan (1.11).
Install SQLite (latest).
Creating applications based on C++ SDK
To create an application based on the C++ SDK, you need to build static/shared Kaa libraries from the generated SDK at first 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).
The BeagleBone platform allows building the source code directly on the board. The only thing you need to do prior to that is export your code onto the board. For this purpose you can use, for example, the scp utility.
To quickly start with the Kaa IoT platform, you can download one of Kaa demo applications from the Kaa Sandbox and run it on the BeagleBone board.
For this example, you need to download the notification demo from the Kaa Sandbox to your host machine. After that, export the downloaded archive to the board and run the demo, as follows:
Find the IP address assigned to the BeagleBone network interface:
Copy the demo application source package to BeagleBone from your host machine:
Build and run the notification demo from your BeagleBone board:
If the build is successful, you will see the following output on the BeagleBone terminal: