Welcome to RAD (Ruby Arduino Development)¶ ↑

RAD is a framework for programming the Arduino physcial computing platform using Ruby. RAD converts Ruby scripts written using a set of Rails-like conventions and helpers into C source code which can be compiled and run on the Arduino microcontroller. It also provides a set of Rake tasks for automating the compilation and upload process.

For a full introduction see rad.rubyforge.org

Documentation¶ ↑

The main documentation is here: ArduinoSketch.

See also the Arduino Software reference: www.arduino.cc/en/Reference/HomePage

Examples¶ ↑

See the examples directory for lots of examples of RAD in action: github.com/atduskgreg/rad/tree/master/lib/examples

The atduskgreg/rad wiki also contains a growing library of examples and hardware tutorials: github.com/atduskgreg/rad/wikis

Getting Started¶ ↑

To install the edge gem:

# Update to RubyGems 1.2.0 before proceeding!
$ gem sources -a http://gems.github.com (you only have to do this once)
$ sudo gem install atduskgreg-rad

A very old and feature poor (though slightly more ‘stable’ RAD) is available from RubyGems:

$ sudo gem install rad

We plan to push tagged releases to RubyGems at key points. The 0.3 release should be coming up soon.

Run the rad command to create a new project:

$ rad my_project

Write a sketch that will blink a single LED every 500ms:

class MyProject < ArduinoSketch
	output_pin 13, :as => led
	
	def loop
		blink led, 500
	end
end

Attach your Arduino and use rake to complile and upload your sketch:

$ rake make:upload

Installing the Arduino Software¶ ↑

Installing RAD and the Arduino software on Linux can be a little more difficult than on OS X. Thankfully, the RAD command line tool can help. Run:

$ rad install arduino

And RAD will do its best to get the Arduino software installed on your system.

Get Involved¶ ↑

Cheers? Jeers? Wanna help out? Contact Greg Borenstein: greg [dot] borenstein [at] gmail [dot] com