Reference

JESD parameterization definitions and helper functions.

jesd

JESD interface class to manage JESD notations and definitions.

Source code in adijif/jesd.py

class jesd(metaclass=ABCMeta):
    """JESD interface class to manage JESD notations and definitions."""

    # Lane rate min/max defaulting to JESD spec (parts may differ)
    bit_clock_min_available = {"jesd204b": 312.5e6, "jesd204c": 312.5e6}
    bit_clock_max_available = {"jesd204b": 12.5e9, "jesd204c": 32e9}

    solver = "CPLEX"

    _parameters_to_return = [
        "bit_clock",
        "multiframe_clock",
        "sample_clock",
        "F",
        "HD",
        "K",
        "L",
        "M",
        "Np",
        "S",
        "CS",
        "jesd_class",
        "converter_clock",
    ]

    _skip_clock_validation = False

    def __init__(
        self, sample_clock: int, M: int, L: int, Np: int, K: int
    ) -> None:
        """Initialize JESD device through link parameterization.

        Args:
            sample_clock (int): Human readable string describing the exception.
            M (int): Number of virtual converters
            L (int): Number of lanes
            Np (int): Number of bits per sample
            K (int): Frames per multiframe

        """
        self.sample_clock = sample_clock
        self.K = K
        self.L = L
        self.M = M
        self.Np = Np
        # self.S = S

    def _check_clock_relations(self) -> None:
        """Check clock relations between clocks and JESD parameters."""
        sc = self.sample_clock
        assert (
            sc == self.frame_clock * self.S
        ), "sample_clock != S * frame_clock"
        if self.jesd_class == "jesd204b":
            assert sc == (self.bit_clock / 10 / self.F) * self.S
            assert sc == (self.multiframe_clock * self.K * self.S)

    def get_jesd_config(self, solution: CpoSolveResult = None) -> Dict:
        """Extract configurations from solver results.

        Collect JESD related parameters, includes modes and clocks.

        Args:
            solution (CpoSolveResult): CPlex solution. Only needed for CPlex solver

        Returns:
            Dict: Dictionary of JESD parameters
        """
        if solution:  # type: ignore
            self.solution = solution
        cfg = {p: getattr(self, p) for p in self._parameters_to_return}
        cfg["jesd_mode"] = self._check_valid_jesd_mode()
        return cfg

    def validate_clocks(self) -> None:
        """Validate all clocks clock settings are within range."""
        if self._skip_clock_validation:
            for name in ["bit", "sample"]:
                clk = getattr(self, name + "_clock")
                lim = getattr(self, name + "_clock_max")
                assert clk <= lim, (
                    name + f" clock too fast for device {clk} (limit: {lim})"
                )
                lim = getattr(self, name + "_clock_min")
                assert clk >= lim, (
                    name + f" clock too slow for device {clk} (limit: {lim})"
                )

    @property
    def bit_clock_min(self) -> Union[int, float]:
        """Get bit clock (lane rate) minimum based on JESD mode.

        Returns:
            int: bit clock in bits per second
        """
        if isinstance(self.jesd_class, list):
            return self.bit_clock_min_available["jesd204b"]
        return self.bit_clock_min_available[self.jesd_class]

    @property
    def bit_clock_max(self) -> Union[int, float]:
        """Get bit clock (lane rate) maximum based on JESD mode.

        Returns:
            int: bit clock in bits per second
        """
        if isinstance(self.jesd_class, list):
            return self.bit_clock_max_available["jesd204b"]
        return self.bit_clock_max_available[self.jesd_class]

    _jesd_class = "jesd204b"

    @property
    def jesd_class(self) -> Union[str, List[str]]:
        """Get JESD selected mode. Wil be either jesd204b or jesd204c."""
        return self._jesd_class

    @jesd_class.setter
    def jesd_class(self, value: str) -> None:
        """Set JESD selected mode and must be either jesd204b or jesd204c.

        Args:
            value (str): String of JESD class and must be jesd204b or jesd204c

        Raises:
            Exception: Invalid JESD class selected
        """
        if value not in self.available_jesd_modes:
            raise Exception(
                f"Invalid JESD class. Valid are: {self.available_jesd_modes}"
            )
        self._jesd_class = value
        if value == "jesd204b":
            self._encoding = "8b10b"
        else:
            self._encoding = "64b66b"

    def _check_jesd_config(self) -> None:
        """Check if bit clock is within JESD limits based on supported standard.

        Raises:
            Exception: bit clock (lane rate) too high for JESD mode or invalid
        """
        if "jesd204c" in self.available_jesd_modes:
            if self.bit_clock > 32e9:
                raise Exception(
                    f"bit clock (lane rate) {self.bit_clock} too high for JESD204C"
                )
        elif "jesd204b" in self.available_jesd_modes:
            if self.bit_clock > 12.5e9:
                raise Exception(
                    f"bit clock (lane rate) {self.bit_clock} too high for JESD204B"
                )
        else:
            raise Exception(f"JESD mode(s) {self.available_jesd_modes}")

    @property
    @abstractmethod
    def available_jesd_modes(self) -> List[str]:
        """Available JESD modes supported by device.

        Must be a list of strings

        Raises:
            NotImplementedError: If child classes do not implement method/property
        """
        raise NotImplementedError  # pragma: no cover

    """ CS: Control bits per conversion sample 0-3"""
    _CS = 0
    CS_available = [0, 1, 2, 3]

    @property
    def CS(self) -> Union[int, float]:
        """Get Control bits per conversion sample.

        Returns:
            int: Control bits per conversion sample
        """
        return self._CS

    @CS.setter
    def CS(self, value: int) -> None:
        """Set Control bits per conversion sample.

        Args:
            value (int): Control bits per conversion sample

        Raises:
            Exception: CS not an integer or not in range
        """
        if int(value) != value:
            raise Exception("CS must be an integer")
        if value not in self.CS_available:
            raise Exception("CS not in range for device")
        self._CS = value

    """ CF: Control word per frame clock period per link 0-32 """
    _CF = 0
    CF_available = [0, 1]

    @property
    def CF(self) -> Union[int, float]:
        """Get Control words per frame clock period per link.

        Returns:
            int: Control words per frame clock period per link
        """
        return self._CF

    @CF.setter
    def CF(self, value: int) -> None:
        """Set Control words per frame clock period per link.

        Args:
            value (int): Control words per frame clock period per link

        Raises:
            Exception: CF not an integer or not in range
        """
        if int(value) != value:
            raise Exception("CF must be an integer")
        if value not in self.CF_available:
            raise Exception("CF not in range for device")
        self._CF = value

    # Encoding functions

    encodings_n = {"8b10b": 8, "64b66b": 64}
    encodings_d = {"8b10b": 10, "64b66b": 66}
    _encoding = "8b10b"

    @property
    def encoding(self) -> str:
        """Get JESD FEC encoding.

        Current options are: "8b10b", "64b66b"

        Returns:
            str: String of supported encodings.
        """
        return self._encoding

    @encoding.setter
    def encoding(self, value: str) -> None:
        """Set JESD FEC encoding.

        Current options are: "8b10b", "64b66b"

        Args:
            value (str): String of desired encoding to use

        Raises:
            Exception: If encoding selected that is not supported
        """
        if self._check_encoding(value):
            raise Exception(
                "JESD encoding not possible due to available modes: {}".format(
                    self.available_jesd_modes
                )
            )
        self._encoding = value

    @property
    def encoding_d(self) -> Union[int, float]:
        """Get JESD FEC encoding denominator.

        Current options are: 10 or 66

        Returns:
            int: Denominator of link encoding.
        """
        return self.encodings_d[self._encoding]

    @property
    def encoding_n(self) -> Union[int, float]:
        """Get JESD FEC encoding numerator.

        Current options are: 8 or 64

        Returns:
            int: Numerator of link encoding.
        """
        return self.encodings_n[self._encoding]

    def _check_encoding(self, encode: str) -> bool:
        if "jesd204c" in self.available_jesd_modes:
            allowed_encodings = ["8b10b", "64b66b"]
        else:
            allowed_encodings = ["8b10b"]
        return encode not in allowed_encodings

    # SCALERS
    @property
    @abstractmethod
    def K_available(self) -> List[int]:
        """Allowable K settings for device.

        Must be a list ints

        Raises:
            NotImplementedError: If child classes do not implement method/property
        """
        raise NotImplementedError  # pragma: no cover

    @property
    @abstractmethod
    def L_available(self) -> List[int]:
        """Allowable L settings for device.

        Must be a list ints

        Raises:
            NotImplementedError: If child classes do not implement method/property
        """
        raise NotImplementedError  # pragma: no cover

    @property
    @abstractmethod
    def M_available(self) -> List[int]:
        """Allowable M settings for device.

        Must be a list ints

        Raises:
            NotImplementedError: If child classes do not implement method/property
        """
        raise NotImplementedError  # pragma: no cover

    @property
    @abstractmethod
    def N_available(self) -> List[int]:
        """Allowable N settings for device.

        Must be a list ints

        Raises:
            NotImplementedError: If child classes do not implement method/property
        """
        raise NotImplementedError  # pragma: no cover

    @property
    @abstractmethod
    def Np_available(self) -> List[int]:
        """Allowable Np settings for device.

        Must be a list ints

        Raises:
            NotImplementedError: If child classes do not implement method/property
        """
        raise NotImplementedError  # pragma: no cover

    @property
    @abstractmethod
    def F_available(self) -> List[int]:
        """Allowable F settings for device.

        Must be a list ints

        Raises:
            NotImplementedError: If child classes do not implement method/property
        """
        raise NotImplementedError  # pragma: no cover

    """ bits
        Usually:
            32 for JESD204B
            64 for JESD204C
    """
    _data_path_width = 32

    @property
    def data_path_width(self) -> Union[int, float]:
        """Get JESD data path width in bits.

        Current options are: 32 (204B) and 64 (204C)

        Returns:
            int: Numerator of link encoding.
        """
        return self._data_path_width

    @data_path_width.setter
    def data_path_width(self, value: int) -> None:
        """Set JESD data path width in bits.

        Current options are: 32 (204B) and 64 (204C)

        Args:
            value (int): Data path width in bits

        Raises:
            Exception: If DMA width is not an integer
        """
        if int(value) != value:
            raise Exception("data_path_width must be an integer")
        self._data_path_width = value

    """ HD: High-density mode (Single sample split over multiple lanes)"""
    # HD_min = 0
    # HD_max = 1
    _HD = 0
    HD_available = [0, 1]

    @property
    def HD(self) -> Union[int, float]:
        """Get High density mode.

        Returns:
            int: High density mode
        """
        return self._HD

    @HD.setter
    def HD(self, value: int) -> None:
        """Set High density mode.

        Args:
            value (int): High density mode

        Raises:
            Exception: HD not an integer or not in range
        """
        if int(value) != value:
            raise Exception("HD must be an integer")
        if value not in self.HD_available:
            raise Exception("HD not in range for device")
        self._HD = value

    """ K: Frames per multiframe
        17/F <= K <= 32
    """
    # K_min = 4
    # K_max = 32
    # K_available = [4, 8, 12, 16, 20, 24, 28, 32]
    _K = 4

    @property
    def K(self) -> Union[int, float]:
        """Get Frames per multiframe.

        17/F <= K <= 32, is generally a multiple of 2

        Returns:
            int: Number of frames per multiframe
        """
        return self._K

    @K.setter
    def K(self, value: int) -> None:
        """Set Frames per multiframe.

        Args:
            value (int): Frames per multiframe

        Raises:
            Exception: K not an integer or not in range
        """
        if int(value) != value:
            raise Exception("K must be an integer")
        if value not in self.K_available:
            raise Exception("K not in range for device")
        self._K = value

    @property
    def D(self) -> Union[int, float]:
        """FIXME."""
        return self._data_path_width * self.encoding_d / self.encoding_n

    """ S: Samples per converter per frame"""
    _S = 1

    @property
    def S(self) -> Union[int, float]:
        """Get Samples per converter per frame.

        S == F/(M*Np) * encoding_p * L

        Returns:
            int: Samples per converter per frame
        """
        return self._S

    @S.setter
    def S(self, value: int) -> None:
        """Set samples per converter per frame.

        Args:
            value (int): Samples per converter per frame

        Raises:
            Exception: S not an integer or not in range
        """
        if int(value) != value:
            raise Exception("S must be an integer")
        if value not in self.L_available:
            raise Exception("S not in range for device")
        self._S = value

    """ L: Lanes per link """
    # L_min = 1
    # L_max = 8
    # L_available = [1, 2, 4, 8]
    _L = 1

    @property
    def L(self) -> Union[int, float]:
        """Get lanes per link.

        Generally a multiple of 2

        Returns:
            int: Number of frames per multiframe
        """
        return self._L

    @L.setter
    def L(self, value: int) -> None:
        """Set lanes per link.

        Args:
            value (int): Lanes per link

        Raises:
            Exception: L not an integer or not in range
        """
        if int(value) != value:
            raise Exception("L must be an integer")
        if value not in self.L_available:
            raise Exception("L not in range for device")
        self._L = value

    """ M: Number of virtual converters """
    # M_min = 1
    # M_max = 8
    # M_available = [1, 2, 4, 8, 16, 32]
    _M = 1

    @property
    def M(self) -> Union[int, float]:
        """Get number of virtual converters.

        Generally a power of 2

        Returns:
            int: Number of frames per multiframe
        """
        return self._M

    @M.setter
    def M(self, value: int) -> None:
        """Set number of virtual converters.

        Args:
            value (int): Number of virtual converters

        Raises:
            Exception: M not an integer or not in range
        """
        if int(value) != value:
            raise Exception("M must be an integer")
        if value not in self.M_available:
            raise Exception("M not in range for device")
        self._M = value

    """ N: Number of non-dummy bits per sample """
    # N_min = 12
    # N_max = 16
    # N_available = [12, 14, 16]
    _N = 12

    @property
    def N(self) -> Union[int, float]:
        """Get number of non-dummy bits per sample.

        Generally a multiple of 2

        Returns:
            int: Number of non-dummy bits per sample
        """
        return self._N

    @N.setter
    def N(self, value: int) -> None:
        """Set number of non-dummy bits per sample.

        Args:
            value (int): Number of non-dummy bits per sample

        Raises:
            Exception: N not an integer or not in range
        """
        if int(value) != value:
            raise Exception("N must be an integer")
        if value not in self.N_available:
            raise Exception("N not in range for device")
        self._N = value

    """ Np: Number of bits per sample """
    # Np_min = 12
    # Np_max = 16
    # Np_available = [12, 14, 16]
    _Np = 16

    @property
    def Np(self) -> Union[int, float]:
        """Get number of bits per sample.

        Generally a multiple of 2

        Returns:
            int: Number of bits per sample
        """
        return self._Np

    @Np.setter
    def Np(self, value: int) -> None:
        """Set number of bits per sample.

        Args:
            value (int): Number of bits per sample

        Raises:
            Exception: Np not an integer or not in range
        """
        if int(value) != value:
            raise Exception("Np must be an integer")
        if value not in self.Np_available:
            raise Exception("Np not in range for device")
        self._Np = value

    # DERIVED SCALERS
    """ F: Octets per frame per link
        This is read-only since it depends on L,M,Np,S, and encoding
    """
    # F_min = 1
    # F_max = 16
    # F_available = [1, 2, 4, 8, 16]
    _F = 1

    @property
    def F(self) -> Union[int, float]:
        """Get octets per frame per link.

        Generally a power of 2

        Returns:
            int: Number of octets per frame per link
        """
        return self._F

    @F.setter
    def F(self, value: int) -> None:
        """Set octets per frame per link.

        Args:
            value (int): Number of octets per frame per link

        Raises:
            Exception: F not an integer or not in range
        """
        if int(value) != value:
            raise Exception("F must be an integer")
        if value not in self.F_available:
            raise Exception("F not in range for device")
        self._F = value

    # CLOCKS
    """ sample_clock: Data rate after decimation stages in Samples/second """

    _sample_clock = 122.88e6

    @property
    def sample_clock(self) -> Union[int, float]:
        """Data rate after decimation stages in Samples/second.

        Returns:
            int: Data rate in samples per second
        """
        return self._sample_clock

    @sample_clock.setter
    def sample_clock(self, value: int) -> None:
        """Data rate after decimation stages in Samples/second.

        Args:
            value (int): Number of octets per frame per link
        """
        self._sample_clock = value

    @property
    def frame_clock(self) -> Union[int, float]:
        """frame_clock in frames per second.

        frame_clock == sample_clock / S

        Returns:
            int: Data rate in samples per second
        """
        return self.sample_clock / self.S

    @property
    def multiframe_clock(self) -> Union[int, float]:
        """multiframe_clock: aka LMFC in frames per multiframe.

        multiframe_clock == frame_clock / K

        Returns:
            int: Frames per multiframe
        """
        return self.frame_clock / self.K

    @property
    def bit_clock(self) -> Union[int, float]:
        """bit_clock: aka line rate aka lane rate.

        bit_clock == (M * S * Np * encoding_d/encoding_n * frame_clock) / L

        Returns:
            int: Bits per second aka lane rate
        """
        return (
            (self.M / self.L)
            * self.Np
            * (self.encoding_d / self.encoding_n)
            * self.sample_clock
        )

    @bit_clock.setter
    def bit_clock(self, value: int) -> None:
        """bit_clock: aka line rate aka lane rate.

        bit_clock == (M * S * Np * encoding_d/encoding_n * frame_clock) / L

        Args:
            value (int): Bits per second aka lane rate
        """
        # This actually sets sample_clock
        # frame_clock = bit_clock*L*encoding_n/encoding_d / (M*S*Np)
        # sample_clock = bit_clock*L*encoding_n/encoding_d / (M*Np)
        value_cal = (
            value
            * self.L
            * self.encoding_n
            / self.encoding_d
            / (self.M * self.Np)
        )
        self._sample_clock = value_cal

    @property
    def device_clock(self) -> Union[int, float]:
        """device_clock is the lane rate over D.

        device_clock == bit_clock / D

        Returns:
            int: bits per second per device
        """
        return self.bit_clock / self.D

