/make/arduino-mk

To get this branch, use:
bzr branch http://bzr.ed.am/make/arduino-mk
1 by edam
initial commit
1
#_______________________________________________________________________________
2
#
32 by edam
typos/spelling
3
#                         edam's Arduino makefile
1 by edam
initial commit
4
#_______________________________________________________________________________
82 by Tim Marston
updated version no. to dev state
5
#                                                                 version 0.6dev
1 by edam
initial commit
6
#
80 by Tim Marston
updated copyright notice
7
# Copyright (C) 2011, 2012, 2013 Tim Marston <tim@ed.am>.
1 by edam
initial commit
8
#
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:
15
#
16
# The above copyright notice and this permission notice shall be included in
17
# all copies or substantial portions of the Software.
18
#
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,
10 by edam
formatting, and changed default for ARDUINODIR
24
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
25
# SOFTWARE.
1 by edam
initial commit
26
#
27
#_______________________________________________________________________________
28
#
29
#
7 by edam
fixed comments for publishing
30
# This is a general purpose makefile for use with Arduino hardware and
75 by Tim Marston
updated reference documentation
31
# software.  It works with the arduino-1.0 and later software releases.  It
32
# should work GNU/Linux and OS X.  To download the latest version of this
33
# makefile visit the following website where you can also find documentation on
34
# it's use.  (The following text can only really be considered a reference.)
7 by edam
fixed comments for publishing
35
#
11 by edam
fixed URL
36
#   http://ed.am/dev/make/arduino-mk
5 by edam
updated comments; added checks for missing or misconfigured variables; use a default TARGET; attempt to autodetect SERIALDEV; added 'boards' goal; fixed use of 'util' project subdirectory.
37
#
10 by edam
formatting, and changed default for ARDUINODIR
38
# This makefile can be used as a drop-in replacement for the Arduino IDE's
75 by Tim Marston
updated reference documentation
39
# build system.  To use it, just copy arduino.mk in to your project directory.
40
# Or, you could save it somewhere (I keep mine at ~/src/arduino.mk) and create
41
# a symlink to it in your project directory, named "Makefile".  For example:
5 by edam
updated comments; added checks for missing or misconfigured variables; use a default TARGET; attempt to autodetect SERIALDEV; added 'boards' goal; fixed use of 'util' project subdirectory.
42
#
7 by edam
fixed comments for publishing
43
#   $ ln -s ~/src/arduino.mk Makefile
5 by edam
updated comments; added checks for missing or misconfigured variables; use a default TARGET; attempt to autodetect SERIALDEV; added 'boards' goal; fixed use of 'util' project subdirectory.
44
#
75 by Tim Marston
updated reference documentation
45
# The Arduino software (version 1.0 or later) is required.  On GNU/Linux you
46
# can probably install the software from your package manager.  If you are
47
# using Debian (or a derivative), try `apt-get install arduino`.  Otherwise,
48
# you can download the Arduino software manually from http://arduino.cc/.  It
49
# is suggested that you install it at ~/opt/arduino (or /Applications on OS X)
50
# if you are unsure.
30 by edam
added THANKS, fixed ARDUINODIR default to look in /usr/share/arduino and capitalised the use of "Arduino" where appropriate.
51
#
52
# If you downloaded the Arduino software manually and unpacked it somewhere
75 by Tim Marston
updated reference documentation
53
# other than ~/opt/arduino (or /Applications), you will need to set up the
54
# ARDUINODIR environment variable to be the path where you unpacked it.  (If
55
# unset, ARDUINODIR defaults to some sensible places).  You could set this in
12 by edam
cleaned up comments
56
# your ~/.profile by adding something like this:
57
#
58
#   export ARDUINODIR=~/somewhere/arduino-1.0
59
#
75 by Tim Marston
updated reference documentation
60
# For each project, you will also need to set BOARD to the type of Arduino
61
# you're building for.  Type `make boards` for a list of acceptable values.
62
# For example:
12 by edam
cleaned up comments
63
#
64
#   $ export BOARD=uno
65
#   $ make
66
#
67
# You may also need to set SERIALDEV if it is not detected correctly.
68
#
18 by edam
downplay importance of .pde files
69
# The presence of a .ino (or .pde) file causes the arduino.mk to automatically
16 by edam
spellcheck, and added check for missing GNU screen
70
# determine values for SOURCES, TARGET and LIBRARIES.  Any .c, .cc and .cpp
71
# files in the project directory (or any "util" or "utility" subdirectories)
72
# are automatically included in the build and are scanned for Arduino libraries
75 by Tim Marston
updated reference documentation
73
# that have been #included.  Note, there can only be one .ino (or .pde) file in
74
# a project directory and if you want to be compatible with the Arduino IDE, it
75
# should be called the same as the directory name.
5 by edam
updated comments; added checks for missing or misconfigured variables; use a default TARGET; attempt to autodetect SERIALDEV; added 'boards' goal; fixed use of 'util' project subdirectory.
76
#
10 by edam
formatting, and changed default for ARDUINODIR
77
# Alternatively, if you want to manually specify build variables, create a
16 by edam
spellcheck, and added check for missing GNU screen
78
# Makefile that defines SOURCES and LIBRARIES and then includes arduino.mk.
75 by Tim Marston
updated reference documentation
79
# (There is no need to define TARGET).  You can also specify the BOARD here, if
80
# the project has a specific one.  Here is an example Makefile:
5 by edam
updated comments; added checks for missing or misconfigured variables; use a default TARGET; attempt to autodetect SERIALDEV; added 'boards' goal; fixed use of 'util' project subdirectory.
81
#
12 by edam
cleaned up comments
82
#   SOURCES := main.cc other.cc
7 by edam
fixed comments for publishing
83
#   LIBRARIES := EEPROM
75 by Tim Marston
updated reference documentation
84
#   BOARD := pro5v
7 by edam
fixed comments for publishing
85
#   include ~/src/arduino.mk
1 by edam
initial commit
86
#
8 by edam
broke out ARDUINODIR, so it is not configured in the makefile
87
# Here is a complete list of configuration parameters:
88
#
30 by edam
added THANKS, fixed ARDUINODIR default to look in /usr/share/arduino and capitalised the use of "Arduino" where appropriate.
89
# ARDUINODIR   The path where the Arduino software is installed on your system.
4 by edam
added included-library autodetection and updated comments
90
#
30 by edam
added THANKS, fixed ARDUINODIR default to look in /usr/share/arduino and capitalised the use of "Arduino" where appropriate.
91
# ARDUINOCONST The Arduino software version, as an integer, used to define the
63 by edam
documented AVRDUDEFLAGS, CPPFLAGS, LINKFLAGS and LINBRARYPATH, cleaned up a
92
#              ARDUINO version constant.  This defaults to 100 if undefined.
25 by edam
added AVRDUDECONF variable; fixed some OS X issues; added SERIALDEV guess warning and invalid BOARD value error
93
#
63 by edam
documented AVRDUDEFLAGS, CPPFLAGS, LINKFLAGS and LINBRARYPATH, cleaned up a
94
# AVRDUDECONF  The avrdude.conf to use.  If undefined, this defaults to a guess
75 by Tim Marston
updated reference documentation
95
#              based on where avrdude is.  If set empty, no avrdude.conf is
96
#              passed to avrdude (so the system default is used).
23 by edam
added ARDUINOCONST, AVRTOOLSPATH, detection of avrdude.conf and cleaned up make variable types
97
#
63 by edam
documented AVRDUDEFLAGS, CPPFLAGS, LINKFLAGS and LINBRARYPATH, cleaned up a
98
# AVRDUDEFLAGS Specify any additional flags for avrdude.  The usual flags,
99
#              required to build the project, will be appended to this.
100
#
101
# AVRTOOLSPATH A space-separated list of directories that is searched in order
102
#              when looking for the avr build tools.  This defaults to PATH,
103
#              followed by subdirectories in ARDUINODIR.
23 by edam
added ARDUINOCONST, AVRTOOLSPATH, detection of avrdude.conf and cleaned up make variable types
104
#
12 by edam
cleaned up comments
105
# BOARD        Specify a target board type.  Run `make boards` to see available
106
#              board types.
4 by edam
added included-library autodetection and updated comments
107
#
63 by edam
documented AVRDUDEFLAGS, CPPFLAGS, LINKFLAGS and LINBRARYPATH, cleaned up a
108
# CPPFLAGS     Specify any additional flags for the compiler.  The usual flags,
109
#              required to build the project, will be appended to this.
110
#
111
# LINKFLAGS    Specify any additional flags for the linker.  The usual flags,
112
#              required to build the project, will be appended to this.
113
#
30 by edam
added THANKS, fixed ARDUINODIR default to look in /usr/share/arduino and capitalised the use of "Arduino" where appropriate.
114
# LIBRARIES    A list of Arduino libraries to build and include.  This is set
23 by edam
added ARDUINOCONST, AVRTOOLSPATH, detection of avrdude.conf and cleaned up make variable types
115
#              automatically if a .ino (or .pde) is found.
116
#
63 by edam
documented AVRDUDEFLAGS, CPPFLAGS, LINKFLAGS and LINBRARYPATH, cleaned up a
117
# LIBRARYPATH  A space-separated list of directories that is searched in order
118
#              when looking for Arduino libraries.  This defaults to "libs",
75 by Tim Marston
updated reference documentation
119
#              "libraries" (in the project directory), then your sketchbook
120
#              "libraries" directory, then the Arduino libraries directory.
63 by edam
documented AVRDUDEFLAGS, CPPFLAGS, LINKFLAGS and LINBRARYPATH, cleaned up a
121
#
75 by Tim Marston
updated reference documentation
122
# SERIALDEV    The POSIX device name of the serial device that is the Arduino.
123
#              If unspecified, an attempt is made to guess the name of a
124
#              connected Arduino's serial device, which may work in some cases.
10 by edam
formatting, and changed default for ARDUINODIR
125
#
23 by edam
added ARDUINOCONST, AVRTOOLSPATH, detection of avrdude.conf and cleaned up make variable types
126
# SOURCES      A list of all source files of whatever language.  The language
127
#              type is determined by the file extension.  This is set
128
#              automatically if a .ino (or .pde) is found.
129
#
10 by edam
formatting, and changed default for ARDUINODIR
130
# TARGET       The name of the target file.  This is set automatically if a
18 by edam
downplay importance of .pde files
131
#              .ino (or .pde) is found, but it is not necessary to set it
10 by edam
formatting, and changed default for ARDUINODIR
132
#              otherwise.
133
#
12 by edam
cleaned up comments
134
# This makefile also defines the following goals for use on the command line
135
# when you run make:
5 by edam
updated comments; added checks for missing or misconfigured variables; use a default TARGET; attempt to autodetect SERIALDEV; added 'boards' goal; fixed use of 'util' project subdirectory.
136
#
12 by edam
cleaned up comments
137
# all          This is the default if no goal is specified.  It builds the
35 by edam
build arduino static lib in .lib using full pathnames in object files (so files of the same name but in different locations can co-exist)
138
#              target.
1 by edam
initial commit
139
#
12 by edam
cleaned up comments
140
# target       Builds the target.
141
#
75 by Tim Marston
updated reference documentation
142
# upload       Uploads the target (building it, as necessary) to an attached
143
#              Arduino.
12 by edam
cleaned up comments
144
#
145
# clean        Deletes files created during the build.
1 by edam
initial commit
146
#
10 by edam
formatting, and changed default for ARDUINODIR
147
# boards       Display a list of available board names, so that you can set the
148
#              BOARD environment variable appropriately.
149
#
16 by edam
spellcheck, and added check for missing GNU screen
150
# monitor      Start `screen` on the serial device.  This is meant to be an
30 by edam
added THANKS, fixed ARDUINODIR default to look in /usr/share/arduino and capitalised the use of "Arduino" where appropriate.
151
#              equivalent to the Arduino serial monitor.
10 by edam
formatting, and changed default for ARDUINODIR
152
#
72 by edam
typo
153
# size         Displays size information about the built target.
34 by Tim Marston
added 'size' goal
154
#
69 by edam
added support for burning bootloaders
155
# bootloader   Burns the bootloader for your board to it.
156
#
10 by edam
formatting, and changed default for ARDUINODIR
157
# <file>       Builds the specified file, either an object file or the target,
158
#              from those that that would be built for the project.
1 by edam
initial commit
159
#_______________________________________________________________________________
5 by edam
updated comments; added checks for missing or misconfigured variables; use a default TARGET; attempt to autodetect SERIALDEV; added 'boards' goal; fixed use of 'util' project subdirectory.
160
#
1 by edam
initial commit
161
23 by edam
added ARDUINOCONST, AVRTOOLSPATH, detection of avrdude.conf and cleaned up make variable types
162
# default arduino software directory, check software exists
8 by edam
broke out ARDUINODIR, so it is not configured in the makefile
163
ifndef ARDUINODIR
73 by Tim Marston
fixed default ARDUINODIR and PREFERENCESFILE locations for Macs
164
ARDUINODIR := $(firstword $(wildcard ~/opt/arduino /usr/share/arduino \
165
	/Applications/Arduino.app/Contents/Resources/Java \
166
	$(HOME)/Applications/Arduino.app/Contents/Resources/Java))
