denko 0.13.6 → 0.15.0

data/CHANGELOG.md

@@ -1,5 +1,392 @@
 # Changelog
 
+## 0.15.0
+
+### New Platform
+
+Denko now runs on mruby! This means it can run on smaller devices. The first of these is the:
+
+- Milk-V Duo
+  - Same footprint as Raspberry Pi Pico
+  - Runs Buildroot Linux on a 1GHz RISC-V CPU
+  - Prebuilt binaries and instructions available [here](https://github.com/denko-rb/mruby-denko-milkv-duo)
+  - Limitations:
+    - UART not supported yet. Consequently, the `JSNSR04T` sensor won't be fully supported either.
+    - Duo has no on-board DAC, but `AnalogIO::Output` should work when support for external DACs is added.
+
+### Updated Platforms
+
+- See [denko-piboard](https://github.com/denko-rb/denko-piboard) release notes for its matching 0.15.0 release. This is Denko for "big" Linux SBCs running CRuby.
+
+### New Peripherals
+
+- `AnalogIO::Joystick` -
+  - MultiPin. Give `x:` and `y:` in `:pins` of initialize. Both must be analog input capable.
+  - Inversion configurable, per axis
+  - Axes are swappable
+  - Deadzone and maxzone configurable, _NOT_ per axis
+
+- `DigitalIO::PCF8574` -
+  - 8-bit (channel) bi-directional I/O expander over I2C
+  - Is a `BoardProxy` so `DigitalIO` components may treat it as `Board`. Not recommended for fast inputs.
+  - Common in "backpacks" attached to HD44780 LCDs. See [example](examples/display/hd44780_thru_pcf8574.rb)
+
+- `Display::IL0373` :
+  - 212 x 104 pixel E-Paper display over SPI
+  - Black/White and Black/Red/White versions supported (B/R/W version not tested in hardware)
+  - Hardware controls: black channel inversion, H/V reflection, rotation
+
+- `Display::PCD8544` -
+  - 84 x 48 pixel backlit mono LCD over SPI
+  - Old design from Nokia phones in late 90's and early 00's
+  - Hardware controls: inversion, contrast (Vop), bias
+  - Gotcha: Pixels appear to have an aspect ratio of about 0.8
+
+- `Display::SH1107` -
+  - 128 x 128 mono OLED over I2C or SPI
+
+- `Display::SSD1680` -
+  - 296 x 128 pixel E-Paper display over SPI
+  - Black/White and Black/Red/White versions supported
+  - Hardware controls: black channel inversion, horizontal reflection
+
+- `Display::SSD1681` -
+  - 200 x 200 pixel variation of SSD1680
+
+- `Display::ST7302` -
+  - 250 x 122 pixel mono reflective LCD over SPI
+  - Hardware controls: inversion, refresh rate
+
+- `Display::ST7565` -
+  - 128 x 64 pixel backlit LCD over SPI
+  - Hardware controls: inversion, H/V reflection, rotation, brightness
+
+- `EEPROM::AT24C` -
+  - 32, 64 128  or 256 kib EEPROM over I2C
+  - Direct read/write with interface similar to Array. `#[]` and `#[]=`
+
+- `Sensor::AHT3X` -
+  - Temperature + Relative Humidity sensor over I2C
+
+- `Sensor::HDC1080` -
+  - Temperature + Relative Humidity sensor over I2C
+  - Can also monitor battery level. `#battery_low?` is true when VCC < 2.8V.
+
+- `Sensor::JSNSR04T` -
+  - Waterproof ultrasonic distance sensor, similar to HC-SR04
+  - Mode 1 supported by `Sensor::HCSR04` class
+  - This new class only supports mode 2 (UART mode)
+  - Requires `board:` AND `uart:` in initialize hash
+  - UART must be set to 9600 baud beforehand
+
+- `Sensor::SHT4X` -
+  - Temperature + Relative Humidity sensor over I2C
+
+- `Sensor::VL53L0X` -
+  - Laser distance sensor over I2C
+  - 20 - 2000mm range
+  - Only continuous mode implemented. No configuration yet.
+  - Has `#smoothing=` and `#smoothing_size=` for moving averages, like `AnalogIO::Input`
+
+### Peripheral Changes
+- `Display::Canvas` -
+  - `#print` changed to `#text`
+  - `#print_char` changed to `#draw_char`
+  - All drawing methods (`#set_pixel`, `#line`, `#circle` etc.) changed to only take keyword arguments
+  - Removed all `#filled_*` methods. Give `filled: true` to any shape method for the same result instead.
+  - Added `#current_color=` to set the default color for drawing when `color:` not given
+  - Fonts can be any size and don't need to align to page boundaries now
+  - Unset pixels/bits in fonts are now ignored (effectively transparent)
+  - Added more fonts
+  - Added integer scaling for fonts
+  - Added `#rotate(degrees)`
+  - Added `#reflect(axis)`, `#reflect_x`, and `#reflect_y`
+  - Optimized `#line` to use only integer math, avoid float
+  - Added support for multicolor e-paper displays
+    - Handled as array of 1-bit framebuffers, one per ink color
+    - __Not__ real multi-bit color yet
+
+- `Display::HD44780` -
+  - `#print` changed to `#text`, and `#set_cursor` to `#text_cursor` for consistency with `Display::Canvas`
+  - Added backlight as a subcomponent
+    - Give positive pin (anode) as `backlight:` in `pins:` hash when initializing
+    - `HD44780#backlight` is an instance of `Denko::LED::Base`
+    - Use like: `lcd.backlight.on` / `lcd.backlight.off`, or (if connected to PWM) `lcd.backlight.duty=`
+
+- `Display::MonoOLED` -
+  - Removed `rotate:` option from `#initialize`
+  - Added `#reflect_x`, `#reflect_y` and `#rotate` methods instead, to match the interface of other displays
+  - Affects `SSD1306`, `SH1106` and `SH1107` OLEDs
+
+- `EEPROM::Board` -
+  - Renamed from `EEPROM::BuiltIn`
+  - Simplified interface, matching `EEPROM::AT24C`
+  - Only provides `[]` and `[]=`, for individual values or ranges
+  - Both block, and read/write hardware immediately, rather than caching state
+
+- `LED::RBG` -
+  - Changed `#write(r,g,b)` so it takes percentages (0-100)
+  - Added `#write_8_bit` that takes an 8 bit range (0-255), regardless of the underlying PWM settings
+
+- `Sensor::DHT` reset pulse changed from 20ms to 10ms. Within spec, and appears more reliable in testing.
+
+### Behavior Changes
+- Raw Read Rework
+  - `Behavior::State`, `Behavior::Callbacks`, `Behavior::Reader`, `Behavior::Poller`, and `Behavior::Listener` have received a combined rework, allowing "raw_reads".
+  - A raw read bypasses the "update pathway": `#pre_callback_filter`, and `#update`, which would run callbacks and update component state.
+  - This simplifies development of drivers for things like sensors, where config and calibration data needs to be passed back and forth, but can't hit the update pathway. The old behavior is still available, for actual sensor data.
+  - `#_read` is a delegate method. Define it to get a single sensor reading, expected to hit the update pathway.
+  - `#_read` should _never_ be called directly now, as it might conflict with raw reads.
+  - Use `#read_nb` to trigger an async read instead. It delegates to `#_read` in a way that won't conflict.
+  - `#read` is now the same as `#read_nb`, except blocking.
+  - `#read_raw` _always_ blocks. Use it to get raw data (no `#pre_callback_filter`), and _not_ hit the update pathway.
+  - `#read_raw` _cannot_ be called if the component is currently listening. No way to gaurantee message order. Stop listening first.
+  - `#read_raw` takes a method object or Proc. It does _not_ delegate to `#_read`, since it's not meant for sensor data.
+
+- Mutex Rework
+  - `Mutex#lock` and `Mutex#unlock` now preferred over `Mutex#synchronize`, so mruby doesn't have to pass a block around.
+  - `Mutex` instances are all replaced with `MutexStub` instances in mruby, and CRuby.
+  - `Component#state` (reading) is no longer protected by a mutex, unless it's a simple Integer.
+  - `Component#state=` (writing) is still portected by `@state_mutex`.
+
+- `SPI::Peripheral::SinglePin` removed. It's simpler to use `SPI::Peripheral::MultiPin` (now renamed to `SPI::Peripheral`) for everything instead.
+
+### Microcontroller Changes
+
+- Arduino Core Version Updates:
+  - ESP32 Arduino Core  -> 3.2.0
+    - NOTE: HW CDC (UART) is still broken when sending large amounts of data both directions. If using an ESP32 board that has a USB port with a USB-UART chip (not native USB), that will be more reliable for now.
+  - All other cores     -> latest released version
+
+- Arduino Library Version Updates:
+  - Adafruit NeoPixel   -> 1.15.1
+  - ESP32Servo          -> 3.0.6
+  - IRremote            -> 4.4.2
+
+- Arduino Uno R4 (Minima and Wi-Fi):
+  - WS2812 RGB LEDs are now supported by the NeoPixel library on the RA4M1, so enabled for these
+
+- ATmega168-based microcontrollers:
+  - Removed OneWire support from default build config and replaced with bit-bang UART
+
+- AUX_SIZE:
+  - AUX_SIZE reduced to 528 bytes for almost all microcontrollers, and still 48 for ATmega168
+  - Most implemented interfaces (except infrared) work fine sending/receiving data in chunks. This allows 512 byte chunks, even if using 16 bytes for configuration etc.
+
+- SPI transfer size limits:
+  - SPI transfer sizes are now sent as 12-bit unsigned integers. This allows for a theoretical limit of 4095 bytes per SPI transaction, but AUX_SIZE is lower by default, so 520 (528 - 8 config bytes) is the practical limit, more than doubling the previous 255.
+
+### Board Interface Changes
+
+- `Board` classes must implement `#spi_limit`, which returns the maximum size (in bytes) of a SPI transaction. The same value is used for both reading and writing.
+
+- `Board` classes must implement `#pin_is_pwm?(pin)`. This takes a pin number and returns true if __that pin number is muxed to a hardware PWM output that cannot be remuxed__. This is only relevant on Linux, where calling something like `#digital_write` on a hardware PWM output does nothing, so we want to mimic it with PWM values instead.
+
+- `Board` classes must implement `#pwm_write(pin, duty)` so that the second argument is always the duty cycle in nanoseconds, not a percentage, or based on PWM timer bit-depth.
+  - The only exception is connected microcontrollers on Arduino firmware. PWM period may not always be controllable (or even known), so use values based on PWM timer bit-depth. This is handled conditionally inside `PulseIO::PWMOutput`.
+
+- `Board#one_wire_reset` arguments changed from `(pin, read_presence=0)` to `(pin, read_presence=false)`. Any truthy value will update the bus' with the presence result.
+
+### Driver convergence with mruby
+- Many classes had small changes made to avoid using CRuby features not available in mruby. These include:
+  - Avoid using `Integer#[]` to get specific bits
+  - Avoid using `Array#pack`
+  - Avoid using regexes entirely
+  - Avoid `super if defined?(super)`
+    - Use `begin; super; rescue NoMethodError; end`
+
+### Bug Fixes
+- Fixed bug where `Display::HD44780` would try to call `#board_has_write_bit?` instead of `#board.is_register?`.
+- Fixed a bug with multiple enviro sensors where calling `#state` would reset the values of all keys to `nil`.
+- Fixed bug where `Canvas#polygon` and `#path` were not passing through color to sub-methods.
+- Fixed a bug where `Behavior::MultiPin` would try to convert pins given as `nil` to Integer, creating unnecesary subcomponents on pin `0`.
+- Shortened `Sensor::DHT` reset time to 10ms, which works more reliably.
+- Write twice before rading for `Sensor::RCWL9620`, which works more reliably.
+
+## 0.14.0
+
+### Known Issues
+
+- ESP32 Boards
+  - **USB-CDC (aka native USB) appears to be broken** in the 3.0 core. Will eventually hang if sending a lot of data both directions at the same time. Use one of the standard UART interfaces until this is fixed.
+
+### New Boards
+
+- ESP32-H2 and ESP32-C6 variants (`--target esp32`):
+  - Depends on ESP32 Arduino Core 3.0+
+  - No WiFi on H2
+
+### Board Changes
+
+- ESP32 Boards
+  - 3.0+ version of the ESP32 Arduino Core now required.
+
+- Raspberry Pi Pico (RP2040)
+  - WS2812 LED strips work now.
+
+### New Peripherals
+
+- Bit-Bang I2C:
+  - Class: `Denko::I2C::BitBang`
+  - Start a software bit-banged I2C bus on any 2 pins.
+  - Interchangeable with hardware bus (`Denko::I2C::Bus`), as far as I2C peripherals are concerned.
+
+- ADS1100 Analog-to-Digital Converter:
+  - Class: `Denko::AnalogIO::ADS1100`
+  - Connects via I2C bus. Driver written in Ruby.
+  - Modeled after `AnalogIO::Input` since it's a single channel ADC.
+  - Can be read directly with `#read` or polled with `#poll`.
+  - Full scale voltage must be given in the initailize hash, `full_scale_ voltage:`.
+  - Gain and sample rate configurable. See example for more.
+
+- SSD1306 1-Color OLED
+  - Added SPI version.
+  - Both use `Denko::Display::SSD1306`. Instances mutate to I2C or SPI behavior, based on bus given.
+
+- SH1106 1-Color OLED
+  - Class: `Denko::Display::SH1106`
+  - Almost the same as SSD1306. Most driver code is shared between them.
+  - I2C and SPI versions both supported, as SSD1306 above.
+
+### Peripheral Changes
+
+- All Peripherals:
+  - On CRuby, `@state_mutex` and `@callback_mutex` are now instances of `Denko::MutexStub`, which just runs the given block when called with `#synchronize`.
+  - The options hash (now called params), given to `#initialize` is always available through the `#params` method.
+  - `#initialize` no longer accepts `pullup: true` or `pulldown: true`. Set mode explicitly, like `mode: :input_pullup`.
+
+- Temperature / Pressure / Humidity Sensors:
+  - `DS18B20`, `DHT` and `HTU21D` readings now match all the others (Hash with same keys).
+  - Readings standardized to be in ºC, %RH and Pascals. Callbacks always receive hash with these.
+  - `[]` access for `@state` removed removed. Use `#temperature`, `#pressure`, `#humidity` instead.
+  - Added `#temperature_f` `#temperature_k` `#pressure_atm` `#pressure_bar` helper conversion methods.
+  - `#read` methods standardized to always read ALL sub-sensors. Affects `HTU21D` and `BMP180`.
+
+- `AnalogIO::Input`:
+  - Added `#smoothing=` and `#smoothing_size=` accessors to `AnalogIO::Input` for configuration.
+  - `AnalogIO::Sensor` removed. Use `Input` instead.
+
+- `Behavior::InputPin`
+  - Added `#debounce=(time)` which just calls `Board#set_pin_debounce` for the pin. Only on `PiBoard`.
+
+- `DigitalIO::CBitBang`:
+  - New helper class. Forces initialize validation for bit-bang pins. Essential for `PiBoard`.
+  - As a side-effect, makes sure 2 low-level bit-bang Components (eg. buses) can't use the same pin.
+  - Always starts pins in `:input` mode. The bit-bang routine is expected to change them.
+
+- `DigitalIO::RotaryEncoder`:
+  - Pin names standardized to `a:` and `b:`, but still accept `:clock`, `:data`, `:clk`, `:dt`.
+  - `steps_per_revolution` changed to `counts_per_revolution`
+  - Every level change is counted now (full-quadrature). Was half-quadrature before.
+  - `counts_per_revolution` now defaults to 60 instead of 30 (generic 30-detent encoders).
+  - `state` and callback hash store `:count` instead of `:steps`.
+
+- `I2C::Bus`:
+  - No longer requires SDA pin to initialize.
+  - Accepts `index:` param (default 0) on initialize, specifying which I2C interface to use.
+    - Only works for PiBoard on Linux right now.
+  - `#update` accepts String of comma delimited ASCII numbers (Board), or Array of bytes (PiBoard).
+
+- `I2C::Peripheral`:
+  - `#i2c_read` arg order changed from `(register, num_bytes)` to `(num_bytes, register: nil)`
+
+- `LED`:
+  - `Base`, `RGB` and `SevenSegment` all inherit from `PulseIO::PWMOutput`, so see that below.
+  - `#write` MUST always be given a PWM value if used, not `0` or `1`.
+  - Prefer using `duty=` if possible, which is percentage based.
+  - Alternatively, call `#digital_write` only to stay in faster digital mode.
+
+- `LED::RGB`:
+  - `#write` takes 3 regular args now. Use `*array` instead to pass an array.
+  - `#color` only takes a symbol for one of the predefined colors (or `:off`) now.
+
+- `Motor::Stepper`:
+  - `#step_cc` renamed to `#step_ccw`.
+
+- `OneWire::Bus`:
+  - `#update` accepts String of comma delimited ASCII numbers (Board), or Array of bytes (PiBoard).
+
+- `PulseIO::IRTransmitter`:
+    - Renamed to `PulseIO::IROutput` to be more consistent with other classes.
+    - `#emit` renamed to `#write` for consistency.
+
+- `PulseIO::PWMOutput`:
+  - `#write` will never try to call `#digital_write`, always `#pwm_write`.
+  - Initial mode is `:output` instead of `:output_pwm`, saving MCU PWM channels until needed.
+  - Mode change is lazy. Happens with first call to `#pwm_write`.
+  - Call only `#digital_write` to stay in digital `:output` mode (faster).
+  - Added `#duty=`. Set duty cycle in percentage regardless of PWM resolution.
+  - Set resolution and frequency per `PWMOutput` instance (pin), instead of per `Board` instance:
+    - `#initialize` hash accepts `frequency:` and `resolution:` keys.
+    - Call `#pwm_enable` with `frequency:` and `resolution:` kwargs
+    - Or use `#resolution=` and `#frequency=` methods.
+    - Defaults are 1 kHz frequency and 8-bit resolution.
+    - **ONLY** works on ESP32 and `PiBoard` right now. Others still control at the Board level.
+    - Limited to 13-bit resolution on `Denko::Board` for now.
+
+- `SPI::Bus`:
+  - Accepts `index:` param (default 0) on initialize, specifying which SPI interface to use.
+    - Only works for PiBoard on Linux right now.
+
+- `SPI::Peripheral`:
+  - Split into `SPI:Peripheral::SinglePin` and `Spi::Peripheral::MultiPin` to allow modeling more complex peripherals.
+  - `#update` accepts String of comma delimited ASCII numbers (Board), or Array of bytes (PiBoard).
+
+- `SPI::OutputRegister`:
+  - Removed automatic buffering of writes.
+  - Call `#set_bit(value)` instead to modify state in memory, without writing to the physical register.
+  - Call `#write` to send state to the register after modifying.
+
+### Fiwmare Changes
+
+- General:
+  - Boards now report their serial buffer as 8 bytes less than the actual buffer size.
+  - Removed local callback hooks (meant for customization in C) from the Arduino sketches.
+  - Improved serial interface selection for ATSAMD21 boards. Some boards have the native interface as `Serial`, some as `SerialUSB`. The native interface is always selected now, regardless of its name.
+  - More accurate pin counts when initializing digital listener storage for different boards.
+
+- Core I/O:
+  - Removed `INPUT_OUTPUT` mode. Only ESP32 used it and it's the same as `OUTPUT`.
+  - Added an optimized single-byte binary message type for `#digital_write`. Improves write throughput 6-7x. Only works for pins 0..63. Fallback automatic for higher pins.
+
+- Hardware I2C:
+  - Message format changed so "value" isn't used. Will be used for differentiating multiple I2C interfaces in future.
+  - Responses now prefixed with `I2C{index}:` (index = I2C device integer, always 0 for now), instead of SDA pin number.
+
+- Hardware SPI:
+  - Transfers don't need a chip select pin now. This is for LED strips like APA102.
+
+- Bit-Bang I2C:
+  - Newly added. Works similar to Bit-Bang SPI.
+
+### Board Interface Changes
+
+- `Board#set_pin_mode` now takes a third hash argument, `options={}`. Only used keys are `resolution:` and `frequency:` for setting PWM resolution. Only works on ESP32 boards and `PiBoard` on Linux.
+
+- Added `Board#set_pin_debounce`
+  - Implemented for Linux GPIO alerts in `Denko::PiBoard` (denko-piboard gem).
+  - Sets a time (in microseconds) that level changes on a pin must be stable for, before an update happens.
+  - Does nothing for `Denko::Board`.
+
+- Added `OUTPUT_OPEN_DRAIN` and `OUTPUT_OPEN_SOURCE` pin modes to support `PiBoard`.
+
+### CLI Changes
+
+- All Atmel targets now prefixed with "at". Eg. `atsamd21` now, instead of `samd21` before.
+
+### Bugs Fixed
+
+- ADS111X sensors were incorrectly validating sample rate when set.
+- Handshake could fail if board was left in a state where it kept transmitting data.
+- An ESP32 with no DACs might not release a LEDC channel after use.
+- `Denko::Connection` could have negative bytes in transit, making it overflow the board's rx buffer.
+- `Servo`, `Buzzer` and `IRTransmitter` didn't start in `:output_pwm` mode.
+- `SSD1306#on` and `#off` would raise errors, trying to write Integer instead of Array to `I2C::Bus`.
+- `SPI::BitBang` did not correctly set initial clock state for modes 2 and 3.
+- `IRTransmitter.emit` didn't work at all ESP8266. Pulse data wasn't aligned properly in memory.
+- `Board#ws2812_write` was validating max length to 256 instead of 255.
+- WS2812 write on ESP32 would crash it, only with *some* low 8-bit pixel values. Still unsure why, but four extra 0 bytes (preceding the pixel data in auxMsg) seems to work around this.
+
 ## 0.13.5
 
 ### New Components
@@ -88,7 +475,7 @@
 
 - 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.
@@ -221,7 +608,7 @@ Fixes critical 1-Wire bugs introduced when namespace was reorganized for 0.13.0.
   - Connects via I2C bus. Driver written in Ruby.
   - All features in the datasheet are implemented, except status checking.
   - Both are mostly identical, except for BMP280 lacking humidity.
-  
+
 - HTU21D Temperature + Humidity Sensor:
   - Class: `Denko::Sensor::HTU21D`
   - Connects via I2C bus. Driver written in Ruby.
@@ -314,7 +701,7 @@ See new examples in the [examples](examples) folder to learn more.
   - This solves compatibility with boards that the library didn't work on.
   - `HD44780#create_char` allows 8 custom characters to be defined in memory addresses 0-7.
   - `HD44780#write` draws the custom  (or standard) character from a given memory address.
-  
+
 - `Denko::PulseIO::PWMOutput` (previously `Denko::Components::Basic::AnalogOutput`):
   - Changed `#analog_write` to `#pwm_write`.
   - Added `#pwm_enable` and `#pwm_disable` methods.
@@ -340,7 +727,7 @@ See new examples in the [examples](examples) folder to learn more.
   - All calls to `delayMicroseconds()` should be replaced with this.
   - Exposed in Ruby via `CMD=99`. It takes one argument, uint_16 for delay length in microsceonds.
   - `Board#micro_delay` and `Component::#micro_delay` are defined.
-  
+
 - `dacWrite` function added to board library. `aWrite` function renamed to `pwmWrite`. Need this to avoid conflict between DAC, PWM and regular output on some chips.
 
 - CMD numbers for some board functions changed to accomodate dacWrite:
@@ -353,7 +740,7 @@ See new examples in the [examples](examples) folder to learn more.
   pulseread   11 -> 9
   servoToggle  8 -> 10
   servoWrite   9 -> 11
-  ````  
+  ````
 
 - `Board#analog_write` replaced by `Board#pwm_write` and `Board#dac_write`, matching the two C functions.
 
@@ -431,7 +818,7 @@ See new examples in the [examples](examples) folder to learn more.
   - WiFi version supports OTA (over-the-air) update in the Arduino IDE. Initial flash must still be done via serial.
   - Dev boards can map GPIOs to physical pins differently. Always look up the GPIO numbers and use those for pin numbers.
   - **Note:** SoftwareSerial and LiquidCrystal (LCD) both do not work on the ESP8266, and are excluded from the sketch.
-  
+
 - ESP32 (`--target esp32`):
   - Works with either built in WiFi or Serial.
   - WiFi version does NOT support OTA (over-the-air) updates yet.
@@ -440,7 +827,7 @@ See new examples in the [examples](examples) folder to learn more.
   - **Note:** Servos and analog outputs share the `LEDC` channels on the board. Maximum of 16 combined.
   - **Note:** SoftwareSerial and LiquidCrystal (LCD) both do not work on the ESP32, and are excluded from the sketch.
   - **Note:** SPI bug exists where input modes don't match other platforms. Eg. For a register using mode 0 on AVR, mode 2 needs to be set on ESP32 for it to work. Using mode 0 misses a bit.
-  
+
 - Arduino Due (`--target sam3x`) :
   - Up to 12-bit analog in/out. Pass a `bits:` option to `Board#new` to set resolution for both.
   - DAC support. Refer to DAC pins as `'DAC0'`, `'DAC1'`, just as labeled on the board. Call `#analog_write` or just `#write` on an `sensor` component that uses the pin.
@@ -463,7 +850,7 @@ See new examples in the [examples](examples) folder to learn more.
 
 - Infrared Emitter support. _Uses [Arduino-IRremote](https://github.com/z3t0/Arduino-IRremote), and the [ESP8266 fork](https://github.com/markszabo/IRremoteESP8266) where applicable._
 
-- Tone (piezo) support. _Uses Arduino `tone`,`noTone` functions._ 
+- Tone (piezo) support. _Uses Arduino `tone`,`noTone` functions._
 
 - SoftwareSerial **(write only)**. _Uses Arduino `SoftSerial` library. Only tested on ATmega chips._
 
@@ -511,7 +898,7 @@ See new examples in the [examples](examples) folder to learn more.
 
 - `BoardProxy` abstraction for shift/SPI registers:
   - The `Register` classes implement enough of the `Board` interface to satisfy components based on `DigitalInput` and `DigitalOutput`, such as `Led` or `Button`.
-  - This lets you call methods on components directly, rather than manipulating the register data to control components indirectly. 
+  - This lets you call methods on components directly, rather than manipulating the register data to control components indirectly.
   - Initialize the appropriate `Register` object for the type of register. To initialize a component connected to the register, use the register as the `board:`, and give the parallel I/O pin on the register that the component is connected to. Pin 0 maps to the lowest bit.
   - This also works for `MultiPin` components built out of only `DigitalInput` or `DigitalOutput`, eg. `SSD` - seven segment display or `RGBLed`. See `examples/register` for more.
 
@@ -523,7 +910,7 @@ See new examples in the [examples](examples) folder to learn more.
 - Callback functionality for components has been extracted into a mixin module, `Mixins::Callbacks`.
   - Like before, callbacks for all components on a board run sequentially, in a single "update" thread, separate from the main thread. This is the same thread reading from TxRx.
   - `#add_callback` and `#remove_callback` methods are available, and take an optional `key` as argument.
-  - Blocks given to `#add_callback` are stored in `@callbacks[key]`, to be called later, when the "update" thread receives data for the component. The default key is `:persistent`. 
+  - Blocks given to `#add_callback` are stored in `@callbacks[key]`, to be called later, when the "update" thread receives data for the component. The default key is `:persistent`.
   - Each key represents an array of callbacks, so multiple callbacks can share the same key.
   - Calling `#remove_callbacks` with a key empties that array. Calling with no key removes **all** callbacks for the component.
   - `#pre_callback_filter` is defined in the `Callbacks` module. The return value of this method is what is given to the component's callbacks and to update its `@state`. By default, it returns whatever was given from the board.
@@ -563,7 +950,7 @@ See new examples in the [examples](examples) folder to learn more.
   * Flashing the updated sketch to the board is required.
 
 ## 0.11.1
- 
+
 ### New Features
 
 * Support for the Arduino Ethernet shield and compatibles (Wiznet W5100 chipset).

data/DEPS_CLI.md

@@ -16,17 +16,16 @@ arduino-cli core install arduino:sam
 arduino-cli core install arduino:samd
 arduino-cli core install arduino:renesas_uno
 arduino-cli core install esp8266:esp8266
-arduino-cli core install esp32:esp32@2.0.17
+arduino-cli core install esp32:esp32@3.2.0
 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
-arduino-cli lib install "Adafruit NeoPixel"
+arduino-cli lib install ESP32Servo@3.0.6
+arduino-cli lib install IRremote@4.4.2
+arduino-cli lib install "Adafruit NeoPixel"@1.15.1
 ````
 
 **AVR-based Arduinos & Clones Only:**
@@ -37,8 +36,8 @@ 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"
+arduino-cli lib install IRremote@4.4.2
+arduino-cli lib install "Adafruit NeoPixel"@1.15.1
 ````
 
 **ARM-based Arduinos & Clones Only:**
@@ -52,8 +51,8 @@ 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"
+arduino-cli lib install IRremote@4.4.2
+arduino-cli lib install "Adafruit NeoPixel"@1.15.1
 ````
 
 **ESP8266 Only:**
@@ -62,8 +61,8 @@ arduino-cli config init
 arduino-cli config add board_manager.additional_urls https://arduino.esp8266.com/stable/package_esp8266com_index.json
 arduino-cli core update-index
 arduino-cli core install esp8266:esp8266
-arduino-cli lib install IRremoteESP8266@2.8.5
-arduino-cli lib install "Adafruit NeoPixel"
+arduino-cli lib install IRremote@4.4.2
+arduino-cli lib install "Adafruit NeoPixel"@1.15.1
 ````
 
 **ESP32 Only:**
@@ -71,10 +70,10 @@ arduino-cli lib install "Adafruit NeoPixel"
 arduino-cli config init
 arduino-cli config add board_manager.additional_urls https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
 arduino-cli core update-index
-arduino-cli core install esp32:esp32@2.0.17
-arduino-cli lib install ESP32Servo
-arduino-cli lib install IRremoteESP8266@2.8.5
-arduino-cli lib install "Adafruit NeoPixel"
+arduino-cli core install esp32:esp32@3.2.0
+arduino-cli lib install ESP32Servo@3.0.6
+arduino-cli lib install IRremote@4.4.2
+arduino-cli lib install "Adafruit NeoPixel"@1.15.1
 ````
 
 **RP2040 Only:**
@@ -83,5 +82,6 @@ arduino-cli config init
 arduino-cli config add board_manager.additional_urls https://github.com/earlephilhower/arduino-pico/releases/download/global/package_rp2040_index.json
 arduino-cli core update-index
 arduino-cli core install rp2040:rp2040
-arduino-cli lib install IRremote@4.1.2
+arduino-cli lib install IRremote@4.4.2
+arduino-cli lib install "Adafruit NeoPixel"@1.15.1
 ````