tellstickr 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2f9c593af7b0656ef65d091c54dfc34332947044
+  data.tar.gz: fee091caf447495e468d0d7c0ec051be99625cf9
+SHA512:
+  metadata.gz: c419997ae2367ae56ab7186b2d4d85b016998cc24644f86221737fdca3f747f44b3897dfbf8196da858f2c11eeee3ed504cea76a62707a8b60867701fa3f12e5
+  data.tar.gz: 0d6439eb5b4e2735b879ddb854c5d782d06e1c69effabb703ce5aca425666b2f4b3698a21bb60feb216b03caa35f72361d3002e0cfe216b481c09553c36d6814

data/.gitignore

@@ -0,0 +1,7 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.rvmrc
+tmp/
+coverage

data/Gemfile

@@ -0,0 +1,2 @@
+source "https://rubygems.org"
+gemspec

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2013 Per-Kristian Nordnes
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,73 @@
+# TellStickR
+
+This is a Gem for communicating with the Telldus TellStick and TellStick Duo through the official telldus-core C library in Ruby.
+
+It also includes device and sensor helper classes for easy communication with various devices and sensors.
+
+If you didn't know, TellSticks are USB radio frequency transmitters which turns any computer into a wireless home automation center (switch on/off electronic devices, read values from sensors, etc).
+
+So far, version 2.1.0 of the telldus-core API is supported.
+
+If you would like to contribute to this code, you are more than welcome to do so!
+
+## Usage
+
+### TellStickR::Core
+This is the binding to the telldus-core C library, with all functions and statics defined.
+Documentation on these can be found here: http://developer.telldus.se/doxygen/group__core.html
+
+### TellStickR::Device
+Class for easy discovery and manipulation of devices.
+
+```
+devices = TellStickR::Device.discover
+device = devices.first
+# Turn it on
+device.on
+# Turn if off
+device.off
+# Make it ring (if supported)
+device.bell
+```
+
+### TellStickR::Sensor
+Class for easy discovery and reading sensors.
+
+```
+sensors = TellStickR::Sensor.discover
+sensor = sensors.first
+
+# Poll temperature
+sensor.temperature
+
+# Poll humidity
+sensor.humidtity 
+
+# Register a callback that will be called when the sensor receives new data:
+callback_id = sensor.register_callback(lambda{|data| puts data.inspect})
+
+# Unregister a spesific callback:
+sensor.unregister_callback(callback_id)
+
+# Unregister all callbacks:
+sensor.unregister_callbacks
+
+# If you know the make and sensor id, you can do this
+# (as long as it's defined in TellStickR::Sensor::PREDEFINED_SENSORS):
+sensor = TellStickR::Sensor.from_predefined(:wt450h, 11)
+```
+
+## Links
+
+* http://www.telldus.se/products/tellstick
+* http://developer.telldus.se/
+
+## Yos and tnx:
+
+- Virus84 for the nice telldus-core on Raspberry Pi guide (https://blogg.itslav.nu/?p=875) which led to this project.
+- Hallvar Helleseth for pointing out the Ruby FFI route.
+- Kristoffer Sivertsen for introducing me to Tellsticks in the first place :)
+- Telldus for a awesome, cheap and trouble-free product!
+
+## Legal
+Copyright (c) 2013 Per-Kristian Nordnes. Released under the MIT license. See the file LICENSE.

data/lib/tellstickr.rb

@@ -0,0 +1,5 @@
+require_relative "./tellstickr/version"
+require_relative "./tellstickr/error"
+require_relative "./tellstickr/core"
+require_relative "./tellstickr/device"
+require_relative "./tellstickr/sensor"

data/lib/tellstickr/core.rb

@@ -0,0 +1,121 @@
+require 'ffi'
+
+module TellStickR
+
+  class Core
+
+    # FFI wrapper for the telldus-core C library.
+    # Versions vary of telldus-core API vary, so far version 2.1.0 is supported.
+    # Functions for version 2.1.2 are implemented, but commented out for now.
+
+    extend FFI::Library
+    ffi_lib "telldus-core"
+
+    # Device method flags
+    TELLSTICK_TURNON = 1
+    TELLSTICK_TURNOFF = 2
+    TELLSTICK_BELL = 4
+    TELLSTICK_TOGGLE = 8
+    TELLSTICK_DIM = 16
+    TELLSTICK_LEARN = 32
+    TELLSTICK_EXECUTE = 64
+    TELLSTICK_UP = 128
+    TELLSTICK_DOWN = 256
+    TELLSTICK_STOP = 512
+
+    # Device types
+    TELLSTICK_TYPE_DEVICE = 1
+    TELLSTICK_TYPE_GROUP = 2
+    TELLSTICK_TYPE_SCENE = 3  
+
+    # Sensor value types
+    TELLSTICK_TEMPERATURE = 1
+    TELLSTICK_HUMIDITY = 2
+
+    #Controller type
+    TELLSTICK_CONTROLLER_TELLSTICK = 1
+    TELLSTICK_CONTROLLER_TELLSTICK_DUO = 2
+    TELLSTICK_CONTROLLER_TELLSTICK_NET = 3
+
+    # Device changes
+    TELLSTICK_DEVICE_ADDED = 1
+    TELLSTICK_DEVICE_CHANGED = 2
+    TELLSTICK_DEVICE_REMOVED = 3
+    TELLSTICK_DEVICE_STATE_CHANGED = 4
+
+    # Change types
+    TELLSTICK_CHANGE_NAME = 1
+    TELLSTICK_CHANGE_PROTOCOL = 2
+    TELLSTICK_CHANGE_MODEL = 3
+    TELLSTICK_CHANGE_METHOD = 4
+    TELLSTICK_CHANGE_AVAILABLE = 5
+    TELLSTICK_CHANGE_FIRMWARE = 6
+
+    # Error codes
+    TELLSTICK_SUCCESS = 0
+    TELLSTICK_ERROR_NOT_FOUND = -1
+    TELLSTICK_ERROR_PERMISSION_DENIED = -2
+    TELLSTICK_ERROR_DEVICE_NOT_FOUND = -3
+    TELLSTICK_ERROR_METHOD_NOT_SUPPORTED = -4
+    TELLSTICK_ERROR_COMMUNICATION = -5
+    TELLSTICK_ERROR_CONNECTING_SERVICE = -6
+    TELLSTICK_ERROR_UNKNOWN_RESPONSE = -7
+    TELLSTICK_ERROR_SYNTAX = -8
+    TELLSTICK_ERROR_BROKEN_PIPE = -9
+    TELLSTICK_ERROR_COMMUNICATING_SERVICE = -10
+    TELLSTICK_ERROR_UNKNOWN = -99
+
+    # Callbacks
+    callback :TDDeviceEvent, [:int, :int, :string, :int, :pointer], :void
+    callback :TDDeviceChangeEvent, [:int, :int, :int, :int], :void
+    callback :TDRawDeviceEvent, [:string, :int, :int], :void
+    callback :TDSensorEvent, [:string, :string, :int, :int, :string, :int, :int, :pointer], :void
+    callback :TDControllerEvent, [:int, :int, :int, :string, :int], :void
+
+    # Functions
+    attach_function :tdInit, [], :void  
+    attach_function :tdRegisterDeviceEvent, [:TDDeviceEvent, :pointer], :int
+    attach_function :tdRegisterRawDeviceEvent, [:TDRawDeviceEvent, :pointer], :int
+    attach_function :tdRegisterDeviceChangeEvent, [:TDDeviceChangeEvent, :pointer], :int
+    attach_function :tdRegisterSensorEvent, [:TDSensorEvent, :pointer], :int
+    # attach_function :tdRegisterControllerEvent, [:TDControllerEvent, :pointer], :int # Version 2.1.2
+    attach_function :tdUnregisterCallback, [:int], :void
+    attach_function :tdClose, [], :void
+    attach_function :tdReleaseString, [:string], :void
+    attach_function :tdTurnOn, [:int], :int
+    attach_function :tdTurnOff, [:int], :int
+    attach_function :tdBell, [:int], :int
+    attach_function :tdDim, [:int], :int
+    attach_function :tdExecute, [:int], :int
+    attach_function :tdUp, [:int], :int
+    attach_function :tdDown, [:int], :int
+    attach_function :tdStop, [:int], :int
+    attach_function :tdLearn, [:int], :int
+    attach_function :tdLastSentCommand, [:int, :int], :int
+    attach_function :tdLastSentValue, [:int], :string
+    attach_function :tdGetNumberOfDevices, [], :int
+    attach_function :tdGetDeviceId, [:int], :int
+    attach_function :tdGetDeviceType, [:int], :int
+    attach_function :tdGetName, [:int], :string
+    attach_function :tdSetName, [:int, :string], :bool
+    attach_function :tdGetProtocol, [:int], :string
+    attach_function :tdSetProtocol, [:int, :string], :bool
+    attach_function :tdGetModel, [:int], :string
+    attach_function :tdSetModel, [:int, :string], :bool
+    attach_function :tdSetDeviceParameter, [:int, :string, :string], :bool
+    attach_function :tdGetDeviceParameter, [:int, :string, :string], :string
+    attach_function :tdAddDevice, [], :int
+    attach_function :tdRemoveDevice, [:int], :bool
+    attach_function :tdMethods, [:int, :int], :int
+    attach_function :tdGetErrorString, [:int], :string
+    attach_function :tdSendRawCommand, [:string, :int], :int
+    attach_function :tdConnectTellStickController, [:int, :int, :string], :void
+    attach_function :tdDisconnectTellStickController, [:int, :int, :string], :void
+    attach_function :tdSensor, [:pointer, :int, :pointer, :int, :pointer, :pointer], :int
+    attach_function :tdSensorValue, [:string, :string, :int, :int, :pointer, :int, :pointer], :int
+    # attach_function :tdController, [:pointer, :pointer, :pointer, :int, :pointer], :int # Version 2.1.2
+    # attach_function :tdControllerValue, [:int, :pointer, :pointer, :int], :int # Version 2.1.2
+    # attach_function :tdSetControllerValue, [:int, :string, :string], :int # Version 2.1.2
+    # attach_function :tdRemoveController, [:int], :int # Version 2.1.2
+  end
+end