8 by edam
broke out ARDUINODIR, so it is not configured in the makefile
167
endif
25 by edam
added AVRDUDECONF variable; fixed some OS X issues; added SERIALDEV guess warning and invalid BOARD value error
168
ifeq "$(wildcard $(ARDUINODIR)/hardware/arduino/boards.txt)" ""
8 by edam
broke out ARDUINODIR, so it is not configured in the makefile
169
$(error ARDUINODIR is not set correctly; arduino software not found)
5 by edam
updated comments; added checks for missing or misconfigured variables; use a default TARGET; attempt to autodetect SERIALDEV; added 'boards' goal; fixed use of 'util' project subdirectory.
170
endif
1 by edam
initial commit
171
23 by edam
added ARDUINOCONST, AVRTOOLSPATH, detection of avrdude.conf and cleaned up make variable types
172
# default arduino version
173
ARDUINOCONST ?= 100
174
175
# default path for avr tools
67 by edam
added support for the user's sketchbook libraries directory
176
AVRTOOLSPATH ?= $(subst :, , $(PATH)) $(ARDUINODIR)/hardware/tools \
177
	$(ARDUINODIR)/hardware/tools/avr/bin
23 by edam
added ARDUINOCONST, AVRTOOLSPATH, detection of avrdude.conf and cleaned up make variable types
178
62 by edam
added support for third party libraries and fixed support for .C c++ files
179
# default path to find libraries
67 by edam
added support for the user's sketchbook libraries directory
180
LIBRARYPATH ?= libraries libs $(SKETCHBOOKDIR)/libraries $(ARDUINODIR)/libraries
62 by edam
added support for third party libraries and fixed support for .C c++ files
181
69 by edam
added support for burning bootloaders
182
# default serial device to a poor guess (something that might be an arduino)
183
SERIALDEVGUESS := 0
184
ifndef SERIALDEV
185
SERIALDEV := $(firstword $(wildcard \
186
	/dev/ttyACM? /dev/ttyUSB? /dev/tty.usbserial* /dev/tty.usbmodem*))
187
SERIALDEVGUESS := 1
188
endif
189
190
# no board?
191
ifndef BOARD
192
ifneq "$(MAKECMDGOALS)" "boards"
193
ifneq "$(MAKECMDGOALS)" "clean"
194
$(error BOARD is unset.  Type 'make boards' to see possible values)
195
endif
196
endif
197
endif
198
199
# obtain board parameters from the arduino boards.txt file
200
BOARDSFILE := $(ARDUINODIR)/hardware/arduino/boards.txt
84 by Tim Marston
be stricter when extracting parameters from boards.txt
201
readboardsparam = $(shell sed -ne "s/^$(BOARD).$(1)=\(.*\)/\1/p" $(BOARDSFILE))
69 by edam
added support for burning bootloaders
202
BOARD_BUILD_MCU := $(call readboardsparam,build.mcu)
203
BOARD_BUILD_FCPU := $(call readboardsparam,build.f_cpu)
204
BOARD_BUILD_VARIANT := $(call readboardsparam,build.variant)
83 by Tim Marston
read and use the build.core parameter in boards.txt
205
BOARD_BUILD_CORE := $(call readboardsparam,build.core)
69 by edam
added support for burning bootloaders
206
BOARD_UPLOAD_SPEED := $(call readboardsparam,upload.speed)
207
BOARD_UPLOAD_PROTOCOL := $(call readboardsparam,upload.protocol)
208
BOARD_USB_VID := $(call readboardsparam,build.vid)
209
BOARD_USB_PID := $(call readboardsparam,build.pid)
210
BOARD_BOOTLOADER_UNLOCK := $(call readboardsparam,bootloader.unlock_bits)
211
BOARD_BOOTLOADER_LOCK := $(call readboardsparam,bootloader.lock_bits)
212
BOARD_BOOTLOADER_LFUSES := $(call readboardsparam,bootloader.low_fuses)
213
BOARD_BOOTLOADER_HFUSES := $(call readboardsparam,bootloader.high_fuses)
214
BOARD_BOOTLOADER_EFUSES := $(call readboardsparam,bootloader.extended_fuses)
215
BOARD_BOOTLOADER_PATH := $(call readboardsparam,bootloader.path)
216
BOARD_BOOTLOADER_FILE := $(call readboardsparam,bootloader.file)
217
218
# obtain preferences from the IDE's preferences.txt
73 by Tim Marston
fixed default ARDUINODIR and PREFERENCESFILE locations for Macs
219
PREFERENCESFILE := $(firstword $(wildcard \
220
	$(HOME)/.arduino/preferences.txt $(HOME)/Library/Arduino/preferences.txt))
