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
- 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.
- Run
ino --help
. - Post issues to GitHub.
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.
- Jared Boone.
- Lars Englund.
- Alberto Ruiz.
- 12qu.
- Michael Sproul.
- Marc Plano-Lesay.
- Fabian Kreiser.
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.
- Fix #16:
- 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
- Support for
- 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 fixes