diff options
Diffstat (limited to 'include')
| -rw-r--r-- | include/linux/amba/pl022.h | 32 | ||||
| -rw-r--r-- | include/linux/spi/spi_bitbang.h | 101 |
2 files changed, 31 insertions, 102 deletions
diff --git a/include/linux/amba/pl022.h b/include/linux/amba/pl022.h index e4836c6b3dd7..abf26cc47a2b 100644 --- a/include/linux/amba/pl022.h +++ b/include/linux/amba/pl022.h | |||
| @@ -71,6 +71,7 @@ struct ssp_clock_params { | |||
| 71 | 71 | ||
| 72 | /** | 72 | /** |
| 73 | * enum ssp_rx_endian - endianess of Rx FIFO Data | 73 | * enum ssp_rx_endian - endianess of Rx FIFO Data |
| 74 | * this feature is only available in ST versionf of PL022 | ||
| 74 | */ | 75 | */ |
| 75 | enum ssp_rx_endian { | 76 | enum ssp_rx_endian { |
| 76 | SSP_RX_MSB, | 77 | SSP_RX_MSB, |
| @@ -181,7 +182,8 @@ enum ssp_microwire_wait_state { | |||
| 181 | }; | 182 | }; |
| 182 | 183 | ||
| 183 | /** | 184 | /** |
| 184 | * enum Microwire - whether Full/Half Duplex | 185 | * enum ssp_duplex - whether Full/Half Duplex on microwire, only |
| 186 | * available in the ST Micro variant. | ||
| 185 | * @SSP_MICROWIRE_CHANNEL_FULL_DUPLEX: SSPTXD becomes bi-directional, | 187 | * @SSP_MICROWIRE_CHANNEL_FULL_DUPLEX: SSPTXD becomes bi-directional, |
| 186 | * SSPRXD not used | 188 | * SSPRXD not used |
| 187 | * @SSP_MICROWIRE_CHANNEL_HALF_DUPLEX: SSPTXD is an output, SSPRXD is | 189 | * @SSP_MICROWIRE_CHANNEL_HALF_DUPLEX: SSPTXD is an output, SSPRXD is |
| @@ -193,6 +195,31 @@ enum ssp_duplex { | |||
| 193 | }; | 195 | }; |
| 194 | 196 | ||
| 195 | /** | 197 | /** |
| 198 | * enum ssp_clkdelay - an optional clock delay on the feedback clock | ||
| 199 | * only available in the ST Micro PL023 variant. | ||
| 200 | * @SSP_FEEDBACK_CLK_DELAY_NONE: no delay, the data coming in from the | ||
| 201 | * slave is sampled directly | ||
| 202 | * @SSP_FEEDBACK_CLK_DELAY_1T: the incoming slave data is sampled with | ||
| 203 | * a delay of T-dt | ||
| 204 | * @SSP_FEEDBACK_CLK_DELAY_2T: dito with a delay if 2T-dt | ||
| 205 | * @SSP_FEEDBACK_CLK_DELAY_3T: dito with a delay if 3T-dt | ||
| 206 | * @SSP_FEEDBACK_CLK_DELAY_4T: dito with a delay if 4T-dt | ||
| 207 | * @SSP_FEEDBACK_CLK_DELAY_5T: dito with a delay if 5T-dt | ||
| 208 | * @SSP_FEEDBACK_CLK_DELAY_6T: dito with a delay if 6T-dt | ||
| 209 | * @SSP_FEEDBACK_CLK_DELAY_7T: dito with a delay if 7T-dt | ||
| 210 | */ | ||
| 211 | enum ssp_clkdelay { | ||
| 212 | SSP_FEEDBACK_CLK_DELAY_NONE, | ||
| 213 | SSP_FEEDBACK_CLK_DELAY_1T, | ||
| 214 | SSP_FEEDBACK_CLK_DELAY_2T, | ||
| 215 | SSP_FEEDBACK_CLK_DELAY_3T, | ||
| 216 | SSP_FEEDBACK_CLK_DELAY_4T, | ||
| 217 | SSP_FEEDBACK_CLK_DELAY_5T, | ||
| 218 | SSP_FEEDBACK_CLK_DELAY_6T, | ||
| 219 | SSP_FEEDBACK_CLK_DELAY_7T | ||
| 220 | }; | ||
| 221 | |||
| 222 | /** | ||
| 196 | * CHIP select/deselect commands | 223 | * CHIP select/deselect commands |
| 197 | */ | 224 | */ |
| 198 | enum ssp_chip_select { | 225 | enum ssp_chip_select { |
| @@ -235,6 +262,8 @@ struct pl022_ssp_controller { | |||
| 235 | * @ctrl_len: Microwire interface: Control length | 262 | * @ctrl_len: Microwire interface: Control length |
| 236 | * @wait_state: Microwire interface: Wait state | 263 | * @wait_state: Microwire interface: Wait state |
| 237 | * @duplex: Microwire interface: Full/Half duplex | 264 | * @duplex: Microwire interface: Full/Half duplex |
| 265 | * @clkdelay: on the PL023 variant, the delay in feeback clock cycles | ||
| 266 | * before sampling the incoming line | ||
| 238 | * @cs_control: function pointer to board-specific function to | 267 | * @cs_control: function pointer to board-specific function to |
| 239 | * assert/deassert I/O port to control HW generation of devices chip-select. | 268 | * assert/deassert I/O port to control HW generation of devices chip-select. |
| 240 | * @dma_xfer_type: Type of DMA xfer (Mem-to-periph or Periph-to-Periph) | 269 | * @dma_xfer_type: Type of DMA xfer (Mem-to-periph or Periph-to-Periph) |
| @@ -258,6 +287,7 @@ struct pl022_config_chip { | |||
| 258 | enum ssp_microwire_ctrl_len ctrl_len; | 287 | enum ssp_microwire_ctrl_len ctrl_len; |
| 259 | enum ssp_microwire_wait_state wait_state; | 288 | enum ssp_microwire_wait_state wait_state; |
| 260 | enum ssp_duplex duplex; | 289 | enum ssp_duplex duplex; |
| 290 | enum ssp_clkdelay clkdelay; | ||
| 261 | void (*cs_control) (u32 control); | 291 | void (*cs_control) (u32 control); |
| 262 | }; | 292 | }; |
| 263 | 293 | ||
diff --git a/include/linux/spi/spi_bitbang.h b/include/linux/spi/spi_bitbang.h index 3274c507b8a9..f987a2bee16a 100644 --- a/include/linux/spi/spi_bitbang.h +++ b/include/linux/spi/spi_bitbang.h | |||
| @@ -1,24 +1,6 @@ | |||
| 1 | #ifndef __SPI_BITBANG_H | 1 | #ifndef __SPI_BITBANG_H |
| 2 | #define __SPI_BITBANG_H | 2 | #define __SPI_BITBANG_H |
| 3 | 3 | ||
| 4 | /* | ||
| 5 | * Mix this utility code with some glue code to get one of several types of | ||
| 6 | * simple SPI master driver. Two do polled word-at-a-time I/O: | ||
| 7 | * | ||
| 8 | * - GPIO/parport bitbangers. Provide chipselect() and txrx_word[](), | ||
| 9 | * expanding the per-word routines from the inline templates below. | ||
| 10 | * | ||
| 11 | * - Drivers for controllers resembling bare shift registers. Provide | ||
| 12 | * chipselect() and txrx_word[](), with custom setup()/cleanup() methods | ||
| 13 | * that use your controller's clock and chipselect registers. | ||
| 14 | * | ||
| 15 | * Some hardware works well with requests at spi_transfer scope: | ||
| 16 | * | ||
| 17 | * - Drivers leveraging smarter hardware, with fifos or DMA; or for half | ||
| 18 | * duplex (MicroWire) controllers. Provide chipselect() and txrx_bufs(), | ||
| 19 | * and custom setup()/cleanup() methods. | ||
| 20 | */ | ||
| 21 | |||
| 22 | #include <linux/workqueue.h> | 4 | #include <linux/workqueue.h> |
| 23 | 5 | ||
| 24 | struct spi_bitbang { | 6 | struct spi_bitbang { |
| @@ -68,86 +50,3 @@ extern int spi_bitbang_start(struct spi_bitbang *spi); | |||
| 68 | extern int spi_bitbang_stop(struct spi_bitbang *spi); | 50 | extern int spi_bitbang_stop(struct spi_bitbang *spi); |
| 69 | 51 | ||
| 70 | #endif /* __SPI_BITBANG_H */ | 52 | #endif /* __SPI_BITBANG_H */ |
| 71 | |||
| 72 | /*-------------------------------------------------------------------------*/ | ||
| 73 | |||
| 74 | #ifdef EXPAND_BITBANG_TXRX | ||
| 75 | |||
| 76 | /* | ||
| 77 | * The code that knows what GPIO pins do what should have declared four | ||
| 78 | * functions, ideally as inlines, before #defining EXPAND_BITBANG_TXRX | ||
| 79 | * and including this header: | ||
| 80 | * | ||
| 81 | * void setsck(struct spi_device *, int is_on); | ||
| 82 | * void setmosi(struct spi_device *, int is_on); | ||
| 83 | * int getmiso(struct spi_device *); | ||
| 84 | * void spidelay(unsigned); | ||
| 85 | * | ||
| 86 | * setsck()'s is_on parameter is a zero/nonzero boolean. | ||
| 87 | * | ||
| 88 | * setmosi()'s is_on parameter is a zero/nonzero boolean. | ||
| 89 | * | ||
| 90 | * getmiso() is required to return 0 or 1 only. Any other value is invalid | ||
| 91 | * and will result in improper operation. | ||
| 92 | * | ||
| 93 | * A non-inlined routine would call bitbang_txrx_*() routines. The | ||
| 94 | * main loop could easily compile down to a handful of instructions, | ||
| 95 | * especially if the delay is a NOP (to run at peak speed). | ||
| 96 | * | ||
| 97 | * Since this is software, the timings may not be exactly what your board's | ||
| 98 | * chips need ... there may be several reasons you'd need to tweak timings | ||
| 99 | * in these routines, not just make to make it faster or slower to match a | ||
| 100 | * particular CPU clock rate. | ||
| 101 | */ | ||
| 102 | |||
| 103 | static inline u32 | ||
| 104 | bitbang_txrx_be_cpha0(struct spi_device *spi, | ||
| 105 | unsigned nsecs, unsigned cpol, | ||
| 106 | u32 word, u8 bits) | ||
| 107 | { | ||
| 108 | /* if (cpol == 0) this is SPI_MODE_0; else this is SPI_MODE_2 */ | ||
| 109 | |||
| 110 | /* clock starts at inactive polarity */ | ||
| 111 | for (word <<= (32 - bits); likely(bits); bits--) { | ||
| 112 | |||
| 113 | /* setup MSB (to slave) on trailing edge */ | ||
| 114 | setmosi(spi, word & (1 << 31)); | ||
| 115 | spidelay(nsecs); /* T(setup) */ | ||
| 116 | |||
| 117 | setsck(spi, !cpol); | ||
| 118 | spidelay(nsecs); | ||
| 119 | |||
| 120 | /* sample MSB (from slave) on leading edge */ | ||
| 121 | word <<= 1; | ||
| 122 | word |= getmiso(spi); | ||
| 123 | setsck(spi, cpol); | ||
| 124 | } | ||
| 125 | return word; | ||
| 126 | } | ||
| 127 | |||
| 128 | static inline u32 | ||
| 129 | bitbang_txrx_be_cpha1(struct spi_device *spi, | ||
| 130 | unsigned nsecs, unsigned cpol, | ||
| 131 | u32 word, u8 bits) | ||
| 132 | { | ||
| 133 | /* if (cpol == 0) this is SPI_MODE_1; else this is SPI_MODE_3 */ | ||
| 134 | |||
| 135 | /* clock starts at inactive polarity */ | ||
| 136 | for (word <<= (32 - bits); likely(bits); bits--) { | ||
| 137 | |||
| 138 | /* setup MSB (to slave) on leading edge */ | ||
| 139 | setsck(spi, !cpol); | ||
| 140 | setmosi(spi, word & (1 << 31)); | ||
| 141 | spidelay(nsecs); /* T(setup) */ | ||
| 142 | |||
| 143 | setsck(spi, cpol); | ||
| 144 | spidelay(nsecs); | ||
| 145 | |||
| 146 | /* sample MSB (from slave) on trailing edge */ | ||
| 147 | word <<= 1; | ||
| 148 | word |= getmiso(spi); | ||
| 149 | } | ||
| 150 | return word; | ||
| 151 | } | ||
| 152 | |||
| 153 | #endif /* EXPAND_BITBANG_TXRX */ | ||
