dredger-iot 0.1.0

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

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+module Dredger
+  module IoT
+    module Sensors
+      # Hardware provider for DHT22/DHT11 sensors via GPIO bit-banging.
+      # Implements the DHT22 1-wire-like protocol:
+      # 1. Pull pin low for 1-10ms (start signal)
+      # 2. Pull high and wait for sensor response (80us low, 80us high)
+      # 3. Read 40 bits (5 bytes): humidity_hi, humidity_lo, temp_hi, temp_lo, checksum
+      # 4. Bit timing: ~50us low start + 26-28us high=0 or 70us high=1
+      class DHT22Provider
+        # gpio_bus: a GPIO bus interface (e.g., Dredger::IoT::Bus::Auto.gpio)
+        def initialize(gpio_bus:)
+          @gpio = gpio_bus
+        end
+
+        # Sample the DHT22 sensor on the given pin.
+        # Returns { humidity: Float, temperature_c: Float } or raises on error.
+        # Note: This is a simplified bit-bang implementation. Real production code would need:
+        # - Precise microsecond timing (Ruby is not ideal; consider C extension or kernel driver)
+        # - Retry logic and timeout handling
+        # - Support for both DHT11 and DHT22 data formats
+        def sample(pin_label)
+          # Send start signal: pull low for ~1ms, then high
+          @gpio.set_direction(pin_label, :out)
+          @gpio.write(pin_label, 0)
+          sleep(0.001) # 1ms low
+          @gpio.write(pin_label, 1)
+          sleep(0.00004) # 40us high
+
+          # Switch to input and read response
+          @gpio.set_direction(pin_label, :in)
+
+          # Wait for sensor to pull low (80us), then high (80us)
+          # In a real implementation, we'd wait with timeout and verify timing
+          sleep(0.00016) # ~160us for response
+
+          # Read 40 bits of data (5 bytes)
+          # This is highly simplified - real bit-banging requires microsecond precision
+          # For production, use a kernel module or C extension with RT priority
+          bytes = read_40_bits(pin_label)
+
+          # Verify checksum
+          checksum = (bytes[0] + bytes[1] + bytes[2] + bytes[3]) & 0xFF
+          raise IOError, 'DHT22 checksum mismatch' unless checksum == bytes[4]
+
+          # Parse DHT22 format (16-bit values, 0.1 resolution)
+          humidity_raw = (bytes[0] << 8) | bytes[1]
+          temp_raw = (bytes[2] << 8) | bytes[3]
+
+          # Handle negative temperature (MSB of temp_raw)
+          temp_raw = -(temp_raw & 0x7FFF) if temp_raw.anybits?(0x8000)
+
+          {
+            humidity: humidity_raw / 10.0,
+            temperature_c: temp_raw / 10.0
+          }
+        end
+
+        private
+
+        # Read 40 bits from the sensor.
+        # This is a stub - real implementation requires precise timing.
+        # In production, consider using a kernel driver or hardware peripheral.
+        def read_40_bits(_pin_label)
+          # Placeholder: return simulated data for now
+          # Real implementation would read GPIO with microsecond timing
+          # For each bit: wait for low->high transition, measure high duration
+          # If high > 40us, bit=1; else bit=0
+          warn 'DHT22Provider: bit-banging not fully implemented, returning stub data'
+          # humidity=65.2% => 0x028C, temp=31.4°C => 0x013A
+          # checksum = (0x02 + 0x8C + 0x01 + 0x3A) & 0xFF = 0xC9
+          [0x02, 0x8C, 0x01, 0x3A, 0xC9]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Dredger
+  module IoT
+    module Sensors
+      # DS18B20 digital temperature sensor (1-Wire protocol)
+      # Uses a provider interface to allow simulation in tests and hardware backends in production.
+      class DS18B20 < BaseSensor
+        # provider must respond to :read_temperature(device_id) -> Float (celsius)
+        def initialize(device_id:, provider:, metadata: {})
+          super(metadata: metadata)
+          @device_id = device_id
+          @provider = provider
+        end
+
+        def readings
+          temp_c = @provider.read_temperature(@device_id)
+          [reading(sensor_type: 'temperature', value: temp_c, unit: 'celsius')]
+        end
+      end
+    end
+  end
+end
+# EOF

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

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Dredger
+  module IoT
+    module Sensors
+      # Hardware provider for DS18B20 1-Wire temperature sensor.
+      # Uses the Linux kernel w1-gpio module (w1_therm driver).
+      #
+      # Setup:
+      # 1. Enable w1-gpio in device tree or config.txt (Raspberry Pi)
+      # 2. Load modules: modprobe w1-gpio && modprobe w1-therm
+      # 3. Devices appear in /sys/bus/w1/devices/28-*/w1_slave
+      #
+      # Device IDs are 64-bit unique addresses, typically formatted as:
+      # "28-0000056789ab" (family code 28 = DS18B20)
+      class DS18B20Provider
+        W1_BASE_PATH = '/sys/bus/w1/devices'
+
+        def initialize(base_path: W1_BASE_PATH)
+          @base_path = base_path
+        end
+
+        # Read temperature from DS18B20 sensor.
+        # device_id: device address (e.g., "28-0000056789ab")
+        # Returns temperature in Celsius as Float
+        def read_temperature(device_id)
+          device_path = File.join(@base_path, device_id, 'w1_slave')
+          raise IOError, "DS18B20 device not found: #{device_id}" unless File.exist?(device_path)
+
+          # Read device file (contains CRC check and temperature)
+          content = File.read(device_path)
+          lines = content.split("\n")
+
+          # First line contains CRC status: "xx xx xx xx xx xx xx xx xx : crc=xx YES"
+          raise IOError, 'DS18B20 CRC check failed' unless lines[0]&.end_with?('YES')
+
+          # Second line contains temperature: "xx xx xx xx xx xx xx xx xx t=23437"
+          temp_match = lines[1]&.match(/t=(-?\d+)/)
+          raise IOError, 'DS18B20 temperature parse failed' unless temp_match
+
+          # Temperature is in millidegrees Celsius
+          temp_match[1].to_i / 1000.0
+        end
+
+        # List all connected DS18B20 devices
+        def list_devices
+          return [] unless Dir.exist?(@base_path)
+
+          Dir.glob(File.join(@base_path, '28-*')).map { |path| File.basename(path) }
+        end
+      end
+    end
+  end
+end
+# EOF

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

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Dredger
+  module IoT
+    module Sensors
+      # MCP9808 high-accuracy I2C temperature sensor
+      # Provider must respond to :read_temperature(addr) -> Float (celsius)
+      class MCP9808 < BaseSensor
+        def initialize(i2c_addr:, provider:, metadata: {})
+          super(metadata: metadata)
+          @i2c_addr = i2c_addr
+          @provider = provider
+        end
+
+        def readings
+          temp_c = @provider.read_temperature(@i2c_addr)
+          [reading(sensor_type: 'temperature', value: temp_c, unit: 'celsius')]
+        end
+      end
+    end
+  end
+end
+# EOF

