xilight 0.1.1 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 96940ee5a8e52c7a209d5619adab903adc6e40a6ef797e74f171afc287b9040d
-  data.tar.gz: e2eebb403b5a55cce98d586834bda03f09ece8a895a59d98ba77a9448269c1af
+  metadata.gz: 8bb65d34b1363b82bfaf5fbca8927b0de1d610aedf7b03e4d2d11ee4485c74c4
+  data.tar.gz: 196803f1a0a8a25faaf676f46a7d9f26ffec3381e255242b149bb95d9c630900
 SHA512:
-  metadata.gz: 72e773c16eb87f341c536d5dc21a0f03c74420768970b746b7076dd1e10026ef7416906bf0e9213916db65fec70fc5ef798ad6ff316bf234a242a300377b109e
-  data.tar.gz: c237b3f66f6e775362c8b22c04fd6102c6d85ac842ae1fc6232216a29f95ceb8f606c3682ad7155d537680ec3ad50abf7a6be2a45a864328230d19a1ec0a85cf
+  metadata.gz: 20b243d508aedca52d92db7ba0c7ef9acdbcd760fde640f7c9fa1f4dfb8ad2a810ba506f6a4f9c9cd1b32cf60876efa42c1fde6e726c4b6b516b27d2da911c76
+  data.tar.gz: 4647b5b21fd425fd926d7ebb6ea75eb565049e63e7421755f79134a220e762b0d34c044c12900aaf685de9433cd2f4cea79f164de6752120505c2600276d35fe

data/.ruby-version

@@ -0,0 +1 @@
+2.7.0

data/README.md

@@ -1,8 +1,8 @@
-# Yeelight
+# Xilight
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/xilight`. To experiment with that code, run `bin/console` for an interactive prompt.
+Xilight provides a Ruby library and a CLI interface to control your Xiaomi Yeelight programmatically.
 
-TODO: Delete this and the text above, and describe your gem
+**Note**: It requires your yeelight to be configured to [development mode](https://www.yeelight.com/en_US/developer).
 
 ## Installation
 
@@ -22,7 +22,226 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+### Library
+
+Read the API docs [here](https://rubydoc.info/github/wouterken/xilight/master/Xilight/Yeelight).
+
+###  CLI
+
+#### Help
+
+    yee -h
+
+#### Discovery
+    Command:
+      yee discover
+
+    Usage:
+      yee discover
+
+    Description:
+      Discover Yeelights and save to ~/.config/.yeelights
+
+    Options:
+      --help, -h                        # Print this help
+
+    Examples:
+      yee discover
+
+#### List Lights
+
+    Command:
+      yee list
+
+    Usage:
+      yee list
+
+    Description:
+      List known Yeelights
+
+    Options:
+      --help, -h                        # Print this help
+
+    Examples:
+      yee list
+
+#### Set Light Name
+
+    Command:
+      yee name
+
+    Usage:
+      yee name NAME
+
+    Description:
+      Set name for Yeelight
+
+    Arguments:
+      NAME                  # REQUIRED Name to set for light
+
+    Options:
+      --light=VALUE, -l VALUE           # ID/index of Yeelight to target, default: "0"
+      --help, -h                        # Print this help
+
+    Examples:
+      yee name name -l 1 foo # Set the name for light#1 to "foo"
+
+
+#### Set RGB
+
+    Command:
+      yee rgb
+
+    Usage:
+      yee rgb R G B
+
+    Description:
+      Set RGB for Yeelight
+
+    Arguments:
+      R                     # REQUIRED Red (0-255)
+      G                     # REQUIRED Green (0-255)
+      B                     # REQUIRED Blue (0-255)
+
+    Options:
+      --light=VALUE, -l VALUE           # ID/index of Yeelight to target, default: "0"
+      --name=VALUE, -n VALUE            # Name of Yeelight to target
+      --help, -h                        # Print this help
+
+    Examples:
+      yee rgb 255 0 0 # set light to red (red 255, green 0, blue 0)
+      yee rgb 0 0 180 -n foo# set light with name foo to blue (red 0, green 0, blue 180)
+      yee rgb 255 255 255 -l 3# set light #3 to white (red 255, green 255, blue 255)
+
+
+#### Brightness
+
+    Command:
+      yee bright
+
+    Usage:
+      yee bright BRIGHTNESS
+
+    Description:
+      Set Brightness for Yeelight
+
+    Arguments:
+      BRIGHTNESS            # REQUIRED Brightness (0-100)
+
+    Options:
+      --light=VALUE, -l VALUE           # ID/index of Yeelight to target, default: "0"
+      --name=VALUE, -n VALUE            # Name of Yeelight to target
+      --help, -h                        # Print this help
+
+    Examples:
+      yee bright 100 # full brightness
+      yee bright 50 -n foo  # 50% brightness for light with name foo
+      yee bright 25 -l 3  # 25% brightness for light#3
+
+#### Set HSV
+
+    Command:
+      yee hsv
+
+    Usage:
+      yee hsv H S
+
+    Description:
+      Set HSV for Yeelight
+
+    Arguments:
+      H                     # REQUIRED Hue (0-359)
+      S                     # REQUIRED Saturation (0-100)
+
+    Options:
+      --light=VALUE, -l VALUE           # ID/index of Yeelight to target, default: "0"
+      --name=VALUE, -n VALUE            # Name of Yeelight to target
+      --help, -h                        # Print this help
+
+    Examples:
+      yee hsv 180 40 # set hue to 180 and saturation to 40
+      yee hsv 200 20 -n foo# set light with name foo to hue: 200, saturation: 20
+      yee hsv 359 90 -l 3# set light #3  to hue: 359, saturation: 90
+
+#### Turn Off
+
+    Command:
+      yee off
+
+    Usage:
+      yee off
+
+
+    Description:
+      Turn Off Yeelight
+
+    Options:
+      --light=VALUE, -l VALUE           # ID/index of Yeelight to target, default: "0"
+      --name=VALUE, -n VALUE            # Name of Yeelight to target
+      --help, -h                        # Print this help
+
+    Examples:
+      yee off # turn default/first light off
+      yee off -n kitchen # turn light with name 'kitchen' off
+      yee off -l 3 # turn light #3 off
+
+#### Turn On
+    Command:
+      yee on
+
+    Usage:
+      yee on
+
+    Description:
+      Turn on Yeelight
+
+    Options:
+      --light=VALUE, -l VALUE           # ID/index of Yeelight to target, default: "0"
+      --name=VALUE, -n VALUE            # Name of Yeelight to target
+      --help, -h                        # Print this help
+
+    Examples:
+      yee on # turn default/first light on
+      yee on -n kitchen # turn light with name 'kitchen' on
+      yee on -l 3 # turn light #3 on
+
+#### Toggle
+
+    Command:
+      yee toggle
+
+    Usage:
+      yee toggle
+
+    Description:
+      Toggle Yeelight
+
+    Options:
+      --light=VALUE, -l VALUE           # ID/index of Yeelight to target, default: "0"
+      --name=VALUE, -n VALUE            # Name of Yeelight to target
+      --help, -h                        # Print this help
+
+    Examples:
+      yee toggle # toggle default/first light
+      yee toggle -n kitchen # toggle light with name 'kitchen'
+      yee toggle -l 3 # toggle light #3
+
+#### Version
+
+    Command:
+      yee version
+
+    Usage:
+      yee version
+
+    Description:
+      Print version
+
+    Options:
+      --help, -h                        # Print this help
+
+    Examples:
+      yee version
 
 ## Development
 
@@ -32,5 +251,5 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/xilight. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+Bug reports and pull requests are welcome on GitHub at https://github.com/wouterken/xilight. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
 

data/exe/yee

@@ -2,7 +2,7 @@
 
 require "xilight"
 require "dry/cli"
-
+require 'pry-byebug'
 module Xilight
   module CLI
 
@@ -20,14 +20,28 @@ module Xilight
       {}
     end
 
-    def self.get_light(index, name=nil)
+    def self.rgb_to_hex(r,g,b)
+      [r,g,b].map{|x| x.to_i.to_s(16).rjust(2, '0') }.join
+    end
+
+    def self.rgb_to_i(r,g,b)
+      rgb_to_hex(r,g,b).to_i(16)
+    end
+
+    def self.get_light(index, name=nil, attempt: 0)
       lights = ::Xilight::CLI.config['yeelights']
       light_attribs = if name && name != ''
         lights.find{|l| l['name'].downcase.strip == name.downcase.strip }
       else
         lights[index.to_i]
       end
-      ::Xilight::Yeelight.new(light_attribs.map{|k,v| [k.to_sym, v]}.to_h)
+      light = ::Xilight::Yeelight.new(**light_attribs.map{|k,v| [k.to_sym, v]}.to_h)
+      unless light.available?
+        self.discover
+        get_light(index, name, attempt: 1) if attempt.zero?
+      else
+        light
+      end
     rescue
       puts "Couldn't find light with " + ((name && name != '') ? "name #{name}" : "ID #{index}")
       puts "Known lights:"
@@ -35,6 +49,23 @@ module Xilight
       exit(1)
     end
 
+    def self.discover
+      ::Xilight::CLI.config = {
+        'yeelights' => ::Xilight::Yeelight.discover.map do |light|
+          light.instance_variables.map{|v| [v.to_s[1..-1], light.instance_variable_get(v)] }.to_h
+        end
+      }
+      self.list
+    end
+
+    def self.list
+      current_config = ::Xilight::CLI.config
+      current_lights = current_config.fetch('yeelights', [])
+      current_lights.each_with_index do |light, index|
+        puts "Light ##{index} => #{(light['name'] || light['id'])}@#{light['host']}"
+      end
+    end
+
     module Commands
       extend Dry::CLI::Registry
 
@@ -58,17 +89,7 @@ module Xilight
         ]
 
         def call(**)
-          current_config = ::Xilight::CLI.config
-          current_lights = current_config.fetch('yeelights', [])
-          ::Xilight::Yeelight.discover.each do |light|
-            current_lights.reject!{|l| l['id'] == light.id}
-            current_lights << light.instance_variables.map{|v| [v.to_s[1..-1], light.instance_variable_get(v)] }.to_h
-          end
-          current_config['yeelights'] = current_lights
-          current_lights.each_with_index do |light, index|
-            puts "Light ##{index} => #{(light['name'] || light['id'])}@#{light['host']}"
-          end
-          ::Xilight::CLI.config = current_config
+          ::Xilight::CLI.discover
         end
       end
 
@@ -80,11 +101,7 @@ module Xilight
         ]
 
         def call(**)
-          current_config = ::Xilight::CLI.config
-          current_lights = current_config.fetch('yeelights', [])
-          current_lights.each_with_index do |light, index|
-            puts "Light ##{index} => #{(light['name'] || light['id'])}@#{light['host']}"
-          end
+          ::Xilight::CLI.list
         end
       end
 
@@ -104,8 +121,7 @@ module Xilight
 
         def call(r:, g:, b:, light: 0, name: nil, **)
           light =::Xilight::CLI.get_light(light, name)
-          as_hex = [r,g,b].map{|x| x.to_i.to_s(16).rjust(2, '0') }.join
-          light.rgb = as_hex.to_i(16)
+          light.rgb = ::Xilight::CLI.rgb_to_i(r,g,b)
         end
       end
 
@@ -214,6 +230,44 @@ module Xilight
         end
       end
 
+      module ColorFlow
+        class On < Dry::CLI::Command
+          desc "Start ColorFlow"
+          option :light, desc: "ID/index of Yeelight to target", default: "0", aliases: ["-l"]
+          option :name, desc: "Name of Yeelight to target", default: nil, aliases: ["-n"]
+
+          example [
+            "on # start color flow on default/first light",
+            "on -n kitchen # start color flow on light with name 'kitchen'",
+            "on -l 3 # start color flow on light #3"
+          ]
+          def call(light: 0, name: nil, **)
+            light =::Xilight::CLI.get_light(light, name)
+            flow_expression = COLORS.values.first(12).each_slice(2).map(&:first).map do |(r,g,b)|
+              "1000,2,#{::Xilight::CLI.rgb_to_i(r,g,b)},100"
+            end.join(',')
+            light.start_cf(0, 1, flow_expression)
+          end
+        end
+
+        class Off < Dry::CLI::Command
+          desc "Stop ColorFlow"
+          option :light, desc: "ID/index of Yeelight to target", default: "0", aliases: ["-l"]
+          option :name, desc: "Name of Yeelight to target", default: nil, aliases: ["-n"]
+
+          example [
+            "off # start color flow on default/first light",
+            "off -n kitchen # start color flow on light with name 'kitchen'",
+            "off -l 3 # start color flow on light #3"
+          ]
+
+          def call(light: 0, name: nil, **)
+            light =::Xilight::CLI.get_light(light, name)
+            light.power = 'off'
+          end
+        end
+      end
+
       COLORS = {
         red: [255, 0, 0],
         orange: [255, 128, 0],
@@ -236,7 +290,7 @@ module Xilight
         Object.const_set(class_name, Class.new(Dry::CLI::Command) do
           desc "Set yeelight to color #{color}"
           example [
-            "#{color}"
+            ""
           ]
 
           option :light, desc: "ID/index of Yeelight to target", default: "0", aliases: ["-l"]
@@ -257,6 +311,11 @@ module Xilight
         end
       end
 
+      register "color_flow", aliases: ["cf"] do |prefix|
+        prefix.register "on", ColorFlow::On, aliases: ["o"]
+        prefix.register "off", ColorFlow::Off, aliases: ["x"]
+      end
+
       register "version",  Version, aliases: ["v", "-v", "--version"]
       register "discover", Discover, aliases: ["d"]
       register "rgb",      Rgb

data/lib/xilight.rb

@@ -24,12 +24,34 @@ module Xilight
       @port       = location[/(?!<:)\d+$/]
     end
 
+    def available?()
+      begin
+        Timeout::timeout(1) do
+          begin
+            s = TCPSocket.new(@host, @port)
+            s.close
+            return true
+          rescue Errno::ECONNREFUSED, Errno::EHOSTUNREACH
+            return false
+          end
+        end
+      rescue Timeout::Error
+      end
+      return false
+    end
+
     def request(cmd)
-      s = TCPSocket.open(@host, @port)
-      s.puts "#{JSON.generate(cmd)}\r\n"
-      data = s.gets.chomp
-      s.close
-      JSON.parse(data)
+      begin
+        Timeout.timeout(0.5) do
+          s = TCPSocket.open(@host, @port)
+          s.puts "#{JSON.generate(cmd)}\r\n"
+          data = s.gets.chomp
+          s.close
+          JSON.parse(data)
+        end
+      rescue Timeout::Error
+        puts "Yeelight connection timed out. Yeelight not accessible"
+      end
     end
 
     # This method is used to retrieve current property of smart LED.
@@ -37,38 +59,44 @@ module Xilight
       request({id: 1,method: 'get_prop', params: values})
     end
 
-    # This method is used to change the color temperature of a smart LED.
+    # This method is used to change the color temperature of the smart LED.
     def set_ct_abx(ct_value, effect='smooth', duration=200)
       request({id: 2,method: 'set_ct_abx', params: [ct_value,effect,duration]})
     end
 
+    # This method is used to change the color temperature of the smart LED.
     def ct_abx=ct_value
       set_ct_abx(ct_value)
     end
 
-    # This method is used to change the color RGB of a smart LED.
+    # This method is used to change the color RGB of the smart LED.
+    # Expects an integer representing a hex triplet (e.g. 0xFFFFFF )
     def set_rgb(rgb_value, effect='smooth', duration=200)
       request({id: 3,method: 'set_rgb', params: [rgb_value,effect,duration]})
     end
 
+    # This method is used to change the color RGB of the smart LED.
+    # Expects an integer representing a hex triplet (e.g. 0xFFFFFF )
     def rgb=rgb_value
       set_rgb(rgb_value)
     end
 
-    # This method is used to change the color HSV of a smart LED.
+    # This method is used to change the color HSV of the smart LED.
     def set_hsv(hue, sat, effect='smooth', duration=200)
       request({id: 4,method: 'set_hsv', params: [hue,sat,effect,duration]})
     end
 
+    # This method is used to change the color HSV of the smart LED.
     def hsv=hue
       set_hsv(hue)
     end
 
-    # This method is used to change the brightness of a smart LED.
+    # This method is used to change the brightness of the smart LED.
     def set_bright(brightness, effect='smooth', duration=200)
       request({id: 5,method: 'set_bright', params: [brightness,effect,duration]})
     end
 
+    # This method is used to change the brightness of the smart LED.
     def bright=brightness
       set_bright(brightness)
     end
@@ -78,6 +106,7 @@ module Xilight
       request({id: 6,method: 'set_power', params: [power,effect,duration]})
     end
 
+    # This method is used to switch on or off the smart LED (software managed on/off).
     def power=power
       set_power(power)
     end
@@ -87,19 +116,18 @@ module Xilight
       request({id: 7,method: 'toggle', params: []})
     end
 
-    # This method is used to save current state of smart LED in persistent memory.
-    # So if user powers off and then powers on the smart LED again (hard power reset),
-    # the smart LED will show last saved state.
-    # Note: The "automatic state saving" must be turn off
+    # This method is used to save the current state of smart LED in persistent memory.
+    # If user powers off and then powers on the smart LED again (hard power reset),
+    # the smart LED will show last the saved state.
     def set_default
       request({id: 8,method: 'set_default', params: []})
     end
 
     # This method is used to start a color flow. Color flow is a series of smart
-    # LED visible state changing. It can be brightness changing, color changing
+    # LED visible state changes. It can be either brightness changing, color changing
     # or color temperature changing
-    def start_cf(count, action, flow_expression)
-      request({id: 9,method: 'set_power', params: [count,action,flow_expression]})
+    def start_cf(count=0, action=1, flow_expression="1000,2,2700,100,500,1,255,10,5000,7,0,0,500,2,5000,1")
+      request({id: 9, method: 'start_cf', params: [count,action,flow_expression]})
     end
 
     # This method is used to stop a running color flow.
@@ -108,8 +136,8 @@ module Xilight
     end
 
     # This method is used to set the smart LED directly to specified state. If
-    # the smart LED is off, then it will turn on the smart LED firstly and then
-    # apply the specified scommand.
+    # the smart LED is off, then it will first turn on the smartLED  and then
+    # apply the specified command.
     def set_scene(classe, val1, val2)
       request({id: 11,method: 'set_scene', params: [classe,val1,val2]})
     end
@@ -131,14 +159,14 @@ module Xilight
     end
 
     # This method is used to change brightness, CT or color of a smart LED
-    # without knowing the current value, it's main used by controllers.
+    # without knowing the current value, it's mainly used by controllers.
     def set_adjust(action, prop)
       request({id: 15,method: 'set_adjust', params: [action,prop]})
     end
 
     # This method is used to name the device. The name will be stored on the
-    # device and reported in discovering response. User can also read the name
-    # through “get_prop” method.
+    # device and reported in the discovery response. Users can also read the device name
+    # through the “get_prop” method.
     def set_name(name)
       request({id: 16,method: 'set_name', params: [name]})
     end
@@ -158,7 +186,7 @@ module Xilight
     end
 
 
-    # This method is used to discover a smart LED in the network
+    # This method is used to discover a smart LED on the local network
     def self.discover
       host = "239.255.255.250"
       port = 1982

data/lib/xilight/version.rb

@@ -1,3 +1,3 @@
-module Yeelight
-  VERSION = "0.1.1"
+module Xilight
+  VERSION = "0.1.8"
 end

data/xilight.gemspec

@@ -5,12 +5,13 @@ require 'xilight/version'
 
 Gem::Specification.new do |spec|
   spec.name          = "xilight"
-  spec.version       = Yeelight::VERSION
+  spec.version       = Xilight::VERSION
   spec.authors       = ["Wouter Coppieters"]
   spec.email         = ["wouter@youdo.co.nz"]
 
   spec.summary       = "Ruby Xiaomi Yeelight gem"
   spec.description   = "Ruby Xiaomi Yeelight gem"
+  spec.homepage      = "https://github.com/wouterken/xilight"
 
   # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
   # to allow pushing to a single host or delete this section to allow pushing to any host.
@@ -29,7 +30,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
   spec.add_runtime_dependency "dry-cli"
   spec.add_development_dependency "bundler", "~> 1.13"
-  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rake", ">= 12.3.3"
   spec.add_development_dependency "pry"
   spec.add_development_dependency "pry-byebug"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: xilight
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.8
 platform: ruby
 authors:
 - Wouter Coppieters
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-06-26 00:00:00.000000000 Z
+date: 2020-07-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-cli
@@ -42,16 +42,16 @@ dependencies:
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 12.3.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 12.3.3
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -89,6 +89,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".ruby-version"
 - CODE_OF_CONDUCT.md
 - Gemfile
 - README.md
@@ -99,7 +100,7 @@ files:
 - lib/xilight.rb
 - lib/xilight/version.rb
 - xilight.gemspec
-homepage: 
+homepage: https://github.com/wouterken/xilight
 licenses: []
 metadata: {}
 post_install_message: 
@@ -117,7 +118,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: Ruby Xiaomi Yeelight gem