artoo-raspi 0.1.0

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in artoo-raspi.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,58 @@
+PATH
+  remote: .
+  specs:
+    artoo-raspi (0.1.0)
+      artoo (~> 1.0.0.rc4)
+      pi_piper
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    artoo (1.0.0.rc4)
+      celluloid (~> 0.14.1)
+      celluloid-io (~> 0.14.1)
+      multi_json (~> 1.6)
+      pry (~> 0.9)
+      rake (~> 10.0)
+      reel (~> 0.4.0.pre)
+      thor (~> 0.18.1)
+    celluloid (0.14.1)
+      timers (>= 1.0.0)
+    celluloid-io (0.14.1)
+      celluloid (>= 0.14.1)
+      nio4r (>= 0.4.5)
+    certified (0.1.1)
+    coderay (1.0.9)
+    ffi (1.9.0)
+    http (0.4.0)
+      certified
+      http_parser.rb
+    http_parser.rb (0.5.3)
+    method_source (0.8.2)
+    multi_json (1.7.9)
+    nio4r (0.5.0)
+    pi_piper (1.3.1)
+      ffi
+    pry (0.9.12.2)
+      coderay (~> 1.0.5)
+      method_source (~> 0.8)
+      slop (~> 3.4)
+    rack (1.5.2)
+    rake (10.1.0)
+    reel (0.4.0.pre)
+      celluloid-io (>= 0.8.0)
+      http (>= 0.2.0)
+      http_parser.rb (>= 0.5.3)
+      rack (>= 1.4.0)
+      websocket_parser (>= 0.1.2)
+    slop (3.4.6)
+    thor (0.18.1)
+    timers (1.1.0)
+    websocket_parser (0.1.4)
+      http
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  artoo-raspi!

data/LICENSE

@@ -0,0 +1,13 @@
+Copyright (c) 2013 The Hybrid Group
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/README.md