CF: Union[int, float] property writable

Get Control words per frame clock period per link.

Returns:

Name	Type	Description
int	Union[int, float]	Control words per frame clock period per link

CS: Union[int, float] property writable

Get Control bits per conversion sample.

Returns:

Name	Type	Description
int	Union[int, float]	Control bits per conversion sample

D: Union[int, float] property

FIXME.

F: Union[int, float] property writable

Get octets per frame per link.

Generally a power of 2

Returns:

Name	Type	Description
int	Union[int, float]	Number of octets per frame per link

F_available: List[int] abstractmethod property

Allowable F settings for device.

Must be a list ints

Raises:

Type	Description
NotImplementedError	If child classes do not implement method/property

HD: Union[int, float] property writable

Get High density mode.

Returns:

Name	Type	Description
int	Union[int, float]	High density mode

K: Union[int, float] property writable

Get Frames per multiframe.

17/F <= K <= 32, is generally a multiple of 2

Returns:

Name	Type	Description
int	Union[int, float]	Number of frames per multiframe

K_available: List[int] abstractmethod property

Allowable K settings for device.

Must be a list ints

Raises:

Type	Description
NotImplementedError	If child classes do not implement method/property

L: Union[int, float] property writable

Get lanes per link.

Generally a multiple of 2

Returns:

