lgpio 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3694843b060710d0fdf63c790b2857cd00bb37943fb80b52b4bb0e884c9eac63
-  data.tar.gz: 5749c5dbcaca251af6f5b2c6c3d189bcf1226f67ebabfc0dd418dee49361da77
+  metadata.gz: d173e84c707ec6e3d84715dbc7c56287a22d735fbbf118adc4d3b602513b852e
+  data.tar.gz: cb8d9acbdc1ed6da8fe9f037f8b837ee989b50d48b173980165b34e5c19d9b92
 SHA512:
-  metadata.gz: e7cd82024168e24f5a776a39b364a7c9f2432de7de6d1966517c686d04acaddf338186074b7b7597051e9521bc93115292223e66a7fa34b2fcf7bb02090ae0ae
-  data.tar.gz: 6855f0811581f7c50803cf1372a9d3927399e547b9d3b9f05dd6162106949d3793d9ea40ee50d5253b9d3c252ed137bfe0859cf7bc38d00a3a2686e64d4be82e
+  metadata.gz: 4959700837149d70e16f550cbd02e13d03b4507ec1b50910c45bf7809e2c711547939ad50d2ba559c0b167befb6c670202e5de371bbe40bf764032d580e94830
+  data.tar.gz: 360a46aa061edb191ce80f67be784ac4edae21d7126cb4e05c3ce3812d416d2daa6f804ecfa532c790637d51f63010e01a07277971897fa26d7442f1c581a251

data/README.md

@@ -7,10 +7,10 @@ Ruby bindings for the [lgpio (lg)](https://github.com/joan2937/lg) C library, wh
 ### Progress:
 
 - [x] GPIO Read/Write
-- [ ] GPIO Group Read/Write
+- [x] GPIO Group Read/Write
 - [ ] GPIO Callbacks
-- [ ] PWM
-- [ ] Wave
+- [x] PWM (software-timed)
+- [x] Wave (software-timed)
 - [ ] I2C
 - [ ] SPI
 - [ ] Serial

data/examples/bench_in.rb

@@ -1,8 +1,8 @@
 require 'lgpio'
 
 GPIO_CHIP = 0
-PIN = 258
-COUNT = 1000000
+PIN       = 258
+COUNT     = 1000000
 
 chip_handle = LGPIO.chip_open(GPIO_CHIP)
 LGPIO.gpio_claim_input(chip_handle, LGPIO::SET_PULL_UP, PIN)
@@ -14,3 +14,6 @@ end
 t2 = Time.now
 
 puts "Reads per second: #{COUNT.to_f / (t2 - t1).to_f}"
+
+LGPIO.gpio_free(chip_handle, PIN)
+LGPIO.chip_close(chip_handle)

data/examples/bench_out.rb

@@ -1,8 +1,8 @@
 require 'lgpio'
 
 GPIO_CHIP = 0
-PIN = 260
-COUNT = 1000000
+PIN       = 260
+COUNT     = 1000000
 
 chip_handle = LGPIO.chip_open(GPIO_CHIP)
 LGPIO.gpio_claim_output(chip_handle, LGPIO::SET_PULL_NONE, PIN, LGPIO::LOW)
@@ -15,3 +15,6 @@ end
 t2 = Time.now
 
 puts "Toggles per second: #{COUNT.to_f / (t2 - t1).to_f}"
+
+LGPIO.gpio_free(chip_handle, PIN)
+LGPIO.chip_close(chip_handle)

data/examples/blink.rb

@@ -1,8 +1,8 @@
 require 'lgpio'
 
 GPIO_CHIP = 0
-LED = 260
-INTERVAL = 0.25
+LED       = 260
+INTERVAL  = 0.25
 
 chip_handle = LGPIO.chip_open(GPIO_CHIP)
 LGPIO.gpio_claim_output(chip_handle, LGPIO::SET_PULL_NONE, LED, LGPIO::LOW)

data/examples/group_in.rb

@@ -0,0 +1,18 @@
+
+require 'lgpio'
+
+GPIO_CHIP   = 0
+BUTTONS     = [258, 256]
+LEDS        = [260, 267]
+INIT_STATE  = [0, 0]
+
+chip_handle = LGPIO.chip_open(GPIO_CHIP)
+LGPIO.group_claim_input(chip_handle, LGPIO::SET_PULL_UP, BUTTONS)
+LGPIO.group_claim_output(chip_handle, LGPIO::SET_PULL_NONE, LEDS, INIT_STATE)
+
+# The inverted (active-low) state of each button controls the corresponding LED.
+loop do
+  output_bits = LGPIO.group_read(chip_handle, BUTTONS[0]) ^ 0b11
+  LGPIO.group_write(chip_handle, LEDS[0], output_bits, 0b11)
+  sleep 0.001
+end

data/examples/group_out.rb

@@ -0,0 +1,27 @@
+require 'lgpio'
+
+GPIO_CHIP   = 0
+LEDS        = [260, 267]
+INIT_STATE  = [0, 0]
+INTERVAL    = 250_000 # 250ms
+TIMES       = 10
+
+chip_handle = LGPIO.chip_open(GPIO_CHIP)
+LGPIO.group_claim_output(chip_handle, LGPIO::SET_PULL_NONE, LEDS, INIT_STATE)
+
+# Convert us interval to seconds.
+interval = INTERVAL.to_f / 1_000_000
+
+# Alternate the LEDs each INTERVAL.
+TIMES.times do
+  # Last 2 args are bits to write, and write mask respectively.
+  LGPIO.group_write(chip_handle, LEDS[0], 0b01, 0b11)
+  sleep interval
+  LGPIO.group_write(chip_handle, LEDS[0], 0b10, 0b11)
+  sleep interval
+end
+
+# Turn them off and cleanup.
+LGPIO.group_write(chip_handle, LEDS[0], 0b00, 0b11)
+LGPIO.group_free(chip_handle, LEDS[0])
+LGPIO.chip_close(chip_handle)

data/examples/pwm.rb

@@ -0,0 +1,19 @@
+require 'lgpio'
+
+GPIO_CHIP   = 0
+LED         = 260
+PWM_FREQ    = 500
+PWM_OFFSET  = 0
+PWM_CYCLES  = 0    # 0 = infinite
+
+chip_handle = LGPIO.chip_open(GPIO_CHIP)
+LGPIO.gpio_claim_output(chip_handle, LGPIO::SET_PULL_NONE, LED, LGPIO::LOW)
+
+# Seamless loop from 0-100 and back.
+duty_cycles = (0..100).to_a + (1..99).to_a.reverse
+
+# Pulse the LED up and down.
+duty_cycles.cycle do |d|
+  LGPIO.tx_pwm(chip_handle, LED, PWM_FREQ, d, PWM_OFFSET, PWM_CYCLES)
+  sleep 0.020
+end

data/examples/wave.rb

@@ -0,0 +1,32 @@
+require 'lgpio'
+
+GPIO_CHIP   = 0
+LEDS        = [260, 267]
+INIT_STATE  = [0, 0]
+INTERVAL    = 250_000 # 250ms
+TIMES       = 10
+
+chip_handle = LGPIO.chip_open(GPIO_CHIP)
+LGPIO.group_claim_output(chip_handle, LGPIO::SET_PULL_NONE, LEDS, INIT_STATE)
+
+# Generic pulse that updates both LED states (first element) each INTERVAL.
+generic_pulse = [ nil, 0b11, INTERVAL ]
+
+# Alternate the LEDs each INTERVAL.
+pulses = []
+TIMES.times do
+  pulses << generic_pulse.clone
+  pulses.last[0] = 0b01
+  pulses << generic_pulse.clone
+  pulses.last[0] = 0b10
+end
+# Turn them off at the end.
+pulses << [0b00, 0b11, 1000]
+
+# Add to wave queue.
+LGPIO.tx_wave(chip_handle, LEDS[0], pulses)
+
+# Wait for it to complete, then cleanup.
+sleep 0.010 while LGPIO.tx_busy(chip_handle, LEDS[0], LGPIO::TX_WAVE) == 1
+LGPIO.group_free(chip_handle, LEDS[0])
+LGPIO.chip_close(chip_handle)

data/ext/lgpio/lgpio.c

@@ -6,8 +6,8 @@ static VALUE chip_open(VALUE self, VALUE gpio_dev) {
   return INT2NUM(result);
 }
 
-static VALUE chip_close(VALUE self, VALUE gpio_dev) {
-  int result = lgGpiochipClose(NUM2INT(gpio_dev));
+static VALUE chip_close(VALUE self, VALUE handle) {
+  int result = lgGpiochipClose(NUM2INT(handle));
   return INT2NUM(result);
 }
 
@@ -21,6 +21,11 @@ static VALUE gpio_claim_input(VALUE self, VALUE handle, VALUE flags, VALUE gpio)
   return INT2NUM(result);
 }
 
+static VALUE gpio_free(VALUE self, VALUE handle, VALUE gpio) {
+  int result = lgGpioFree(NUM2INT(handle), NUM2INT(gpio));
+  return INT2NUM(result);
+}
+
 static VALUE gpio_read(VALUE self, VALUE handle, VALUE gpio) {
   int result = lgGpioRead(NUM2INT(handle), NUM2INT(gpio));
   return INT2NUM(result);
@@ -31,23 +36,122 @@ static VALUE gpio_write(VALUE self, VALUE handle, VALUE gpio, VALUE level) {
   return INT2NUM(result);
 }
 
+static VALUE group_claim_input(VALUE self, VALUE handle, VALUE flags, VALUE gpios) {
+  int count = rb_array_len(gpios);
+  int lgGpios[count];
+  int i;
+  for(i=0; i<count; i++) {
+    lgGpios[i] = NUM2INT(rb_ary_entry(gpios, i));
+  }
+  int result = lgGroupClaimInput(NUM2INT(handle), NUM2INT(flags), count, lgGpios);
+  return INT2NUM(result);
+}
+
+static VALUE group_claim_output(VALUE self, VALUE handle, VALUE flags, VALUE gpios, VALUE levels) {
+  int count = rb_array_len(gpios);
+  int lgGpios[count];
+  int lgLevels[count];
+  int i;
+  for(i=0; i<count; i++) {
+    lgGpios[i]  = NUM2INT(rb_ary_entry(gpios, i));
+    lgLevels[i] = NUM2INT(rb_ary_entry(levels, i));
+  }
+  int result = lgGroupClaimOutput(NUM2INT(handle), NUM2INT(flags), count, lgGpios, lgLevels);
+  return INT2NUM(result);
+}
+
+static VALUE group_free(VALUE self, VALUE handle, VALUE gpio) {
+  int result = lgGroupFree(NUM2INT(handle), NUM2INT(gpio));
+  return INT2NUM(result);
+}
+
+static VALUE group_read(VALUE self, VALUE handle, VALUE gpio) {
+  uint64_t result;
+  lgGroupRead(NUM2INT(handle), NUM2INT(gpio), &result);
+  return UINT2NUM(result);
+}
+
+static VALUE group_write(VALUE self, VALUE handle, VALUE gpio, VALUE bits, VALUE mask) {
+  int result = lgGroupWrite(NUM2INT(handle), NUM2INT(gpio), NUM2UINT(bits), NUM2UINT(mask));
+  return INT2NUM(result);
+}
+
+static VALUE tx_busy(VALUE self, VALUE handle, VALUE gpio, VALUE kind) {
+  int result = lgTxBusy(NUM2INT(handle), NUM2INT(gpio), NUM2INT(kind));
+  return INT2NUM(result);
+}
+
+static VALUE tx_room(VALUE self, VALUE handle, VALUE gpio, VALUE kind) {
+  int result = lgTxRoom(NUM2INT(handle), NUM2INT(gpio), NUM2INT(kind));
+  return INT2NUM(result);
+}
+
+static VALUE tx_pulse(VALUE self, VALUE handle, VALUE gpio, VALUE on, VALUE off, VALUE offset, VALUE cycles) {
+  int result = lgTxPulse(NUM2INT(handle), NUM2INT(gpio), NUM2INT(on), NUM2INT(off), NUM2INT(offset), NUM2INT(cycles));
+  return INT2NUM(result);
+}
+
+static VALUE tx_pwm(VALUE self, VALUE handle, VALUE gpio, VALUE freq, VALUE duty, VALUE offset, VALUE cycles) {
+  int result = lgTxPwm(NUM2INT(handle), NUM2INT(gpio), NUM2INT(freq), NUM2INT(duty), NUM2INT(offset), NUM2INT(cycles));
+  return INT2NUM(result);
+}
+
+static VALUE tx_servo(VALUE self, VALUE handle, VALUE gpio, VALUE width, VALUE freq, VALUE offset, VALUE cycles) {
+  int result = lgTxServo(NUM2INT(handle), NUM2INT(gpio), NUM2INT(width), NUM2INT(freq), NUM2INT(offset), NUM2INT(cycles));
+  return INT2NUM(result);
+}
+
+static VALUE tx_wave(VALUE self, VALUE handle, VALUE lead_gpio, VALUE pulses) {
+  // Copy Ruby array to array of lgPulse_t.
+  int       pulseCount = rb_array_len(pulses);
+  lgPulse_t pulsesOut[pulseCount];
+  VALUE     rbPulse;
+  int       i;
+  for(i=0; i<pulseCount; i++) {
+    rbPulse            = rb_ary_entry(pulses, i);
+    pulsesOut[i].bits  = NUM2UINT(rb_ary_entry(rbPulse, 0));
+    pulsesOut[i].mask  = NUM2UINT(rb_ary_entry(rbPulse, 1));
+    pulsesOut[i].delay = NUM2INT (rb_ary_entry(rbPulse, 2));
+  }
+
+  // Add it to wave queue.
+  int result = lgTxWave(NUM2INT(handle), NUM2INT(lead_gpio), pulseCount, pulsesOut);
+  return INT2NUM(result);
+}
+
 void Init_lgpio(void) {
   // Modules
   VALUE mLGPIO = rb_define_module("LGPIO");
 
-  // Constants
+  // Basics
   rb_define_const(mLGPIO, "SET_ACTIVE_LOW",   INT2NUM(LG_SET_ACTIVE_LOW));
   rb_define_const(mLGPIO, "SET_OPEN_DRAIN",   INT2NUM(LG_SET_OPEN_DRAIN));
   rb_define_const(mLGPIO, "SET_OPEN_SOURCE",  INT2NUM(LG_SET_OPEN_SOURCE));
   rb_define_const(mLGPIO, "SET_PULL_UP",      INT2NUM(LG_SET_PULL_UP));
   rb_define_const(mLGPIO, "SET_PULL_DOWN",    INT2NUM(LG_SET_PULL_DOWN));
   rb_define_const(mLGPIO, "SET_PULL_NONE",    INT2NUM(LG_SET_PULL_NONE));
-
-  // Methods
-  rb_define_singleton_method(mLGPIO, "chip_open",          chip_open, 1);
-  rb_define_singleton_method(mLGPIO, "chip_close",         chip_close, 1);
-  rb_define_singleton_method(mLGPIO, "gpio_claim_input",   gpio_claim_input, 3);
+  rb_define_singleton_method(mLGPIO, "chip_open",          chip_open,         1);
+  rb_define_singleton_method(mLGPIO, "chip_close",         chip_close,        1);
+  rb_define_singleton_method(mLGPIO, "gpio_free",          gpio_free,         2);
+  rb_define_singleton_method(mLGPIO, "gpio_claim_input",   gpio_claim_input,  3);
   rb_define_singleton_method(mLGPIO, "gpio_claim_output",  gpio_claim_output, 4);
-  rb_define_singleton_method(mLGPIO, "gpio_read",          gpio_read, 2);
-  rb_define_singleton_method(mLGPIO, "gpio_write",         gpio_write, 3);
+  rb_define_singleton_method(mLGPIO, "gpio_read",          gpio_read,         2);
+  rb_define_singleton_method(mLGPIO, "gpio_write",         gpio_write,        3);
+
+  // Grouped
+  rb_define_singleton_method(mLGPIO, "group_claim_input",   group_claim_input,  3);
+  rb_define_singleton_method(mLGPIO, "group_claim_output",  group_claim_output, 4);
+  rb_define_singleton_method(mLGPIO, "group_free",          group_free,         2);
+  rb_define_singleton_method(mLGPIO, "group_read",          group_read,         2);
+  rb_define_singleton_method(mLGPIO, "group_write",         group_write,        4);
+
+  // PWM / Servo / Wave
+  rb_define_const(mLGPIO, "TX_PWM", INT2NUM(LG_TX_PWM));
+  rb_define_const(mLGPIO, "TX_WAVE",INT2NUM(LG_TX_WAVE));
+  rb_define_singleton_method(mLGPIO, "tx_busy",  tx_busy,  3);
+  rb_define_singleton_method(mLGPIO, "tx_room",  tx_room,  3);
+  rb_define_singleton_method(mLGPIO, "tx_pulse", tx_pulse, 6);
+  rb_define_singleton_method(mLGPIO, "tx_pwm",   tx_pwm,   6);
+  rb_define_singleton_method(mLGPIO, "tx_servo", tx_servo, 6);
+  rb_define_singleton_method(mLGPIO, "tx_wave",  tx_wave,  3);
 }

data/lib/lgpio/version.rb

@@ -1,3 +1,3 @@
 module LGPIO
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lgpio
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - vickash
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-04-24 00:00:00.000000000 Z
+date: 2024-05-03 00:00:00.000000000 Z
 dependencies: []
 description: Use GPIO / PWM / I2C / SPI / UART on Linux SBCs in Ruby
 email: mail@vickash.com
@@ -24,7 +24,11 @@ files:
 - examples/bench_in.rb
 - examples/bench_out.rb
 - examples/blink.rb
+- examples/group_in.rb
+- examples/group_out.rb
 - examples/momentary.rb
+- examples/pwm.rb
+- examples/wave.rb
 - ext/lgpio/extconf.rb
 - ext/lgpio/lgpio.c
 - lgpio.gemspec