pan_tilt 0.0.1 → 0.0.2

data/README.md

@@ -1,3 +1,35 @@
 # Pan and Tilt
 
-Pan and tilt your Arduino connected servos
+Pan and tilt your Arduino connected bracket
+
+## Requirements
+
+* Arduino Uno
+* USB cable
+* Pan/Tilt Bracket from [sparkfun](https://www.sparkfun.com/products/10335)
+* 2x Small Servos
+* Breadboard
+# Pinned wires
+
+## Pan and Tilt bracket
+To create the bracket you can order the parts from [sparkfun](https://www.sparkfun.com/products/10335) and follow their [assembly instructions.](https://www.sparkfun.com/datasheets/Robotics/Other/sensor%20pan%20tilt%20manual.jpg)
+
+## Hardware Installation
+
+* Connect the Pan servo's control wire to Pin 11 (configurable)
+* Connect the Tilt servo's control wire to Pin 9 (configurable)
+* Connect both servos' ground wires to GND
+* Connect both servos' power wires to 5V
+
+## Software Installation
+
+* Connect the Arduino to your computer via USB
+* Install the [Arduino IDE](http://arduino.cc/en/Main/Software)
+* Install this gem
+
+    gem install pan_tilt
+
+## Dino
+
+The [Dino](https://github.com/austinbv/dino) bootstrapper will need to be instaled on the Arduino. You can follow the instructions in [here](https://github.com/austinbv/dino#upload-the-bootstrapper).
+The .ino file referenced should be opened and not copied in.

data/bin/pan_tilt

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
 require 'pan_tilt'
+require 'pan_tilt/command_line'
 
-PanTilt.run
+PanTilt::CommandLine.new.run

data/lib/pan_tilt/command_line.rb

@@ -0,0 +1,49 @@
+module PanTilt
+  class CommandLine
+    def initialize(debug=false)
+      @debug      = debug
+      @board      = Dino::Board.new(Dino::TxRx::Serial.new)
+      @rotor      = PanTilt::Rotor.new @board, @debug
+      @pan_angle  = PanTilt::MIN_PAN_ANGLE
+      @tilt_angle = PanTilt::MIN_TILT_ANGLE
+      @led        = Dino::Components::Led.new(pin: PanTilt::LIVE_LED, board: @board)
+    end
+
+    def run
+      print_instructions
+      @led.send :on
+
+      while key = STDIN.getch
+        case key
+        when PanTilt::ESCAPE
+          @led.send :off
+          break
+        when PanTilt::LEFT_ARROW
+          if @pan_angle > PanTilt::MIN_PAN_ANGLE
+            @pan_angle = @pan_angle - PanTilt::INCREMENT
+          end
+        when PanTilt::RIGHT_ARROW
+          if @pan_angle < PanTilt::MAX_PAN_ANGLE
+            @pan_angle = @pan_angle + PanTilt::INCREMENT
+          end
+        when PanTilt::DOWN_ARROW
+          if @tilt_angle > PanTilt::MIN_TILT_ANGLE
+            @tilt_angle = @tilt_angle - PanTilt::INCREMENT
+          end
+        when PanTilt::UP_ARROW
+          if @tilt_angle < PanTilt::MAX_TILT_ANGLE
+            @tilt_angle = @tilt_angle + PanTilt::INCREMENT
+          end
+        end
+
+        @rotor.rotate @pan_angle, @tilt_angle
+      end
+    end
+
+    private
+
+    def print_instructions
+      puts "Use 'h', 'j', 'k', and 'l' to pan and tilt. Use 'e' to exit"
+    end
+  end
+end

data/lib/pan_tilt/rotor.rb

@@ -0,0 +1,26 @@
+module PanTilt
+  class Rotor
+    attr_reader :board, :tilt_servo, :pan_servo
+
+    def initialize(board, debug=false)
+      @debug      = debug
+
+      @board      = board
+      @tilt_servo = Dino::Components::Servo.new(pin: PanTilt::TILT_PIN,  board: @board)
+      @pan_servo  = Dino::Components::Servo.new(pin: PanTilt::PAN_PIN, board: @board)
+    end
+
+    def rotate(pan_angle, tilt_angle)
+      pan_servo.position = pan_angle
+      tilt_servo.position = tilt_angle
+
+      print_debug "p: #{pan_angle}, t: #{tilt_angle}"
+    end
+
+    private
+
+    def print_debug(string)
+      puts string if @debug
+    end
+  end
+end

data/lib/pan_tilt/version.rb

@@ -1,3 +1,3 @@
 module PanTilt
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/lib/pan_tilt.rb

@@ -3,53 +3,20 @@ require "pan_tilt/version"
 require 'bundler/setup'
 require 'dino'
 require 'io/console'
+require 'pan_tilt/rotor'
 
 module PanTilt
+  TILT_PIN       = 9
+  PAN_PIN        = 11
+  LIVE_LED       = 13
   ESCAPE         = 'e'
   LEFT_ARROW     = 'h'
   RIGHT_ARROW    = 'l'
   UP_ARROW       = 'k'
   DOWN_ARROW     = 'j'
   MAX_TILT_ANGLE = 135
-  MAX_PAN_ANGLE  = 180
+  MAX_PAN_ANGLE  = 160
   MIN_TILT_ANGLE = 15
   MIN_PAN_ANGLE  = 0
   INCREMENT      = 5
-
-  board      = Dino::Board.new(Dino::TxRx::Serial.new)
-  tilt_servo = Dino::Components::Servo.new(pin: 9, board: board)
-  pan_servo  = Dino::Components::Servo.new(pin: 11, board: board)
-
-  pan_angle  = MIN_PAN_ANGLE
-  tilt_angle = MIN_TILT_ANGLE
-
-  def self.run
-    while key = STDIN.getch
-      case key
-      when ESCAPE
-        break
-      when LEFT_ARROW
-        if pan_angle > MIN_PAN_ANGLE
-          pan_angle = pan_angle - INCREMENT
-          pan_servo.position = pan_angle
-        end
-      when RIGHT_ARROW
-        if pan_angle < MAX_PAN_ANGLE
-          pan_angle = pan_angle + INCREMENT
-          pan_servo.position = pan_angle
-        end
-      when DOWN_ARROW
-        if tilt_angle > MIN_TILT_ANGLE
-          tilt_angle = tilt_angle - INCREMENT
-          tilt_servo.position = tilt_angle
-        end
-      when UP_ARROW
-        if tilt_angle < MAX_TILT_ANGLE
-          tilt_angle = tilt_angle + INCREMENT
-          tilt_servo.position = tilt_angle
-        end
-      end
-      puts "p: #{pan_angle}, t: #{tilt_angle}"
-    end
-  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pan_tilt
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -77,6 +77,8 @@ files:
 - lib/du/Dino.h
 - lib/du/du.ino
 - lib/pan_tilt.rb
+- lib/pan_tilt/command_line.rb
+- lib/pan_tilt/rotor.rb
 - lib/pan_tilt/version.rb
 - pan_tilt.gemspec
 homepage: https://github.com/wmernagh/pan_tilt