nRF5 SPI

SPI bus driver for the nRF5 SPIM peripheral. More...

Data Structures
struct	pbl_spi_nrf5
	nRF5 SPI bus. More...

Macros
#define	PBL_SPI_NRF5_DEFINE(sym, _name, _idx, _sck, _mosi, _miso, _deps, ...)
	Define a bus on an nRF5 SPIM instance.

Functions
void	pbl_spi_nrf5_irq_handler (const struct pbl_spi_nrf5 *spi)
	SPIM interrupt handler, to connect with PBL_IRQ_CONNECT().

Detailed Description

SPI bus driver for the nRF5 SPIM peripheral.

Transfers run through EasyDMA, so their buffers must be in data RAM, and are at most 65535 bytes. The clock runs at 125 kHz to 8 MHz, or up to 32 MHz on SPIM3.

SCK and MOSI are outputs and MISO an input with its wiring flags, e.g. a pull, and keep that configuration while the bus is disabled; MOSI and MISO may be left unconnected. The SPIM interrupt is connected by the board:

PBL_SPI_NRF5_DEFINE(s_spi3, "spi3", 3, PBL_GPIO(NRF5_GPIO_P0, 6, 0),
                    PBL_GPIO(NRF5_GPIO_P0, 8, 0), PBL_GPIO(NULL, 0, 0), NULL,
                    PBL_GPIO(NRF5_GPIO_P1, 3, PBL_GPIO_ACTIVE_LOW));
PBL_IRQ_CONNECT(SPIM3, 7, pbl_spi_nrf5_irq_handler, &s_spi3, 0);

---

Data Structure Documentation

pbl_spi_nrf5

struct pbl_spi_nrf5

nRF5 SPI bus.

Data Fields
struct pbl_spi_bus	bus	SPI bus.
uint8_t	index	SPIM instance index.
struct pbl_gpio	miso	MISO pin, or unconnected.
struct pbl_gpio	mosi	MOSI pin, or unconnected.
struct pbl_gpio	sck	SCK pin.

Macro Definition Documentation

PBL_SPI_NRF5_DEFINE

#define PBL_SPI_NRF5_DEFINE	(		sym,
			_name,
			_idx,
			_sck,
			_mosi,
			_miso,
			_deps,
			...
	)

Value:

  PBL_SPI_BUS_STATE_DEFINE(sym, __VA_ARGS__);                                 \
  const struct pbl_spi_nrf5 sym = {                                           \
    .bus = PBL_SPI_BUS_INIT(sym, _name, &pbl_spi_nrf5_ops, _deps),            \
    .index = (_idx),                                                          \
    .sck = _sck,                                                              \
    .mosi = _mosi,                                                            \
    .miso = _miso,                                                            \
  };                                                                          \
  PBL_DEVICE_REGISTER(sym, &sym.bus.dev)

Define a bus on an nRF5 SPIM instance.

Parameters

sym	Symbol of the bus.
_name	Name.
_idx	SPIM instance index.
_sck	SCK pin, from PBL_GPIO().
_mosi	MOSI pin, from PBL_GPIO().
_miso	MISO pin, from PBL_GPIO().
_deps	Dependencies from PBL_DEVICE_DEPS(), or NULL.
...	Chip select GPIOs, from PBL_GPIO().

Function Documentation

pbl_spi_nrf5_irq_handler()

void pbl_spi_nrf5_irq_handler

(

const struct pbl_spi_nrf5 *

spi

)

SPIM interrupt handler, to connect with PBL_IRQ_CONNECT().

Parameters

spi

Bus.