/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
#_______________________________________________________________________________
78 by Tim Marston
bump version no. to 0.5
5
#                                                                    version 0.5
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
201
readboardsparam = $(shell sed -ne "s/$(BOARD).$(1)=\(.*\)/\1/p" $(BOARDSFILE))
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)
205
BOARD_UPLOAD_SPEED := $(call readboardsparam,upload.speed)
206
BOARD_UPLOAD_PROTOCOL := $(call readboardsparam,upload.protocol)
207
BOARD_USB_VID := $(call readboardsparam,build.vid)
208
BOARD_USB_PID := $(call readboardsparam,build.pid)
209
BOARD_BOOTLOADER_UNLOCK := $(call readboardsparam,bootloader.unlock_bits)
210
BOARD_BOOTLOADER_LOCK := $(call readboardsparam,bootloader.lock_bits)
211
BOARD_BOOTLOADER_LFUSES := $(call readboardsparam,bootloader.low_fuses)
212
BOARD_BOOTLOADER_HFUSES := $(call readboardsparam,bootloader.high_fuses)
213
BOARD_BOOTLOADER_EFUSES := $(call readboardsparam,bootloader.extended_fuses)
214
BOARD_BOOTLOADER_PATH := $(call readboardsparam,bootloader.path)
215
BOARD_BOOTLOADER_FILE := $(call readboardsparam,bootloader.file)
216
217
# obtain preferences from the IDE's preferences.txt
73 by Tim Marston
fixed default ARDUINODIR and PREFERENCESFILE locations for Macs
218
PREFERENCESFILE := $(firstword $(wildcard \
219
	$(HOME)/.arduino/preferences.txt $(HOME)/Library/Arduino/preferences.txt))
69 by edam
added support for burning bootloaders
220
ifneq "$(PREFERENCESFILE)" ""
221
readpreferencesparam = $(shell sed -ne "s/$(1)=\(.*\)/\1/p" $(PREFERENCESFILE))
222
SKETCHBOOKDIR := $(call readpreferencesparam,sketchbook.path)
223
endif
224
225
# invalid board?
226
ifeq "$(BOARD_BUILD_MCU)" ""
227
ifneq "$(MAKECMDGOALS)" "boards"
228
ifneq "$(MAKECMDGOALS)" "clean"
229
$(error BOARD is invalid.  Type 'make boards' to see possible values)
230
endif
231
endif
232
endif
233
1 by edam
initial commit
234
# auto mode?
235
INOFILE := $(wildcard *.ino *.pde)
236
ifdef INOFILE
25 by edam
added AVRDUDECONF variable; fixed some OS X issues; added SERIALDEV guess warning and invalid BOARD value error
237
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.
238
$(error There is more than one .pde or .ino file in this directory!)
1 by edam
initial commit
239
endif
23 by edam
added ARDUINOCONST, AVRTOOLSPATH, detection of avrdude.conf and cleaned up make variable types
240
241
# automatically determine sources and targeet
1 by edam
initial commit
242
TARGET := $(basename $(INOFILE))
243
SOURCES := $(INOFILE) \
62 by edam
added support for third party libraries and fixed support for .C c++ files
244
	$(wildcard *.c *.cc *.cpp *.C) \
245
	$(wildcard $(addprefix util/, *.c *.cc *.cpp *.C)) \
246
	$(wildcard $(addprefix utility/, *.c *.cc *.cpp *.C))
