Quick start with Ubuntu

This guide shows you how to get started with Pelion Edge and Ubuntu. At the end of this tutorial, you will have built Pelion Edge packages ready to be installed on Ubuntu Focal AMD64.

Prerequisites

This guide builds Pelion Edge on the Ubuntu 20.04 operating system.

Before you can build this package, you must have:

• A Pelion Device Management account with which you have:

  • Created and downloaded the developer certificate credentials file mbed_cloud_dev_credentials.c.
  • Created an application access key.

• Docker and git installed to your build machine.

• Manifest tool v1.5.2.

Build

1. Clone distro-pelion-edge, and change the directory to the root of the repository:

   git clone https://github.com/PelionIoT/distro-pelion-edge
   cd distro-pelion-edge
   

2. Copy the mbed_cloud_dev_credentials.c file in place, so the Edge developer mode package builds with your developer credentials:

   cp ~/Downloads/mbed_cloud_dev_credentials.c .
   

3. Use the manifest tool to create update_default_resources.c:

   manifest-tool init -a <access-key> --vendor-id 42fa7b48-1a65-43aa-890f-8c704daade54 --class-id 42fa7b48-1a65-43aa-890f-8c704daade54 --force
   

   Note: Firmware-over-the-air update behavior is currently not defined.

4. Copy the generated update_default_resources.c into place:

   cp /path/to/update_default_resources.c .
   

5. Build all the Ubuntu 20 packages for AMD64 using Docker:

   ./build-env/bin/docker-run-env.sh focal ./build-env/bin/build-all.sh --deps --install --build --source --arch=amd64
   

   Ubuntu packages are available in ./build/deploy/deb/focal/main/

6. (Optional) To rebuild an individual package (for example, mbed-edge-core-devmode):

   ./build-env/bin/docker-run-env.sh focal ./mbed-edge-core-devmode/deb/build.sh --install --build --source --arch=amd64
   

Troubleshooting

Please see the distro-pelion-edge README for more information and GitHub issues for solutions to common build errors.