====== CrowBox Software Configuration ======

The programmable computer brain that controls the CrowBox is the [[https://store.arduino.cc/arduino-uno-rev3|Arduino UNO microcontroller board]].

On this page we'll go through the steps required to download the source code for our CrOS software and get it uploaded to an Arduino UNO board, which can then be used to control your CrowBox. The CrOS software is fully open-source and we encourage you to make changes and improvements to the program code and the machine's training protocol.

The Arduino is an extremely popular platform for makers and experimental electronics worldwide. This means that there are a great deal of resources available to help you learn more about the Arduino hardware, the Arduino IDE software, and how to program and modify programs for these great little boards. 

If you run into trouble following the instructions on this page, there are a number of places to turn for help:

  * arduino.cc - [[https://www.arduino.cc/en/Guide/HomePage|Getting Started with Arduino]] (follow instructions for the **Arduino Desktop IDE**)
  * arduino.cc - [[https://www.arduino.cc/en/Guide/ArduinoUno|Arduino UNO Guide]]
  * The community at the [[http://groups.google.com/group/CrowBoxKit|Official CrowBox Google Group]]


====== Step One: Download and install the Arduino IDE software ======

To install the CrowBox system software onto your Arduino UNO microcontroller board, you'll need a computer, a USB A to B cable, and the Arduino IDE software installed on your computer, which is available for free download. IDE stands for //Integrated Development Environment//, but that's not an important detail right now.

Let's get started! First, follow the official instructions at the Arduino website to [[https://docs.arduino.cc/software/ide-v2/tutorials/getting-started/ide-v2-downloading-and-installing/|install the Arduino IDE software]]

====== Step Two: Download the CrOS Software ======
The CrowBox is controlled by an Arduino UNO microcontroller board which runs the CrowBox Operating System software that we call 'CrOS'. In order to get your CrowBox online, you'll need to download our CrOS software and install it on your Arduino UNO board. To do this you'll use the Arduino IDE software (see above) on your desktop or laptop computer, and the source code to the CrOS software (below).

  -Download the latest version of the [[kit:cros_software|CrOS software]].
  -You will receive a file named something like **cros_v10.zip**. Double-click this file to extract the .zip archive
  -The archive should create a folder called **cros** which contains the CrOS source code files, which have extensions like .h, .cpp, and a file named **cros.ino**

====== Step Three: Load CrOS software into the Arduino IDE ======
  -Launch the Arduino IDE software that you downloaded and installed in steps one and two.
  -From the Arduino menu, select FILE->OPEN
  -In the file dialog window that appears, navigate to the **cros_v10** folder from step three and select the file named **cros.ino** then click **Open**.
  -The CrOS project files will be loaded and you will see some tabs containing filenames that begin with 'cros'. You can click through these tabs to view the various source code files, or just ignore them if you're not interested.
  -It's possible that at some point a window will appear near the bottom of the Arduino IDE which tells you "Updates are available for some of your boards and libraries". It's a good idea to accept these updates and wait for them to install (just a few minutes).

====== Step Four: Connect your Arduino UNO board ======
  -Plug the 'B' end (The big square end) of your USB A to B cable into the square USB socket on your Arduino UNO board. Plug the other end of the USB cable into a free USB port on your computer.
  -Allow a moment for your operating system to detect the new device. On Windows operating systems, drivers may begin to install. If so, allow this process to finish before proceeding.
    - Your computer may ask if want to allow this new device or accessory to connect to your computer. Yes, you want to allow this.
  -Some details of the next step depend on your operating system, but to start, look at the top left of your Arduino IDE window and you should see three round buttons, and a drop-down box to the right of those buttons. Click the small arrow at the right side of the drop down box and select **Arduino Uno**. Depending on your computer operating system, the full board description will look something like this:
    - Windows
      - 'Arduino Uno' or 'Genuino Uno' along with a port number that looks like **COM3** or **COM6**, etc.
    - Mac OSX
      - 'Arduino Uno' or 'Genuino Uno' along with a port number that looks like **/dev/tty.usbmodem** or **/dev/tty.usbserial**. The port name may also end with an unusual alphanumeric string.

====== Step Five: Upload CrOS software to Arduino UNO ======
  -At the top left of the Arduino IDE window (where the three round buttons are), locate the round button with an arrow facing to the right. This is the //Upload// button.
  -Click the //Upload// button. The CrOS software will compile on your computer and then be uploaded to the Arduino UNO board which you've connected to your computer with the USB cable. This process doesn't take very long and when it is finished you'll see a message which says "Upload Complete". 
    - If you receive an error message, the best place to turn for help is the [[http://groups.google.com/group/CrowBoxKit|CrowBox Google Group]].
  -Once the upload is complete, leave the Arduino UNO board connected to your computer for 30 seconds before disconnecting the USB cable.

Your CrowBox software is now installed on the Arduino UNO!