madrona-rad 0.2.2

data/spec/models/arduino_sketch_spec.rb

@@ -0,0 +1,82 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+require File.expand_path(File.dirname(__FILE__) + "/../../lib/rad/arduino_sketch.rb")
+
+context "Arduino#serial_begin" do
+  setup do
+    @as = ArduinoSketch.new
+  end
+  
+  specify "should default baud_rate to 9600" do
+    @as.serial_begin
+    @as.instance_variable_get("@other_setup").should include("Serial.begin(9600);")
+  end
+  specify "should set an alternate baud_rate if told" do
+    @as.serial_begin :rate => 2400
+    @as.instance_variable_get("@other_setup").should include("Serial.begin(2400);")
+  end
+  specify "should add the correct function call to the composed_setup" do
+    @as.serial_begin
+    @as.compose_setup.should match(Regexp.new(Regexp.escape("Serial.begin(9600);")))
+  end
+end
+
+
+context "Arduino Base" do
+  setup do
+    @as = ArduinoSketch.new
+  end
+  
+  specify "output_pin method without :as arg. should add the pin to the pin_mode hash's output list and leave the declarations alone" do
+    @as.output_pin 1
+    @as.instance_variable_get("@declarations").first.should == nil
+    @as.instance_variable_get("@pin_modes")[:output].should include(1)
+  end
+  
+  specify "output_pin method with :as arg. should add the pin to the pin_mode hash's output list write the appropriate declaration and accessor" do
+    @as.output_pin 3, :as => :led
+    @as.instance_variable_get("@declarations").first.should == "int _led = 3;"
+    @as.instance_variable_get("@accessors").first.should == "int led(){\nreturn _led;\n}"
+    @as.instance_variable_get("@pin_modes")[:output].should include(3)
+  end
+  
+  specify "output_pins method should add the pin to the pin_mode hash's output list and leave the declarations and accessors alone" do
+    @as.output_pins [5,4,3,2]
+    @as.instance_variable_get("@pin_modes")[:output].should include(5)
+    @as.instance_variable_get("@pin_modes")[:output].should include(4)
+    @as.instance_variable_get("@pin_modes")[:output].should include(3)
+    @as.instance_variable_get("@pin_modes")[:output].should include(2)
+    @as.instance_variable_get("@declarations").first.should == nil
+    @as.instance_variable_get("@accessors").first.should == nil
+  end
+  
+  specify "input_pin method with :as arg. should add the pin to the pin_mode hash's input list write the appropriate declaration and accessor" do
+    @as.input_pin 1, :as => :knob
+    @as.instance_variable_get("@declarations").first.should == "int _knob = 1;"
+    @as.instance_variable_get("@accessors").first.should == "int knob(){\nreturn _knob;\n}"
+    @as.instance_variable_get("@pin_modes")[:input].should include(1)
+  end
+  
+  specify "input_pins method should add the pins to the pin_mode hash's input list and leave the declarations and accessors alone" do
+    @as.input_pins [5,4,3,2]
+    @as.instance_variable_get("@pin_modes")[:input].should include(5)
+    @as.instance_variable_get("@pin_modes")[:input].should include(4)
+    @as.instance_variable_get("@pin_modes")[:input].should include(3)
+    @as.instance_variable_get("@pin_modes")[:input].should include(2)
+    @as.instance_variable_get("@declarations").first.should == nil
+    @as.instance_variable_get("@accessors").first.should == nil
+  end
+  
+  specify "compose_setup should append each appropriate pinMode statement and :as accessor to the setup_function string with a newline" do
+    @as.output_pins [1, 2]
+    @as.input_pin 3, :as => :button
+    
+    result = @as.send :compose_setup
+    
+    result.should match(Regexp.new(Regexp.escape("pinMode(1, OUTPUT);\n")))
+    result.should match(Regexp.new(Regexp.escape("pinMode(2, OUTPUT);\n")))
+    result.should match(Regexp.new(Regexp.escape("pinMode(3, INPUT);\n")))
+    result.should match(Regexp.new(Regexp.escape("int _button = 3;\n")))
+    result.should match(Regexp.new(Regexp.escape("int button(){\nreturn _button;\n}")))
+  end
+  
+end

data/spec/models/spec_helper.rb

@@ -0,0 +1,2 @@
+require 'rubygems'
+require 'spec'

data/spec/spec.opts

@@ -0,0 +1 @@
+--colour

