Getting Started - Ringo and Ringo2 RobotsFollow the instructions in the video below to quickly set up your Ringo or Ringo2 robot.
To prepare your computer to write code for your Ringo robots, you will need to perform the following steps.
|
This is a smooth process for most people, and once you have the drivers and software loaded up on your computer, it's easy sailing as you begin to play with your robots. If you do encounter any difficulty getting the programming process started, please have a look at this post on our forum, where we discuss some issues others have encountered along with solutions. You can also Contact Us for more assistance.
Ringo Getting Started Video
Ringo Getting Started Steps
These steps follow along with the video above. Note that the install process is nearly identical for Mac.
IMPORTANT NOTE: We are still in process of updating the written guides and docs for the newest version of Ringo. Some instructions in the guides may conflict with directions on this page. Follow the instructions given in the video above and the steps below as they are most up to date.
IMPORTANT NOTE: We are still in process of updating the written guides and docs for the newest version of Ringo. Some instructions in the guides may conflict with directions on this page. Follow the instructions given in the video above and the steps below as they are most up to date.
- Visit the Software page of the arduino.cc website. Download and install the correct version of the Arduino coding environment for your operating system.
- Download and install the USB driver from the links below. For Windows users, right-click the installer and select "Run as Administrator" when installing.
- Download the Ringo Software libraries from the links below. Copy all folders inside the zip to your Documents>Arduino>libraries folder.
- Go to the Ringo Software page and download the Ringo Base Sketch and the Pre-Loaded Behaviors. You can use the Pre-Loaded Behaviors file to re-install the demo code that was installed on your robot when shipping. Use the Base Sketch to begin writing your own code. The Base Sketch is a template that already has the required libraries linked and ready to use.
- Configure a few options in the Arduino>Tools menu to prepare the Arduino software to upload code to your robot.
- Test the upload.
- Visit the Ringo Guide Book page to download a copy of the Ringo Guide Book. Follow this guide book to learn how to write code for Ringo.
Driver Installation
Before you can load code onto your robots, the FTDI drivers must be installed first. Follow the instructions on this page to download and install the correct driver for your computer and operating system.
It is important that the FTDI drivers be installed on your computer BEFORE connecting the programmer to your computer.
It is important that the FTDI drivers be installed on your computer BEFORE connecting the programmer to your computer.
Windows Driver Installation |
Mac Driver Installation |
Linux Driver InstallationNo driver should be required for Ubuntu 11.10 or later and kernel 3.0.0-19 or later.
If you have a different version of Linux, you can get the driver here: http://www.ftdichip.com/Drivers/VCP/Linux/ftdi_sio.tar.gz |
|
Install Ringo Software Libraries
The software libraries include code you'll add to your Arduino installation. This only needs to be done one time. Arduino will use these library files as necessary automatically after they are installed.
1) Download a zip archive including all the Ringo library files (also use these same files for Wink):
http://files.plumgeek.com/software/ringo/libraries/RingoLibraries_Rev01-01.zip
2) Copy the four folders included in this zip file into your Arduino/libraries folder:
For the examples to compile, these three important folders must be copied into your libraries folder: Adafruit_NeoPixel, RingoMsTimer2, RingoWire, and FastLED.
You'll need to re-start the Arduino software for it to see the new libraries.
The "libraries" folder is located inside the folder where your computer saves Arduino sketches.
http://files.plumgeek.com/software/ringo/libraries/RingoLibraries_Rev01-01.zip
2) Copy the four folders included in this zip file into your Arduino/libraries folder:
For the examples to compile, these three important folders must be copied into your libraries folder: Adafruit_NeoPixel, RingoMsTimer2, RingoWire, and FastLED.
You'll need to re-start the Arduino software for it to see the new libraries.
The "libraries" folder is located inside the folder where your computer saves Arduino sketches.
Windows Library Location:
My Documents\Arduino\libraries After copying the paths should look like this: My Documents\Arduino\libraries\Adafruit_NeoPixel My Documents\Arduino\libraries\RingoMsTimer2 My Documents\Arduino\libraries\RingoWire My Documents\Arduino\libraries\FastLED |
Mac Library Location:
Documents/Arduino/libraries After copying the paths should look like this: Documents/Arduino/libraries/Adafruit_NeoPixel Documents/Arduino/libraries/RingoMsTimer2 Documents/Arduino/libraries/RingoWire Documents/Arduino/libraries/FastLED |
For more information or help regarding library installation, check out the "Libraries" page on the official Arduino site:
https://www.arduino.cc/en/Guide/Libraries
https://www.arduino.cc/en/Guide/Libraries