© Copyright The University of New South Wales 2018
http://www.crl.unsw.edu.au/projects/interaction-interface-for-creative-robotics

CR Package Readme File.


Install Max Package Instructions:
---------------------------------
There are two ways you can install the cr package onto Max, either via the Max 
Package Manager (preferred), or manually download and install the files.

A. Max Package Manager

1. Access the Package Manager by selecting “Show Package Manager” in the File menu. 
2. In the Package Manager window click on the cr Package to inspect its details.
3. To install the Package, click the green Install button.

    For more information on how to use the package manager, please consult the Max Documentation.


B. Manual installation

1. Download the cr package from http://www.crl.unsw.edu.au/projects/interaction-interface-for-creative-robotics
2. Once the cr package is downloaded, unzip it in any location (prefered: /Documents/Max 7/Packages).
3. Open Max (or Restart Max).
4. By default, Max uploads all packages placed in /Documents/Max 7/Packages. 
    If you decide to place your package in any location other than the default, then you need to add this location to your Max search path:
    Im Max, Open file browser window: File -> show file browser.
    In the file browser window, Press the + button (at the bottom left corner) ->add files to search path -> locate and select the cr folder you unzipped.
    (Note: this step is not necessary if you've placed your package under /Documents/Max 7/Packages)



Board Preparations:
-------------------
1. Open Arduino.
2. Open Sketch File -> Examples -> Firmata -> StandardFirmata.
3. Upload the Sketch to Your UNO Board*. Make sure no errors in the console (Arduino window).

* You may need to set the board and port first: 
Tools -> Board -> Arduino/Genuino Uno
Tools -> Port -> (choose the correct port that is connected to your Arduino board)

Done.



Usage Instructions:
-------------------
1. Try first the overview patcher: overview.maxpat .
2. Try the example patchers under /extras/cr. They have comments to help you understand how to use the new objects in the cr package.
3. Try the demo patchers under /extras/cr. They demonstrate how to use some of the actuators and sensors, and include circuite images to help you get started.  
4. Help pages, Reference pages and Example Patchers are available in the cr package to help you getting started. 


