dangernoodle-io / breadboard / 27324299439

100%

push

github

feat(bb_i2c): portable I2C bus+device abstraction (esp + host mock) (#385)

first PR of B1-42. gives consumers an I2C surface with no esp types, so
the i2c-using drivers (bb_display_ssd1306, bb_fan_emc2101,
bb_power_tps546) can stop exposing i2c_master_bus_handle_t in their
public configs (migrations follow in later PRs).

- public bb_i2c.h: opaque bb_i2c_bus_t / bb_i2c_dev_t; config is plain
  ints (port/sda/scl/clk/pullup). bus_create/delete, dev_add/remove,
  write/read/write_read, read_reg8/write_reg8.
- espidf backend wraps esp_driver_i2c (PRIV_REQUIRES; not public).
- host backend is an injectable mock (bb_i2c_test.h: reset / queue_read
  / last_write / force_err) -> the i2c drivers become host-testable for
  the first time.

verified: 1665 host tests pass (39 new); coverage 100%; smoke green on
esp32, esp32c3, esp32-p4, tdongle-s3.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

1637 of 1637 branches covered (100.0%)

Branch coverage included in aggregate %.

2755 of 2755 relevant lines covered (100.0%)

989.22 hits per line