artoo-arduino 1.0.0.pre → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8a614efd769cd7695db5bb044c4ab4fa6dbdaf6d
-  data.tar.gz: d32fa41b3f9af38945542a34a43eb808e49e67cd
+  metadata.gz: 6cab89e35158f2d7be237a7b0a2cee159953f573
+  data.tar.gz: dcedc720fa195da509d2865bf47bd6b0040ae3a4
 SHA512:
-  metadata.gz: 821c652fde64fa4733212924a7e7690ca464f708ea5b60078df52d9ef0617b88908c0f01e4e1dfecf3be70a23f283b5ad7f27e8a6f30ab708a280fa2fe29de83
-  data.tar.gz: 9d4e51c327cd33b6982382ade0c7564a1b58ad89bd632fb04e116bb7ac8d63f7b39db8922d87a7d9ed6faf794809bb2e45875b1a9833eb9b0959f7559f1b4348
+  metadata.gz: db12d34801fe73ea8af6aad96c6eb225bce96917d1550236ce76fc8f9a3c4788e1eb95854e9a7baa312483dfdddbbccf9686ed9b5a4961eef5c1fbbe07a10213
+  data.tar.gz: 9f338021acab661e86751a82524042a81665fca35b62d50f83c04aed1b4108a22c604450a6a98cfd56c353bfa421bafef805d5f07d7ba2d4723ecfa4de5d4956

data/Gemfile.lock

@@ -1,24 +1,25 @@
 PATH
   remote: .
   specs:
-    artoo-arduino (1.0.0.pre)
-      artoo (~> 1.0.0.pre)
-      hybridgroup-firmata (~> 0.4.0)
+    artoo-arduino (1.0.1)
+      artoo (~> 1.0.0.rc3)
+      hybridgroup-firmata (~> 0.4.2)
 
 GEM
   remote: http://rubygems.org/
   specs:
-    artoo (1.0.0.pre)
-      celluloid (~> 0.14.0)
-      celluloid-io (~> 0.14.0)
+    artoo (1.0.0.rc3)
+      celluloid (~> 0.14.1)
+      celluloid-io (~> 0.14.1)
       multi_json (~> 1.6)
       pry (~> 0.9)
       rake (~> 10.0)
-      reel (~> 0.4.pre)
-    celluloid (0.14.0)
+      reel (~> 0.4.0.pre)
+      thor (~> 0.18.1)
+    celluloid (0.14.1)
       timers (>= 1.0.0)
-    celluloid-io (0.14.0)
-      celluloid (>= 0.13.0)
+    celluloid-io (0.14.1)
+      celluloid (>= 0.14.1)
       nio4r (>= 0.4.5)
     certified (0.1.1)
     coderay (1.0.9)
@@ -27,29 +28,30 @@ GEM
       certified
       http_parser.rb
     http_parser.rb (0.5.3)
-    hybridgroup-firmata (0.4.0)
+    hybridgroup-firmata (0.4.2)
       event_spitter
     metaclass (0.0.1)
-    method_source (0.8.1)
+    method_source (0.8.2)
     minitest (5.0.1)
     minitest-happy (1.0.0)
     mocha (0.14.0)
       metaclass (~> 0.0.1)
-    multi_json (1.7.3)
-    nio4r (0.4.5)
+    multi_json (1.7.9)
+    nio4r (0.5.0)
     pry (0.9.12.2)
       coderay (~> 1.0.5)
       method_source (~> 0.8)
       slop (~> 3.4)
     rack (1.5.2)
-    rake (10.0.4)
+    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.5)
+    slop (3.4.6)
+    thor (0.18.1)
     timers (1.1.0)
     websocket_parser (0.1.4)
       http

data/README.md

@@ -1,6 +1,6 @@
 # Artoo Adaptor For Arduino
 
