denko 0.13.6 → 0.15.0

data/examples/analog_io/dac_loopback.rb

@@ -1,34 +0,0 @@
-#
-# Example looping the Arduino Zero's DAC back into one of its ADC pins.
-#
-require 'bundler/setup'
-require 'denko'
-
-#
-# Arduino Zero:   :DAC0 is :A0 is GPIO14
-# Arduino UNO R4: :DAC  is :A0 is GPIO14
-# ESP32 V1:       :DAC0 is GPIO25, :DAC1 is GPIO26, :A4 is GPIO32
-# ESP32-S2:       :DAC0 is GPIO17, :DAC1 is GPIO18, :A4 is GPIO5
-#
-# Connect DAC_PIN TO ADC_PIN with a jumper to test.
-#
-DAC_PIN = :DAC0
-ADC_PIN = :A4
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-dac = Denko::AnalogIO::Output.new(pin: DAC_PIN, board: board)
-adc = Denko::AnalogIO::Input.new(pin: ADC_PIN, board: board)
-
-#
-# Read values should be approximately 4x the written values, since Board#new tries to
-# set output resolution at 8-bits and input to 10-bits. Not configurable on all chips.
-# Scale may be off but, readings should still be proportional.
-#
-[0, 32, 64, 128, 192, 255].each do |output_value|
-  dac.write output_value
-  sleep 1
-  loopback_value = adc.read
-  puts "ADC reads: #{loopback_value} when DAC writes: #{output_value}"
-end
-
-board.finish_write

data/examples/analog_io/input.rb

@@ -1,55 +0,0 @@
-#
-# This example shows how to use your board's analog-to-digital-converter(ADC) pins,
-# through the AnalogIO::Input class. ADC inputs can be connected to sensors
-# which produce a variable output voltage, such as light dependent resistors,
-# or a simple temperature sensor like the TMP36.
-#
-require 'bundler/setup'
-require 'denko'
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-input = Denko::AnalogIO::Input.new(pin: :A0, board: board)
-
-# Single read that blocks the main thread. When a value is received, the given
-# code block runs only once, and then the main thread continues.
-input.read { |value| puts "#{Time.now} Single read #1: #{value}" }
-
-# Read (poll) the input every half second. This happens in a separate thread, 
-# so sleep the main thread for a while to get some values.
-# Given code block is added as a callback, and runs every time a value is received.
-input.poll(0.5) { |value| puts "#{Time.now} Polling: #{value}" }
-sleep 3
-
-# Stop polling. Automatically removes the #poll callback.
-input.stop
-
-# Listening is similar to polling. The board reads the input and sends the value
-# every time interval, except it's keeping time. We only send the initial command,
-# not one for each read. Smaller intervals like 32 milliseconds are possible.
-# Powers of 2 from 1 to 128 are supported for listener intervals.
-input.listen(32) { |value| puts "#{Time.now} Listening: #{value}" }
-sleep 0.5
-
-# Stop listening. Automatically removes the #listen callback.
-input.stop
-
-# This adds a persistent callback, which runs no matter how a read happens.
-# It will not be removed by #stop.
-input.on_data { |value| puts "#{Time.now} Persistent callback: #{value}" }
-
-# This is a persistent callback with a custom key.
-input.on_data(:test) { |value| puts "#{Time.now} Keyed callback: #{value}"}
-
-# If we do a single read, the two persistent callbacks, and the block given, should run once each.
-input.read { |value| puts "#{Time.now} Single read #2: #{value}" }
-
-# If we listen, the two persistent callbacks, and the block given should run many times.
-input.listen(8) { |value| puts "#{Time.now } Listening again: #{value}" }
-sleep 0.125
-input.stop
-
-# Remove callbacks keyed with :test.
-input.remove_callbacks(:test)
-
-# Remove all callbacks.
-input.remove_callbacks

data/examples/connection/tcp.rb

@@ -1,34 +0,0 @@
-require 'bundler/setup'
-require 'denko'
-#
-# This example shows how to use denko when connecting to a board via TCP.
-# This applies to the WiFi and Ethernet sketches, or serial sketch + ser2net.
-# Port number defaults to 3466 (denko), but may be given as a second argument.
-# It must correspond to the listening port set when the board was flashed.
-#
-connection = Denko::Connection::TCP.new("192.168.0.77", 3466)
-# connection = Denko::Connection::TCP.new("127.0.0.1")
-# connection =  Denko::Connection::TCP.new("192.168.1.2", 3466)
-#
-board = Denko::Board.new(connection)
-led = Denko::LED.new(board: board, pin: :LED_BUILTIN)
-
-[:on, :off].cycle do |switch|
-  led.send(switch)
-  sleep 0.5
-end
-#
-# ser2net can be used to simulate a TCP interface from a board running denko serial.
-# It serves the serial interface over a TCP port from the machine running ser2net.
-#
-# Example ser2net command for an Arduino UNO connected to a Mac:
-# ser2net -u -C "3466:raw:0:/dev/cu.usbmodem621:115200"
-#
-# Tell denko to connect to the IP address of the Mac, at port 3466.
-# Note: ser2net should be used in raw TCP mode, not telnet mode (more common).
-#
-# Replace /dev/cu.usbmodem621 with your denko serial device.
-# Arduino UNOs should be something like /dev/ttyACM0 under Linux.
-#
-# http://sourceforge.net/projects/ser2net/ for more info on installing and configuring ser2net.
-#

data/examples/digital_io/button.rb

@@ -1,13 +0,0 @@
-#
-# Simple button example.
-#
-require 'bundler/setup'
-require 'denko'
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-button = Denko::DigitalIO::Button.new(board: board, pin: 5, pullup: true)
-
-button.up   { puts "Button released!" } 
-button.down { puts "Button pressed!" }
-
-sleep

data/examples/digital_io/rotary_encoder.rb

@@ -1,26 +0,0 @@
-#
-# Example of a smiple rotary encoder polling at ~1ms.
-#
-# WARNING: This method is not precise at all. Please do not use it for anything
-# that requires all steps to be read for precise positioning or high speed.
-#
-require 'bundler/setup'
-require 'denko'
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-encoder = Denko::DigitalIO::RotaryEncoder.new  board: board,
-                                              pins: { clock: 4, data: 5 },
-                                              divider: 1,                 # default, reads each pin every 1ms
-                                              steps_per_revolution: 30    # default
-
-# Reverse direction if needed.
-# encoder.reverse
-
-# Reset angle and steps to 0.
-encoder.reset
-
-encoder.add_callback do |state|
-  puts "Encoder moved #{state[:change]} steps | CW step count: #{state[:steps]} | Current angle: #{state[:angle]}\xC2\xB0"
-end
-
-sleep

data/examples/display/hd44780.rb

@@ -1,39 +0,0 @@
-#
-# This example writes "Hello World!" in the display
-#
-require 'bundler/setup'
-require 'denko'
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-lcd = Denko::Display::HD44780.new  board: board,
-                                   pins: { rs: 8, enable: 9, d4: 4, d5: 5, d6: 6, d7: 7 },
-                                   cols: 16,
-                                   rows: 2
-
-# Bitmap for a custom character. 5 bits wide x 8 high.
-# Useful for generating these: https://omerk.github.io/lcdchargen/
-heart = [	0b00000,
-        	0b00000,
-        	0b01010,
-        	0b11111,
-        	0b11111,
-        	0b01110,
-        	0b00100,
-        	0b00000 ]
-                  
-# Define the character in CGRAM address 2. 0-7 are usable.
-lcd.create_char(2, heart)
-
-# Need to call home/clear/set_cursor so we go back to writing DDRAM.
-lcd.home
-
-# End the first line with the heart by writing its CGRAM address.
-lcd.print "Hello World!   "
-lcd.write(2)
-
-# Display a clock on second line, updating approximately every second.
-loop do
-  lcd.move_to 0,1
-  lcd.print(Time.now.strftime("%I:%M:%S"))
-  sleep 1
-end

data/examples/display/ssd1306.rb

@@ -1,40 +0,0 @@
-#
-# Example using an SSD1306 driven OLED screen over I2C.
-#
-require 'bundler/setup'
-require 'denko'
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-
-#
-# Default pins for the I2C0 (first) interface on most chips:
-#
-# ATmega 328p:       SDA = 'A4'  SCL = 'A5' - Arduino Uno, Nano
-# ATmega 32u4:       SDA =   2   SCL =   3  - Arduino Leonardo, Pro Micro
-# ATmega1280 / 2560: SDA =  20   SCL =  21  - Arduino Mega
-# SAM3X8E:           SDA =  20   SCL =  21  - Arduino Due
-# SAMD21G18:         SDA =  20   SCL =  21  - Arduino Zero, M0, M0 Pro
-# ESP8266:           SDA =   4   SCL =   5
-# ESP32:             SDA =  21   SCL =  22
-# RP2040:            SDA =   4   SCL =   5  - Raspberry Pi Pico (W)
-#
-# Only give the SDA pin of the I2C bus. SCL (clock) pin must be 
-# connected for it to work, but we don't need to control it.
-#
-bus = Denko::I2C::Bus.new(board: board, pin: :SDA)
-oled = Denko::Display::SSD1306.new(bus: bus, rotate: true)
-canvas = oled.canvas
-
-# Draw some text on the OLED's canvas (a Ruby memory buffer).
-canvas.text_cursor = [27,60]
-canvas.print("Hello World!")
-
-# Add some shapes to the canvas.
-baseline = 40
-canvas.rectangle(10, baseline, 30, -30)
-canvas.circle(66, baseline - 15, 15)
-canvas.triangle(87, baseline, 117, baseline, 102, baseline - 30)
-
-# Send the canvas to the OLED's graphics RAM so it shows.
-oled.draw
-board.finish_write

data/examples/display/ssd1306_s2_pico.rb

@@ -1,29 +0,0 @@
-#
-# Example using the SSD1306 OLED built into the LOLIN ES32-S2 PICO
-#
-require 'bundler/setup'
-require 'denko'
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-
-# The OLED's reset pin on this board isn't tied high. Do it manually.
-reset = Denko::DigitalIO::Output.new(board: board, pin: 18)
-reset.high
-
-bus = Denko::I2C::Bus.new(board: board, pin: :SDA)
-oled = Denko::Display::SSD1306.new(bus: bus, width: 128, height: 32)
-canvas = oled.canvas
-
-# Draw some text on the OLED's canvas (a Ruby memory buffer).
-canvas.text_cursor = [27,31]
-canvas.print("Hello World!")
-
-# Add some shapes to the canvas.
-baseline = 15
-canvas.rectangle(10, baseline, 15, -15)
-canvas.circle(66, baseline - 7, 8)
-canvas.triangle(102, baseline, 118, baseline, 110, baseline - 15)
-
-# Send the canvas to the OLED's graphics RAM so it shows.
-oled.draw
-board.finish_write

data/examples/eeprom/built_in.rb

@@ -1,32 +0,0 @@
-#
-# Example showing how to load, modify and save the board's EEPROM.
-#
-require 'bundler/setup'
-require 'denko'
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-
-# Initialization automatically gets all EEPROM data from the board.
-# eeprom = Denko::EEPROM::BuiltIn(board: board)
-eeprom = board.eeprom
-
-# EEPROM size reported by the board.
-puts "EEPROM Size: #{eeprom.length} bytes"
-
-# Write values like an array.
-eeprom[0] = 128
-eeprom[1] = 127
-
-# Changes do not save to the board automatically.
-# Call #save to write to the board, and automatically reload from it.
-eeprom.save
-
-# Read values like an array.
-puts "Address 0 contains: #{eeprom[0]}"
-
-# Enumerate like an array.
-eeprom.each_with_index do |byte, address|
-  if address == 1
-    puts "Address #{address} contains #{byte}"
-  end
-end

data/examples/i2c/search.rb

@@ -1,55 +0,0 @@
-#
-# Example that shows the default I2C bus pins, and addresses of any
-# devices connected to the bus.
-#
-require 'bundler/setup'
-require 'denko'
-
-# Method to let the user set I2C pins.
-def enter_pins
-  puts  "Please manually specify I2C pins..."
-  print "I2C SDA pin: "; sda = gets
-  print "I2C SCL pin: "; scl = gets
-  puts
-  [sda.to_i, scl.to_i]
-end
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-
-# If no board map, ask user to set pins manually.
-unless board.map
-  puts "Error: Pin map not available for this board"
-  sda, scl = enter_pins
-
-# Else get defaults from map.
-else
-  puts "Detected board: #{board.name}"
-
-  sda = board.map[:SDA] || board.map[:SDA0]
-  scl = board.map[:SCL] || board.map[:SCL0]
-
-  # If not in map, ask user to set manually.
-  unless sda && scl
-    puts "Error: I2C pins not found in this board's pin map"
-    sda, scl = enter_pins
-  end
-end
-
-puts "Using I2C interface on pins #{sda} (SDA) and #{scl} (SCL)"
-puts
-
-bus = Denko::I2C::Bus.new(board: board, pin: sda)
-bus.search
-
-if bus.found_devices.empty?
-  puts "No devices found on I2C bus"
-else
-  puts "I2C device addresses found:"
-  bus.found_devices.each do |address|
-    # Print as hexadecimal.
-    puts "0x#{address.to_s(16).upcase}"
-  end
-end
-
-puts
-board.finish_write

data/examples/led/apa102_bounce.rb

@@ -1,33 +0,0 @@
-#
-# Walk a single pixel along the length of an APA102 strip and back,
-# changing color each time it returns to position 0.
-#
-require 'bundler/setup'
-require 'denko'
-
-RED    = [255, 0, 0]
-GREEN  = [0, 255, 0]
-BLUE   = [0, 0, 255]
-WHITE  = [255, 255, 255]
-COLORS = [RED, GREEN, BLUE, WHITE]
-PIXELS = 8
-
-# Move along the strip and back, one pixel at a time.
-positions = (0..PIXELS-1).to_a + (1..PIXELS-2).to_a.reverse
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-
-# Use the default hardware SPI bus.
-bus = Denko::SPI::Bus.new(board: board)
-strip = Denko::LED::APA102.new(bus: bus, 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/apa102_breathe.rb

@@ -1,45 +0,0 @@
-#
-# Walk a single pixel along the length of an APA102 strip and back,
-# changing color each time it returns to position 0.
-#
-require 'bundler/setup'
-require 'denko'
-
-RED    = [255, 0, 0]
-GREEN  = [0, 255, 0]
-BLUE   = [0, 0, 255]
-WHITE  = [255, 255, 255]
-COLORS = [RED, GREEN, BLUE, WHITE]
-PIXELS = 3
-
-# Get all the brightness values as an array.
-brightness_steps = (0..31).to_a
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-
-# Use the default hardware SPI bus.
-bus = Denko::SPI::Bus.new(board: board)
-strip = Denko::LED::APA102.new(bus: bus, length: PIXELS)
-
-# Test global brightness control first.
-strip[0] = RED
-strip[1] = GREEN
-strip[2] = BLUE
-
-# Fade up from 0 brightness then back down.
-(brightness_steps + brightness_steps.reverse).each do |value|
-  strip.brightness = value
-  strip.show
-  sleep 0.05
-end
-
-# Test per-pixel brightness by fading different pixels different directions.
-loop do
-  (brightness_steps + brightness_steps.reverse).each do |value|
-    strip[0] = RED   +  [value]
-    strip[1] = GREEN +  [31 - value]
-    strip[2] = BLUE  +  [value]
-    strip.show
-    sleep 0.1
-  end
-end

data/examples/led/builtin_blink.rb

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

data/examples/led/seven_segment_char_echo.rb

@@ -1,15 +0,0 @@
-#
-# This is an example of how to use the ssd class
-#
-require 'bundler/setup'
-require 'denko'
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-ssd   = Denko::LED::SevenSegment.new board: board,
-                                    pins:  { cathode: 10, a: 3, b: 4, c: 5, d: 6, e: 7, f: 8, g: 9 }
-
-# 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,32 +0,0 @@
-#
-# Walk a single pixel along the length of a WS2812 strip and back,
-# changing color each time it returns to position 0.
-#
-require 'bundler/setup'
-require 'denko'
-
-RED    = [255, 0, 0]
-GREEN  = [0, 255, 0]
-BLUE   = [0, 0, 255]
-WHITE  = [255, 255, 255]
-COLORS = [RED, GREEN, BLUE, WHITE]
-
-WS2812_PIN = 4
-PIXELS = 8
-
-# Move along the strip and back, one pixel at a time.
-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: WS2812_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,21 +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'
-
-WHITE = [255, 255, 255]
-OFF = [0, 0, 0]
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-strip = Denko::LED::WS2812.new(board: board, pin: :LED_BUILTIN, length: 1)
-
-loop do
-  strip[0] = WHITE
-  strip.show
-  sleep 0.5
-  strip[0] = OFF
-  strip.show
-  sleep 0.5
-end

data/examples/motor/l298.rb

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

data/examples/motor/servo.rb

@@ -1,16 +0,0 @@
-#
-# This is an example of how to use the servo class
-#
-require 'bundler/setup'
-require 'denko'
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-servo = Denko::Motor::Servo.new(pin: 9, board: board)
-
-# 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].cycle do |angle|
-  servo.position = angle
-  sleep 0.5
-end

data/examples/motor/stepper.rb

@@ -1,43 +0,0 @@
-#
-# Example driving a stepper motor with the EasyDriver board: https://www.sparkfun.com/products/10267?
-#
-require 'bundler/setup'
-require 'denko'
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-stepper = Denko::Motor::Stepper.new  board: board,
-                                    pins: { slp: 6, enable: 7, direction: 8, step: 10, ms1: 11, ms2: 12 }
-                                        
-# Default is 8 microsteps. Set to 2 so we can move faster.
-stepper.microsteps = 2
-
-# 400 steps is now 1 revolution for a 200 step motor.
-400.times do
-  stepper.step_cc
-  sleep 0.002
-end
-
-# Sleep the driver chip 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 move us back to the start.
-# Note the longer sleep here since the steps are bigger.
-# Adjust both sleep vales to suit your motor.
-#
-200.times do
-  stepper.step_cw
-  sleep 0.006
-end
-
-# Sleep the driver once we're done.
-stepper.sleep
-
-# We write to the board asynchronously.
-# Make sure we send all step commands before exit.
-board.finish_write

data/examples/pulse_io/buzzer.rb

@@ -1,30 +0,0 @@
-#
-# Example of playing a melody on a piezoelectric buzzer.
-#
-require 'bundler/setup'
-require 'denko'
-
-board = Denko::Board.new(Denko::Connection::Serial.new)
-buzzer = Denko::PulseIO::Buzzer.new(board: board, pin: 9)
-
-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
-end
-
-buzzer.stop
-board.finish_write