raspberry_pi_iot 0.0.8 → 0.1.3

data/lib/iot/digital_receptor.rb

@@ -0,0 +1,17 @@
+require_relative 'receptor'
+
+module IoT
+  # DigitalReceptor - receptor with digitized values
+  class DigitalReceptor < IoT::Receptor
+    @@one_wire_bus = '/sys/bus/w1/devices'
+    @sensor_file = nil
+
+    def self.one_wire_file(prefix='28*', device='w1_slave')
+      files = Dir[@@one_wire_bus+'/'+prefix]
+      if files.size > 0 then
+        @sensor_file = files[0]+'/'+device
+      end
+      @sensor_file
+    end
+  end
+end

data/lib/iot/digital_sensor.rb

@@ -0,0 +1,7 @@
+require_relative 'digital_receptor'
+
+module IoT
+  # DigitalSensor - a synonym for DigitalReceptor
+  class DigitalSensor < IoT::DigitalReceptor
+  end
+end

data/lib/iot/ds18b20.rb

@@ -0,0 +1,25 @@
+require_relative 'temperature_sensor'
+
+# DS18B20 - high precision temperature sensor with 1-wire interface
+module IoT
+  class DS18B20 < IoT::TemperatureSensor
+
+    def initialize(device='w1_slave')
+      self.name = 'DS18B20'
+      @sensor_file = DigitalReceptor.one_wire_file('28*', device)
+      if @sensor_file
+        @temperature = read_data
+      else
+        raise "#{self.name} - Sensor NOT FOUND!"
+      end
+    end
+
+    def read_data
+      File.open(@sensor_file, 'r') do |f|
+        value = f.read
+        @temperature = value.scan(/t=(\d+)/).flatten[0].to_i/1000.0
+      end
+      @temperature
+    end
+  end
+end

data/lib/iot/effector.rb

@@ -0,0 +1,32 @@
+# https://github.com/ClockVapor/rpi_gpio
+require 'rpi_gpio'
+
+RPi::GPIO.set_warnings(false)
+RPi::GPIO.set_numbering :bcm
+
+module IoT
+  # Effector - a controlled physical device that performs some (useful) action
+  class Effector
+    def initialize
+      @model = 'N/A'
+      @name = 'N/A'
+    end
+
+    def name
+      @name
+    end
+
+    def model_name
+      @model
+    end
+
+protected
+    def name=(name)
+      @name = name
+    end
+
+    def model_name=(name)
+      @model_name = name
+    end
+  end
+end

data/lib/iot/hcsr501.rb

@@ -0,0 +1,8 @@
+require_relative 'binary_sensor'
+
+module IoT
+  # HCSR501 - PIR sensor
+  class HCSR501 < IoT::BinarySensor
+    # TODO: implement and test
+  end
+end

data/lib/iot/humiture_sensor.rb

@@ -0,0 +1,27 @@
+require_relative 'temperature_sensor'
+
+module IoT
+  # HumitureSensor - combined humidity & temperature sensor
+  class HumitureSensor < IoT::TemperatureSensor
+    @humidity = 0.0
+    @temperature = 0.0
+
+    def initialize
+      @humidity, @temperature = read_data
+    end
+
+    def read_data
+      [@humidity, @temperature]
+    end
+
+    # Humidity in per cents
+    def humidity
+      @humidity
+    end
+
+    # Temperature & humidity as a string
+    def to_s
+      sprintf "%5.2f°, %5.2f %%", @temperature, @humidity
+    end
+  end
+end

data/lib/iot/led.rb

@@ -0,0 +1,64 @@
+require_relative 'binary_effector'
+
+module IoT
+  # LED - Light Emitting Diode
+  class LED < IoT::BinaryEffector
+    def initialize(pin)
+      super(pin)
+      self.name = 'LED'
+    end
+
+    # Turn on the LED.
+    def on(pin=@pin)
+      super(pin)
+    end
+
+    # Turn off the LED.
+    def off(pin=@pin)
+      super(pin)
+    end
+
+    # Repeat 'repeat' times: light the LED for 'switched_on' secs, then pause for 'switched_off' secs
+    def blink(repeat=3, switched_on=0.25, switched_off=0.5)
+      repeat.times do |n|
+        on
+        sleep switched_on
+        off
+        sleep switched_off
+      end
+    end
+
+    # Turn the LED on for N seconds.
+    def on_for(seconds=1)
+      on
+      sleep seconds
+      off
+    end
+
+    # Turn the LED off for N seconds.
+    def off_for(seconds=1)
+      off
+      sleep seconds
+      on
+    end
+  end
+
+# Experimental methods with names in Russian
+  class LED
+    def LED.создать(pin = 25)
+      LED.new(pin)
+    end
+
+    def включить
+      on
+    end
+
+    def выключить
+      off
+    end
+
+    def мигать(repeat=3, switched_on=0.25, switched_off=0.5)
+      blink(repeat, switched_on, switched_off)
+    end
+  end
+end