-This repository contains the Artoo (http://artoo.io/) adaptor and drivers for the Arduino microcontroller using the firmata protocol.
+This repository contains the Artoo (http://artoo.io/) adaptor and drivers for the Arduino microcontroller (http://arduino.cc/) using the Firmata protocol (http://firmata.org).
 
 Artoo is a open source micro-framework for robotics using Ruby.
 
@@ -13,3 +13,78 @@ For more information abut Artoo, check out our repo at https://github.com/hybrid
 ```
 gem install artoo-arduino
 ```
+
+## Using
+
+```ruby
+require 'artoo'
+
+connection :arduino, :adaptor => :firmata, :port => '127.0.0.1:8023'
+device :board
+device :led, :driver => :led, :pin => 13
+
+work do
+  puts "Firmware name #{board.firmware_name}"
+  puts "Firmata version #{board.version}"
+  every 1.second do
+    led.toggle
+  end
+end
+```
+
+## Connecting to Arduino
+
+### OSX
+
+The main steps are:
+- Connect to the Arduino via serial port/USB
+- Use a socket to serial connection to map a TCP socket to the local unix port
+- Connect to the device via Artoo
+
+First plug the Arduino into your computer via the USB/serial port. A dialog box will appear telling you that a new network interface has been detected. Click "Network Preferences...", and when it opens, simply click "Apply".
+
+Once plugged in, use the `artoo connect scan` command to find out your connection info:
+
+```
+$ artoo connect scan
+```
+
+Now you are ready to connect to the Arduino using a socket, such as in this example port 4567:
+
+```
+artoo connect socat 4567 tty.USBABC
+```
+
+### Ubuntu
+
+The main steps are:
+- Connect to the Arduino via serial port/USB
+- Use a socket to serial connection to map a TCP socket to the local unix port
+- Connect to the device via Artoo
+
+First plug the Arduino into your computer via the USB/serial port.
+
+Once plugged in, use the `ls /dev/ttyACM*` command to find out your connection info:
+
+```
+$ ls /dev/ttyACM*
+/dev/ttyACM0
+```
+
+Now you are ready to connect to the Arduino using the socket, in this example port 4567:
+
+```
+artoo connect socat 4567 ttyACM0
+```
+
+### Windows
+
+Someone please fill in the blanks here...
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/artoo-arduino.gemspec

@@ -19,8 +19,8 @@ Gem::Specification.new do |s|
   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.pre'
-  s.add_runtime_dependency 'hybridgroup-firmata', '~> 0.4.0'
+  s.add_runtime_dependency 'artoo', '~> 1.0.0.rc3'
+  s.add_runtime_dependency 'hybridgroup-firmata', '~> 0.4.2'
   s.add_development_dependency 'minitest', '~> 5.0'
   s.add_development_dependency 'minitest-happy'
   s.add_development_dependency 'mocha', '~> 0.14.0'

data/examples/firmata.rb

@@ -1,6 +1,6 @@
 require 'artoo'
 
-connection :firmata, :adaptor => :firmata, :port => '127.0.0.1:8023'
+connection :arduino, :adaptor => :firmata, :port => '127.0.0.1:8023'
 device :board
 device :led, :driver => :led, :pin => 13
 

data/lib/artoo/drivers/button.rb

@@ -30,7 +30,8 @@ module Artoo
 
       def handle_events
         while i = find_event("digital-read-#{pin}") do
-          update(events.slice!(i).data.first)
+          event = events.slice!(i)
+          update(event.data.first) if !event.nil?
         end
       end
 

data/lib/artoo/drivers/led.rb

@@ -5,7 +5,7 @@ module Artoo
     # The LED driver behaviors
     class Led < Driver
 
-      COMMANDS = [:on, :off, :toggle, :brightness].freeze
+      COMMANDS = [:firmware_name, :version, :on, :off, :toggle, :brightness].freeze
 
       # @return [Boolean] True if on
       def is_on?

data/lib/artoo-arduino/version.rb

@@ -1,5 +1,5 @@
 module Artoo
   module Arduino
-    VERSION = '1.0.0.pre'
+    VERSION = '1.0.1'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: artoo-arduino
 version: !ruby/object:Gem::Version
-  version: 1.0.0.pre
+  version: 1.0.1
 platform: ruby
 authors:
 - Ron Evans
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-05-24 00:00:00.000000000 Z
+date: 2013-08-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: artoo
@@ -17,28 +17,28 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 1.0.0.pre
+        version: 1.0.0.rc3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 1.0.0.pre
+        version: 1.0.0.rc3
 - !ruby/object:Gem::Dependency
   name: hybridgroup-firmata
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.4.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.4.2
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -131,9 +131,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>'
+  - - '>='
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: artoo-arduino
 rubygems_version: 2.0.3