Configuring an Arduino Yun for use with Open Hybrid

Open Hybrid is a very interesting system used to connect devices (think IoT) to one another, and control the devices using a mobile device running the Hybrid Editor app.  The project that I am working on as a part of the SMARTER RET at NYU Poly details research into the educational applications of augmented reality (AR), and it seemed like a natural fit to use Open Hybrid to consider some possible applications of AR in the chemistry classroom.

This post is meant purely to document the setup process for other who (like myself) have limited coding experience.  Here we go!

Step 1: Unboxing the components

You’ll need an Arduino Yun as well as a decent sized microSD card to get rolling.  I found a 16 GB microSD card from amazon for about five bucks.

Arduino Yun and microSD card

Arduino Yun and microSD card

Step 2: Download the Yun image from OpenHybrid.org

Next, you’ll need the Arduino Yun image, which you will install onto the microSD card. You can download the most recent image from OpenHybrid.org or from the associated GitHub.

Before beginning, make sure that your Arduino Yun has the most recent firmware. You can read about how to upgrade the firmware here.

Open the hybrid.dmg file

Step 3: Install the files onto your microSD card

Insert your microSD card into your computer and fire up the Terminal application.  You’ll need to find the folder where the hybrid.dmg file is stored on your computer.  For me, this was in the downloads folder, but your experience may vary depending upon your system settings. If you are unfamiliar with how to change folders within terminal, you need to use a couple of simple UNIX commands.

To see the folders at your current level, type “ls”. This tells terminal to list all of the folders. Notice that the file “hybrid.dmg” is not visible. This is because it is in the Downloads folder.  To change the folder location, type “cd <name of folder>”, which for me looks like this:

Terminal window showing folders

Terminal window showing folders

When I repeat the “ls” command, I now see the file.

Next, type “diskutil list”. This will show you all of the disks on your computer and their names. You need to find the name of the microSD card. For me, it was “/dev/disk2”. Once you’ve figured out the name, you will enter a command to unmount the disk by typing “diskutil unmountDisk /dev/disk2”. If you’ve done this correctly, the terminal will display a message that the disk was successfully unmounted.

Terminal window showing the microSD card name

Terminal window showing the microSD card name

Now’s the time to install the hybrid image onto the microSD card.  Do this by typing “sudo dd if=hybrid.dmg of=/dev/disk2”. Just remember that you need to use your unique name of your microSD card. You will need to enter your system password after executing the sudo command. This process can take a while to complete, so be patient! You’ll know the process is complete when the terminal prompt returns.

Step 4: Install microSD card and wirelessly connect to the Arduino Yun

After completing steps 1-3, you can eject the microSD card from the computer and install it into your Arduino Yun. Connect the Yun to your computer using a usb cord. After a little while, you should notice a wifi signal named “Arduino-XXXXXXXXXXXX”. This is being broadcast by your Arduino and you will need to connect your computer to this wifi network.

Step 5: Configure the wifi settings on your Arduino Yun

Follow the directions from Arduino to configure your Yun. Once you have connected to your Arduino’s wifi network (“Arduino-XXXXXXXXXXX” from step 4), you can access the config panel by typing “arduino.local” into the url region of your web browser. This should take you to the Arduino Yun panel.

Webportal for the Arduino Yun

Webportal for the Arduino Yun

By default, the password is set to “arduino”. Type this in, and you will see the configure button.

Click on the configure button

Click on the configure button

Once inside the configuration panel, you’ll have the ability to change the name of your arduino, change the arduino password, and configure the wireless connectivity.  If you want to change the name of your Arduino, understand that this also changes how you access the arduino using the web browser! For example, my Arduino Yun is named “pcarduino” and I use “pcarduino.local” to access the configuration panel wirelessly.

The configuration panel

The configuration panel

Within the configuration panel, select the wifi network that you want to connect to. This will also be the network that you will need to have your mobile device connected to later on so that the open hybrid objects are able to be visualized.  Remember, the Arduino Yun and computer/mobile device must be connected to the same network for open hybrid to work properly.

Click “Configure & Restart” to apply the new settings.  While the Arduino is restarting, connect to the wifi network that you specified within the configuration panel.  This way, you’ll be able to connect to your Arduino once it finishes the reboot process.

Step 6: Reset the Arduino Yun 

Next, go back to arduino.local. Click on the “reset” button to apply the files you installed onto the microSD.  This will take a little while to complete.  You’ll know the process is complete when you can login to the Arduino using arduino.local and entering the password.

Screen_Shot_2015-08-07_at_2_18_13_PM

Step 7: Begin creation of Open Hybrid Objects

If you’ve made it this far, you now have an Arduino Yun that is a Hybrid Object.  To check to ensure this is the case, navigate to “arduino.local:8080” (remember if you renamed your arduino that the navigation would be <yourarduinoname>.local:8080).  You should see something that looks like this:

The Hybrid Object Administration Panel

The Hybrid Object Administration Panel

Congrats! You’re ready to start building great things with Open Hybrid!  My suggestion: follow the Learn/First Steps page on openhybrid.org.  The video tutorials are very helpful.

 

Good luck!

Advertisements

One response to “Configuring an Arduino Yun for use with Open Hybrid

  1. Pingback: Changing the wifi settings for an Open Hybrid configured Arduino Yun | A Digital Life·

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s