data/lib/iot/led_pwm.rb

@@ -0,0 +1,8 @@
+require_relative 'led'
+
+module IoT
+  class LED
+    class PWM
+    end
+  end
+end

data/lib/iot/led_rgb.rb

@@ -0,0 +1,86 @@
+require_relative 'led'
+
+module IoT
+  class LED
+    class RGB < IoT::DigitalEffector
+      @red   = nil # GPIO pins
+      @green = nil #
+      @blue  = nil #
+
+      def initialize(red = 17, green = 27, blue = 22)
+        super({:red => red, :green => green, :blue => blue}, :low)
+        @red   = red
+        @green = green
+        @blue  = blue
+        self.name = 'RGB LED'
+      end
+
+      def on(color=:all)
+        color = :aoi if color == :aqua
+        case color
+        when :red
+          super @red
+        when :green
+          super @green
+        when :blue
+          super @blue
+        when :yellow
+          super @red
+          super @green
+        when :aoi
+          super @blue
+          super @green
+        when :all
+          super @red
+          super @green
+          super @blue
+        else
+        end
+      end
+
+      def off(color=:all)
+        color = :aoi if color == :aqua
+        case color
+        when :red
+          super @red
+        when :green
+          super @green
+        when :blue
+          super @blue
+        when :yellow
+          super @red
+          super @green
+        when :aoi
+          super @blue
+          super @green
+        when :all
+          super @red
+          super @green
+          super @blue
+        else
+          all_off
+        end
+      end
+
+      def all_on
+        on :all
+      end
+
+      def all_off
+        off :all
+      end
+
+      def blink(list = :all, repeat=3, switched_on=0.25, switched_off=0.5)
+        colors = (list == :all) ? [:red, :green, :blue] : (list.class == Array ? list : [list])
+        repeat.times do |n|
+          colors.each do |color|
+            on color
+            sleep switched_on
+            off color
+            sleep switched_off
+          end
+        end
+      end
+    end
+  end
+end

data/lib/iot/max44009.rb