69 by edam
added support for burning bootloaders
221
ifneq "$(PREFERENCESFILE)" ""
222
readpreferencesparam = $(shell sed -ne "s/$(1)=\(.*\)/\1/p" $(PREFERENCESFILE))
223
SKETCHBOOKDIR := $(call readpreferencesparam,sketchbook.path)
224
endif
225
226
# invalid board?
227
ifeq "$(BOARD_BUILD_MCU)" ""
228
ifneq "$(MAKECMDGOALS)" "boards"
229
ifneq "$(MAKECMDGOALS)" "clean"
230
$(error BOARD is invalid.  Type 'make boards' to see possible values)
231
endif
232
endif
233
endif
234
1 by edam
initial commit
235
# auto mode?
236
INOFILE := $(wildcard *.ino *.pde)
237
ifdef INOFILE
25 by edam
added AVRDUDECONF variable; fixed some OS X issues; added SERIALDEV guess warning and invalid BOARD value error
238
ifneq "$(words $(INOFILE))" "1"
5 by edam
updated comments; added checks for missing or misconfigured variables; use a default TARGET; attempt to autodetect SERIALDEV; added 'boards' goal; fixed use of 'util' project subdirectory.
239
$(error There is more than one .pde or .ino file in this directory!)
1 by edam
initial commit
240
endif
23 by edam
added ARDUINOCONST, AVRTOOLSPATH, detection of avrdude.conf and cleaned up make variable types
241
242
# automatically determine sources and targeet
1 by edam
initial commit
243
TARGET := $(basename $(INOFILE))
244
SOURCES := $(INOFILE) \
62 by edam
added support for third party libraries and fixed support for .C c++ files
245
	$(wildcard *.c *.cc *.cpp *.C) \
