rpi_gpio 0.4.0 → 0.7.1

data/lib/rpi_gpio.rb

@@ -0,0 +1,329 @@
+require 'rpi_gpio/rpi_gpio'
+require 'epoll'
+
+module RPi
+  module GPIO
+    def self.watch(channel, on:, bounce_time: nil, &block) 
+      gpio = get_gpio_number(channel)
+      ensure_gpio_input(gpio)
+      validate_edge(on)
+      if bounce_time && bounce_time <= 0
+        raise ArgumentError, "`bounce_time` must be greater than 0; given #{bounce_time}"
+      end
+      add_edge_detect(gpio, on, bounce_time)
+      add_callback(gpio, &block)
+    end
+
+    def self.stop_watching(channel)
+      gpio = get_gpio_number(channel)
+      ensure_gpio_input(gpio)
+      remove_edge_detect(gpio)
+      remove_callbacks(gpio)
+    end
+
+    def self.wait_for_edge(channel, edge, bounce_time: nil, timeout: -1)
+      gpio = get_gpio_number(channel)
+      if callback_exists(gpio)
+        raise RuntimeError, "conflicting edge detection already enabled for GPIO #{gpio}"
+      end
+
+      ensure_gpio_input(gpio)
+      validate_edge(edge)
+      was_gpio_new = false
+      current_edge = get_event_edge(gpio)
+      if current_edge == edge
+        g = get_gpio(gpio)
+        if g.bounce_time && g.bounce_time != bounce_time
+          raise RuntimeError, "conflicting edge detection already enabled for GPIO #{gpio}"
+        end
+      elsif current_edge.nil?
+        was_gpio_new = true
+        g = new_gpio(gpio)
+        set_edge(gpio, edge)
+        g.edge = edge
+        g.bounce_time = bounce_time
+      else
+        g = get_gpio(gpio)
+        set_edge(gpio, edge)
+        g.edge = edge
+        g.bounce_time = bounce_time
+        g.initial_wait = 1
+      end
+
+      if @@epoll_blocking.nil?
+        @@epoll_blocking = Epoll.create
+      end
+      @@epoll_blocking.add(g.value_file, Epoll::PRI)
+
+      initial_edge = true
+      the_value = nil
+      timed_out = false
+      begin
+        while the_value.nil? && !timed_out do
+          events = @@epoll_blocking.wait(timeout)
+          if events.empty?
+            timed_out = true
+          end
+          events.each do |event|
+            if event.events & Epoll::PRI != 0
+              event.data.seek(0, IO::SEEK_SET)
+              value = event.data.read.chomp.to_i
+              if event.data == g.value_file
+                if initial_edge # ignore first epoll trigger
+                  initial_edge = false
+                else
+                  now = Time.now.to_f
+                  if g.bounce_time.nil? || g.last_call == 0 || g.last_call > now ||
+                     (now - g.last_call) * 1000 > g.bounce_time then
+                    g.last_call = now
+                    the_value = value
+                  end
+                end
+              end
+            end
+          end
+        end
+
+        if the_value
+          return the_value
+        end
+      ensure
+        @@epoll_blocking.del(g.value_file)
+        if was_gpio_new
+          delete_gpio(gpio)
+        end
+      end
+    end
+
+    private
+      @@callbacks = []
+      @@gpios = []
+      @@epoll = nil
+      @@epoll_thread = nil
+      @@epoll_blocking = nil
+  
+      def self.export(gpio)
+        unless File.exist?("/sys/class/gpio/gpio#{gpio}")
+          File.open("/sys/class/gpio/export", 'w') do |file|
+            file.write(gpio.to_s)
+          end
+        end
+      end
+
+      def self.unexport(gpio)
+        File.open("/sys/class/gpio/unexport", 'w') do |file|
+          file.write(gpio.to_s)
+        end
+      end
+
+      def self.set_direction(gpio, direction)
+        validate_direction(direction)
+        tries = 0
+        begin
+          File.open("/sys/class/gpio/gpio#{gpio}/direction", 'w') do |file|
+            file.write(direction.to_s)
+          end
+        rescue
+          raise if tries > 5
+          sleep 0.1
+          tries += 1
+          retry
+        end
+      end
+
+      def self.set_edge(gpio, edge)
+        validate_edge(edge)
+        tries = 0
+        begin
+          File.open("/sys/class/gpio/gpio#{gpio}/edge", 'w') do |file|
+            file.write(edge.to_s)
+          end
+        rescue
+          raise if tries > 5
+          sleep 0.1
+          tries += 1
+          retry
+        end
+      end
+
+      def self.open_value_file(gpio)
+        File.open("/sys/class/gpio/gpio#{gpio}/value", 'r')
+      end
+
+      def self.new_gpio(gpio)
+        g = GPIO.new
+        g.gpio = gpio
+        export(gpio)
+        g.exported = true
+        set_direction(gpio, :in)
+        begin
+          g.value_file = open_value_file(gpio)
+        rescue
+          unexport(gpio)
+          raise
+        end
+        g.initial_thread = true
+        g.initial_wait = true
+        g.bounce_time = nil
+        g.last_call = 0
+        g.thread_added = false
+        @@gpios << g
+        g
+      end
+
+      def self.delete_gpio(gpio)
+        @@gpios.delete_if { |g| g.gpio == gpio }
+      end
+
+      def self.get_gpio(gpio)
+        @@gpios.find { |g| g.gpio == gpio }
+      end
+
+      def self.get_gpio_by_value_file(value_file)
+        @@gpios.find { |g| g.value_file == value_file }
+      end
+
+      def self.get_event_edge(gpio) # gpio_event_added in python library
+        g = @@gpios.find { |g| g.gpio == gpio }
+        if g
+          return g.edge
+        end
+      end
+
+      def self.add_edge_detect(gpio, edge, bounce_time = nil)
+        current_edge = get_event_edge(gpio)
+        if current_edge.nil?
+          g = new_gpio(gpio)
+          set_edge(gpio, edge)
+          g.edge = edge
+          g.bounce_time = bounce_time
+        elsif current_edge == edge
+          g = get_gpio(gpio)
+          if (bounce_time && g.bounce_time != bounce_time) || g.thread_added
+            raise RuntimeError, "conflicting edge detection already enabled for GPIO #{gpio}"
+          end
+        else
+          raise RuntimeError, "conflicting edge detection already enabled for GPIO #{gpio}"
+        end
+
+        if @@epoll.nil?
+          @@epoll = Epoll.create
+        end
+
+        begin
+          @@epoll.add(g.value_file, Epoll::PRI)
+        rescue
+          remove_edge_detect(gpio)
+          raise
+        end
+
+        g.thread_added = true
+        if @@epoll_thread.nil? || !@@epoll_thread.alive?
+          @@epoll_thread = Thread.new { poll_thread }
+        end
+      end
+
+      def self.remove_edge_detect(gpio)
+        g = get_gpio(gpio)
+        if g and @@epoll
+          @@epoll.del(g.value_file)
+          set_edge(gpio, :none)
+          g.edge = :none
+          g.value_file.close
+          unexport(gpio)
+          delete_gpio(gpio)
+        end
+      end
+
+      def self.poll_thread
+        loop do
+          begin
+            events = @@epoll.wait
+          rescue IOError # empty interest list
+            break
+          end
+          events.each do |event|
+            if event.events & Epoll::PRI != 0
+              event.data.seek(0, IO::SEEK_SET)
+              g = get_gpio_by_value_file(event.data)
+              value = event.data.read.chomp.to_i
+              if g.initial_thread # ignore first epoll trigger
+                g.initial_thread = false
+              else
+                now = Time.now.to_f
+                if g.bounce_time.nil? || g.last_call == 0 || g.last_call > now ||
+                   (now - g.last_call) * 1000 > g.bounce_time then
+                  g.last_call = now
+                  run_callbacks(g.gpio, value)
+                end
+              end
+            end
+          end
+        end
+      end
+
+      def self.event_cleanup(gpio)
+        @@gpios.map { |g| g.gpio }.each do |gpio_|
+          if gpio.nil? || gpio_ == gpio
+            remove_edge_detect(gpio_)
+          end
+        end
+
+        if @@gpios.empty? && @@epoll_thread
+          @@epoll_thread.terminate
+        end
+      end
+
+      def self.event_cleanup_all
+        event_cleanup(nil)
+      end
+
+      def self.add_callback(gpio, &block)
+        @@callbacks << Callback.new(gpio, &block)
+      end
+
+      def self.remove_callbacks(gpio)
+        @@callbacks.delete_if { |g| g.gpio == gpio }
+      end
+
+      def self.callback_exists(gpio)
+        @@gpios.find { |g| g.gpio == gpio } != nil
+      end
+
+      def self.run_callbacks(gpio, value)
+        @@callbacks.each do |callback|
+          if callback.gpio == gpio
+            callback.block.call(channel_from_gpio(gpio), value)
+          end
+        end
+      end
+
+      def self.validate_direction(direction)
+        direction = direction.to_s
+        if direction != 'in' && direction != 'out'
+          raise ArgumentError, "`direction` must be 'in' or 'out'; given '#{direction}'"
+        end
+      end
+
+      def self.validate_edge(edge)
+        edge = edge.to_s
+        if edge != 'rising' && edge != 'falling' && edge != 'both' && edge != 'none'
+          raise ArgumentError, "`edge` must be 'rising', 'falling', 'both', or 'none'; given '#{edge}'"
+        end
+      end
+
+      class GPIO
+        attr_accessor :gpio, :exported, :value_file, :initial_thread, :initial_wait, :bounce_time, :last_call,
+          :thread_added, :edge
+      end
+
+      class Callback
+        attr_accessor :gpio, :block
+
+        def initialize(gpio, &block)
+          @gpio = gpio
+          @block = block
+        end
+      end
+  end
+end

metadata

@@ -1,63 +1,71 @@
 --- !ruby/object:Gem::Specification
 name: rpi_gpio
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.7.1
 platform: ruby
 authors:
 - Nick Lowery
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-07-21 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: epoll
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
 - !ruby/object:Gem::Dependency
   name: rake-compiler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.13'
 description: Ruby conversion of RPi.GPIO Python module
-email: nick.a.lowery@gmail.com
+email: nick.lowery@proton.me
 executables: []
 extensions:
 - ext/rpi_gpio/extconf.rb
 extra_rdoc_files: []
 files:
-- Gemfile
-- Gemfile.lock
 - LICENSE
 - README.md
-- Rakefile
 - ext/rpi_gpio/c_gpio.c
 - ext/rpi_gpio/c_gpio.h
 - ext/rpi_gpio/common.c
 - ext/rpi_gpio/common.h
 - ext/rpi_gpio/cpuinfo.c
 - ext/rpi_gpio/cpuinfo.h
-- ext/rpi_gpio/event_gpio.c
-- ext/rpi_gpio/event_gpio.h
 - ext/rpi_gpio/extconf.rb
 - ext/rpi_gpio/rb_gpio.c
 - ext/rpi_gpio/rb_gpio.h
@@ -67,11 +75,11 @@ files:
 - ext/rpi_gpio/rpi_gpio.h
 - ext/rpi_gpio/soft_pwm.c
 - ext/rpi_gpio/soft_pwm.h
+- lib/rpi_gpio.rb
 homepage: https://github.com/ClockVapor/rpi_gpio
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -86,8 +94,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Ruby conversion of RPi.GPIO Python module
 test_files: []

data/Gemfile

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

data/Gemfile.lock

@@ -1,36 +0,0 @@
-PATH
-  remote: .
-  specs:
-    rpi_gpio (0.4.0)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    diff-lcs (1.4.4)
-    rake (13.0.1)
-    rake-compiler (1.1.1)
-      rake
-    rspec (3.9.0)
-      rspec-core (~> 3.9.0)
-      rspec-expectations (~> 3.9.0)
-      rspec-mocks (~> 3.9.0)
-    rspec-core (3.9.2)
-      rspec-support (~> 3.9.3)
-    rspec-expectations (3.9.2)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-mocks (3.9.1)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-support (3.9.3)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  rake-compiler
-  rpi_gpio!
-  rspec
-
-BUNDLED WITH
-   2.1.4

data/Rakefile

@@ -1,3 +0,0 @@
-require 'rake/extensiontask'
-
-Rake::ExtensionTask.new('rpi_gpio')