@@ -0,0 +1,84 @@
+require 'bus'
+
+module IoT
+  # MAX44009 - low-power ambient Light Sensor
+  # Output: digital, Bus: I²C, Range: 0.045..188,000 Lux, VCC: 1.7..3.6V, Operating Current: 0.65µA
+  # https://datasheets.maximintegrated.com/en/ds/MAX44009.pdf
+  class MAX44009
+    MAX44009_DEFAULT_ADDRESS = 0x4A
+    # MAX44009 Register Map
+    MAX44009_REG_INTR_STATUS = 0x00 # Interrupt Status Register
+    MAX44009_REG_INTR_ENABLE = 0x01 # Interrupt Enable Register
+    MAX44009_REG_CONFIG = 0x02 # Configuration Register
+    MAX44009_REG_LUX_HIGH = 0x03 # Lux High Byte
+    MAX44009_REG_LUX_LOW = 0x04 # Lux Low Byte
+    MAX44009_REG_THRES_UP_HI = 0x05 # Upper Threshold High Byte
+    MAX44009_REG_THRES_LO_HI = 0x06 # Upper Threshold Low Byte
+    MAX44009_REG_THRES_TIMER = 0x07 # Threshold Timer
+    # MAX44009 INTERRUPT ENABLE REGISTER
+    MAX44009_REG_INTR_ENABLE_NO_ASSRT = 0x00 # The INT pin and the INTS bit are not asserted even if an interrupt event has occurred
+    MAX44009_REG_INTR_ENABLE_TRIGGER = 0x01 # Detection of an interrupt event triggers a hardware interrupt
+    # MAX44009 CONFIGURATION REGISTER
+    MAX44009_REG_CONFIG_CONTMODE_DEFAULT = 0x00 # Default mode
+    MAX44009_REG_CONFIG_CONTMODE_CONTIN = 0x80 # Continuous mode
+    MAX44009_REG_CONFIG_MANUAL_DEFAULT = 0x00 # Default mode of configuration is used for the IC
+    MAX44009_REG_CONFIG_MANUAL_MODEON = 0x40 # Manual mode of configuration is used for the IC
+    MAX44009_REG_CONFIG_CDR_NODIVIDED = 0x00 # Current not divided. All of the photodiode current goes to the ADC
+    MAX44009_REG_CONFIG_CDR_DIVIDED = 0x08 # Current divided by 8
+    MAX44009_REG_CONFIG_INTRTIMER_800 = 0x00 # Integration Time = 800ms, This is a preferred mode for boosting low-light sensitivity
+    MAX44009_REG_CONFIG_INTRTIMER_400 = 0x01 # Integration Time = 400ms
+    MAX44009_REG_CONFIG_INTRTIMER_200 = 0x02 # Integration Time = 200ms
+    MAX44009_REG_CONFIG_INTRTIMER_100 = 0x03 # Integration Time = 100ms, This is a preferred mode for high-brightness applications
+    MAX44009_REG_CONFIG_INTRTIMER_50 = 0x04 # Integration Time = 50ms, Manual Mode only
+    MAX44009_REG_CONFIG_INTRTIMER_25 = 0x05 # Integration Time = 25ms, Manual Mode only
+    MAX44009_REG_CONFIG_INTRTIMER_12_5 = 0x06 # Integration Time = 12.5ms, Manual Mode only
+    MAX44009_REG_CONFIG_INTRTIMER_6_25 = 0x07 # Integration Time = 6.25ms, Manual Mode only
+ 
+    DEVICE = MAX44009_DEFAULT_ADDRESS # I2C sensor address
+
+    def initialize(i2c_bus='/dev/i2c-1')
+      @sensor_name = 'MAX44009'
+      @i2c_bus = i2c_bus
+      @device = I2CDevice.new(address: DEVICE, driver: I2CDevice::Driver::I2CDev.new(@i2c_bus))
+      write_config()
+      @length = 2
+      @value = read_sensor
+    end
+
+    def name
+      @sensor_name
+    end
+
+    def write_config()
+      # Select the configuration register data from the given provided values
+      config = (MAX44009_REG_CONFIG_CONTMODE_CONTIN | MAX44009_REG_CONFIG_MANUAL_MODEON | MAX44009_REG_CONFIG_CDR_NODIVIDED | MAX44009_REG_CONFIG_INTRTIMER_800)
+      @device.i2cset(MAX44009_REG_CONFIG, config)
+    end
+
+    def read_sensor
+      # Read data back from MAX44009_REG_LUX_HIGH(0x03), 2 bytes, luminance MSB, luminance LSB
+      data = @device.i2cget(MAX44009_REG_LUX_HIGH, 2)
+      @value = data_to_lux(data)
+    end
+
+    def lux
+    # Return value in LX
+      read_sensor
+      @value
+    end
+
+private
+    # Convert the data to lux
+    def data_to_lux(data)
+      exponent = (data[0].ord & 0xF0) >> 4
+      mantissa = ((data[0].ord & 0x0F) << 4) | (data[1].ord & 0x0F)
+      luminance = ((2 ** exponent) * mantissa) * 0.045
+      luminance
+    end
+
+    # convert sensor data to a float number
+    def to_f(data)
+      return ((data[1].ord + (256 * data[0].ord)) / 1.2)
+    end
+  end
+end

data/lib/iot/receptor.rb

@@ -0,0 +1,38 @@
+require 'rpi_gpio'
+
+RPi::GPIO.set_warnings(false)
+RPi::GPIO.set_numbering :bcm
+
+module IoT
+  # Receptor - physical device that can provide info about real world
+  class Receptor
+    def initialize
+      @model = 'N/A'
+      @name = 'N/A'
+      @value = nil
+    end
+
+    def name
+      @name
+    end
+
+    def model_name
+      @model
+    end
+
+    def read
+      @value
+    end
+
+    alias read_sensor read
+
+protected
+    def name=(name)
+      @name = name
+    end
+
+    def model_name=(name)
+      @model_name = name
+    end
+  end
+end

data/lib/iot/sensor.rb

@@ -0,0 +1,8 @@
+require_relative 'receptor'
+
+module IoT
+  # Sensor - a synonym for Receptor
+  class Sensor < IoT::Receptor
+
+  end
+end

data/lib/iot/temperature_sensor.rb

@@ -0,0 +1,51 @@
+require_relative 'digital_sensor'
+
+module IoT
+  # TemperatureSensor - temperature sensing receptor
+  class IoT::TemperatureSensor < IoT::DigitalSensor
+    @temperature = 0.0
+
+    def initialize
+      @temperature = read_data
+    end
+
+    def read_data
+      @temperature
+    end
+
+    def celsius
+      @temperature
+    end
+
+    def fahrenheit
+      @temperature * 9.0 / 5.0 + 32
+    end
+
+    def kelvin
+      @temperature + 273.15
+    end
+
+    def reaumur
+      @temperature * 0.8
+    end
+
+    def to_s
+      sprintf "%5.2f°C", @temperature
+    end
+
+    def temperature(mode=:celsius)
+      case mode
+      when :celsius
+        celsius
+      when :fahrenheit
+        fahrenheit
+      when :kelvin
+        kelvin
+      when :reaumur
+        reaumur
+      else
+        celsius
+      end
+    end
+  end
+end