cheeky-pi 0.0.1

data/README.md

@@ -0,0 +1,90 @@
+# CheekyPi
+
+EventMachine friendly library for working with the DreamCheeky Webmail Notifier.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'cheeky-pi'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install cheeky-pi
+
+## Usage
+
+```ruby
+require 'cheeky-pi'
+require 'eventmachine'
+
+light = CheekyPi.new.light
+
+EventMachine.run {
+  pi.light.color([0, 255, 0])
+}
+```
+
+### Multiple lights:
+
+```ruby
+light1 = CheekyPi.lights[0]
+light2 = CheekyPi.lights[1]
+...
+light1.failure
+light2.success
+```
+
+### Simple animation
+
+```ruby
+CheekyPi.new.light.transition! [255, 0, 255]
+```
+
+### Throb animation
+
+```ruby
+#Perpetual throb animation, with a 10 second cycle period
+CheekyPi.new.light.throb! [0, 255, 0], [0, 0, 255], 10
+```
+
+##$ Fun with promises
+
+```ruby
+light = CheekyPi.new.light
+light.transition!(255, 0, 255).then {
+  puts 'animation complete'
+  light.throb! 10, [255, 0, 255], [255, 255, 255]
+}
+```
+
+### Build lights
+
+```ruby
+case some_build_status
+  when :build
+    light.building
+  when :failed
+    light.failure
+  when :successful
+    light.success
+  else
+    light.off
+end
+```
+
+## Related gems:
+
+ * [blinky](https://github.com/perryn/blinky)
+ * [cheeky_dreams](https://github.com/simojenki/cheeky-dreams)
+
+## Why?
+
+My raspberry pi could not interact with the webmail notifier via libusb, so this gem depends instead on
+`/sys/devices/*/red|green|blue` courtesy of the usbled driver.
+
+Additionally, I wanted (non-blocking) animation for use with a build monitoring tool.

data/lib/cheeky-pi.rb

@@ -0,0 +1,35 @@
+$:.unshift(File.dirname(__FILE__))
+require 'cheeky-pi/version'
+require 'cheeky-pi/factory'
+
+module CheekyPi
+  COLOR = {
+    off:    [0, 0, 0],
+    black:  [0, 0, 0],
+    red:    [255, 0, 0],
+    green:  [0, 255, 0],
+    blue:   [0, 0, 255],
+    yellow: [255,255,0],
+    aqua:   [0,255,255],
+    purple: [255,0,255],
+    white:  [255,255,255],
+  }
+
+  def self.new
+    CheekyPi.new
+  end
+
+  class CheekyPi
+    def initialize
+      @lights = Factory.find_lights
+    end
+
+    def lights
+      @lights
+    end
+
+    def light
+      @lights.first
+    end
+  end
+end

data/lib/cheeky-pi/animation/base.rb

@@ -0,0 +1,77 @@
+require 'eventmachine'
+require 'em-promise'
+
+module CheekyPi
+  module Animation
+
+    class Base
+
+      TICKRATE = 0.1
+
+      def initialize(duration, light, options={})
+        @duration = duration
+        @light = light
+
+        @deferred = EventMachine::Q.defer
+        promise.then { handle_complete }
+
+        start
+      end
+
+      def handle_complete
+      end
+
+      def promise
+        @promise ||= @deferred.promise
+      end
+
+      def start
+        @timer.cancel if @timer
+        @start_time = Time.now.to_f
+        @timer = EventMachine.add_periodic_timer(TICKRATE) { tick }
+
+        self
+      end
+
+      def percent
+        return 0 if @duration.nil?
+        (Time.now.to_f - @start_time) / @duration
+      end
+
+      def safe_percent
+        [percent, 1].min
+      end
+
+      def halt
+        @timer.cancel
+        @deferred.reject
+
+        self
+      end
+
+      def complete
+        @timer.cancel
+        @deferred.resolve
+
+        self
+      end
+
+      def tick
+        complete if percent >=1
+        animate
+      end
+
+      def animate
+      end
+
+      #convert [0-0.5-1] to [0-1-0]
+      def triangle(percent)
+        (0.5 - (percent % 1 - 0.5).abs) * 2
+      end
+
+      def sine(percent)
+        Math::sin(percent *  2 * Math::PI - 0.5 * Math::PI) * 0.5 + 0.5
+      end
+    end
+  end
+end

data/lib/cheeky-pi/animation/cycle.rb

@@ -0,0 +1,20 @@
+require 'cheeky-pi/animation/base'
+
+module CheekyPi
+  module Animation
+    class Cycle < Base
+
+      def initialize(duration, light, options={})
+        super
+
+        @to = options[:to]
+        @from = options[:from]
+        @period = options[:period]
+      end
+
+      def cycle_percent
+        ((Time.now.to_f - @start_time) % @period) / @period
+      end
+    end
+  end
+end

data/lib/cheeky-pi/animation/fade.rb

@@ -0,0 +1,23 @@
+require 'cheeky-pi/animation/base'
+
+module CheekyPi
+  module Animation
+    class Fade < Base
+
+      def initialize(duration, light, options={})
+        super
+
+        @to = options[:to]
+        @from = options[:from]
+      end
+
+      def handle_complete
+        @light.set @to
+      end
+
+      def animate
+        @light.set(@from.blend(@to, safe_percent))
+      end
+    end
+  end
+end

data/lib/cheeky-pi/animation/throb.rb

@@ -0,0 +1,22 @@
+require 'cheeky-pi/animation/cycle'
+
+module CheekyPi
+  module Animation
+    class Throb < Cycle
+
+      def initialize(duration, light, options={})
+        super
+
+        @to = options[:to]
+        @from = options[:from]
+        @wave = options[:type] || :triangle
+      end
+
+
+      def animate
+        blend_percent = send(@wave, cycle_percent)
+        @light.set(@from.blend(@to, blend_percent))
+      end
+    end
+  end
+end

data/lib/cheeky-pi/color.rb

@@ -0,0 +1,34 @@
+module CheekyPi
+  class Color < Struct.new(:r, :g, :b)
+
+    # Lighten color by percent
+    def lighten(percent)
+      blend(self.class.create(COLOR[:white]), percent)
+    end
+
+    # Darken a color by a percent
+    def darken(percent)
+      blend(self.class.create(COLOR[:off]), percent)
+    end
+
+    # Returns color distance (maximum of rgb distances individually) from a target color
+    def distance(color)
+      [(self.r - color.r).abs, (self.g - color.g).abs, (self.b - color.b).abs].max
+    end
+
+    # Blend with another color
+    def blend(color, opacity)
+      self.class.new(
+        self.r * (1 - opacity) + color.r * opacity,
+        self.g * (1 - opacity) + color.g * opacity,
+        self.b * (1 - opacity) + color.b * opacity
+      )
+    end
+
+    # Create a new color from [r,g,b] array
+    def self.create(rgb)
+      new *rgb
+    end
+  end
+end
+

data/lib/cheeky-pi/factory.rb

@@ -0,0 +1,10 @@
+require 'cheeky-pi/light'
+
+module CheekyPi
+  module Factory
+    def self.find_lights
+      reds = Dir.glob('/sys/devices/**/red')
+      reds.collect {|red| Light.new(File.dirname(red)) }
+    end
+  end
+end

data/lib/cheeky-pi/light.rb

@@ -0,0 +1,99 @@
+require 'cheeky-pi/light_interface'
+require 'cheeky-pi/color'
+require 'cheeky-pi/animation/fade'
+require 'cheeky-pi/animation/throb'
+
+module CheekyPi
+  class Light
+    MAX = 90
+
+    # Initialize with a path and optional color
+    def initialize(path)
+      @light = LightInterface.new(path)
+      @last_color = @light.fetch
+    end
+
+    def animation
+      @animation
+    end
+
+    def animation=(new_animation)
+      stop_animation
+      @animation = new_animation
+    end
+
+    def stop_animation
+      self.animation.halt if self.animation
+    end
+
+    def building
+      start_color = [6, 6, 25]
+      end_color = [6, 6, MAX]
+
+      transition!(start_color).then do
+        throb!(3, start_color, end_color)
+      end
+    end
+
+    def failure
+      start_color = [30, 0, 0]
+      end_color = [MAX, 30, 0]
+
+      transition!(start_color).then do
+        throb!(1, start_color, end_color)
+      end
+    end
+
+    def success
+      transition!([0, MAX, 0])
+    end
+
+    def off
+      transition!(COLOR[:black])
+    end
+
+    def throb (period, from, to)
+      Animation::Throb.new nil, self, {
+        from: Color.create(from),
+        to: Color.create(to),
+        period: period,
+        type: :sine
+      }
+    end
+
+    def throb! (period, from, to)
+      self.animation = throb(period, from, to)
+
+      self.animation.promise
+    end
+
+
+    def transition(to, duration=2)
+      to = Color.create(to)
+
+      #Set color transition time based on distance, with a maximum of 2 seconds
+      #(number from 0-255)
+      distance = @last_color.distance(to)
+      seconds = duration * [distance, MAX].max / MAX
+
+      Animation::Fade.new seconds, self, { from: @last_color, to: to }
+    end
+
+
+    def transition!(to)
+      self.animation = transition to
+
+      self.animation.promise
+    end
+
+    def color
+      set Color.create(color)
+    end
+
+    # Set light to a given color
+    def set(color)
+      @last_color = color
+      @light.set(color)
+    end
+  end
+end

data/lib/cheeky-pi/light_interface.rb

@@ -0,0 +1,26 @@
+require 'cheeky-pi/color'
+
+module CheekyPi
+  class LightInterface
+    def initialize(path)
+      @r = "#{path}/red"
+      @g = "#{path}/green"
+      @b = "#{path}/blue"
+    end
+
+    def fetch
+      r = IO.read(@r).to_f
+      g = IO.read(@g).to_f
+      b = IO.read(@b).to_f
+
+      Color.create [r, g, b]
+    end
+
+
+    def set(color)
+      IO.write(@r, color.r.round)
+      IO.write(@g, color.g.round)
+      IO.write(@b, color.b.round)
+    end
+  end
+end

data/lib/cheeky-pi/version.rb

@@ -0,0 +1,3 @@
+module CheekyPi
+  VERSION = "0.0.1"
+end

metadata

@@ -0,0 +1,87 @@
+--- !ruby/object:Gem::Specification
+name: cheeky-pi
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Billiam
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-04-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: eventmachine
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.3
+- !ruby/object:Gem::Dependency
+  name: em-promise
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.1
+description: Simple usbled ruby library
+email: billiamthesecond@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/cheeky-pi/animation/base.rb
+- lib/cheeky-pi/animation/cycle.rb
+- lib/cheeky-pi/animation/fade.rb
+- lib/cheeky-pi/animation/throb.rb
+- lib/cheeky-pi/color.rb
+- lib/cheeky-pi/factory.rb
+- lib/cheeky-pi/light.rb
+- lib/cheeky-pi/light_interface.rb
+- lib/cheeky-pi/version.rb
+- lib/cheeky-pi.rb
+- README.md
+homepage: http://github.com/billiam/cheeeky-pi
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: PI led helper
+test_files: []