1
#_______________________________________________________________________________
3
# edam's arduino makefile
4
#_______________________________________________________________________________
7
# Copyright (c) 2011 Tim Marston <tim@ed.am>.
9
# Permission is hereby granted, free of charge, to any person obtaining a copy
10
# of this software and associated documentation files (the "Software"), to deal
11
# in the Software without restriction, including without limitation the rights
12
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
13
# copies of the Software, and to permit persons to whom the Software is
14
# furnished to do so, subject to the following conditions:
16
# The above copyright notice and this permission notice shall be included in
17
# all copies or substantial portions of the Software.
19
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
20
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
22
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
23
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
24
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
27
#_______________________________________________________________________________
30
# This is a general purpose makefile for use with Arduino hardware and
31
# software. It works with the arduino-1.0 release and requires that
32
# software to be downloaded separately (see http://arduino.cc/). To
33
# download the latest version of this makefile, visit the following
34
# website, where you can also find more information and documentation
35
# on it's use. The following text can only really be considered a
36
# reference to it's use.
38
# http://ed.am/dev/make/arduino-makefile
40
# To install, it is suggested that you keep arduino.mk somewhere and
41
# either symlink to it or include it in your make files. I keep mine
42
# at ~/src/arduino.mk. You will need to alter the value of the
43
# ARDUINODIR variable (below) to be the path where you have unpacked
44
# the arduino software from arduino.cc.
46
# This makefile can be used as a drop-in replacement for the Arduino
47
# IDE's build system. Simply create a symlink to it under the name
48
# "Makefile" and run make (remembering to specify an ARDUINODIR and
49
# BOARD, as described below). You would create the symlink like like
52
# $ ln -s ~/src/arduino.mk Makefile
54
# The presence of a .ino or .pde file causes the arduino.mk to
55
# atuomatically determine va;ues for SOURCES, TARGET and LIBRARIES.
56
# Any .c, .cc and .cpp files in the project directory (or a "util" or
57
# "utility" subdirectory) are automatically included in the build and
58
# are scanned for libraries that have been #included.
60
# Alternatively, if you want to manually specify build variables,
61
# create a Makefile that defines SOURCES and LIBRARARIES and then
62
# includes arduino.mk. (There is no need to define TARGET). You will
63
# also be expected to provide a main() function, for example in
64
# main.cc, which may or may not duplicate the functionality of the
65
# default main() that calls init() and loop(). Here is an example
68
# SOURCES := main.cc foo.cc
70
# include ~/src/arduino.mk
72
# A complete list of all the settings you can use in your Makefile
73
# follows shortly. It should be noted, however, that some variables
74
# are better specified in the environment (or on the command line)
75
# than in your Makefile. Specifically, the ARDUINODIR, BOARD and, if
76
# it is not automatically detected, SERIALDEV.
78
# When running make, you might want to specify the board and path to
79
# your installation of the arduino software, like this:
81
# $ export ARDUINODIR=~/opt/arduino-1.0
82
# $ export BOARD=pro5v
85
# For a list of available board types, run `make boards`.
1
# Arduino 0022 Makefile
87
# Here is a complete list of configuration parameters:
89
# ARDUINODIR The path where you have installed/unpacked the arduino
90
# software (from http://arduino.cc/)
92
# BOARD Specify a target board type.
94
# SERIALDEV The unix device of the device where the arduino can be
95
# found. If unspecified, an attempt is made to determine
96
# the name of a connected arduino's serial device.
98
# TARGET The name of the target file. This is set automatically
99
# if a .ino or .pde is found, but it is not neccesary to
102
# SOURCES A list of all source files of whatever language. The
103
# language type is determined by the file extension.
104
# This is set automatically if a .ino or .pde is found.
106
# LIBRARIES A list of arduino libraries to build and include. This
107
# is set automatically if a .ino or .pde is found.
109
# This general-purpose makefile also defines the following goals for
110
# use on the command line when you run make:
112
# all This is the default if no goal is specified. It builds
113
# the target and uploads it.
115
# target Builds the target of your Makefile.
117
# upload Uploads the target to an attached arduino.
119
# clean Deletes temporary files.
121
# <file> Builds the specified file, either an object file or the
122
# target, from those that that would be built for the
125
#_______________________________________________________________________________
128
# The full path to the arduino software, from arduino.cc
130
ARDUINODIR := $(wildcard ~/opt/arduino-1.0)
133
# check arduino software
134
ifeq ($(wildcard $(ARDUINODIR)/hardware/arduino/boards.txt), )
135
$(error ARDUINODIR is not set correctly; arduino software not found)
139
INOFILE := $(wildcard *.ino *.pde)
141
ifneq ($(words $(INOFILE)), 1)
142
$(error There is more than one .pde or .ino file in this directory!)
144
TARGET := $(basename $(INOFILE))
145
SOURCES := $(INOFILE) \
146
$(wildcard *.c *.cc *.cpp) \
147
$(wildcard $(addprefix util/, *.c *.cc *.cpp)) \
148
$(wildcard $(addprefix utility/, *.c *.cc *.cpp))
149
# automatically determine included libraries
150
ARDUINOLIBSAVAIL := $(notdir $(wildcard $(ARDUINODIR)/libraries/*))
151
LIBRARIES := $(filter $(ARDUINOLIBSAVAIL), \
152
$(shell sed -ne "s/^ *\# *include *[<\"]\(.*\)\.h[>\"]/\1/p" $(SOURCES)))
155
# no target? use default
160
# no serial device? attempt to detect an arduino
162
SERIALDEV := $(firstword $(wildcard /dev/ttyACM? /dev/ttyUSB?))
165
# no board? oh dear...
167
ifneq "$(MAKECMDGOALS)" "boards"
168
ifneq "$(MAKECMDGOALS)" "clean"
169
$(error BOARD is unset. Type 'make boards' to see possible values)
175
OBJECTS := $(addsuffix .o, $(basename $(SOURCES)))
176
ARDUINOSRCDIR := $(ARDUINODIR)/hardware/arduino/cores/arduino
177
ARDUINOLIB := _arduino.a
178
ARDUINOLIBTMP := _arduino.a.tmp
179
ARDUINOLIBOBJS := $(patsubst %, $(ARDUINOLIBTMP)/%.o, $(basename $(notdir \
180
$(wildcard $(addprefix $(ARDUINOSRCDIR)/, *.c *.cpp)))))
181
ARDUINOLIBOBJS += $(foreach lib, $(LIBRARIES), \
182
$(patsubst %, $(ARDUINOLIBTMP)/%.o, $(basename $(notdir \
183
$(wildcard $(addprefix $(ARDUINODIR)/libraries/$(lib)/, *.c *.cpp))))))
185
# obtain board parameters from the arduino boards.txt file
186
BOARDS_FILE := $(ARDUINODIR)/hardware/arduino/boards.txt
188
$(shell sed -ne "s/$(BOARD).build.mcu=\(.*\)/\1/p" $(BOARDS_FILE))
189
BOARD_BUILD_FCPU := \
190
$(shell sed -ne "s/$(BOARD).build.f_cpu=\(.*\)/\1/p" $(BOARDS_FILE))
191
BOARD_BUILD_VARIANT := \
192
$(shell sed -ne "s/$(BOARD).build.variant=\(.*\)/\1/p" $(BOARDS_FILE))
193
BOARD_UPLOAD_SPEED := \
194
$(shell sed -ne "s/$(BOARD).upload.speed=\(.*\)/\1/p" $(BOARDS_FILE))
195
BOARD_UPLOAD_PROTOCOL := \
196
$(shell sed -ne "s/$(BOARD).upload.protocol=\(.*\)/\1/p" $(BOARDS_FILE))
203
OBJCOPY := avr-objcopy
207
CPPFLAGS = -Os -Wall -fno-exceptions -ffunction-sections -fdata-sections
208
CPPFLAGS += -mmcu=$(BOARD_BUILD_MCU) -DF_CPU=$(BOARD_BUILD_FCPU)
209
CPPFLAGS += -I. -Iutil -Iutility -I$(ARDUINOSRCDIR)
210
CPPFLAGS += -I$(ARDUINODIR)/hardware/arduino/variants/$(BOARD_BUILD_VARIANT)/
211
CPPFLAGS += $(addprefix -I$(ARDUINODIR)/libraries/,$(LIBRARIES))
212
AVRDUDEFLAGS = -C $(ARDUINODIR)/hardware/tools/avrdude.conf -DV
213
AVRDUDEFLAGS += -p $(BOARD_BUILD_MCU) -P $(SERIALDEV)
214
AVRDUDEFLAGS += -c $(BOARD_UPLOAD_PROTOCOL) -b $(BOARD_UPLOAD_SPEED)
215
LINKFLAGS = -Os -Wl,--gc-sections -mmcu=$(BOARD_BUILD_MCU)
220
#_______________________________________________________________________________
223
.PHONY: all target upload clean boards
227
target: $(TARGET).hex
230
stty -F $(SERIALDEV) hupcl
231
$(AVRDUDE) $(AVRDUDEFLAGS) -U flash:w:$(TARGET).hex:i
4
# written by olikraus@gmail.com
7
# - boards.txt is used to derive parameters
8
# - All intermediate files are put into a separate directory (TMPDIRNAME)
9
# - Simple use: Copy Makefile into the same directory of the .pde file
12
# - requires UNIX environment
13
# - TMPDIRNAME must be subdirectory of the current directory.
16
# all build everything
17
# upload build and upload to arduino
18
# clean remove all temporary files (includes final hex file)
21
# 001 28 Apr 2010 first release
22
# 002 05 Oct 2010 added 'uno'
25
#=== user configuration ===
26
# All ...PATH variables must have a '/' at the end
28
# Board (and prozessor) information: see $(ARDUINO_PATH)hardware/arduino/boards.txt
32
# atmega328 Arduino Duemilanove or Nano w/ ATmega328
33
# diecimila Arduino Diecimila, Duemilanove, or Nano w/ ATmega168
36
# lilypad328 LilyPad Arduino w/ ATmega328
39
# additional (comma separated) defines
40
# -DDOGM128_HW board is connected to DOGM128 display
41
# -DDOGM132_HW board is connected to DOGM132 display
42
# -DDOGS102_HW board is connected to DOGS102 display
43
# -DDOG_REVERSE 180 degree rotation
46
# The location where the avr tools (e.g. avr-gcc) are located. Requires a '/' at the end.
47
# Can be empty if all tools are accessable through the search path
48
AVR_TOOLS_PATH:=/usr/bin/
50
# Install path of the arduino software. Requires a '/' at the end.
51
ARDUINO_PATH:=/home/edam/opt/arduino-0022/
53
# Install path for avrdude. Requires a '/' at the end. Can be empty if
54
# avrdude is in the search path.
55
AVRDUDE_PATH:=$(ARDUINO_PATH)hardware/tools/
57
# The unix device where we can reach the arduino board
59
# Duemilanove: /dev/ttyUSB0
60
AVRDUDE_PORT:=/dev/ttyACM0
62
# List of all libaries which should be included.
63
#EXTRA_DIRS+=$(ARDUINO_PATH)libraries/SPI/
64
#EXTRA_DIRS+=$(ARDUINO_PATH)libraries/Ethernet/
65
#EXTRA_DIRS+=$(ARDUINO_PATH)libraries/Ethernet/utility/
67
#=== fetch parameter from boards.txt processor parameter ===
68
# the basic idea is to get most of the information from boards.txt
70
BOARDS_TXT:=$(ARDUINO_PATH)hardware/arduino/boards.txt
72
# get the MCU value from the $(BOARD).build.mcu variable. For the
73
# atmega328 board this is atmega328p
74
MCU:=$(shell sed -n -e "s/$(BOARD).build.mcu=\(.*\)/\1/p" $(BOARDS_TXT))
75
# get the F_CPU value from the $(BOARD).build.f_cpu variable. For the
76
# atmega328 board this is 16000000
77
F_CPU:=$(shell sed -n -e "s/$(BOARD).build.f_cpu=\(.*\)/\1/p" $(BOARDS_TXT))
80
# get the AVRDUDE_UPLOAD_RATE value from the $(BOARD).upload.speed
81
# variable. For the atmega328 board this is 57600
82
AVRDUDE_UPLOAD_RATE:=$(shell sed -n -e "s/$(BOARD).upload.speed=\(.*\)/\1/p" $(BOARDS_TXT))
83
# get the AVRDUDE_PROGRAMMER value from the $(BOARD).upload.protocol
84
# variable. For the atmega328 board this is stk500
85
#AVRDUDE_PROGRAMMER:=$(shell sed -n -e "s/$(BOARD).upload.protocol=\(.*\)/\1/p" $(BOARDS_TXT))
86
# use stk500v1, because stk500 will default to stk500v2
87
AVRDUDE_PROGRAMMER:=stk500v1
89
#=== identify user files ===
90
PDESRC:=$(shell ls *.pde)
91
TARGETNAME=$(basename $(PDESRC))
93
CDIRS:=$(EXTRA_DIRS) $(addsuffix utility/,$(EXTRA_DIRS))
94
CDIRS:=*.c utility/*.c $(addsuffix *.c,$(CDIRS)) $(ARDUINO_PATH)hardware/arduino/cores/arduino/*.c
95
CSRC:=$(shell ls $(CDIRS) 2>/dev/null)
97
CCSRC:=$(shell ls *.cc 2>/dev/null)
99
CPPDIRS:=$(EXTRA_DIRS) $(addsuffix utility/,$(EXTRA_DIRS))
100
CPPDIRS:=*.cpp utility/*.cpp $(addsuffix *.cpp,$(CPPDIRS)) $(ARDUINO_PATH)hardware/arduino/cores/arduino/*.cpp
101
CPPSRC:=$(shell ls $(CPPDIRS) 2>/dev/null)
103
#=== build internal variables ===
105
# the name of the subdirectory where everything is stored
107
TMPDIRPATH:=$(TMPDIRNAME)/
109
AVRTOOLSPATH:=$(AVR_TOOLS_PATH)
111
OBJCOPY:=$(AVRTOOLSPATH)avr-objcopy
112
OBJDUMP:=$(AVRTOOLSPATH)avr-objdump
113
SIZE:=$(AVRTOOLSPATH)avr-size
115
CPPSRC:=$(addprefix $(TMPDIRPATH),$(PDESRC:.pde=.cpp)) $(CPPSRC)
118
CCOBJ:=$(CCSRC:.cc=.o)
119
CPPOBJ:=$(CPPSRC:.cpp=.o)
121
OBJFILES:=$(COBJ) $(CCOBJ) $(CPPOBJ)
122
DIRS:= $(dir $(OBJFILES))
124
DEPFILES:=$(OBJFILES:.o=.d)
125
# assembler files from avr-gcc -S
126
ASSFILES:=$(OBJFILES:.o=.s)
127
# disassembled object files with avr-objdump -S
128
DISFILES:=$(OBJFILES:.o=.dis)
131
LIBNAME:=$(TMPDIRPATH)$(TARGETNAME).a
132
ELFNAME:=$(TMPDIRPATH)$(TARGETNAME).elf
133
HEXNAME:=$(TMPDIRPATH)$(TARGETNAME).hex
135
AVRDUDE_FLAGS = -V -F
136
AVRDUDE_FLAGS += -C $(ARDUINO_PATH)/hardware/tools/avrdude.conf
137
AVRDUDE_FLAGS += -p $(MCU)
138
AVRDUDE_FLAGS += -P $(AVRDUDE_PORT)
139
AVRDUDE_FLAGS += -c $(AVRDUDE_PROGRAMMER)
140
AVRDUDE_FLAGS += -b $(AVRDUDE_UPLOAD_RATE)
141
AVRDUDE_FLAGS += -U flash:w:$(HEXNAME)
143
AVRDUDE = $(AVRDUDE_PATH)avrdude
145
#=== predefined variable override ===
147
# use "make -p -f/dev/null" to see the default rules and definitions
148
# Build C and C++ flags. Include path information must be placed here
149
COMMON_FLAGS = -DF_CPU=$(F_CPU) -mmcu=$(MCU) $(DEFS)
150
# COMMON_FLAGS += -gdwarf-2
152
COMMON_FLAGS += -Wall -funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums
153
COMMON_FLAGS += -I. -Iutility
154
COMMON_FLAGS += -I$(ARDUINO_PATH)hardware/arduino/cores/arduino
155
COMMON_FLAGS += $(addprefix -I,$(EXTRA_DIRS))
156
COMMON_FLAGS += -fno-exceptions -ffunction-sections -fdata-sections -Wl,--gc-sections
157
COMMON_FLAGS += -Wl,--relax
158
COMMON_FLAGS += -mcall-prologues
160
CFLAGS = $(COMMON_FLAGS) -std=gnu99 -Wstrict-prototypes
161
CXXFLAGS = $(COMMON_FLAGS)
163
# Replace standard build tools by avr tools
164
CC = $(AVRTOOLSPATH)avr-gcc
165
CXX = $(AVRTOOLSPATH)avr-g++
166
AR = @$(AVRTOOLSPATH)avr-ar
169
# "rm" must be able to delete a directory tree
174
# add rules for the C/C++ files where the .o file is placed in the
175
# TMPDIRPATH reuse existing variables as far as possible
177
$(TMPDIRPATH)%.o: %.c
179
@$(COMPILE.c) $(OUTPUT_OPTION) $<
181
$(TMPDIRPATH)%.o: %.cc
183
@$(COMPILE.cc) $(OUTPUT_OPTION) $<
185
$(TMPDIRPATH)%.o: %.cpp
187
@$(COMPILE.cpp) $(OUTPUT_OPTION) $<
189
$(TMPDIRPATH)%.s: %.c
190
@$(COMPILE.c) $(OUTPUT_OPTION) -S $<
192
$(TMPDIRPATH)%.s: %.cc
193
@$(COMPILE.cc) $(OUTPUT_OPTION) -S $<
195
$(TMPDIRPATH)%.s: %.cpp
196
@$(COMPILE.cpp) $(OUTPUT_OPTION) -S $<
198
$(TMPDIRPATH)%.dis: $(TMPDIRPATH)%.o
199
@$(OBJDUMP) -S $< > $@
201
.SUFFIXES: .elf .hex .pde
204
@$(OBJCOPY) -O ihex -R .eeprom $< $@
206
$(TMPDIRPATH)%.cpp: %.pde
207
@cat $(ARDUINO_PATH)hardware/arduino/cores/arduino/main.cpp > $@
210
@echo 'extern "C" void __cxa_pure_virtual() { while (1); }' >> $@
214
all: tmpdir $(HEXNAME) assemblersource showsize
215
ls -al $(HEXNAME) $(ELFNAME)
217
$(ELFNAME): $(LIBNAME)($(addprefix $(TMPDIRPATH),$(OBJFILES)))
218
$(LINK.o) $(COMMON_FLAGS) $(LIBNAME) $(LOADLIBES) $(LDLIBS) -o $@
220
$(LIBNAME)(): $(addprefix $(TMPDIRPATH),$(OBJFILES))
222
#=== create temp directory ===
223
# not really required, because it will be also created during the
224
# dependency handling
227
@test -d $(TMPDIRPATH) || mkdir $(TMPDIRPATH)
229
#=== create assembler files for each C/C++ file ===
230
.PHONY: assemblersource
231
assemblersource: $(addprefix $(TMPDIRPATH),$(ASSFILES)) $(addprefix $(TMPDIRPATH),$(DISFILES))
234
#=== show the section sizes of the ELF file ===
239
#=== clean up target ===
240
# this is simple: the TMPDIRPATH is removed
235
rm -f $(TARGET).elf $(TARGET).hex $(ARDUINOLIB) *~
236
rm -rf $(ARDUINOLIBTMP)
239
@echo Available values for BOARD:
240
@sed -ne '/^#/d;s/^\(.*\).name=\(.*\)/\1 \2/;T' \
241
-e 's/\(.\{12\}\) *\(.*\)/\1 \2/;p' $(BOARDS_FILE)
243
# building the target
245
$(TARGET).hex: $(TARGET).elf
246
$(OBJCOPY) -O ihex -R .eeprom $< $@
248
.INTERMEDIATE: $(TARGET).elf
250
$(TARGET).elf: $(ARDUINOLIB) $(OBJECTS)
251
$(CC) $(LINKFLAGS) $(OBJECTS) $(ARDUINOLIB) -o $@
254
$(COMPILE.cpp) -o $@ -x c++ -include $(ARDUINOSRCDIR)/Arduino.h $<
257
$(COMPILE.cpp) -o $@ -x c++ -include $(ARDUINOSRCDIR)/Arduino.h $<
259
# building the arduino library
261
$(ARDUINOLIB): $(ARDUINOLIBOBJS)
263
rm -rf $(ARDUINOLIBTMP)
265
.INTERMEDIATE: $(ARDUINOLIBOBJS)
267
$(ARDUINOLIBTMP)/%.o: $(ARDUINOSRCDIR)/%.c
268
@test -d $(ARDUINOLIBTMP) || mkdir $(ARDUINOLIBTMP)
269
$(COMPILE.c) -o $@ $<
271
$(ARDUINOLIBTMP)/%.o: $(ARDUINOSRCDIR)/%.cpp
272
@test -d $(ARDUINOLIBTMP) || mkdir $(ARDUINOLIBTMP)
273
$(COMPILE.cpp) -o $@ $<
275
$(ARDUINOLIBTMP)/%.o: $(ARDUINODIR)/libraries/*/%.c
276
@test -d $(ARDUINOLIBTMP) || mkdir $(ARDUINOLIBTMP)
277
$(COMPILE.c) -o $@ $<
279
$(ARDUINOLIBTMP)/%.o: $(ARDUINODIR)/libraries/*/%.cpp
280
@test -d $(ARDUINOLIBTMP) || mkdir $(ARDUINOLIBTMP)
281
$(COMPILE.cpp) -o $@ $<
245
# Program the device.
246
# step 1: reset the arduino board with the stty command
247
# step 2: user avrdude to upload the software
250
stty -F $(AVRDUDE_PORT) hupcl
251
$(AVRDUDE) $(AVRDUDE_FLAGS)
254
# === dependency handling ===
255
# From the gnu make manual (section 4.14, Generating Prerequisites
256
# Automatically) Additionally (because this will be the first executed
257
# rule) TMPDIRPATH is created here. Instead of "sed" the "echo"
259
# cd $(TMPDIRPATH); mkdir -p $(DIRS) 2> /dev/null; cd ..
260
DEPACTION=test -d $(TMPDIRPATH) || mkdir $(TMPDIRPATH);\
261
mkdir -p $(addprefix $(TMPDIRPATH),$(DIRS));\
262
set -e; echo -n $@ $(dir $@) > $@; $(CC) -MM $(COMMON_FLAGS) $< >> $@
265
$(TMPDIRPATH)%.d: %.c
268
$(TMPDIRPATH)%.d: %.cc
272
$(TMPDIRPATH)%.d: %.cpp
275
# Include dependency files. If a .d file is missing, a warning is
276
# created and the .d file is created This warning is not a problem
277
# (gnu make manual, section 3.3 Including Other Makefiles)
278
-include $(addprefix $(TMPDIRPATH),$(DEPFILES))