⚠️ This repo is no longer maintained!

Please use denko instead. It's identical other than the name, and being up to date. I've reset the master branch of this repo to match the last Rubygems release. - @vickash

Dino 0.11.2

Get Started In No Time

Dino lets you start programming your Arduino with Ruby in minutes.

Install the Gem

gem install dino

Prepare the Bootstrapper

Use the included command line tool to create a folder with the Arduino sketch you want to use and optionally configure it.

# If connecting via serial, USB or ser2net, this is all you should need:
dino generate-sketch serial

# If usng the ethernet shield, you'll want to specify unique MAC and IP addresses:
dino generate-sketch ethernet --mac XX:XX:XX:XX:XX:XX --ip XXX.XXX.XXX.XXX

# For more options:
dino help

Note: Current Ethernet shields come with a sticker indicating the MAC address you should use with them. For older shields without a dedicated MAC address, inventing a random one should work, but don't use the same one for multiple boards. Valid IP addresses depend on the configuration of your network.

Upload The Bootstrapper

Connect the Arduino to a USB port on your machine, regardless of which sketch you're using.
Open the normal Arduino IDE
Open the .ino file in the sketch folder you just generated.
Click the upload button (an arrow).

Verify Install

Build the sample circuit examples/led/led.png
From your terminal, execute ruby example/led/led.rb
Observe your LED blinking continuously

Examples and Tutorials

Circuits and Programs

Take a look in the example directory for small component examples
Try Getting Started with Arduino and Dino from Jumpstart Lab, building a number-guessing game and a simple nightlight
An example rails app using Dino and Pusher
For a Sinatra example look at the site used to shoot the cannon at RubyConf2012

Explanatory Talks

"Arduino the Ruby Way" at RubyConf 2012
- Video by ConFreaks
- Slides on SpeakerDeck

austinbv/dino