Rubydeako

A Ruby library for interacting with Deako smart switches via local network discovery and control. This is an unoffical port of the Python pydeako library.

📦 RubyGems: https://rubygems.org/gems/rubydeako

• Device discovery via mDNS/Zeroconf
• Real-time device state updates
• Control power and dimming for compatible devices
• Thread-safe socket communication
• Automatic connection management with heartbeat monitoring

Add this line to your application's Gemfile:

gem 'rubydeako'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install rubydeako

require 'rubydeako'

# Create a discoverer to find Deako devices on the network
discoverer = Rubydeako::Discover::DeakoDiscoverer.new

# Create the main client
deako = Rubydeako::Deako.new(
  discoverer.method(:get_address),
  client_name: "MyRubyApp"
)

begin
  # Connect to a device
  deako.connect
  
  # Discover all devices
  deako.find_devices
  
  # List discovered devices
  deako.devices.each do |uuid, device|
    puts "Device: #{device['name']} (#{uuid})"
    puts "  Power: #{device['state']['power']}"
    puts "  Dimmable: #{device['dimmable']}"
  end
  
  # Control a device
  if deako.devices.any?
    first_uuid = deako.devices.keys.first
    
    # Turn on
    deako.control_device(first_uuid, true)
    
    # Dim to 50% (if dimmable)
    if deako.dimmable?(first_uuid)
      deako.control_device(first_uuid, true, dim: 50)
    end
    
    # Turn off
    deako.control_device(first_uuid, false)
  end
  
ensure
  deako.disconnect
  discoverer.stop
end

# Set up a callback for state changes
deako.set_state_callback(uuid) do
  puts "Device #{uuid} state changed!"
  state = deako.get_state(uuid)
  puts "Power: #{state['power']}, Dim: #{state['dim']}"
end

The main client class for controlling Deako devices.

Methods:

• connect - Establish connection to devices
• disconnect - Close all connections
• find_devices(timeout: 10) - Discover devices on network
• control_device(uuid, power, dim: nil) - Control device state
• get_name(uuid) - Get device name
• get_state(uuid) - Get device current state
• dimmable?(uuid) - Check if device supports dimming
• set_state_callback(uuid, callback) - Set state change callback

Handles mDNS discovery of Deako devices.

Methods:

• start - Begin device discovery
• stop - Stop discovery
• get_address - Get discovered device address

• dnssd - mDNS/Zeroconf service discovery
• async - Asynchronous I/O operations
• concurrent-ruby - Thread-safe collections

After checking out the repo, run bundle install to install dependencies. Then, run bundle exec rspec to run the tests.

Bug reports and pull requests are welcome on GitHub.

The gem is available as open source under the MIT License.

This library is a Ruby port of the Python pydeako library.