sudo apt-get install g++ git rpm cmake zlib1g-dev libssl-dev curl libcurl4-openssl-dev dialog

Download repo and put it somewhere in your PATH:

curl https://storage.googleapis.com/git-repo-downloads/repo > repo
chmod a+x repo
sudo cp repo /usr/local/bin

After installing repo, set up your client to access the Canopy EDK repository.

1) Create a working directory. You can call it anything you like:

mkdir canopy_edk
cd canopy_edk

2) Run repo init to initialize the client repository.

repo init -u https://github.com/canopy-project/canopy-embedded-manifest

To check out a branch other than "master", specify it with -b:

repo init -u https://github.com/canopy-project/canopy-embedded-manifest -b beta

3) Use repo sync to download sources to your working directory:

repo sync

Canopy's build system expects certain environment variables to be set, which are initialized with the envsetup.sh script. Use this script to select the target platform and build flavor (i.e. debug or release).

For example, from the build/ directory:

source envsetup.sh linux-default debug

If you have dialog installed on your system, you can interactively configure your build by simply running:

source envsetup.sh

If you do not have dialog installed, the envsetup.sh script will simply list the available options.

To build and install the Canopy EDK, from build/ run:

make
sudo make install

You can compile your program with a normal C/C++ compiler, such as GCC.

When you installed libcanopy it should have copied canopy.h to somewhere in your include path, such as /usr/local/include/canopy.h. If

libcanopy

is not in your path you will need to add it with something like:

gcc -Wall -g -I~/canopy_edk/libcanopy/include -C example.c -o example.o

You must link your program with the following shared libraries:

• libcanopy
• libsddl
• libred-canopy
• libwebsockets-canopy or libwebsockets
• libcurl

Some of the libraries that libcanopy depends on, such as libwebsockets are included in the EDK repo. The EDK build system will append -canopy to the library object file name (for example libwebsockets-canopy) in order to prevent collisions with other versions of those libraries that may already be installed on your system.

gcc -Wall -g -lred-canopy -lcanopy -lsddl -lcurl -lwebsockets-canopy example.o -o example

If you haven't installed libcanopy, you may need to add the appropriate directory(ies) to the library path. For example:

gcc -Wall -g -L~/canopy_edk/build/_out/lib -lred-canopy -lcanopy -lsddl -lcurl -lwebsockets-canopy example.o -o example

If you've installed libcanopy, you should be able to just run your program, for example, with:

./example

You may need to add the appropriate path to LD_LIBRARY_PATH or DYLD_LIBRARY_PATH:

LD_LIBRARY_PATH=~/canopy_edk/build/_out/lib ./example

CanopyContext ctx;
ctx = canopy_init_context();
if (!ctx) {
    canopy_write_error(stderr, NULL, "Failed to initialize Canopy context");
}

CanopyResultEnum result;

// Does nothing with no option arguments:
canopy_set_opt(ctx);

// You can set several options at once:
result = canopy_set_opt(ctx,
    CANOPY_CLOUD_SERVER, "localhost:8080",
    CANOPY_DEVICE_UUID, "16eeca6a-e8dc-4c54-b78e-6a7416803ca8",
    CANOPY_DEVICE_SECRET_KEY, "My Secret"
);
if (result != CANOPY_SUCCESS) {
    canopy_write_error(stderr, ctx, "Failed to set options");
}