INTRODUCTION

RuBitlash is a Ruby interface with the wonderful Bitlash library for Arduino. Bitlash is an Arduino library that allows direct interaction via serial port with the microcontroller. Thanks to Bill Roy for writing it!

Installation

RuBitlash gem has moved to Gemcutter. In order to install you have two alternative choices:

1. Simply add the Gemcutter repo to your rubygem source list:

    gem sources -a http://gemcutter.org
   

2. Install gemcutter:

    sudo gem install gemcutter
    sudo gem tumble
   

Next, simply install the gem:

sudo gem install rubitlash

USAGE

I'm still writing few docs, but the library itself is quite short. Look at it to know how to use it.

EXAMPLE

require "../lib/rubitlash"

# Instantiate the connection. Verbose mode is false
bl = Bitlash.new("/dev/tty.usbserial-A6004aLr", 57600, false)

# talk() writes its argument to Arduino and reports the reply:
r = bl.talk "print free()"
puts "Bytes free: #{r}"

# variables are accessed as keys of the Bitlash instance:
bl[:a] = 2              # writing
puts "a =  #{bl[:a]}"   # reading
bl.talk "d12=1"         # low-level
sleep 2

# Assigning Bitlash variables:
bl[:f] = bl.free        # commands and functions are mapped as methods
puts "f = #{bl[:f]}"

# Macro example
bl.macro "toggle13", "d13=!d13" # define a new macro
puts "\nMacros:"
bl.ls.each_with_index {|m,i| puts "#{i}:\t#{m}"}
bl.toggle13                     # calls the new macro
sleep 1
# but also:
# bl.run :toggle13        # this runs in background on Arduino
# sleep 1

# Some play
puts "\nStarting cyclic fade"
bl.pinmode(11,1)
t = t0 = Time.now.to_f
while (t - t0) < 5 do
  t = Time.now.to_f
  bl[:a11] = ((1.0 - Math::cos((t - t0)*Math::PI))*100).to_i # 2 Hz cycle
  sleep 0.01
end

bl.close