tps55288 0.2.0

Rust driver skeleton for TI TPS55288 buck-boost converter (I2C)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

# TPS55288 Buck-Boost Driver (Rust)

 Rust driver skeleton for TI TPS55288 36 V / 16 A four-switch buck-boost converter with I2C control. This repo follows the patterns proven in `sc8815-rs` (no-std, sync by default, async behind the `async` feature, type-safe registers, strong error handling). Core driver helpers are in place; example/CI are pending.

## Status
- Sync + async driver helpers implemented (I2C read/write, VOUT/ILIM, VOUT_SR, feedback, cable comp, STATUS decode, init).
- Datasheet-driven register modeling in place; conversion helpers tested.
- STM32G031G8U6 reference example reserved under `examples/stm32g031g8u6/` (code TBD).

## Scope & Goals
- Provide a safe, no-std Rust driver with optional async + defmt.
- Cover I2C register map: output voltage/current limits, mode control (buck/boost/auto), PPS-style programmable voltage steps, protections, status/interrupts.
- Ship integration example for STM32G031G8U6 demonstrating PPS-like VOUT control and fault polling.

## Usage (sync)
```rust
use tps55288::driver::Tps55288;
use tps55288::{VoutSlewRate, OcpDelay, FeedbackSource, InternalFeedbackRatio, CableCompOption, CableCompLevel};
use embedded_hal::i2c::I2c;

fn example<I2C: I2c>(i2c: I2C) {
    let mut dev = Tps55288::new(i2c);
    // init() configures safe defaults but leaves OE disabled so that
    // callers can finish all register writes before enabling the power stage.
    dev.init().ok();
    // Configure output voltage, current limit, slew rate, feedback, and cable compensation.
    dev.set_vout_mv(5_000).ok();
    dev.set_ilim_ma(3_000, true).ok();
    dev.set_vout_sr(VoutSlewRate::Sr2p5MvPerUs, OcpDelay::Us128).ok();
    dev.set_feedback(FeedbackSource::Internal, InternalFeedbackRatio::R0_0564).ok();
    dev.set_cable_comp(CableCompOption::Internal, CableCompLevel::V0p0, true, true, true).ok();
    // Finally enable the output once configuration is complete.
    dev.enable_output().ok();

    let _ = dev.read_status();
}
```

## Repo Layout
- `src/` — registers, data types, driver core (sync + async helpers), error handling.
- `examples/stm32g031g8u6/` — board wiring notes and build plan (code pending).
- `docs/tps55288-datasheet.md` — full datasheet extraction with images.
- `DESIGN.md` — architecture and API plan.
- `TODO.md` — execution checklist.

## Next Steps
See `TODO.md` for the ordered task list. Remaining work includes STM32 example, CI/lefthook, defmt display polish, and expanded docs.