Atmel Makefile Featured Image

Building Atmel Studio ASF Project using External Makefile

The Atmel Studio IDE is a useful tool thanks to the comprehensive debugging support and management of project drivers via the Atmel Software Framework (ASF) – coming from a hardcore Vim advocate. One thing I dislike about IDEs is the fact they hide the make process from the user making it difficult to break a project away from the software. On wishing to develop code on different operating systems (being Visual Studio based, Atmel Studio is limited to Windows), and outside the IDE, I set about creating a Makefile for an Atmel Studio project built around the ASF.


Atmel Studio provides a command line tool for building projects but unfortunately it still relies on the project file and isn’t completely makefile based. Digging into the ASF, I found a Makefiles for AVR and SAM systems in ‘common/util/make’ and ‘sam/util/make’ respectively. It’s a project independant Makefile for each processor type, requiring an include ‘’ that defines the project specific name, source, includes etc.

Copy this file (either AVR or SAM depending on what you’re using) to the to root directory of the project you want to build.


Template ‘’ files can be found in the various demo projects within the ASF folder. Just do a find . -name | grep sam3 in the ASF root to find one for the board used in your project. They are well commented so fairly self explanatory. The main changes required are ‘PRJ_PATH’, ‘TARGET_FLASH’ and the source/includes.

Defining the source and includes required for a large project would be a timely and frustrating process – it’s one of the main attractions of the IDE. Thankfully, the build folder contains (‘Debug’ by default) a Makefile that has done this for us (it doesn’t build on its own though). Just copy ‘C_SRCS’ to ‘CSRCS’ and ‘SUBDIR’ tp ‘INC_PATH’ – NOTE the includes in the are appended with the ASF dir ‘PRJ_PATH’ whereas the ‘CSRCS’ are not.

Finally, check the ‘CPPFLAGS’ defines are the same as those in the IDE. Generally you’ll need to define the MCU in the format ‘MCU‘. Check also that the linker scripts are correct for the board (relative to ‘PRJ_PATH’ again).


Once configured, simply make at the command line will build the project – completely non-reliant on the Atmel Project. The Makefile and can also be used for general Atmel projects without the ASF. The files below are examples for a simple GCC application:

Atmel Make SAM Template


One thought on “Building Atmel Studio ASF Project using External Makefile”

Leave a Reply