NAME

duino - Command-line tool for working with Arduino

VERSION

version 0.05

SYNOPSIS

duino COMMAND [OPTIONS]

List the supported Arduino models:

$ duino models

Build a sketch:

$ duino build --board uno

Upload the sketch to the Arduino:

$ duino upload --board uno --port /dev/ttyACM0

Build and upload a given sketch file:

$ duino build --board uno some_sketch.ino
$ duino upload --board uno --port /dev/ttyACM0 some_sketch.ino

Communicate with the Arduino:

$ duino com --port /dev/ttyACM0

Clean the build directory:

$ duino clean --board uno

DESCRIPTION

duino is a simple command-line tool that simplifies working with Arduino boards: it can build and upload sketches to a variety of models and has a built-in minimal serial teminal for communicating with the boards.

To work it needs the Arduino software environment that can be found on the Arduino website, or in most package repositories (e.g. the arduino-core package on Debian/Ubuntu).

OPTIONS

--board, -b

The Arduino board model. The environment variable ARDUINO_BOARD will be used if present and if the command-line option is not set. If neither of them is set the default value (uno) will be used.

--port, -p

The path to the Arduino serial port. The environment variable ARDUINO_PORT will be used if present and if the command-line option is not set. If neither of them is set the default value (/dev/ttyACM0) will be used.

--sketchbook, -s

The path to the user's sketchbook directory. The environment variable ARDUINO_SKETCHBOOK will be used if present and if the command-line option is not set. If neither of them is set the default value ($HOME/sketchbook) will be used.

--dir, -d

The path to the Arduino installation directory. The environment variable ARDUINO_DIR will be used if present and if the command-line option is not set. If neither of them is set the default value (/usr/share/arduino) will be used.

--libs, -l

List of space-separated, non-core Arduino libraries to build. The environment variable ARDUINO_LIBS will be used if present and if the command-line option is not set. If neither of them is set no libraries are built.

Example:

$ duino build --libs "Wire Wire/utility SPI"

CONFIGURATION

Per-project configurations can be specified in the duino.ini file under the project directory. Valid configurations are:

board

The Arduino board model.

libs

A list of non-core libraries needed by the project.

Example:

board = leonardo
libs  = Wire Wire/utility SPI SD SD/utility

AUTHOR

Alessandro Ghedini <alexbio@cpan.org>

LICENSE AND COPYRIGHT

Copyright 2013 Alessandro Ghedini.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.