linux/spi/spi.h

62  *                 transfer bytes histogram
136  *	The spi_transfer.speed_hz can override this for each transfer.
143  *	each word in a transfer (by specifying SPI_LSB_FIRST).
149  *	The spi_transfer.bits_per_word can override this for each transfer.
166  *	words of a transfer
403  *	supported. If set, the SPI core will reject any transfer with an
406  * @min_speed_hz: Lowest supported transfer speed
407  * @max_speed_hz: Highest supported transfer speed
412  * @max_transfer_size: function that returns the max transfer size for
429  * @transfer: adds a message to the controller's transfer queue.
448  * @fallback: fallback to PIO if DMA transfer return failure with
461  * @max_dma_len: Maximum length of a DMA transfer for the device.
463  *	so the subsystem requests the driver to prepare the transfer hardware
465  * @transfer_one_message: the subsystem calls the driver to transfer a single
478  * @prepare_message: set up the controller to transfer a single message,
481  * @transfer_one: transfer a single spi_transfer.
483  *                  - return 0 if the transfer is finished,
484  *                  - return 1 if the transfer is still in progress. When
485  *                    the driver is finished with this transfer it must
487  *                    can issue the next transfer. If the transfer fails, the
501  * @target_abort: abort the ongoing transfer request on an SPI target controller
583 	/* Limits on transfer speed */
613 	 * On some hardware transfer / message size may be constrained
614 	 * the limit may depend on device transfer settings.
654 	 * + The transfer() method may not sleep; its main role is
671 	int			(*transfer)(struct spi_device *spi,  member
679 	 * exists and returns true then the transfer will be mapped
693 	 * controller transfer queueing mechanism. If these are used, the
694 	 * transfer() function above must NOT be specified by the driver.
735 			    struct spi_transfer *transfer);
815 /* Helper calls for driver to timestamp transfer */
952  * The spi_messages themselves consist of a series of read+write transfer
975  *      transfer. If 0 the default (from @spi_device) is used.
977  *      for this transfer. If 0 the default (from @spi_device) is used.
978  * @dummy_data: indicates transfer is dummy bytes transfer.
979  * @cs_off: performs the transfer with chipselect off.
980  * @cs_change: affects chipselect after this transfer completes
983  * @delay: delay to be introduced after this transfer before
985  *	the next transfer or completing this @spi_message.
989  *      transfer this transfer. Set to 0 if the SPI bus driver does
998  *	snapshot for this transfer begins. Upon completing the SPI transfer,
1000  *	on the available snapshotting resolution (DMA transfer,
1006  *	@ptp_sts_word_post to the length of the transfer. This is done
1008  *	that a transfer-level snapshot taken from within the driver may still
1012  *	hardware has some sort of assist for retrieving exact transfer timing,
1019  * @timestamped: true if the transfer has been timestamped
1040  * When the word size of the SPI transfer is not a power-of-two multiple
1046  * it stays selected until after the last transfer in a message.  Drivers
1049  * (i) If the transfer isn't the last one in the message, this flag is
1055  * (ii) When the transfer is the last one in the message, the chip may
1056  * stay selected until the next transfer.  On multi-device SPI busses
1065  * When SPI can transfer in 1x,2x or 4x. It can get this transfer information
1067  * two should both be set. User can set transfer mode with SPI_NBITS_SINGLE(1x)
1068  * SPI_NBITS_DUAL(2x) and SPI_NBITS_QUAD(4x) to support these three transfer.
1104 #define	SPI_NBITS_SINGLE	0x01 /* 1-bit transfer */
1105 #define	SPI_NBITS_DUAL		0x02 /* 2-bit transfer */
1106 #define	SPI_NBITS_QUAD		0x04 /* 4-bit transfer */
1107 #define	SPI_NBITS_OCTAL	0x08 /* 8-bit transfer */
1126  * @transfers: list of transfer segments in this transaction
1146  * a single programmed DMA transfer.  On all systems, these messages are
1171 	 * last transfer ... allowing things like "read 16 bit length L"
1312 	/* Transfer size limit must not be greater than message size limit */  in spi_max_transfer_size()
1339  * @xfer: Transfer descriptor
1341  * Compute a relevant timeout value for the given transfer. We derive the time
1345  * Returns: Transfer timeout value in milliseconds.
1355 /* SPI transfer replacement methods which make use of spi_res */
1370  * @replaced_after:     the transfer after which the @replaced_transfers
1391 /* SPI transfer transformation methods */
1403  * All these synchronous SPI transfer routines are utilities layered
1404  * over the core async transfer primitive.  Here, "synchronous" means
1405  * they will sleep uninterruptibly until the async transfer completes.
1414  * spi_sync_transfer - synchronous SPI data transfer
1420  * Does a synchronous SPI data transfer of the given spi_transfer array.
1600  * as the default transfer wordsize) is not included here.