/make/arduino-mk

To get this branch, use:
bzr branch http://bzr.ed.am/make/arduino-mk

« back to all changes in this revision

Viewing changes to arduino.mk

  • Committer: edam
  • Date: 2012-11-30 15:13:27 UTC
  • Revision ID: tim@ed.am-20121130151327-scygxxvu0crec501
documented AVRDUDEFLAGS, CPPFLAGS, LINKFLAGS and LINBRARYPATH, cleaned up a
little bit, and fixed a tiny bug (called ecit, not exit, during an error)

Show diffs side-by-side

added added

removed removed

Lines of Context:
144
144
# monitor      Start `screen` on the serial device.  This is meant to be an
145
145
#              equivalent to the Arduino serial monitor.
146
146
#
147
 
# size         Displays size information about the built target.
148
 
#
149
 
# bootloader   Burns the bootloader for your board to it.
 
147
# size         Displays size information about the bulit target.
150
148
#
151
149
# <file>       Builds the specified file, either an object file or the target,
152
150
#              from those that that would be built for the project.
155
153
 
156
154
# default arduino software directory, check software exists
157
155
ifndef ARDUINODIR
158
 
ARDUINODIR := $(firstword $(wildcard ~/opt/arduino /usr/share/arduino \
159
 
        /Applications/Arduino.app/Contents/Resources/Java \
160
 
        $(HOME)/Applications/Arduino.app/Contents/Resources/Java))
 
156
ARDUINODIR := $(firstword $(wildcard ~/opt/arduino /usr/share/arduino))
161
157
endif
162
158
ifeq "$(wildcard $(ARDUINODIR)/hardware/arduino/boards.txt)" ""
163
159
$(error ARDUINODIR is not set correctly; arduino software not found)
167
163
ARDUINOCONST ?= 100
168
164
 
169
165
# default path for avr tools
170
 
AVRTOOLSPATH ?= $(subst :, , $(PATH)) $(ARDUINODIR)/hardware/tools \
171
 
        $(ARDUINODIR)/hardware/tools/avr/bin
 
166
ifndef AVRTOOLSPATH
 
167
AVRTOOLSPATH := $(subst :, , $(PATH))
 
168
AVRTOOLSPATH += $(ARDUINODIR)/hardware/tools
 
169
AVRTOOLSPATH += $(ARDUINODIR)/hardware/tools/avr/bin
 
170
endif
172
171
 
173
172
# default path to find libraries
174
 
LIBRARYPATH ?= libraries libs $(SKETCHBOOKDIR)/libraries $(ARDUINODIR)/libraries
175
 
 
176
 
# default serial device to a poor guess (something that might be an arduino)
177
 
SERIALDEVGUESS := 0
178
 
ifndef SERIALDEV
179
 
SERIALDEV := $(firstword $(wildcard \
180
 
        /dev/ttyACM? /dev/ttyUSB? /dev/tty.usbserial* /dev/tty.usbmodem*))
181
 
SERIALDEVGUESS := 1
182
 
endif
183
 
 
184
 
# no board?
185
 
ifndef BOARD
186
 
ifneq "$(MAKECMDGOALS)" "boards"
187
 
ifneq "$(MAKECMDGOALS)" "clean"
188
 
$(error BOARD is unset.  Type 'make boards' to see possible values)
189
 
endif
190
 
endif
191
 
endif
192
 
 
193
 
# obtain board parameters from the arduino boards.txt file
194
 
BOARDSFILE := $(ARDUINODIR)/hardware/arduino/boards.txt
195
 
readboardsparam = $(shell sed -ne "s/$(BOARD).$(1)=\(.*\)/\1/p" $(BOARDSFILE))
196
 
BOARD_BUILD_MCU := $(call readboardsparam,build.mcu)
197
 
BOARD_BUILD_FCPU := $(call readboardsparam,build.f_cpu)
198
 
BOARD_BUILD_VARIANT := $(call readboardsparam,build.variant)
199
 
BOARD_UPLOAD_SPEED := $(call readboardsparam,upload.speed)
200
 
BOARD_UPLOAD_PROTOCOL := $(call readboardsparam,upload.protocol)
201
 
BOARD_USB_VID := $(call readboardsparam,build.vid)
202
 
BOARD_USB_PID := $(call readboardsparam,build.pid)
203
 
BOARD_BOOTLOADER_UNLOCK := $(call readboardsparam,bootloader.unlock_bits)
204
 
BOARD_BOOTLOADER_LOCK := $(call readboardsparam,bootloader.lock_bits)
205
 
BOARD_BOOTLOADER_LFUSES := $(call readboardsparam,bootloader.low_fuses)
206
 
BOARD_BOOTLOADER_HFUSES := $(call readboardsparam,bootloader.high_fuses)
207
 
BOARD_BOOTLOADER_EFUSES := $(call readboardsparam,bootloader.extended_fuses)
208
 
BOARD_BOOTLOADER_PATH := $(call readboardsparam,bootloader.path)
209
 
BOARD_BOOTLOADER_FILE := $(call readboardsparam,bootloader.file)
210
 
 
211
 
# obtain preferences from the IDE's preferences.txt
212
 
PREFERENCESFILE := $(firstword $(wildcard \
213
 
        $(HOME)/.arduino/preferences.txt $(HOME)/Library/Arduino/preferences.txt))
214
 
ifneq "$(PREFERENCESFILE)" ""
215
 
readpreferencesparam = $(shell sed -ne "s/$(1)=\(.*\)/\1/p" $(PREFERENCESFILE))
216
 
SKETCHBOOKDIR := $(call readpreferencesparam,sketchbook.path)
217
 
endif
218
 
 
219
 
# invalid board?
220
 
ifeq "$(BOARD_BUILD_MCU)" ""
221
 
ifneq "$(MAKECMDGOALS)" "boards"
222
 
ifneq "$(MAKECMDGOALS)" "clean"
223
 
$(error BOARD is invalid.  Type 'make boards' to see possible values)
224
 
endif
225
 
endif
226
 
endif
 
173
LIBRARYPATH ?= libraries libs $(ARDUINODIR)/libraries
227
174
 
228
175
# auto mode?
229
176
INOFILE := $(wildcard *.ino *.pde)
245
192
 
246
193
endif
247
194
 
 
195
# no serial device? make a poor attempt to detect an arduino
 
196
SERIALDEVGUESS := 0
 
197
ifeq "$(SERIALDEV)" ""
 
198
SERIALDEV := $(firstword $(wildcard \
 
199
        /dev/ttyACM? /dev/ttyUSB? /dev/tty.usbserial* /dev/tty.usbmodem*))
 
200
SERIALDEVGUESS := 1
 
201
endif
 
202
 
248
203
# software
249
204
findsoftware = $(firstword $(wildcard $(addsuffix /$(1), $(AVRTOOLSPATH))))
250
205
CC := $(call findsoftware,avr-gcc)
268
223
ARDUINOLIB := .lib/arduino.a
269
224
ARDUINOLIBOBJS := $(foreach dir, $(ARDUINOCOREDIR) $(LIBRARYDIRS), \
270
225
        $(patsubst %, .lib/%.o, $(wildcard $(addprefix $(dir)/, *.c *.cpp))))
271
 
BOOTLOADERHEX := $(addprefix \
272
 
        $(ARDUINODIR)/hardware/arduino/bootloaders/$(BOARD_BOOTLOADER_PATH)/, \
273
 
        $(BOARD_BOOTLOADER_FILE))
274
226
 
275
227
# avrdude confifuration
276
228
ifeq "$(AVRDUDECONF)" ""
281
233
endif
282
234
endif
283
235
 
 
236
# no board?
 
237
ifndef BOARD
 
238
ifneq "$(MAKECMDGOALS)" "boards"
 
239
ifneq "$(MAKECMDGOALS)" "clean"
 
240
$(error BOARD is unset.  Type 'make boards' to see possible values)
 
241
endif
 
242
endif
 
243
endif
 
244
 
 
245
# obtain board parameters from the arduino boards.txt file
 
246
BOARDS_FILE := $(ARDUINODIR)/hardware/arduino/boards.txt
 
247
BOARD_BUILD_MCU := \
 
248
        $(shell sed -ne "s/$(BOARD).build.mcu=\(.*\)/\1/p" $(BOARDS_FILE))
 
249
BOARD_BUILD_FCPU := \
 
250
        $(shell sed -ne "s/$(BOARD).build.f_cpu=\(.*\)/\1/p" $(BOARDS_FILE))
 
251
BOARD_BUILD_VARIANT := \
 
252
        $(shell sed -ne "s/$(BOARD).build.variant=\(.*\)/\1/p" $(BOARDS_FILE))
 
253
BOARD_UPLOAD_SPEED := \
 
254
        $(shell sed -ne "s/$(BOARD).upload.speed=\(.*\)/\1/p" $(BOARDS_FILE))
 
255
BOARD_UPLOAD_PROTOCOL := \
 
256
        $(shell sed -ne "s/$(BOARD).upload.protocol=\(.*\)/\1/p" $(BOARDS_FILE))
 
257
BOARD_USB_VID := \
 
