Versalino.com

What is an IDE?

If you are new to programming you may be wondering what an IDE is. An IDE is an Integrated Development Environment, which aside from being a mouthful, is an extremely useful tool that is used to allow an individual to use high level code like C++ to develop programs more quickly.

In the case of the Arduino IDE you are provided with a simplified C++ based approach to developing code that can be quickly developed, and uploaded to your Versalino projects. As you learn how to use this system you can even go as far as writing your own libraries, and taking advantage of direct machine coding techniques, and native C++ structures and classes.

Install the Arduino IDE on your computer

The first step before you can do anything with the Versalino, or any other Arduino compatible system is to install the Arduino IDE.

Download and Install the Arduino IDE with the link below

Thle Arduino IDE can be found for Windows, Mac OS or Linux at the following link -->Click to go to download page http://arduino.cc/en/main/software <--.

Follow the instructions for your specific operating system as provided by Arduino in the link above.

Note: Though there is a windows installer available now, most windows users have reported that they had a better experience downloading and extracting the zip archive version. This is as of version 1.0.5 and the windows installer may become more stable over time.

What is an FTDI?

FTDI itself is actually stands for Future Technology Devices International, a company whose initials (FTDI) have become synonomous with USB to Serial converters. The Versalino FTDI is named so because of the fact that it uses an FTDI chip as it's main processor.

The reason you need a USB to Serial converter (like the Versalino FTDI) is to load programs onto, and communicate with your Versalino, and other Serial UART enabled devices. The key advantages of the Versalino FTDI over alternative versions is the fact that it has a built in Virtuabotix BT2S Com port for instant Bluetooth to Bluetooth connectivity between your Versalino and PC, and the fact that it has easily selectable voltage levels.

Install the FTDI (USB to Serial) Drivers on your PC

Though we recommend and assume you are using the Versalino FTDI, the following devices can also be used to program the Versalino:
The Arduino USB Serial Light
Sparkfun or Adafruit versions of the FTDI programmer
And for the adventurous the Atmel AVRISP programmer

Note: The Arduino USB Serial Light uses different drivers than those we will be discussing in this section, those drivers can be found in the driver folder of the Arduino IDE directory that you installed in the last step.

Installing FTDI drivers on Windows 7 or later

If you are using Windows 7 or later, chances are that all you have to do is plug in the Versalino FTDI and your system will identify and install the drivers for you automatically, but if you are on Windows XP or earlier, or your system did not auto-detect the device drivers then you will want to install the drivers manually below.

Installing FTDI drivers on older systems, and Mac OS/Linux

The FTDI Drivers can be found and installed from the following location -->Click to go to download page http://www.ftdichip.com/Drivers/VCP.htm and select drivers from the appropriate operating system to install <--.

Check if your drivers installed properly

Now that you have installed your drivers you can plug the Versalino FTDI into the computer using the USB Mini B cable (make sure you have the 5V setting selected with the switch on the back).

If everything is installed correctly you should now have a new COM port available on your computer.

What is a Library?

A library (in the Arduino IDE) is a specially structured piece of code that is intended to add or improve the existing functionality of your C++ environment. The libraries often handle complex problems, and device communication so that you do not have to handle low level, complex, or repetitive tasks directly in your code.

Libraries can do anything that you can do in your sketches, or in C++ in general (as long as there is room on your device), but are generally used to store classes and functions to be used in your projects.

Why should I install the Versalino library?

First of all, you do not have to install the Versalino library for you to be able to use the Versalino. For all intents and purposes you can program the Versalino as if it were an Arduino Uno, but you would lose the ease of use of the pin-out, and may have to dedicate more time to selecting pin numbers, especially if you would like to take advantage of the Versalino's unique bus structure. Because of this we think it is much easier to use the Versalino library to take advantage of the simplified bus structure, and the direct use of standard Versalino pin names in your code.

Download and extract the library

-->Click to go to the Versalino product page and download the latest Versalino library https://www.virtuabotix.com/productpage/0609224531828/ <--.

Extract the zip folders contents and makes sure that you have just the library name as your folder. In example if your extracted contents folder was named VersalinoV1S2B then you will want to remove the V1S2B from the folder name, and then check inside that folder. If that folder contained a folder named versalino then you would use the subfolder as your library folder.

If you don't use the folder that actually contains the .h and .cpp files, or you use a folder that is not named exactly the same as the main .h/.cpp file in that directory then the library will not work after it has been installed (because the IDE will not be able to find the appropriate files for installation.

Installing libraries on Windows

If you are using the Arduino IDE on windows you simply need to navigate to the folder where the Arduino.exe is and drop the Versalino libraries folder into the "Libraries" folder. So drop the library folder into the following directory on windows: arduino-1.x.x-windows (where the .x.x is the IDE version you installed) -> arduino-1.x.x -> libraries

Installing libraries on Mac OS/Linux

Installing a library in Mac OS or Linux can be a little more tricky, especially if this is the first time you are using the Arduino IDE. Unlike on Windows, your IDE does not have an accessible folder structure, so you will have to run the IDE before you can proceed.

Once you have opened the Arduino IDE it will create a Sketchbook folder on your profile, you can easily find the location of this folder by using the top menu File -> Preferences and looking at the address in the sketchbook location at the top of the Preferences window.

