rubitlash 0.2

data/README.markdown

@@ -0,0 +1,62 @@
+INTRODUCTION
+============
+RuBitlash is a Ruby interface with the wonderful Bitlash library for Arduino.
+[Bitlash](http://bitlash.net/) is an [Arduino](http://arduino.cc) library that allows direct interaction via serial port with the microcontroller.
+Thanks to Bill Roy for writing it!
+
+INSTALLATION
+============
+First of all you have to [buy or own an Arduino](http://arduino.cc), then install on it Bitlash (v0.95a or later) following the instructions on [Bill Roy's site](http://bitlash.net/).
+
+Then install RuBitlash gem and start playing with it:
+
+    > sudo gem install pbosetti-rubitlash --source=http://gems.github.com
+    
+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
+    

data/example/simple.rb

@@ -0,0 +1,45 @@
+#!/usr/bin/env ruby
+#
+# Created by Paolo Bosetti on 2009-07-02.
+# Copyright (c) 2009 University of Trento. All rights 
+# reserved.
+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

data/lib/rubitlash.rb

@@ -0,0 +1,76 @@
+#!/usr/bin/env ruby
+#
+# Created by Paolo Bosetti on 2009-07-02.
+# Copyright (c) 2009 University of Trento. All rights 
+# reserved.
+require 'rubygems'
+require "serialport"
+require 'expect'
+# sp = SerialPort.new("/dev/tty.usbserial-A6004aLr", 57600, 8, 1, SerialPort::NONE)
+# 
+# sp.expect(/>\s/)
+# sp.puts "print free()"
+# sp.expect(/>\s/)
+# sp.puts "a=10"
+# sp.expect(/>\s/)
+# sp.puts "print a"
+# r = sp.expect(/>\s/)[0]
+# r =~ /\n\r(.*)\n\r/
+# p $1
+# 
+# sp.close
+
+class Bitlash
+  PROMPT = ">\s"
+  COMMANDS = %w[boot help if ls peep print ps rm run stop while]
+  attr_accessor :port_addr
+  attr_reader :port, :baud
+  
+  def initialize(port_addr, baud=57600, verbose=false, name="Bitflash##{(rand*1000).to_i}")
+    @port_addr, @baud, @name = port_addr, baud, name
+    self.verbose = verbose
+    self.open
+  end
+  
+  def open    
+    @port = SerialPort.new(@port_addr, 57600, 8, 1, SerialPort::NONE)
+    @port.expect(/>\s/)
+  end
+  
+  def close; @port.close; end
+  
+  def verbose; $expect_verbose; end
+    
+  def verbose=(bool); $expect_verbose=bool; end
+  
+  def talk(string)
+    @port.puts string
+    reply = @port.expect(/#{PROMPT}/)[0].split("\n\r")[1...-1]
+    return reply.size == 1 ? reply[0] : reply
+  end
+  
+  def [](var)
+    self.talk "print #{var.to_s}"
+  end
+  
+  def []=(var,value)
+    self.talk "#{var.to_s}=#{value.to_i}"
+  end
+  
+  def macro(name,cmd)
+    self.talk "#{name}:=\"#{cmd}\""
+  end
+  
+  # def run(macro); self.talk macro.to_s; end
+  # def background(macro); self.talk "run #{macro}"; end
+  
+  def method_missing(m, *args)
+    if COMMANDS.include? m.to_s
+      cmd = args.size > 0 ? "#{m.to_s} #{args * ','}" : "#{m.to_s}"
+    else
+      cmd = args.size > 0 ? "print #{m.to_s}(#{args * ','})" : "print #{m.to_s}"
+    end
+    self.talk(cmd)
+  end
+  
+end

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification 
+name: rubitlash
+version: !ruby/object:Gem::Version 
+  version: "0.2"
+platform: ruby
+authors: 
+- Paolo Bosetti
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-07-03 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: ruby-serialport
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.6.0
+    version: 
+description: Rubitlash is a Ruby interface with Bitlash for Arduino
+email: paolo.bosetti@me.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.markdown
+- lib/rubitlash.rb
+- example/simple.rb
+has_rdoc: true
+homepage: http://github.com/pbosetti/rubitlash
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --inline-source
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: rubitlash
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 2
+summary: Rubitlash is a Ruby interface with Bitlash for Arduino
+test_files: []
+