258
        $(shell sed -ne "s/$(BOARD).build.vid=\(.*\)/\1/p" $(BOARDS_FILE))
 
259
BOARD_USB_PID := \
 
260
        $(shell sed -ne "s/$(BOARD).build.pid=\(.*\)/\1/p" $(BOARDS_FILE))
 
261
 
 
262
# invalid board?
 
263
ifeq "$(BOARD_BUILD_MCU)" ""
 
264
ifneq "$(MAKECMDGOALS)" "boards"
 
265
ifneq "$(MAKECMDGOALS)" "clean"
 
266
$(error BOARD is invalid.  Type 'make boards' to see possible values)
 
267
endif
 
268
endif
 
269
endif
 
270
 
284
271
# flags
285
272
CPPFLAGS += -Os -Wall -fno-exceptions -ffunction-sections -fdata-sections
286
273
CPPFLAGS += -funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums
312
299
#_______________________________________________________________________________
313
300
#                                                                          RULES
314
301
 
315
 
.PHONY: all target upload clean boards monitor size bootloader
 
302
.PHONY: all target upload clean boards monitor size
316
303
 
317
304
all: target
318
305
 
326
313
        @test 0 -eq $(SERIALDEVGUESS) || { \
327
314
                echo "*GUESSING* at serial device:" $(SERIALDEV); \
328
315
                echo; }
329
 
ifeq "$(BOARD_BOOTLOADER_PATH)" "caterina"
330
 
        stty $(STTYFARG) $(SERIALDEV) speed 1200
331
 
        sleep 1
332
 
endif
333
316
        stty $(STTYFARG) $(SERIALDEV) hupcl
334
317
        $(AVRDUDE) $(AVRDUDEFLAGS) -U flash:w:$(TARGET).hex:i
335
318
 
339
322
        rm -rf .lib .dep
340
323
 
341
324
boards:
342
 
        @echo "Available values for BOARD:"
343
 
        @sed -nEe '/^#/d; /^[^.]+\.name=/p' $(BOARDSFILE) | \
 
325
        @echo Available values for BOARD:
 
326
        @sed -nEe '/^#/d; /^[^.]+\.name=/p' $(BOARDS_FILE) | \
344
327
                sed -Ee 's/([^.]+)\.name=(.*)/\1            \2/' \
345
328
                        -e 's/(.{12}) *(.*)/\1 \2/'
346
329
 
359
342
size: $(TARGET).elf
360
343
        echo && $(AVRSIZE) --format=avr --mcu=$(BOARD_BUILD_MCU) $(TARGET).elf
361
344
 
362
 
bootloader:
363
 
        @echo "Burning bootloader to board..."
364
 
        @test -n "$(SERIALDEV)" || { \
365
 
                echo "error: SERIALDEV could not be determined automatically." >&2; \
366
 
                exit 1; }
367
 
        @test 0 -eq $(SERIALDEVGUESS) || { \
368
 
                echo "*GUESSING* at serial device:" $(SERIALDEV); \
369
 
                echo; }
370
 
        stty $(STTYFARG) $(SERIALDEV) hupcl
371
 
        $(AVRDUDE) $(AVRDUDEFLAGS) -U lock:w:$(BOARD_BOOTLOADER_UNLOCK):m
372
 
        $(AVRDUDE) $(AVRDUDEFLAGS) -eU lfuse:w:$(BOARD_BOOTLOADER_LFUSES):m
373
 
        $(AVRDUDE) $(AVRDUDEFLAGS) -U hfuse:w:$(BOARD_BOOTLOADER_HFUSES):m
374
 
ifneq "$(BOARD_BOOTLOADER_EFUSES)" ""
375
 
        $(AVRDUDE) $(AVRDUDEFLAGS) -U efuse:w:$(BOARD_BOOTLOADER_EFUSES):m
376
 
endif
377
 
ifneq "$(BOOTLOADERHEX)" ""
378
 
        $(AVRDUDE) $(AVRDUDEFLAGS) -U flash:w:$(BOOTLOADERHEX):i
379
 
endif
380
 
        $(AVRDUDE) $(AVRDUDEFLAGS) -U lock:w:$(BOARD_BOOTLOADER_LOCK):m
381
 
 
382
345
# building the target
383
346
 
384
347
$(TARGET).hex: $(TARGET).elf
433
396
.lib/%.C.o: %.C
434
397
        mkdir -p $(dir $@)
435
398
        $(COMPILE.cpp) -o $@ $<
436
 
 
437
 
# Local Variables:
438
 
# mode: makefile
439
 
# tab-width: 4
440
 
# End: