Atmel Software Framework and build chain in a Docker container

(Reading time: 3 mins)

Watch "Atmel Software Framework and build chain in a Docker container" on YouTube.

YouTube video: Atmel Software Framework and build chain in a Docker container

A follow-up to my video tutorial: “Program an Atmel SAM without an IDE” I’ve created a Docker container on GitHub with a complete ASF build chain. Ready to go. Go for it!

ASF build Docker container

This repository provides you with a full development environment supporting ASF within a Docker container. It currently provides version 3.37 of ASF.

You can pick it up from GitHub.

Quick Start (for the impatient)

Pull down the GitHub repo and build. This may take a while as it ends up being around 2.4GB.

git clone https://github.com/mickmake/AtmelASF-docker.git
cd AtmelASF-docker/full/3.37
make build

Then run a shell within that container:

make shell

Or change directory to your source tree and compile using ‘make’:

cd /some/dir/on/your/pc
docker run --rm -i -t -v "$PWD":/home/build mickmake/debian-asf:3.37 make

Supported tags and respective Dockerfiles

3.37, latest _(3.37/Dockerfile) - full build _

3.37, latest _(3.37/Dockerfile) - using layers _

Using this container.

Two options. 1. Pull from Docker Hub. 2. Or you can use the GitHub method to build and run the container. The container ends up being around 2.4GB. DockerHub should be the quickest method if you don’t want to customize.

Using it from Docker Hub

Links

(Docker Hub repo)[https://hub.docker.com/r/mickmake/AtmelASF/]

(Docker Cloud repo)[https://cloud.docker.com/swarm/mickmake/repository/docker/mickmake/AtmelASF/]

Setup from Docker Hub

A simple docker pull mickmake/AtmelASF will pull down the latest version.

Runtime from Docker Hub

start - Spin up a Docker container with the correct runtime configs. This will later support remote builds, (to avoid restarting containers).

docker run -d --name debian-asf-3.37 -v "$PWD":/home/build mickmake/debian-asf:3.37

stop - Stop a Docker container.

docker stop debian-asf-3.37

run - Run a Docker container in the foreground, (all STDOUT and STDERR will go to console). The Container will be removed on termination.

docker run --rm -v "$PWD":/home/build mickmake/debian-asf:3.37

shell - Run a shell, (/bin/bash), within a Docker container.

docker run --rm -i -t -v "$PWD":/home/build mickmake/debian-asf:3.37 /bin/bash

make - Run make within the current directory.

docker run --rm -i -t -v "$PWD":/home/build mickmake/debian-asf:3.37

rm - Remove the Docker container. Not needed if you use the -i -t flags.

docker container rm debian-asf-3.37

Using it from GitHub repo

Setup from GitHub repo

Simply clone this repository to your local machine

git clone https://github.com/mickmake/AtmelASF-docker.git

Building from GitHub repo

You have two build choices: 1. Using a layered approach - This will allow you to build on top of other base containers, such as Debian, Alpine, etc. 2. All-in-one - Will build straight from the O/S reference container. make build - Build Docker images. Build all versions from the base directory or specific versions from each directory.

make list - List already built Docker images. List all versions from the base directory or specific versions from each directory.

make clean - Remove already built Docker images. Remove all versions from the base directory or specific versions from each directory.

make push - Push already built Docker images to Docker Hub, (only for WPLib admins). Push all versions from the base directory or specific versions from each directory.