246
	$(wildcard $(addprefix util/, *.c *.cc *.cpp *.C)) \
247
	$(wildcard $(addprefix utility/, *.c *.cc *.cpp *.C))
23 by edam
added ARDUINOCONST, AVRTOOLSPATH, detection of avrdude.conf and cleaned up make variable types
248
4 by edam
added included-library autodetection and updated comments
249
# automatically determine included libraries
63 by edam
documented AVRDUDEFLAGS, CPPFLAGS, LINKFLAGS and LINBRARYPATH, cleaned up a
250
LIBRARIES := $(filter $(notdir $(wildcard $(addsuffix /*, $(LIBRARYPATH)))), \
4 by edam
added included-library autodetection and updated comments
251
	$(shell sed -ne "s/^ *\# *include *[<\"]\(.*\)\.h[>\"]/\1/p" $(SOURCES)))
23 by edam
added ARDUINOCONST, AVRTOOLSPATH, detection of avrdude.conf and cleaned up make variable types
252
5 by edam
updated comments; added checks for missing or misconfigured variables; use a default TARGET; attempt to autodetect SERIALDEV; added 'boards' goal; fixed use of 'util' project subdirectory.
253
endif
254
23 by edam
added ARDUINOCONST, AVRTOOLSPATH, detection of avrdude.conf and cleaned up make variable types
255
# software
256
findsoftware = $(firstword $(wildcard $(addsuffix /$(1), $(AVRTOOLSPATH))))
257
CC := $(call findsoftware,avr-gcc)
258
CXX := $(call findsoftware,avr-g++)
259
LD := $(call findsoftware,avr-ld)
260
AR := $(call findsoftware,avr-ar)
261
OBJCOPY := $(call findsoftware,avr-objcopy)
262
AVRDUDE := $(call findsoftware,avrdude)
34 by Tim Marston
added 'size' goal
263
AVRSIZE := $(call findsoftware,avr-size)
23 by edam
added ARDUINOCONST, AVRTOOLSPATH, detection of avrdude.conf and cleaned up make variable types
264
63 by edam
documented AVRDUDEFLAGS, CPPFLAGS, LINKFLAGS and LINBRARYPATH, cleaned up a
265
# directories
83 by Tim Marston
read and use the build.core parameter in boards.txt
266
ARDUINOCOREDIR := $(ARDUINODIR)/hardware/arduino/cores/$(BOARD_BUILD_CORE)
63 by edam
documented AVRDUDEFLAGS, CPPFLAGS, LINKFLAGS and LINBRARYPATH, cleaned up a
267
LIBRARYDIRS := $(foreach lib, $(LIBRARIES), \
268
	$(firstword $(wildcard $(addsuffix /$(lib), $(LIBRARYPATH)))))
269
LIBRARYDIRS += $(addsuffix /utility, $(LIBRARYDIRS))
270
1 by edam
initial commit
271
# files
25 by edam
added AVRDUDECONF variable; fixed some OS X issues; added SERIALDEV guess warning and invalid BOARD value error
272
TARGET := $(if $(TARGET),$(TARGET),a.out)
1 by edam
initial commit
273
OBJECTS := $(addsuffix .o, $(basename $(SOURCES)))
36 by edam
added dependency generation to project files
274
DEPFILES := $(patsubst %, .dep/%.dep, $(SOURCES))
35 by edam
build arduino static lib in .lib using full pathnames in object files (so files of the same name but in different locations can co-exist)
275
ARDUINOLIB := .lib/arduino.a
63 by edam
documented AVRDUDEFLAGS, CPPFLAGS, LINKFLAGS and LINBRARYPATH, cleaned up a
276
ARDUINOLIBOBJS := $(foreach dir, $(ARDUINOCOREDIR) $(LIBRARYDIRS), \
35 by edam
build arduino static lib in .lib using full pathnames in object files (so files of the same name but in different locations can co-exist)
277
	$(patsubst %, .lib/%.o, $(wildcard $(addprefix $(dir)/, *.c *.cpp))))
70 by edam
bootloader may not be specified in boards.txt
278
BOOTLOADERHEX := $(addprefix \
279
	$(ARDUINODIR)/hardware/arduino/bootloaders/$(BOARD_BOOTLOADER_PATH)/, \
280
	$(BOARD_BOOTLOADER_FILE))
62 by edam
added support for third party libraries and fixed support for .C c++ files
281
282
# avrdude confifuration
25 by edam
added AVRDUDECONF variable; fixed some OS X issues; added SERIALDEV guess warning and invalid BOARD value error
283
ifeq "$(AVRDUDECONF)" ""
284
ifeq "$(AVRDUDE)" "$(ARDUINODIR)/hardware/tools/avr/bin/avrdude"
285
AVRDUDECONF := $(ARDUINODIR)/hardware/tools/avr/etc/avrdude.conf
286
else
23 by edam
added ARDUINOCONST, AVRTOOLSPATH, detection of avrdude.conf and cleaned up make variable types
287
AVRDUDECONF := $(wildcard $(AVRDUDE).conf)
25 by edam
added AVRDUDECONF variable; fixed some OS X issues; added SERIALDEV guess warning and invalid BOARD value error
288
endif
289
endif
290
1 by edam
initial commit
291
# flags
61 by Tim Marston
make it possible to add to CPPFLAGS, AVRDUDEFLAGS and LINKFLAGS
292
CPPFLAGS += -Os -Wall -fno-exceptions -ffunction-sections -fdata-sections
36 by edam
added dependency generation to project files
293
CPPFLAGS += -funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums
294
CPPFLAGS += -mmcu=$(BOARD_BUILD_MCU)
295
CPPFLAGS += -DF_CPU=$(BOARD_BUILD_FCPU) -DARDUINO=$(ARDUINOCONST)
49 by edam
added support for the Leonardo
296
CPPFLAGS += -DUSB_VID=$(BOARD_USB_VID) -DUSB_PID=$(BOARD_USB_PID)
45 by edam
fixed CPPFLAGS -I parameters so that path expansion of '~' in ARDUINODIR works
297
CPPFLAGS += -I. -Iutil -Iutility -I $(ARDUINOCOREDIR)
298
CPPFLAGS += -I $(ARDUINODIR)/hardware/arduino/variants/$(BOARD_BUILD_VARIANT)/
63 by edam
documented AVRDUDEFLAGS, CPPFLAGS, LINKFLAGS and LINBRARYPATH, cleaned up a
299
CPPFLAGS += $(addprefix -I , $(LIBRARYDIRS))
36 by edam
added dependency generation to project files
300
CPPDEPFLAGS = -MMD -MP -MF .dep/$<.dep
301
CPPINOFLAGS := -x c++ -include $(ARDUINOCOREDIR)/Arduino.h
61 by Tim Marston
make it possible to add to CPPFLAGS, AVRDUDEFLAGS and LINKFLAGS
302
AVRDUDEFLAGS += $(addprefix -C , $(AVRDUDECONF)) -DV
1 by edam
initial commit
303
AVRDUDEFLAGS += -p $(BOARD_BUILD_MCU) -P $(SERIALDEV)
304
AVRDUDEFLAGS += -c $(BOARD_UPLOAD_PROTOCOL) -b $(BOARD_UPLOAD_SPEED)
61 by Tim Marston
make it possible to add to CPPFLAGS, AVRDUDEFLAGS and LINKFLAGS
305
LINKFLAGS += -Os -Wl,--gc-sections -mmcu=$(BOARD_BUILD_MCU)
1 by edam
initial commit
306
43 by edam
fixed check for stty switch, so that it works with busybox
307
# figure out which arg to use with stty (for OS X, GNU and busybox stty)
308
STTYFARG := $(shell stty --help 2>&1 | \
309
	grep -q 'illegal option' && echo -f || echo -F)
25 by edam
added AVRDUDECONF variable; fixed some OS X issues; added SERIALDEV guess warning and invalid BOARD value error
310
36 by edam
added dependency generation to project files
311
# include dependencies
312
ifneq "$(MAKECMDGOALS)" "clean"
313
-include $(DEPFILES)
314
endif
315
1 by edam
initial commit
316
# default rule
317
.DEFAULT_GOAL := all
318
319
#_______________________________________________________________________________
320
#                                                                          RULES
321
69 by edam
added support for burning bootloaders
322
.PHONY:	all target upload clean boards monitor size bootloader
1 by edam
initial commit
323
35 by edam
build arduino static lib in .lib using full pathnames in object files (so files of the same name but in different locations can co-exist)
324
all: target
1 by edam
initial commit
325
2 by edam
fixed build (missing library), tested upload, and made the .elf file an intermediate file (the .hex file is now the target)
326
target: $(TARGET).hex
1 by edam
initial commit
327
40 by Tim Marston
upload now depends on target (added dev to version no.)
328
upload: target
13 by edam
announce that we're uploading and error on SERIALDEV blank
329
	@echo "\nUploading to board..."
330
	@test -n "$(SERIALDEV)" || { \
331
		echo "error: SERIALDEV could not be determined automatically." >&2; \
332
		exit 1; }
27 by edam
fixed test not returning 0
333
	@test 0 -eq $(SERIALDEVGUESS) || { \
25 by edam
added AVRDUDECONF variable; fixed some OS X issues; added SERIALDEV guess warning and invalid BOARD value error
334
		echo "*GUESSING* at serial device:" $(SERIALDEV); \
335
		echo; }
66 by edam
fixed resetting Leonardos before upload
336
ifeq "$(BOARD_BOOTLOADER_PATH)" "caterina"
337
	stty $(STTYFARG) $(SERIALDEV) speed 1200
338
	sleep 1
77 by Tim Marston
prevent unnecessary hupcl when uploading to the caterina bootloader
339
else
340
	stty $(STTYFARG) $(SERIALDEV) hupcl
66 by edam
fixed resetting Leonardos before upload
341
endif
2 by edam
fixed build (missing library), tested upload, and made the .elf file an intermediate file (the .hex file is now the target)
342
	$(AVRDUDE) $(AVRDUDEFLAGS) -U flash:w:$(TARGET).hex:i
1 by edam
initial commit
343
344
clean:
345
	rm -f $(OBJECTS)
346
	rm -f $(TARGET).elf $(TARGET).hex $(ARDUINOLIB) *~
36 by edam
added dependency generation to project files
347
	rm -rf .lib .dep
1 by edam
initial commit
348
5 by edam
updated comments; added checks for missing or misconfigured variables; use a default TARGET; attempt to autodetect SERIALDEV; added 'boards' goal; fixed use of 'util' project subdirectory.
349
boards:
69 by edam
added support for burning bootloaders
350
	@echo "Available values for BOARD:"
351
	@sed -nEe '/^#/d; /^[^.]+\.name=/p' $(BOARDSFILE) | \
41 by edam
updated boards goal to work on OS X (explicitly use extended REs)
352
		sed -Ee 's/([^.]+)\.name=(.*)/\1            \2/' \
353
			-e 's/(.{12}) *(.*)/\1 \2/'
5 by edam
updated comments; added checks for missing or misconfigured variables; use a default TARGET; attempt to autodetect SERIALDEV; added 'boards' goal; fixed use of 'util' project subdirectory.
354
9 by edam
added "monitor" goal; documented boards and monitor goals
355
monitor:
13 by edam
announce that we're uploading and error on SERIALDEV blank
356
	@test -n "$(SERIALDEV)" || { \
357
		echo "error: SERIALDEV could not be determined automatically." >&2; \
358
		exit 1; }
16 by edam
spellcheck, and added check for missing GNU screen
359
	@test -n `which screen` || { \
360
		echo "error: can't find GNU screen, you might need to install it." >&2 \
63 by edam
documented AVRDUDEFLAGS, CPPFLAGS, LINKFLAGS and LINBRARYPATH, cleaned up a
361
		exit 1; }
27 by edam
fixed test not returning 0
362
	@test 0 -eq $(SERIALDEVGUESS) || { \
25 by edam
added AVRDUDECONF variable; fixed some OS X issues; added SERIALDEV guess warning and invalid BOARD value error
363
		echo "*GUESSING* at serial device:" $(SERIALDEV); \
364
		echo; }
9 by edam
added "monitor" goal; documented boards and monitor goals
365
	screen $(SERIALDEV)
366
34 by Tim Marston
added 'size' goal
367
size: $(TARGET).elf
368
	echo && $(AVRSIZE) --format=avr --mcu=$(BOARD_BUILD_MCU) $(TARGET).elf
369
69 by edam
added support for burning bootloaders
370
bootloader:
371
	@echo "Burning bootloader to board..."
372
	@test -n "$(SERIALDEV)" || { \
373
		echo "error: SERIALDEV could not be determined automatically." >&2; \
374
		exit 1; }
375
	@test 0 -eq $(SERIALDEVGUESS) || { \
376
		echo "*GUESSING* at serial device:" $(SERIALDEV); \
377
		echo; }
378
	stty $(STTYFARG) $(SERIALDEV) hupcl
379
	$(AVRDUDE) $(AVRDUDEFLAGS) -U lock:w:$(BOARD_BOOTLOADER_UNLOCK):m
70 by edam
bootloader may not be specified in boards.txt
380
	$(AVRDUDE) $(AVRDUDEFLAGS) -eU lfuse:w:$(BOARD_BOOTLOADER_LFUSES):m
381
	$(AVRDUDE) $(AVRDUDEFLAGS) -U hfuse:w:$(BOARD_BOOTLOADER_HFUSES):m
382
ifneq "$(BOARD_BOOTLOADER_EFUSES)" ""
383
	$(AVRDUDE) $(AVRDUDEFLAGS) -U efuse:w:$(BOARD_BOOTLOADER_EFUSES):m
384
endif
385
ifneq "$(BOOTLOADERHEX)" ""
69 by edam
added support for burning bootloaders
386
	$(AVRDUDE) $(AVRDUDEFLAGS) -U flash:w:$(BOOTLOADERHEX):i
70 by edam
bootloader may not be specified in boards.txt
387
endif
69 by edam
added support for burning bootloaders
388
	$(AVRDUDE) $(AVRDUDEFLAGS) -U lock:w:$(BOARD_BOOTLOADER_LOCK):m
389
1 by edam
initial commit
390
# building the target
391
2 by edam
fixed build (missing library), tested upload, and made the .elf file an intermediate file (the .hex file is now the target)
392
$(TARGET).hex: $(TARGET).elf
393
	$(OBJCOPY) -O ihex -R .eeprom $< $@
394
395
.INTERMEDIATE: $(TARGET).elf
396
1 by edam
initial commit
397
$(TARGET).elf: $(ARDUINOLIB) $(OBJECTS)
48 by edam
use a more sensible command-line oprdering when linking
398
	$(CC) $(LINKFLAGS) $(OBJECTS) $(ARDUINOLIB) -lm -o $@
1 by edam
initial commit
399
36 by edam
added dependency generation to project files
400
%.o: %.c
401
	mkdir -p .dep/$(dir $<)
402
	$(COMPILE.c) $(CPPDEPFLAGS) -o $@ $<
403
404
%.o: %.cpp
405
	mkdir -p .dep/$(dir $<)
406
	$(COMPILE.cpp) $(CPPDEPFLAGS) -o $@ $<
407
408
%.o: %.cc
409
	mkdir -p .dep/$(dir $<)
410
	$(COMPILE.cpp) $(CPPDEPFLAGS) -o $@ $<
411
412
%.o: %.C
413
	mkdir -p .dep/$(dir $<)
414
	$(COMPILE.cpp) $(CPPDEPFLAGS) -o $@ $<
35 by edam
build arduino static lib in .lib using full pathnames in object files (so files of the same name but in different locations can co-exist)
415
1 by edam
initial commit
416
%.o: %.ino
36 by edam
added dependency generation to project files
417
	mkdir -p .dep/$(dir $<)
418
	$(COMPILE.cpp) $(CPPDEPFLAGS) -o $@ $(CPPINOFLAGS) $<
1 by edam
initial commit
419
420
%.o: %.pde
36 by edam
added dependency generation to project files
421
	mkdir -p .dep/$(dir $<)
62 by edam
added support for third party libraries and fixed support for .C c++ files
422
	$(COMPILE.cpp) $(CPPDEPFLAGS) -o $@ $(CPPINOFLAGS) $<
1 by edam
initial commit
423
424
# building the arduino library
425
4 by edam
added included-library autodetection and updated comments
426
$(ARDUINOLIB): $(ARDUINOLIBOBJS)
1 by edam
initial commit
427
	$(AR) rcs $@ $?
35 by edam
build arduino static lib in .lib using full pathnames in object files (so files of the same name but in different locations can co-exist)
428
429
.lib/%.c.o: %.c
430
	mkdir -p $(dir $@)
431
	$(COMPILE.c) -o $@ $<
432
433
.lib/%.cpp.o: %.cpp
434
	mkdir -p $(dir $@)
435
	$(COMPILE.cpp) -o $@ $<
436
437
.lib/%.cc.o: %.cc
438
	mkdir -p $(dir $@)
439
	$(COMPILE.cpp) -o $@ $<
440
441
.lib/%.C.o: %.C
442
	mkdir -p $(dir $@)
14 by Dan
search for software in ARDUINODIR; include library/*/utility code in core lib
443
	$(COMPILE.cpp) -o $@ $<
74 by Tim Marston
added emacs formatting variables and updated TODO
444
445
# Local Variables:
446
# mode: makefile
447
# tab-width: 4
448
# End: