denko 0.14.0 → 0.15.0

data/examples/led/builtin_blink.rb

@@ -1,14 +0,0 @@
-#
-# Blink example for standard built-in LEDs named :LED_BUILTIN
-#
-require 'bundler/setup'
-require 'denko'
-
-PIN = :LED_BUILTIN
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-led = Denko::LED.new(board: board, pin: PIN)
-
-led.blink 0.5
-
-sleep

data/examples/led/builtin_fade.rb

@@ -1,19 +0,0 @@
-#
-# Blink example for standard built-in LEDs named :LED_BUILTIN
-#
-require 'bundler/setup'
-require 'denko'
-
-PIN = :LED_BUILTIN
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-led = Denko::LED.new(board: board, pin: PIN)
-
-min = 0
-max = 100
-values = (min..max).to_a + (min..max-1).to_a.reverse
-
-values.cycle do |value|
-  led.duty = value
-  sleep 0.005
-end

data/examples/led/rgb_led.rb

@@ -1,31 +0,0 @@
-#
-# A standard 3 pin RGB LED (not single pin addressable), on 3 PWM pins.
-#
-require 'bundler/setup'
-require 'denko'
-
-RED_PIN   = 11
-GREEN_PIN = 10
-BLUE_PIN  = 9
-
-board  = Denko::Board.new(Denko::Connection::Serial.new)
-rgb_led = Denko::LED::RGB.new board: board,
-                              pins: {red: RED_PIN, green: GREEN_PIN, blue: BLUE_PIN}
-
-# Set these predefined colors with symbols.
-[:red, :green, :blue, :cyan, :yellow, :magenta, :white, :off].each do |color|
-  rgb_led.color = color
-  sleep 0.5
-end
-
-# Set duty cycle for each "sub LED".
-loop do
-  rgb_led.red.duty   = 100
-  rgb_led.green.duty = 50
-  rgb_led.blue.duty  = 0
-  sleep 0.5
-  rgb_led.red.duty   = 100
-  rgb_led.green.duty = 0
-  rgb_led.blue.duty  = 50
-  sleep 0.5
-end

data/examples/led/seven_segment_char_echo.rb

@@ -1,17 +0,0 @@
-#
-# Echo pressed keys to a seven segment LED.
-#
-require 'bundler/setup'
-require 'denko'
-
-PINS  = { cathode: 10, a: 3, b: 4, c: 5, d: 6, e: 7, f: 8, g: 9 }
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-ssd   = Denko::LED::SevenSegment.new board: board,
-                                     pins:  PINS
-
-# Turn off the ssd on exit
-trap("SIGINT") { exit !ssd.off }
-
-# Display each new line on the ssd
-loop { ssd.display(gets.chomp) }

data/examples/led/ws2812_bounce.rb

@@ -1,30 +0,0 @@
-#
-# Walk a pixel along a WS2812 strip and back, changing color each loop.
-#
-require 'bundler/setup'
-require 'denko'
-
-PIN    = 4
-PIXELS = 8
-
-RED    = [255, 0, 0]
-GREEN  = [0, 255, 0]
-BLUE   = [0, 0, 255]
-WHITE  = [255, 255, 255]
-COLORS = [RED, GREEN, BLUE, WHITE]
-
-positions = (0..PIXELS-1).to_a + (1..PIXELS-2).to_a.reverse
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-strip = Denko::LED::WS2812.new(board: board, pin: PIN, length: PIXELS)
-
-loop do
-  COLORS.each do |color|
-    positions.each do |index|
-      strip.clear
-      strip[index] = color
-      strip.show
-      sleep 0.05
-    end
-  end
-end

data/examples/led/ws2812_builtin_blink.rb

@@ -1,22 +0,0 @@
-#
-# Blink example for the LOLIN ESP32 S3 or C3, or any board where
-# :LED_BUILTIN is the data pin for a single on-board WS2812.
-#
-require 'bundler/setup'
-require 'denko'
-
-PIN   = :LED_BUILTIN
-WHITE = [255, 255, 255]
-OFF   = [0, 0, 0]
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-strip = Denko::LED::WS2812.new(board: board, pin: PIN, length: 1)
-
-loop do
-  strip[0] = WHITE
-  strip.show
-  sleep 0.5
-  strip[0] = OFF
-  strip.show
-  sleep 0.5
-end

data/examples/led/ws2812_fade.rb

