denko 0.13.5 → 0.14.0

data/examples/sensor/bme280.rb

@@ -1,15 +1,16 @@
 #
-# Example using a BME280 sensor over I2C, for temperature, pressure and humidity.
+# 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, pin: :SDA)
+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
+# sensor = Denko::Sensor::BMP280.new(bus: bus) # address: 0x76 default
 
 # Default reading mode is oneshot ("forced" in datasheet).
 # sensor.oneshot_mode
@@ -28,7 +29,6 @@ sensor = Denko::Sensor::BME280.new(bus: bus) # address: 0x76 default
 # print sensor.config_register_bits
 
 # Get the shared #print_tph_reading method to print readings neatly.
-require_relative 'neat_tph_readings'
 
 # Poll it and print readings.
 sensor.poll(5) do |reading|

data/examples/sensor/bmp180.rb

@@ -1,18 +1,22 @@
 #
-# Example using a BMP180 sensor over I2C, for temperature and pressure.
+# 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, pin: :SDA)
+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
 
-# Get the shared #print_tph_reading method to print readings neatly.
-require_relative 'neat_tph_readings'
+# 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|

data/examples/sensor/dht.rb

@@ -1,24 +1,29 @@
 #
-# Example of how to use the DHT class for DHT 11 and DHT 22 sensors.
+# DHT sensor class for DHT 11 and DHT 22 sensors.
 #
 require 'bundler/setup'
 require 'denko'
+require_relative 'neat_tph_readings'
 
-board = Denko::Board.new(Denko::Connection::Serial.new)
-dht = Denko::Sensor::DHT.new(pin: 5, board: board)
+PIN    = 5
 
-# The DHT class pre-processes raw data from the board. When it reaches callbacks
-# it's already hash of :temperature and :humidity keys, both with Float values.
-dht.add_callback do |reading|
-  print "#{Time.now.strftime '%Y-%m-%d %H:%M:%S'} | "
-  if reading[:error]
-    puts "Error: #{reading[:error]}"
-  else
-    print "#{reading[:celsius]} \xC2\xB0C | #{reading[:fahrenheit]} \xC2\xB0F | "
-    puts "#{reading[:humidity]}% relative humidity"
-  end
+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
 
-# Read it every 5 seconds.
-dht.poll(5)
 sleep

data/examples/sensor/ds18b20.rb

@@ -4,31 +4,22 @@
 require 'bundler/setup'
 require 'denko'
 
-board = Denko::Board.new(Denko::Connection::Serial.new)
-bus = Denko::OneWire::Bus.new(pin:4, board: board)
+PIN   = 4
 
-# 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
+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
+unless bus.device_present?
   puts "No devices present on bus... Quitting..."
   return
 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; puts
+if bus.parasite_power
+  puts "Parasite power detected..."; puts
+end
 
-# We can use the search results to setup instances of the device classes.
+# 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
@@ -36,7 +27,15 @@ bus.found_devices.each do |d|
   end
 end
 
-#  Format a reading for printing on a line.
+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 | "
@@ -44,8 +43,8 @@ def print_reading(reading, sensor)
   if reading[:crc_error]
     puts "CRC check failed for this reading!"
   else
-    print "#{reading[:celsius]} \xC2\xB0C | #{reading[:fahrenheit]} \xC2\xB0F | "
-    puts "Raw: #{reading[:raw].inspect}"
+    fahrenheit = (reading[:temperature] * 1.8 + 32).round(1)
+    puts "#{reading[:temperature]} \xC2\xB0C | #{fahrenheit} \xC2\xB0F"
   end
 end
 

data/examples/sensor/generic_pir.rb

@@ -13,8 +13,10 @@
 require 'bundler/setup'
 require 'denko'
 
-board = Denko::Board.new(Denko::Connection::Serial.new)
-sensor = Denko::Sensor::GenericPIR.new(board: board, pin: 8)
+PIN    = 8
+
+board  = Denko::Board.new(Denko::Connection::Serial.new)
+sensor = Denko::Sensor::GenericPIR.new(board: board, pin: PIN)
 
 sensor.on_motion_start { print "Motion detected!      \r" }
 sensor.on_motion_stop  { print "No motion detected... \r" }

data/examples/sensor/hcsr04.rb

@@ -4,10 +4,13 @@
 require 'bundler/setup'
 require 'denko'
 
+TRIGGER_PIN = 6
+ECHO_PIN    = 7
+
 board = Denko::Board.new(Denko::Connection::Serial.new)
-hcsr04 = Denko::Sensor::HCSR04.new(board: board, pins: {trigger: 6, echo: 7})
+hcsr04 = Denko::Sensor::HCSR04.new(board: board, pins: {trigger: TRIGGER_PIN, echo: ECHO_PIN})
 
-hcsr04.poll(0.05) do |distance|
+hcsr04.poll(0.50) do |distance|
   puts "Distance: #{distance} mm"
 end
 

data/examples/sensor/htu21d.rb

@@ -1,11 +1,12 @@
 #
-# Example using HTU21D sensor over I2C, for temperature and humidity.
+# HTU21D 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, pin: :SDA)
+board  = Denko::Board.new(Denko::Connection::Serial.new)
+bus    = Denko::I2C::Bus.new(board: board)
 htu21d = Denko::Sensor::HTU21D.new(bus: bus) # address: 0x40 default
 
 # Get and set heater state.
@@ -30,25 +31,13 @@ puts "Temperature resolution: #{htu21d.resolution[:temperature]} bits"
 puts "Humidity resolution:    #{htu21d.resolution[:humidity]} bits"
 puts
 
-# Take direct readings by calling methods on the HTU21D instance.
-#   Note: These methods do not take block callbacks like other components.
-#         The HTU21D class doesn't directly implement polling methods either.
-#
-puts "Direct Temperature: #{htu21d.read_temperature.round(3)} \xC2\xB0C"
-puts "Direct Humidity:    #{htu21d.read_humidity.round(3)} %"
-puts
-
-# The last read state can be accessed through sub-objects or [].
-puts "Last Temperature: #{htu21d.temperature.fahrenheit.round(3)} \xC2\xB0F" 
-puts "Last Humidity:    #{htu21d[:humidity].round(3)} %"
+htu21d.read
+puts "Temperature unit helpers: #{htu21d.temperature} \xC2\xB0C | #{htu21d.temperature_f} \xC2\xB0F | #{htu21d.temperature_k} K"
 puts
 
-# Poll temperature and humidity at different rates by calling methods on the sub-objects.
-htu21d.temperature.poll(2) do |value|
-  puts "Sub-Object Temperature: #{value.round(3)} \xC2\xB0C"
-end
-htu21d.humidity.poll(4) do |value|
-  puts "Sub-Object Humidity:    #{value.round(3)} %"
+# Poll it and print readings.
+htu21d.poll(5) do |reading|
+  print_tph_reading(reading)
 end
 
 sleep

data/examples/sensor/htu31d.rb

@@ -1,12 +1,13 @@
 #
-# Example using HTU31D sensor over I2C, for temperature and humidity.
+# HTU31D 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, pin: :SDA)
-sensor = Denko::Sensor::HTU31D.new(bus: bus)
+board  = Denko::Board.new(Denko::Connection::Serial.new)
+bus    = Denko::I2C::Bus.new(board: board)
+sensor = Denko::Sensor::HTU31D.new(bus: bus) # address: 0x40 default
 
 # Get and set heater state.
 sensor.heater_on
@@ -22,12 +23,9 @@ puts
 
 # Resolution goes from 0..3 separately for temperature and humidity. See datasheet.
 sensor.temperature_resolution = 3
-sensor.humidity_resolution = 3
-
-# Get the shared #print_tph_reading method to print readings neatly.
-require_relative 'neat_tph_readings'
+sensor.humidity_resolution    = 3
 
-# Unlike HTU21D, HTU31D works as a regular polled sensor.
+# Poll it and print readings.
 sensor.poll(5) do |reading|
   print_tph_reading(reading)
 end

data/examples/sensor/neat_tph_readings.rb

@@ -3,24 +3,30 @@
 # Give a hash with readings as float values and it prints them neatly.
 #
 def print_tph_reading(reading)
-  # Time
-  print "#{Time.now.strftime '%Y-%m-%d %H:%M:%S'} - "
-  
+  elements = []
+
   # Temperature
-  formatted_temp = reading[:temperature].to_f.round(2).to_s.ljust(5, '0')
-  print "Temperature: #{formatted_temp} \xC2\xB0C"
+  if reading[:temperature]
+    formatted_temp = reading[:temperature].to_f.round(2).to_s.ljust(5, '0')
+    elements << "Temperature: #{formatted_temp} \xC2\xB0C"
+  end
   
   # Pressure
   if reading[:pressure]
-    formatted_pressure = (reading[:pressure] / 101325).round(5).to_s.ljust(7, '0')
-    print " | Pressure #{formatted_pressure} atm"
+    formatted_pressure = reading[:pressure].round(2).to_s.ljust(7, '0')
+    elements << "Pressure: #{formatted_pressure} Pa"
   end
   
   # Humidity  
   if reading[:humidity]
     formatted_humidity = reading[:humidity].round(2).to_s.ljust(5, '0')
-    print " | Humidity #{formatted_humidity} %"
+    elements << "Humidity: #{formatted_humidity} %"
   end
+
+  return if elements.empty?
+  
+  # Time
+  print "#{Time.now.strftime '%Y-%m-%d %H:%M:%S'} - "
   
-  puts
+  puts elements.join(" | ")
 end

data/examples/sensor/qmp6988.rb

@@ -3,9 +3,10 @@
 #
 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, pin: :SDA)
+board  = Denko::Board.new(Denko::Connection::Serial.new)
+bus    = Denko::I2C::Bus.new(board: board)
 sensor = Denko::Sensor::QMP6988.new(bus: bus) # address: 0x70 default
 
 # Verify chip_id.
@@ -25,8 +26,8 @@ puts
 #
 # High accuracy settings from datasheet, with IIR of 2.
 sensor.temperature_samples = 2
-sensor.pressure_samples = 16
-sensor.iir_coefficient = 2
+sensor.pressure_samples    = 16
+sensor.iir_coefficient     = 2
 
 #
 # Change mode (default: forced_mode)
@@ -42,9 +43,6 @@ sensor.continuous_mode
 #
 # sensor.standby_time = 500
 
-# Get the shared #print_tph_reading method to print readings neatly.
-require_relative 'neat_tph_readings'
-
 # Poll it and print readings.
 sensor.poll(5) do |reading|
   print_tph_reading(reading)

data/examples/sensor/rcwl9620.rb

@@ -1,11 +1,11 @@
 #
-# Example using an RCWL-9620 sensor over I2C to measure distance.
+# RCWL-9620 sensor over I2C to measure distance.
 #
 require 'bundler/setup'
 require 'denko'
 
-board = Denko::Board.new(Denko::Connection::Serial.new)
-bus = Denko::I2C::Bus.new(board: board, pin: :SDA)
+board  = Denko::Board.new(Denko::Connection::Serial.new)
+bus    = Denko::I2C::Bus.new(board: board)
 sensor = Denko::Sensor::RCWL9620.new(bus: bus) # address: 0x57 default
 
 sensor.poll(1) do |distance|

data/examples/sensor/sht3x.rb

@@ -1,11 +1,12 @@
 #
-# Example using SHT30/31/35 sensor over I2C, for temperature and humidity.
+# SHT30/31/35 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, pin: :SDA)
+board  = Denko::Board.new(Denko::Connection::Serial.new)
+bus    = Denko::I2C::Bus.new(board: board)
 sensor = Denko::Sensor::SHT3X.new(bus: bus) # address: 0x44 default
 
 # Heater control
@@ -23,9 +24,6 @@ puts
 # Set repeatability= :low, :medium or :high (default). See datasheet for details.
 sensor.repeatability = :high
 
-# Get the shared #print_tph_reading method to print readings neatly.
-require_relative 'neat_tph_readings'
-
 # Poll it and print readings.
 sensor.poll(5) do |reading|
   print_tph_reading(reading)

data/examples/spi/bitbang_loopback.rb

@@ -0,0 +1,46 @@
+require 'bundler/setup'
+require 'denko'
+
+SPI_BIT_BANG_PINS = { clock: 13, input: 12, output: 11 }
+SELECT_PIN        = 10
+
+board = Denko::Board.new(Denko::Connection::Serial.new)
+bus = Denko::SPI::BitBang.new(board: board, pins: SPI_BIT_BANG_PINS)
+
+# Methods so results print neatly. SPI transfers don't block main thread.
+def stop_waiting
+  $waiting = false
+end
+
+def wait_for_read
+  $waiting = true
+  sleep 0.001 while $waiting
+end
+
+# Create a simple test component class.
+class SPITester
+  include Denko::SPI::Peripheral::SinglePin
+end
+spi_tester = SPITester.new(bus: bus, pin: SELECT_PIN)
+
+spi_tester.add_callback do |rx_bytes|
+  # If MOSI and MISO are connected this should match TEST_DATA.
+  # If not, all bytes should be 255.
+  puts "Result      : #{rx_bytes.inspect}"
+  stop_waiting
+end
+
+TEST_DATA = [0, 1, 2, 3, 4, 5, 6, 7]
+
+# Send and receive same data.
+puts "Tx 8 / Rx 8 : #{TEST_DATA.inspect}"
+spi_tester.spi_transfer(write: TEST_DATA, read: 8)
+wait_for_read
+
+puts "Tx 8 / Rx 12: #{TEST_DATA.inspect}"
+spi_tester.spi_transfer(write: TEST_DATA, read: 12)
+wait_for_read
+
+puts "Tx 8 / Rx 4 : #{TEST_DATA.inspect}"
+spi_tester.spi_transfer(write: TEST_DATA, read: 4)
+wait_for_read

data/examples/spi/input_register.rb

@@ -1,6 +1,5 @@
 #
-# Example of a Button connected through an input shift register (CD4021B).
-# Can be used over either a bit bang or hardware SPI interface.
+# Button connected through input shift register (CD4021B).
 #
 require 'bundler/setup'
 require 'denko'
@@ -13,16 +12,7 @@ REGISTER_SELECT_PIN = 9
 BUTTON_PIN = 0
 
 board = Denko::Board.new(Denko::Connection::Serial.new)
-
-# 1-way (input) bit bang SPI interface on any pins (slower, but flexible).
-bus = Denko::SPI::BitBang.new(board: board, pins: SPI_BIT_BANG_PINS)
-
-# Use the default hardware SPI bus (faster, but predetermined pins).
-# bus = Denko::SPI::Bus.new(board: board)
-
-# Show the hardware SPI pins to aid connection.
-# MOSI = output | MISO = input | SCK = clock
-# puts board.map.select { |name, number| [:MOSI, :MISO, :SCK].include?(name) }
+bus   = Denko::SPI::BitBang.new(board: board, pins: SPI_BIT_BANG_PINS)
 
 # InputRegister needs a bus and its select pin. The CD4021 likes SPI mode 2.
 # Other options and their defaults:
@@ -33,18 +23,18 @@ bus = Denko::SPI::BitBang.new(board: board, pins: SPI_BIT_BANG_PINS)
 #
 register = Denko::SPI::InputRegister.new(bus: bus, pin: REGISTER_SELECT_PIN, spi_mode: 2)
 
-# InputRegister implements enough of the Board interface that digital input
-# components can treat it as a Board. Do that with the Button.
+# InputRegister is a BoardProxy, so DigitalInput components can can use
+# it in place of a board. Use it with a Button instance.
 #
-# button starts listening automatically, which triggers register to start listening,
-# so it can update button as needed. Registers listen with an 8ms interval by default,
-# compared to the 4ms default for a Button directly connected to a Board.
+# button starts listening automatically, which tells register to start listening.
+# On Denko::Board, InputRegisters listen with an 8ms interval by default, compared
+# to 1ms default for a Button directly connected to a Board.
 #
-button = Denko::DigitalIO::Button.new(pin: 0, board: register)
+button = Denko::DigitalIO::Button.new(pin: BUTTON_PIN, board: register)
 
 # Button callbacks.
 button.down { puts "Button pressed"  }
 button.up   { puts "Button released" }
 
-# Sleep the main thread. Press the button and callbacks will run.
+# Keep main thread alive.
 sleep

data/examples/spi/output_register.rb

@@ -12,17 +12,10 @@ REGISTER_SELECT_PIN = 10
 # LED pin (on register parallel outputs)
 LED_PIN = 0
 
+# Works on hardware or bit-bang SPI.
 board = Denko::Board.new(Denko::Connection::Serial.new)
-
-# 1-way (output) bit bang SPI interface on any pins (slower, but flexible).
-bus = Denko::SPI::BitBang.new(board: board, pins: SPI_BIT_BANG_PINS)
-
-# Use the default hardware SPI bus (faster, but predetermined pins).
 # bus = Denko::SPI::Bus.new(board: board)
-
-# Show the hardware SPI pins to aid connection.
-# MOSI = output | MISO = input | SCK = clock
-# puts board.map.select { |name, number| [:MOSI, :MISO, :SCK].include?(name) }
+bus = Denko::SPI::BitBang.new(board: board, pins: SPI_BIT_BANG_PINS)
 
 # OutputRegister needs a bus and its select pin.
 # Other options and their defaults:
@@ -30,19 +23,18 @@ bus = Denko::SPI::BitBang.new(board: board, pins: SPI_BIT_BANG_PINS)
 #     spi_frequency:  1000000    - Only affects hardware SPI interfaces
 #     spi_mode:       0
 #     spi_bit_order:  :msbfirst
-#     write_delay:    0.001      - How long to buffer writes, in seconds
-#     buffer_writes:  true       - Wait for write_delay before writing whole register state.
-#                                  Makes proxied components write pseudo-parallelly.
 #
 register = Denko::SPI::OutputRegister.new(bus: bus, pin: REGISTER_SELECT_PIN)
 
-# We can turn the LED on by writing a 1 to the lowest bit (0) of the register.
-register.write(0b00000001)
+# Turn the LED on by setting the corresponding register bit to 1, then writing to it.
+register.bit_set(LED_PIN, 1)
+register.write
+sleep 2
 
-# OutputRegister implements enough of the Board interface that digital output
-# components can treat it as a Board. Do that with the LED instead.
+# OutputRegister is a BoardProxy, so DigitalOutput components can use
+# it in place of a board. Use it with an LED instance.
 #
-led = Denko::LED.new(board: register, pin: 0)
+led = Denko::LED.new(board: register, pin: LED_PIN)
 
 # Blink the LED and sleep the main thread.
 led.blink 0.5

data/examples/spi/ssd_through_registers.rb

@@ -0,0 +1,28 @@
+#
+# SevenSegment LED driven though a pair of daisy chained OutputRegisters
+# (74HC595), with some segments on each register.
+#
+require 'bundler/setup'
+require 'denko'
+
+# SPI pins (on board)
+SPI_BIT_BANG_PINS   = { clock: 13, output: 11 }
+REGISTER_SELECT_PIN = 10
+
+# SevenSegment pins (on registers' parallel outputs)
+SEVEN_SEGMENT_PINS = { cathode: 14, a: 10, b: 9, c: 4, d: 2, e: 1, f: 12, g: 13 }
+
+board = Denko::Board.new(Denko::Connection::Serial.new)
+bus   = Denko::SPI::BitBang.new(board: board, pins: SPI_BIT_BANG_PINS)
+
+# Model as one 2-byte (16-bit) OutputRegister, since they're daisy chained.
+# Bit numbering starts at the first register, so bit 0 of the second register
+# is bit 8 of the OutputRegister instance.
+register = Denko::SPI::OutputRegister.new(bus: bus, pin: REGISTER_SELECT_PIN, bytes: 2)
+ssd      = Denko::LED::SevenSegment.new(board: register, pins: SEVEN_SEGMENT_PINS)
+
+# Turn off the ssd on exit.
+trap("SIGINT") { exit !ssd.off }
+
+# Type a character and press Enter to show it on the SevenSegment LED.
+loop { ssd.display(gets.chomp) }

data/examples/spi/two_registers.rb

@@ -1,6 +1,6 @@
 #
-# Example of 2 SPI devices on the same bus with different select pins.
-# Combination of input_register.rb and output_register.rb
+# 2 SPI registers (74HC595 and CD4021B) on the same bus, both acting as
+# BoardProxies for their Subcomponents.
 #
 require 'bundler/setup'
 require 'denko'
@@ -11,36 +11,30 @@ OUT_REGISTER_SELECT = 10
 IN_REGISTER_SELECT  = 9
 
 # LED and Button pins (on their respective registers' parallel pins)
-LED_PIN     = 0
-BUTTON_PIN  = 0
+LED_PIN    = 0
+BUTTON_PIN = 0
 
-board = Denko::Board.new(Denko::Connection::Serial.new)
-
-# 2-way bit bang SPI bus (slower, but use any pins).
-bus = Denko::SPI::BitBang.new(board: board, pins: SPI_BIT_BANG_PINS)
-
-# Use the default hardware SPI bus (faster, but predetermined pins).
-# bus = Denko::SPI::Bus.new(board: board)
-
-# Show the hardware SPI pins to aid connection.
-# MOSI = output | MISO = input | SCK = clock
-# puts board.map.select { |name, number| [:MOSI, :MISO, :SCK].include?(name) }
-
-# OutputRegister needs a bus and its select pin.
+board        = Denko::Board.new(Denko::Connection::Serial.new)
+bus          = Denko::SPI::BitBang.new(board: board, pins: SPI_BIT_BANG_PINS)
 out_register = Denko::SPI::OutputRegister.new(bus: bus, pin: OUT_REGISTER_SELECT)
-
-# InputRegister needs a bus and its select pin. The CD4021 likes SPI mode 2.
-in_register = Denko::SPI::InputRegister.new(bus: bus, pin: IN_REGISTER_SELECT, spi_mode: 2)
+in_register  = Denko::SPI::InputRegister.new(bus: bus, pin: IN_REGISTER_SELECT, spi_mode: 2)
 
 # LED connected to the output register.
-led = Denko::LED.new(board: out_register, pin: LED_PIN)                                 
+led = Denko::LED.new(board: out_register, pin: LED_PIN)
 
 # Button connected to the input register.
 button = Denko::DigitalIO::Button.new(board: in_register, pin: BUTTON_PIN)
 
 # Button callbacks.
-button.down { led.on;  puts "Button pressed"  }
-button.up   { led.off; puts "Button released" }
+button.down do
+  led.on
+  puts "Button pressed"
+end
+
+button.up do
+  led.off
+  puts "Button released"
+end
 
-# Sleep the main thread. Press the button and callbacks will run.
+# Keep main thread alive.
 sleep

data/examples/uart/bit_bang_demo.rb

@@ -0,0 +1,25 @@
+#
+# Bit-bang UART is only used on the Arduino UNO / ATmega328p, because it has no
+# extra hardware UARTs. This also makes a self-loopback test impossible. Connect a
+# second board (Arduino Mega) and use its UART1 to verify bit-bang works on the Uno.
+#
+require 'bundler/setup'
+require 'denko'
+
+uno  = Denko::Board.new(Denko::Connection::Serial.new(device: "/dev/cu.usbserial-1450"))
+mega = Denko::Board.new(Denko::Connection::Serial.new(device: "/dev/cu.usbmodem14101"))
+
+mega_uart1  = Denko::UART::Hardware.new(board: mega, index: 1, baud: 31250)
+uno_bb_uart = Denko::UART::BitBang.new(board: uno, pins: { rx:10, tx:11 }, baud: 31250)
+
+# Write to Uno, read from Mega
+uno_bb_uart.write("Hello World!\n")
+sleep 0.5
+line = mega_uart1.gets
+puts "Mega received from Uno: #{line}"
+
+# Write to Uno, read from Mega
+mega_uart1.write("Goodbye World!\n")
+sleep 0.5
+line = uno_bb_uart.gets
+puts "Uno received from Mega: #{line}"