spi_alloc_master(9) [centos man page]

SPI_ALLOC_MASTER(9)					  Serial Peripheral Interface (S				       SPI_ALLOC_MASTER(9)

NAME

       spi_alloc_master - allocate SPI master controller

SYNOPSIS

       struct spi_master * spi_alloc_master(struct device * dev, unsigned size);

ARGUMENTS

       dev
	   the controller, possibly using the platform_bus

       size
	   how much zeroed driver-private data to allocate; the pointer to this memory is in the driver_data field of the returned device,
	   accessible with spi_master_get_devdata.

CONTEXT

       can sleep

DESCRIPTION

       This call is used only by SPI master controller drivers, which are the only ones directly touching chip registers. It's how they allocate
       an spi_master structure, prior to calling spi_register_master.

       This must be called from context that can sleep. It returns the SPI master structure on success, else NULL.

       The caller is responsible for assigning the bus number and initializing the master's methods before calling spi_register_master; and (after
       errors adding the device) calling spi_master_put and kfree to prevent a memory leak.

COPYRIGHT

Kernel Hackers Manual 3.10					     June 2014						       SPI_ALLOC_MASTER(9)

STRUCT 
SPI_BOARD_INF(9) 				  Serial Peripheral Interface (S				   STRUCT SPI_BOARD_INF(9)

NAME

       struct_spi_board_info - board-specific template for a SPI device

SYNOPSIS

       struct spi_board_info {
	 char modalias[SPI_NAME_SIZE];
	 const void * platform_data;
	 void * controller_data;
	 int irq;
	 u32 max_speed_hz;
	 u16 bus_num;
	 u16 chip_select;
	 u8 mode;
       };

MEMBERS

       modalias[SPI_NAME_SIZE]
	   Initializes spi_device.modalias; identifies the driver.

       platform_data
	   Initializes spi_device.platform_data; the particular data stored there is driver-specific.

       controller_data
	   Initializes spi_device.controller_data; some controllers need hints about hardware setup, e.g. for DMA.

       irq
	   Initializes spi_device.irq; depends on how the board is wired.

       max_speed_hz
	   Initializes spi_device.max_speed_hz; based on limits from the chip datasheet and board-specific signal quality issues.

       bus_num
	   Identifies which spi_master parents the spi_device; unused by spi_new_device, and otherwise depends on board wiring.

       chip_select
	   Initializes spi_device.chip_select; depends on how the board is wired.

       mode
	   Initializes spi_device.mode; based on the chip datasheet, board wiring (some devices support both 3WIRE and standard modes), and
	   possibly presence of an inverter in the chipselect path.

DESCRIPTION

       When adding new SPI devices to the device tree, these structures serve as a partial device template. They hold information which can't
       always be determined by drivers. Information that probe can establish (such as the default transfer wordsize) is not included here.

       These structures are used in two places. Their primary role is to be stored in tables of board-specific device descriptors, which are
       declared early in board initialization and then used (much later) to populate a controller's device tree after the that controller's driver
       initializes. A secondary (and atypical) role is as a parameter to spi_new_device call, which happens after those controller drivers are
       active in some dynamic board configuration models.

COPYRIGHT

Kernel Hackers Manual 3.10					     June 2014						   STRUCT SPI_BOARD_INF(9)