typehints/pyboard/pyb.pyi [3460:3485]:
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
        mode: int = CONTROLLER,
        baudrate: int = 328125,
        *,
        polarity: int = 1,
        phase: int = 0,
        bits: int = 8,
        firstbit: int = MSB,
        ti: bool = False,
        crc: int | None = None,
    ):
        """
      Construct an SPI object on the given bus.  ``bus`` can be 1 or 2, or
      'X' or 'Y'. With no additional parameters, the SPI object is created but
      not initialised (it has the settings from the last initialisation of
      the bus, if any).  If extra arguments are given, the bus is initialised.
      See ``init`` for parameters of initialisation.
      
      The physical pins of the SPI buses are:
      
        - ``SPI(1)`` is on the X position: ``(NSS, SCK, MISO, MOSI) = (X5, X6, X7, X8) = (PA4, PA5, PA6, PA7)``
        - ``SPI(2)`` is on the Y position: ``(NSS, SCK, MISO, MOSI) = (Y5, Y6, Y7, Y8) = (PB12, PB13, PB14, PB15)``
      
      At the moment, the NSS pin is not used by the SPI driver and is free
      for other use.
      """
    @overload
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -



typehints/pyboard/pyb.pyi [3522:3557]:
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
        mode: int = CONTROLLER,
        baudrate: int = 328125,
        *,
        polarity: int = 1,
        phase: int = 0,
        bits: int = 8,
        firstbit: int = MSB,
        ti: bool = False,
        crc: int | None = None,
    ):
        """
      Initialise the SPI bus with the given parameters:
      
        - ``mode`` must be either ``SPI.CONTROLLER`` or ``SPI.PERIPHERAL``.
        - ``baudrate`` is the SCK clock rate (only sensible for a controller).
        - ``prescaler`` is the prescaler to use to derive SCK from the APB bus frequency;
          use of ``prescaler`` overrides ``baudrate``.
        - ``polarity`` can be 0 or 1, and is the level the idle clock line sits at.
        - ``phase`` can be 0 or 1 to sample data on the first or second clock edge
          respectively.
        - ``bits`` can be 8 or 16, and is the number of bits in each transferred word.
        - ``firstbit`` can be ``SPI.MSB`` or ``SPI.LSB``.
        - ``ti`` True indicates Texas Instruments, as opposed to Motorola, signal conventions.
        - ``crc`` can be None for no CRC, or a polynomial specifier.
      
      Note that the SPI clock frequency will not always be the requested baudrate.
      The hardware only supports baudrates that are the APB bus frequency
      (see :meth:`pyb.freq`) divided by a prescaler, which can be 2, 4, 8, 16, 32,
      64, 128 or 256.  SPI(1) is on AHB2, and SPI(2) is on AHB1.  For precise
      control over the SPI clock frequency, specify ``prescaler`` instead of
      ``baudrate``.
      
      Printing the SPI object will show you the computed baudrate and the chosen
      prescaler.
      """
    @overload
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -