This repository contains every needed to build your own Snappy Ubuntu Core OS image for Boundary Devices Nitrogen platforms.

First of all, it is highly recommended to build from Ubuntu 16.04 or later. Although there are solutions for different OS flavours, some tools are limited to Ubuntu for now.

Then you need to install the following packages in order to build Ubuntu Core.

~$ sudo apt update
~$ sudo apt install -y build-essential u-boot-tools lzop gcc-arm-linux-gnueabihf
~$ sudo apt install -y snap snapcraft
~$ sudo snap install ubuntu-image --classic --edge

You can check that the snap is working on your host machine by listing the available packages:

~$ snap list
Name          Version    Rev   Tracking  Developer  Notes
core          16-2.32.1  4327  stable    canonical  core
ubuntu-image  1.3+snap1  98    edge      canonical  classic

NOTE: make sure that you have the latest snapcraft tool available, using versions < 2.27.1 have proven to be troublesome.

Simply clone this repository:

~$ git clone https://github.com/boundarydevices/ubuntu-core.git
~$ cd ubuntu-core

In order to build the whole OS image, you just need to issue the following:

~/ubuntu-core$ make

The output file should be named ubuntu-core-nitrogen-yyyymmdd.img.gz.

You can then simply flash it using zcat and dd.

~/ubuntu-core$ zcat ubuntu-core-nitrogen-xxxx.img.gz | sudo dd of=/dev/sdX bs=1M oflag=sync

If you just wish to build the gadget:

~/ubuntu-core$ make gadget

If you just wish to build the kernel:

~/ubuntu-core$ make kernel

If you re-built the kernel or the gadget manually, you can simply generate the image:

~/ubuntu-core$ make snappy