crowboxwiki

User Tools

Site Tools

Trace:
kit:software_configuration

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
kit:software_configuration [2018/09/22 15:18] – [Step Two: Download the CrOS Software] - Updated source file names stevekit:software_configuration [2025/06/07 14:53] (current) – external edit 127.0.0.1
Line 9: 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.cc - [[https://www.arduino.cc/en/Guide/HomePage|Getting Started with Arduino]]+  * 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]]   * 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]]   * The community at the [[http://groups.google.com/group/CrowBoxKit|Official CrowBox Google Group]]
Line 16: Line 16:
 ====== 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 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 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 [[https://docs.arduino.cc/software/ide-v2/tutorials/getting-started/ide-v2-downloading-and-installing/|install the Arduino IDE software]]
- +
-    * Arduino software install guide for [[https://www.arduino.cc/en/Guide/Windows|Windows]] +
-    * Arduino software install guide for [[https://www.arduino.cc/en/Guide/MacOSX|Mac OSX]] +
-    * Arduino software install guide for [[https://www.arduino.cc/en/Guide/Linux|Linux]]+
  
 ====== 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. 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]].   -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+  -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**   -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**
  
Line 34: Line 30:
   -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
-  -In the file dialog window that appears, navigate to the 'cros_source' folder from step three and select the file named **cros.ino** then click **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.   -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 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 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 ====== ====== 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. On Windows operating systems, drivers may begin to install. If so, allow this process to finish before proceeding.   -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 +    - Your computer may ask if want to allow this new device or accessory to connect to your computer. Yes, you want to allow this. 
-  -The details of the next step depend on your operating system:+  -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     - 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. +      - 'Arduino Uno' or 'Genuino Uno' along with a port number that looks like **COM3** or **COM6**, etc.
-      - Examples: **COM6 (Arduino/Genuino Uno)** or **COM3 (Arduino/Genuino Uno)**+
     - Mac OSX     - 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. +      - '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.
-    - 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 ====== ====== 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 (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. 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. 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.   -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 is now installed on the Arduino UNO! 
kit/software_configuration.1537654715.txt.gz · Last modified: 2018/09/22 15:18 by steve