data/lib/tellstickr/device.rb

@@ -0,0 +1,55 @@
+module TellStickR
+
+  class Device
+
+    attr_reader :id, :name, :protocol, :model
+
+    def initialize(id, name, protocol, model)
+      @id = id
+      @name = name
+      @protocol = protocol
+      @model = model
+    end
+
+    def learn
+      result = TellStickR::Core.tdLearn(@id)
+      return true if result == TellStickR::Core::TELLSTICK_SUCCESS
+      raise TellStickR::Error.new(result)
+    end
+
+    def on
+      result = TellStickR::Core.tdTurnOn(@id)
+      return true if result == TellStickR::Core::TELLSTICK_SUCCESS
+      raise TellStickR::Error.new(result)
+    end
+
+    def off
+      result = TellStickR::Core.tdTurnOff(@id)
+      return true if result == TellStickR::Core::TELLSTICK_SUCCESS
+      raise TellStickR::Error.new(result)
+    end
+
+    def bell
+      result = TellStickR::Core.tdBell(@id)
+      return true if result == TellStickR::Core::TELLSTICK_SUCCESS
+      raise TellStickR::Error.new(result)
+    end
+
+    def self.discover
+      nr_of_devices = TellStickR::Core.tdGetNumberOfDevices
+      i = 0
+      devices = []
+      while(i < nr_of_devices) do
+        id = TellStickR::Core.tdGetDeviceId(i)
+        name = TellStickR::Core.tdGetName(i)
+        protocol = TellStickR::Core.tdGetProtocol(i)
+        model = TellStickR::Core.tdGetModel(i)
+        devices << Device.new(id, name, protocol, model)
+        i += 1
+      end
+      devices
+    end
+
+  end
+
+end

data/lib/tellstickr/error.rb

@@ -0,0 +1,38 @@
+module TellStickR
+
+    class Error < StandardError
+
+      def initialize(code)
+        @code = code
+        super(human_message)
+      end
+
+      def human_message
+        case @code
+          when TellStickR::Core::TELLSTICK_ERROR_NOT_FOUND
+            "Tellstick not found (#{@code})"
+          when TellStickR::Core::TELLSTICK_ERROR_PERMISSION_DENIED
+            "Permission denied accessing the Tellstick (#{@code})"
+          when TellStickR::Core::TELLSTICK_ERROR_DEVICE_NOT_FOUND
+            "The supplied device id was not found (#{@code})"
+          when TellStickR::Core::TELLSTICK_ERROR_METHOD_NOT_SUPPORTED
+            "The requested method is not supported by the device (#{@code})"
+          when TellStickR::Core::TELLSTICK_ERROR_COMMUNICATION
+            "An error occurred when communicating with the TellStick (#{@code})"
+          when TellStickR::Core::TELLSTICK_ERROR_CONNECTING_SERVICE
+            "The client library could not connect to the service. Maybe it is not running? (#{@code})"
+          when TellStickR::Core::TELLSTICK_ERROR_UNKNOWN_RESPONSE
+            "The client library received a response from the service it did not understand (#{@code})"
+          when TellStickR::Core::TELLSTICK_ERROR_SYNTAX
+            "Input/command could not be parsed or didn't follow input rules (#{@code})"
+          when TellStickR::Core::TELLSTICK_ERROR_BROKEN_PIPE
+            "Pipe broken during communication (#{@code})"
+          when TellStickR::Core::TELLSTICK_ERROR_COMMUNICATING_SERVICE
+            "Timeout waiting for response from the Telldus Service (#{@code})"
+          else TellStickR::Core::TELLSTICK_ERROR_UNKNOWN
+            "An unknown error has occurred (#{@code})"
+        end
+      end
+
+    end
+end

data/lib/tellstickr/sensor.rb

@@ -0,0 +1,98 @@
+module TellStickR
+
+  class Sensor
+
+    attr_reader :protocol, :model, :id
+
+    def initialize(protocol, model, id)
+      @protocol = protocol
+      @model = model
+      @id = id
+      @callback_functions = {}
+      TellStickR::Core.tdInit
+    end
+
+    def temperature
+      value  = FFI::MemoryPointer.new(:string, 4)
+      time  = FFI::MemoryPointer.new(:int, 2)
+      TellStickR::Core.tdSensorValue(@protocol, @model, @id, TellStickR::Core::TELLSTICK_TEMPERATURE, value, 4, time)
+      {value: value.get_string(0,4).to_f, time: Time.at(time.get_int32(0))}
+    end
+
+    def humidity
+      value = FFI::MemoryPointer.new(:string, 4)
+      time = FFI::MemoryPointer.new(:int, 2)
+      TellStickR::Core.tdSensorValue(@protocol, @model, @id, TellStickR::Core::TELLSTICK_HUMIDITY, value, 4, time)
+      {value: value.get_string(0,4).to_f, time: Time.at(time.get_int32(0))}
+    end
+
+    def register_callback(proc)
+      object_id  = FFI::MemoryPointer.new(:int32)
+      object_id.write_int32(self.object_id)
+      callback = Proc.new do |protocol, model, id, data_type, value, timestamp, callback_id, context|
+        sensor = ObjectSpace._id2ref(context.get_int32(0))
+        if id == sensor.id
+          sensor.callback_functions[callback_id].call({
+            kind: (data_type == TellStickR::Core::TELLSTICK_TEMPERATURE ? :temperature : :humidity),
+            value: value.to_f, time: Time.at(timestamp.to_i)
+          })
+        end
+      end
+      id = TellStickR::Core.tdRegisterSensorEvent(callback, object_id)
+      @callback_functions[id] = proc
+      id
+    end
+
+    def unregister_callback(id)
+      TellStickR::Core.tdUnregisterCallback(id)
+      @callback_functions.delete(id)
+    end
+
+    def unregister_callbacks
+      @callback_functions.each do |k,v|
+        TellStickR::Core.tdUnregisterCallback(k)
+        @callback_functions.delete(k)
+      end
+      @callback_functions
+    end
+
+    def self.discover
+      TellStickR::Core.tdInit
+      sensors = []
+      result = TellStickR::Core::TELLSTICK_SUCCESS
+      while(true) do
+        protocol = FFI::MemoryPointer.new(:string, 32)
+        model  = FFI::MemoryPointer.new(:string, 32)
+        data_types  = FFI::MemoryPointer.new(:int, 2)
+        id = FFI::MemoryPointer.new(:int, 2)
+        if TellStickR::Core.tdSensor(protocol, 32, model, 32, id, data_types) == TellStickR::Core::TELLSTICK_SUCCESS
+          sensors << Sensor.new(protocol.get_string(0, 32), model.get_string(0, 32), id.get_int32(0))
+        else
+          break
+        end
+      end
+      sensors
+    end
+
+    # A mapping of known protocols and models
+    # for different sensor products.
+    PREDEFINED_SENSORS = {
+      # Clas Ohlson Esic 36-179* sensors
+      wt450h: {
+        protocol: "mandolyn",
+        model: "temperaturehumidity"
+      }
+    }
+
+    def self.from_predefined(key, id)
+      predefined = PREDEFINED_SENSORS[key.to_sym]
+      if predefined
+        return Sensor.new(predefined[:protocol], predefined[:model], id)
+      else
+        raise "Unknown sensor product. Predefined sensors: #{PREDEFINED_SENSORS.map{|k,v| k}.join(', ')}"
+      end
+    end
+
+  end
+
+end

data/lib/tellstickr/version.rb

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

data/spec/spec_helper.rb

@@ -0,0 +1,17 @@
+require 'simplecov'
+require 'rspec'
+
+SimpleCov.add_filter 'spec'
+SimpleCov.add_filter 'config'
+SimpleCov.start
+
+require 'tellstickr'
+
+RSpec.configure do |c|
+  c.mock_with :rspec
+  c.before(:each) do
+  end
+  c.around(:each) do |example|
+    example.run
+  end
+end

data/spec/tellstickr/core_spec.rb

@@ -0,0 +1,48 @@
+require 'spec_helper'
+
+describe TellStickR::Core do
+  it 'has defined FFI-functions matching tellstick-core v. 2.1.0' do
+    functions = [
+      :tdInit, 
+      :tdRegisterDeviceEvent,
+      :tdRegisterRawDeviceEvent,
+      :tdRegisterDeviceChangeEvent,
+      :tdRegisterSensorEvent,
+      :tdUnregisterCallback,
+      :tdClose,
+      :tdReleaseString,
+      :tdTurnOn,
+      :tdTurnOff,
+      :tdBell,
+      :tdDim,
+      :tdExecute,
+      :tdUp,
+      :tdDown,
+      :tdStop,
+      :tdLearn,
+      :tdLastSentCommand,
+      :tdLastSentValue,
+      :tdGetNumberOfDevices,
+      :tdGetDeviceId,
+      :tdGetDeviceType,
+      :tdGetName,
+      :tdSetName,
+      :tdGetProtocol,
+      :tdSetProtocol,
+      :tdGetModel,
+      :tdSetModel,
+      :tdSetDeviceParameter,
+      :tdGetDeviceParameter,
+      :tdAddDevice,
+      :tdRemoveDevice,
+      :tdMethods,
+      :tdGetErrorString,
+      :tdSendRawCommand,
+      :tdConnectTellStickController,
+      :tdDisconnectTellStickController,
+      :tdSensor,
+      :tdSensorValue
+    ]
+    functions.select{|f| TellStickR::Core.methods.include?(f)}.size.should eq functions.size
+  end
+end

data/spec/tellstickr/device_spec.rb

@@ -0,0 +1,52 @@
+require 'spec_helper'
+describe TellStickR::Device do
+
+  let :device do
+    TellStickR::Device.new(12, "Lights", "arctech", "selflearning-switch:nexa")
+  end
+
+  it 'initializes' do
+    device.id.should eq 12
+    device.name.should eq "Lights"
+    device.protocol.should eq "arctech"
+    device.model.should eq "selflearning-switch:nexa"
+  end
+
+  it 'can learn' do
+    allow(TellStickR::Core).to receive(:tdLearn).and_return(TellStickR::Core::TELLSTICK_SUCCESS)
+    device.learn.should be_true
+  end
+
+  it 'can be turned on' do
+    allow(TellStickR::Core).to receive(:tdTurnOn).and_return(TellStickR::Core::TELLSTICK_SUCCESS)
+    device.on.should be_true
+  end
+
+  it 'can be turned off' do
+    allow(TellStickR::Core).to receive(:tdTurnOff).and_return(TellStickR::Core::TELLSTICK_SUCCESS)
+    device.off.should be_true
+  end
+
+  it 'can be belled' do
+    allow(TellStickR::Core).to receive(:tdBell).and_return(TellStickR::Core::TELLSTICK_SUCCESS)
+    device.bell.should be_true
+  end
+
+  it 'can discover devices' do
+    allow(TellStickR::Core).to receive(:tdGetNumberOfDevices).and_return(1)
+    allow(TellStickR::Core).to receive(:tdGetDeviceId).and_return(12)
+    allow(TellStickR::Core).to receive(:tdGetName).and_return("My Device")
+    allow(TellStickR::Core).to receive(:tdGetProtocol).and_return("arctech")
+    allow(TellStickR::Core).to receive(:tdGetModel).and_return("selflearning-switch:nexa")
+    TellStickR::Device.discover.first.name.should eq "My Device"
+    TellStickR::Device.discover.first.id.should eq 12
+    TellStickR::Device.discover.first.protocol.should eq "arctech"
+    TellStickR::Device.discover.first.model.should eq "selflearning-switch:nexa"
+  end
+
+  it 'gives human readable exception messages' do
+    allow(TellStickR::Core).to receive(:tdBell).and_return(TellStickR::Core::TELLSTICK_ERROR_METHOD_NOT_SUPPORTED)
+    lambda { device.bell }.should raise_error TellStickR::Error, "The requested method is not supported by the device (#{TellStickR::Core::TELLSTICK_ERROR_METHOD_NOT_SUPPORTED})"
+  end
+
+end

