Class TimingSpec

ci/tools/led_timing_conversions.py:32–79

Datasheet timing specifications (min/max ranges). Attributes: T0H_min, T0H_max: T0H valid range (nanoseconds) T0L_min, T0L_max: T0L valid range (nanoseconds) T1H_min, T1H_max: T1H valid range (nanoseconds) T1L_min, T1L_max: T1L valid range (nanoseconds)

@dataclass
class TimingSpec:
    """Datasheet timing specifications (min/max ranges).

    Attributes:
        T0H_min, T0H_max: T0H valid range (nanoseconds)
        T0L_min, T0L_max: T0L valid range (nanoseconds)
        T1H_min, T1H_max: T1H valid range (nanoseconds)
        T1L_min, T1L_max: T1L valid range (nanoseconds)
    """

    T0H_min: int
    T0H_max: int
    T0L_min: int
    T0L_max: int
    T1H_min: int
    T1H_max: int
    T1L_min: int
    T1L_max: int

    def validate(self, ds: "TimingDatasheet") -> tuple[bool, list[str]]:
        """Validate datasheet timing against specifications.

        Args:
            ds: Datasheet timing to validate

        Returns:
            Tuple of (is_valid, list of error messages)
        """
        errors: list[str] = []

        if not (self.T0H_min <= ds.T0H <= self.T0H_max):
            errors.append(
                f"T0H={ds.T0H}ns out of spec (valid: {self.T0H_min}-{self.T0H_max}ns)"
            )
        if not (self.T0L_min <= ds.T0L <= self.T0L_max):
            errors.append(
                f"T0L={ds.T0L}ns out of spec (valid: {self.T0L_min}-{self.T0L_max}ns)"
            )
        if not (self.T1H_min <= ds.T1H <= self.T1H_max):
            errors.append(
                f"T1H={ds.T1H}ns out of spec (valid: {self.T1H_min}-{self.T1H_max}ns)"
            )
        if not (self.T1L_min <= ds.T1L <= self.T1L_max):
            errors.append(
                f"T1L={ds.T1L}ns out of spec (valid: {self.T1L_min}-{self.T1L_max}ns)"
            )

        return (len(errors) == 0, errors)


class TimingDatasheet: