projects / deliverable / linux.git / blob
? search:
summary | shortlog | log | commit | commitdiff | tree
blame | history | raw | HEAD
watchdog: mtx1-wdt: use devm_gpio_request_one()
[deliverable/linux.git] / drivers / spi / spi-coldfire-qspi.c
1 /*
2 * Freescale/Motorola Coldfire Queued SPI driver
3 *
4 * Copyright 2010 Steven King <sfking@fdwdc.com>
5 *
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA
19 *
20 */
21
22 #include <linux/kernel.h>
23 #include <linux/module.h>
24 #include <linux/interrupt.h>
25 #include <linux/errno.h>
26 #include <linux/platform_device.h>
27 #include <linux/sched.h>
28 #include <linux/delay.h>
29 #include <linux/io.h>
30 #include <linux/clk.h>
31 #include <linux/err.h>
32 #include <linux/spi/spi.h>
33 #include <linux/pm_runtime.h>
34
35 #include <asm/coldfire.h>
36 #include <asm/mcfsim.h>
37 #include <asm/mcfqspi.h>
38
39 #define DRIVER_NAME "mcfqspi"
40
41 #define MCFQSPI_BUSCLK (MCF_BUSCLK / 2)
42
43 #define MCFQSPI_QMR 0x00
44 #define MCFQSPI_QMR_MSTR 0x8000
45 #define MCFQSPI_QMR_CPOL 0x0200
46 #define MCFQSPI_QMR_CPHA 0x0100
47 #define MCFQSPI_QDLYR 0x04
48 #define MCFQSPI_QDLYR_SPE 0x8000
49 #define MCFQSPI_QWR 0x08
50 #define MCFQSPI_QWR_HALT 0x8000
51 #define MCFQSPI_QWR_WREN 0x4000
52 #define MCFQSPI_QWR_CSIV 0x1000
53 #define MCFQSPI_QIR 0x0C
54 #define MCFQSPI_QIR_WCEFB 0x8000
55 #define MCFQSPI_QIR_ABRTB 0x4000
56 #define MCFQSPI_QIR_ABRTL 0x1000
57 #define MCFQSPI_QIR_WCEFE 0x0800
58 #define MCFQSPI_QIR_ABRTE 0x0400
59 #define MCFQSPI_QIR_SPIFE 0x0100
60 #define MCFQSPI_QIR_WCEF 0x0008
61 #define MCFQSPI_QIR_ABRT 0x0004
62 #define MCFQSPI_QIR_SPIF 0x0001
63 #define MCFQSPI_QAR 0x010
64 #define MCFQSPI_QAR_TXBUF 0x00
65 #define MCFQSPI_QAR_RXBUF 0x10
66 #define MCFQSPI_QAR_CMDBUF 0x20
67 #define MCFQSPI_QDR 0x014
68 #define MCFQSPI_QCR 0x014
69 #define MCFQSPI_QCR_CONT 0x8000
70 #define MCFQSPI_QCR_BITSE 0x4000
71 #define MCFQSPI_QCR_DT 0x2000
72
73 struct mcfqspi {
74 void __iomem *iobase;
75 int irq;
76 struct clk *clk;
77 struct mcfqspi_cs_control *cs_control;
78
79 wait_queue_head_t waitq;
80
81 struct device *dev;
82 };
83
84 static void mcfqspi_wr_qmr(struct mcfqspi *mcfqspi, u16 val)
85 {
86 writew(val, mcfqspi->iobase + MCFQSPI_QMR);
87 }
88
89 static void mcfqspi_wr_qdlyr(struct mcfqspi *mcfqspi, u16 val)
90 {
91 writew(val, mcfqspi->iobase + MCFQSPI_QDLYR);
92 }
93
94 static u16 mcfqspi_rd_qdlyr(struct mcfqspi *mcfqspi)
95 {
96 return readw(mcfqspi->iobase + MCFQSPI_QDLYR);
97 }
98
99 static void mcfqspi_wr_qwr(struct mcfqspi *mcfqspi, u16 val)
100 {
101 writew(val, mcfqspi->iobase + MCFQSPI_QWR);
102 }
103
104 static void mcfqspi_wr_qir(struct mcfqspi *mcfqspi, u16 val)
105 {
106 writew(val, mcfqspi->iobase + MCFQSPI_QIR);
107 }
108
109 static void mcfqspi_wr_qar(struct mcfqspi *mcfqspi, u16 val)
110 {
111 writew(val, mcfqspi->iobase + MCFQSPI_QAR);
112 }
113
114 static void mcfqspi_wr_qdr(struct mcfqspi *mcfqspi, u16 val)
115 {
116 writew(val, mcfqspi->iobase + MCFQSPI_QDR);
117 }
118
119 static u16 mcfqspi_rd_qdr(struct mcfqspi *mcfqspi)
120 {
121 return readw(mcfqspi->iobase + MCFQSPI_QDR);
122 }
123
124 static void mcfqspi_cs_select(struct mcfqspi *mcfqspi, u8 chip_select,
125 bool cs_high)
126 {
127 mcfqspi->cs_control->select(mcfqspi->cs_control, chip_select, cs_high);
128 }
129
130 static void mcfqspi_cs_deselect(struct mcfqspi *mcfqspi, u8 chip_select,
131 bool cs_high)
132 {
133 mcfqspi->cs_control->deselect(mcfqspi->cs_control, chip_select, cs_high);
134 }
135
136 static int mcfqspi_cs_setup(struct mcfqspi *mcfqspi)
137 {
138 return (mcfqspi->cs_control && mcfqspi->cs_control->setup) ?
139 mcfqspi->cs_control->setup(mcfqspi->cs_control) : 0;
140 }
141
142 static void mcfqspi_cs_teardown(struct mcfqspi *mcfqspi)
143 {
144 if (mcfqspi->cs_control && mcfqspi->cs_control->teardown)
145 mcfqspi->cs_control->teardown(mcfqspi->cs_control);
146 }
147
148 static u8 mcfqspi_qmr_baud(u32 speed_hz)
149 {
150 return clamp((MCFQSPI_BUSCLK + speed_hz - 1) / speed_hz, 2u, 255u);
151 }
152
153 static bool mcfqspi_qdlyr_spe(struct mcfqspi *mcfqspi)
154 {
155 return mcfqspi_rd_qdlyr(mcfqspi) & MCFQSPI_QDLYR_SPE;
156 }
157
158 static irqreturn_t mcfqspi_irq_handler(int this_irq, void *dev_id)
159 {
160 struct mcfqspi *mcfqspi = dev_id;
161
162 /* clear interrupt */
163 mcfqspi_wr_qir(mcfqspi, MCFQSPI_QIR_SPIFE | MCFQSPI_QIR_SPIF);
164 wake_up(&mcfqspi->waitq);
165
166 return IRQ_HANDLED;
167 }
168
169 static void mcfqspi_transfer_msg8(struct mcfqspi *mcfqspi, unsigned count,
170 const u8 *txbuf, u8 *rxbuf)
171 {
172 unsigned i, n, offset = 0;
173
174 n = min(count, 16u);
175
176 mcfqspi_wr_qar(mcfqspi, MCFQSPI_QAR_CMDBUF);
177 for (i = 0; i < n; ++i)
178 mcfqspi_wr_qdr(mcfqspi, MCFQSPI_QCR_BITSE);
179
180 mcfqspi_wr_qar(mcfqspi, MCFQSPI_QAR_TXBUF);
181 if (txbuf)
182 for (i = 0; i < n; ++i)
183 mcfqspi_wr_qdr(mcfqspi, *txbuf++);
184 else
185 for (i = 0; i < count; ++i)
186 mcfqspi_wr_qdr(mcfqspi, 0);
187
188 count -= n;
189 if (count) {
190 u16 qwr = 0xf08;
191 mcfqspi_wr_qwr(mcfqspi, 0x700);
192 mcfqspi_wr_qdlyr(mcfqspi, MCFQSPI_QDLYR_SPE);
193
194 do {
195 wait_event(mcfqspi->waitq, !mcfqspi_qdlyr_spe(mcfqspi));
196 mcfqspi_wr_qwr(mcfqspi, qwr);
197 mcfqspi_wr_qdlyr(mcfqspi, MCFQSPI_QDLYR_SPE);
198 if (rxbuf) {
199 mcfqspi_wr_qar(mcfqspi,
200 MCFQSPI_QAR_RXBUF + offset);
201 for (i = 0; i < 8; ++i)
202 *rxbuf++ = mcfqspi_rd_qdr(mcfqspi);
203 }
204 n = min(count, 8u);
205 if (txbuf) {
206 mcfqspi_wr_qar(mcfqspi,
207 MCFQSPI_QAR_TXBUF + offset);
208 for (i = 0; i < n; ++i)
209 mcfqspi_wr_qdr(mcfqspi, *txbuf++);
210 }
211 qwr = (offset ? 0x808 : 0) + ((n - 1) << 8);
212 offset ^= 8;
213 count -= n;
214 } while (count);
215 wait_event(mcfqspi->waitq, !mcfqspi_qdlyr_spe(mcfqspi));
216 mcfqspi_wr_qwr(mcfqspi, qwr);
217 mcfqspi_wr_qdlyr(mcfqspi, MCFQSPI_QDLYR_SPE);
218 if (rxbuf) {
219 mcfqspi_wr_qar(mcfqspi, MCFQSPI_QAR_RXBUF + offset);
220 for (i = 0; i < 8; ++i)
221 *rxbuf++ = mcfqspi_rd_qdr(mcfqspi);
222 offset ^= 8;
223 }
224 } else {
225 mcfqspi_wr_qwr(mcfqspi, (n - 1) << 8);
226 mcfqspi_wr_qdlyr(mcfqspi, MCFQSPI_QDLYR_SPE);
227 }
228 wait_event(mcfqspi->waitq, !mcfqspi_qdlyr_spe(mcfqspi));
229 if (rxbuf) {
230 mcfqspi_wr_qar(mcfqspi, MCFQSPI_QAR_RXBUF + offset);
231 for (i = 0; i < n; ++i)
232 *rxbuf++ = mcfqspi_rd_qdr(mcfqspi);
233 }
234 }
235
236 static void mcfqspi_transfer_msg16(struct mcfqspi *mcfqspi, unsigned count,
237 const u16 *txbuf, u16 *rxbuf)
238 {
239 unsigned i, n, offset = 0;
240
241 n = min(count, 16u);
242
243 mcfqspi_wr_qar(mcfqspi, MCFQSPI_QAR_CMDBUF);
244 for (i = 0; i < n; ++i)
245 mcfqspi_wr_qdr(mcfqspi, MCFQSPI_QCR_BITSE);
246
247 mcfqspi_wr_qar(mcfqspi, MCFQSPI_QAR_TXBUF);
248 if (txbuf)
249 for (i = 0; i < n; ++i)
250 mcfqspi_wr_qdr(mcfqspi, *txbuf++);
251 else
252 for (i = 0; i < count; ++i)
253 mcfqspi_wr_qdr(mcfqspi, 0);
254
255 count -= n;
256 if (count) {
257 u16 qwr = 0xf08;
258 mcfqspi_wr_qwr(mcfqspi, 0x700);
259 mcfqspi_wr_qdlyr(mcfqspi, MCFQSPI_QDLYR_SPE);
260
261 do {
262 wait_event(mcfqspi->waitq, !mcfqspi_qdlyr_spe(mcfqspi));
263 mcfqspi_wr_qwr(mcfqspi, qwr);
264 mcfqspi_wr_qdlyr(mcfqspi, MCFQSPI_QDLYR_SPE);
265 if (rxbuf) {
266 mcfqspi_wr_qar(mcfqspi,
267 MCFQSPI_QAR_RXBUF + offset);
268 for (i = 0; i < 8; ++i)
269 *rxbuf++ = mcfqspi_rd_qdr(mcfqspi);
270 }
271 n = min(count, 8u);
272 if (txbuf) {
273 mcfqspi_wr_qar(mcfqspi,
274 MCFQSPI_QAR_TXBUF + offset);
275 for (i = 0; i < n; ++i)
276 mcfqspi_wr_qdr(mcfqspi, *txbuf++);
277 }
278 qwr = (offset ? 0x808 : 0x000) + ((n - 1) << 8);
279 offset ^= 8;
280 count -= n;
281 } while (count);
282 wait_event(mcfqspi->waitq, !mcfqspi_qdlyr_spe(mcfqspi));
283 mcfqspi_wr_qwr(mcfqspi, qwr);
284 mcfqspi_wr_qdlyr(mcfqspi, MCFQSPI_QDLYR_SPE);
285 if (rxbuf) {
286 mcfqspi_wr_qar(mcfqspi, MCFQSPI_QAR_RXBUF + offset);
287 for (i = 0; i < 8; ++i)
288 *rxbuf++ = mcfqspi_rd_qdr(mcfqspi);
289 offset ^= 8;
290 }
291 } else {
292 mcfqspi_wr_qwr(mcfqspi, (n - 1) << 8);
293 mcfqspi_wr_qdlyr(mcfqspi, MCFQSPI_QDLYR_SPE);
294 }
295 wait_event(mcfqspi->waitq, !mcfqspi_qdlyr_spe(mcfqspi));
296 if (rxbuf) {
297 mcfqspi_wr_qar(mcfqspi, MCFQSPI_QAR_RXBUF + offset);
298 for (i = 0; i < n; ++i)
299 *rxbuf++ = mcfqspi_rd_qdr(mcfqspi);
300 }
301 }
302
303 static int mcfqspi_transfer_one_message(struct spi_master *master,
304 struct spi_message *msg)
305 {
306 struct mcfqspi *mcfqspi = spi_master_get_devdata(master);
307 struct spi_device *spi = msg->spi;
308 struct spi_transfer *t;
309 int status = 0;
310
311 list_for_each_entry(t, &msg->transfers, transfer_list) {
312 bool cs_high = spi->mode & SPI_CS_HIGH;
313 u16 qmr = MCFQSPI_QMR_MSTR;
314
315 qmr |= t->bits_per_word << 10;
316 if (spi->mode & SPI_CPHA)
317 qmr |= MCFQSPI_QMR_CPHA;
318 if (spi->mode & SPI_CPOL)
319 qmr |= MCFQSPI_QMR_CPOL;
320 if (t->speed_hz)
321 qmr |= mcfqspi_qmr_baud(t->speed_hz);
322 else
323 qmr |= mcfqspi_qmr_baud(spi->max_speed_hz);
324 mcfqspi_wr_qmr(mcfqspi, qmr);
325
326 mcfqspi_cs_select(mcfqspi, spi->chip_select, cs_high);
327
328 mcfqspi_wr_qir(mcfqspi, MCFQSPI_QIR_SPIFE);
329 if (t->bits_per_word == 8)
330 mcfqspi_transfer_msg8(mcfqspi, t->len, t->tx_buf,
331 t->rx_buf);
332 else
333 mcfqspi_transfer_msg16(mcfqspi, t->len / 2, t->tx_buf,
334 t->rx_buf);
335 mcfqspi_wr_qir(mcfqspi, 0);
336
337 if (t->delay_usecs)
338 udelay(t->delay_usecs);
339 if (t->cs_change) {
340 if (!list_is_last(&t->transfer_list, &msg->transfers))
341 mcfqspi_cs_deselect(mcfqspi, spi->chip_select,
342 cs_high);
343 } else {
344 if (list_is_last(&t->transfer_list, &msg->transfers))
345 mcfqspi_cs_deselect(mcfqspi, spi->chip_select,
346 cs_high);
347 }
348 msg->actual_length += t->len;
349 }
350 msg->status = status;
351 spi_finalize_current_message(master);
352
353 return status;
354
355 }
356
357 static int mcfqspi_prepare_transfer_hw(struct spi_master *master)
358 {
359 struct mcfqspi *mcfqspi = spi_master_get_devdata(master);
360
361 pm_runtime_get_sync(mcfqspi->dev);
362
363 return 0;
364 }
365
366 static int mcfqspi_unprepare_transfer_hw(struct spi_master *master)
367 {
368 struct mcfqspi *mcfqspi = spi_master_get_devdata(master);
369
370 pm_runtime_put_sync(mcfqspi->dev);
371
372 return 0;
373 }
374
375 static int mcfqspi_setup(struct spi_device *spi)
376 {
377 if (spi->chip_select >= spi->master->num_chipselect) {
378 dev_dbg(&spi->dev, "%d chip select is out of range\n",
379 spi->chip_select);
380 return -EINVAL;
381 }
382
383 mcfqspi_cs_deselect(spi_master_get_devdata(spi->master),
384 spi->chip_select, spi->mode & SPI_CS_HIGH);
385
386 dev_dbg(&spi->dev,
387 "bits per word %d, chip select %d, speed %d KHz\n",
388 spi->bits_per_word, spi->chip_select,
389 (MCFQSPI_BUSCLK / mcfqspi_qmr_baud(spi->max_speed_hz))
390 / 1000);
391
392 return 0;
393 }
394
395 static int mcfqspi_probe(struct platform_device *pdev)
396 {
397 struct spi_master *master;
398 struct mcfqspi *mcfqspi;
399 struct resource *res;
400 struct mcfqspi_platform_data *pdata;
401 int status;
402
403 pdata = pdev->dev.platform_data;
404 if (!pdata) {
405 dev_dbg(&pdev->dev, "platform data is missing\n");
406 return -ENOENT;
407 }
408
409 master = spi_alloc_master(&pdev->dev, sizeof(*mcfqspi));
410 if (master == NULL) {
411 dev_dbg(&pdev->dev, "spi_alloc_master failed\n");
412 return -ENOMEM;
413 }
414
415 mcfqspi = spi_master_get_devdata(master);
416
417 res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
418 if (!res) {
419 dev_dbg(&pdev->dev, "platform_get_resource failed\n");
420 status = -ENXIO;
421 goto fail0;
422 }
423
424 if (!request_mem_region(res->start, resource_size(res), pdev->name)) {
425 dev_dbg(&pdev->dev, "request_mem_region failed\n");
426 status = -EBUSY;
427 goto fail0;
428 }
429
430 mcfqspi->iobase = ioremap(res->start, resource_size(res));
431 if (!mcfqspi->iobase) {
432 dev_dbg(&pdev->dev, "ioremap failed\n");
433 status = -ENOMEM;
434 goto fail1;
435 }
436
437 mcfqspi->irq = platform_get_irq(pdev, 0);
438 if (mcfqspi->irq < 0) {
439 dev_dbg(&pdev->dev, "platform_get_irq failed\n");
440 status = -ENXIO;
441 goto fail2;
442 }
443
444 status = request_irq(mcfqspi->irq, mcfqspi_irq_handler, 0,
445 pdev->name, mcfqspi);
446 if (status) {
447 dev_dbg(&pdev->dev, "request_irq failed\n");
448 goto fail2;
449 }
450
451 mcfqspi->clk = clk_get(&pdev->dev, "qspi_clk");
452 if (IS_ERR(mcfqspi->clk)) {
453 dev_dbg(&pdev->dev, "clk_get failed\n");
454 status = PTR_ERR(mcfqspi->clk);
455 goto fail3;
456 }
457 clk_enable(mcfqspi->clk);
458
459 master->bus_num = pdata->bus_num;
460 master->num_chipselect = pdata->num_chipselect;
461
462 mcfqspi->cs_control = pdata->cs_control;
463 status = mcfqspi_cs_setup(mcfqspi);
464 if (status) {
465 dev_dbg(&pdev->dev, "error initializing cs_control\n");
466 goto fail4;
467 }
468
469 init_waitqueue_head(&mcfqspi->waitq);
470 mcfqspi->dev = &pdev->dev;
471
472 master->mode_bits = SPI_CS_HIGH | SPI_CPOL | SPI_CPHA;
473 master->bits_per_word_mask = SPI_BPW_RANGE_MASK(8, 16);
474 master->setup = mcfqspi_setup;
475 master->transfer_one_message = mcfqspi_transfer_one_message;
476 master->prepare_transfer_hardware = mcfqspi_prepare_transfer_hw;
477 master->unprepare_transfer_hardware = mcfqspi_unprepare_transfer_hw;
478
479 platform_set_drvdata(pdev, master);
480
481 status = spi_register_master(master);
482 if (status) {
483 dev_dbg(&pdev->dev, "spi_register_master failed\n");
484 goto fail5;
485 }
486 pm_runtime_enable(mcfqspi->dev);
487
488 dev_info(&pdev->dev, "Coldfire QSPI bus driver\n");
489
490 return 0;
491
492 fail5:
493 mcfqspi_cs_teardown(mcfqspi);
494 fail4:
495 clk_disable(mcfqspi->clk);
496 clk_put(mcfqspi->clk);
497 fail3:
498 free_irq(mcfqspi->irq, mcfqspi);
499 fail2:
500 iounmap(mcfqspi->iobase);
501 fail1:
502 release_mem_region(res->start, resource_size(res));
503 fail0:
504 spi_master_put(master);
505
506 dev_dbg(&pdev->dev, "Coldfire QSPI probe failed\n");
507
508 return status;
509 }
510
511 static int mcfqspi_remove(struct platform_device *pdev)
512 {
513 struct spi_master *master = platform_get_drvdata(pdev);
514 struct mcfqspi *mcfqspi = spi_master_get_devdata(master);
515 struct resource *res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
516
517 pm_runtime_disable(mcfqspi->dev);
518 /* disable the hardware (set the baud rate to 0) */
519 mcfqspi_wr_qmr(mcfqspi, MCFQSPI_QMR_MSTR);
520
521 mcfqspi_cs_teardown(mcfqspi);
522 clk_disable(mcfqspi->clk);
523 clk_put(mcfqspi->clk);
524 free_irq(mcfqspi->irq, mcfqspi);
525 iounmap(mcfqspi->iobase);
526 release_mem_region(res->start, resource_size(res));
527 spi_unregister_master(master);
528
529 return 0;
530 }
531
532 #ifdef CONFIG_PM_SLEEP
533 static int mcfqspi_suspend(struct device *dev)
534 {
535 struct spi_master *master = dev_get_drvdata(dev);
536 struct mcfqspi *mcfqspi = spi_master_get_devdata(master);
537
538 spi_master_suspend(master);
539
540 clk_disable(mcfqspi->clk);
541
542 return 0;
543 }
544
545 static int mcfqspi_resume(struct device *dev)
546 {
547 struct spi_master *master = dev_get_drvdata(dev);
548 struct mcfqspi *mcfqspi = spi_master_get_devdata(master);
549
550 spi_master_resume(master);
551
552 clk_enable(mcfqspi->clk);
553
554 return 0;
555 }
556 #endif
557
558 #ifdef CONFIG_PM_RUNTIME
559 static int mcfqspi_runtime_suspend(struct device *dev)
560 {
561 struct mcfqspi *mcfqspi = platform_get_drvdata(to_platform_device(dev));
562
563 clk_disable(mcfqspi->clk);
564
565 return 0;
566 }
567
568 static int mcfqspi_runtime_resume(struct device *dev)
569 {
570 struct mcfqspi *mcfqspi = platform_get_drvdata(to_platform_device(dev));
571
572 clk_enable(mcfqspi->clk);
573
574 return 0;
575 }
576 #endif
577
578 static const struct dev_pm_ops mcfqspi_pm = {
579 SET_SYSTEM_SLEEP_PM_OPS(mcfqspi_suspend, mcfqspi_resume)
580 SET_RUNTIME_PM_OPS(mcfqspi_runtime_suspend, mcfqspi_runtime_resume,
581 NULL)
582 };
583
584 static struct platform_driver mcfqspi_driver = {
585 .driver.name = DRIVER_NAME,
586 .driver.owner = THIS_MODULE,
587 .driver.pm = &mcfqspi_pm,
588 .probe = mcfqspi_probe,
589 .remove = mcfqspi_remove,
590 };
591 module_platform_driver(mcfqspi_driver);
592
593 MODULE_AUTHOR("Steven King <sfking@fdwdc.com>");
594 MODULE_DESCRIPTION("Coldfire QSPI Controller Driver");
595 MODULE_LICENSE("GPL");
596 MODULE_ALIAS("platform:" DRIVER_NAME);
Linux kernel - Deliverables
This page took 0.050434 seconds and 5 git commands to generate.