4e8320d2ec
Might as well rename spi_enable_module to spi_enable_node for consistency as well so long as I'm being picky. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@31442 a1c6a512-1295-4272-9138-f99709370657
86 lines
2.9 KiB
C
86 lines
2.9 KiB
C
/***************************************************************************
|
|
* __________ __ ___.
|
|
* Open \______ \ ____ ____ | | _\_ |__ _______ ___
|
|
* Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
|
|
* Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
|
|
* Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
|
|
* \/ \/ \/ \/ \/
|
|
* $Id$
|
|
*
|
|
* Copyright (c) 2007 Will Robertson
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public License
|
|
* as published by the Free Software Foundation; either version 2
|
|
* of the License, or (at your option) any later version.
|
|
*
|
|
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
|
* KIND, either express or implied.
|
|
*
|
|
****************************************************************************/
|
|
#ifndef SPI_IMX31_H
|
|
#define SPI_IMX31_H
|
|
|
|
#define USE_CSPI1_MODULE (1 << 0)
|
|
#define USE_CSPI2_MODULE (1 << 1)
|
|
#define USE_CSPI3_MODULE (1 << 2)
|
|
|
|
/* SPI_MODULE_MASK is set in target's config */
|
|
enum spi_module_number
|
|
{
|
|
__CSPI_NUM_START = -1, /* The first will be 0 */
|
|
#if (SPI_MODULE_MASK & USE_CSPI1_MODULE)
|
|
CSPI1_NUM,
|
|
#endif
|
|
#if (SPI_MODULE_MASK & USE_CSPI2_MODULE)
|
|
CSPI2_NUM,
|
|
#endif
|
|
#if (SPI_MODULE_MASK & USE_CSPI3_MODULE)
|
|
CSPI3_NUM,
|
|
#endif
|
|
SPI_NUM_CSPI,
|
|
};
|
|
|
|
struct spi_node
|
|
{
|
|
enum spi_module_number num; /* Module number (CSPIx_NUM) */
|
|
unsigned long conreg; /* CSPI conreg setup */
|
|
unsigned long periodreg; /* CSPI periodreg setup */
|
|
};
|
|
|
|
struct spi_transfer_desc;
|
|
|
|
typedef void (*spi_transfer_cb_fn_type)(struct spi_transfer_desc *);
|
|
|
|
struct spi_transfer_desc
|
|
{
|
|
const struct spi_node *node; /* node for this transfer */
|
|
const void *txbuf; /* buffer to transmit */
|
|
void *rxbuf; /* buffer to receive */
|
|
int count; /* number of elements */
|
|
spi_transfer_cb_fn_type callback; /* function to call when done */
|
|
struct spi_transfer_desc *next; /* next transfer queued,
|
|
spi layer sets this */
|
|
};
|
|
|
|
/* NOTE: SPI updates the descrptor during the operation. Do not write
|
|
* to it until completion notification is received. If no callback is
|
|
* specified, the caller must find a way to ensure integrity.
|
|
*
|
|
* -1 will be written to 'count' if an error occurs, otherwise it will
|
|
* be zero when completed.
|
|
*/
|
|
|
|
/* One-time init of SPI driver */
|
|
void spi_init(void);
|
|
|
|
/* Enable or disable the node - modules will be switch on/off accordingly. */
|
|
void spi_enable_node(const struct spi_node *node, bool enable);
|
|
|
|
/* Send and/or receive data on the specified node (asychronous) */
|
|
bool spi_transfer(struct spi_transfer_desc *xfer);
|
|
|
|
/* Returns 'true' if the descriptor is not busy */
|
|
bool spi_transfer_complete(const struct spi_transfer_desc *xfer);
|
|
|
|
#endif /* SPI_IMX31_H */
|