drivers/spi/spi-davinci.c
Source file repositories/reference/linux-study-clean/drivers/spi/spi-davinci.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/spi/spi-davinci.c- Extension
.c- Size
- 29357 bytes
- Lines
- 1107
- 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.
- 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.
- Touches IRQ or DMA behavior; this matters for the representative real-device path.
- Allocates kernel memory; connect allocation flags and lifetime to context constraints.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/interrupt.hlinux/io.hlinux/gpio/consumer.hlinux/module.hlinux/delay.hlinux/platform_data/edma.hlinux/platform_device.hlinux/err.hlinux/clk.hlinux/dmaengine.hlinux/dma-mapping.hlinux/of.hlinux/spi/spi.hlinux/spi/spi_bitbang.hlinux/slab.h
Detected Declarations
struct davinci_spi_platform_datastruct davinci_spi_configstruct davinci_spistruct davinci_spi_of_datafunction davinci_spi_rx_buf_u8function davinci_spi_rx_buf_u16function davinci_spi_tx_buf_u8function davinci_spi_tx_buf_u16function set_io_bitsfunction clear_io_bitsfunction davinci_spi_chipselectfunction davinci_spi_get_prescalefunction methodfunction davinci_spi_of_setupfunction davinci_spi_setupfunction davinci_spi_cleanupfunction davinci_spi_can_dmafunction davinci_spi_check_errorfunction davinci_spi_process_eventsfunction davinci_spi_dma_rx_callbackfunction davinci_spi_dma_tx_callbackfunction davinci_spi_bufsfunction request_threaded_irqfunction davinci_spi_irqfunction davinci_spi_request_dmafunction spi_davinci_get_pdatafunction spi_davinci_get_pdatafunction davinci_spi_probefunction davinci_spi_remove
Annotated Snippet
struct davinci_spi_platform_data {
u8 version;
u8 num_chipselect;
u8 intr_line;
u8 prescaler_limit;
bool cshold_bug;
enum dma_event_q dma_event_q;
};
/**
* struct davinci_spi_config - Per-chip-select configuration for SPI slave devices
*
* @wdelay: amount of delay between transmissions. Measured in number of
* SPI module clocks.
* @odd_parity: polarity of parity flag at the end of transmit data stream.
* 0 - odd parity, 1 - even parity.
* @parity_enable: enable transmission of parity at end of each transmit
* data stream.
* @io_type: type of IO transfer. Choose between polled, interrupt and DMA.
* @timer_disable: disable chip-select timers (setup and hold)
* @c2tdelay: chip-select setup time. Measured in number of SPI module clocks.
* @t2cdelay: chip-select hold time. Measured in number of SPI module clocks.
* @t2edelay: transmit data finished to SPI ENAn pin inactive time. Measured
* in number of SPI clocks.
* @c2edelay: chip-select active to SPI ENAn signal active time. Measured in
* number of SPI clocks.
*/
struct davinci_spi_config {
u8 wdelay;
u8 odd_parity;
u8 parity_enable;
u8 io_type;
u8 timer_disable;
u8 c2tdelay;
u8 t2cdelay;
u8 t2edelay;
u8 c2edelay;
};
/* SPI Controller driver's private data. */
struct davinci_spi {
struct spi_bitbang bitbang;
struct clk *clk;
u8 version;
resource_size_t pbase;
void __iomem *base;
u32 irq;
struct completion done;
const void *tx;
void *rx;
int rcount;
int wcount;
struct dma_chan *dma_rx;
struct dma_chan *dma_tx;
struct davinci_spi_platform_data pdata;
void (*get_rx)(u32 rx_data, struct davinci_spi *);
u32 (*get_tx)(struct davinci_spi *);
u8 *bytes_per_word;
u8 prescaler_limit;
};
static struct davinci_spi_config davinci_spi_default_cfg;
static void davinci_spi_rx_buf_u8(u32 data, struct davinci_spi *dspi)
{
if (dspi->rx) {
u8 *rx = dspi->rx;
*rx++ = (u8)data;
dspi->rx = rx;
}
}
static void davinci_spi_rx_buf_u16(u32 data, struct davinci_spi *dspi)
{
if (dspi->rx) {
u16 *rx = dspi->rx;
*rx++ = (u16)data;
dspi->rx = rx;
}
}
static u32 davinci_spi_tx_buf_u8(struct davinci_spi *dspi)
{
Annotation
- Immediate include surface: `linux/interrupt.h`, `linux/io.h`, `linux/gpio/consumer.h`, `linux/module.h`, `linux/delay.h`, `linux/platform_data/edma.h`, `linux/platform_device.h`, `linux/err.h`.
- Detected declarations: `struct davinci_spi_platform_data`, `struct davinci_spi_config`, `struct davinci_spi`, `struct davinci_spi_of_data`, `function davinci_spi_rx_buf_u8`, `function davinci_spi_rx_buf_u16`, `function davinci_spi_tx_buf_u8`, `function davinci_spi_tx_buf_u16`, `function set_io_bits`, `function clear_io_bits`.
- Atlas domain: Driver Families / drivers/spi.
- Implementation status: source implementation candidate.
- IRQ or DMA behavior appears here, which is relevant to the selected PCIe/NVMe device path.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.