rad 0.0.1

data/bin/rad

@@ -0,0 +1,68 @@
+#!/usr/bin/env ruby
+
+begin
+  require 'rubygems'
+rescue LoadError
+  # no rubygems to load, so we fail silently
+end
+
+require 'optparse'
+require 'fileutils'
+
+parser = OptionParser.new do |opts|
+  opts.banner = <<BANNER
+Build a directory for your RAD Sketch and install RAD in its vendor sub-directory.
+
+Usage: #{File.basename($0)} <sketch_dir_name>
+BANNER
+
+  opts.on("-h", "--help",
+          "Show this help message.") { puts opts; exit }
+  opts.parse!(ARGV)
+end
+
+sketch_name = ARGV[0]
+parser.parse!(["-h"]) unless sketch_name 
+
+FileUtils.mkdir_p "#{sketch_name}/vendor/rad"
+puts "Successfully created your sketch directory."
+
+FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/rad/.", "#{sketch_name}/vendor/rad"
+puts "Installed RAD library into #{sketch_name}/vendor/rad"
+puts
+
+FileUtils.touch "#{sketch_name}/#{sketch_name}.rb"
+File.open("#{sketch_name}/#{sketch_name}.rb", "w") do |file|
+  file << <<-EOS
+class #{sketch_name.split("_").collect{|c| c.capitalize}.join("")} < ArduinoSketch
+end
+  EOS
+end
+puts "Added #{sketch_name}/#{sketch_name}.rb"
+
+File.open("#{sketch_name}/Rakefile", 'w') do |file|
+  file << <<-EOS 
+require 'vendor/rad/init.rb'
+  EOS
+end
+puts "Added #{sketch_name}/Rakefile"
+
+FileUtils.mkdir_p "#{sketch_name}/config"
+puts "Added #{sketch_name}/config"
+
+File.open("#{sketch_name}/config/hardware.yml", 'w') do |file|
+  file << <<-EOS 
+rserial_port: /dev/tty.usbserial-A3000WS0
+  EOS
+end
+puts "Added #{sketch_name}/config/hardware.yml"
+
+File.open("#{sketch_name}/config/software.yml", 'w') do |file|
+  file << <<-EOS 
+arduino_root: /Applications/arduino/arduino-0007
+  EOS
+end
+puts "Added #{sketch_name}/config/software.yml"
+
+puts
+puts "Run 'rake -T' inside your sketch dir to learn how to compile and upload it."

data/lib/rad.rb

@@ -0,0 +1,5 @@
+module Rad
+end
+
+require 'rad/version'
+require 'rad/init'

data/lib/rad/arduino_sketch.rb

@@ -0,0 +1,95 @@
+# TOOD:
+# ON and OFF
+# HIGH and LOW
+
+class ArduinoSketch
+  def initialize
+    @declarations = []
+    @pin_modes = {:output => [], :input => []}
+    @accessors = []
+    @signatures = []
+    @helper_methods = ""
+  end
+  
+  def output_pin(num, opts={})
+    raise ArgumentError, "can only define pin from Fixnum, got #{num.class}" unless num.is_a?(Fixnum)
+    @pin_modes[:output] << num
+    if opts[:as]
+      @declarations << "int _#{opts[:as]} = #{num};"
+      @accessors << "int #{opts[:as]}(){\nreturn _#{opts[:as]};\n}"
+      @signatures << "int #{opts[:as]}();"
+    end
+  end
+  
+  def output_pins(nums)
+    ar = Array(nums)
+    ar.each {|n| output_pin(n)} 
+  end
+  
+  def input_pin(num, opts={})
+    raise ArgumentError, "can only define pin from Fixnum, got #{num.class}" unless num.is_a?(Fixnum)
+    @pin_modes[:input] << num
+    if opts[:as]
+      @declarations << "int _#{opts[:as]} = #{num};"
+      @accessors << "int #{opts[:as]}(){\nreturn _#{opts[:as]};\n}"
+      @signatures << "int #{opts[:as]}();"
+    end
+  end
+  
+  def input_pins(nums)
+    ar = Array(nums)
+    ar.each {|n| input_pin(n)} 
+  end
+  
+  def add(st)
+    @helper_methods << "\n#{st}\n"
+  end
+  
+  def compose_setup # also composes headers and signatures
+    result = "#include <WProgram.h>\nvoid loop();\nvoid setup();"
+    @signatures.each do |dec|
+      result << "#{dec}\n"
+    end
+    
+    @declarations.each do |dec|
+      result << "#{dec}\n"
+    end
+    @accessors.each do |ac|
+      result << "#{ac}\n"
+    end
+    result << "void setup(){\n"
+    @pin_modes.each do |k,v|
+      v.each do |value| 
+        result << "pinMode(#{value}, #{k.to_s.upcase});\n"
+      end
+    end
+    result<<"}\n#{@helper_methods}"
+  end
+  
+  private
+  
+  def serial_boilerplate
+    # TODO:
+    # take away serial_begin and write a real class method
+    # serial_print and serial_println need signatures for every combination of argument options
+    <<-CODE
+    void serial_begin(int speed){
+      Serial.begin(speed)
+    }
+    int serial_available(){
+      Serial.available() > 0
+    }
+    int serial_read(){
+      Serial.read()
+    }
+    void serial_flush(){
+      Serial.flush()
+    }
+    void serial_print()
+    void serial_println()
+    Serial.print(data)
+    Serial.println(data)
+    CODE
+  end
+  
+end

