|Peter J. Jones 5385f7cc10 Merge commit 'd3b08b44f0d74fd2cbb5f488f6cb9ad2fb352db8' as 'vendor/arduino-makefile'||5 年前|
This is a very simple Makefile which knows how to build Arduino sketches. It defines entire workflows for compiling code, flashing it to Arduino and even communicating through Serial monitor. You don’t need to change anything in the Arduino sketches.
*.pdesketches as well as raw
*.hfiles lead to recompilation of sources which include them
If you’re using FreeBSD, Debian or Ubuntu, you can find this in the
package which can be installed using
git clone email@example.com:sudar/Arduino-Makefile.git
You need to have the Arduino IDE. You can either install it through the installer or download the distribution zip file and extract it.
The Makefile also delegates resetting the board to a short Python program.
You’ll need to install
pySerial to use it though.
On Debian or Ubuntu:
apt-get install python-serial
yum install pyserial
zypper install python-serial
On Mac using MacPorts:
sudo port install py27-serial
You need to install Cygwin and its packages for Make, Perl and the following Serial library.
pySerial can be downloaded from PyPi
On other systems:
pip install pyserial or easy_install -U pyserial
You can also find more detailed instructions in this guide.
You can also checkout the sample makefiles inside the
examples/ directory, e.g. Makefile-example.
Download a copy of this repo some where in your system or install it through a package.
On the Mac you might want to set:
ARDUINO_DIR = /Applications/Arduino.app/Contents/Resources/Java ARDMK_DIR = /usr/local AVR_TOOLS_DIR = /usr MONITOR_PORT = /dev/ttyACM0 BOARD_TAG = mega2560
On Linux (if you have installed through package), you shouldn’t need to set anything other than your board type and port:
BOARD_TAG = mega2560 MONITOR_PORT = /dev/ttyACM0
On Windows (using cygwin), you might want to set:
ARDUINO_DIR = ../../arduino ARDMK_DIR = path/to/mkfile MONITOR_PORT = com3 BOARD_TAG = mega2560
It is recommended in Windows that you create a symbolic link to avoid problems with file naming conventions on Windows. For example, if your your Arduino directory is in:
c:\Program Files (x86)\Arduino
You will get problems with the special characters on the directory name. More details about this can be found in issue #94
To create a symbolic link, you can use the command “mklink” on Windows, e.g.
mklink /d c:\Arduino c:\Program Files (x86)\Arduino
After which, the variables should be:
ARDUINO_DIR=../../../../../Program\ Files\ \(x86\)/Arduino
BOARD_TAG- Type of board, for a list see boards.txt or
MONITOR_PORT- The port where your Arduino is plugged in, usually
/dev/ttyUSB0in Linux or Mac OS X and
com4, etc. in Windows.
ARDUINO_DIR- Path to Arduino installation. In Cygwin in Windows this path must be relative, not absolute (e.g. “../../arduino” and not “/c/cygwin/Arduino”).
ARDMK_DIR- Path where the
*.mkare present. If you installed the package, then it is usually
AVR_TOOLS_DIR- Path where the avr tools chain binaries are present. If you are going to use the binaries that came with Arduino installation, then you don’t have to set it. Otherwise set it realtive and not absolute.
The list of all variables that can be overridden is available at arduino-mk-vars.md file.
You can specify space separated list of libraries that are needed for your sketch to the variable
ARDUINO_LIBS = Wire SoftwareSerial
The libraries will be searched in the following places in the following order.
/librariesdirectory inside your sketchbook directory. Sketchbook directory will be auto detected from your Arduino preference file. You can also manually set it through
/librariesdirectory inside your Arduino directory, which is read from
The libraries inside user directories will take precedence over libraries present in Arduino core directory.
The makefile can autodetect the libraries that are included from your sketch and can include them automatically. But it can’t detect libraries that are included from other libraries. (see issue #93)
To upload compiled files,
avrdude is used. This Makefile tries to find
avrdude and it’s config (
ARDUINO_DIR. If you like to use the one installed on your system instead of the one which came with Arduino, you can try to set the variables
AVRDUDE_CONF. On a typical Linux system these could be set to
AVRDDUDE = /usr/bin/avrdude AVRDUDE_CONF = /etc/avrdude.conf
On-the-fly syntax checking in Emacs using the Flymake minor mode is now possible.
First, the flymake mode must be configured to recognize ino files :
Edit the flymake configuration :
M-x customize-option RET flymake-allowed-file-name-masks RET
Add the line :
Then click on “Apply and Save” button
Then, the following line must be added to the project Makefile :
check-syntax: $(CXX_NAME) -c -include Arduino.h -x c++ $(CXXFLAGS) $(CPPFLAGS) -fsyntax-only $(CHK_SOURCES)
The current version of the makefile is
1.3.4. You can find the full history in the HISTORY.md file
This project adheres to Semantic Versioning 2.0.
This makefile and the related documentation and examples are free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.
All contributions (even documentation) are welcome :) Open a pull request and I would be happy to merge them. Also checkout the contribution guide for more details.
If you are looking for ideas to work on, then check out the following TODO items or the issue tracker.
If you find an issue or have an idea for a feature then log them in the issue tracker