@@ -0,0 +1,60 @@
+# Artoo Adaptor For Raspberry Pi
+
+This repository contains the Artoo (http://artoo.io/) adaptor for the Raspberry Pi (http://www.raspberrypi.org/) tiny Linux computer's General Purpose Input/Output (GPIO).
+
+Artoo is a open source micro-framework for robotics using Ruby.
+
+For more information about Artoo, check out our repo at https://github.com/hybridgroup/artoo
+
+This gem makes extensive us the the pi_piper gem (https://github.com/jwhitehorn/pi_piper) thanks to @jwhitehorn
+
+## Installing On Raspberry Pi
+
+If you do not already have Ruby installed, first you'll need to:
+
+```
+sudo apt-get install ruby ruby1.9.1-dev
+```
+
+Despite one of the packages being titled "ruby1.9.1-dev", the above command will install Ruby 1.9.3 (as of January 2013) and the Ruby dev tools.
+
+Then install the artoo-raspi gem:
+
+```
+sudo gem install artoo-raspi
+```
+
+## Using
+
+```ruby
+require 'artoo'
+
+connection :raspi, :adaptor => :raspi
+device :led, :driver => :raspi_pin, :pin => 17, :direction => :out
+
+work do
+  every 1.second do
+    led.toggle
+  end
+end
+
+```
+
+To run the examples, requires sudo access on the Raspberry Pi:
+
+```
+sudo ruby examples/raspi_led.rb
+```
+
+## Connecting to Raspberry Pi GPIO
+
+This gem only works on a real Raspberry Pi. Do not bother trying on any other kind of computer it will not work. Also note you will need to connect actual circuits to the Raspberry Pi's GPIO pins. Here is an example of wiring the circuits for the GPIO to connect a single LED:
+
+![GPIO LED Circuit Example](https://github.com/jwhitehorn/pi_piper/blob/master/examples/morse_code/circuit.png)
+
+To add the button used in the example, add a momentary contact switch to the circuit.
+
+![GPIO Switch Circuit Example](https://github.com/jwhitehorn/pi_piper/blob/master/examples/simple_switch/circuit.png)
+
+
+

data/Rakefile

@@ -0,0 +1,10 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.pattern = "test/**/*_test.rb"
+end
+
+task :default => :test

data/artoo-raspi.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "artoo-raspi/version"
+
+Gem::Specification.new do |s|
+  s.name        = "artoo-raspi"
+  s.version     = Artoo::Raspi::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Ron Evans"]
+  s.email       = ["artoo@hybridgroup.com"]
+  s.homepage    = "https://github.com/hybridgroup/artoo-raspi"
+  s.summary     = %q{Artoo adaptor and driver for Raspberry Pi}
+  s.description = %q{Artoo adaptor and driver for Raspberry Pi GPIO}
+  s.license     = 'Apache 2.0'
+
+  s.rubyforge_project = "artoo-raspi"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_runtime_dependency 'artoo', '~> 1.0.0.rc4'
+  s.add_runtime_dependency 'pi_piper'
+  # TODO: add your development dependencies here
+  # EXAMPLE:
+  # s.add_development_dependency 'minitest', '~> 5.0'
+  # s.add_development_dependency 'minitest-happy'
+  # s.add_development_dependency 'mocha', '~> 0.14.0'
+end

data/examples/raspi_led.rb

@@ -0,0 +1,10 @@
+require 'artoo'
+
+connection :raspi, :adaptor => :raspi
+device :led, :driver => :raspi_pin, :pin => 17, :direction => :out
+
+work do
+  every 1.second do
+    led.toggle
+  end
+end

data/examples/raspi_led_and_button.rb

@@ -0,0 +1,9 @@
+require 'artoo'
+
+connection :raspi, :adaptor => :raspi
+device :led, :driver => :raspi_pin, :pin => 17, :direction => :out
+device :button, :driver => :raspi_pin, :pin => 18, :direction => :in
+
+work do
+  on button, :push => proc {led.toggle}
+end

data/lib/artoo-raspi.rb

@@ -0,0 +1,3 @@
+require 'lib/artoo/adaptors/raspi'
+require 'lib/artoo/drivers/raspi_pin'
+require 'lib/artoo-raspi/version'

data/lib/artoo-raspi/version.rb

@@ -0,0 +1,5 @@
+module Artoo
+  module Raspi
+    VERSION = '0.1.0'
+  end
+end

data/lib/artoo/adaptors/raspi.rb

@@ -0,0 +1,37 @@
+require 'artoo/adaptors/adaptor'
+
+module Artoo
+  module Adaptors
+    # Connect to a Raspberry Pi GPIO
+    # @see device documentation for more information
+    class Raspi < Adaptor
+      finalizer :finalize
+      attr_reader :device
+
+      # Closes connection with device if connected
+      # @return [Boolean]
+      def finalize
+      end
+
+      # Creates a connection with device
+      # @return [Boolean]
+      def connect
+        require 'pi_piper' unless defined?(::PiPiper)
+
+        super
+      end
+
+      # Closes connection with device
+      # @return [Boolean]
+      def disconnect
+        super
+      end
+
+      # Uses method missing to call device actions
+      # @see device documentation
+      def method_missing(method_name, *arguments, &block)
+        device.send(method_name, *arguments, &block)
+      end
+    end
+  end
+end

data/lib/artoo/drivers/raspi_pin.rb

@@ -0,0 +1,67 @@
+require 'artoo/drivers/driver'
+
+module Artoo
+  module Drivers
+    # Raspberry Pi pin driver behaviors
+    class RaspiPin < Driver
+      COMMANDS = [:on?, :on, :off?, :off, :toggle].freeze
+
+      attr_reader :raspi_pin, :direction, :value
+
+      def initialize(params)
+        super
+
+        @direction = params[:additional_params][:direction]
+        @value = false
+      end
+
+      # Start driver and any required connections
+      def start_driver
+        begin
+          every(interval) do
+            handle_message_events
+          end
+
+          @raspi_pin = PiPiper::Pin.new(:pin => pin, :direction => direction)
+
+          super
+        rescue Exception => e
+          Logger.error "Error starting Raspberry Pi pin driver!"
+          Logger.error e.message
+          Logger.error e.backtrace.inspect
+        end
+      end
+
+      def handle_message_events
+        return if raspi_pin.nil?
+        raspi_pin.read
+        if raspi_pin.changed?
+          publish(event_topic_name(raspi_pin.value == 0 ? "push" : "release"))
+          publish(event_topic_name("update"), "pin", raspi_pin.value)
+        end
+      end
+
+      def toggle
+        off? ? on : off
+      end
+
+      def on
+        @value = true
+        raspi_pin.on
+      end
+
+      def on?
+        value == true
+      end
+
+      def off
+        @value = false
+        raspi_pin.off
+      end
+
+      def off?
+        !on?
+      end
+    end
+  end
+end

data/test/adaptors/raspi_adaptor_test.rb

@@ -0,0 +1,4 @@
+require File.expand_path(File.dirname(__FILE__) + "/../test_helper")
+require 'artoo/adaptors/raspi'
+
+# TODO: test for your adaptor goes here...

data/test/drivers/raspi_pin_driver_test.rb

@@ -0,0 +1,4 @@
+require File.expand_path(File.dirname(__FILE__) + "/../test_helper")
+require 'artoo/drivers/raspi_pin'
+
+# TODO: test for your driver goes here...

data/test/test_helper.rb

@@ -0,0 +1,5 @@
+require 'artoo/robot'
+
+require 'minitest/autorun'
+
+Celluloid.logger = nil

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification
+name: artoo-raspi
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Ron Evans
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-08-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: artoo
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0.rc4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0.rc4
+- !ruby/object:Gem::Dependency
+  name: pi_piper
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Artoo adaptor and driver for Raspberry Pi GPIO
+email:
+- artoo@hybridgroup.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- artoo-raspi.gemspec
+- examples/raspi_led.rb
+- examples/raspi_led_and_button.rb
+- lib/artoo-raspi.rb
+- lib/artoo-raspi/version.rb
+- lib/artoo/adaptors/raspi.rb
+- lib/artoo/drivers/raspi_pin.rb
+- test/adaptors/raspi_adaptor_test.rb
+- test/drivers/raspi_pin_driver_test.rb
+- test/test_helper.rb
+homepage: https://github.com/hybridgroup/artoo-raspi
+licenses:
+- Apache 2.0
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 3220213707000459885
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 3220213707000459885
+requirements: []
+rubyforge_project: artoo-raspi
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Artoo adaptor and driver for Raspberry Pi
+test_files: []