A command line tool for compiling Arduino sketches
This tool is able to parse Arduino Hardware specifications, properly run
gcc and produce compiled sketches.
An Arduino sketch differs from a standard C program in that it misses a
main (provided by the Arduino core), function prototypes are not mandatory, and libraries inclusion is automagic (you just have to
This tool generates function prototypes and gathers library paths, providing
gcc with all the needed
-preprocess: Optional. If omitted, defaults to
-dump-prefswill just print all build preferences used,
-compilewill use those preferences to run the actual compiler,
-preprocesswill only print preprocessed code to stdout.
-hardware: Mandatory. Folder containing Arduino platforms. An example is the
hardwarefolder shipped with the Arduino IDE, or the
packagesfolder created by Arduino Boards Manager. Can be specified multiple times. If conflicting hardware definitions are specified, the last one wins.
-tools: Mandatory. Folder containing Arduino tools (
avrdude...). An example is the
hardware/toolsfolder shipped with the Arduino IDE, or the
packagesfolder created by Arduino Boards Manager. Can be specified multiple times.
-libraries: Optional. Folder containing Arduino libraries. An example is the
librariesfolder shipped with the Arduino IDE. Can be specified multiple times.
-fqbn: Mandatory. Fully Qualified Board Name, e.g.: arduino:avr:uno
-build-path: Optional. Folder where to save compiled files. If omitted, a folder will be created in the temporary folder specified by your OS.
-prefs=key=value: Optional. It allows to override some build properties.
-warnings: Optional, can be "none", "default", "more" and "all". Defaults to "none". Used to tell
gccwhich warning level to use (
-verbose: Optional, turns on verbose mode.
-quiet: Optional, supresses almost every output.
-debug-level: Optional, defaults to "5". Used for debugging. Set it to 10 when submitting an issue.
-ide-version: Optional, defaults to "10600". The version of the Arduino IDE which is using this tool.
-logger: Optional, can be "human" or "machine". Defaults to "human". If "machine", messages emitted will be in a format which the Arduino IDE understands and that it uses for I18N.
-lib-discovery-recursion-depth: Optional. Defaults to 4. How deep should library discovery go down looking for included libraries.
-version: if specified, prints version and exits.
-build-options-file: it specifies path to a local
build.options.jsonfile (see paragraph below), which allows you to omit specifying params such as
-vid-pid: when specified, VID/PID specific build properties are used, if boards supports them.
Final mandatory parameter is the sketch to compile (of course).
What is and how to use build.options.json file
Every time you run this tool, it will create a
build.options.json file in build path. It's used to understand if build options (such as hardware folders, fqbn and so on) were changed when compiling the same sketch.
If they changed, the whole build path is wiped out. If they didn't change, previous compiled files will be reused if the corresponding source files didn't change as well.
You can save this file locally and use it instead of specifying
Using it for continuously verify your libraries or cores
Building from source
You need Go 1.4.3.
Repo root contains script
setup_go_env_vars. Use it as is or as a template for setting up Go environment variables.
Once done, run the following commands:
go get github.com/go-errors/errors go get github.com/stretchr/testify go get github.com/jstemmer/go-junit-report go get golang.org/x/codereview/patch go get golang.org/x/tools/cmd/vet go build
In order to run the tests, type:
go test -v ./src/arduino.cc/builder/test/...
In jenkins, use
go test -v ./src/arduino.cc/builder/test/... | bin/go-junit-report > report.xml
License and Copyright
arduino-builder is licensed under General Public License version 2, as published bythe Free Software Foundation. See LICENSE.txt.
Copyright (C) 2015 Arduino LLC and contributors