data/website/examples/assembler_test.rb.html

@@ -0,0 +1,73 @@
+<html>
+  <head>
+    <title>assembler_test.rb.html</title
+    <style type="text/css">
+
+	.ruby .normal {}
+	.ruby .comment { color: #888; font-style: italic; }
+	.ruby .keyword { color: #A00; font-weight: bold; }
+	.ruby .method { color: #077; }
+	.ruby .class { color: #074; }
+	.ruby .module { color: #050; }
+	.ruby .punct { color: #447; font-weight: bold; }
+	.ruby .symbol { color: #099; }
+	.ruby .string { color: #944; }
+	.ruby .char { color: #F07; }
+	.ruby .ident { color: #004; }
+	.ruby .constant { color: #07F; }
+	.ruby .regex { color: #B66; }
+	.ruby .number { color: #D55; }
+	.ruby .attribute { color: #377; }
+	.ruby .global { color: #3B7; }
+	.ruby .expr { color: #227; }
+    </style>
+  </head>
+  <body>
+    <pre class="ruby">
+<pre><span class="comment"># Hardware: Connect to serial output with screen:</span>
+<span class="comment">#           $ screen /dev/tty/path.to.your.usb 9600</span>
+
+<span class="keyword">class </span><span class="class">AssemblerTest</span> <span class="punct">&lt;</span> <span class="constant">ArduinoSketch</span>
+  <span class="ident">vars</span> <span class="symbol">:a</span> <span class="punct">=&gt;</span> <span class="number">10</span><span class="punct">,</span> <span class="symbol">:b</span> <span class="punct">=&gt;</span> <span class="number">4</span>
+  <span class="ident">serial_begin</span>
+  
+  <span class="keyword">def </span><span class="method">loop</span>
+    <span class="ident">serial_println</span> <span class="ident">product</span><span class="punct">(</span><span class="ident">a</span><span class="punct">,</span><span class="ident">b</span><span class="punct">)</span>
+  <span class="keyword">end</span>
+  
+  <span class="ident">assembler</span><span class="punct">(</span> <span class="symbol">:product</span><span class="punct">,</span> <span class="punct">&quot;</span><span class="string">int product(int a, int b);</span><span class="punct">&quot;,</span>
+    <span class="punct">&lt;&lt;-</span><span class="constant">CODE</span><span class="string">
+    product:
+      	mov  r18,r24	; move a to another register
+      	ldi  r24,0		; clear running sum, used to coalesce product
+      	ldi  r25,0		; sum = 0
+      
+      .loop:
+      	tst  r18		  ; is a = 0? if so, we're done
+      	breq .end
+      
+      	mov  r19,r18	; copy a
+      	andi r19,1		; is a % 2 == 0
+      	breq .skip		
+      
+      	add  r24,r22	; add b to sum
+      	adc  r25,r23
+      
+      .skip:
+      	lsr  r18		  ; divide a by 2
+      
+      	clc			
+      	rol  r22		  ; multiply b by 2
+      	rol  r23
+      	rjmp .loop
+      
+      .end:
+      	ret
+      	.size product, .-product
+</span><span class="constant">    CODE</span>
+  <span class="punct">)</span>
+<span class="keyword">end</span>
+</pre>
+    </pre>
+  </body>
+</html>

data/website/examples/gps_reader.rb.html

@@ -0,0 +1,39 @@
+<html>
+  <head>
+    <title>gps_reader.rb.html</title
+    <style type="text/css">
+
+	.ruby .normal {}
+	.ruby .comment { color: #888; font-style: italic; }
+	.ruby .keyword { color: #A00; font-weight: bold; }
+	.ruby .method { color: #077; }
+	.ruby .class { color: #074; }
+	.ruby .module { color: #050; }
+	.ruby .punct { color: #447; font-weight: bold; }
+	.ruby .symbol { color: #099; }
+	.ruby .string { color: #944; }
+	.ruby .char { color: #F07; }
+	.ruby .ident { color: #004; }
+	.ruby .constant { color: #07F; }
+	.ruby .regex { color: #B66; }
+	.ruby .number { color: #D55; }
+	.ruby .attribute { color: #377; }
+	.ruby .global { color: #3B7; }
+	.ruby .expr { color: #227; }
+    </style>
+  </head>
+  <body>
+    <pre class="ruby">
+<pre><span class="keyword">class </span><span class="class">GpsReader</span> <span class="punct">&lt;</span> <span class="constant">ArduinoSketch</span>
+  <span class="ident">output_pin</span> <span class="number">13</span><span class="punct">,</span> <span class="symbol">:as</span> <span class="punct">=&gt;</span> <span class="symbol">:led</span>
+  <span class="ident">software_serial</span> <span class="number">6</span><span class="punct">,</span> <span class="number">7</span><span class="punct">,</span> <span class="symbol">:as</span> <span class="punct">=&gt;</span> <span class="symbol">:gps</span>
+  <span class="ident">serial_begin</span>
+
+  <span class="keyword">def </span><span class="method">loop</span>
+    <span class="ident">digitalWrite</span><span class="punct">(</span><span class="ident">led</span><span class="punct">,</span> <span class="constant">true</span><span class="punct">)</span>
+    <span class="ident">serial_print</span><span class="punct">(</span><span class="ident">gps</span><span class="punct">.</span><span class="ident">read</span><span class="punct">)</span>
+  <span class="keyword">end</span>
+<span class="keyword">end</span></pre>
+    </pre>
+  </body>
+</html>

data/website/examples/hello_world.rb.html

@@ -0,0 +1,38 @@
+<html>
+  <head>
+    <title>hello_world.rb.html</title
+    <style type="text/css">
+
+	.ruby .normal {}
+	.ruby .comment { color: #888; font-style: italic; }
+	.ruby .keyword { color: #A00; font-weight: bold; }
+	.ruby .method { color: #077; }
+	.ruby .class { color: #074; }
+	.ruby .module { color: #050; }
+	.ruby .punct { color: #447; font-weight: bold; }
+	.ruby .symbol { color: #099; }
+	.ruby .string { color: #944; }
+	.ruby .char { color: #F07; }
+	.ruby .ident { color: #004; }
+	.ruby .constant { color: #07F; }
+	.ruby .regex { color: #B66; }
+	.ruby .number { color: #D55; }
+	.ruby .attribute { color: #377; }
+	.ruby .global { color: #3B7; }
+	.ruby .expr { color: #227; }
+    </style>
+  </head>
+  <body>
+    <pre class="ruby">
+<pre><span class="comment"># Hardware: LED connected on pin 7</span>
+
+<span class="keyword">class </span><span class="class">HelloWorld</span> <span class="punct">&lt;</span> <span class="constant">ArduinoSketch</span>
+  <span class="ident">output_pin</span> <span class="number">7</span><span class="punct">,</span> <span class="symbol">:as</span> <span class="punct">=&gt;</span> <span class="symbol">:led</span>
+  <span class="keyword">def </span><span class="method">loop</span>
+    <span class="ident">blink</span> <span class="ident">led</span><span class="punct">,</span> <span class="number">500</span>
+  <span class="keyword">end</span>
+<span class="keyword">end</span>
+</pre>
+    </pre>
+  </body>
+</html>

data/website/examples/serial_motor.rb.html

@@ -0,0 +1,41 @@
+<html>
+  <head>
+    <title>serial_motor.rb.html</title
+    <style type="text/css">
+
+	.ruby .normal {}
+	.ruby .comment { color: #888; font-style: italic; }
+	.ruby .keyword { color: #A00; font-weight: bold; }
+	.ruby .method { color: #077; }
+	.ruby .class { color: #074; }
+	.ruby .module { color: #050; }
+	.ruby .punct { color: #447; font-weight: bold; }
+	.ruby .symbol { color: #099; }
+	.ruby .string { color: #944; }
+	.ruby .char { color: #F07; }
+	.ruby .ident { color: #004; }
+	.ruby .constant { color: #07F; }
+	.ruby .regex { color: #B66; }
+	.ruby .number { color: #D55; }
+	.ruby .attribute { color: #377; }
+	.ruby .global { color: #3B7; }
+	.ruby .expr { color: #227; }
+    </style>
+  </head>
+  <body>
+    <pre class="ruby">
+<pre><span class="comment"># Hardware: motor control circuit (i.e. TIP-120 control pin)</span>
+<span class="comment">#           connected at pin 7.</span>
+<span class="comment">#     Demo: http://www.youtube.com/watch?v=7OguEBfdTe0</span>
+
+<span class="keyword">class </span><span class="class">SerialMotor</span> <span class="punct">&lt;</span> <span class="constant">ArduinoSketch</span>
+  <span class="ident">output_pin</span> <span class="number">7</span><span class="punct">,</span> <span class="symbol">:as</span> <span class="punct">=&gt;</span> <span class="symbol">:motor</span>
+  <span class="ident">serial_begin</span>
+  
+  <span class="keyword">def </span><span class="method">loop</span>
+    <span class="ident">digitalWrite</span><span class="punct">(</span><span class="ident">motor</span><span class="punct">,</span> <span class="ident">serial_read</span><span class="punct">)</span> <span class="keyword">if</span> <span class="ident">serial_available</span>
+  <span class="keyword">end</span>
+<span class="keyword">end</span></pre>
+    </pre>
+  </body>
+</html>

data/website/index.html

@@ -0,0 +1,177 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <link rel="stylesheet" href="stylesheets/screen.css" type="text/css" media="screen" />
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+  <title>
+      RAD
+  </title>
+  <script src="javascripts/rounded_corners_lite.inc.js" type="text/javascript"></script>
+<style>
+	.movie {float: left; margin-right: 10px; margin-bottom: 10px;}
+</style>
+  <script type="text/javascript">
+    window.onload = function() {
+      settings = {
+          tl: { radius: 10 },
+          tr: { radius: 10 },
+          bl: { radius: 10 },
+          br: { radius: 10 },
+          antiAlias: true,
+          autoPad: true,
+          validTags: ["div"]
+      }
+      var versionBox = new curvyCorners(settings, document.getElementById("version"));
+      versionBox.applyCornersToAll();
+    }
+  </script>
+</head>
+<body>
+<div id="main">
+		<div id="metadata">
+			<div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/rad"; return false'>
+    	  <p>Get Version</p>
+    	  <a href="http://rubyforge.org/projects/rad" class="numbers">0.2.2</a>
+    	</div>
+			<div id="buy-arduino">
+				
+								<a href="http://www.sparkfun.com/commerce/product_info.php?products_id=666">
+
+				<img src="http://www.sparkfun.com/commerce/images/ArduinoUSBBoard-01-M.jpg" />
+				</a>
+								<h4><a href="http://www.sparkfun.com/commerce/product_info.php?products_id=666">Buy an Arduino from Sparkfun</a></h4>
+
+			</div>
+		</div>
+    <h1>RAD</h1>
+    <h1>&#x2192; &#8216;Ruby Arduino Development&#8217;</h1>
+			
+			
+
+
+	<h2>What?</h2>
+
+
+	<p><span class="caps">RAD</span> is a framework for programming the Arduino physcial computing platform using Ruby. <span class="caps">RAD</span> 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.</p>
+
+<br style="clear:both" />
+
+	<h2>Demo: 'Hello World'</h2>
+
+	<p>Here's a basic demo of <span class="caps">RAD</span> in action. In this movie, we'll write, compile, and upload the universal physical computing 'Hello World': a single flashing LED.
+		<div class="movie"><object width="425" height="355"><param name="movie" value="http://www.youtube.com/v/AKbHcMaC_cA&hl=en"></param><param name="wmode" value="transparent"></param><embed src="http://www.youtube.com/v/AKbHcMaC_cA&hl=en" type="application/x-shockwave-flash" wmode="transparent" width="425" height="355"></embed></object></div>
+		<em>Note: This movie was made using an old version of the Arduino board which required a hardware reset before being able to accept a new sketch. More recent versions of the board don't have this requirement and hence as of version 0.2.0, <span class="caps">RAD</span> no longer prompts for reset when running 'rake make:upload' (thought the option is still available for older boards.)</em>
+	</p>
+	<br style="clear:both" />
+	<h2>Why?</h2>
+
+
+	<p>While duplicating the functionality of the well-designed Arduino software interface in Ruby may seem like an odd or redundant goal, <span class="caps">RAD</span> has further ambitions! Bootstrapping the ability to write microcontroller code in a high level dynamic language like Ruby could greatly ease the creation of all the luxurious development aids the users of such a language have come to expect: developer testing, platform independence, easy metaprogramming, etc.</p>
+
+
+	<h2>Installing</h2>
+
+
+	<p><code>$ sudo gem install rad</code></p>
+
+
+	<p>You&#8217;ll also need to have the Arduino environment installed, which you can get from <a href="http://www.arduino.cc/en/Main/Software">the Arduino website</a>.  <span class="caps">RAD</span> currently requires Arduino 0010, but we try to keep it up-to-date with new Arduino releases.</p>	
+
+
+	<h2>The Basics</h2>
+
+
+	<p><code>$ rad my_sketch</code></p>
+
+
+	<p>This command will create a new <span class="caps">RAD</span> project directory (my_sketch/) inside of the current directory that contains a blank script in which you can write your own <span class="caps">RAD</span> code, as well as a full install of the <span class="caps">RAD</span> support infrastructure (in vendor/). A sample &#8216;hello world&#8217; script in <span class="caps">RAD</span> will look like this:</p>
+
+
+<pre syntax="ruby">
+class MySketch &lt; ArduinoSketch
+  output_pin 7, :as =&gt; :led
+  def loop
+    blink led, 500
+  end
+end
+</pre>
+
+	<p>Once your code is written, your relevant local configuration properly setup in <code>config/hardware.rb</code> and <code>config/software.rb</code>, and an Arduino with the corresponding circuit (a 220ohm resistor and an <span class="caps">LED</span> wired in series between Arduino pin 7 and ground) is connected to your computer via serial, run:</p>
+
+
+	<p><code>$ rake make:upload</code></p>
+
+
+	<p>This will:</p>
+
+
+	<ul>
+	<li>generate the correct Arduino C++ code from your sketch</li>
+		<li>dynamically prepare a localized version of the default Arduino Makefile</li>
+		<li>compile your sketch</li>
+		<li>prompt you to hit the reset button on your Arduino (if necessary!)</li>
+		<li>upload your compiled binary onto your Arduino</li>
+	</ul>
+
+
+	<h2>Documentation and The Arduino <span class="caps">API</span></h2>
+
+
+	<p>Most of <a href="http://www.arduino.cc/en/Reference/HomePage">the Arduino software <span class="caps">API</span></a> should be working correctly at this point. Documentation for RAD's version of things and details about usage of the wider Arduino API are available in the <a href="http://rad.rubyforge.org/rdoc">RAD rDocs</a>.</p>
+
+	<h2>Demo: Serial Communication</h2>
+	<p>
+		To demonstrate some of the more advanced features of <span class="caps">RAD</span>, here's a movie showing how to program the Arduino to listen to serial communication from a computer. 
+		<div class="movie">
+			<object width="425" height="355"><param name="movie" value="http://www.youtube.com/v/7OguEBfdTe0&hl=en"></param><param name="wmode" value="transparent"></param><embed src="http://www.youtube.com/v/7OguEBfdTe0&hl=en" type="application/x-shockwave-flash" wmode="transparent" width="425" height="355"></embed></object>		</div>
+
+			<em>Note: The same comment from above applies here about the hardware reset. Also, extra points are available if you recognize the logo on the flag in the video.</em>	
+	</p>
+	<br style="clear:both" />
+	
+	<p>For more examples of <span class="caps">RAD</span> in action, see <a href="http://rad.rubyforge.org/examples">the RAD example directory</a>.</p>
+	<h2><span class="caps">RAD</span> Needs You!</h2>
+
+
+	<p>All the many discipline-crossing skills required for a project like <span class="caps">RAD</span> make for lots of opportunities to help out: Have you written lots of sketches exploring the obscure depths of the Arduino library? Do you run the Arduino development tool chain on an obscure (i.e., non-OS X) platform? Do you develop for other <span class="caps">AVR</span> or <span class="caps">PIC</span> microcontrollers? Are you a C/C++ ninja? Or even C/C++ competent?</p>
+
+
+	<p>There&#8217;s lots to do.</p>
+
+
+	<p>If you&#8217;re looking for a place to dive in and don&#8217;t know quite where, <a href="mailto:ruby-arduino-development@googlegroups.com">email the RAD Google Group</a>; we're friendly! If you want to start by taking a log at the code, the trunk repository is <code>svn://rubyforge.org/var/svn/rad/trunk</code> for anonymous access.</p>
+
+
+	<h2>License</h2>
+
+
+	<p>This code is free to use under the terms of the <span class="caps">GPL</span> 2.0 license, just like the Arduino software library itself.</p>
+
+
+	<h2>Contact</h2>
+
+
+	<p>Comments, questions, heckles, attacks, praises, and, (most especially) patches and contributions are welcome! Send email to <a href="mailto:ruby-arduino-development@googlegroups.com">the RAD mailing list</a>.</p>
+	
+		<h2>Who</h2>
+<p><a href="http://urbanhonking.com/ideasfordozens">Greg Borenstein</a> is RAD's original author and main maintainer with significant contributions from <a href="http://blog.bleything.net/">Ben Bleything</a> and <a href="http://www.wulfden.org/TheShoppe.shtml">Brian Riley</a>, patches from Scott Windsor and David Michael, and the support of the <a href="http://groups.google.com/group/ruby-arduino-development">the Ruby Arduino Development Google Group</a>.</p>
+	
+    <p class="coda">
+      <a href="mailto:drnicwilliams@gmail.com">Dr Nic</a>, 18th November 2007<br>
+      Theme extended from <a href="http://rb2js.rubyforge.org/">Paul Battley</a>
+    </p>
+</div>
+
+<!-- insert site tracking codes here, like Google Urchin -->
+<script type="text/javascript">
+var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+</script>
+<script type="text/javascript">
+var pageTracker = _gat._getTracker("UA-3885443-1");
+pageTracker._initData();
+pageTracker._trackPageview();
+</script>
+</body>
+</html>

data/website/index.txt

@@ -0,0 +1,64 @@
+h1. RAD
+
+h1. → 'Ruby Arduino Development'
+
+h2. What?
+
+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.
+
+h2. Why?
+
+While duplicating the functionality of the well-designed Arduino software interface in Ruby may seem like an odd or redundant goal, RAD has further ambitions! Bootstrapping the ability to write microcontroller code in a high level dynamic language like Ruby could greatly ease the creation of all the luxurious development aids the users of such a language have come to expect: developer testing, platform independence, easy metaprogramming, etc.
+
+h2. Installing
+
+@$ sudo gem install rad@
+
+You'll also need to have the Arduino environment installed, which you can get from "the Arduino website":http://www.arduino.cc/en/Main/Software.  RAD currently requires Arduino 0010, but we try to keep it up-to-date with new Arduino releases.
+
+h2. The Basics
+
+@$ rad my_sketch@
+
+This command will create a new RAD project directory (my_sketch/) inside of the current directory that contains a blank script in which you can write your own RAD code, as well as a full install of the RAD support infrastructure (in vendor/). A sample 'hello world' script in RAD will look like this:
+
+<pre syntax="ruby">
+class MySketch < ArduinoSketch
+  output_pin 7, :as => :led
+  def loop
+    blink led, 500
+  end
+end
+</pre>
+
+Once your code is written, your relevant local configuration properly setup in @config/hardware.rb@ and @config/software.rb@, and an Arduino with the corresponding circuit (a 220ohm resistor and an LED wired in series between Arduino pin 7 and ground) is connected to your computer via serial, run:
+
+@$ rake make:upload@
+
+This will:
+
+ * generate the correct Arduino C++ code from your sketch
+ * dynamically prepare a localized version of the default Arduino Makefile
+ * compile your sketch
+ * prompt you to hit the reset button on your Arduino (if necessary!)
+ * upload your compiled binary onto your Arduino
+
+h2. The Arduino API
+
+With the exception of the still-experimental Serial interface, most of <a href="http://www.arduino.cc/en/Reference/HomePage">the Arduino software API</a> should be working correctly at this point. Documentation for the Ruby versions of the methods is forthcoming, but it is mostly what you'd expect: methods with identical names and arguments to their Arduino counterparts with the exception of using 'true' and 'false' for HIGH and LOW.
+
+h2. RAD Needs You!
+
+All the many discipline-crossing skills required for a project like RAD make for lots of opportunities to help out: Have you written lots of sketches exploring the obscure depths of the Arduino library? Do you run the Arduino development tool chain on an obscure (i.e., non-OS X) platform? Do you develop for other AVR or PIC microcontrollers? Are you a C/C++ ninja? Or even C/C++ competent?
+
+There's lots to do.
+
+If you're looking for a place to dive in and don't know quite where, "email Greg":mailto:greg@grabb.it. If you want to start by taking a log at the code, the trunk repository is @svn://rubyforge.org/var/svn/rad/trunk@ for anonymous access.
+
+h2. License
+
+This code is free to use under the terms of the GPL 2.0 license, just like the Arduino software library itself.  
+
+h2. Contact
+
+Comments, questions, heckles, attacks, praises, and, (most especially) patches and contributions are welcome! Send email to "Greg Borenstein":mailto:greg@grabb.it.