Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/amperka/ino

Command line toolkit for working with Arduino hardware
https://github.com/amperka/ino

Last synced: about 1 month ago
JSON representation

Command line toolkit for working with Arduino hardware

Awesome Lists containing this project

README 

        
===

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: '' 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 fixes