For Arduino 1.5.X: Create a folder named Cosa in your Sketchbook hardware folder. Create the hardware folder if missing. Unzip in your Sketchbook hardware/Cosa folder. Your should have the path; Sketchbook/hardware/Cosa/Cosa. Rename the inner Cosa to avr; Sketchbook/hardware/Cosa/avr.
The Cosa core contains support for most Arduino boards plus Mighty and Tiny processors. All boards with ATmega328P, ATmega32U4, ATmega1264 and ATmega2560 are supported. No extra cores need to be installed. The source code for Cosa will support all of these targets and allow your project to be moved seamless between them. Please see the Tools>Board menu. You must select a Cosa prefixed board to compile Cosa sketches.
If you intend to compile sketches for ATtiny please install the following patch to AVR GCC (for Arduino Windows): https://github.com/TCWORLD/ATTinyCore/tree/master/PCREL%20Patch%20for%20GCC. Also please remember to program the device with the bootloader (i.e. set the correct fuse). For more details see the High-Low Tech Tutorial.
Please clone instead if you intend to follow this project more closely and do frequent updates.
The Application Programmers Interface (API) documentation is available on-line and for download as doc.zip. Uncompress this file and navigate your browser to the index file. The documentation contains a full hyperlinked description of all classes, methods and functions in Cosa together with UML graphs of the class hierarchy, include dependencies, and much more. Uncompressing will take some time as the documentation is over 50 Mbyte.
Fig. 3: Cosa documentation (doxygen)
The provided documentation is generated with doxygen and may also be generated for users source code if the Cosa documentation style is adapted. See the Doxyfile for configuration of doxygen.
Cosa is a project with rapid development and frequent updates. Please follow the project by updating your installation. Report bugs and propose improvements on GitHub. Use the New Issue button. Additional Blackduck based information about the project is available on Ohloh. Support this project by adding your interest to github and Ohloh.
Additional information about installing Cosa may be found on github.
The easiest way to install Cosa is to use the new Arduino IDE Boards Manager. First add the URL (https://raw.githubusercontent.com/mikaelpatel/Cosa/master/package_cosa_index.json) to the package information to the Arduino IDE Preferences (File>Preferences:Additional Boards Manager URLs:). Second select Cosa in the Boards Manager (Tools>Board:"">Boards Manager...). This will handle both download and install of the latest Cosa release.