drivers/spi/internals.h

Source file repositories/reference/linux-study-clean/drivers/spi/internals.h

File Facts

System
Linux kernel
Corpus path
drivers/spi/internals.h
Extension
.h
Size
1500 bytes
Lines
52
Domain
Driver Families
Bucket
drivers/spi
Inferred role
Driver Families: implementation source
Status
source implementation candidate

Why This File Exists

Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.

Dependency Surface

Detected Declarations

Annotated Snippet

#ifndef __LINUX_SPI_INTERNALS_H
#define __LINUX_SPI_INTERNALS_H

#include <linux/device.h>
#include <linux/dma-direction.h>
#include <linux/scatterlist.h>
#include <linux/spi/spi.h>

void spi_flush_queue(struct spi_controller *ctrl);

#ifdef CONFIG_HAS_DMA
int spi_map_buf(struct spi_controller *ctlr, struct device *dev,
		struct sg_table *sgt, void *buf, size_t len,
		enum dma_data_direction dir);
void spi_unmap_buf(struct spi_controller *ctlr, struct device *dev,
		   struct sg_table *sgt, enum dma_data_direction dir);
#else /* !CONFIG_HAS_DMA */
static inline int spi_map_buf(struct spi_controller *ctlr, struct device *dev,
			      struct sg_table *sgt, void *buf, size_t len,
			      enum dma_data_direction dir)
{
	return -EINVAL;
}

static inline void spi_unmap_buf(struct spi_controller *ctlr,
				 struct device *dev, struct sg_table *sgt,
				 enum dma_data_direction dir)
{
}
#endif /* CONFIG_HAS_DMA */

static inline bool spi_xfer_is_dma_mapped(struct spi_controller *ctlr,
					  struct spi_device *spi,
					  struct spi_transfer *xfer)
{
	return ctlr->can_dma && ctlr->can_dma(ctlr, spi, xfer) &&
	       (xfer->tx_sg_mapped || xfer->rx_sg_mapped);
}

#endif /* __LINUX_SPI_INTERNALS_H */

Annotation

Implementation Notes