dino 0.8

data/.gitignore

@@ -0,0 +1,21 @@
+*.gem
+*.rbc
+.*.swp
+.*.swo
+junk.*
+.idea/*
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rvmrc

@@ -0,0 +1 @@
+rvm use ruby-1.9.3@dino --create

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in dino.gemspec
+gemspec
+
+gem 'rspec'

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Austin
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,14 @@
+# Welcome to Dino
+
+## Get started in no time
+Dino was designed to help you start working with your Arduino in minutes.
+
+> * Burn the file `src/du.ino` to your Arduino
+> ** You can do this in the [Arduino IDE](http://www.arduino.cc/en/Main/software)
+> * Plug in your Arduino and wire the led like in `examples/led/led.png`
+> * Run `ruby example/led/led.rb`
+
+By now you should be blinking away
+
+
+Take a look in the example directory for more information

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/dino.gemspec

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/dino/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Austinbv"]
+  gem.email         = ["austinbv@gmail.com"]
+  gem.description   = %q{A utility library for interfacting with an Arduino.
+  Designed for control, expansion, and with love.}
+  gem.summary       = %q{Control your arduino through a serial port}
+  gem.homepage      = 'https://github.com/austinbv/dino'
+
+  gem.files         = `git ls-files`.split($\)
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "dino"
+  gem.require_paths = ["lib"]
+  gem.version       = Dino::VERSION
+
+  gem.add_dependency 'serialport'
+end

data/examples/button/button.rb

@@ -0,0 +1,23 @@
+#
+# This is an example of how to use the button class
+# You must register helpers and have the main thread
+# sleep or in someway keep running or your program
+# will exit before any callbacks can be called
+#
+require '../lib/dino'
+
+board = Dino::Board.new(Dino::TxRx.new)
+button = Dino::Components::Button.new(pin: 2, board: board)
+
+button_down = Proc.new do
+  puts "button down"
+end
+
+button_up = Proc.new do
+  puts "button up"
+end
+
+button.down(button_down)
+button.up(button_up)
+
+sleep

data/examples/ir_receiver.rb

@@ -0,0 +1,33 @@
+#
+# This is an example of how to use the button class
+# You must register helpers and have the main thread
+# sleep or in someway keep running or your program
+# will exit before any callbacks can be called
+#
+require '../lib/dino'
+
+board = Dino::Board.new(Dino::TxRx.new)
+ir = Dino::Components::IrReceiver.new(pin: 2, board: board)
+led = Dino::Components::Led.new(pin: 13, board: board)
+
+n = 0
+
+flash = Proc.new do
+  n += 1
+  puts "light flash #{n}"
+end
+
+sleep 2
+Thread.new do
+  loop do
+    led.on
+    sleep 0.01
+    led.off
+    sleep 0.01
+  end
+end
+
+sleep 4
+ir.flash(flash)
+
+sleep

data/examples/led/led.rb

@@ -0,0 +1,14 @@
+#
+# This is a simple example to blink an led
+# every half a second
+#
+
+require '../lib/dino'
+
+board = Dino::Board.new(Dino::TxRx.new)
+led = Dino::Components::Led.new(pin: 13, board: board)
+
+[:on, :off].cycle do |switch|
+  led.send(switch)
+  sleep 0.5
+end

data/examples/potentiometer.rb

@@ -0,0 +1,26 @@
+#
+# This is an example of how to use the sensor class
+# with a potentiometer to control the flash speed of an
+# LED. The set_delay callback reads from the potentiometer
+# and changes the sleep delay for the LED on/off cycle.  
+#  
+
+require '../lib/dino'
+
+board = Dino::Board.new(Dino::TxRx.new)
+led = Dino::Components::Led.new(pin: 13, board: board)
+potentiometer = Dino::Components::Sensor.new(pin: 'A0', board: board)
+
+delay = 500.0
+
+set_delay = Proc.new do |data|
+  puts "DATA: #{delay = data.to_i}"
+end
+
+potentiometer.when_data_received(set_delay)
+
+[:on, :off].cycle do |switch|
+  puts "DELAY: #{seconds = (delay / 1000.0)}"
+  led.send(switch)
+  sleep seconds
+end

data/examples/rgb_led.rb

@@ -0,0 +1,39 @@
+#
+# This is a simple example to blink an led
+# every half a second
+#
+
+require '../lib/dino'
+
+board = Dino::Board.new(Dino::TxRx.new)
+led = Dino::Components::RgbLed.new(pins: {red: 11, green: 10, blue: 9}, board: board)
+potentiometer = Dino::Components::Sensor.new(pin: 'A0', board: board)
+
+
+delay = 500.0
+
+set_delay = Proc.new do |data|
+  sleep 0.5
+  puts "DATA: #{delay = data.to_i}"
+end
+
+potentiometer.when_data_received(set_delay)
+
+  sleep(2)
+loop do
+  puts "DELAY: #{seconds = (delay / 1000.0)}"
+  p 'red'
+  led.red
+  sleep(seconds)
+  led.blue
+  p 'blue'
+  sleep(seconds)
+  led.green
+  p 'green'
+  sleep(seconds)
+end
+#led.color(224, 27, 106)
+#sleep(1)
+#led.color(255, 149, 7)
+#sleep(1)
+#led.off

data/examples/sensor.rb

@@ -0,0 +1,18 @@
+#
+# This is an example of how to use the sensor class
+# You must register data callbacks and have the main thread
+# sleep or in someway keep running or your program
+# will exit before any callbacks can be called
+#
+require '../lib/dino'
+
+board = Dino::Board.new(Dino::TxRx.new)
+sensor = Dino::Components::Sensor.new(pin: 'A0', board: board)
+
+on_data = Proc.new do |data|
+    puts data
+end
+
+sensor.when_data_received(on_data)
+
+sleep

data/examples/servo.rb

@@ -0,0 +1,16 @@
+#
+# This is an example of how to use the button class
+# You must register helpers and have the main thread
+# sleep or in someway keep running or your program
+# will exit before any callbacks can be called
+#
+$: << File.expand_path('../../lib', __FILE__)
+require '../lib/dino'
+
+board = Dino::Board.new(Dino::TxRx.new)
+servo = Dino::Components::Servo.new(pin: 9, board: board)
+
+loop do
+  servo.position += 9
+  sleep 0.5
+end

data/examples/stepper.rb

@@ -0,0 +1,18 @@
+#
+# This is a simple example to move a stepper motor using the sparkfun easydriver shield: https://www.sparkfun.com/products/10267?
+#
+
+require '../lib/dino'
+
+board = Dino::Board.new(Dino::TxRx.new)
+stepper = Dino::Components::Stepper.new(board: board, pins: { step: 10, direction: 8 })
+
+  1600.times do
+    stepper.step_cc
+    sleep 0.001
+  end
+
+  1600.times do
+    stepper.step_cw
+    sleep 0.001
+  end

data/lib/dino.rb

@@ -0,0 +1,15 @@
+require 'dino/version'
+require 'dino/tx_rx'
+require 'dino/board'
+
+require 'dino/components/base_component'
+require 'dino/components/led'
+require 'dino/components/button'
+require 'dino/components/sensor'
+require 'dino/components/rgb_led'
+require 'dino/components/servo'
+require 'dino/components/stepper'
+require 'dino/components/ir_receiver'
+
+module Dino
+end

data/lib/dino/board.rb

@@ -0,0 +1,114 @@
+module Dino
+  class Board
+    attr_reader :digital_hardware, :analog_hardware
+    LOW, HIGH = 000, 255
+
+    def initialize(io)
+      @io, @digital_hardware, @analog_hardware = io, [], []
+      io.add_observer(self)
+      send_clearing_bytes
+      start_heart_beat
+    end
+
+    def update(pin, msg)
+      (@digital_hardware + @analog_hardware).each do |part|
+        part.update(msg) if normalize_pin(pin) == normalize_pin(part.pin)
+      end
+    end
+
+    def add_digital_hardware(part)
+      set_pin_mode(part.pin, :in)
+      @digital_hardware << part
+    end
+
+    def remove_digital_hardware(part)
+      @digital_hardware.delete(part)
+    end
+
+    def add_analog_hardware(part)
+      set_pin_mode(part.pin, :in)
+      @analog_hardware << part
+    end
+
+    def remove_analog_hardware(part)
+      @analog_hardware.delete(part)
+    end
+
+    def start_read
+      @io.read
+    end
+
+    def stop_read
+      @io.close_read
+    end
+
+    def write(msg, opts = {})
+      formatted_msg = opts.delete(:no_wrap) ? msg : "!#{msg}."
+      @io.write(formatted_msg)
+    end
+
+    def digital_write(pin, value)
+      pin, value = normalize_pin(pin), normalize_value(value)
+      write("01#{pin}#{value}")
+    end
+
+    def digital_read(pin)
+      pin, value = normalize_pin(pin), normalize_value(0)
+      write("02#{pin}#{value}")
+    end
+
+    def analog_write(pin, value)
+      pin, value = normalize_pin(pin), normalize_value(value)
+      write("03#{pin}#{value}")
+    end
+
+    def analog_read(pin)
+      pin, value = normalize_pin(pin), normalize_value(0)
+      write("04#{pin}#{value}")
+    end
+
+    def set_pin_mode(pin, mode)
+      pin, value = normalize_pin(pin), normalize_value(mode == :out ? 1 : 0)
+      write("00#{pin}#{value}")
+    end
+
+    def set_debug(on_off)
+      pin, value = normalize_pin(0), normalize_value(on_off == :on ? 1 : 0)
+      write("99#{pin}#{value}")
+    end
+
+    def normalize_pin(pin)
+      raise Exception.new('pins can only be two digits') if pin.to_s.length > 2
+      normalize(pin, 2)
+    end
+
+    def normalize_value(value)
+      raise Exception.new('values are limited to three digits') if value.to_s.length > 3
+      normalize(value, 3)
+    end
+
+    private
+
+    def start_heart_beat
+      @heart_beat ||= Thread.new do
+        loop do
+          sleep 0.005
+          @digital_hardware.each do |part|
+            digital_read(part.pin)
+          end
+          @analog_hardware.each do |part|
+            analog_read(part.pin)
+          end
+        end
+      end
+    end
+
+    def normalize(pin, spaces)
+      pin.to_s.rjust(spaces, '0')
+    end
+
+    def send_clearing_bytes
+      write('00000000', no_wrap: true)
+    end
+  end
+end

data/lib/dino/components/base_component.rb

@@ -0,0 +1,33 @@
+module Dino
+  module Components
+    class BaseComponent
+      attr_reader :pin, :board
+      alias :pins :pin
+
+      def initialize(options={})
+        self.pin = options[:pin] || options[:pins]
+        self.board = options[:board]
+
+        raise 'board and pin or pins are required for a component' if self.board.nil? || self.pin.nil?
+      end
+
+      protected
+
+      attr_writer :pin, :board
+      alias :pins= :pin=
+
+      def digital_write(value, pin = self.pin)
+        self.board.digital_write(pin, value)
+      end
+
+      def analog_write(value, pin = self.pin)
+        self.board.analog_write(pin, value)
+      end
+
+      def set_pin_mode(mode, pin = self.pin)
+        self.board.set_pin_mode(pin, mode)
+      end
+    end
+  end
+end
+