data/lib/rad/generators/makefile/makefile.erb

@@ -0,0 +1,219 @@
+# Arduino makefile
+#
+# This makefile allows you to build sketches from the command line
+# without the Arduino environment (or Java).
+#
+# The Arduino environment does preliminary processing on a sketch before
+# compiling it.  If you're using this makefile instead, you'll need to do
+# a few things differently:
+#
+#   - Give your program's file a .cpp extension (e.g. foo.cpp).
+#
+#   - Put this line at top of your code: #include <WProgram.h>
+#
+#   - Write prototypes for all your functions (or define them before you
+#     call them).  A prototype declares the types of parameters a
+#     function will take and what type of value it will return.  This
+#     means that you can have a call to a function before the definition
+#     of the function.  A function prototype looks like the first line of
+#     the function, with a semi-colon at the end.  For example:
+#     int digitalRead(int pin);
+#
+# Instructions for using the makefile:
+#
+#  1. Copy this file into the folder with your sketch.
+#
+#  2. Below, modify the line containing "TARGET" to refer to the name of
+#     of your program's file without an extension (e.g. TARGET = foo).
+#
+#  3. Modify the line containg "ARDUINO" to point the directory that
+#     contains the Arduino core (for normal Arduino installations, this
+#     is the lib/targets/arduino sub-directory).
+#
+#  4. Modify the line containing "PORT" to refer to the filename
+#     representing the USB or serial connection to your Arduino board
+#     (e.g. PORT = /dev/tty.USB0).  If the exact name of this file
+#     changes, you can use * as a wildcard (e.g. PORT = /dev/tty.USB*).
+#
+#  5. At the command line, change to the directory containing your
+#     program's file and the makefile.
+#
+#  6. Type "make" and press enter to compile/verify your program.
+#
+#  7. Type "make upload", reset your Arduino board, and press enter  to
+#     upload your program to the Arduino board.
+#
+# $Id$
+
+PORT = <%= params[:serial_port] %>
+TARGET = <%= params[:target] %>
+ARDUINO = <%= params[:arduino_root] %>/lib/targets/arduino
+SRC = $(ARDUINO)/pins_arduino.c $(ARDUINO)/wiring.c $(ARDUINO)/WInterrupts.c
+CXXSRC = $(TARGET).cpp $(ARDUINO)/HardwareSerial.cpp $(ARDUINO)/WRandom.cpp
+MCU = atmega8
+F_CPU = 16000000
+FORMAT = ihex
+UPLOAD_RATE = 19200
+
+# Name of this Makefile (used for "make depend").
+MAKEFILE = Makefile
+
+# Debugging format.
+# Native formats for AVR-GCC's -g are stabs [default], or dwarf-2.
+# AVR (extended) COFF requires stabs, plus an avr-objcopy run.
+DEBUG = stabs
+
+OPT = s
+
+# Place -D or -U options here
+CDEFS = -DF_CPU=$(F_CPU)
+CXXDEFS = -DF_CPU=$(F_CPU)
+
+# Place -I options here
+CINCS = -I$(ARDUINO)
+CXXINCS = -I$(ARDUINO)
+
+# Compiler flag to set the C Standard level.
+# c89   - "ANSI" C
+# gnu89 - c89 plus GCC extensions
+# c99   - ISO C99 standard (not yet fully implemented)
+# gnu99 - c99 plus GCC extensions
+CSTANDARD = -std=gnu99
+CDEBUG = -g$(DEBUG)
+CWARN = -Wall -Wstrict-prototypes
+CTUNING = -funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums
+#CEXTRA = -Wa,-adhlns=$(<:.c=.lst)
+
+CFLAGS = $(CDEBUG) $(CDEFS) $(CINCS) -O$(OPT) $(CWARN) $(CSTANDARD) $(CEXTRA)
+CXXFLAGS = $(CDEFS) $(CINCS) -O$(OPT)
+#ASFLAGS = -Wa,-adhlns=$(<:.S=.lst),-gstabs 
+LDFLAGS = 
+
+
+# Programming support using avrdude. Settings and variables.
+AVRDUDE_PROGRAMMER = stk500
+AVRDUDE_PORT = $(PORT)
+AVRDUDE_WRITE_FLASH = -U flash:w:$(TARGET).hex
+AVRDUDE_FLAGS = -F -p $(MCU) -P $(AVRDUDE_PORT) -C <%= params[:arduino_root] %>/tools/avr/etc/avrdude.conf -c $(AVRDUDE_PROGRAMMER) \
+  -b $(UPLOAD_RATE)
+
+# Program settings
+CC = avr-gcc
+CXX = avr-g++
+OBJCOPY = avr-objcopy
+OBJDUMP = avr-objdump
+SIZE = avr-size
+NM = avr-nm
+AVRDUDE = avrdude
+REMOVE = rm -f
+MV = mv -f
+
+# Define all object files.
+OBJ = $(SRC:.c=.o) $(CXXSRC:.cpp=.o) $(ASRC:.S=.o)
+
+# Define all listing files.
+LST = $(ASRC:.S=.lst) $(CXXSRC:.cpp=.lst) $(SRC:.c=.lst)
+
+# Combine all necessary flags and optional flags.
+# Add target processor to flags.
+ALL_CFLAGS = -mmcu=$(MCU) -I. $(CFLAGS)
+ALL_CXXFLAGS = -mmcu=$(MCU) -I. $(CXXFLAGS)
+ALL_ASFLAGS = -mmcu=$(MCU) -I. -x assembler-with-cpp $(ASFLAGS)
+
+
+# Default target.
+all: build
+
+build: elf hex
+
+elf: $(TARGET).elf
+hex: $(TARGET).hex
+eep: $(TARGET).eep
+lss: $(TARGET).lss 
+sym: $(TARGET).sym
+
+# Program the device.  
+upload: $(TARGET).hex
+	$(AVRDUDE) $(AVRDUDE_FLAGS) $(AVRDUDE_WRITE_FLASH)
+
+
+
+
+# Convert ELF to COFF for use in debugging / simulating in AVR Studio or VMLAB.
+COFFCONVERT=$(OBJCOPY) --debugging \
+--change-section-address .data-0x800000 \
+--change-section-address .bss-0x800000 \
+--change-section-address .noinit-0x800000 \
+--change-section-address .eeprom-0x810000 
+
+
+coff: $(TARGET).elf
+	$(COFFCONVERT) -O coff-avr $(TARGET).elf $(TARGET).cof
+
+
+extcoff: $(TARGET).elf
+	$(COFFCONVERT) -O coff-ext-avr $(TARGET).elf $(TARGET).cof
+
+
+.SUFFIXES: .elf .hex .eep .lss .sym
+
+.elf.hex:
+	$(OBJCOPY) -O $(FORMAT) -R .eeprom $< $@
+
+.elf.eep:
+	-$(OBJCOPY) -j .eeprom --set-section-flags=.eeprom="alloc,load" \
+	--change-section-lma .eeprom=0 -O $(FORMAT) $< $@
+
+# Create extended listing file from ELF output file.
+.elf.lss:
+	$(OBJDUMP) -h -S $< > $@
+
+# Create a symbol table from ELF output file.
+.elf.sym:
+	$(NM) -n $< > $@
+
+
+
+# Link: create ELF output file from object files.
+$(TARGET).elf: $(OBJ)
+	$(CC) $(ALL_CFLAGS) $(OBJ) --output $@ $(LDFLAGS)
+
+
+# Compile: create object files from C++ source files.
+.cpp.o:
+	$(CXX) -c $(ALL_CXXFLAGS) $< -o $@ 
+
+# Compile: create object files from C source files.
+.c.o:
+	$(CC) -c $(ALL_CFLAGS) $< -o $@ 
+
+
+# Compile: create assembler files from C source files.
+.c.s:
+	$(CC) -S $(ALL_CFLAGS) $< -o $@
+
+
+# Assemble: create object files from assembler source files.
+.S.o:
+	$(CC) -c $(ALL_ASFLAGS) $< -o $@
+
+
+
+# Target: clean project.
+clean:
+	$(REMOVE) $(TARGET).hex $(TARGET).eep $(TARGET).cof $(TARGET).elf \
+	$(TARGET).map $(TARGET).sym $(TARGET).lss \
+	$(OBJ) $(LST) $(SRC:.c=.s) $(SRC:.c=.d) $(CXXSRC:.cpp=.s) $(CXXSRC:.cpp=.d)
+
+depend:
+	if grep '^# DO NOT DELETE' $(MAKEFILE) >/dev/null; \
+	then \
+		sed -e '/^# DO NOT DELETE/,$$d' $(MAKEFILE) > \
+			$(MAKEFILE).$$$$ && \
+		$(MV) $(MAKEFILE).$$$$ $(MAKEFILE); \
+	fi
+	echo '# DO NOT DELETE THIS LINE -- make depend depends on it.' \
+		>> $(MAKEFILE); \
+	$(CC) -M -mmcu=$(MCU) $(CDEFS) $(CINCS) $(SRC) $(ASRC) >> $(MAKEFILE)
+
+.PHONY:	all build elf hex eep lss sym program coff extcoff clean depend

