File ns_spi.h

FileList > includes-api > ns_spi.h

Generic SPI driver. More...

#include "am_bsp.h"
#include "am_mcu_apollo.h"
#include "am_util.h"

Classes

Type	Name
struct	ns_spi_cfg

Public Types

Type	Name
typedef void(*	ns_spi_cb
typedef struct ns_spi_cfg	ns_spi_config_t
enum	ns_spi_status_e

Public Functions

Type	Name
void	ns_spi_handle_iom_isr (void)
uint32_t	ns_spi_interface_init (ns_spi_config_t * cfg, uint32_t speed, am_hal_iom_spi_mode_e mode) Initialize the SPI interface.
uint32_t	ns_spi_read (ns_spi_config_t * cfg, const void * buf, uint32_t bufLen, uint64_t reg, uint32_t regLen, uint32_t csPin) Read from a SPI device. The SPI device is selected by the csPin parameter.
uint32_t	ns_spi_read_dma (ns_spi_config_t * cfg, const void * buf, uint32_t bufLen, uint64_t reg, uint32_t regLen, uint32_t csPin) Issure DMA read, the cfg->callback will be called when the transfer is complete.
uint32_t	ns_spi_transfer (ns_spi_config_t * cfg, const void * txBuf, const void * rxBuf, uint32_t size, uint32_t csPin) Transfer data to/from a SPI device. The SPI device is selected by the csPin parameter.
uint32_t	ns_spi_write (ns_spi_config_t * cfg, const void * buf, uint32_t bufLen, uint64_t reg, uint32_t regLen, uint32_t csPin) Write to a SPI device. The SPI device is selected by the csPin parameter.

Detailed Description

Author:

Adam Page

Version:

0.1

Date:

2022-08-26

Copyright:

Public Types Documentation

typedef ns_spi_cb

typedef void(* ns_spi_cb) (struct ns_spi_cfg *);

typedef ns_spi_config_t

typedef struct ns_spi_cfg ns_spi_config_t;

enum ns_spi_status_e

enum ns_spi_status_e {
    NS_SPI_STATUS_SUCCESS = 0,
    NS_SPI_STATUS_ERROR = 1
};

Public Functions Documentation

function ns_spi_handle_iom_isr

void ns_spi_handle_iom_isr (
    void
)

IOM ISRs Take over correct IOM ISR.

function ns_spi_interface_init

Initialize the SPI interface.

uint32_t ns_spi_interface_init (
    ns_spi_config_t * cfg,
    uint32_t speed,
    am_hal_iom_spi_mode_e mode
)

Parameters:

cfg SPI Configuration
speed Bus speed in Hz
mode SPI mode (CPOL, CPHA)

Returns:

uint32_t

function ns_spi_read

Read from a SPI device. The SPI device is selected by the csPin parameter.

uint32_t ns_spi_read (
    ns_spi_config_t * cfg,
    const void * buf,
    uint32_t bufLen,
    uint64_t reg,
    uint32_t regLen,
    uint32_t csPin
)

Parameters:

cfg SPI Configuration
buf Buffer to read into
bufLen Buffer length
reg Register to read from
regLen Register length
csPin CS pin number

Returns:

uint32_t

function ns_spi_read_dma

Issure DMA read, the cfg->callback will be called when the transfer is complete.

uint32_t ns_spi_read_dma (
    ns_spi_config_t * cfg,
    const void * buf,
    uint32_t bufLen,
    uint64_t reg,
    uint32_t regLen,
    uint32_t csPin
)

Parameters:

cfg
buf
bufLen
reg
regLen
csPin

Returns:

uint32_t

function ns_spi_transfer

Transfer data to/from a SPI device. The SPI device is selected by the csPin parameter.

uint32_t ns_spi_transfer (
    ns_spi_config_t * cfg,
    const void * txBuf,
    const void * rxBuf,
    uint32_t size,
    uint32_t csPin
)

Parameters:

cfg SPI Configuration
txBuf Transmit buffer
rxBuf Receive buffer
size Size of the transfer
csPin CS pin number

Returns:

uint32_t

function ns_spi_write

Write to a SPI device. The SPI device is selected by the csPin parameter.

uint32_t ns_spi_write (
    ns_spi_config_t * cfg,
    const void * buf,
    uint32_t bufLen,
    uint64_t reg,
    uint32_t regLen,
    uint32_t csPin
)

Parameters:

cfg SPI Configuration
buf Buffer to write from
bufLen Buffer length
reg Register to write to
regLen Register length
csPin CS pin number

Returns:

uint32_t

The documentation for this class was generated from the following file neuralSPOT/neuralspot/ns-spi/includes-api/ns_spi.h