dredger-iot 0.1.2 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3249f8a115ef3351b820037510c1ef0259ae227eb881d191353ddd20378c7520
-  data.tar.gz: 1bbc867919f8ba1faa5640d5b1f39370646b4a41d133dab98da0966fe44c2bdc
+  metadata.gz: 6710d17818b007805d0634e65fde9048c5fb191b9a11d4c5ac3d09aeccf9483e
+  data.tar.gz: cb7d2e68d335ee490f902b9eaed4b30b6499b8a688336f47678619e862b48cf6
 SHA512:
-  metadata.gz: 10d9397170fa1c21e34a969595c21a48a4605cbceeb6b79c6833930a65bddaac5798d4537c881d0bda30decbb76a5029d35e5924180978c265b61e5a7f739e84
-  data.tar.gz: 6d9f92320c43eb23c92aee74cc60cc24bcbb5b44cf5409487047aa2e34b8380011d3a8a508612216edf2e9ff00c7eafda562e4e683c46fd7bb988898f22d0552
+  metadata.gz: c14e577283263ea3a3674280cf416bde53ce0c172776fe85c2a9bde00835d7b42fd5badf5bcff6e8dc16b041abae9d810ad7fe510f2afbb86a1c7ffcf0b9d35b
+  data.tar.gz: bb7fc628012d3f9e26d83a792e24fdf20493de7cf984dee32a17658221aa53a7e5b208c49bbd528bb431320354edec09b3dd4506b52fff1b05ae6b4965de1daf

data/CHANGELOG.md

@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.1] - 2025-10-05
+
+### Added
+- Examples: Raspberry Pi GPIO blink script (GPIO17)
+- Docs: Raspberry Pi OS instructions to enable I2C and 1-Wire
+
+## [0.2.0] - 2025-10-05
+
+### Added
+- New sensors: SHT31 (I2C temp/humidity), BH1750 (I2C lux), TSL2561 (I2C lux), INA219 (I2C bus voltage/current)
+- CLI: --shunt option for INA219 to specify shunt resistance (default 0.1 Ω)
+- Examples: example scripts for SHT31, BH1750, TSL2561, INA219
+
+### Changed
+- README: document new sensors and CLI usage
+- Coverage: exclude all provider implementations from coverage (hardware-dependent)
+
 ## [0.1.2] - 2025-10-04
 
 ### Added
@@ -53,7 +70,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - RuboCop configuration and compliance
 - Comprehensive documentation and usage examples
 
-[Unreleased]: https://github.com/TheMadBotterINC/dredger-iot/compare/v0.1.2...HEAD
+[Unreleased]: https://github.com/TheMadBotterINC/dredger-iot/compare/v0.2.1...HEAD
+[0.2.1]: https://github.com/TheMadBotterINC/dredger-iot/compare/v0.2.0...v0.2.1
+[0.2.0]: https://github.com/TheMadBotterINC/dredger-iot/compare/v0.1.2...v0.2.0
 [0.1.2]: https://github.com/TheMadBotterINC/dredger-iot/compare/v0.1.1...v0.1.2
 [0.1.1]: https://github.com/TheMadBotterINC/dredger-iot/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/TheMadBotterINC/dredger-iot/releases/tag/v0.1.0

data/README.md

@@ -70,6 +70,26 @@ Environment overrides:
 - `DREDGER_IOT_GPIO_BACKEND`: `simulation` | `libgpiod`
 - `DREDGER_IOT_I2C_BACKEND`: `simulation` | `linux`
 
+## Raspberry Pi GPIO label mapping
+
+When the libgpiod backend is selected via Auto, Dredger-IoT resolves Raspberry Pi labels to the corresponding chip:line before accessing the GPIO line. Accepted labels:
+- GPIO17 or BCM17 (Broadcom numbering)
+- PIN11 or BOARD11 (header pin numbers)
+
+On most Raspberry Pi boards, GPIO lines are exposed on gpiochip0 and the line offset matches the BCM number. The adapter will translate labels accordingly.
+
+Example:
+
+```ruby path=null start=null
+require 'dredger/iot'
+
+gpio = Dredger::IoT::Bus::Auto.gpio # picks libgpiod on RPi, otherwise simulation
+
+# Use Raspberry Pi labels
+gpio.set_direction('GPIO17', :out)
+gpio.write('GPIO17', 1)
+```
+
 ## Beaglebone P9_XX label mapping
 
 When the libgpiod backend is selected via Auto, Dredger-IoT resolves Beaglebone labels like `P9_12` to the corresponding `gpiochipN:line` before accessing the GPIO line. A minimal built-in table is provided and can be extended in future releases.