data/lib/rad/generators/makefile/makefile.rb

@@ -0,0 +1,46 @@
+require 'erb'
+
+class Makefile
+  class << self
+    
+    # build the sketch Makefile for the given template based on the values in its software and hardware config files
+    def compose_for_sketch(sketch_name)
+      params = hardware_params.merge software_params
+      
+      params[:target] = sketch_name
+      
+      e = ERB.new File.open("#{File.dirname(__FILE__)}/makefile.erb").read
+      
+      File.open("#{RAD_ROOT}/#{sketch_name}/Makefile", "w") do |f|
+        f << e.result(binding)
+      end
+    end
+    
+    def hardware_params
+      return @hardware_params if @hardware_params
+      @hardware_params = {}
+      
+      File.open( "#{RAD_ROOT}/config/hardware.yml" ) do |yf|
+        YAML.load_documents( yf ) do |ydoc|
+          @hardware_params[:serial_port] = ydoc["serial_port"]        
+        end
+      end
+      
+      @hardware_params
+    end
+      
+    def software_params
+      return @software_params if @software_params
+      @software_params = {}
+      
+      File.open( "#{RAD_ROOT}/config/software.yml" ) do |yf|
+        YAML.load_documents( yf ) do |ydoc|
+          @software_params[:arduino_root] = ydoc["arduino_root"]        
+        end
+      end
+      
+      @software_params
+    end
+      
+  end
+end

data/lib/rad/init.rb

@@ -0,0 +1,7 @@
+RAD_ROOT = "#{File.dirname(__FILE__)}/../.." unless defined?(RAD_ROOT)
+
+%w(arduino_sketch.rb 
+   generators/makefile/makefile.rb tasks/rad.rb).each do |path|
+  require File.expand_path("#{RAD_ROOT}/vendor/rad/#{path}")
+end
+