inoCommand line toolkit for working with Arduino hardware===
Ino
===
Ino is a command line toolkit for working with Arduino hardware
It allows you to:
* Quickly create new projects
* Build a firmware from multiple source files and libraries
* Upload the firmware to a device
* Perform serial communication with a device (aka serial monitor)
Ino may replace Arduino IDE UI if you prefer to work with command
line and an editor of your choice or if you want to integrate Arduino
build process to 3-rd party IDE.
Ino is based on ``make`` to perform builds. However Makefiles are
generated automatically and you'll never see them if you don't want to.
Features
========
* Simple. No build scripts are necessary.
* Out-of-source builds. Directories with source files are not
cluttered with intermediate object files.
* Support for ``*.ino`` and ``*.pde`` sketches as well as
raw ``*.c`` and ``*.cpp``.
* Support for Arduino Software versions 1.x as well as 0.x.
* Automatic dependency tracking. Referred libraries are automatically
included in the build process. Changes in ``*.h`` files lead
to recompilation of sources which include them.
* Pretty colorful output.
* Support for all boards that are supported by Arduino IDE.
* Fast. Discovered tool paths and other stuff is cached across runs.
If nothing has changed, nothing is build.
* Flexible. Support for simple ini-style config files to setup
machine-specific info like used Arduino model, Arduino distribution
path, etc just once.
Installation
============
From source:
* `Download latest source tarball <http://pypi.python.org/pypi/ino/#downloads>`_
* Or clone it from GitHub: ``git clone git://github.com/amperka/ino.git``
* Do ``make install`` to perform installation under ``/usr/local``
* Or see ``INSTALL`` for instructions on changing destination directory
With Python setup tools:
* Either ``pip install ino``
* Or ``easy_install ino``
Requirements
============
* Python 2.6+
* Arduino IDE distribution
* ``picocom`` for serial communication
Limitations
===========
* As for current version, ino works only in Linux and MacOS.
However it was created with other OS users in mind,
so it will eventually get full cross-platform support.
Help from Windows-developers is much appreciated.
Getting Help
============
* Take a look at `Quick start tutorial <http://inotool.org/quickstart>`_.
* Run ``ino --help``.
* Post `issues to GitHub <http://github.com/amperka/ino/issues>`_.
License
=======
If not stated otherwise ino is distributed in terms of MIT software license.
See MIT-LICENSE.txt in the distribution for details.
Contributors
============
* `David Charbonnier <https://github.com/dcharbonnier>`_.
* `Jared Boone <https://github.com/jboone>`_.
* `Lars Englund <https://github.com/larsenglund>`_.
* `Alberto Ruiz <https://github.com/aruiz>`_.
* `12qu <https://github.com/12qu>`_.
* `Michael Sproul <https://github.com/gnusouth>`_.
* `Marc Plano-Lesay <https://github.com/Kernald>`_.
* `Fabian Kreiser <https://github.com/fabiankr>`_.
Changelog
=========
0.3.6
* Fix #74, #107, #108: Use of types declared in included files is allowed
in function definitions. Previously it led to: '<enum|struct|typedef>' not
declared in this scope.
* Fix #105: Search for `avrdude.conf` in `/etc/avrdude` to be compatible with
Fedora.
* Fix #99: Check for an existing project before building or creating directories
* Fix #93, #57, #8: Custom compile and link flags can be passed as `ino build` arguments
* Fix #60, #63: Custom `make` tool command can be passed as `ino build` argument
* Fix #23, #28: `make` is searched within Arduino IDE binaries as well
* Fix #88, #103: Correct version parsing for some distributions that mangle it
* Fix #46: Taking build number into account in version string
* Fix #19, #81, #82: Custom command line arguments for `picocom` can be passed
while running `ino serial`
0.3.5
* Fix #62: Include `MIT-LICENSE.txt` in the tarball.
0.3.4
* Fix #44, #45: Building and uploading for Arduino Leonardo is fully supported.
* Fix #3, #29: Build artifacts for different board models and Arduino distributions
go in different build subdirectories, so you haven't to run ``ino clean`` and
rebuild if you switch to another Arduino model or software distribution.
* The version of avr gcc toolset that is bundled with Arduino Software is now
always preferred over system-wide. So that users with edge-versions of software
(such as Arch Linux) able to produce expected results.
0.3.3
* Fix #16: ``*.ino`` and ``*.pde`` sketches are now populated with function
prototypes while preprocessing step in the same way as it done by Arduino IDE,
so it is now possible to use functions before they're declared or defined.
0.3.2
* Fix #13: Local header #includes from sketch files are no longer lead to
'No such file or directory' error. Now GCC is given an additional include
path pointing to the sketch origin while compiling processed source.
* Fix #18: Proper scanning of dependency files when multiple library
dependencies are found on the same line. Now all of them are taken into
account, not just first one.
* Add: Processed sketch files now have #line directive so that they appear
as original source in GCC output in case of syntax errors.
* Add: Automatic dependency tracking for included header files. Now a
sketch or cpp source get rebuild once an included (directly or
indirectly) header changes.
0.3.1
* Support for ``ino build --verbose``
0.3.0
* MacOS support
* Serial port guess
0.2.0
* Support for Arduino Software version 1.0
0.1.x
* Initial release
* Various bug fixesVictor Nakoryakov, Amperka Team024bb9cf3b5e4b9a6c8afa180e87b1f1e5b7b1e20.3.6