Function datasheet_to_phase3

ci/tools/led_timing_conversions.py:191–221

Convert LED timing from datasheet format to 3-phase format. This is the CORRECTED algorithm that fixes bugs in the original chipsets.h embedded Python script. Algorithm: duration = max(T0H + T0L, T1H + T1L) T1 = T0H # High time for '0' bit T2 = T1H

(ds: TimingDatasheet)

def datasheet_to_phase3(ds: TimingDatasheet) -> Timing3Phase:
    """Convert LED timing from datasheet format to 3-phase format.

    This is the CORRECTED algorithm that fixes bugs in the original
    chipsets.h embedded Python script.

    Algorithm:
        duration = max(T0H + T0L, T1H + T1L)
        T1 = T0H              # High time for '0' bit
        T2 = T1H - T0H        # Additional time for '1' bit
        T3 = duration - T1H   # Tail time after '1' bit drops

    Args:
        ds: LED timing in datasheet format

    Returns:
        LED timing in 3-phase format

    Example:
        >>> ds = TimingDatasheet(T0H=400, T0L=850, T1H=850, T1L=400, name="WS2812B")
        >>> fl = datasheet_to_phase3(ds)
        >>> print(fl)
        T1=400ns, T2=450ns, T3=400ns (cycle=1250ns)
    """
    duration = max(ds.T0H + ds.T0L, ds.T1H + ds.T1L)

    T1 = ds.T0H  # High time for '0' bit
    T2 = ds.T1H - ds.T0H  # Additional time for '1' bit
    T3 = duration - ds.T1H  # Tail time after '1' bit

    return Timing3Phase(T1, T2, T3, ds.name)


def optimize_datasheet_timing(