firmware/target/arm/imx31/gigabeat-s/spi-imx31.h

   1 /***************************************************************************
   2  *             __________               __   ___.
   3  *   Open      \______   \ ____   ____ |  | _\_ |__   _______  ___
   4  *   Source     |       _//  _ \_/ ___\|  |/ /| __ \ /  _ \  \/  /
   5  *   Jukebox    |    |   (  <_> )  \___|    < | \_\ (  <_> > <  <
   6  *   Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \
   7  *                     \/            \/     \/    \/            \/
   8  * $Id$
   9  *
  10  * Copyright (c) 2007 Will Robertson
  11  *
  12  * This program is free software; you can redistribute it and/or
  13  * modify it under the terms of the GNU General Public License
  14  * as published by the Free Software Foundation; either version 2
  15  * of the License, or (at your option) any later version.
  16  *
  17  * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
  18  * KIND, either express or implied.
  19  *
  20  ****************************************************************************/
  21 #ifndef SPI_IMX31_H
  22 #define SPI_IMX31_H
  23
  24 #define USE_CSPI1_MODULE (1 << 0)
  25 #define USE_CSPI2_MODULE (1 << 1)
  26 #define USE_CSPI3_MODULE (1 << 2)
  27
  28 /* SPI_MODULE_MASK is set in target's config */
  29 enum spi_module_number
  30 {
  31     __CSPI_NUM_START = -1, /* The first will be 0 */
  32 #if (SPI_MODULE_MASK & USE_CSPI1_MODULE)
  33     CSPI1_NUM,
  34 #endif
  35 #if (SPI_MODULE_MASK & USE_CSPI2_MODULE)
  36     CSPI2_NUM,
  37 #endif
  38 #if (SPI_MODULE_MASK & USE_CSPI3_MODULE)
  39     CSPI3_NUM,
  40 #endif
  41     SPI_NUM_CSPI,
  42 };
  43
  44 struct cspi_map
  45 {
  46     volatile uint32_t rxdata;       /* 00h */
  47     volatile uint32_t txdata;       /* 04h */
  48     volatile uint32_t conreg;       /* 08h */
  49     volatile uint32_t intreg;       /* 0Ch */
  50     volatile uint32_t dmareg;       /* 10h */
  51     volatile uint32_t statreg;      /* 14h */
  52     volatile uint32_t periodreg;    /* 18h */
  53     volatile uint32_t skip1[0x69];  /* 1Ch */
  54     volatile uint32_t testreg;      /* 1C0h */
  55 };
  56
  57 struct spi_node
  58 {
  59     enum spi_module_number num; /* Module number (CSPIx_NUM) */
  60     unsigned long conreg;       /* CSPI conreg setup */
  61     unsigned long periodreg;    /* CSPI periodreg setup */
  62 };
  63
  64 struct spi_transfer
  65 {
  66     const void *txbuf;
  67     void       *rxbuf;
  68     int         count;
  69 };
  70
  71 /* One-time init of SPI driver */
  72 void spi_init(void);
  73
  74 /* Enable the specified module for the node */
  75 void spi_enable_module(struct spi_node *node);
  76
  77 /* Disabled the specified module for the node */
  78 void spi_disable_module(struct spi_node *node);
  79
  80 /* Lock module mutex */
  81 void spi_lock(struct spi_node *node);
  82
  83 /* Unlock module mutex */
  84 void spi_unlock(struct spi_node *node);
  85
  86 /* Send and/or receive data on the specified node */
  87 int spi_transfer(struct spi_node *node, struct spi_transfer *trans);
  88
  89 #endif /* SPI_IMX31_H */