User Tools

Site Tools


kit:software_configuration

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revision Both sides next revision
kit:software_configuration [2018/08/01 13:06]
admin [Step Five: Upload CrOS software to Arduino UNO]
kit:software_configuration [2018/08/02 02:55]
admin
Line 1: Line 1:
-====== ​Introduction ​====== +====== ​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 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. ​ 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. ​
Line 8: Line 9:
 If you run into trouble following the instructions on this page, there are a number of places to turn for help: If you run into trouble following the instructions on this page, there are a number of places to turn for help:
  
-  * Arduino ​- [[https://​www.arduino.cc/​en/​Guide/​HomePage|Getting Started with Arduino]] +  * arduino.cc ​- [[https://​www.arduino.cc/​en/​Guide/​HomePage|Getting Started with Arduino]] 
-  * The community at the [[http://​groups.google.com/​group/​CrowBoxKit|Official ​Crowbox ​Google Group]]+  * 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 ====== ====== 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, which is available for free download. IDE stands for //​Integrated Development Environment//,​ but that's not an important detail right now.+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.
  
 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: 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:
Line 23: Line 25:
  
 ====== Step Two: Download the CrOS 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.+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]].   -Download the latest version of the [[kit:​cros_software|CrOS software]].
Line 38: Line 40:
 ====== Step Four: Connect your Arduino UNO board ====== ====== 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.   -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+  -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
   -The details of the next step depend on your operating system:   -The details of the next step depend on your operating system:
     - Windows     - Windows
-      - In the Arduino IDE menu, select TOOLS->​PORT->​FIXME+      - 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     - Mac OSX
-      - In the Arduino IDE menu, select TOOLS->​PORT->​FIXME+      - 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     - 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       - 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 ====== ====== 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.   -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]].+  -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.   -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! Your CrowBox software should now be ready to operate!
kit/software_configuration.txt · Last modified: 2018/09/22 15:18 by steve