View on GitHub


Boon Amber C++ SDK

An SDK for Boon Amber sensor analytics


The Boon Amber C++ SDK is a source-only distribution.

amber-cpp-sdk uses libcurl to send and receive http requests. This must be installed on the host system before building amber-cpp-sdk.

A full detail of curl installation options can be found at:

Clone source:

git clone

Within amber-cpp-sdk repository, create makefiles:

cmake .

Make libraries and supporting example scripts:


Internal Developers Notes

Credentials setup

Note: An account in the Boon Amber cloud must be obtained from Boon Logic to use the Amber SDK.

The username and password should be placed in a file named ~/.Amber.license whose contents are the following:

    "default": {
        "username": "AMBER-ACCOUNT-USERNAME",
        "password": "AMBER-ACCOUNT-PASSWORD",
        "server": ""

The ~/.Amber.license file will be consulted by the Amber SDK to find and authenticate your account credentials with the Amber server. Credentials may optionally be provided instead via the environment variables AMBER_USERNAME and AMBER_PASSWORD.

Connectivity test

The following example provides a basic proof-of-connectivity:


Running the bin/connect-example should yield output like the following:

$ bin/connect-example
    "api-version": "/v1",
    "builder": "712de01c",
    "expert-api": "55bb36dd",
    "expert-common": "f65c90bf",
    "nano-secure": "aac9f5d0",
    "release": "dev",
    "swagger-ui": "914af396"


full-example.cpp : demonstrates each sdk call (bin/full-example)

stream-advanced.cpp : streams output_current.csv to Amber and displays analytic results (bin/full-example)

output_current.csv : supporting csv file