data/lib/dredger/iot/sensors.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require_relative 'sensors/base_sensor'
+require_relative 'sensors/dht22'
+require_relative 'sensors/dht22_provider'
+require_relative 'sensors/bme280'
+require_relative 'sensors/bme280_provider'
+require_relative 'sensors/ds18b20'
+require_relative 'sensors/ds18b20_provider'
+require_relative 'sensors/bmp180'
+require_relative 'sensors/mcp9808'

data/lib/dredger/iot/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Dredger
+  module IoT
+    VERSION = '0.1.0'
+  end
+end

data/lib/dredger/iot.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require_relative 'iot/version'
+require_relative 'iot/reading'
+require_relative 'iot/scheduler'
+require_relative 'iot/bus'
+require_relative 'iot/pins'
+require_relative 'iot/sensors'
+
+module Dredger
+  module IoT
+    class Error < StandardError; end
+  end
+end

metadata

@@ -0,0 +1,112 @@
+--- !ruby/object:Gem::Specification
+name: dredger-iot
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- The Mad Botter INC
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ffi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+description: |
+  Dredger-IoT provides FFI-based GPIO and I2C access for embedded Linux systems like Beaglebone Black.
+  Features include: libgpiod GPIO backend, Linux i2c-dev I2C backend, simulation backends for testing,
+  sensor drivers (DHT22, BME280, DS18B20, BMP180, MCP9808), Beaglebone pin label mapping, and
+  scheduling utilities for periodic polling and exponential backoff.
+email:
+- opensource@themadbotter.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- lib/dredger/iot.rb
+- lib/dredger/iot/bus.rb
+- lib/dredger/iot/bus/auto.rb
+- lib/dredger/iot/bus/gpio.rb
+- lib/dredger/iot/bus/gpio_label_adapter.rb
+- lib/dredger/iot/bus/gpio_libgpiod.rb
+- lib/dredger/iot/bus/i2c.rb
+- lib/dredger/iot/bus/i2c_linux.rb
+- lib/dredger/iot/pins.rb
+- lib/dredger/iot/pins/beaglebone.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/bme280.rb
+- lib/dredger/iot/sensors/bme280_provider.rb
+- lib/dredger/iot/sensors/bmp180.rb
+- lib/dredger/iot/sensors/dht22.rb
+- lib/dredger/iot/sensors/dht22_provider.rb
+- lib/dredger/iot/sensors/ds18b20.rb
+- lib/dredger/iot/sensors/ds18b20_provider.rb
+- lib/dredger/iot/sensors/mcp9808.rb
+- lib/dredger/iot/version.rb
+homepage: https://github.com/TheMadBotterINC/dredger-iot
+licenses:
+- MIT
+metadata:
+  platforms: Hardware backends require Linux. Simulation works everywhere.
+  homepage_uri: https://github.com/TheMadBotterINC/dredger-iot
+  source_code_uri: https://github.com/TheMadBotterINC/dredger-iot
+  changelog_uri: https://github.com/TheMadBotterINC/dredger-iot/blob/master/CHANGELOG.md
+  bug_tracker_uri: https://github.com/TheMadBotterINC/dredger-iot/issues
+  documentation_uri: https://github.com/TheMadBotterINC/dredger-iot/blob/master/README.md
+  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.0\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
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Generic hardware integration for embedded Linux (GPIO, I2C) with sensor drivers.
+test_files: []