Once you have navigated to your Sketchbook directory you will have to create a subdirectory named "libraries" if one hasn't already been created for you. Now you can simply drop the Versalino (or other) library folder into that directory.

Check if your library is installed properly

Regardless of the operating system you used once the library folder has been placed in the "libraries" directory you will have to ensure that the Arduino IDE has been closed, and then re-open it before the library can be used.

If you have installed the library properly you should now see a Versalino subsection in the File -> Examples submenu. If your install did not work, then you likely need to check the folder name, and make sure that you did not copy extra extracted folders into the libraries directory. Adjust and retry until you see the Versalino subcategory on the Examples menu.

Congratulations!

With all the boring stuff out of the way, it is finally time to get things rolling. Keep following the steps below to start doing something with your Versalino.

Thanks again for choosing the Versalino, and best of luck with your nerdly adventures!

Connect the Versalino FTDI

Now that you have installed the Arduino IDE and Versalino FTDI drivers you are finally ready to connect it all together and get started with your first project

First connnect the Versalino FTDI to your computer with your USB Mini B cable and make sure that a new COM port is available on your computer like you did in earlier setup steps.

Once you are satisfied with the setup you can plug it into the Versalino Uno/Versalino Nano. Make sure that the pins of the Versalino FTDI match up with the pins on the Versalino Uno/Nano PGM port (I.E. match G pin to G pin, V pin to V pin and so forth). If you have it lined up correctly the voltage selector will be facing toward the outside of the Versalino board.

WARNING: DO NOT CONNECT THE VERSALINO FTDI TO THE VERSALINO BACKWARDS, OR SADNESS AND MAGIC BLUE SMOKE MAY RESULT. IF YOU CONNECTED IT THE WRONG WAY QUICKLY DISCONNECT THE USB AND TRY AGAIN THE CORRECT WAY.

Open the Arduino IDE

When you open the Arduino IDE it should conveniently create an empty sketch for you. A sketch is just the name Arduino gave to their .ino files which are the files you save your simplified C++ code for the Arduino and Versalino platforms with.

Copy the following lines of code into the empty sketch:

#include <Versalino.h> //this loads the Versalino library

// we will be connecting the LED to BUSA pin D1
// so we declare it as a variable to use later
// just in case we decide to change the pin or BUS
int led = BUSA.D1;


// the setup routine runs once when you press reset:
void setup() {
// initialize the digital pin as an output.
pinMode(led, OUTPUT);
}

// the loop routine runs over and over again forever:
void loop() {
digitalWrite(led, HIGH); // turn the LED on (HIGH is the voltage level)
delay(1000); // wait for a second
digitalWrite(led, LOW); // turn the LED off by making the voltage LOW
delay(1000); // wait for a second
}

Check compiler settings

If you are programming the Versalino Uno ensure that
"Arduino Uno" is selected from the "Tools -> Boards" menu.

If you are programming the Versalino Nano ensure that
"Arduino Nano W/ ATmega328" is selected from the "Tools -> Boards" menu.

Also check to make sure that the COM port of your Versalino FTDI
is selected from the "Tools -> Serial Port" menu.

Upload the Arduino Sketch to your Versalino

Now you should be ready to program your Versalino with your newly created sketch.

Select "File -> Upload" and wait while your sketch is compiled, and uploaded to the Versalino. If you have set up everything correctly up to this point you should see a short series of blink red and green lights on the Versalino FTDI indicating that the program is being loading through the transmit and receive lines of the serial port.

Once you see "Successfully Uploaded" at the bottom of the screen you are good to move onto the next step.

Before we connect the LED to the Versalino

NOTE: First disconnect the USB from the Versalino FTDI before plugging anything into the Versalino BUS.

If you are not familiar with the LED (Light Emitting Diode), then let me explain a little bit about it's operation and wiring. The first thing you should know is that the LED is in fact a Diode which means among other things that it only allows the flow of electrons in one direction. This means that to get the LED to light up we will have to plug it in with the correct polarity.

An easy way to determine which side of the LED is supposed to connect to Ground, and which is supposed to connect to Vdd or your IO pin you can actually look at the length of the LED leads (which means the pins that come off of the LED). The shorter of the two pins is always ground, and the longer goes to the IO pin or VDD.

If your leads have been clipped you may have to check with your manufacturer on what the notch indicator on the LED body means, some LEDs have reverse notch indicators, you shouldn't assume that your LED is the same as another. If you can see inside your LED however the larger of the two elements is always ground so you may be able to tell them apart that way. (Alternatively you can try connecting the LED in both directions and pick the one that works 😀 ).

Note: If you are using a high powered LED, or more than one LED you should put a resistor in series to prevent too much current from being drawn from your Versalino, but with a single LED that draws 20 mA or less you can safely connect it directly to your IO pin (IO pin means input output pin).

Connect the LED

Now that you know which pin is Ground and which pin goes to the IO pin you should be able to plug the short lead into GND on BUSA and the long lead of the LED into D1 of BUSA on the Versalino.

Watch in awe as your first project comes to life

Now that everything is plugged in you can reconnect the USB cable, and watch as your LED begins to blink just as you told it to. Feel free to bask in the mysterious glow as long as you see fit, and congratulations on finishing your first project!