23 by edam
added ARDUINOCONST, AVRTOOLSPATH, detection of avrdude.conf and cleaned up make variable types
247
4 by edam
added included-library autodetection and updated comments
248
# automatically determine included libraries
63 by edam
documented AVRDUDEFLAGS, CPPFLAGS, LINKFLAGS and LINBRARYPATH, cleaned up a
249
LIBRARIES := $(filter $(notdir $(wildcard $(addsuffix /*, $(LIBRARYPATH)))), \
4 by edam
added included-library autodetection and updated comments
250
	$(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
251
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.
252
endif
253
23 by edam
added ARDUINOCONST, AVRTOOLSPATH, detection of avrdude.conf and cleaned up make variable types
254
# software
255
findsoftware = $(firstword $(wildcard $(addsuffix /$(1), $(AVRTOOLSPATH))))
256
CC := $(call findsoftware,avr-gcc)
257
CXX := $(call findsoftware,avr-g++)
258
LD := $(call findsoftware,avr-ld)
259
AR := $(call findsoftware,avr-ar)
260
OBJCOPY := $(call findsoftware,avr-objcopy)
261
AVRDUDE := $(call findsoftware,avrdude)
34 by Tim Marston
added 'size' goal
262
AVRSIZE := $(call findsoftware,avr-size)
23 by edam
added ARDUINOCONST, AVRTOOLSPATH, detection of avrdude.conf and cleaned up make variable types
263
63 by edam
documented AVRDUDEFLAGS, CPPFLAGS, LINKFLAGS and LINBRARYPATH, cleaned up a
264
# directories
265
ARDUINOCOREDIR := $(ARDUINODIR)/hardware/arduino/cores/arduino
266
LIBRARYDIRS := $(foreach lib, $(LIBRARIES), \
267
	$(firstword $(wildcard $(addsuffix /$(lib), $(LIBRARYPATH)))))
268
LIBRARYDIRS += $(addsuffix /utility, $(LIBRARYDIRS))
269
1 by edam
initial commit
270
# files
25 by edam
added AVRDUDECONF variable; fixed some OS X issues; added SERIALDEV guess warning and invalid BOARD value error
271
TARGET := $(if $(TARGET),$(TARGET),a.out)
1 by edam
initial commit
272
OBJECTS := $(addsuffix .o, $(basename $(SOURCES)))
36 by edam
added dependency generation to project files
273
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)
274
ARDUINOLIB := .lib/arduino.a
63 by edam
documented AVRDUDEFLAGS, CPPFLAGS, LINKFLAGS and LINBRARYPATH, cleaned up a
275
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)
276
	$(patsubst %, .lib/%.o, $(wildcard $(addprefix $(dir)/, *.c *.cpp))))
70 by edam
bootloader may not be specified in boards.txt
277
BOOTLOADERHEX := $(addprefix \
278
	$(ARDUINODIR)/hardware/arduino/bootloaders/$(BOARD_BOOTLOADER_PATH)/, \
279
	$(BOARD_BOOTLOADER_FILE))
62 by edam
added support for third party libraries and fixed support for .C c++ files
280
281
# avrdude confifuration
25 by edam
added AVRDUDECONF variable; fixed some OS X issues; added SERIALDEV guess warning and invalid BOARD value error
282
ifeq "$(AVRDUDECONF)" ""
283
ifeq "$(AVRDUDE)" "$(ARDUINODIR)/hardware/tools/avr/bin/avrdude"
284
AVRDUDECONF := $(ARDUINODIR)/hardware/tools/avr/etc/avrdude.conf
285
else
23 by edam
added ARDUINOCONST, AVRTOOLSPATH, detection of avrdude.conf and cleaned up make variable types
286
AVRDUDECONF := $(wildcard $(AVRDUDE).conf)
25 by edam
added AVRDUDECONF variable; fixed some OS X issues; added SERIALDEV guess warning and invalid BOARD value error
287
endif
288
endif
289
1 by edam
initial commit
290
# flags
61 by Tim Marston
make it possible to add to CPPFLAGS, AVRDUDEFLAGS and LINKFLAGS
291
CPPFLAGS += -Os -Wall -fno-exceptions -ffunction-sections -fdata-sections
36 by edam
added dependency generation to project files
292
CPPFLAGS += -funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums
293
CPPFLAGS += -mmcu=$(BOARD_BUILD_MCU)
294
CPPFLAGS += -DF_CPU=$(BOARD_BUILD_FCPU) -DARDUINO=$(ARDUINOCONST)
49 by edam
added support for the Leonardo
295
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
296
CPPFLAGS += -I. -Iutil -Iutility -I $(ARDUINOCOREDIR)
297
CPPFLAGS += -I $(ARDUINODIR)/hardware/arduino/variants/$(BOARD_BUILD_VARIANT)/
63 by edam
documented AVRDUDEFLAGS, CPPFLAGS, LINKFLAGS and LINBRARYPATH, cleaned up a
298
CPPFLAGS += $(addprefix -I , $(LIBRARYDIRS))
36 by edam
added dependency generation to project files
299
CPPDEPFLAGS = -MMD -MP -MF .dep/$<.dep
300
CPPINOFLAGS := -x c++ -include $(ARDUINOCOREDIR)/Arduino.h
61 by Tim Marston
make it possible to add to CPPFLAGS, AVRDUDEFLAGS and LINKFLAGS
301
AVRDUDEFLAGS += $(addprefix -C , $(AVRDUDECONF)) -DV
1 by edam
initial commit
302
AVRDUDEFLAGS += -p $(BOARD_BUILD_MCU) -P $(SERIALDEV)
303
AVRDUDEFLAGS += -c $(BOARD_UPLOAD_PROTOCOL) -b $(BOARD_UPLOAD_SPEED)
61 by Tim Marston
make it possible to add to CPPFLAGS, AVRDUDEFLAGS and LINKFLAGS
304
LINKFLAGS += -Os -Wl,--gc-sections -mmcu=$(BOARD_BUILD_MCU)
1 by edam
initial commit
305
43 by edam
fixed check for stty switch, so that it works with busybox
306
# figure out which arg to use with stty (for OS X, GNU and busybox stty)
307
STTYFARG := $(shell stty --help 2>&1 | \
308
	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
309
36 by edam
added dependency generation to project files
310
# include dependencies
311
ifneq "$(MAKECMDGOALS)" "clean"
312
-include $(DEPFILES)
313
endif
314
1 by edam
initial commit
315
# default rule
316
.DEFAULT_GOAL := all
317
318
#_______________________________________________________________________________
319
#                                                                          RULES
320
69 by edam
added support for burning bootloaders
321
.PHONY:	all target upload clean boards monitor size bootloader
1 by edam
initial commit
322
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)
323
all: target
1 by edam
initial commit
324
2 by edam
fixed build (missing library), tested upload, and made the .elf file an intermediate file (the .hex file is now the target)
325
target: $(TARGET).hex
1 by edam
initial commit
326
40 by Tim Marston
upload now depends on target (added dev to version no.)
327
upload: target
13 by edam
announce that we're uploading and error on SERIALDEV blank
328
	@echo "\nUploading to board..."
329
	@test -n "$(SERIALDEV)" || { \
330
		echo "error: SERIALDEV could not be determined automatically." >&2; \
331
		exit 1; }
27 by edam
fixed test not returning 0
332
	@test 0 -eq $(SERIALDEVGUESS) || { \
25 by edam
added AVRDUDECONF variable; fixed some OS X issues; added SERIALDEV guess warning and invalid BOARD value error
333
		echo "*GUESSING* at serial device:" $(SERIALDEV); \
334
		echo; }
66 by edam
fixed resetting Leonardos before upload
335
ifeq "$(BOARD_BOOTLOADER_PATH)" "caterina"
336
	stty $(STTYFARG) $(SERIALDEV) speed 1200
337
	sleep 1
77 by Tim Marston
prevent unnecessary hupcl when uploading to the caterina bootloader
338
else
339
	stty $(STTYFARG) $(SERIALDEV) hupcl
66 by edam
fixed resetting Leonardos before upload
340
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)
341
	$(AVRDUDE) $(AVRDUDEFLAGS) -U flash:w:$(TARGET).hex:i
1 by edam
initial commit
342
343
clean:
344
	rm -f $(OBJECTS)
345
	rm -f $(TARGET).elf $(TARGET).hex $(ARDUINOLIB) *~
36 by edam
added dependency generation to project files
346
	rm -rf .lib .dep
1 by edam
initial commit
347
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.
348
boards:
69 by edam
added support for burning bootloaders
349
	@echo "Available values for BOARD:"
350
	@sed -nEe '/^#/d; /^[^.]+\.name=/p' $(BOARDSFILE) | \
41 by edam
updated boards goal to work on OS X (explicitly use extended REs)
351
		sed -Ee 's/([^.]+)\.name=(.*)/\1            \2/' \
352
			-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.
353
9 by edam
added "monitor" goal; documented boards and monitor goals
354
monitor:
13 by edam
announce that we're uploading and error on SERIALDEV blank
355
	@test -n "$(SERIALDEV)" || { \
356
		echo "error: SERIALDEV could not be determined automatically." >&2; \
357
		exit 1; }
16 by edam
spellcheck, and added check for missing GNU screen
358
	@test -n `which screen` || { \
359
		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
360
		exit 1; }
27 by edam
fixed test not returning 0
361
	@test 0 -eq $(SERIALDEVGUESS) || { \
25 by edam
added AVRDUDECONF variable; fixed some OS X issues; added SERIALDEV guess warning and invalid BOARD value error
362
		echo "*GUESSING* at serial device:" $(SERIALDEV); \
363
		echo; }
9 by edam
added "monitor" goal; documented boards and monitor goals
364
	screen $(SERIALDEV)
365
34 by Tim Marston
added 'size' goal
366
size: $(TARGET).elf
367
	echo && $(AVRSIZE) --format=avr --mcu=$(BOARD_BUILD_MCU) $(TARGET).elf
368
69 by edam
added support for burning bootloaders
369
bootloader:
370
	@echo "Burning bootloader to board..."
371
	@test -n "$(SERIALDEV)" || { \
372
		echo "error: SERIALDEV could not be determined automatically." >&2; \
373
		exit 1; }
374
	@test 0 -eq $(SERIALDEVGUESS) || { \
375
		echo "*GUESSING* at serial device:" $(SERIALDEV); \
376
		echo; }
377
	stty $(STTYFARG) $(SERIALDEV) hupcl
378
	$(AVRDUDE) $(AVRDUDEFLAGS) -U lock:w:$(BOARD_BOOTLOADER_UNLOCK):m
70 by edam
bootloader may not be specified in boards.txt
379
	$(AVRDUDE) $(AVRDUDEFLAGS) -eU lfuse:w:$(BOARD_BOOTLOADER_LFUSES):m
380
	$(AVRDUDE) $(AVRDUDEFLAGS) -U hfuse:w:$(BOARD_BOOTLOADER_HFUSES):m
381
ifneq "$(BOARD_BOOTLOADER_EFUSES)" ""
382
	$(AVRDUDE) $(AVRDUDEFLAGS) -U efuse:w:$(BOARD_BOOTLOADER_EFUSES):m
383
endif
384
ifneq "$(BOOTLOADERHEX)" ""
69 by edam
added support for burning bootloaders
385
	$(AVRDUDE) $(AVRDUDEFLAGS) -U flash:w:$(BOOTLOADERHEX):i
70 by edam
bootloader may not be specified in boards.txt
386
endif
69 by edam
added support for burning bootloaders
387
	$(AVRDUDE) $(AVRDUDEFLAGS) -U lock:w:$(BOARD_BOOTLOADER_LOCK):m
388
1 by edam
initial commit
389
# building the target
390
2 by edam
fixed build (missing library), tested upload, and made the .elf file an intermediate file (the .hex file is now the target)
391
$(TARGET).hex: $(TARGET).elf
392
	$(OBJCOPY) -O ihex -R .eeprom $< $@
393
394
.INTERMEDIATE: $(TARGET).elf
395
1 by edam
initial commit
396
$(TARGET).elf: $(ARDUINOLIB) $(OBJECTS)
48 by edam
use a more sensible command-line oprdering when linking
397
	$(CC) $(LINKFLAGS) $(OBJECTS) $(ARDUINOLIB) -lm -o $@
1 by edam
initial commit
398
36 by edam
added dependency generation to project files
399
%.o: %.c
400
	mkdir -p .dep/$(dir $<)
401
	$(COMPILE.c) $(CPPDEPFLAGS) -o $@ $<
402
403
%.o: %.cpp
404
	mkdir -p .dep/$(dir $<)
405
	$(COMPILE.cpp) $(CPPDEPFLAGS) -o $@ $<
406
407
%.o: %.cc
408
	mkdir -p .dep/$(dir $<)
409
	$(COMPILE.cpp) $(CPPDEPFLAGS) -o $@ $<
410
411
%.o: %.C
412
	mkdir -p .dep/$(dir $<)
413
	$(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)
414
1 by edam
initial commit
415
%.o: %.ino
36 by edam
added dependency generation to project files
416
	mkdir -p .dep/$(dir $<)
417
	$(COMPILE.cpp) $(CPPDEPFLAGS) -o $@ $(CPPINOFLAGS) $<
1 by edam
initial commit
418
419
%.o: %.pde
36 by edam
added dependency generation to project files
420
	mkdir -p .dep/$(dir $<)
62 by edam
added support for third party libraries and fixed support for .C c++ files
421
	$(COMPILE.cpp) $(CPPDEPFLAGS) -o $@ $(CPPINOFLAGS) $<
1 by edam
initial commit
422
423
# building the arduino library
424
4 by edam
added included-library autodetection and updated comments
425
$(ARDUINOLIB): $(ARDUINOLIBOBJS)
1 by edam
initial commit
426
	$(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)
427
428
.lib/%.c.o: %.c
429
	mkdir -p $(dir $@)
430
	$(COMPILE.c) -o $@ $<
431
432
.lib/%.cpp.o: %.cpp
433
	mkdir -p $(dir $@)
434
	$(COMPILE.cpp) -o $@ $<
435
436
.lib/%.cc.o: %.cc
437
	mkdir -p $(dir $@)
438
	$(COMPILE.cpp) -o $@ $<
439
440
.lib/%.C.o: %.C
441
	mkdir -p $(dir $@)
14 by Dan
search for software in ARDUINODIR; include library/*/utility code in core lib
442
	$(COMPILE.cpp) -o $@ $<
74 by Tim Marston
added emacs formatting variables and updated TODO
443
444
# Local Variables:
445
# mode: makefile
446
# tab-width: 4
447
# End: