denko 0.13.2 → 0.13.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c1cefcc0106edf784dea04c7217bf8475887402da89aacf0c9b578185ee4c152
-  data.tar.gz: '08b1bcaac7973a3eb5b2fbbae7b7227cfbdec9250dffe9d41a95a1fe0a90565b'
+  metadata.gz: e165f677a5af1dc4d7a924e7b2387bafaca1c84c754b72eac8960fcea42117a7
+  data.tar.gz: f1c795bff6917284d3b31fbff4d1ea44de78f2871492b466f45d9f36abc340af
 SHA512:
-  metadata.gz: a0344465f58fe0e23fb579d7e903a93ecaf49a923270991c471caf674a34bf5fece80e56598878a2e690966461d2f08db15b49eccd58c09de7d2140803f2f77e
-  data.tar.gz: 7395727636ea674940fd84a7fdf55b61a32dde2329cf2f561aea7e73ea177098e8346ea7fd2a5ea0b4d6f035a0b88d2e4386ba33a3356966b9afe4322a53912c
+  metadata.gz: c897cca6c4a59ce2fbd73e517c380ba272ad0c6a621a9ba7034dffe1f83e151c21cad0671df872443eff8376ff646933a0a68cda07e25860869a06a9306fcfac
+  data.tar.gz: 6f90da47a6bb960400d9986668b2f9320248616f0a4f0a12a930e9ffda4dad0d75e1c08ecf8aae223f8882b72bd56e73dfe113a79c3973ff91c326c4ed31f941

data/.github/workflows/build_megaavr.yml

@@ -36,7 +36,7 @@ jobs:
               - name: IRremote
                 version: 4.1.2
               - name: Ethernet
-              - name: WiFi
+              - name: WiFiNINA
               - name: Adafruit NeoPixel
                 
     steps:

data/CHANGELOG.md

@@ -1,5 +1,84 @@
 # Changelog
 
+## 0.13.4
+
+### New Components
+
+- Generic PIR sensors:
+  - Class: `Denko::Sensor::GenericPIR`
+  - Based on `Denko::DigitalIO::Input` class.
+  - Tested with AS312 and HC-SR501 sensors. Should work with AM312 and others.
+
+- Bosch BMP 180 Temperature + Pressure Sensor:
+  - Class: `Denko::Sensor::BMP180`
+  - Connects via I2C bus. Ruby driver.
+  - Similar to BMP280, but fewer features (older version).
+  - Should work for BMP085 sensor as well.
+
+- SHT30/31/35 Temperature + Humidity Sensor:
+  - Class: `Denko::Sensor::SHTX`
+  - Connects via I2C bus. Ruby driver.
+  - One-shot reading mode only.
+
+- RCWL-9620 Ultrasonic Distance Sensor:
+  - Class: `Denko::Sensor::RCWL9620`
+  - Connects via I2C bus. Ruby driver.
+  - Very simple interface. `#read` returns a distance in mm.
+
+### Component Changes
+
+- HTU21D:
+  - Humidity values outside the 0-100% range will be clipped to those values automatically.
+
+### Example Changes
+
+- Added a simple button example, separate from tutorial.
+- Standardize temp/pressure/humidity sensor examples (except DHT, DS18B20, HTU21D) so readings display the same.
+
+### Bug Fixes
+
+- Fixed bug where `BMP280`` sensor class would not autoload.
+
+## 0.13.3
+
+### Board Updates / Fixes
+
+- Arduino UNO R4 Minima & Wi-Fi (`--target ra4m1`):
+  - RA4M1 fully tested
+  - Only IR-remote and WS2812 libraries not working. Disabled temporarily.
+
+- Arduino Nano Every
+  - ATmega4809 fully tested and issues fixed
+  - Works similarly to the regular AVR chips
+
+- SAMD21
+  - Changed serial acknowledgement threshold to 128 instead of 64. More stable, but might be slightly slower performing.
+
+### Network Chip Updates / Fixes
+
+- WINC1500
+  - Added support for WiFi101 library
+  - Tested on Arduino MKR 1000
+
+- NINA-W102
+  - Added conditions to select the WiFiNINA library on appropriate hardware.
+  - Untested in hardware
+
+### API Changes
+
+- Default aux message size is now  784 bytes (768 + 16) instead of (512 + 16)
+
+### Component Changes
+
+- WS2812
+  - Larger aux message size now allows up to 256 pixels (3 bytes per pixel) on a strip
+  
+### Bug Fixes
+
+- Fixed a bug with WS2812 strips where it would try to memcpy 3x the number of necessary bytes. Fixed this by just sending the total number of bytes to write to the strip, rather than number of pixels * bytes per pxiel.
+- The `val` variable in Arduino is now 16-bit instead of 8-bit.
+- Fixed instances where `Minitest` was referred to as `MiniTest`, causing tests to fail.
+
 ## 0.13.2
 
 ### New Boards

data/DEPS_CLI.md

@@ -21,6 +21,8 @@ arduino-cli core install rp2040:rp2040
 arduino-cli lib install Servo
 arduino-cli lib install Ethernet
 arduino-cli lib install WiFi
+arduino-cli lib install WiFi101
+arduino-cli lib install WiFiNINA
 arduino-cli lib install IRremote@4.1.2
 arduino-cli lib install IRremoteESP8266@2.8.4
 arduino-cli lib install ESP32Servo
@@ -34,6 +36,7 @@ arduino-cli core install arduino:megaavr
 arduino-cli lib install Servo
 arduino-cli lib install Ethernet
 arduino-cli lib install WiFi
+arduino-cli lib install WiFiNINA
 arduino-cli lib install IRremote@4.1.2
 arduino-cli lib install "Adafruit NeoPixel"
 ````
@@ -47,6 +50,8 @@ arduino-cli core install arduino:renesas_uno
 arduino-cli lib install Servo
 arduino-cli lib install Ethernet
 arduino-cli lib install WiFi
+arduino-cli lib install WiFi101
+arduino-cli lib install WiFiNINA
 arduino-cli lib install IRremote@4.1.2
 arduino-cli lib install "Adafruit NeoPixel"
 ````

data/DEPS_IDE.md

@@ -40,6 +40,8 @@ All platforms will require libraries to be installed. To install a library do th
     Servo                      by Michael Margolis, Arduino
     Ethernet                   by Various
     WiFi                       by Arduino
+    WiFi101                    by Arduino
+    WiFiNINA                   by Arduino
     IRremote         @ v4.1.2  by shirriff, z3to, ArminJo
     IRremoteESP82666 @ v2.8.5  by David Conran, Sebastien Warin
     ESP32Servo                 by Kevin Harrington, John K. Bennett
@@ -56,6 +58,7 @@ All platforms will require libraries to be installed. To install a library do th
     Servo                      by Michael Margolis, Arduino
     Ethernet                   by Various
     WiFi                       by Arduino
+    WiFiNINA                   by Arduino
     IRremote         @ v4.1.2  by shirriff, z3to, ArminJo
     Adafruit NeoPixel          by Adafruit
     ````
@@ -72,6 +75,8 @@ All platforms will require libraries to be installed. To install a library do th
     Servo                      by Michael Margolis, Arduino
     Ethernet                   by Various
     WiFi                       by Arduino
+    WiFi101                    by Arduino
+    WiFiNINA                   by Arduino
     IRremote         @ v4.1.2  by shirriff, z3to, ArminJo
     Adafruit NeoPixel          by Adafruit
     ````

data/HARDWARE.md

@@ -2,7 +2,7 @@
 
 :green_heart: Full support :yellow_heart: Partial support :heart: Planned. No support yet :question: Works in theory. Untested in real hardware.
 
-### AVR/MegaAVR Based in Arduino Products (and Clones)
+### AVR/MegaAVR Based Arduino Products (and Clones)
 [![AVR Build Status](https://github.com/denko-rb/denko/actions/workflows/build_avr.yml/badge.svg)](https://github.com/denko-rb/denko/actions/workflows/build_avr.yml)
 [![MegaAVR Build Status](https://github.com/denko-rb/denko/actions/workflows/build_megaavr.yml/badge.svg)](https://github.com/denko-rb/denko/actions/workflows/build_megaavr.yml)
 
@@ -13,7 +13,7 @@
 | ATmega32u4     | :green_heart:   | Leonardo, Micro, Leonardo ETH, Esplora, LilyPad USB |
 | ATmega1280     | :green_heart:   | Mega |
 | ATmega2560     | :green_heart:   | Mega2560, Arduino Mega ADK |
-| ATmega4809     | :question:      | Nano Every, Uno WiFi Rev2 | No hardware to test, but should work
+| ATmega4809     | :green_heart:   | Nano Every, Uno WiFi Rev2 |
 
 **Note:** Only USB boards listed. Any board with a supported chip should work, once you can flash it and connect to serial.
 
@@ -25,16 +25,23 @@
 |    Chip        | Status          | Products         | Notes |
 | :--------      | :------:        | :--------------- |------ |
 | ATSAM3X8E      | :yellow_heart:  | Due | Native USB port. Tone, and IR Out don't work.
-| ATSAMD21       | :green_heart:   | Zero, M0, M0 Pro | Native USB port
-| RA4M1          | :yellow_heart:  | Uno R4 Minima, Uno R4 WiFi | IR Out and WS2812 unsupported. UART & Wi-Fi untested
+| ATSAMD21       | :green_heart:   | Zero, M0 Series, Nano 33 IOT, MKR WiFi 1010 | Native USB
+| RA4M1          | :yellow_heart:  | Uno R4 Minima, Uno R4 WiFi | IR and WS2812 libraries don't support this yet
 
-### Arduino Accessories
+### Arduino Networking
 
-|    Chip               | Status          | Product          | Notes |
+|    Chip               | Status          | Products         | Notes |
 | :--------             | :------:        | :--------------- |------ |
 | Wiznet W5100/5500     | :green_heart:   | Ethernet Shield  | Wired Ethernet for Uno/Mega pin-compatibles
-| HDG204 + AT32UC3      | :question:      | WiFi Shield      | WiFi for Uno. No hardware to test, but compiles
-| ATWINC1500            | :question:      | WiFi Shield 101  | Same as above, high memory use, Mega only
+| HDG204 + AT32UC3      | :question:      | WiFi Shield      | Compiles, but no hardware
+| ATWINC1500            | :green_heart:   | MKR1000, WiFi Shield 101 | #define WIFI_101 for shield. Automatic for MKR1000
+| u-blox NINA-W102      | :question:      | Uno WiFi Rev 2, MKR WiFi 1010, Nano 33 IOT | Should work. No hardware
+
+### AVR Chips from [MightyCore](https://github.com/MCUdude/MightyCore)
+
+|    Chip        | Status          | Products         | Notes |
+| :--------      | :------:        | :--------------- |------ |
+| ATmega1284     | :heart:         | Used in many 8-bit 3D printer boards. | 
 
 ### Espressif Chips with Built-In Wi-Fi
 [![ESP8266 Build Status](https://github.com/denko-rb/denko/actions/workflows/build_esp8266.yml/badge.svg)](https://github.com/denko-rb/denko/actions/workflows/build_esp8266.yml)
@@ -90,12 +97,12 @@
 | I2C Bit Bang          | :heart:         | S     | `I2C::BitBang`           | Any pins
 | SPI                   | :green_heart:   | H     | `SPI::Bus`               | Predetermined pins from IDE
 | SPI Bit Bang          | :green_heart:   | S     | `SPI::BitBang`           | Any pins
-| UART                  | :green_heart:   | H     | `UART::Hardware`         | Except Atmega328, ATmega168, RA4M1
+| UART                  | :green_heart:   | H     | `UART::Hardware`         | Except Atmega328, ATmega168
 | UART Bit Bang         | :green_heart:   | S     | `UART::BitBang`          | Only ATmega328, ATmega168
 | Maxim OneWire         | :green_heart:   | S     | `OneWire::Bus`           | No overdrive
-| Infrared Emitter      | :green_heart:   | S     | `PulseIO::IRTransmitter` | Except RA4M1
+| Infrared Emitter      | :green_heart:   | S     | `PulseIO::IRTransmitter` | Except SAM3X, RA4M1
 | Infrared Receiver     | :heart:         | S     | `PulseIO::IRReceiver`    | Doable with existing library
-| WS2812                | :green_heart:   | S     | See LED table            | Except RP2040
+| WS2812                | :green_heart:   | S     | See LED table            | Except RP2040, RA4M1
 | ESP32-PCNT            | :heart:         | H     | -                        | Only ESP32. Pulse counter (for encoders)
 | ESP32-MCPWM           | :heart:         | H     | -                        | Only ESP32. Motor control PWM
 
@@ -118,6 +125,7 @@ Polling and reading follow a call and response pattern.
 | LED                | :green_heart:      | Digi/Ana Out      | `LED::Base`           |
 | RGB LED            | :green_heart:      | Digi/Ana Out      | `LED::RGB`            |
 | 7 Segment Display  | :yellow_heart:     | Digital Out       | `LED::SevenSegment`   | No decimal point
+| 8x8 LED (MAX7219)  | :heart:            | SPI               | `LED::MAX7219`        |
 | TM1637             | :heart:            | BitBang SPI       | `LED::TM1637`         | 4x 7 Segment + Colon
 | Neopixel / WS2812B | :yellow_heart:     | Adafruit Library  | `LED::WS2812`         | Not working on RP2040
 | Dotstar / APA102   | :green_heart:      | SPI               | `LED::APA102`         |
@@ -128,6 +136,12 @@ Polling and reading follow a call and response pattern.
 | :---------------         | :------:       | :--------                    | :---------------    |------ |
 | HD44780 LCD              | :green_heart:  | Digital Out, Output Register | `Display::HD44780`  |
 | SSD1306 OLED             | :yellow_heart: | I2C                          | `Display::SSD1306`  | 1 font, some graphics
+| ST7565R (128x64 Mono)    | :heart:        | SPI                          | `Display::ST7565R`  |
+| ST7735S (160x128 RGB)    | :heart:        | SPI                          | `Display::ST7735S`  |
+| ILI9341 (240x320 RGB)    | :heart:        | SPI                          | `Display::ILI9341`  |
+| GC9107 (128x128 RGB)     | :heart:        | SPI                          | `Display::GC9107`   |
+| GC9A01 (240x240 Round)   | :heart:        | SPI                          | `Display::GCA9A01`  |
+| IL0373 (212x104 E-Paper) | :heart:        | SPI                          | `Display::IL0373`   |
 
 ### Sound
 
@@ -141,9 +155,12 @@ Polling and reading follow a call and response pattern.
 | :---------------     | :------:       | :--------      | :---------------   |------ |
 | Generic Hobby Servo  | :green_heart:  | Servo/ESC PWM  | `Motor::Servo`     | Max depends on PWM channel count
 | Generic ESC          | :yellow_heart: | Servo/ESC PWM  | `Motor::Servo`     | Works. Needs its own class.
+| PCA9685              | :heart:        | I2C            | `PulseIO::PCA9685` | 16ch 12-bit PWM for servo or LED
 | L298N                | :green_heart:  | Digi + PWM Out | `Motor::L298`      | H-Bridge DC motor driver
+| DRV8833              | :heart:        | Digi + PWM Out | `Motor::DRV8833`   | H-Bridge DC motor driver
 | A3967                | :green_heart:  | Digital Out    | `Motor::Stepper`   | 1ch microstepper (EasyDriver)
-| PCA9685              | :heart:        | I2C            | `PulseIO::PCA9685` | 16ch 12-bit PWM for servo or LED
+| A4988                | :yellow_heart: | DigitalOut     | `Motor::Stepper`   | 1-ch microstepper
+| TMC2209              | :heart:        | -              | -                  | 1ch silent stepper driver
 
 ### I/O Expansion
 
@@ -160,55 +177,73 @@ Polling and reading follow a call and response pattern.
 
 ### Environmental Sensors
 
-| Name             | Status         | Interface   | Component Class    | Notes |
-| :--------------- | :------:       | :--------   | :---------------   |------ |
-| DS18B20          | :green_heart:  | OneWire     | `Sensor::DS18B20`  | Temp
-| DHT 11/21/22     | :green_heart:  | Digi In/Out | `Sensor::DHT`      | Temp/RH
-| SHT30            | :heart:        | I2C         | `Sensor::SHT30`    | Temp/RH
-| QMP6988          | :heart:        | I2C         | `Sensor::QMP6988`  | Pressure
-| BME280           | :green_heart:  | I2C         | `Sensor::BME280`   | Temp/RH/Press
-| BMP280           | :green_heart:  | I2C         | `Sensor::BMP280`   | Temp/Press
-| HTU21D           | :green_heart:  | I2C         | `Sensor::HTU21D`   | Temp/RH. User register read not implemented.
-| HTU31D           | :green_heart:  | I2C         | `Sensor::HTU31D`   | Temp/RH. Diagnostic read not implemented.
-| AHT10/15         | :green_heart:  | I2C         | `Sensor::AHT10`    | Temp/RH. Always uses calibrated mode.
-| AHT20/21/25      | :green_heart:  | I2C         | `Sensor::AHT20`    | Temp/RH. Always uses calibrated mode + CRC.
-| ENS160           | :heart:        | I2C         | `Sensor::ENS160`   | CO2e/TVOC/AQI
-| AGS02MA          | :heart:        | I2C         | `Sensor::AGS02MA`  | TVOC
-| MAX31850         | :heart:        | OneWire     | `Sensor::MAX31850` | Thermocouple Amplifier
+| Name             | Status         | Interface   | Component Class    | Type               | Notes                  |
+| :--------------- | :------:       | :--------   | :---------------   |---------------     | ---------------------- |
+| MAX31850         | :heart:        | OneWire     | `Sensor::MAX31850` | Thermocouple       |
+| MAX6675          | :heart:        | SPI         | `Sensor::MAX6675`  | Thermocouple       |
+| DS18B20          | :green_heart:  | OneWire     | `Sensor::DS18B20`  | Temp               |
+| DHT11/21/22      | :green_heart:  | Digi In/Out | `Sensor::DHT`      | Temp / RH          |
+| SHT30/31/35      | :green_heart:  | I2C         | `Sensor::SHT3X`    | Temp / RH          | M5Stack ENV III, one-shot only
+| QMP6988          | :green_heart:  | I2C         | `Sensor::QMP6988`  | Temp / Press       | M5Stack ENV III
+| BMP180           | :green_heart:  | I2C         | `Sensor::BMP180`   | Temp / Press       |
+| BMP280           | :green_heart:  | I2C         | `Sensor::BMP280`   | Temp / Press       |
+| BME280           | :green_heart:  | I2C         | `Sensor::BME280`   | Temp / Press / RH  |
+| HTU21D           | :green_heart:  | I2C         | `Sensor::HTU21D`   | Temp / RH          | No user register read
+| HTU31D           | :green_heart:  | I2C         | `Sensor::HTU31D`   | Temp / RH          | No diagnostic read
+| AHT10/15         | :green_heart:  | I2C         | `Sensor::AHT10`    | Temp / RH          |
+| AHT20/21/25      | :green_heart:  | I2C         | `Sensor::AHT20`    | Temp / RH          |
+| ENS160           | :heart:        | I2C         | `Sensor::ENS160`   | CO2e / TVOC / AQI  |
+| AGS02MA          | :heart:        | I2C         | `Sensor::AGS02MA`  | TVOC               |
+| SCD40            | :heart:        | I2C         | `Sensor::SDC40`    | Temp / Press / CO2 |
 
 ### Light Sensors
 
 | Name             | Status         | Interface    | Component Class    | Notes |
 | :--------------- | :------:       | :--------    | :---------------   |------ |
 | BH1750           | :heart:        | Digital In   | `Sensor::BH1750`   | Ambient Light
-| HC-SR501         | :yellow_heart: | Digital In   | `DigitalIO::Input` | PIR. Needs class: `Sensor::HC-SR501`
-| AS312            | :heart:        | I2C          | `Sensor::AS312`    | PIR
+| TCS34725         | :heart:        | I2C          | `Sensor::TCS34725` | RGB
 | APDS9960         | :heart:        | I2C          | `Sensor::APDS9960` | Proximity, RGB, Gesture
 
+### PIR Motion Sensors
+| Name             | Status         | Interface    | Component Class      | Notes |
+| :--------------- | :------:       | :--------    | :---------------     |------ |
+| HC-SR501         | :green_heart:  | Digital In   | `Sensor::GenericPIR` |
+| AS312            | :green_heart:  | Digital In   | `Sensor::GenericPIR` |
+
 ### Distance Sensors
 
 | Name             | Status         | Interface    | Component Class    | Notes |
 | :--------------- | :------:       | :--------    | :---------------   |------ |
 | HC-SR04          | :heart:        | Digi In/Out  | `Sensor::HCSR04`   | Ultrasonic, 20-4000mm
-| RCWL-9620        | :heart:        | I2C          | `Sensor::RCWL9260` | Ultrasonic, 20-4500mm
+| RCWL-9620        | :green_heart:  | I2C          | `Sensor::RCWL9260` | Ultrasonic, 20-4500mm
 | VL53L0X          | :heart:        | I2C          | `Sensor::VL53L0X`  | Laser, 30 - 1000mm
 | GP2Y0E03         | :heart:        | I2C          | `Sensor::GP2Y0E03` | Infrared, 40 - 500mm
 
-### Motion Sensors
+### Inertial Measurement Units
 
 | Name             | Status         | Interface | Component Class    | Notes |
 | :--------------- | :------:       | :-------- | :---------------   |------ |
-| ADXL345          | :heart:        | I2C       | `Sensor::ADXL345`  | 3-axis Accelerometer
-| IT3205           | :heart:        | I2C       | `Sensor::IT3205`   | 3-axis Gyroscope
-| HMC5883L         | :heart:        | I2C       | `Sensor::HMC5883L` | 3-axis Compass
-| MPU6886          | :heart:        | I2C       | `Sensor::MPU6886`  | 3-axis Gyro + Accel
+| ADXL345          | :heart:        | I2C       | `Sensor::ADXL345`  | Accelerometer
+| IT3205           | :heart:        | I2C       | `Sensor::IT3205`   | Gyroscope
+| HMC5883L         | :heart:        | I2C       | `Sensor::HMC5883L` | Compass
+| MPU6886          | :heart:        | I2C       | `Sensor::MPU6886`  | Gyro + Accelerometer
+| BMI160           | :heart:        | I2C       | `Sensor::BMI160`   | Gyro + Accelerometer
+| LSM6DS3          | :heart:        | I2C       | `Sensor:LSM6DS3`   | Gyro + Accelerometer
 
 ### Real Time Clocks
 
 | Name             | Status         | Interface | Component Class   | Notes |
 | :--------------- | :------:       | :-------- | :---------------  |------ |
 | DS1302           | :heart:        | I2C       | `RTC::DS1302`     |
+| DS1307           | :heart:        | I2C       | `RTC::DS1307`     |
 | DS3231           | :green_heart:  | I2C       | `RTC::DS3231`     | Alarms not implemented
+| PCF8563          | :heart:        | I2C       | `RTC::PCF8563`    |
+
+### GPS
+
+| Name             | Status         | Interface | Component Class   | Notes |
+| :--------------- | :------:       | :-------- | :---------------  |------ |
+| GT-U7            | :heart:        | UART      | -                 |
 
 ### Miscellaneous
 

data/README.md

@@ -1,4 +1,4 @@
-# Denko 0.13.1 [![Test Status](https://github.com/denko-rb/denko/actions/workflows/ruby.yml/badge.svg)](https://github.com/denko-rb/denko/actions/workflows/ruby.yml)
+# Denko 0.13.4 [![Test Status](https://github.com/denko-rb/denko/actions/workflows/ruby.yml/badge.svg)](https://github.com/denko-rb/denko/actions/workflows/ruby.yml)
 ### Ruby Meets Microcontrollers
 Denko gives you a high-level Ruby interface to low-level hardware, without writing microcontroller code. Use LEDs, buttons, sensors and more, just as easily as any Ruby object:
 
@@ -23,10 +23,10 @@ High-level abstraction in Ruby makes hardware classes easy to implement, with in
 Full list of supported mircocontroller platforms, interfaces, and peripherals is located [here](HARDWARE.md).
 
 ##### denko-piboard
-There's an add-on  in development, [denko-piboard](https://github.com/denko-rb/denko-piboard), which supports the Raspberry Pi's built in GPIO pins, as `Denko::PiBoard`, class-compatible with `Denko::Board`. Connect peripherals directly to the Pi, with no microcontroller between, then use the peripheral classes from this gem.
+The add-on gem, [denko-piboard](https://github.com/denko-rb/denko-piboard), allows you to use a Raspberry Pi's built in GPIO pins in place of an attached microcontroller. Connect things directly to the Pi, and use the same peripheral classes from this gem.
 
 ##### mruby-denko
-A solo Raspberry Pi (or other small SBC + microcontroller) is a great standalone setup if your project needs the compute power anyway, but what if you don't? Why not run Ruby on the microcontroller itself? 
+A solo Raspberry Pi (or other small SBC + microcontroller) is a great standalone setup if your project needs the compute power anyway, but what if you don't? Why not run Ruby on the microcontroller itself?
 
 That's the goal of [mruby-denko](https://github.com/denko-rb/mruby-denko): write mruby on the ESP32, using peripheral classes as close to this gem as possible. Still early in development, so limited features, but already usable.
 

data/benchmarks/i2c_ssd1306_refresh.rb

@@ -22,8 +22,13 @@
 #
 # July 15 2023 | i7 8700k CPU | CRuby 3.2.1 | 100 frames | 1 Mhz I2C frequency | Average of 3 runs
 #
-#   Arduino Uno R4      :  7.5 fps (native USB @ 115200, 32-byte I2C limit, no I2C level shifter)
-#   Arduino Uno R4      :  7.8 fps (native USB @ 230400, 32-byte I2C limit, no I2C level shifter)
+#   Arduino Uno R4 WiFi :  7.5 fps (USB through ESP32-S3 @ 115200, 32-byte I2C limit, no I2C level shifter)
+#   Arduino Uno R4 WiFi :  7.8 fps (USB through ESP32-S3 @ 230400, 32-byte I2C limit, no I2C level shifter)
+#
+# August 13 2023 | i7 8700k CPU | CRuby 3.2.1 | 100 frames | 1 Mhz I2C frequency | Average of 3 runs
+#
+#   Arduino Nano Every  :  9.2 fps (USB through ATSAMD11 @ 115200, 128-byte I2C limit, no I2C level shifter)
+#   Arduino Nano Every  : 13.0 fps (USB through ATSAMD11 @ 230400, 128-byte I2C limit, no I2C level shifter)
 #
 require 'bundler/setup'
 require 'denko'

data/examples/advanced/m5_env.rb

@@ -0,0 +1,48 @@
+#
+# This example combines the SHTX and QMP6988 examples. The M5Stack ENV III unit
+# contains both sensors, accessible over a single I2C connection.
+#
+require 'bundler/setup'
+require 'denko'
+
+board = Denko::Board.new(Denko::Connection::Serial.new)
+bus = Denko::I2C::Bus.new(board: board, pin: :SDA)
+sht = Denko::Sensor::SHT3X.new(bus: bus) # address: 0x44 default
+qmp = Denko::Sensor::QMP6988.new(bus: bus) # address: 0x70 default
+
+# Configure for higher accuracy.
+sht.repeatability = :high
+qmp.temperature_samples = 2
+qmp.pressure_samples = 16
+qmp.iir_coefficient = 2
+
+# Buggy on ESP32-S3 in forced mode. Data registers return zeroes on all but first read.
+# Can't recreate on ESP32 V1, AVR or SAMD21. Put it in contiuous mode just in case.
+qmp.continuous_mode
+
+# Get the shared #print_tph_reading method to print readings neatly.
+require_relative '../sensor/neat_tph_readings'
+
+# How many degrees C the two temperature values can differ by before a warning.
+TOLERANCE = 0.50
+
+loop do
+  # Read both sensors.
+  qmp_reading = qmp.read
+  sht_reading = sht.read
+
+  # Retry immediately if either failed.
+  next unless (sht_reading && qmp_reading)
+  
+  # Warn if large gap between temperature readings.
+  difference = (qmp_reading[:temperature] - sht_reading[:temperature]).abs
+  if (difference > TOLERANCE)
+    puts "WARNING: temperature values differed by more than #{TOLERANCE}\xC2\xB0C (#{difference.round(4)} \xC2\xB0C actual)"
+  end
+
+  # Combine values from both sensors, averaging their temperatures.
+  average_temperature = (qmp_reading[:temperature] + sht_reading[:temperature]) / 2.0
+  print_tph_reading(temperature: average_temperature, humidity: sht_reading[:humidity], pressure: qmp_reading[:pressure])
+
+  sleep 5
+end

data/examples/digital_io/button.rb

@@ -0,0 +1,13 @@
+#
+# 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/pulse_io/buzzer.rb

@@ -7,7 +7,6 @@ require 'denko'
 board = Denko::Board.new(Denko::Connection::Serial.new)
 buzzer = Denko::PulseIO::Buzzer.new(board: board, pin: 9)
 
-=begin
 C4 = 262
 D4 = 294
 E4 = 330
@@ -29,42 +28,3 @@ end
 
 buzzer.stop
 board.finish_write
-=end
-
-
-
-AS3 = 233
-BN3 = 257
-DS4 = 311
-FN4 = 349
-FS4 = 370
-GS4 = 415
-
-notes = [
-  [AS3, 1],       [AS3, 1],             [AS3, 1], [AS3, 1],
-  [AS3, 0.75], [BN3, 0.75], [DS4, 0.5], [AS3, 1], [AS3, 0.5], [nil, 0.5],
-  [AS3, 0.75], [BN3, 0.75], [DS4, 0.5], [AS3, 1], [AS3, 0.5], [nil, 0.5],
-  [AS3, 0.75], [BN3, 0.75], [DS4, 0.5], [FN4, 1], [FN4, 0.5], [nil, 0.5],
-  [GS4, 0.75], [FS4, 0.75], [FN4, 0.5], [DS4, 1], [DS4, 0.5], [nil, 0.5],
-  [GS4, 0.75], [FS4, 0.75], [FN4, 0.5], [DS4, 1], [DS4, 0.5], [nil, 0.5],
-  [AS3, 0.75], [BN3, 0.75], [DS4, 0.5], [AS3, 1], [AS3, 0.5], [nil, 0.5],
-  [AS3, 0.75], [BN3, 0.75], [DS4, 0.5], [AS3, 1], [AS3, 0.5], [nil, 0.5],
-]
-  
-bpm = 135
-beat_time = 60.to_f / bpm
-
-notes.each do |note|
-  if note[0]
-    buzzer.tone(note[0])
-    sleep(note[1] * beat_time)
-  else
-    buzzer.stop
-    sleep((note[1] * beat_time))
-  end
-  buzzer.stop
-  buzzer.micro_delay(5)
-end
-
-buzzer.stop
-board.finish_write

data/examples/sensor/aht10.rb

@@ -6,10 +6,14 @@ require 'denko'
 
 board = Denko::Board.new(Denko::Connection::Serial.new)
 bus = Denko::I2C::Bus.new(board: board, pin: :SDA)
-aht10 = Denko::Sensor::AHT10.new(bus: bus)
+sensor = Denko::Sensor::AHT10.new(bus: bus) # address: 0x38 default
 
-aht10.poll(2) do |reading|
-  puts "Polled Reading: #{reading[:temperature].round(3)} \xC2\xB0C | #{reading[:humidity].round(3)} % RH"
+# 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)
 end
 
 sleep

data/examples/sensor/aht20.rb

@@ -6,10 +6,14 @@ require 'denko'
 
 board = Denko::Board.new(Denko::Connection::Serial.new)
 bus = Denko::I2C::Bus.new(board: board, pin: :SDA)
-aht20 = Denko::Sensor::AHT20.new(bus: bus)
+sensor = Denko::Sensor::AHT20.new(bus: bus) # address: 0x38 default
 
-aht20.poll(2) do |reading|
-  puts "Polled Reading: #{reading[:temperature].round(3)} \xC2\xB0C | #{reading[:humidity].round(3)} % RH"
+# 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)
 end
 
 sleep

data/examples/sensor/bme280.rb

@@ -5,28 +5,11 @@ 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)
 
-sensor = Denko::Sensor::BME280.new(bus: bus, address: 0x76)
-
+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 reading mode is oneshot ("forced" in datasheet).
 # sensor.oneshot_mode
@@ -44,32 +27,12 @@ sensor = Denko::Sensor::BME280.new(bus: bus, address: 0x76)
 # Print raw config register bits.
 # print sensor.config_register_bits
 
-def display_reading(reading)
-  # Time
-  print "#{Time.now.strftime '%Y-%m-%d %H:%M:%S'} - "
-  
-  # Temperature
-  formatted_temp = reading[:temperature].round(2).to_s.ljust(5, '0')
-  print "Temperature: #{formatted_temp} \xC2\xB0C"
-  
-  # Pressure
-  if reading[:pressure]
-    formatted_pressure = (reading[:pressure] / 101325).round(5).to_s.ljust(7, '0')
-    print " | Pressure #{formatted_pressure} atm"
-  end
-  
-  # Humidity  
-  if reading[:humidity]
-    formatted_humidity = reading[:humidity].round(2).to_s.ljust(5, '0')
-    print " | Humidity #{formatted_humidity} %"
-  end
-  
-  puts
-end
+# Get the shared #print_tph_reading method to print readings neatly.
+require_relative 'neat_tph_readings'
 
-# Poll the sensor and print readings.
+# Poll it and print readings.
 sensor.poll(5) do |reading|
-  display_reading(reading)
+  print_tph_reading(reading)
 end
 
 sleep

data/examples/sensor/bmp180.rb

@@ -0,0 +1,22 @@
+#
+# Example using a BMP180 sensor over I2C, for temperature and pressure.
+#
+require 'bundler/setup'
+require 'denko'
+
+board = Denko::Board.new(Denko::Connection::Serial.new)
+bus = Denko::I2C::Bus.new(board: board, pin: :SDA)
+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'
+
+# Poll it and print readings.
+sensor.poll(5) do |reading|
+  print_tph_reading(reading)
+end
+
+sleep