@@ -98,9 +118,58 @@ Dredger-IoT includes drivers for popular embedded sensors:
 - **DS18B20** - 1-Wire digital temperature sensor
 - **BMP180** - I2C barometric pressure/temperature sensor
 - **MCP9808** - I2C high-accuracy temperature sensor
+- **SHT31** - I2C temperature/humidity sensor
+- **BH1750** - I2C ambient light sensor (lux)
+- **TSL2561** - I2C ambient light sensor (lux)
+- **INA219** - I2C bus voltage/current monitor
 
 Sensors use a provider pattern for testability and hardware abstraction.
 
+## CLI Usage
+
+Commands:
+- list-sensors
+  - List available sensor types supported by dredger-iot.
+- read SENSOR [ARGS]
+  - Read once or continuously from a sensor.
+  - Examples:
+    - dredger read bme280 0x76
+    - dredger read dht22 P9_12
+    - dredger read ina219 0x40 --shunt 0.1
+- test-gpio PIN
+  - Simple blink test to verify GPIO output works.
+- test-i2c
+  - Scans a few common I2C addresses (hardware backend only).
+- info
+  - Prints version, detected backends, and environment variables.
+
+Options:
+- --backend BACKEND
+  - auto (default), simulation, hardware
+  - simulation forces both GPIO and I2C simulation backends
+  - hardware forces libgpiod (GPIO) and linux (I2C)
+- --format FORMAT
+  - text (default) or json
+- --interval SECONDS
+  - Poll continuously at the specified interval (e.g., 2.0)
+- --shunt OHMS
+  - INA219-only: specify the shunt resistance in ohms (default 0.1)
+
+Examples:
+```bash
+# Read a BME280 once (auto-detected backends)
+dredger read bme280 0x76
+
+# Read a DHT22 every 2 seconds, JSON output
+dredger read dht22 P9_12 --interval 2 --format json
+
+# Force simulation backends for local testing
+dredger --backend simulation read bh1750 0x23
+
+# INA219 with custom shunt
+dredger read ina219 0x40 --shunt 0.05
+```
+
 ## Usage Examples
 
 ### DHT22 Temperature/Humidity Sensor
