artoo-wandboard 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 144e672dde9047b7a040ceedf96a5b35da6e28dd
+  data.tar.gz: 048be5401b599e36c06fcc1d8953bcf64888245e
+SHA512:
+  metadata.gz: 37f38d0aaef93a25207c53dd3f7c1f7c01099d85e859f88c31a2e324948b910efc4935fb88960e1e9067b569d03f0cb0b5cb634ad6965dbe385ad6be3a0a7d1f
+  data.tar.gz: 8acdbc16b60589ba7a35de74925c9bda58237687aa218f768822efd7c8ed5e688e3c5598fb39182922ee500290d7099fcfc88594196f3c225daa0f2ab197c3b5

data/.gitignore

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

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--format progress
+--order default

data/.yardopts

@@ -0,0 +1 @@
+--markup markdown

data/Gemfile

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

data/README.md

@@ -0,0 +1,32 @@
+# Artoo Adaptor For Wandboard
+
+This repository contains the [Artoo](http://artoo.io/) adaptor for [Wandboard](http://wandboard.org/).
+
+Artoo is a open source micro-framework for robotics using Ruby.
+
+For more information about Artoo, check out repo at https://github.com/hybridgroup/artoo
+
+## Installing
+
+```
+gem install artoo-wandboard
+```
+
+## Using
+
+```ruby
+require 'artoo'
+
+connection :wandboard, :adaptor => :wandboard
+device :led, :driver => :led, :pin => :JP4_4
+
+work do
+  every 1.second do
+    led.on? ? led.off : led.on
+  end
+end
+```
+
+## Connecting
+
+Run this Gem on Wandboard device itself.

data/Rakefile

@@ -0,0 +1,13 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'yard'
+
+desc 'Default: run specs.'
+task :default => :spec
+
+desc 'Run specs'
+RSpec::Core::RakeTask.new(:spec) do |t|
+end
+
+YARD::Rake::YardocTask.new(:doc) do |t|
+end

data/UNLICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+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 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.
+
+For more information, please refer to <http://unlicense.org/>

data/artoo-wandboard.gemspec

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path('../lib', __FILE__)
+require 'artoo-wandboard/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'artoo-wandboard'
+  s.version     = Artoo::Wandboard::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ['Dāvis']
+  s.email       = ['davispuh@gmail.com']
+  s.homepage    = 'https://github.com/davispuh/artoo-wandboard'
+  s.license     = 'UNLICENSE'
+  s.summary     = %q{Artoo adaptor and driver for Wandboard}
+  s.description = %q{Artoo adaptor and driver for Wandboard}
+
+  s.rubyforge_project = 'artoo-wandboard'
+
+  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.8.0'
+  s.add_development_dependency 'bundler'
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'rspec'
+  s.add_development_dependency 'yard'
+  s.add_development_dependency 'simplecov'
+end

data/lib/artoo-wandboard.rb

@@ -0,0 +1,3 @@
+require 'artoo/adaptors/wandboard'
+require 'artoo/drivers/wandboard'
+require 'artoo-wandboard/version'

data/lib/artoo-wandboard/version.rb

@@ -0,0 +1,5 @@
+module Artoo
+  module Wandboard
+    VERSION = '0.0.1'
+  end
+end

data/lib/artoo/adaptors/wandboard.rb

@@ -0,0 +1,118 @@
+require 'artoo/adaptors/adaptor'
+require 'artoo/adaptors/io'
+
+module Artoo
+  module Adaptors
+    # Connect to a wandboard device
+    # @see device documentation for more information
+    class Wandboard < Adaptor
+      attr_reader :device, :pins, :camera, :uart, :spdif, :i2c1, :i2c2, :ttl, :lvds, :spi
+
+      I2C0 = '/dev/i2c-0'
+      I2C1 = '/dev/i2c-1'
+
+      def self.gpio(bank, number)
+        (bank - 1) * 32 + number
+      end
+
+      include Artoo::Adaptors::IO
+      PINS = {
+               :JP4_4  => gpio(3, 11), #  75
+               :JP4_6  => gpio(3, 27), #  91
+               :JP4_8  => gpio(6, 31), # 191
+               :JP4_10 => gpio(1, 24), #  24
+               :JP4_12 => gpio(7,  8), # 200
+               :JP4_14 => gpio(3, 26), #  90
+               :JP4_16 => gpio(3,  8), #  72
+               :JP4_18 => gpio(4,  5), # 101
+      }
+
+      # Creates a connection with device
+      # @return [Boolean]
+      def connect
+        @pins ||= {}
+        super
+      end
+
+      # Closes connection with device
+      # @return [Boolean]
+      def disconnect
+        @pins.each { |n, p| p.close } if @pins
+        @pins = {}
+        super
+      end
+
+      # Name of device
+      # @return [String]
+      def name
+        'wandboard'
+      end
+
+      # Version of device
+      # @return [String]
+      def version
+        Artoo::Wandboard::VERSION
+      end
+
+      def digital_write(pin, val)
+        pin = wandboard_pin(pin, 'w')
+        pin.digital_write(val)
+      end
+
+      def digital_read(pin)
+        pin = wandboard_pin(pin, 'r')
+        pin.digital_read
+      end
+
+      def i2c1_start(address)
+        @i2c1 = I2c.new(I2C0, address)
+      end
+
+      def i2c1_write(*data)
+        raise 'Not started' unless @i2c1
+        @i2c1.write(*data)
+      end
+
+      def i2c1_read(len)
+        raise 'Not started' unless @i2c1
+        @i2c1.read(len)
+      end
+
+      def i2c2_start(address)
+        @i2c2 = I2c.new(I2C1, address)
+      end
+
+      def i2c2_write(*data)
+        raise 'Not started' unless @i2c2
+        @i2c2.write(*data)
+      end
+
+      def i2c2_read(len)
+        raise 'Not started' unless @i2c2
+        @i2c2.read(len)
+      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
+
+      private
+
+      def translate_pin(pin)
+        PINS.fetch(pin)
+      rescue KeyError
+        raise 'Not a valid pin'
+      end
+
+      def wandboard_pin(pin, mode)
+        raise 'Not connected' unless connected?
+        pin = translate_pin(pin)
+        @pins[pin] = DigitalPin.new(pin, mode) if @pins[pin].nil? or @pins[pin].mode != mode
+        @pins[pin]
+      end
+
+    end
+  end
+end

data/lib/artoo/drivers/wandboard.rb

@@ -0,0 +1,28 @@
+require 'artoo/drivers/driver'
+
+module Artoo
+  module Drivers
+    # The wandboard driver behaviors
+    class Wandboard < Driver
+
+      # Start driver and any required connections
+      def start_driver
+        begin
+          every(interval) do
+            handle_message_events
+          end
+
+          super
+        rescue Exception => e
+          Logger.error "Error starting Wandboard driver!"
+          Logger.error e.message
+          Logger.error e.backtrace.inspect
+        end
+      end
+
+      def handle_message_events
+      end
+
+    end
+  end
+end

data/spec/adaptors/wandboard_adaptor_spec.rb

@@ -0,0 +1,130 @@
+# encoding: UTF-8
+require_relative '../spec_helper'
+
+describe Artoo::Adaptors::Wandboard do
+
+    let(:adaptor) { Artoo::Adaptors::Wandboard.new }
+    let(:pin) { double('DigitalPin') }
+    let(:i2c) { double('I2C') }
+
+    describe 'device info interface' do
+        describe '#name' do
+            it 'should return Wandboard name' do
+                expect(adaptor.name).to eq('wandboard')
+            end
+        end
+
+        describe '#version' do
+           it 'should return Wandboard adapter version' do
+               expect(adaptor.version).to eq(Artoo::Wandboard::VERSION)
+           end
+        end
+    end
+
+    describe 'digital GPIO interface' do
+        describe '#connect' do
+            it 'should connect to Wandboard hardware' do
+                expect(adaptor.connect).to be true
+            end
+        end
+
+        describe '#disconnect' do
+            it 'should disconnect from Wandboard hardware' do
+                adaptor.connect
+                allow(Artoo::Adaptors::IO::DigitalPin).to receive(:new).with(200, 'r') { pin }
+                allow(pin).to receive(:digital_read) { 1 }
+                expect(pin).to receive(:close)
+                adaptor.digital_read(:JP4_12)
+                expect(adaptor.disconnect).to be true
+            end
+        end
+
+        describe '#digital_read' do
+            it 'should read from :JP4_12 pin' do
+                adaptor.connect
+                expect(Artoo::Adaptors::IO::DigitalPin).to receive(:new).with(200, 'r') { pin }
+                allow(pin).to receive(:mode) { 'r' }
+                expect(pin).to receive(:digital_read) { 1 }
+                expect(adaptor.digital_read(:JP4_12)).to eq(1)
+            end
+
+            it 'should raise exception if not connected' do
+                expect { adaptor.digital_read(:JP4_8) }.to raise_error('Not connected')
+            end
+
+            it 'should raise exception if invalid pin' do
+                adaptor.connect
+                expect { adaptor.digital_read(:JP4_80) }.to raise_error('Not a valid pin')
+            end
+        end
+
+        describe '#digital_write' do
+            it 'should write to :JP4_8 pin' do
+                adaptor.connect
+                expect(Artoo::Adaptors::IO::DigitalPin).to receive(:new).with(191, 'w') { pin }
+                allow(pin).to receive(:mode) { 'w' }
+                expect(pin).to receive(:digital_write).with(1)
+                expect(pin).to receive(:digital_write).with(0)
+                adaptor.digital_write(:JP4_8, 1)
+                adaptor.digital_write(:JP4_8, 0)
+            end
+
+            it 'should raise exception if not connected' do
+                expect { adaptor.digital_write(:JP4_12, 1) }.to raise_error('Not connected')
+            end
+        end
+    end
+
+    describe 'i2c interface' do
+        describe '#i2c1_start' do
+            it 'should start /dev/i2c-0 at address 0x50' do
+                expect(Artoo::Adaptors::IO::I2c).to receive(:new).with('/dev/i2c-0', 0x50) { i2c }
+                expect(adaptor.i2c1_start(0x50)).to be i2c
+            end
+        end
+
+        describe '#i2c1_read' do
+            it 'should read i2c-1' do
+                allow(Artoo::Adaptors::IO::I2c).to receive(:new) { i2c }
+                adaptor.i2c1_start(0x50)
+                expect(i2c).to receive(:read).with(3) { [0x00, 0x01, 0x02] }
+                expect(adaptor.i2c1_read(3)).to eq([0x00, 0x01, 0x02])
+            end
+        end
+
+        describe '#i2c1_write' do
+            it 'should write i2c-1' do
+                allow(Artoo::Adaptors::IO::I2c).to receive(:new) { i2c }
+                adaptor.i2c1_start(0x50)
+                expect(i2c).to receive(:write).with(0x00, 0x01, 0x02) { true }
+                expect(adaptor.i2c1_write(0x00, 0x01, 0x02)).to be true
+            end
+        end
+
+        describe '#i2c2_start' do
+            it 'should start /dev/i2c-1 at address 0x50' do
+                expect(Artoo::Adaptors::IO::I2c).to receive(:new).with('/dev/i2c-1', 0x50) { i2c }
+                expect(adaptor.i2c2_start(0x50)).to be i2c
+            end
+        end
+
+        describe '#i2c2_read' do
+            it 'should read i2c-2' do
+                allow(Artoo::Adaptors::IO::I2c).to receive(:new) { i2c }
+                adaptor.i2c2_start(0x50)
+                expect(i2c).to receive(:read).with(3) { [0x00, 0x01, 0x02] }
+                expect(adaptor.i2c2_read(3)).to eq([0x00, 0x01, 0x02])
+            end
+        end
+
+        describe '#i2c2_write' do
+            it 'should write i2c-2' do
+                allow(Artoo::Adaptors::IO::I2c).to receive(:new) { i2c }
+                adaptor.i2c2_start(0x50)
+                expect(i2c).to receive(:write).with(0x00, 0x01, 0x02) { true }
+                expect(adaptor.i2c2_write(0x00, 0x01, 0x02)).to be true
+            end
+        end
+    end
+
+end

data/spec/drivers/wandboard_driver_spec.rb

@@ -0,0 +1,12 @@
+# encoding: UTF-8
+require_relative '../spec_helper'
+
+describe Artoo::Drivers::Wandboard do
+
+    let(:driver) { Artoo::Drivers::Wandboard.new }
+
+    it '#start_driver' do
+        expect {  driver.start_driver }.to_not raise_error
+    end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,20 @@
+# encoding: UTF-8
+require 'simplecov'
+require 'artoo/robot'
+
+Celluloid.logger = nil
+Celluloid.shutdown
+Celluloid.boot
+
+RSpec.configure do |config|
+    config.expect_with :rspec do |c|
+        c.syntax = :expect
+    end
+    config.mock_with :rspec do |mocks|
+        mocks.verify_partial_doubles = true
+    end
+end
+
+SimpleCov.start
+
+require 'artoo-wandboard'

metadata

@@ -0,0 +1,144 @@
+--- !ruby/object:Gem::Specification
+name: artoo-wandboard
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Dāvis
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-11-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: artoo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.8.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.8.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Artoo adaptor and driver for Wandboard
+email:
+- davispuh@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".yardopts"
+- Gemfile
+- README.md
+- Rakefile
+- UNLICENSE
+- artoo-wandboard.gemspec
+- lib/artoo-wandboard.rb
+- lib/artoo-wandboard/version.rb
+- lib/artoo/adaptors/wandboard.rb
+- lib/artoo/drivers/wandboard.rb
+- spec/adaptors/wandboard_adaptor_spec.rb
+- spec/drivers/wandboard_driver_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/davispuh/artoo-wandboard
+licenses:
+- UNLICENSE
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: artoo-wandboard
+rubygems_version: 2.4.2
+signing_key: 
+specification_version: 4
+summary: Artoo adaptor and driver for Wandboard
+test_files: []
+has_rdoc: