User Tools

Site Tools


kit:software_configuration

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
kit:software_configuration [2018/07/31 11:26]
steve created - relocated content from orphaned article
kit:software_configuration [2018/09/22 15:18] (current)
steve [Step Two: Download the CrOS Software] - Updated source file names
Line 1: Line 1:
-====== ​Step One: Download the Arduino IDE software ​======+====== ​CrowBox Software Configuration ​======
  
-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, which is available for free download. IDE stands for //Integrated Development Environment//, but that's not an important detail right now.+The programmable ​computer ​brain that controls ​the CrowBox ​is the [[https://store.arduino.cc/arduino-uno-rev3|Arduino UNO microcontroller board]].
  
-Let'get started!+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.
  
-  -Visit the Arduino website at https://​www.arduino.cc +The Arduino is an extremely popular platform ​for makers ​and experimental electronics worldwideThis means that there are a great deal of resources available ​to help you learn more about the Arduino ​hardware, the Arduino ​IDE softwareand how to program and modify programs for these great little boards
-  -From the menu bar near the top of the web page, select SOFTWARE->​DOWNLOADS +
-  -Disregard the section labelled //Arduino Web Editor// and scroll down the the section labelled //Download the Arduino IDE// +
-  -From the right-hand sidebar, select the operating system that applies to the computer you will use to program your Arduino Uno. The Arduino ​IDE software ​is offered ​for Windows, Mac OSX, and LinuxIf you are downloading for Windows operating system, we recommend the option labelled //Windows Installer//​ +
-  -After you select an operating system you will be taken to download page where you may choose ​to //​Contribute and Download// or //Just Download//. Here you may choose to download ​the Arduino ​IDE for freeor make a contribution to the Arduino ​project. **NOTE:** Crowbox has no direct affiliation with Arduino. +
-  -Once you’ve made a selectionthe Arduino software will download.+
  
-====== Step Two: Install ​the Arduino IDE Software ======+If you run into trouble following ​the instructions on this page, there are a number of places to turn for help:
  
-===== For Windows operating system ===== +  * arduino.cc - [[https://​www.arduino.cc/​en/​Guide/​HomePage|Getting Started with Arduino]] 
-FIXME+  * 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]]
  
-===== For Mac OSX operating system ===== 
-**NOTE:** The Arduino IDE requires Mac OSX 10.7 Lion or newer. 
  
-  -In your Downloads folder, locate the file named something like **arduino-x.x.x-macosx.zip** +====== Step One: Download ​and install ​the Arduino IDE software ======
-  -Double click the file and it should automatically extract +
-  -Locate ​the extracted file which will simply be named **Arduino**. It should have a round, blue-green icon.  +
-  -You may leave this Arduino file in your //​Downloads//​ folder, or drag it another folder, usually //​Applications//​. +
-  -Arduino IDE installation is now complete!+
  
-===== For Linux operating system ===== +To install ​the CrowBox system software onto your Arduino ​UNO microcontroller board, ​you'll need a computer, a USB A to B cableand the Arduino IDE software, which is available for free download. IDE stands for //​Integrated Development Environment//,​ but that's not an important detail right now.
-We are looking for someone to help us by writing Linux installation instructions for the Arduino ​IDE. If you're willing ​to contributeplease contact us on the **Crowbox Google Group** FIXME+
  
-====== Step Three: Download ​the CrOS Software ====== +Let's get started! First, follow the official instructions at the Arduino ​website to install ​the version of the Arduino IDE software that matches ​your computer's operating system:
-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.+
  
-  -Download the latest version of the CrOS software ​from FIXME +    * Arduino ​software ​install guide for [[https://​www.arduino.cc/​en/​Guide/​Windows|Windows]] 
-  -You will receive a file named something like **cros_v011.zip**Double-click this file to extract the .zip archive +    Arduino software install guide for [[https://​www.arduino.cc/​en/​Guide/​MacOSX|Mac OSX]] 
-  -The archive should create a folder called ​**cros_source** which contains the CrOS source code files, which have extensions like .h, .cpp, and a file named **cros.ino**+    Arduino software install guide for [[https://​www.arduino.cc/​en/​Guide/​Linux|Linux]]
  
-====== Step Four: Load CrOS software into the Arduino IDE ======+====== 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. 
 + 
 +  -Download the latest version of the [[kit:​cros_software|CrOS software]]. 
 +  -You will receive a file named something like **cros_v099a.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.   -Launch the Arduino IDE software that you downloaded and installed in steps one and two.
   -From the Arduino menu, select FILE->​OPEN   -From the Arduino menu, select FILE->​OPEN
Line 43: Line 38:
   -It's possible that at some point a window will appear near the bottom of the Arduino IDE which says "​Updates are available for some of your boards and libraries"​. It's a good idea to accept these updates, but you may also click the X to dismiss this message and ignore the updates.   -It's possible that at some point a window will appear near the bottom of the Arduino IDE which says "​Updates are available for some of your boards and libraries"​. It's a good idea to accept these updates, but you may also click the X to dismiss this message and ignore the updates.
  
-====== Step FivePlug in your Arduino UNO board ======+====== Step FourConnect ​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.   -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.
   -In the Arduino IDE menu, select TOOLS->​BOARD->​ARDUINO/​GENUINO UNO   -In the Arduino IDE menu, select TOOLS->​BOARD->​ARDUINO/​GENUINO UNO
-  -In the Arduino IDE menu, select TOOLS->​PORT->​FIXME +  ​-The details of the next step depend on your operating system: 
- +    - Windows 
- +      ​- In the Arduino IDE menu, select TOOLS->​PORT-> ​and then look for a COM port numbered 3 or higher which is also labeled (Arduino/​Genuino Uno) and select it. 
 +      - Examples: **COM6 (Arduino/​Genuino Uno)** or **COM3 (Arduino/​Genuino Uno)** 
 +    - Mac OSX 
 +      - In the Arduino IDE menu, select TOOLS->​PORT->​ and then select the port named starting with **/​dev/​tty.usbmodem** or **/​dev/​tty.usbserial**. The port name will probably end with an unusual alphanumeric string. 
 +    - Linux 
 +      - We have no instructions for this step at present!  
 +      - If you are familiar with the Arduino IDE on Linux, please contact us on the Google Group to contribute to this section
  
  
 +====== Step Five: Upload CrOS software to Arduino UNO ======
 +  -At the top left of the Arduino IDE window you'll see two round buttons. 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. 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 should now be ready to operate!
kit/software_configuration.1533061591.txt.gz · Last modified: 2018/07/31 11:26 by steve