@@ -304,6 +373,29 @@ ls /sys/bus/w1/devices/
 # Should show devices like: 28-00000xxxxxx
 ```
 
+#### Raspberry Pi OS: Enable I2C and 1-Wire
+
+On Raspberry Pi OS you can enable I2C and 1-Wire via raspi-config or by editing /boot/config.txt.
+
+Option A: raspi-config (recommended)
+```bash path=null start=null
+sudo raspi-config
+# Interface Options → I2C → Enable
+# Interface Options → 1-Wire → Enable
+sudo reboot
+```
+
+Option B: edit /boot/config.txt
+```bash path=null start=null
+# Enable I2C
+sudo sed -i 's/^#\?dtparam=i2c_arm=.*/dtparam=i2c_arm=on/' /boot/config.txt
+# Enable 1-Wire on default BCM4 (PIN7)
+echo 'dtoverlay=w1-gpio,gpiopin=4' | sudo tee -a /boot/config.txt
+sudo reboot
+```
+
+Note: Dredger-IoT accepts Raspberry Pi labels like GPIO17, BCM17, and PIN11.
+
 #### Beaglebone Black Device Tree
 
 For Beaglebone Black, you may need to enable device tree overlays:
@@ -483,6 +575,26 @@ reading.timestamp    # Time object when reading was taken
 - **`MCP9808`** - High-accuracy temperature (I2C)
   - Parameters: `i2c_addr` (default: `0x18`), `provider`
   - Returns: temperature (celsius)
+  
+- **`SHT31`** - Temperature/humidity (I2C)
+  - Parameters: `i2c_addr` (default: `0x44`), `provider`
+  - Returns: temperature (celsius), humidity (%)
+  
+- **`BH1750`** - Ambient light (I2C)
+  - Parameters: `i2c_addr` (default: `0x23`), `provider`
+  - Returns: illuminance (lux)
+  
+- **`TSL2561`** - Ambient light (I2C)
+  - Parameters: `i2c_addr` (default: `0x39`), `provider`
+  - Returns: illuminance (lux)
+  
+- **`INA219`** - Bus voltage/current monitor (I2C)
+  - Parameters: `i2c_addr` (default: `0x40`), `provider`
+  - Returns: bus_voltage (V), current (mA)
+  - CLI example:
+    ```bash path=null start=null
+    dredger read ina219 0x40 --shunt 0.1
+    ```
 
 ### Scheduling
 

data/bin/dredger

@@ -32,6 +32,8 @@ class DredgerCLI
       test_i2c
     when 'info'
       show_info
+    when 'doctor'
+      doctor
     else
       puts parser
       exit 1
@@ -53,6 +55,7 @@ class DredgerCLI
       opts.separator '  read SENSOR [OPTIONS]  Read from a sensor'
       opts.separator '  test-gpio PIN          Test GPIO pin'
       opts.separator '  test-i2c               Scan I2C bus'
+      opts.separator '  doctor                 Check system prerequisites'
       opts.separator '  info                   Show system information'
       opts.separator ''
       opts.separator 'Options:'
@@ -69,6 +72,10 @@ class DredgerCLI
         @options[:interval] = i
       end
 
+      opts.on('--shunt OHMS', Float, 'INA219 shunt resistance in ohms (default: 0.1)') do |ohms|
+        @options[:ina219_shunt] = ohms
+      end
+
       opts.on('-h', '--help', 'Show this help') do
         puts opts
         exit
@@ -87,7 +94,11 @@ class DredgerCLI
       'bme280' => 'BME280 - Temperature/Humidity/Pressure (I2C)',
       'ds18b20' => 'DS18B20 - Waterproof Temperature (1-Wire)',
       'bmp180' => 'BMP180 - Barometric Pressure/Temperature (I2C)',
-      'mcp9808' => 'MCP9808 - High-Accuracy Temperature (I2C)'
+      'mcp9808' => 'MCP9808 - High-Accuracy Temperature (I2C)',
+      'sht31' => 'SHT31 - Temperature/Humidity (I2C)',
+      'bh1750' => 'BH1750 - Ambient Light (I2C)',
+      'tsl2561' => 'TSL2561 - Ambient Light (I2C)',
+      'ina219' => 'INA219 - Bus Voltage/Current (I2C)'
     }
 
     puts 'Available Sensors:'
@@ -136,6 +147,27 @@ class DredgerCLI
         exit 1
       end
       Dredger::IoT::Sensors::DS18B20.new(device_id: device_id, provider: provider)
+    when 'sht31'
+      addr = (args.shift || '0x44').to_i(16)
+      i2c = Dredger::IoT::Bus::Auto.i2c
+      provider = Dredger::IoT::Sensors::SHT31Provider.new(i2c_bus: i2c)
+      Dredger::IoT::Sensors::SHT31.new(i2c_addr: addr, provider: provider)
+    when 'bh1750'
+      addr = (args.shift || '0x23').to_i(16)
+      i2c = Dredger::IoT::Bus::Auto.i2c
+      provider = Dredger::IoT::Sensors::BH1750Provider.new(i2c_bus: i2c)
+      Dredger::IoT::Sensors::BH1750.new(i2c_addr: addr, provider: provider)
+    when 'tsl2561'
+      addr = (args.shift || '0x39').to_i(16)
+      i2c = Dredger::IoT::Bus::Auto.i2c
+      provider = Dredger::IoT::Sensors::TSL2561Provider.new(i2c_bus: i2c)
+      Dredger::IoT::Sensors::TSL2561.new(i2c_addr: addr, provider: provider)
+    when 'ina219'
+      addr = (args.shift || '0x40').to_i(16)
+      i2c = Dredger::IoT::Bus::Auto.i2c
+      shunt = @options[:ina219_shunt] || 0.1
+      provider = Dredger::IoT::Sensors::INA219Provider.new(i2c_bus: i2c, shunt_resistance_ohms: shunt)
+      Dredger::IoT::Sensors::INA219.new(i2c_addr: addr, provider: provider)
     else
       puts "Error: Unknown sensor type '#{type}'"
       exit 1
@@ -241,6 +273,51 @@ class DredgerCLI
     puts "  DREDGER_IOT_I2C_BACKEND:  #{ENV['DREDGER_IOT_I2C_BACKEND'] || '(not set)'}"
   end
 
+  def doctor
+    puts 'Doctor: checking system prerequisites...'
+    puts
+    check_device_node('/dev/gpiochip0', 'GPIO (libgpiod) device')
+    check_device_node('/dev/i2c-1', 'I2C device (bus 1)')
+    check_path('/sys/bus/w1/devices', '1-Wire bus (DS18B20) directory')
+
+    puts
+    puts 'Kernel modules:'
+    mods = read_proc_modules
+    puts "  i2c-dev: #{mods.include?('i2c_dev') ? 'loaded' : 'missing'}"
+    puts "  w1-gpio: #{mods.include?('w1_gpio') ? 'loaded' : 'missing'}"
+    puts "  w1-therm: #{mods.include?('w1_therm') ? 'loaded' : 'missing'}"
+
+    puts
+    puts 'Recommendations:'
+    puts "  sudo apt-get install gpiod i2c-tools"
+    puts "  sudo usermod -a -G gpio $USER  # for GPIO access"
+    puts "  sudo usermod -a -G i2c $USER   # for I2C access"
+    puts "  sudo modprobe i2c-dev"
+    puts "  sudo modprobe w1-gpio; sudo modprobe w1-therm"
+  end
+
+  def check_device_node(path, desc)
+    if File.exist?(path)
+      puts "  ✔ #{desc}: present (#{path})"
+    else
+      puts "  ✖ #{desc}: missing (#{path})"
+    end
+  end
+
+  def check_path(path, desc)
+    if Dir.exist?(path)
+      puts "  ✔ #{desc}: present (#{path})"
+    else
+      puts "  ✖ #{desc}: missing (#{path})"
+    end
+  end
+
+  def read_proc_modules
+    File.read('/proc/modules')
+  rescue StandardError
+    ''
+  end
+
   def setup_backends
     case @options[:backend]
     when 'simulation'

data/lib/dredger/iot/bus/gpio_label_adapter.rb

@@ -5,9 +5,11 @@ module Dredger
     module Bus
       # Adapts label strings (e.g. 'P9_12') to PinRef with chip:line for libgpiod backends
       class GPIOLabelAdapter
-        def initialize(backend:, mapper: Dredger::IoT::Pins::Beaglebone)
+        # mapper can be a single mapper module/class or an Array of them.
+        # Defaults to both Beaglebone and RaspberryPi mappers.
+        def initialize(backend:, mapper: [Dredger::IoT::Pins::Beaglebone, Dredger::IoT::Pins::RaspberryPi])
           @backend = backend
-          @mapper = mapper
+          @mappers = Array(mapper)
         end
 
         def set_direction(pin, direction)
@@ -24,16 +26,24 @@ module Dredger
 
         private
 
+        # rubocop:disable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
         def resolve(pin)
           # Already a PinRef with line
           return pin if pin.respond_to?(:line) && !pin.line.nil?
+
           # Numeric line
           return Integer(pin) if pin.is_a?(Integer) || pin.to_s =~ /^\d+$/
-          # Beaglebone-style label
-          return @mapper.resolve_label_to_pinref(pin) if @mapper.respond_to?(:resolve_label_to_pinref)
+
+          # Try all mappers in order
+          @mappers.each do |m|
+            if m.respond_to?(:resolve_label_to_pinref) && m.respond_to?(:valid_label?) && m.valid_label?(pin)
+              return m.resolve_label_to_pinref(pin)
+            end
+          end
 
           raise ArgumentError, 'Unsupported pin format'
         end
+        # rubocop:enable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
       end
     end
   end

data/lib/dredger/iot/pins/raspberry_pi.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Dredger
+  module IoT
+    module Pins
+      # Raspberry Pi header/BCM label mapping.
+      # Supports labels like:
+      # - GPIO17, BCM17
+      # - PIN11 (a.k.a. BOARD11)
+      class RaspberryPi
+        PinRef = Struct.new(:label, :chip, :line, keyword_init: true) do
+          def to_s
+            chip && line ? "#{label}(chip#{chip}:#{line})" : label.to_s
+          end
+        end
+
+        # Subset of BOARD pin to BCM mapping for common usable GPIOs on 40-pin header
+        BOARD_TO_BCM = {
+          3 => 2, 5 => 3, 7 => 4, 8 => 14, 10 => 15, 11 => 17, 12 => 18, 13 => 27,
+          15 => 22, 16 => 23, 18 => 24, 19 => 10, 21 => 9, 22 => 25, 23 => 11,
+          24 => 8, 26 => 7, 29 => 5, 31 => 6, 32 => 12, 33 => 13, 35 => 19,
+          36 => 16, 37 => 26, 38 => 20, 40 => 21
+        }.freeze
+
+        # Accept variants like GPIO17, BCM17, PIN11, BOARD11
+        def self.valid_label?(label)
+          s = label.to_s.upcase
+          return true if s.match?(/^(GPIO|BCM)\d+$/)
+          return true if s.match?(/^(PIN|BOARD)\d+$/)
+
+          false
+        end
+
+        def self.resolve_label_to_pinref(label)
+          s = label.to_s.upcase
+          if s =~ /^(GPIO|BCM)(\d+)$/
+            bcm = Regexp.last_match(2).to_i
+            return PinRef.new(label: label.to_s, chip: 0, line: bcm)
+          end
+
+          if s =~ /^(PIN|BOARD)(\d+)$/
+            board = Regexp.last_match(2).to_i
+            bcm = BOARD_TO_BCM[board]
+            raise ArgumentError, "Unknown/unsupported board pin: #{label}" if bcm.nil?
+
+            return PinRef.new(label: label.to_s, chip: 0, line: bcm)
+          end
+
+          raise ArgumentError, "Unknown Raspberry Pi pin label: #{label}"
+        end
+      end
+    end
+  end
+end

data/lib/dredger/iot/pins.rb

@@ -1,3 +1,4 @@
 # frozen_string_literal: true
 
 require_relative 'pins/beaglebone'
+require_relative 'pins/raspberry_pi'

data/lib/dredger/iot/sensors/bh1750.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Dredger
+  module IoT
+    module Sensors
+      # BH1750 ambient light sensor (I2C)
+      # Provider must respond to :read_lux(addr) -> Float (lux)
+      class BH1750 < BaseSensor
+        def initialize(i2c_addr:, provider:, metadata: {})
+          super(metadata: metadata)
+          @i2c_addr = i2c_addr
+          @provider = provider
+        end
+
+        def readings
+          lux = @provider.read_lux(@i2c_addr)
+          [reading(sensor_type: 'illuminance', value: lux, unit: 'lux')]
+        end
+      end
+    end
+  end
+end

data/lib/dredger/iot/sensors/bh1750_provider.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Dredger
+  module IoT
+    module Sensors
+      # Hardware provider for BH1750 ambient light sensor (I2C)
+      # Measurement: Continuous High-Resolution Mode (1 lx, typical 120ms)
+      class BH1750Provider
+        POWER_ON = 0x01
+        RESET = 0x07
+        CONT_HIRES = 0x10
+
+        def initialize(i2c_bus:)
+          @i2c = i2c_bus
+        end
+
+        # Returns lux as Float
+        def read_lux(addr)
+          # Power on and reset
+          @i2c.write(addr, [POWER_ON])
+          @i2c.write(addr, [RESET])
+          # Start continuous high-resolution measurement
+          @i2c.write(addr, [CONT_HIRES])
+          # Wait for conversion
+          sleep(0.18)
+          # Read 2 bytes (big-endian)
+          bytes = @i2c.read(addr, 2)
+          raw = (bytes[0] << 8) | bytes[1]
+          (raw / 1.2).to_f
+        end
+      end
+    end
+  end
+end

data/lib/dredger/iot/sensors/ina219.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Dredger
+  module IoT
+    module Sensors
+      # INA219 current/voltage/power monitor (I2C)
+      # Provider must respond to :read_measurements(addr) -> { bus_voltage_v:, current_ma:, shunt_voltage_mv: }
+      class INA219 < BaseSensor
+        def initialize(i2c_addr:, provider:, metadata: {})
+          super(metadata: metadata)
+          @i2c_addr = i2c_addr
+          @provider = provider
+        end
+
+        def readings
+          m = @provider.read_measurements(@i2c_addr)
+          [
+            reading(sensor_type: 'bus_voltage', value: m[:bus_voltage_v], unit: 'V'),
+            reading(sensor_type: 'current', value: m[:current_ma], unit: 'mA')
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/dredger/iot/sensors/ina219_provider.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Dredger
+  module IoT
+    module Sensors
+      # Hardware provider for INA219 current/voltage monitor (I2C)
+      # Simplified: computes current from shunt voltage and provided shunt resistance,
+      # avoids calibration register dependency.
+      class INA219Provider
+        REG_SHUNT_VOLTAGE = 0x01
+        REG_BUS_VOLTAGE = 0x02
+
+        def initialize(i2c_bus:, shunt_resistance_ohms: 0.1)
+          @i2c = i2c_bus
+          @r_shunt = shunt_resistance_ohms.to_f
+        end
+
+        # Returns { bus_voltage_v: Float, current_ma: Float, shunt_voltage_mv: Float }
+        def read_measurements(addr)
+          shunt_raw = read_word(addr, REG_SHUNT_VOLTAGE, signed: true)
+          bus_raw = read_word(addr, REG_BUS_VOLTAGE, signed: false)
+
+          # Shunt voltage LSB = 10uV => mV = raw * 0.01
+          shunt_mv = shunt_raw * 0.01
+          # Current (mA) = (shunt_mv / R_ohms)
+          current_ma = (@r_shunt.positive? ? (shunt_mv / @r_shunt) : 0.0)
+
+          # Bus voltage: bits [15:3] * 4mV
+          bus_voltage_v = ((bus_raw >> 3) * 0.004)
+
+          {
+            bus_voltage_v: bus_voltage_v,
+            current_ma: current_ma,
+            shunt_voltage_mv: shunt_mv
+          }
+        end
+
+        private
+
+        # Read 16-bit word
+        # INA219 registers are big-endian; register reads may return bytes LSB-first
+        def read_word(addr, reg, signed: false)
+          bytes = @i2c.read(addr, 2, register: reg)
+          val = (bytes[0] << 8) | bytes[1]
+          if signed && val > 0x7FFF
+            val - 0x1_0000
+          else
+            val
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dredger/iot/sensors/sht31.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Dredger
+  module IoT
+    module Sensors
+      # SHT31 temperature/humidity sensor (I2C)
+      # Provider must respond to :read_measurements(addr) -> { temperature_c:, humidity: }
+      class SHT31 < BaseSensor
+        def initialize(i2c_addr:, provider:, metadata: {})
+          super(metadata: metadata)
+          @i2c_addr = i2c_addr
+          @provider = provider
+        end
+
+        def readings
+          m = @provider.read_measurements(@i2c_addr)
+          [
+            reading(sensor_type: 'temperature', value: m[:temperature_c], unit: 'celsius'),
+            reading(sensor_type: 'humidity', value: m[:humidity], unit: '%')
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/dredger/iot/sensors/sht31_provider.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Dredger
+  module IoT
+    module Sensors
+      # Hardware provider for Sensirion SHT31 temperature/humidity over I2C.
+      # Basic single-shot measurement without CRC checks for simplicity.
+      # Datasheet formula:
+      #  - Temperature (°C) = -45 + 175 * (ST / 65535)
+      #  - Humidity (%RH)  = 100 * (SRH / 65535)
+      class SHT31Provider
+        # I2C commands
+        CMD_SINGLE_SHOT_HIGHREP = [0x24, 0x00].freeze # High repeatability, clock stretching disabled
+
+        def initialize(i2c_bus:)
+          @i2c = i2c_bus
+        end
+
+        # Returns { temperature_c: Float, humidity: Float }
+        def read_measurements(addr)
+          # Trigger single-shot measurement
+          @i2c.write(addr, CMD_SINGLE_SHOT_HIGHREP)
+          # Max measurement duration ~15ms (high repeatability). Add margin.
+          sleep(0.02)
+
+          # Read 6 bytes: T_MSB, T_LSB, T_CRC, RH_MSB, RH_LSB, RH_CRC
+          data = @i2c.read(addr, 6)
+
+          st = (data[0] << 8) | data[1]
+          srh = (data[3] << 8) | data[4]
+
+          temp_c = -45.0 + (175.0 * st / 65_535.0)
+          humidity = (100.0 * srh / 65_535.0)
+          humidity = humidity.clamp(0.0, 100.0)
+
+          { temperature_c: temp_c, humidity: humidity }
+        end
+      end
+    end
+  end
+end

data/lib/dredger/iot/sensors/tsl2561.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Dredger
+  module IoT
+    module Sensors
+      # TSL2561 ambient light sensor (I2C)
+      # Provider must respond to :read_lux(addr) -> Float (lux)
+      class TSL2561 < BaseSensor
+        def initialize(i2c_addr:, provider:, metadata: {})
+          super(metadata: metadata)
+          @i2c_addr = i2c_addr
+          @provider = provider
+        end
+
+        def readings
+          lux = @provider.read_lux(@i2c_addr)
+          [reading(sensor_type: 'illuminance', value: lux, unit: 'lux')]
+        end
+      end
+    end
+  end
+end

data/lib/dredger/iot/sensors/tsl2561_provider.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Dredger
+  module IoT
+    module Sensors
+      # Hardware provider for TSL2561 ambient light sensor (I2C)
+      # Uses simple configuration: integration 402ms, low gain.
+      class TSL2561Provider
+        CMD = 0x80
+        CONTROL = 0x00
+        TIMING = 0x01
+        DATA0LOW = 0x0C
+        DATA1LOW = 0x0E
+
+        POWER_ON = 0x03
+        POWER_OFF = 0x00
+        INTEG_402MS = 0x02 # integration time bits [1:0] = 10
+        GAIN_LOW = 0x00    # gain bit [4] = 0
+
+        def initialize(i2c_bus:)
+          @i2c = i2c_bus
+        end
+
+        # Returns lux as Float
+        def read_lux(addr)
+          # Power on
+          @i2c.write(addr, [POWER_ON], register: CMD | CONTROL)
+          # Set timing: 402ms, low gain
+          @i2c.write(addr, [GAIN_LOW | INTEG_402MS], register: CMD | TIMING)
+
+          # Wait for integration
+          sleep(0.45)
+
+          ch0 = read_word(addr, CMD | DATA0LOW)
+          ch1 = read_word(addr, CMD | DATA1LOW)
+
+          compute_lux(ch0, ch1).to_f
+        ensure
+          # Power off to save energy
+          @i2c.write(addr, [POWER_OFF], register: CMD | CONTROL)
+        end
+
+        private
+
+        # Read 16-bit little-endian word from LSB register
+        def read_word(addr, reg)
+          bytes = @i2c.read(addr, 2, register: reg)
+          bytes[0] | (bytes[1] << 8)
+        end
+
+        # Lux calculation based on TSL2561 datasheet/Adafruit library
+        def compute_lux(ch0, ch1)
+          return 0.0 if ch0.zero?
+
+          ratio = ch1.to_f / ch0
+
+          if ratio <= 0.5
+            (0.0304 * ch0) - (0.062 * ch0 * (ratio**1.4))
+          elsif ratio <= 0.61
+            (0.0224 * ch0) - (0.031 * ch1)
+          elsif ratio <= 0.80
+            (0.0128 * ch0) - (0.0153 * ch1)
+          elsif ratio <= 1.30
+            (0.00146 * ch0) - (0.00112 * ch1)
+          else
+            0.0
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dredger/iot/sensors.rb

@@ -9,3 +9,11 @@ require_relative 'sensors/ds18b20'
 require_relative 'sensors/ds18b20_provider'
 require_relative 'sensors/bmp180'
 require_relative 'sensors/mcp9808'
+require_relative 'sensors/sht31'
+require_relative 'sensors/sht31_provider'
+require_relative 'sensors/bh1750'
+require_relative 'sensors/bh1750_provider'
+require_relative 'sensors/tsl2561'
+require_relative 'sensors/tsl2561_provider'
+require_relative 'sensors/ina219'
+require_relative 'sensors/ina219_provider'

data/lib/dredger/iot/version.rb

@@ -2,6 +2,6 @@
 
 module Dredger
   module IoT
-    VERSION = '0.1.2'
+    VERSION = '0.2.1'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dredger-iot
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.1
 platform: ruby
 authors:
 - The Mad Botter INC
@@ -49,10 +49,13 @@ files:
 - lib/dredger/iot/bus/i2c_linux.rb
 - lib/dredger/iot/pins.rb
 - lib/dredger/iot/pins/beaglebone.rb
+- lib/dredger/iot/pins/raspberry_pi.rb
 - lib/dredger/iot/reading.rb
 - lib/dredger/iot/scheduler.rb
 - lib/dredger/iot/sensors.rb
 - lib/dredger/iot/sensors/base_sensor.rb
+- lib/dredger/iot/sensors/bh1750.rb
+- lib/dredger/iot/sensors/bh1750_provider.rb
 - lib/dredger/iot/sensors/bme280.rb
 - lib/dredger/iot/sensors/bme280_provider.rb
 - lib/dredger/iot/sensors/bmp180.rb
@@ -60,7 +63,13 @@ files:
 - lib/dredger/iot/sensors/dht22_provider.rb
 - lib/dredger/iot/sensors/ds18b20.rb
 - lib/dredger/iot/sensors/ds18b20_provider.rb
+- lib/dredger/iot/sensors/ina219.rb
+- lib/dredger/iot/sensors/ina219_provider.rb
 - lib/dredger/iot/sensors/mcp9808.rb
+- lib/dredger/iot/sensors/sht31.rb
+- lib/dredger/iot/sensors/sht31_provider.rb
+- lib/dredger/iot/sensors/tsl2561.rb
+- lib/dredger/iot/sensors/tsl2561_provider.rb
 - lib/dredger/iot/version.rb
 homepage: https://github.com/TheMadBotterINC/dredger-iot
 licenses:
@@ -75,25 +84,27 @@ metadata:
   rubygems_mfa_required: 'true'
   keywords: iot, embedded, linux, gpio, i2c, beaglebone, raspberry-pi, hardware, sensors,
     dht22, bme280, ds18b20, bmp180, mcp9808, libgpiod, automation
-post_install_message: "\n═══════════════════════════════════════════════════════════════════\n
-  \                                                              \n                  _______________
-  \                             \n                 |  DREDGER-IoT  |                            \n
-  \                |_______________|                            \n                /|
-  \  ___     ___ |                           \n               / |  |___|   |___||
-  \                          \n              /  |______________|                           \n
-  \        ====|========================|====                   \n        |    |    |-----------|
-  \    |    |                   \n        |    |____|           |_____|    |                   \n
-  \    ___|____|                         |____|___             \n~~~~{________|_________________________|________}~~~~~~~
-  \    \n  ~~      |  \\                     //  |         ~~~        \n          |
-  \  \\___________________//   |                    \n          |_____________________________|
-  \                   \n     ~~~       \\                 //          ~~~            \n
-  \               \\_______________//                          \n═══════════════════════════════════════════════════════════════════\n
-  \      Hardware Integration for Embedded Linux v0.1.2\n═══════════════════════════════════════════════════════════════════\n\n\U0001F389
-  Thanks for installing!\n\n\U0001F4DA Hardware Setup (kernel modules & permissions):\n
-  \  https://github.com/TheMadBotterINC/dredger-iot#hardware-setup\n\n\U0001F680 Quick
-  Start:\n   require 'dredger/iot'\n   gpio = Dredger::IoT::Bus::Auto.gpio\n   i2c
-  \ = Dredger::IoT::Bus::Auto.i2c\n\n\U0001F4A1 Supported Sensors:\n   DHT22, BME280,
-  DS18B20, BMP180, MCP9808\n\n\U0001F4D6 Full Documentation:\n   https://github.com/TheMadBotterINC/dredger-iot\n\n"
+post_install_message: "\n    ═══════════════════════════════════════════════════════════════════\n
+  \                                                                  \n                      _______________
+  \                             \n                     |  DREDGER-IoT  |                            \n
+  \                    |_______________|                            \n                    /|
+  \  ___     ___ |                           \n                   / |  |___|   |___||
+  \                          \n                  /  |______________|                           \n
+  \            ====|========================|====                   \n            |
+  \   |    |-----------|     |    |                   \n            |    |____|           |_____|
+  \   |                   \n         ___|____|                         |____|___             \n
+  \   ~~~~{________|_________________________|________}~~~~~~~     \n      ~~      |
+  \ \\                     //  |         ~~~        \n              |   \\___________________//
+  \  |                    \n              |_____________________________|                    \n
+  \        ~~~       \\                 //          ~~~            \n                    \\_______________//
+  \                         \n    ═══════════════════════════════════════════════════════════════════\nHardware
+  Integration for Embedded Linux v0.2.1\n    ═══════════════════════════════════════════════════════════════════\n\n
+  \   \U0001F389 Thanks for installing!\n\n    \U0001F4DA Hardware Setup (kernel modules
+  & permissions):\n       https://github.com/TheMadBotterINC/dredger-iot#hardware-setup\n\n
+  \   \U0001F680 Quick Start:\n       require 'dredger/iot'\n       gpio = Dredger::IoT::Bus::Auto.gpio\n
+  \      i2c  = Dredger::IoT::Bus::Auto.i2c\n\n    \U0001F4A1 Supported Sensors:\n
+  \      DHT22, BME280, DS18B20, BMP180, MCP9808\n\n    \U0001F4D6 Full Documentation:\n
+  \      https://github.com/TheMadBotterINC/dredger-iot\n\n"
 rdoc_options: []
 require_paths:
 - lib