@@ -1,43 +0,0 @@
-#
-# Fade colors along a WS2812, and over time.
-#
-require 'bundler/setup'
-require 'denko'
-
-PIN    = 4
-PIXELS = 8
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-strip = Denko::LED::WS2812.new(board: board, pin: PIN, length: PIXELS)
-
-min = 0
-max = 255
-gap = 5
-values = (min..max).step(gap).to_a + (min..max-gap).step(gap).to_a.reverse
-
-color_values= []
-# Red
-values.each { |v| color_values << [v, 0, 0] }
-# Green
-values.each { |v| color_values << [0, v, 0] }
-# Blue
-values.each { |v| color_values << [0, 0, v] }
-# White
-values.each { |v| color_values << [v, v, v] }
-
-loop do
-  start  = 0
-  finish = PIXELS - 1
-  while (finish < color_values.length)
-    slice = color_values[start..finish]
-
-    slice.each_with_index do |value, i|
-      strip[i] = value
-    end
-    strip.show
-    sleep 0.025
-
-    start  += 1
-    finish += 1
-  end
-end

data/examples/motor/l298.rb

@@ -1,45 +0,0 @@
-#
-# Drive a DC motor with the L298 H-Bridge driver.
-#
-require 'bundler/setup'
-require 'denko'
-board = Denko::Board.new(Denko::Connection::Serial.new)
-
-PINS = { direction1: 8, direction2: 9, enable: 10 }
-
-# This is only 1 channel of the driver. Make a new object for each channel.
-motor = Denko::Motor::L298.new(board: board, pins: PINS)
-
-# Off without braking (initial state).
-# motor.off
-# motor.idle
-
-# Go forward at half speed for a while.
-motor.forward(50)
-sleep 2
-
-# Change direction.
-motor.reverse(50)
-sleep 2
-
-# Speed up without changing direction.
-motor.speed = 100
-sleep 2
-
-# Brake to stop quickly.
-motor.brake
-sleep 1
-
-# Change from brake to forward, but 0 speed.
-motor.forward(0)
-sleep 1
-
-# Speed up in 5% increments.
-(1..20).each do |step|
-  sleep 0.5
-  motor.speed = step * 5
-end
-
-# Turn it off.
-motor.off
-board.finish_write

data/examples/motor/servo.rb

@@ -1,17 +0,0 @@
-#
-# This is an example of how to use the servo class
-#
-require 'bundler/setup'
-require 'denko'
-
-PIN   = 9
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-servo = Denko::Motor::Servo.new(board: board, pin: PIN)
-
-# Add different angles (in degrees) to the array below to try out your servo.
-# Note: Some servos may not have a full 180 degree sweep.
-[0, 90, 180, 90].cycle do |angle|
-  servo.position = angle
-  sleep 0.5
-end

data/examples/motor/stepper.rb

@@ -1,43 +0,0 @@
-#
-# Use a stepper motor with the EasyDriver board: https://www.sparkfun.com/products/12779
-#
-require 'bundler/setup'
-require 'denko'
-
-PINS = { slp: 6, enable: 7, direction: 8, step: 10, ms1: 11, ms2: 12 }
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-stepper = Denko::Motor::Stepper.new(board: board, pins: PINS)
-
-# Default is 8 microsteps. Use 2 to move faster.
-stepper.microsteps = 2
-
-# 400 steps is now 1 revolution for a 200 step motor.
-400.times do
-  stepper.step_ccw
-  sleep 0.002
-end
-
-# Sleep the driver and wait a while.
-stepper.sleep
-sleep 1
-
-# Wake it up and set to full steps.
-stepper.wake
-stepper.microsteps = 1
-
-#
-# Now 200 steps the other way will return to the start.
-# Longer sleep times to match bigger steps. Adjust for your motor.
-#
-200.times do
-  stepper.step_cw
-  sleep 0.006
-end
-
-# Sleep the driver once we're done.
-stepper.sleep
-
-# Writing to the board is done asynchronously.
-# Make sure all commands are written before exit.
-board.finish_write

data/examples/one_wire/search.rb

@@ -1,32 +0,0 @@
-#
-# Search a 1-Wire bus.
-#
-require 'bundler/setup'
-require 'denko'
-
-PIN   = 4
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-bus   = Denko::OneWire::Bus.new(board: board, pin: PIN)
-
-# Call #device_present to reset the bus and return presence pulse as a boolean.
-if bus.device_present?
-  puts "Devices present on bus..."; puts
-else
-  puts "No devices present on bus... Quitting..."
-  return
-end
-
-# The bus detects parasite power automatically when initialized.
-# It can tell that parasite power is in use, but not by WHICH devices.
-if bus.parasite_power
-  puts "Parasite power detected..."; puts
-end
-
-# Calling #search finds connected devices and stores them in #found_devices.
-# Each hash contains a device's ROM address and matching Ruby class if one exists.
-bus.search
-count = bus.found_devices.count
-puts "Found #{count} device#{'s' if count > 1} on the bus:"
-
-puts bus.found_devices.inspect

data/examples/pulse_io/buzzer.rb

@@ -1,35 +0,0 @@
-#
-# Example of playing a melody on a piezoelectric buzzer.
-#
-require 'bundler/setup'
-require 'denko'
-
-PIN    = 9
-
-board  = Denko::Board.new(Denko::Connection::Serial.new)
-buzzer = Denko::PulseIO::Buzzer.new(board: board, pin: PIN)
-
-C4 = 262
-D4 = 294
-E4 = 330
-
-notes = [
-        [E4, 1], [D4, 1], [C4, 1], [D4, 1], [E4, 1], [E4, 1], [E4, 2],
-        [D4, 1], [D4, 1], [D4, 2],          [E4, 1], [E4, 1], [E4, 2],
-        [E4, 1], [D4, 1], [C4, 1], [D4, 1], [E4, 1], [E4, 1], [E4, 1], [E4, 1],
-        [D4, 1], [D4, 1], [E4, 1], [D4, 1], [C4, 4],
-        ]
-
-bpm = 240
-beat_time = 60.to_f / bpm
-
-notes.each do |note|
-  buzzer.tone(note[0])
-  sleep note[1] * beat_time
-
-  # Stop for a bit so notes are properly defined.
-  buzzer.stop; sleep 0.010
-end
-
-buzzer.stop
-board.finish_write

data/examples/pulse_io/ir_output.rb

@@ -1,51 +0,0 @@
-#
-# Test of the IROutput (infrared transmitter) class.
-# The specific NEC code is one taken from the Arduino example:
-# https://github.com/Arduino-IRremote/Arduino-IRremote/tree/master/examples/SendDemo
-#
-# To test your emitter works, flash the recieve sketch on a second board:
-# https://github.com/Arduino-IRremote/Arduino-IRremote/tree/master/examples/ReceiveDemo
-# Attach an IR receiver to the receive pin (2 for Atmel AVR) and observe its serial output.
-#
-# If you don't have 2 boards, use that sketch to capture a code from a remote.
-# Copy the raw code (list of numbers in curly braces) and modify into a Ruby array.
-# Put denko firmare back on your board, then test if the IR code operates your device.
-#
-# IR codes are also available from sites like:
-# https://github.com/zmoteio/irdb.tk
-# If formatted numbers with + and - prepended, you need to convert into a Ruby array first.
-#
-require 'bundler/setup'
-require 'denko'
-
-PIN = 4
-
-# Note: If testing with 2 boards on one computer, be explicit about which serial device
-# runs denko. Use the second Serial.new call below and modify device: as needed.
-# Monitor the receiver board in the Arduino (or some other) serial monitor.
-#
-connection = Denko::Connection::Serial.new
-# connection = Denko::Connection::Serial.new(device: "/dev/ttyACM0")
-board = Denko::Board.new(connection)
-
-#
-# Infrared can be used on most pins for most boards, but there might be conflicts
-# with other hardware or libraries. Try different pins. For more info:
-# https://github.com/Arduino-IRremote/Arduino-IRremote?#timer-and-pin-usage
-#
-ir = Denko::PulseIO::IROutput.new(board: board, pin: PIN)
-
-# NEC Raw-Data=0xF708FB04. LSBFIRST, so the binary for each hex digit below is backward.
-code =  [ 9000, 4500,                                 # Start bit
-          560, 560, 560, 560, 560, 1690, 560, 560,    # 0010 0x4 command
-          560, 560, 560, 560, 560, 560, 560, 560,     # 0000 0x0 command
-          560, 1690, 560, 1690, 560,560, 560, 1690,   # 1101 0xB command inverted
-          560, 1690, 560, 1690, 560, 1690, 560, 1690, # 1111 0xF command inverted
-          560, 560, 560, 560, 560, 560, 560, 1690,    # 0001 0x8 address
-          560, 560, 560, 560, 560, 560, 560, 560,     # 0000 0x0 address
-          560, 1690, 560, 1690, 560, 1690, 560, 560,  # 1110 0x7 address inverted
-          560, 1690, 560, 1690, 560, 1690, 560, 1690, # 1111 0xF address inverted
-          560]                                        # Stop bit
-
-ir.write(code)
-board.finish_write

data/examples/pulse_io/pwm_output.rb

@@ -1,30 +0,0 @@
-#
-# PWM (pulse width modulation) output demo.
-# Frequency and resolution are configurable (only on ESP32 and PiBoard/Linux for now).
-# Capture output with logic analyzer or oscilloscope to verify accuracy.
-#
-require 'bundler/setup'
-require 'denko'
-
-PIN = 2
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-pwm = Denko::PulseIO::PWMOutput.new(board: board, pin: PIN)
-
-# Resolution test: ~1% duty at 1 kHz / 10-bit.
-# On and off approx. 10us and 990us respectively.
-pwm.pwm_enable(frequency: 1_000, resolution: 10)
-pwm.write 10 # of 1023
-sleep 0.5
-pwm.digital_write 0
-
-sleep 0.5
-
-# Frequency test: ~50% duty at 10 kHz / 8-bit.
-# On and off both approx. 50us.
-pwm.pwm_enable(frequency: 10_000, resolution: 8)
-pwm.write 127 # of 255
-sleep 0.5
-pwm.digital_write 0
-
-board.finish_write

data/examples/rtc/ds3231.rb

@@ -1,31 +0,0 @@
-#
-# D3231 real-time-clock over I2C. Set time and read back every 5 seconds.
-#
-require 'bundler/setup'
-require 'denko'
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-i2c   = Denko::I2C::Bus.new(board: board) # address: 0x68 default
-
-# Tell the bus to search for devices.
-i2c.search
-
-if i2c.found_devices.empty?
-  puts "No I2C devices connected!"
-  return
-end
-
-# 0x68 is the I2C address for most real time clocks.
-unless (i2c.found_devices.include? 0x68)
-  puts "DS3231 real time clock not found!"
-  return
-end
-
-puts "Using DS3231 RTC at address 0x68"; puts
-rtc = Denko::RTC::DS3231.new(bus: i2c, address: 0x68)
-rtc.time = Time.now
-
-5.times do
-  puts rtc.time
-  sleep 5
-end

data/examples/sensor/aht10.rb

@@ -1,17 +0,0 @@
-#
-# AHT10 sensor over I2C, for temperature and humidity.
-#
-require 'bundler/setup'
-require 'denko'
-require_relative 'neat_tph_readings'
-
-board  = Denko::Board.new(Denko::Connection::Serial.new)
-bus    = Denko::I2C::Bus.new(board: board)
-sensor = Denko::Sensor::AHT10.new(bus: bus) # address: 0x38 default
-
-# Poll it and print readings.
-sensor.poll(5) do |reading|
-  print_tph_reading(reading)
-end
-
-sleep

data/examples/sensor/aht20.rb

@@ -1,17 +0,0 @@
-#
-# AHT21 sensor over I2C, for temperature and humidity.
-#
-require 'bundler/setup'
-require 'denko'
-require_relative 'neat_tph_readings'
-
-board  = Denko::Board.new(Denko::Connection::Serial.new)
-bus    = Denko::I2C::Bus.new(board: board)
-sensor = Denko::Sensor::AHT20.new(bus: bus) # address: 0x38 default
-
-# Poll it and print readings.
-sensor.poll(5) do |reading|
-  print_tph_reading(reading)
-end
-
-sleep

data/examples/sensor/bme280.rb

@@ -1,38 +0,0 @@
-#
-# BME280 sensor over I2C, for temperature, pressure and humidity.
-#
-require 'bundler/setup'
-require 'denko'
-require_relative 'neat_tph_readings'
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-bus   = Denko::I2C::Bus.new(board: board)
-
-sensor = Denko::Sensor::BME280.new(bus: bus) # address: 0x76 default
-# Use A BMP280 with no humidity instead.
-# sensor = Denko::Sensor::BMP280.new(bus: bus) # address: 0x76 default
-
-# Default reading mode is oneshot ("forced" in datasheet).
-# sensor.oneshot_mode
-
-# Enable oversampling independently on each sensor.
-# sensor.temperature_samples = 8
-# sensor.pressure_samples = 2
-# sensor.humidity_samples = 4
-
-# Enable continuous reading mode ("normal" in datasheet), with standby time and IIR filter.
-# sensor.continuous_mode
-# sensor.standby_time = 62.5
-# sensor.iir_coefficient = 4
-
-# Print raw config register bits.
-# print sensor.config_register_bits
-
-# Get the shared #print_tph_reading method to print readings neatly.
-
-# Poll it and print readings.
-sensor.poll(5) do |reading|
-  print_tph_reading(reading)
-end
-
-sleep

