pixel_pi 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 88f76ffee2734314c7106fb269336d2e634fce17
+  data.tar.gz: 94b421a965b1bf7b1df122b8ef237eb751b62ba4
+SHA512:
+  metadata.gz: 5179dc9f4abea2e66023cf1f487ff699de587bce76c328f3010cfbb906cb7dc572870855013023dd9734439ff025437c4391de391d5a8bc949b62b943a6a5ead
+  data.tar.gz: 0c85470cf2b9c1a4e18891081fc14c42e472f9848e038ed3cec60f7ce9f2b0bc9f0853c0382f13842c54c14fc49f0b4119045fe6b33d46ada60c0cba15fe8c3d

data/.gitignore

@@ -0,0 +1 @@
+tmp

data/README.md

@@ -0,0 +1,85 @@
+# What is this?
+
+Ruby code for controlling [NeoPixels](https://www.adafruit.com/category/168)
+attached to a [Raspberry Pi](http://www.raspberrypi.org).
+
+# Is it any good?
+
+Yes.
+
+# How do I run it?
+
+Install the gem on your RaspberryPi, and copy the `strandtest.rb` file to your
+home directory:
+
+```sh
+sudo gem install pixel_pi
+cp `gem contents pixel_pi | grep strandtest.rb` .
+```
+
+Edit the `LED_COUNT` and `LED_PIN` at the top of the file to
+match the NeoPixel circuit attached to your RaspberryPi (read the [RaspberryPi
+NeoPixel guide](https://learn.adafruit.com/neopixels-on-raspberry-pi/overview)
+from Adafruit for all the details). Now run the strandtest example:
+
+```sh
+sudo ruby strandtest.rb
+```
+
+Enjoy the blinken lights!
+
+# It won't run!
+
+Yes it will.
+
+The [ws2811](https://github.com/jgarff/rpi_ws281x) driver is using direct memory
+addressing (DMA) via `/dev/mem` to control the NeoPixels. Only the root user has
+permission to read and write to this hardware device. So any time your work with
+NeoPixels, your code will need to be run as the super user.
+
+# I want to help out
+
+If you want to contribute to this gem then you will need a development
+environment setup on your RaspberryPi. You will need the ruby headers installed
+locally.
+
+```
+sudo apt-get install ruby ruby-dev
+```
+
+Install some ruby gems.
+
+```
+sudo gem install rake
+sudo gem install rake-compiler
+```
+
+The `rake-compiler` gem might not install properly. The problem is a very strict
+requirement on the rubygems version. To work around this we need to download the
+source code, create the gem by hand, and install. You can skip this step if
+rake-compiler installed successfully.
+
+```
+sudo su
+git clone https://github.com/luislavena/rake-compiler.git
+cd rake-compiler
+rake gem
+gem install pkg/rake-compiler-0.9.3.gem --no-rdoc --no-ri
+cd ../
+rm -fr rake-compiler
+exit
+```
+
+Now we can compile the NeoPixels ruby library.
+
+```
+rake compile
+```
+
+Take a look at the `examples/strandtest.rb` file and adjust the `LED_COUNT` and
+`LED_PIN` to match your circuit. Run the strandtest and bask in the glow of
+blinking rainbow lights.
+
+```
+sudo ruby examples/strandtest.rb
+```

data/Rakefile

@@ -0,0 +1,16 @@
+require "rubygems"
+require "rake/extensiontask"
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+spec = Gem::Specification.load("pixel_pi.gemspec")
+
+Gem::PackageTask.new(spec)
+
+Rake::ExtensionTask.new("pixel_pi", spec) do |ext|
+  ext.name    = "leds"
+  ext.ext_dir = "ext/pixel_pi"
+  ext.lib_dir = "lib/pixel_pi"
+end
+

data/examples/strandtest.rb

@@ -0,0 +1,186 @@
+require "rubygems"
+
+begin
+  require "pixel_pi"
+rescue LoadError
+  lib = File.expand_path('../../lib', __FILE__)
+  raise if $LOAD_PATH.include?(lib)
+  $LOAD_PATH.unshift(lib)
+  retry
+end
+
+LED_COUNT      = 8       # Number of LED pixels.
+LED_PIN        = 18      # GPIO pin connected to the pixels (must support PWM!).
+LED_FREQ_HZ    = 800000  # LED signal frequency in hertz (usually 800khz)
+LED_DMA        = 5       # DMA channel to use for generating signal (try 5)
+LED_BRIGHTNESS = 255     # Scale the brightness of the pixels (0 to 255)
+LED_INVERT     = false   # True to invert the signal (when using NPN transistor level shift)
+
+module StrandTest
+
+  attr_accessor :wait_ms
+
+  # Wipe color across display a pixel at a time.
+  #
+  # color - The 24-bit RGB color value
+  # opts  - The options Hash
+  #   :wait_ms - sleep time between pixel updates
+  #
+  # Returns this PixelPi::Leds instance.
+  def color_wipe( color, opts = {} )
+    wait_ms = opts.fetch(:wait_ms, self.wait_ms)
+
+    self.length.times do |num|
+      self[num] = color
+      self.show
+      sleep(wait_ms / 1000.0)
+    end
+
+    self
+  end
+
+  # Movie theater light style chaser animation.
+  #
+  # color - The 24-bit RGB color value
+  # opts  - The options Hash
+  #   :wait_ms    - sleep time between pixel updates
+  #   :iterations - number of iterations (defaults to 10)
+  #   :spacing    - spacing between lights (defaults to 3)
+  #
+  # Returns this PixelPi::Leds instance.
+  def theater_chase( color, opts = {} )
+    wait_ms    = opts.fetch(:wait_ms, self.wait_ms)
+    iterations = opts.fetch(:iterations, 10)
+    spacing    = opts.fetch(:spacing, 3)
+
+    iterations.times do
+      spacing.times do |jj|
+        (0...self.length).step(spacing) { |ii| self[ii+jj] = color }
+        self.show
+        sleep(wait_ms / 1000.0)
+        (0...self.length).step(spacing) { |ii| self[ii+jj] = 0 }
+      end
+    end
+
+    self
+  end
+
+  # Generate rainbow colors across 0-255 positions.
+  #
+  # pos - Positoin between 0 and 255
+  #
+  # Returns a 24-bit RGB color value.
+  def wheel( pos )
+    if pos < 85
+      return PixelPi::Color(pos * 3, 255 - pos * 3, 0)
+    elsif pos < 170
+      pos -= 85
+      return PixelPi::Color(255 - pos * 3, 0, pos * 3)
+    else
+      pos -= 170
+      return PixelPi::Color(0, pos * 3, 255 - pos * 3)
+    end
+  end
+
+  # Draw rainbow that fades across all pixels at once.
+  #
+  # opts - The options Hash
+  #   :wait_ms    - sleep time between pixel updates
+  #   :iterations - number of iterations (defaults to 1)
+  #
+  # Returns this PixelPi::Leds instance.
+  def rainbow( opts = {} )
+    wait_ms    = opts.fetch(:wait_ms, self.wait_ms)
+    iterations = opts.fetch(:iterations, 1)
+
+    (0...256*iterations).each do |jj|
+      self.length.times { |ii| self[ii] = wheel((ii+jj) & 0xff) }
+      self.show
+      sleep(wait_ms / 1000.0)
+    end
+
+    self
+  end
+
+  # Draw rainbow that uniformly distributes itself across all pixels.
+  #
+  # opts - The options Hash
+  #   :wait_ms    - sleep time between pixel updates
+  #   :iterations - number of iterations (defaults to 5)
+  #
+  # Returns this PixelPi::Leds instance.
+  def rainbow_cycle( opts = {} )
+    wait_ms    = opts.fetch(:wait_ms, self.wait_ms)
+    iterations = opts.fetch(:iterations, 5)
+
+    (0...256*iterations).each do |jj|
+      self.length.times { |ii| self[ii] = wheel(((ii * 256 / self.length) + jj) & 0xff) }
+      self.show
+      sleep(wait_ms / 1000.0)
+    end
+
+    self
+  end
+
+  # Rainbow moview theather light style chaser animation.
+  #
+  # opts - The options Hash
+  #   :wait_ms - sleep time between pixel updates
+  #   :spacing - spacing between lights (defaults to 3)
+  #
+  # Returns this PixelPi::Leds instance.
+  def theater_chase_rainbow( opts = {} )
+    wait_ms = opts.fetch(:wait_ms, self.wait_ms)
+    spacing = opts.fetch(:spacing, 3)
+
+    256.times do |jj|
+      spacing.times do |sp|
+        (0...self.length).step(spacing) { |ii| self[ii+sp] = wheel((ii+jj) % 255) }
+        self.show
+        sleep(wait_ms / 1000.0)
+        (0...self.length).step(spacing) { |ii| self[ii+sp] = 0 }
+      end
+    end
+
+    self
+  end
+
+end
+
+
+strip = PixelPi::Leds.new \
+    LED_COUNT, LED_PIN,
+    :frequency  => LED_FREQ_HZ,
+    :dma        => LED_DMA,
+    :brightness => LED_BRIGHTNESS,
+    :invert     => LED_INVERT
+
+strip.extend StrandTest
+
+trap("SIGINT") do
+  strip.clear
+  strip.close  # not explicitly needed - the finalizer will gracefully shutdown
+  exit         # the PWM channel and release the DMA memory
+end
+
+STDOUT.puts "Press Ctrl-C to quit."
+
+loop do
+  # Color wipe animations
+  strip.wait_ms = 75
+  strip.color_wipe(PixelPi::Color(255, 0, 0))  # red color wipe
+  strip.color_wipe(PixelPi::Color(0, 255, 0))  # green color wipe
+  strip.color_wipe(PixelPi::Color(0, 0, 255))  # blue color wipe
+
+  # Theater chase animations
+  strip.wait_ms = 100
+  strip.clear
+  strip.theater_chase(PixelPi::Color(255, 255, 255))  # white theater chase
+  strip.theater_chase(PixelPi::Color(255,   0,   0))  # red theater chase
+  strip.theater_chase(PixelPi::Color(  0,   0, 255))  # blue theater chase
+
+  strip.wait_ms = 20
+  strip.rainbow
+  strip.rainbow_cycle
+  strip.theater_chase_rainbow(:wait_ms => 75)
+end

data/ext/pixel_pi/extconf.rb

@@ -0,0 +1,18 @@
+require 'mkmf'
+
+pixel_pi_path = File.expand_path("../", __FILE__)
+ws2811_path   = File.expand_path("../../ws2811", __FILE__)
+ws2811_files  = %w[
+  clk.h
+  dma.h
+  gpio.h
+  pwm.h
+  ws2811.h
+  dma.c
+  pwm.c
+  ws2811.c
+]
+ws2811_files.map! { |name| "#{ws2811_path}/#{name}" }
+FileUtils.cp(ws2811_files, pixel_pi_path)
+
+create_makefile("neo_pixels/leds")