data/spec/tellstickr/sensor_spec.rb

@@ -0,0 +1,51 @@
+require 'spec_helper'
+
+describe TellStickR::Sensor do
+
+  let :sensor do
+    TellStickR::Sensor.new("mandolyn", "temperaturehumidity", 1)
+  end
+
+  it 'initializes' do
+    sensor.protocol.should eq "mandolyn"
+    sensor.model.should eq "temperaturehumidity"
+    sensor.id.should eq 1
+  end
+
+  it 'reads temperature' do
+    sensor.temperature.should == {:value=>0.to_f, :time=>Time.at(0)}
+  end
+
+  it 'reads humidity' do
+    sensor.humidity.should == {:value=>0.to_f, :time=>Time.at(0)}
+  end
+
+  it 'can discover sensors' do
+    TellStickR::Sensor.discover.class.should eq Array
+  end
+
+  it 'has a hash of predefined sensors for easy initialization' do
+    TellStickR::Sensor::PREDEFINED_SENSORS.keys.include?(:wt450h).should be_true
+  end
+
+  it "can initialize from a predefined sensor product if you know the wireless id, and it's defined in TellStickR::Sensor::PREDEFINED_SENSORS" do
+    TellStickR::Sensor.from_predefined(:wt450h, 11).class.should eq TellStickR::Sensor
+  end
+
+  it "can not initialize from a predefined sensor product if the product is not defined" do
+    lambda { TellStickR::Sensor.from_predefined(:wtf, 9)}.should raise_error
+  end
+
+  it 'can register callback functions which are callend when the sensor sends new values' do
+    sensor.register_callback(lambda{|data| puts data.inspect}).class.should eq Fixnum
+  end
+
+  it 'can unregister a callback function from id' do
+    sensor.unregister_callback(1).should be_nil
+  end
+
+  it 'can unregister all callbacks' do
+    sensor.unregister_callbacks.should == {}
+  end
+
+end

data/tellstickr.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "tellstickr/version"
+
+Gem::Specification.new do |s|
+  s.name        = "tellstickr"
+  s.version     = TellStickR::VERSION
+  s.authors     = ["Per-Kristian Nordnes"]
+  s.email       = ["per.kristian.nordnes@gmail.com"]
+  s.homepage    = "https://github.com/skogsmaskin/tellstickr"
+  s.summary     = %q{Gem for communicating with the Telldus TellStick and TellStick Duo through the official telldus-core C library in Ruby.}
+  s.description = %q{FFI wrapper for the telldus-core C library, and classes for easy communication with various devices and sensors.}
+  s.license     = "MIT"
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency "rspec"
+  s.add_development_dependency "simplecov"
+
+  s.add_runtime_dependency "ffi"
+
+end

metadata

@@ -0,0 +1,103 @@
+--- !ruby/object:Gem::Specification
+name: tellstickr
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Per-Kristian Nordnes
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-08-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ffi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: FFI wrapper for the telldus-core C library, and classes for easy communication
+  with various devices and sensors.
+email:
+- per.kristian.nordnes@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- lib/tellstickr.rb
+- lib/tellstickr/core.rb
+- lib/tellstickr/device.rb
+- lib/tellstickr/error.rb
+- lib/tellstickr/sensor.rb
+- lib/tellstickr/version.rb
+- spec/spec_helper.rb
+- spec/tellstickr/core_spec.rb
+- spec/tellstickr/device_spec.rb
+- spec/tellstickr/sensor_spec.rb
+- tellstickr.gemspec
+homepage: https://github.com/skogsmaskin/tellstickr
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Gem for communicating with the Telldus TellStick and TellStick Duo through
+  the official telldus-core C library in Ruby.
+test_files: []