launchpad 0.2.2 → 0.3.0

data/.gitignore

@@ -1,2 +1,4 @@
-rdoc
-pkg
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+rvm:
+  - 1.8.7
+  - 1.9.3
+  - 2.0.0
+before_install:
+  - sudo apt-get update
+  - sudo apt-get install libportmidi-dev

data/Gemfile

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

data/README.rdoc

@@ -1,26 +1,46 @@
 = launchpad
 
-This gem provides an interface to access novation's launchpad programmatically. LEDs can be lighted and button presses can be responded to. Internally, launchpad's MIDI input/output is used to accomplish this.
+{<img src="https://travis-ci.org/thomasjachmann/launchpad.png?branch=master" alt="Build Status" />}[https://travis-ci.org/thomasjachmann/launchpad]
+
+This gem provides a ruby interface to access novation's launchpad programmatically. LEDs can be lighted and button presses can be responded to. Internally, launchpad's MIDI input/output is used to accomplish this.
 
 The interfaces should be rather stable now (sorry, I changed quite a bit since the last release), so experiment with them and comment on their usability. This still is work in progress. If you need anything or think the interfaces could be improved in any way, please contact me.
 
 Sometimes, the launchpad won't react to anything or react to/light up the wrong LEDs. Don't despair, just dis- and reconnect the thing. It seems that some (unexpected) MIDI signals make it hickup.
 
 
+== More Info
+
+If you don't know what launchpad is, visit:
+
+* Novation's site at http://de.novationmusic.com/products/midi_controller/launchpad
+* my demo videos for this library at http://www.youtube.com/thomasjachmann
+* other demos on youtube http://www.youtube.com/results?search_query=novation+launchpad
+
+If you're into other languages or want to know what goes on behind the scenes MIDI wise, have a look at:
+
+* Novation's MIDI programmer's reference at {www.novationmusic.com/support/launchpad}[http://www.novationmusic.com/support/launchpad/] (bottom of the page)
+* Tobi Tobes' port of my gem to processing at http://github.com/rngtng/launchpad
+
+
 == Requirements
 
 * Roger B. Dannenberg's {portmidi library}[http://sourceforge.net/projects/portmedia/]
 * Jan Krutisch's {portmidi gem}[http://github.com/halfbyte/portmidi]
 
 
-== Installation
+== Compatibility
+
+The gem is known to be compatible with the following ruby versions:
+
+* MRI 1.8.7
+* MRI 1.9.3
+* MRI 2.0.0
 
-The gem is hosted on Gemcutter[http://gemcutter.org/], so in order to use it, you're gonna install the gemcutter gem (for details, see their site):
 
-  gem install gemcutter
-  gem tumble
+== Installation
 
-After that, it's a simple gem install:
+The gem is hosted on RubyGems[https://rubygems.org/], so in order to use it, you're gonna gem install it:
 
   gem install launchpad
 
@@ -34,7 +54,6 @@ There are two main entry points:
 
 This is a simple example (only requiring the device for output) that switches on all LEDs (for testing), resets the launchpad again and then lights the grid button at position 4/4 (from top left).
 
-  require 'rubygems'
   require 'launchpad/device'
   
   device = Launchpad::Device.new
@@ -46,7 +65,6 @@ This is a simple example (only requiring the device for output) that switches on
 
 This is an interaction example lighting all grid buttons in red when pressed and keeping them lit.
 
-  require 'rubygems'
   require 'launchpad'
   
   interaction = Launchpad::Interaction.new
@@ -63,15 +81,21 @@ This is an interaction example lighting all grid buttons in red when pressed and
 For more details, see the examples. examples/color_picker.rb is the most complex example with interaction.
 
 
-== Near future plans
+== Future plans
 
-* interaction responses for presses on single grid buttons/button areas
 * bitmap rendering
 * internal tracking of LED states for both buffers
 
 
 == Changelog
 
+=== v.0.3.0
+
+* logging
+* reworked multi threading for action handling
+* compatibility with ruby 1.8.7 and 2.0.0
+* interaction responses for presses on single grid buttons/button areas/columns/rows
+
 === v.0.2.2
 
 * single threading fix: prevent ThreadError when Launchpad::Interaction#stop is called within an action response

data/Rakefile

@@ -1,28 +1,4 @@
-require 'rubygems'
-require 'rake'
-
-require File.join(File.dirname(__FILE__), 'lib', 'launchpad', 'version')
-
-begin
-  require 'jeweler'
-  Jeweler::Tasks.new do |gem|
-    gem.name = 'launchpad'
-    gem.summary = 'A gem for accessing novation\'s launchpad programmatically and easily.'
-    gem.description = 'This gem provides an interface to access novation\'s launchpad programmatically. LEDs can be lighted and button presses can be evaluated using launchpad\'s MIDI input/output.'
-    gem.email = 'tom.j@gmx.net'
-    gem.homepage = 'http://github.com/thomasjachmann/launchpad'
-    gem.version = Launchpad::VERSION
-    gem.authors = ['Thomas Jachmann']
-    gem.has_rdoc = true
-    gem.add_dependency('portmidi', '>= 0.0.6')
-    gem.add_development_dependency('thoughtbot-shoulda', '>= 0')
-    gem.add_development_dependency('mocha')
-    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
-  end
-  Jeweler::GemcutterTasks.new
-rescue LoadError
-  puts 'Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler'
-end
+require 'bundler/gem_tasks'
 
 require 'rake/testtask'
 Rake::TestTask.new(:test) do |test|
@@ -31,29 +7,4 @@ Rake::TestTask.new(:test) do |test|
   test.verbose = true
 end
 
-begin
-  require 'rcov/rcovtask'
-  Rcov::RcovTask.new do |test|
-    test.libs << 'test'
-    test.pattern = 'test/**/test_*.rb'
-    test.verbose = true
-  end
-rescue LoadError
-  task :rcov do
-    abort 'RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov'
-  end
-end
-
-task :test => :check_dependencies
-
 task :default => :test
-
-require 'rake/rdoctask'
-Rake::RDocTask.new do |rdoc|
-  version = File.exist?('VERSION') ? File.read('VERSION') : ""
-
-  rdoc.rdoc_dir = 'rdoc'
-  rdoc.title = "launchpad #{version}"
-  rdoc.rdoc_files.include('README*')
-  rdoc.rdoc_files.include('lib/**/*.rb')
-end

data/examples/binary_clock.rb

@@ -0,0 +1,29 @@
+require 'launchpad'
+
+device = Launchpad::Device.new
+
+on = { :red => :high, :green => :off }
+off = { :red => :off, :green => :lo }
+
+digit_map = [
+  [off, off, off, off],
+  [on , off, off, off],
+  [off, on , off, off],
+  [on , on , off, off],
+  [off, off, on , off],
+  [on , off, on , off],
+  [off, on , on , off],
+  [on , on , on , off],
+  [off, off, off, on ],
+  [on , off, off, on ]
+]
+
+while true do
+  Time.now.strftime('%H%M%S').split('').each_with_index do |digit, x|
+    digit_map[digit.to_i].each_with_index do |color, y|
+      device.change :grid, color.merge(:x => x, :y => (7 - y))
+    end
+  end
+
+  sleep 0.25
+end

data/examples/color_picker.rb

@@ -1,4 +1,4 @@
-require File.join(File.dirname(__FILE__), 'setup')
+require 'launchpad'
 
 interaction = Launchpad::Interaction.new
 

data/examples/colors.rb

@@ -1,4 +1,4 @@
-require File.join(File.dirname(__FILE__), 'setup')
+require 'launchpad'
 
 device = Launchpad::Device.new(:input => false, :output => true)
 

data/examples/doodle.rb

@@ -1,4 +1,4 @@
-require File.join(File.dirname(__FILE__), 'setup')
+require 'launchpad'
 
 interaction = Launchpad::Interaction.new
 

data/examples/double_buffering.rb

@@ -1,4 +1,4 @@
-require File.join(File.dirname(__FILE__), 'setup')
+require 'launchpad'
 
 interaction = Launchpad::Interaction.new
 

data/examples/drawing_board.rb

@@ -1,4 +1,4 @@
-require File.join(File.dirname(__FILE__), 'setup')
+require 'launchpad'
 
 interaction = Launchpad::Interaction.new
 

data/examples/feedback.rb

@@ -1,4 +1,4 @@
-require File.join(File.dirname(__FILE__), 'setup')
+require 'launchpad'
 
 interaction = Launchpad::Interaction.new
 

data/examples/reset.rb

@@ -1,4 +1,4 @@
-require File.join(File.dirname(__FILE__), 'setup')
+require 'launchpad'
 
 Launchpad::Device.new.reset
 

data/launchpad.gemspec

@@ -1,83 +1,34 @@
-# Generated by jeweler
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
 # -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "launchpad/version"
 
 Gem::Specification.new do |s|
-  s.name = %q{launchpad}
-  s.version = "0.2.2"
-
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Thomas Jachmann"]
-  s.date = %q{2010-02-24}
+  s.name        = "launchpad"
+  s.version     = Launchpad::VERSION
+  s.authors     = ["Thomas Jachmann"]
+  s.email       = ["self@thomasjachmann.com"]
+  s.homepage    = "https://github.com/thomasjachmann/launchpad"
+  s.summary     = %q{A gem for accessing novation's launchpad programmatically and easily.}
   s.description = %q{This gem provides an interface to access novation's launchpad programmatically. LEDs can be lighted and button presses can be evaluated using launchpad's MIDI input/output.}
-  s.email = %q{tom.j@gmx.net}
-  s.extra_rdoc_files = [
-    "LICENSE",
-     "README.rdoc"
-  ]
-  s.files = [
-    ".document",
-     ".gitignore",
-     "LICENSE",
-     "README.rdoc",
-     "Rakefile",
-     "examples/color_picker.rb",
-     "examples/colors.rb",
-     "examples/doodle.rb",
-     "examples/double_buffering.rb",
-     "examples/drawing_board.rb",
-     "examples/feedback.rb",
-     "examples/reset.rb",
-     "examples/setup.rb",
-     "experiments/wandering_dot.rb",
-     "launchpad.gemspec",
-     "lib/launchpad.rb",
-     "lib/launchpad/device.rb",
-     "lib/launchpad/errors.rb",
-     "lib/launchpad/interaction.rb",
-     "lib/launchpad/midi_codes.rb",
-     "lib/launchpad/version.rb",
-     "test/helper.rb",
-     "test/test_device.rb",
-     "test/test_interaction.rb"
-  ]
-  s.homepage = %q{http://github.com/thomasjachmann/launchpad}
-  s.rdoc_options = ["--charset=UTF-8"]
-  s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.3.5}
-  s.summary = %q{A gem for accessing novation's launchpad programmatically and easily.}
-  s.test_files = [
-    "test/helper.rb",
-     "test/test_device.rb",
-     "test/test_interaction.rb",
-     "examples/color_picker.rb",
-     "examples/colors.rb",
-     "examples/doodle.rb",
-     "examples/double_buffering.rb",
-     "examples/drawing_board.rb",
-     "examples/feedback.rb",
-     "examples/reset.rb",
-     "examples/setup.rb"
-  ]
 
-  if s.respond_to? :specification_version then
-    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
-    s.specification_version = 3
+  s.rubyforge_project = "launchpad"
 
-    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<portmidi>, [">= 0.0.6"])
-      s.add_development_dependency(%q<thoughtbot-shoulda>, [">= 0"])
-      s.add_development_dependency(%q<mocha>, [">= 0"])
-    else
-      s.add_dependency(%q<portmidi>, [">= 0.0.6"])
-      s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
-      s.add_dependency(%q<mocha>, [">= 0"])
-    end
+  s.add_dependency "portmidi", ">= 0.0.6"
+  s.add_dependency "ffi"
+  s.add_development_dependency "rake"
+  if RUBY_VERSION < "1.9"
+    s.add_development_dependency "minitest"
+    # s.add_development_dependency "ruby-debug"
   else
-    s.add_dependency(%q<portmidi>, [">= 0.0.6"])
-    s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
-    s.add_dependency(%q<mocha>, [">= 0"])
+    s.add_development_dependency "minitest-reporters"
+    # s.add_development_dependency "debugger"
   end
-end
+  s.add_development_dependency "mocha"
 
+  # s.has_rdoc = true
+
+  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"]
+end

data/lib/launchpad.rb

@@ -30,4 +30,5 @@ require 'launchpad/interaction'
 #                       * <tt>:buffering</tt> (LED is written to buffer, see Launchpad::Device.start_buffering, Launchpad::Device.flush_buffer)
 #                       optional, defaults to <tt>:normal</tt>
 # [+state+]             whether the button is pressed or released, <tt>:down/:up</tt>
-module Launchpad; end
+module Launchpad
+end

data/lib/launchpad/device.rb

@@ -1,6 +1,7 @@
 require 'portmidi'
 
 require 'launchpad/errors'
+require 'launchpad/logging'
 require 'launchpad/midi_codes'
 require 'launchpad/version'
 
@@ -11,7 +12,6 @@ module Launchpad
   # 
   # Example:
   # 
-  #   require 'rubygems'
   #   require 'launchpad/device'
   #   
   #   device = Launchpad::Device.new
@@ -22,8 +22,47 @@ module Launchpad
   #   device.change :grid, :x => 4, :y => 4, :red => :high, :green => :low
   class Device
     
+    include Logging
     include MidiCodes
     
+    CODE_NOTE_TO_DATA_TYPE = {
+      [Status::ON, SceneButton::SCENE1]     => :scene1,
+      [Status::ON, SceneButton::SCENE2]     => :scene2,
+      [Status::ON, SceneButton::SCENE3]     => :scene3,
+      [Status::ON, SceneButton::SCENE4]     => :scene4,
+      [Status::ON, SceneButton::SCENE5]     => :scene5,
+      [Status::ON, SceneButton::SCENE6]     => :scene6,
+      [Status::ON, SceneButton::SCENE7]     => :scene7,
+      [Status::ON, SceneButton::SCENE8]     => :scene8,
+      [Status::CC, ControlButton::UP]       => :up,
+      [Status::CC, ControlButton::DOWN]     => :down,
+      [Status::CC, ControlButton::LEFT]     => :left,
+      [Status::CC, ControlButton::RIGHT]    => :right,
+      [Status::CC, ControlButton::SESSION]  => :session,
+      [Status::CC, ControlButton::USER1]    => :user1,
+      [Status::CC, ControlButton::USER2]    => :user2,
+      [Status::CC, ControlButton::MIXER]    => :mixer
+    }.freeze
+
+    TYPE_TO_NOTE = {
+      :up       => ControlButton::UP,
+      :down     => ControlButton::DOWN,
+      :left     => ControlButton::LEFT,
+      :right    => ControlButton::RIGHT,
+      :session  => ControlButton::SESSION,
+      :user1    => ControlButton::USER1,
+      :user2    => ControlButton::USER2,
+      :mixer    => ControlButton::MIXER,
+      :scene1   => SceneButton::SCENE1,
+      :scene2   => SceneButton::SCENE2,
+      :scene3   => SceneButton::SCENE3,
+      :scene4   => SceneButton::SCENE4,
+      :scene5   => SceneButton::SCENE5,
+      :scene6   => SceneButton::SCENE6,
+      :scene7   => SceneButton::SCENE7,
+      :scene8   => SceneButton::SCENE8
+    }.freeze
+
     # Initializes the launchpad device. When output capabilities are requested,
     # the launchpad will be reset.
     # 
@@ -39,6 +78,7 @@ module Launchpad
     #                               optional, <tt>:device_name</tt> will be used if omitted
     # [<tt>:device_name</tt>]       Name of the MIDI device to use,
     #                               optional, defaults to "Launchpad"
+    # [<tt>:logger</tt>]            [Logger] to be used by this device instance, can be changed afterwards
     # 
     # Errors raised:
     # 
@@ -50,15 +90,26 @@ module Launchpad
         :output       => true
       }.merge(opts || {})
       
+      self.logger = opts[:logger]
+      logger.debug "initializing Launchpad::Device##{object_id} with #{opts.inspect}"
+
       Portmidi.start
       
-      @input = device(Portmidi.input_devices, Portmidi::Input, :id => opts[:input_device_id], :name => opts[:device_name]) if opts[:input]
-      @output = device(Portmidi.output_devices, Portmidi::Output, :id => opts[:output_device_id], :name => opts[:device_name]) if opts[:output]
+      @input = create_device!(Portmidi.input_devices, Portmidi::Input,
+        :id => opts[:input_device_id],
+        :name => opts[:device_name]
+      ) if opts[:input]
+      @output = create_device!(Portmidi.output_devices, Portmidi::Output,
+        :id => opts[:output_device_id],
+        :name => opts[:device_name]
+      ) if opts[:output]
+
       reset if output_enabled?
     end
     
     # Closes the device - nothing can be done with the device afterwards.
     def close
+      logger.debug "closing Launchpad::Device##{object_id}"
       @input.close unless @input.nil?
       @input = nil
       @output.close unless @output.nil?
@@ -228,6 +279,7 @@ module Launchpad
     end
     
     # Reads user actions (button presses/releases) that haven't been handled yet.
+    # This is non-blocking, so when nothing happend yet you'll get an empty array.
     # 
     # Returns:
     # 
@@ -249,33 +301,10 @@ module Launchpad
           :timestamp  => midi_message[:timestamp],
           :state      => (velocity == 127 ? :down : :up)
         }
-        data[:type] = case code
-        when Status::ON
-          case note
-          when SceneButton::SCENE1 then :scene1
-          when SceneButton::SCENE2 then :scene2
-          when SceneButton::SCENE3 then :scene3
-          when SceneButton::SCENE4 then :scene4
-          when SceneButton::SCENE5 then :scene5
-          when SceneButton::SCENE6 then :scene6
-          when SceneButton::SCENE7 then :scene7
-          when SceneButton::SCENE8 then :scene8
-          else
-            data[:x] = note % 16
-            data[:y] = note / 16
-            :grid
-          end
-        when Status::CC
-          case note
-          when ControlButton::UP       then :up
-          when ControlButton::DOWN     then :down
-          when ControlButton::LEFT     then :left
-          when ControlButton::RIGHT    then :right
-          when ControlButton::SESSION  then :session
-          when ControlButton::USER1    then :user1
-          when ControlButton::USER2    then :user2
-          when ControlButton::MIXER    then :mixer
-          end
+        data[:type] = CODE_NOTE_TO_DATA_TYPE[[code, note]] || :grid
+        if data[:type] == :grid
+          data[:x] = note % 16
+          data[:y] = note / 16
         end
         data
       end
@@ -305,16 +334,22 @@ module Launchpad
     # 
     # [Launchpad::NoSuchDeviceError] when device with ID or name specified does not exist
     # [Launchpad::DeviceBusyError] when device with ID or name specified is busy
-    def device(devices, device_type, opts)
+    def create_device!(devices, device_type, opts)
+      logger.debug "creating #{device_type} with #{opts.inspect}, choosing from portmidi devices #{devices.inspect}"
       id = opts[:id]
       if id.nil?
         name = opts[:name] || 'Launchpad'
         device = devices.select {|device| device.name == name}.first
         id = device.device_id unless device.nil?
       end
-      raise NoSuchDeviceError.new("MIDI device #{opts[:id] || opts[:name]} doesn't exist") if id.nil?
+      if id.nil?
+        message = "MIDI device #{opts[:id] || opts[:name]} doesn't exist"
+        logger.fatal message
+        raise NoSuchDeviceError.new(message)
+      end
       device_type.new(id)
     rescue RuntimeError => e
+      logger.fatal "error creating #{device_type}: #{e.inspect}"
       raise DeviceBusyError.new(e)
     end
     
@@ -335,7 +370,10 @@ module Launchpad
     # 
     # [Launchpad::NoInputAllowedError] when output is not enabled
     def input
-      raise NoInputAllowedError if @input.nil?
+      if @input.nil?
+        logger.error "trying to read from device that's not been initialized for input"
+        raise NoInputAllowedError
+      end
       @input.read(16)
     end
     
@@ -365,7 +403,11 @@ module Launchpad
     #                                     MIDI data 2 (velocity)
     #               [<tt>:timestamp</tt>] integer indicating the time when the MIDI message was created
     def output_messages(messages)
-      raise NoOutputAllowedError if @output.nil?
+      if @output.nil?
+        logger.error "trying to write to device that's not been initialized for output"
+        raise NoOutputAllowedError
+      end
+      logger.debug "writing messages to launchpad:\n  #{messages.join("\n  ")}" if logger.debug?
       @output.write(messages)
       nil
     end
@@ -389,29 +431,17 @@ module Launchpad
     # 
     # [Launchpad::NoValidGridCoordinatesError] when coordinates aren't within the valid range
     def note(type, opts)
-      case type
-      when :up      then ControlButton::UP
-      when :down    then ControlButton::DOWN
-      when :left    then ControlButton::LEFT
-      when :right   then ControlButton::RIGHT
-      when :session then ControlButton::SESSION
-      when :user1   then ControlButton::USER1
-      when :user2   then ControlButton::USER2
-      when :mixer   then ControlButton::MIXER
-      when :scene1  then SceneButton::SCENE1
-      when :scene2  then SceneButton::SCENE2
-      when :scene3  then SceneButton::SCENE3
-      when :scene4  then SceneButton::SCENE4
-      when :scene5  then SceneButton::SCENE5
-      when :scene6  then SceneButton::SCENE6
-      when :scene7  then SceneButton::SCENE7
-      when :scene8  then SceneButton::SCENE8
-      else
+      note = TYPE_TO_NOTE[type]
+      if note.nil?
         x = (opts[:x] || -1).to_i
         y = (opts[:y] || -1).to_i
-        raise NoValidGridCoordinatesError.new("you need to specify valid coordinates (x/y, 0-7, from top left), you specified: x=#{x}, y=#{y}") if x < 0 || x > 7 || y < 0 || y > 7
-        y * 16 + x
+        if x < 0 || x > 7 || y < 0 || y > 7
+          logger.error "wrong coordinates specified: x=#{x}, y=#{y}"
+          raise NoValidGridCoordinatesError.new("you need to specify valid coordinates (x/y, 0-7, from top left), you specified: x=#{x}, y=#{y}")
+        end
+        note = y * 16 + x
       end
+      note
     end
     
     # Calculates the MIDI data 2 value (velocity) for given brightness and mode values.
@@ -433,19 +463,19 @@ module Launchpad
     # 
     # [Launchpad::NoValidBrightnessError] when brightness values aren't within the valid range
     def velocity(opts)
-      color = if opts.is_a?(Hash)
+      if opts.is_a?(Hash)
         red = brightness(opts[:red] || 0)
         green = brightness(opts[:green] || 0)
-        16 * green + red
+        color = 16 * green + red
+        flags = case opts[:mode]
+                when :flashing  then  8
+                when :buffering then  0
+                else                  12
+                end
+        color + flags
       else
-        opts.to_i
-      end
-      flags = case opts[:mode]
-      when :flashing  then  8
-      when :buffering then  0
-      else                  12
+        opts.to_i + 12
       end
-      color + flags
     end
     
     # Calculates the integer brightness for given brightness values.
@@ -464,6 +494,7 @@ module Launchpad
       when 2, :medium,  :med  then 2
       when 3, :high,    :hi   then 3
       else
+        logger.error "wrong brightness specified: #{brightness}"
         raise NoValidBrightnessError.new("you need to specify the brightness as 0/1/2/3, :off/:low/:medium/:high or :off/:lo/:hi, you specified: #{brightness}")
       end
     end