Name	Type	Description
int	Union[int, float]	Number of frames per multiframe

L_available: List[int] abstractmethod property

Allowable L settings for device.

Must be a list ints

Raises:

Type	Description
NotImplementedError	If child classes do not implement method/property

M: Union[int, float] property writable

Get number of virtual converters.

Generally a power of 2

Returns:

Name	Type	Description
int	Union[int, float]	Number of frames per multiframe

M_available: List[int] abstractmethod property

Allowable M settings for device.

Must be a list ints

Raises:

Type	Description
NotImplementedError	If child classes do not implement method/property

N: Union[int, float] property writable

Get number of non-dummy bits per sample.

Generally a multiple of 2

Returns:

Name	Type	Description
int	Union[int, float]	Number of non-dummy bits per sample

N_available: List[int] abstractmethod property

Allowable N settings for device.

Must be a list ints

Raises:

Type	Description
NotImplementedError	If child classes do not implement method/property

Np: Union[int, float] property writable

Get number of bits per sample.

Generally a multiple of 2

Returns:

Name	Type	Description
int	Union[int, float]	Number of bits per sample

Np_available: List[int] abstractmethod property

Allowable Np settings for device.

Must be a list ints

Raises:

Type	Description
NotImplementedError	If child classes do not implement method/property

S: Union[int, float] property writable

Get Samples per converter per frame.

S == F/(M*Np) * encoding_p * L

Returns:

Name	Type	Description
int	Union[int, float]	Samples per converter per frame

available_jesd_modes: List[str] abstractmethod property

Available JESD modes supported by device.

Must be a list of strings

Raises:

Type	Description
NotImplementedError	If child classes do not implement method/property

bit_clock: Union[int, float] property writable

bit_clock: aka line rate aka lane rate.

bit_clock == (M * S * Np * encoding_d/encoding_n * frame_clock) / L

Returns:

Name	Type	Description
int	Union[int, float]	Bits per second aka lane rate

bit_clock_max: Union[int, float] property

Get bit clock (lane rate) maximum based on JESD mode.

Returns:

Name	Type	Description
int	Union[int, float]	bit clock in bits per second

bit_clock_min: Union[int, float] property

Get bit clock (lane rate) minimum based on JESD mode.

Returns:

Name	Type	Description
int	Union[int, float]	bit clock in bits per second

data_path_width: Union[int, float] property writable

Get JESD data path width in bits.

Current options are: 32 (204B) and 64 (204C)

Returns:

Name	Type	Description
int	Union[int, float]	Numerator of link encoding.

device_clock: Union[int, float] property

device_clock is the lane rate over D.

device_clock == bit_clock / D