data/examples/sensor/bmp180.rb

@@ -1,26 +0,0 @@
-#
-# BMP180 sensor over I2C, for temperature and pressure.
-#
-require 'bundler/setup'
-require 'denko'
-require_relative 'neat_tph_readings'
-
-board  = Denko::Board.new(Denko::Connection::Serial.new)
-bus    = Denko::I2C::Bus.new(board: board)
-sensor = Denko::Sensor::BMP180.new(bus: bus) # address: 0x77 default
-
-# Enable oversampling for the pressure sensor only (1,2,4, 8).
-# sensor.pressure_samples = 8
-
-# Demonstrate helper methods
-result = sensor.read
-puts "Temperature unit helpers: #{sensor.temperature} \xC2\xB0C | #{sensor.temperature_f} \xC2\xB0F | #{sensor.temperature_k} K"
-puts "Pressure unit helpers: #{sensor.pressure} Pa | #{sensor.pressure_atm.round(6)} atm | #{sensor.pressure_bar.round(6)} bar"
-puts
-
-# Poll it and print readings.
-sensor.poll(5) do |reading|
-  print_tph_reading(reading)
-end
-
-sleep

data/examples/sensor/dht.rb

@@ -1,29 +0,0 @@
-#
-# DHT sensor class for DHT 11 and DHT 22 sensors.
-#
-require 'bundler/setup'
-require 'denko'
-require_relative 'neat_tph_readings'
-
-PIN    = 5
-
-board  = Denko::Board.new(Denko::Connection::Serial.new)
-sensor = Denko::Sensor::DHT.new(board: board, pin: PIN)
-
-sensor.read
-if sensor.temperature
-  puts "Temperature unit helpers: #{sensor.temperature} \xC2\xB0C | #{sensor.temperature_f} \xC2\xB0F | #{sensor.temperature_k} K"; puts
-else
-  puts "ERROR: Sensor not connected... Quitting..."
-  return
-end
-
-# Don't try to read it again too quickly.
-sleep(1)
-
-# Poll it and print readings.
-sensor.poll(5) do |reading|
-  print_tph_reading(reading)
-end
-
-sleep

data/examples/sensor/ds18b20.rb

@@ -1,57 +0,0 @@
-#
-# Example of how to use the Dallas DS18B20 temperature sensor.
-#
-require 'bundler/setup'
-require 'denko'
-
-PIN   = 4
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-bus   = Denko::OneWire::Bus.new(board: board, pin: PIN)
-
-unless bus.device_present?
-  puts "No devices present on bus... Quitting..."
-  return
-end
-
-if bus.parasite_power
-  puts "Parasite power detected..."; puts
-end
-
-# Search the bus and use results to set up DS18B20 instances.
-bus.search
-ds18b20s = []
-bus.found_devices.each do |d|
-  if d[:class] == Denko::Sensor::DS18B20
-    ds18b20s << d[:class].new(bus: bus, address: d[:address])
-  end
-end
-
-if ds18b20s.empty?
-  puts "No DS18B20 sensors found on the bus... Quitting...";
-else
-  puts "Found DS18B20 sensors with these serials:"
-  puts ds18b20s.map { |d| d.serial_number }
-  puts
-end
-
-# Format a reading for printing on a line.
-def print_reading(reading, sensor)
-  print "#{Time.now.strftime '%Y-%m-%d %H:%M:%S'} - "
-  print "Serial(HEX): #{sensor.serial_number} | Res: #{sensor.resolution} bits | "
-
-  if reading[:crc_error]
-    puts "CRC check failed for this reading!"
-  else
-    fahrenheit = (reading[:temperature] * 1.8 + 32).round(1)
-    puts "#{reading[:temperature]} \xC2\xB0C | #{fahrenheit} \xC2\xB0F"
-  end
-end
-
-ds18b20s.each do |sensor|
-  sensor.poll(5) do |reading|
-    print_reading(reading, sensor)
-  end
-end
-
-sleep