]>
Commit | Line | Data |
---|---|---|
c942fddf | 1 | // SPDX-License-Identifier: GPL-2.0-or-later |
d29389de | 2 | /* |
ca632f55 | 3 | * SPI master driver using generic bitbanged GPIO |
d29389de DB |
4 | * |
5 | * Copyright (C) 2006,2008 David Brownell | |
9b00bc7b | 6 | * Copyright (C) 2017 Linus Walleij |
d29389de DB |
7 | */ |
8 | #include <linux/kernel.h> | |
d7614de4 | 9 | #include <linux/module.h> |
d29389de | 10 | #include <linux/platform_device.h> |
9b00bc7b | 11 | #include <linux/gpio/consumer.h> |
ecc77773 | 12 | #include <linux/of.h> |
38ab18ca | 13 | #include <linux/of_device.h> |
d29389de DB |
14 | |
15 | #include <linux/spi/spi.h> | |
16 | #include <linux/spi/spi_bitbang.h> | |
17 | #include <linux/spi/spi_gpio.h> | |
18 | ||
19 | ||
20 | /* | |
21 | * This bitbanging SPI master driver should help make systems usable | |
22 | * when a native hardware SPI engine is not available, perhaps because | |
23 | * its driver isn't yet working or because the I/O pins it requires | |
24 | * are used for other purposes. | |
25 | * | |
26 | * platform_device->driver_data ... points to spi_gpio | |
27 | * | |
28 | * spi->controller_state ... reserved for bitbang framework code | |
d29389de DB |
29 | * |
30 | * spi->master->dev.driver_data ... points to spi_gpio->bitbang | |
31 | */ | |
32 | ||
33 | struct spi_gpio { | |
34 | struct spi_bitbang bitbang; | |
9b00bc7b LW |
35 | struct gpio_desc *sck; |
36 | struct gpio_desc *miso; | |
37 | struct gpio_desc *mosi; | |
38 | struct gpio_desc **cs_gpios; | |
d29389de DB |
39 | }; |
40 | ||
41 | /*----------------------------------------------------------------------*/ | |
42 | ||
43 | /* | |
44 | * Because the overhead of going through four GPIO procedure calls | |
45 | * per transferred bit can make performance a problem, this code | |
46 | * is set up so that you can use it in either of two ways: | |
47 | * | |
48 | * - The slow generic way: set up platform_data to hold the GPIO | |
49 | * numbers used for MISO/MOSI/SCK, and issue procedure calls for | |
50 | * each of them. This driver can handle several such busses. | |
51 | * | |
52 | * - The quicker inlined way: only helps with platform GPIO code | |
53 | * that inlines operations for constant GPIOs. This can give | |
54 | * you tight (fast!) inner loops, but each such bus needs a | |
55 | * new driver. You'll define a new C file, with Makefile and | |
56 | * Kconfig support; the C code can be a total of six lines: | |
57 | * | |
58 | * #define DRIVER_NAME "myboard_spi2" | |
59 | * #define SPI_MISO_GPIO 119 | |
60 | * #define SPI_MOSI_GPIO 120 | |
61 | * #define SPI_SCK_GPIO 121 | |
62 | * #define SPI_N_CHIPSEL 4 | |
ca632f55 | 63 | * #include "spi-gpio.c" |
d29389de DB |
64 | */ |
65 | ||
66 | #ifndef DRIVER_NAME | |
67 | #define DRIVER_NAME "spi_gpio" | |
68 | ||
69 | #define GENERIC_BITBANG /* vs tight inlines */ | |
70 | ||
d29389de DB |
71 | #endif |
72 | ||
73 | /*----------------------------------------------------------------------*/ | |
74 | ||
650705cf | 75 | static inline struct spi_gpio *__pure |
161c2dd3 | 76 | spi_to_spi_gpio(const struct spi_device *spi) |
d29389de DB |
77 | { |
78 | const struct spi_bitbang *bang; | |
161c2dd3 | 79 | struct spi_gpio *spi_gpio; |
d29389de DB |
80 | |
81 | bang = spi_master_get_devdata(spi->master); | |
82 | spi_gpio = container_of(bang, struct spi_gpio, bitbang); | |
161c2dd3 DM |
83 | return spi_gpio; |
84 | } | |
85 | ||
9b00bc7b | 86 | /* These helpers are in turn called by the bitbang inlines */ |
d29389de DB |
87 | static inline void setsck(const struct spi_device *spi, int is_on) |
88 | { | |
9b00bc7b LW |
89 | struct spi_gpio *spi_gpio = spi_to_spi_gpio(spi); |
90 | ||
91 | gpiod_set_value_cansleep(spi_gpio->sck, is_on); | |
d29389de DB |
92 | } |
93 | ||
94 | static inline void setmosi(const struct spi_device *spi, int is_on) | |
95 | { | |
9b00bc7b LW |
96 | struct spi_gpio *spi_gpio = spi_to_spi_gpio(spi); |
97 | ||
98 | gpiod_set_value_cansleep(spi_gpio->mosi, is_on); | |
d29389de DB |
99 | } |
100 | ||
101 | static inline int getmiso(const struct spi_device *spi) | |
102 | { | |
9b00bc7b | 103 | struct spi_gpio *spi_gpio = spi_to_spi_gpio(spi); |
d29389de | 104 | |
4b859db2 LB |
105 | if (spi->mode & SPI_3WIRE) |
106 | return !!gpiod_get_value_cansleep(spi_gpio->mosi); | |
107 | else | |
108 | return !!gpiod_get_value_cansleep(spi_gpio->miso); | |
9b00bc7b | 109 | } |
d29389de DB |
110 | |
111 | /* | |
112 | * NOTE: this clocks "as fast as we can". It "should" be a function of the | |
113 | * requested device clock. Software overhead means we usually have trouble | |
114 | * reaching even one Mbit/sec (except when we can inline bitops), so for now | |
115 | * we'll just assume we never need additional per-bit slowdowns. | |
116 | */ | |
117 | #define spidelay(nsecs) do {} while (0) | |
118 | ||
ca632f55 | 119 | #include "spi-bitbang-txrx.h" |
d29389de DB |
120 | |
121 | /* | |
122 | * These functions can leverage inline expansion of GPIO calls to shrink | |
123 | * costs for a txrx bit, often by factors of around ten (by instruction | |
124 | * count). That is particularly visible for larger word sizes, but helps | |
125 | * even with default 8-bit words. | |
126 | * | |
127 | * REVISIT overheads calling these functions for each word also have | |
128 | * significant performance costs. Having txrx_bufs() calls that inline | |
129 | * the txrx_word() logic would help performance, e.g. on larger blocks | |
130 | * used with flash storage or MMC/SD. There should also be ways to make | |
131 | * GCC be less stupid about reloading registers inside the I/O loops, | |
132 | * even without inlined GPIO calls; __attribute__((hot)) on GCC 4.3? | |
133 | */ | |
134 | ||
135 | static u32 spi_gpio_txrx_word_mode0(struct spi_device *spi, | |
304d3436 | 136 | unsigned nsecs, u32 word, u8 bits, unsigned flags) |
d29389de | 137 | { |
304d3436 | 138 | return bitbang_txrx_be_cpha0(spi, nsecs, 0, flags, word, bits); |
d29389de DB |
139 | } |
140 | ||
141 | static u32 spi_gpio_txrx_word_mode1(struct spi_device *spi, | |
304d3436 | 142 | unsigned nsecs, u32 word, u8 bits, unsigned flags) |
d29389de | 143 | { |
304d3436 | 144 | return bitbang_txrx_be_cpha1(spi, nsecs, 0, flags, word, bits); |
d29389de DB |
145 | } |
146 | ||
147 | static u32 spi_gpio_txrx_word_mode2(struct spi_device *spi, | |
304d3436 | 148 | unsigned nsecs, u32 word, u8 bits, unsigned flags) |
d29389de | 149 | { |
304d3436 | 150 | return bitbang_txrx_be_cpha0(spi, nsecs, 1, flags, word, bits); |
d29389de DB |
151 | } |
152 | ||
153 | static u32 spi_gpio_txrx_word_mode3(struct spi_device *spi, | |
304d3436 | 154 | unsigned nsecs, u32 word, u8 bits, unsigned flags) |
d29389de | 155 | { |
304d3436 | 156 | return bitbang_txrx_be_cpha1(spi, nsecs, 1, flags, word, bits); |
d29389de DB |
157 | } |
158 | ||
3c8e1a84 MS |
159 | /* |
160 | * These functions do not call setmosi or getmiso if respective flag | |
161 | * (SPI_MASTER_NO_RX or SPI_MASTER_NO_TX) is set, so they are safe to | |
162 | * call when such pin is not present or defined in the controller. | |
163 | * A separate set of callbacks is defined to get highest possible | |
164 | * speed in the generic case (when both MISO and MOSI lines are | |
165 | * available), as optimiser will remove the checks when argument is | |
166 | * constant. | |
167 | */ | |
168 | ||
169 | static u32 spi_gpio_spec_txrx_word_mode0(struct spi_device *spi, | |
304d3436 | 170 | unsigned nsecs, u32 word, u8 bits, unsigned flags) |
3c8e1a84 | 171 | { |
304d3436 | 172 | flags = spi->master->flags; |
3c8e1a84 MS |
173 | return bitbang_txrx_be_cpha0(spi, nsecs, 0, flags, word, bits); |
174 | } | |
175 | ||
176 | static u32 spi_gpio_spec_txrx_word_mode1(struct spi_device *spi, | |
304d3436 | 177 | unsigned nsecs, u32 word, u8 bits, unsigned flags) |
3c8e1a84 | 178 | { |
304d3436 | 179 | flags = spi->master->flags; |
3c8e1a84 MS |
180 | return bitbang_txrx_be_cpha1(spi, nsecs, 0, flags, word, bits); |
181 | } | |
182 | ||
183 | static u32 spi_gpio_spec_txrx_word_mode2(struct spi_device *spi, | |
304d3436 | 184 | unsigned nsecs, u32 word, u8 bits, unsigned flags) |
3c8e1a84 | 185 | { |
304d3436 | 186 | flags = spi->master->flags; |
3c8e1a84 MS |
187 | return bitbang_txrx_be_cpha0(spi, nsecs, 1, flags, word, bits); |
188 | } | |
189 | ||
190 | static u32 spi_gpio_spec_txrx_word_mode3(struct spi_device *spi, | |
304d3436 | 191 | unsigned nsecs, u32 word, u8 bits, unsigned flags) |
3c8e1a84 | 192 | { |
304d3436 | 193 | flags = spi->master->flags; |
3c8e1a84 MS |
194 | return bitbang_txrx_be_cpha1(spi, nsecs, 1, flags, word, bits); |
195 | } | |
196 | ||
d29389de DB |
197 | /*----------------------------------------------------------------------*/ |
198 | ||
199 | static void spi_gpio_chipselect(struct spi_device *spi, int is_active) | |
200 | { | |
161c2dd3 | 201 | struct spi_gpio *spi_gpio = spi_to_spi_gpio(spi); |
d29389de | 202 | |
9b00bc7b | 203 | /* set initial clock line level */ |
d29389de | 204 | if (is_active) |
9b00bc7b LW |
205 | gpiod_set_value_cansleep(spi_gpio->sck, spi->mode & SPI_CPOL); |
206 | ||
207 | /* Drive chip select line, if we have one */ | |
249e2632 | 208 | if (spi_gpio->cs_gpios) { |
9b00bc7b | 209 | struct gpio_desc *cs = spi_gpio->cs_gpios[spi->chip_select]; |
d29389de | 210 | |
9b00bc7b LW |
211 | /* SPI chip selects are normally active-low */ |
212 | gpiod_set_value_cansleep(cs, (spi->mode & SPI_CS_HIGH) ? is_active : !is_active); | |
bfb9bcdb | 213 | } |
d29389de DB |
214 | } |
215 | ||
216 | static int spi_gpio_setup(struct spi_device *spi) | |
217 | { | |
9b00bc7b | 218 | struct gpio_desc *cs; |
161c2dd3 DM |
219 | int status = 0; |
220 | struct spi_gpio *spi_gpio = spi_to_spi_gpio(spi); | |
38ab18ca | 221 | |
9b00bc7b LW |
222 | /* |
223 | * The CS GPIOs have already been | |
224 | * initialized from the descriptor lookup. | |
225 | */ | |
249e2632 AS |
226 | if (spi_gpio->cs_gpios) { |
227 | cs = spi_gpio->cs_gpios[spi->chip_select]; | |
228 | if (!spi->controller_state && cs) | |
229 | status = gpiod_direction_output(cs, | |
230 | !(spi->mode & SPI_CS_HIGH)); | |
231 | } | |
9b00bc7b LW |
232 | |
233 | if (!status) | |
6b8cc330 | 234 | status = spi_bitbang_setup(spi); |
161c2dd3 | 235 | |
d29389de DB |
236 | return status; |
237 | } | |
238 | ||
4b859db2 LB |
239 | static int spi_gpio_set_direction(struct spi_device *spi, bool output) |
240 | { | |
241 | struct spi_gpio *spi_gpio = spi_to_spi_gpio(spi); | |
5132b3d2 | 242 | int ret; |
4b859db2 LB |
243 | |
244 | if (output) | |
245 | return gpiod_direction_output(spi_gpio->mosi, 1); | |
5132b3d2 LW |
246 | |
247 | ret = gpiod_direction_input(spi_gpio->mosi); | |
248 | if (ret) | |
249 | return ret; | |
250 | /* | |
251 | * Send a turnaround high impedance cycle when switching | |
252 | * from output to input. Theoretically there should be | |
253 | * a clock delay here, but as has been noted above, the | |
254 | * nsec delay function for bit-banged GPIO is simply | |
255 | * {} because bit-banging just doesn't get fast enough | |
256 | * anyway. | |
257 | */ | |
258 | if (spi->mode & SPI_3WIRE_HIZ) { | |
259 | gpiod_set_value_cansleep(spi_gpio->sck, | |
260 | !(spi->mode & SPI_CPOL)); | |
261 | gpiod_set_value_cansleep(spi_gpio->sck, | |
262 | !!(spi->mode & SPI_CPOL)); | |
263 | } | |
264 | return 0; | |
4b859db2 LB |
265 | } |
266 | ||
d29389de DB |
267 | static void spi_gpio_cleanup(struct spi_device *spi) |
268 | { | |
d29389de DB |
269 | spi_bitbang_cleanup(spi); |
270 | } | |
271 | ||
9b00bc7b LW |
272 | /* |
273 | * It can be convenient to use this driver with pins that have alternate | |
274 | * functions associated with a "native" SPI controller if a driver for that | |
275 | * controller is not available, or is missing important functionality. | |
276 | * | |
277 | * On platforms which can do so, configure MISO with a weak pullup unless | |
278 | * there's an external pullup on that signal. That saves power by avoiding | |
279 | * floating signals. (A weak pulldown would save power too, but many | |
280 | * drivers expect to see all-ones data as the no slave "response".) | |
281 | */ | |
5c8283c1 | 282 | static int spi_gpio_request(struct device *dev, struct spi_gpio *spi_gpio) |
d29389de | 283 | { |
9b00bc7b LW |
284 | spi_gpio->mosi = devm_gpiod_get_optional(dev, "mosi", GPIOD_OUT_LOW); |
285 | if (IS_ERR(spi_gpio->mosi)) | |
286 | return PTR_ERR(spi_gpio->mosi); | |
d29389de | 287 | |
9b00bc7b LW |
288 | spi_gpio->miso = devm_gpiod_get_optional(dev, "miso", GPIOD_IN); |
289 | if (IS_ERR(spi_gpio->miso)) | |
290 | return PTR_ERR(spi_gpio->miso); | |
d29389de | 291 | |
9b00bc7b | 292 | spi_gpio->sck = devm_gpiod_get(dev, "sck", GPIOD_OUT_LOW); |
8995673e | 293 | return PTR_ERR_OR_ZERO(spi_gpio->sck); |
d29389de DB |
294 | } |
295 | ||
38ab18ca | 296 | #ifdef CONFIG_OF |
d9e15281 | 297 | static const struct of_device_id spi_gpio_dt_ids[] = { |
38ab18ca DM |
298 | { .compatible = "spi-gpio" }, |
299 | {} | |
300 | }; | |
301 | MODULE_DEVICE_TABLE(of, spi_gpio_dt_ids); | |
302 | ||
249e2632 AS |
303 | static int spi_gpio_probe_dt(struct platform_device *pdev, |
304 | struct spi_master *master) | |
38ab18ca | 305 | { |
249e2632 AS |
306 | master->dev.of_node = pdev->dev.of_node; |
307 | master->use_gpio_descriptors = true; | |
38ab18ca | 308 | |
249e2632 AS |
309 | return 0; |
310 | } | |
311 | #else | |
312 | static inline int spi_gpio_probe_dt(struct platform_device *pdev, | |
313 | struct spi_master *master) | |
314 | { | |
315 | return 0; | |
316 | } | |
317 | #endif | |
38ab18ca | 318 | |
249e2632 AS |
319 | static int spi_gpio_probe_pdata(struct platform_device *pdev, |
320 | struct spi_master *master) | |
321 | { | |
322 | struct device *dev = &pdev->dev; | |
323 | struct spi_gpio_platform_data *pdata = dev_get_platdata(dev); | |
324 | struct spi_gpio *spi_gpio = spi_master_get_devdata(master); | |
325 | int i; | |
38ab18ca | 326 | |
249e2632 AS |
327 | #ifdef GENERIC_BITBANG |
328 | if (!pdata || !pdata->num_chipselect) | |
329 | return -ENODEV; | |
330 | #endif | |
331 | /* | |
332 | * The master needs to think there is a chipselect even if not | |
333 | * connected | |
334 | */ | |
335 | master->num_chipselect = pdata->num_chipselect ?: 1; | |
38ab18ca | 336 | |
249e2632 AS |
337 | spi_gpio->cs_gpios = devm_kcalloc(dev, master->num_chipselect, |
338 | sizeof(*spi_gpio->cs_gpios), | |
339 | GFP_KERNEL); | |
340 | if (!spi_gpio->cs_gpios) | |
341 | return -ENOMEM; | |
38ab18ca | 342 | |
249e2632 AS |
343 | for (i = 0; i < master->num_chipselect; i++) { |
344 | spi_gpio->cs_gpios[i] = devm_gpiod_get_index(dev, "cs", i, | |
345 | GPIOD_OUT_HIGH); | |
346 | if (IS_ERR(spi_gpio->cs_gpios[i])) | |
347 | return PTR_ERR(spi_gpio->cs_gpios[i]); | |
348 | } | |
38ab18ca | 349 | |
38ab18ca DM |
350 | return 0; |
351 | } | |
38ab18ca | 352 | |
8b797490 AS |
353 | static void spi_gpio_put(void *data) |
354 | { | |
355 | spi_master_put(data); | |
356 | } | |
357 | ||
fd4a319b | 358 | static int spi_gpio_probe(struct platform_device *pdev) |
d29389de DB |
359 | { |
360 | int status; | |
361 | struct spi_master *master; | |
362 | struct spi_gpio *spi_gpio; | |
96cad6d7 | 363 | struct device *dev = &pdev->dev; |
15dd0e9e | 364 | struct spi_bitbang *bb; |
d29389de | 365 | |
96cad6d7 | 366 | master = spi_alloc_master(dev, sizeof(*spi_gpio)); |
9b00bc7b LW |
367 | if (!master) |
368 | return -ENOMEM; | |
d29389de | 369 | |
8b797490 | 370 | status = devm_add_action_or_reset(&pdev->dev, spi_gpio_put, master); |
d3b0ffa1 NE |
371 | if (status) { |
372 | spi_master_put(master); | |
8b797490 | 373 | return status; |
d3b0ffa1 | 374 | } |
8b797490 | 375 | |
62217f8b | 376 | if (pdev->dev.of_node) |
249e2632 AS |
377 | status = spi_gpio_probe_dt(pdev, master); |
378 | else | |
379 | status = spi_gpio_probe_pdata(pdev, master); | |
9b00bc7b | 380 | |
249e2632 AS |
381 | if (status) |
382 | return status; | |
9b00bc7b | 383 | |
249e2632 | 384 | spi_gpio = spi_master_get_devdata(master); |
d29389de | 385 | |
5c8283c1 | 386 | status = spi_gpio_request(dev, spi_gpio); |
9b00bc7b LW |
387 | if (status) |
388 | return status; | |
389 | ||
24778be2 | 390 | master->bits_per_word_mask = SPI_BPW_RANGE_MASK(1, 32); |
b89fefda RK |
391 | master->mode_bits = SPI_3WIRE | SPI_3WIRE_HIZ | SPI_CPHA | SPI_CPOL | |
392 | SPI_CS_HIGH; | |
5c8283c1 AS |
393 | if (!spi_gpio->mosi) { |
394 | /* HW configuration without MOSI pin | |
395 | * | |
396 | * No setting SPI_MASTER_NO_RX here - if there is only | |
397 | * a MOSI pin connected the host can still do RX by | |
398 | * changing the direction of the line. | |
399 | */ | |
400 | master->flags = SPI_MASTER_NO_TX; | |
401 | } | |
402 | ||
d29389de | 403 | master->bus_num = pdev->id; |
d29389de DB |
404 | master->setup = spi_gpio_setup; |
405 | master->cleanup = spi_gpio_cleanup; | |
249e2632 | 406 | |
15dd0e9e AS |
407 | bb = &spi_gpio->bitbang; |
408 | bb->master = master; | |
2922d1cc LW |
409 | /* |
410 | * There is some additional business, apart from driving the CS GPIO | |
411 | * line, that we need to do on selection. This makes the local | |
412 | * callback for chipselect always get called. | |
413 | */ | |
414 | master->flags |= SPI_MASTER_GPIO_SS; | |
15dd0e9e AS |
415 | bb->chipselect = spi_gpio_chipselect; |
416 | bb->set_line_direction = spi_gpio_set_direction; | |
3c8e1a84 | 417 | |
5c8283c1 | 418 | if (master->flags & SPI_MASTER_NO_TX) { |
15dd0e9e AS |
419 | bb->txrx_word[SPI_MODE_0] = spi_gpio_spec_txrx_word_mode0; |
420 | bb->txrx_word[SPI_MODE_1] = spi_gpio_spec_txrx_word_mode1; | |
421 | bb->txrx_word[SPI_MODE_2] = spi_gpio_spec_txrx_word_mode2; | |
422 | bb->txrx_word[SPI_MODE_3] = spi_gpio_spec_txrx_word_mode3; | |
68cd9dc2 AS |
423 | } else { |
424 | bb->txrx_word[SPI_MODE_0] = spi_gpio_txrx_word_mode0; | |
425 | bb->txrx_word[SPI_MODE_1] = spi_gpio_txrx_word_mode1; | |
426 | bb->txrx_word[SPI_MODE_2] = spi_gpio_txrx_word_mode2; | |
427 | bb->txrx_word[SPI_MODE_3] = spi_gpio_txrx_word_mode3; | |
3c8e1a84 | 428 | } |
15dd0e9e | 429 | bb->setup_transfer = spi_bitbang_setup_transfer; |
d29389de | 430 | |
79567c1a AS |
431 | status = spi_bitbang_init(&spi_gpio->bitbang); |
432 | if (status) | |
433 | return status; | |
d29389de | 434 | |
79567c1a | 435 | return devm_spi_register_master(&pdev->dev, spi_master_get(master)); |
d29389de DB |
436 | } |
437 | ||
438 | MODULE_ALIAS("platform:" DRIVER_NAME); | |
439 | ||
440 | static struct platform_driver spi_gpio_driver = { | |
38ab18ca DM |
441 | .driver = { |
442 | .name = DRIVER_NAME, | |
38ab18ca DM |
443 | .of_match_table = of_match_ptr(spi_gpio_dt_ids), |
444 | }, | |
940ab889 | 445 | .probe = spi_gpio_probe, |
d29389de | 446 | }; |
940ab889 | 447 | module_platform_driver(spi_gpio_driver); |
d29389de DB |
448 | |
449 | MODULE_DESCRIPTION("SPI master driver using generic bitbanged GPIO "); | |
450 | MODULE_AUTHOR("David Brownell"); | |
451 | MODULE_LICENSE("GPL"); |