Returns:

Name	Type	Description
int	Union[int, float]	bits per second per device

encoding: str property writable

Get JESD FEC encoding.

Current options are: "8b10b", "64b66b"

Returns:

Name	Type	Description
str	str	String of supported encodings.

encoding_d: Union[int, float] property

Get JESD FEC encoding denominator.

Current options are: 10 or 66

Returns:

Name	Type	Description
int	Union[int, float]	Denominator of link encoding.

encoding_n: Union[int, float] property

Get JESD FEC encoding numerator.

Current options are: 8 or 64

Returns:

Name	Type	Description
int	Union[int, float]	Numerator of link encoding.

frame_clock: Union[int, float] property

frame_clock in frames per second.

frame_clock == sample_clock / S

Returns:

Name	Type	Description
int	Union[int, float]	Data rate in samples per second

jesd_class: Union[str, List[str]] property writable

Get JESD selected mode. Wil be either jesd204b or jesd204c.

multiframe_clock: Union[int, float] property

multiframe_clock: aka LMFC in frames per multiframe.

multiframe_clock == frame_clock / K

Returns:

Name	Type	Description
int	Union[int, float]	Frames per multiframe

sample_clock: Union[int, float] property writable

Data rate after decimation stages in Samples/second.

Returns:

Name	Type	Description
int	Union[int, float]	Data rate in samples per second

__init__(sample_clock, M, L, Np, K)

Initialize JESD device through link parameterization.

Parameters:

Name	Type	Description	Default
sample_clock	int	Human readable string describing the exception.	required
M	int	Number of virtual converters	required
L	int	Number of lanes	required
Np	int	Number of bits per sample	required
K	int	Frames per multiframe	required

Source code in adijif/jesd.py

def __init__(
    self, sample_clock: int, M: int, L: int, Np: int, K: int
) -> None:
    """Initialize JESD device through link parameterization.

    Args:
        sample_clock (int): Human readable string describing the exception.
        M (int): Number of virtual converters
        L (int): Number of lanes
        Np (int): Number of bits per sample
        K (int): Frames per multiframe

    """
    self.sample_clock = sample_clock
    self.K = K
    self.L = L
    self.M = M
    self.Np = Np

get_jesd_config(solution=None)

Extract configurations from solver results.

Collect JESD related parameters, includes modes and clocks.

Parameters:

Name	Type	Description	Default
solution	CpoSolveResult	CPlex solution. Only needed for CPlex solver	None

Returns:

Name	Type	Description
Dict	Dict	Dictionary of JESD parameters

Source code in adijif/jesd.py

def get_jesd_config(self, solution: CpoSolveResult = None) -> Dict:
    """Extract configurations from solver results.

    Collect JESD related parameters, includes modes and clocks.

    Args:
        solution (CpoSolveResult): CPlex solution. Only needed for CPlex solver

    Returns:
        Dict: Dictionary of JESD parameters
    """
    if solution:  # type: ignore
        self.solution = solution
    cfg = {p: getattr(self, p) for p in self._parameters_to_return}
    cfg["jesd_mode"] = self._check_valid_jesd_mode()
    return cfg

validate_clocks()

Validate all clocks clock settings are within range.

Source code in adijif/jesd.py

def validate_clocks(self) -> None:
    """Validate all clocks clock settings are within range."""
    if self._skip_clock_validation:
        for name in ["bit", "sample"]:
            clk = getattr(self, name + "_clock")
            lim = getattr(self, name + "_clock_max")
            assert clk <= lim, (
                name + f" clock too fast for device {clk} (limit: {lim})"
            )
            lim = getattr(self, name + "_clock_min")
            assert clk >= lim, (
                name + f" clock too slow for device {clk} (limit: {lim})"
            )