Class Timing3Phase

ci/tools/led_timing_conversions.py:137–188

LED timing in 3-phase format (three-phase protocol). Protocol Timing: At T=0 : Line goes HIGH (start of bit) At T=T1 : Line goes LOW (for '0' bit) At T=T1+T2 : Line goes LOW (for '1' bit) At T=T1+T2+T3 : Cycle complete (ready for next bit) At

class Timing3Phase:
    """LED timing in 3-phase format (three-phase protocol).

    Protocol Timing:
        At T=0        : Line goes HIGH (start of bit)
        At T=T1       : Line goes LOW (for '0' bit)
        At T=T1+T2    : Line goes LOW (for '1' bit)
        At T=T1+T2+T3 : Cycle complete (ready for next bit)

    Attributes:
        T1: High time for '0' bit (nanoseconds)
        T2: Additional high time for '1' bit (nanoseconds)
        T3: Low tail duration (nanoseconds)
        name: Human-readable chipset name
    """

    def __init__(self, T1: int, T2: int, T3: int, name: str = "") -> None:
        """Initialize Timing3Phase."""
        self.T1 = T1
        self.T2 = T2
        self.T3 = T3
        self.name = name

    @property
    def duration(self) -> int:
        """Total cycle duration (T1 + T2 + T3)."""
        return self.T1 + self.T2 + self.T3

    @property
    def high_time_0(self) -> int:
        """High time for '0' bit (T1)."""
        return self.T1

    @property
    def high_time_1(self) -> int:
        """High time for '1' bit (T1 + T2)."""
        return self.T1 + self.T2

    def __repr__(self) -> str:
        """Return detailed representation."""
        if self.name:
            return (
                f"Timing3Phase({self.name}: "
                f"T1={self.T1}ns, T2={self.T2}ns, T3={self.T3}ns)"
            )
        return f"Timing3Phase(T1={self.T1}ns, T2={self.T2}ns, T3={self.T3}ns)"

    def __str__(self) -> str:
        """Return human-readable string."""
        return (
            f"T1={self.T1}ns, T2={self.T2}ns, T3={self.T3}ns (cycle={self.duration}ns)"
        )


def datasheet_to_phase3(ds: TimingDatasheet) -> Timing3Phase: