2 * CARMA Board DATA-FPGA Programmer
4 * Copyright (c) 2009-2011 Ira W. Snyder <iws@ovro.caltech.edu>
6 * This program is free software; you can redistribute it and/or modify it
7 * under the terms of the GNU General Public License as published by the
8 * Free Software Foundation; either version 2 of the License, or (at your
9 * option) any later version.
12 #include <linux/dma-mapping.h>
13 #include <linux/of_address.h>
14 #include <linux/of_irq.h>
15 #include <linux/of_platform.h>
16 #include <linux/completion.h>
17 #include <linux/miscdevice.h>
18 #include <linux/dmaengine.h>
19 #include <linux/interrupt.h>
20 #include <linux/highmem.h>
21 #include <linux/kernel.h>
22 #include <linux/module.h>
23 #include <linux/mutex.h>
24 #include <linux/delay.h>
25 #include <linux/init.h>
26 #include <linux/leds.h>
27 #include <linux/slab.h>
28 #include <linux/kref.h>
32 #include <media/videobuf-dma-sg.h>
34 /* MPC8349EMDS specific get_immrbase() */
35 #include <sysdev/fsl_soc.h>
37 static const char drv_name
[] = "carma-fpga-program";
40 * Firmware images are always this exact size
42 * 12849552 bytes for a CARMA Digitizer Board (EP2S90 FPGAs)
43 * 18662880 bytes for a CARMA Correlator Board (EP2S130 FPGAs)
45 #define FW_SIZE_EP2S90 12849552
46 #define FW_SIZE_EP2S130 18662880
49 struct miscdevice miscdev
;
54 /* Device Registers */
59 /* Freescale DMA Device */
60 struct dma_chan
*chan
;
64 struct completion completion
;
69 struct videobuf_dmabuf vb
;
72 /* max size and written bytes */
78 * FPGA Bitfile Helpers
82 * fpga_drop_firmware_data() - drop the bitfile image from memory
83 * @priv: the driver's private data structure
85 * LOCKING: must hold priv->lock
87 static void fpga_drop_firmware_data(struct fpga_dev
*priv
)
89 videobuf_dma_free(&priv
->vb
);
90 priv
->vb_allocated
= false;
95 * Private Data Reference Count
98 static void fpga_dev_remove(struct kref
*ref
)
100 struct fpga_dev
*priv
= container_of(ref
, struct fpga_dev
, ref
);
102 /* free any firmware image that was not programmed */
103 fpga_drop_firmware_data(priv
);
105 mutex_destroy(&priv
->lock
);
110 * LED Trigger (could be a seperate module)
114 * NOTE: this whole thing does have the problem that whenever the led's are
115 * NOTE: first set to use the fpga trigger, they could be in the wrong state
118 DEFINE_LED_TRIGGER(ledtrig_fpga
);
120 static void ledtrig_fpga_programmed(bool enabled
)
123 led_trigger_event(ledtrig_fpga
, LED_FULL
);
125 led_trigger_event(ledtrig_fpga
, LED_OFF
);
129 * FPGA Register Helpers
132 /* Register Definitions */
133 #define FPGA_CONFIG_CONTROL 0x40
134 #define FPGA_CONFIG_STATUS 0x44
135 #define FPGA_CONFIG_FIFO_SIZE 0x48
136 #define FPGA_CONFIG_FIFO_USED 0x4C
137 #define FPGA_CONFIG_TOTAL_BYTE_COUNT 0x50
138 #define FPGA_CONFIG_CUR_BYTE_COUNT 0x54
140 #define FPGA_FIFO_ADDRESS 0x3000
142 static int fpga_fifo_size(void __iomem
*regs
)
144 return ioread32be(regs
+ FPGA_CONFIG_FIFO_SIZE
);
147 #define CFG_STATUS_ERR_MASK 0xfffe
149 static int fpga_config_error(void __iomem
*regs
)
151 return ioread32be(regs
+ FPGA_CONFIG_STATUS
) & CFG_STATUS_ERR_MASK
;
154 static int fpga_fifo_empty(void __iomem
*regs
)
156 return ioread32be(regs
+ FPGA_CONFIG_FIFO_USED
) == 0;
159 static void fpga_fifo_write(void __iomem
*regs
, u32 val
)
161 iowrite32be(val
, regs
+ FPGA_FIFO_ADDRESS
);
164 static void fpga_set_byte_count(void __iomem
*regs
, u32 count
)
166 iowrite32be(count
, regs
+ FPGA_CONFIG_TOTAL_BYTE_COUNT
);
169 #define CFG_CTL_ENABLE (1 << 0)
170 #define CFG_CTL_RESET (1 << 1)
171 #define CFG_CTL_DMA (1 << 2)
173 static void fpga_programmer_enable(struct fpga_dev
*priv
, bool dma
)
177 val
= (dma
) ? (CFG_CTL_ENABLE
| CFG_CTL_DMA
) : CFG_CTL_ENABLE
;
178 iowrite32be(val
, priv
->regs
+ FPGA_CONFIG_CONTROL
);
181 static void fpga_programmer_disable(struct fpga_dev
*priv
)
183 iowrite32be(0x0, priv
->regs
+ FPGA_CONFIG_CONTROL
);
186 static void fpga_dump_registers(struct fpga_dev
*priv
)
188 u32 control
, status
, size
, used
, total
, curr
;
190 /* good status: do nothing */
191 if (priv
->status
== 0)
194 /* Dump all status registers */
195 control
= ioread32be(priv
->regs
+ FPGA_CONFIG_CONTROL
);
196 status
= ioread32be(priv
->regs
+ FPGA_CONFIG_STATUS
);
197 size
= ioread32be(priv
->regs
+ FPGA_CONFIG_FIFO_SIZE
);
198 used
= ioread32be(priv
->regs
+ FPGA_CONFIG_FIFO_USED
);
199 total
= ioread32be(priv
->regs
+ FPGA_CONFIG_TOTAL_BYTE_COUNT
);
200 curr
= ioread32be(priv
->regs
+ FPGA_CONFIG_CUR_BYTE_COUNT
);
202 dev_err(priv
->dev
, "Configuration failed, dumping status registers\n");
203 dev_err(priv
->dev
, "Control: 0x%.8x\n", control
);
204 dev_err(priv
->dev
, "Status: 0x%.8x\n", status
);
205 dev_err(priv
->dev
, "FIFO Size: 0x%.8x\n", size
);
206 dev_err(priv
->dev
, "FIFO Used: 0x%.8x\n", used
);
207 dev_err(priv
->dev
, "FIFO Total: 0x%.8x\n", total
);
208 dev_err(priv
->dev
, "FIFO Curr: 0x%.8x\n", curr
);
212 * FPGA Power Supply Code
215 #define CTL_PWR_CONTROL 0x2006
216 #define CTL_PWR_STATUS 0x200A
217 #define CTL_PWR_FAIL 0x200B
219 #define PWR_CONTROL_ENABLE 0x01
221 #define PWR_STATUS_ERROR_MASK 0x10
222 #define PWR_STATUS_GOOD 0x0f
225 * Determine if the FPGA power is good for all supplies
227 static bool fpga_power_good(struct fpga_dev
*priv
)
231 val
= ioread8(priv
->regs
+ CTL_PWR_STATUS
);
232 if (val
& PWR_STATUS_ERROR_MASK
)
235 return val
== PWR_STATUS_GOOD
;
239 * Disable the FPGA power supplies
241 static void fpga_disable_power_supplies(struct fpga_dev
*priv
)
246 iowrite8(0x0, priv
->regs
+ CTL_PWR_CONTROL
);
249 * Wait 500ms for the power rails to discharge
251 * Without this delay, the CTL-CPLD state machine can get into a
252 * state where it is waiting for the power-goods to assert, but they
253 * never do. This only happens when enabling and disabling the
254 * power sequencer very rapidly.
256 * The loop below will also wait for the power goods to de-assert,
257 * but testing has shown that they are always disabled by the time
258 * the sleep completes. However, omitting the sleep and only waiting
259 * for the power-goods to de-assert was not sufficient to ensure
260 * that the power sequencer would not wedge itself.
265 while (time_before(jiffies
, start
+ HZ
)) {
266 val
= ioread8(priv
->regs
+ CTL_PWR_STATUS
);
267 if (!(val
& PWR_STATUS_GOOD
))
270 usleep_range(5000, 10000);
273 val
= ioread8(priv
->regs
+ CTL_PWR_STATUS
);
274 if (val
& PWR_STATUS_GOOD
) {
275 dev_err(priv
->dev
, "power disable failed: "
276 "power goods: status 0x%.2x\n", val
);
279 if (val
& PWR_STATUS_ERROR_MASK
) {
280 dev_err(priv
->dev
, "power disable failed: "
281 "alarm bit set: status 0x%.2x\n", val
);
286 * fpga_enable_power_supplies() - enable the DATA-FPGA power supplies
287 * @priv: the driver's private data structure
289 * Enable the DATA-FPGA power supplies, waiting up to 1 second for
290 * them to enable successfully.
292 * Returns 0 on success, -ERRNO otherwise
294 static int fpga_enable_power_supplies(struct fpga_dev
*priv
)
296 unsigned long start
= jiffies
;
298 if (fpga_power_good(priv
)) {
299 dev_dbg(priv
->dev
, "power was already good\n");
303 iowrite8(PWR_CONTROL_ENABLE
, priv
->regs
+ CTL_PWR_CONTROL
);
304 while (time_before(jiffies
, start
+ HZ
)) {
305 if (fpga_power_good(priv
))
308 usleep_range(5000, 10000);
311 return fpga_power_good(priv
) ? 0 : -ETIMEDOUT
;
315 * Determine if the FPGA power supplies are all enabled
317 static bool fpga_power_enabled(struct fpga_dev
*priv
)
321 val
= ioread8(priv
->regs
+ CTL_PWR_CONTROL
);
322 if (val
& PWR_CONTROL_ENABLE
)
329 * Determine if the FPGA's are programmed and running correctly
331 static bool fpga_running(struct fpga_dev
*priv
)
333 if (!fpga_power_good(priv
))
336 /* Check the config done bit */
337 return ioread32be(priv
->regs
+ FPGA_CONFIG_STATUS
) & (1 << 18);
341 * FPGA Programming Code
345 * fpga_program_block() - put a block of data into the programmer's FIFO
346 * @priv: the driver's private data structure
347 * @buf: the data to program
348 * @count: the length of data to program (must be a multiple of 4 bytes)
350 * Returns 0 on success, -ERRNO otherwise
352 static int fpga_program_block(struct fpga_dev
*priv
, void *buf
, size_t count
)
355 int size
= fpga_fifo_size(priv
->regs
);
357 unsigned long timeout
;
359 /* enforce correct data length for the FIFO */
360 BUG_ON(count
% 4 != 0);
364 /* Get the size of the block to write (maximum is FIFO_SIZE) */
365 len
= min_t(size_t, count
, size
);
366 timeout
= jiffies
+ HZ
/ 4;
368 /* Write the block */
369 for (i
= 0; i
< len
/ 4; i
++)
370 fpga_fifo_write(priv
->regs
, data
[i
]);
372 /* Update the amounts left */
376 /* Wait for the fifo to empty */
379 if (fpga_fifo_empty(priv
->regs
)) {
382 dev_dbg(priv
->dev
, "Fifo not empty\n");
386 if (fpga_config_error(priv
->regs
)) {
387 dev_err(priv
->dev
, "Error detected\n");
391 if (time_after(jiffies
, timeout
)) {
392 dev_err(priv
->dev
, "Fifo drain timeout\n");
396 usleep_range(5000, 10000);
404 * fpga_program_cpu() - program the DATA-FPGA's using the CPU
405 * @priv: the driver's private data structure
407 * This is useful when the DMA programming method fails. It is possible to
408 * wedge the Freescale DMA controller such that the DMA programming method
409 * always fails. This method has always succeeded.
411 * Returns 0 on success, -ERRNO otherwise
413 static noinline
int fpga_program_cpu(struct fpga_dev
*priv
)
417 /* Disable the programmer */
418 fpga_programmer_disable(priv
);
420 /* Set the total byte count */
421 fpga_set_byte_count(priv
->regs
, priv
->bytes
);
422 dev_dbg(priv
->dev
, "total byte count %u bytes\n", priv
->bytes
);
424 /* Enable the controller for programming */
425 fpga_programmer_enable(priv
, false);
426 dev_dbg(priv
->dev
, "enabled the controller\n");
428 /* Write each chunk of the FPGA bitfile to FPGA programmer */
429 ret
= fpga_program_block(priv
, priv
->vb
.vaddr
, priv
->bytes
);
431 goto out_disable_controller
;
433 /* Wait for the interrupt handler to signal that programming finished */
434 ret
= wait_for_completion_timeout(&priv
->completion
, 2 * HZ
);
436 dev_err(priv
->dev
, "Timed out waiting for completion\n");
438 goto out_disable_controller
;
441 /* Retrieve the status from the interrupt handler */
444 out_disable_controller
:
445 fpga_programmer_disable(priv
);
449 #define FIFO_DMA_ADDRESS 0xf0003000
450 #define FIFO_MAX_LEN 4096
453 * fpga_program_dma() - program the DATA-FPGA's using the DMA engine
454 * @priv: the driver's private data structure
456 * Program the DATA-FPGA's using the Freescale DMA engine. This requires that
457 * the engine is programmed such that the hardware DMA request lines can
458 * control the entire DMA transaction. The system controller FPGA then
459 * completely offloads the programming from the CPU.
461 * Returns 0 on success, -ERRNO otherwise
463 static noinline
int fpga_program_dma(struct fpga_dev
*priv
)
465 struct videobuf_dmabuf
*vb
= &priv
->vb
;
466 struct dma_chan
*chan
= priv
->chan
;
467 struct dma_async_tx_descriptor
*tx
;
468 size_t num_pages
, len
, avail
= 0;
469 struct dma_slave_config config
;
470 struct scatterlist
*sg
;
471 struct sg_table table
;
475 /* Disable the programmer */
476 fpga_programmer_disable(priv
);
478 /* Allocate a scatterlist for the DMA destination */
479 num_pages
= DIV_ROUND_UP(priv
->bytes
, FIFO_MAX_LEN
);
480 ret
= sg_alloc_table(&table
, num_pages
, GFP_KERNEL
);
482 dev_err(priv
->dev
, "Unable to allocate dst scatterlist\n");
488 * This is an ugly hack
490 * We fill in a scatterlist as if it were mapped for DMA. This is
491 * necessary because there exists no better structure for this
492 * inside the kernel code.
494 * As an added bonus, we can use the DMAEngine API for all of this,
495 * rather than inventing another extremely similar API.
498 for_each_sg(table
.sgl
, sg
, num_pages
, i
) {
499 len
= min_t(size_t, avail
, FIFO_MAX_LEN
);
500 sg_dma_address(sg
) = FIFO_DMA_ADDRESS
;
501 sg_dma_len(sg
) = len
;
506 /* Map the buffer for DMA */
507 ret
= videobuf_dma_map(priv
->dev
, &priv
->vb
);
509 dev_err(priv
->dev
, "Unable to map buffer for DMA\n");
514 * Configure the DMA channel to transfer FIFO_SIZE / 2 bytes per
515 * transaction, and then put it under external control
517 memset(&config
, 0, sizeof(config
));
518 config
.direction
= DMA_MEM_TO_DEV
;
519 config
.dst_addr_width
= DMA_SLAVE_BUSWIDTH_4_BYTES
;
520 config
.dst_maxburst
= fpga_fifo_size(priv
->regs
) / 2 / 4;
521 ret
= chan
->device
->device_control(chan
, DMA_SLAVE_CONFIG
,
522 (unsigned long)&config
);
524 dev_err(priv
->dev
, "DMA slave configuration failed\n");
528 ret
= chan
->device
->device_control(chan
, FSLDMA_EXTERNAL_START
, 1);
530 dev_err(priv
->dev
, "DMA external control setup failed\n");
534 /* setup and submit the DMA transaction */
535 tx
= chan
->device
->device_prep_dma_sg(chan
,
536 table
.sgl
, num_pages
,
537 vb
->sglist
, vb
->sglen
, 0);
539 dev_err(priv
->dev
, "Unable to prep DMA transaction\n");
544 cookie
= tx
->tx_submit(tx
);
545 if (dma_submit_error(cookie
)) {
546 dev_err(priv
->dev
, "Unable to submit DMA transaction\n");
551 dma_async_issue_pending(chan
);
553 /* Set the total byte count */
554 fpga_set_byte_count(priv
->regs
, priv
->bytes
);
555 dev_dbg(priv
->dev
, "total byte count %u bytes\n", priv
->bytes
);
557 /* Enable the controller for DMA programming */
558 fpga_programmer_enable(priv
, true);
559 dev_dbg(priv
->dev
, "enabled the controller\n");
561 /* Wait for the interrupt handler to signal that programming finished */
562 ret
= wait_for_completion_timeout(&priv
->completion
, 2 * HZ
);
564 dev_err(priv
->dev
, "Timed out waiting for completion\n");
566 goto out_disable_controller
;
569 /* Retrieve the status from the interrupt handler */
572 out_disable_controller
:
573 fpga_programmer_disable(priv
);
575 videobuf_dma_unmap(priv
->dev
, vb
);
577 sg_free_table(&table
);
586 static irqreturn_t
fpga_irq(int irq
, void *dev_id
)
588 struct fpga_dev
*priv
= dev_id
;
590 /* Save the status */
591 priv
->status
= fpga_config_error(priv
->regs
) ? -EIO
: 0;
592 dev_dbg(priv
->dev
, "INTERRUPT status %d\n", priv
->status
);
593 fpga_dump_registers(priv
);
595 /* Disabling the programmer clears the interrupt */
596 fpga_programmer_disable(priv
);
598 /* Notify any waiters */
599 complete(&priv
->completion
);
609 * fpga_do_stop() - deconfigure (reset) the DATA-FPGA's
610 * @priv: the driver's private data structure
612 * LOCKING: must hold priv->lock
614 static int fpga_do_stop(struct fpga_dev
*priv
)
618 /* Set the led to unprogrammed */
619 ledtrig_fpga_programmed(false);
621 /* Pulse the config line to reset the FPGA's */
622 val
= CFG_CTL_ENABLE
| CFG_CTL_RESET
;
623 iowrite32be(val
, priv
->regs
+ FPGA_CONFIG_CONTROL
);
624 iowrite32be(0x0, priv
->regs
+ FPGA_CONFIG_CONTROL
);
629 static noinline
int fpga_do_program(struct fpga_dev
*priv
)
633 if (priv
->bytes
!= priv
->fw_size
) {
634 dev_err(priv
->dev
, "Incorrect bitfile size: got %zu bytes, "
635 "should be %zu bytes\n",
636 priv
->bytes
, priv
->fw_size
);
640 if (!fpga_power_enabled(priv
)) {
641 dev_err(priv
->dev
, "Power not enabled\n");
645 if (!fpga_power_good(priv
)) {
646 dev_err(priv
->dev
, "Power not good\n");
650 /* Set the LED to unprogrammed */
651 ledtrig_fpga_programmed(false);
653 /* Try to program the FPGA's using DMA */
654 ret
= fpga_program_dma(priv
);
656 /* If DMA failed or doesn't exist, try with CPU */
658 dev_warn(priv
->dev
, "Falling back to CPU programming\n");
659 ret
= fpga_program_cpu(priv
);
663 dev_err(priv
->dev
, "Unable to program FPGA's\n");
667 /* Drop the firmware bitfile from memory */
668 fpga_drop_firmware_data(priv
);
670 dev_dbg(priv
->dev
, "FPGA programming successful\n");
671 ledtrig_fpga_programmed(true);
680 static int fpga_open(struct inode
*inode
, struct file
*filp
)
683 * The miscdevice layer puts our struct miscdevice into the
684 * filp->private_data field. We use this to find our private
685 * data and then overwrite it with our own private structure.
687 struct fpga_dev
*priv
= container_of(filp
->private_data
,
688 struct fpga_dev
, miscdev
);
689 unsigned int nr_pages
;
692 /* We only allow one process at a time */
693 ret
= mutex_lock_interruptible(&priv
->lock
);
697 filp
->private_data
= priv
;
698 kref_get(&priv
->ref
);
700 /* Truncation: drop any existing data */
701 if (filp
->f_flags
& O_TRUNC
)
704 /* Check if we have already allocated a buffer */
705 if (priv
->vb_allocated
)
708 /* Allocate a buffer to hold enough data for the bitfile */
709 nr_pages
= DIV_ROUND_UP(priv
->fw_size
, PAGE_SIZE
);
710 ret
= videobuf_dma_init_kernel(&priv
->vb
, DMA_TO_DEVICE
, nr_pages
);
712 dev_err(priv
->dev
, "unable to allocate data buffer\n");
713 mutex_unlock(&priv
->lock
);
714 kref_put(&priv
->ref
, fpga_dev_remove
);
718 priv
->vb_allocated
= true;
722 static int fpga_release(struct inode
*inode
, struct file
*filp
)
724 struct fpga_dev
*priv
= filp
->private_data
;
726 mutex_unlock(&priv
->lock
);
727 kref_put(&priv
->ref
, fpga_dev_remove
);
731 static ssize_t
fpga_write(struct file
*filp
, const char __user
*buf
,
732 size_t count
, loff_t
*f_pos
)
734 struct fpga_dev
*priv
= filp
->private_data
;
736 /* FPGA bitfiles have an exact size: disallow anything else */
737 if (priv
->bytes
>= priv
->fw_size
)
740 count
= min_t(size_t, priv
->fw_size
- priv
->bytes
, count
);
741 if (copy_from_user(priv
->vb
.vaddr
+ priv
->bytes
, buf
, count
))
744 priv
->bytes
+= count
;
748 static ssize_t
fpga_read(struct file
*filp
, char __user
*buf
, size_t count
,
751 struct fpga_dev
*priv
= filp
->private_data
;
753 count
= min_t(size_t, priv
->bytes
- *f_pos
, count
);
754 if (copy_to_user(buf
, priv
->vb
.vaddr
+ *f_pos
, count
))
761 static loff_t
fpga_llseek(struct file
*filp
, loff_t offset
, int origin
)
763 struct fpga_dev
*priv
= filp
->private_data
;
766 /* only read-only opens are allowed to seek */
767 if ((filp
->f_flags
& O_ACCMODE
) != O_RDONLY
)
771 case SEEK_SET
: /* seek relative to the beginning of the file */
774 case SEEK_CUR
: /* seek relative to current position in the file */
775 newpos
= filp
->f_pos
+ offset
;
777 case SEEK_END
: /* seek relative to the end of the file */
778 newpos
= priv
->fw_size
- offset
;
784 /* check for sanity */
785 if (newpos
> priv
->fw_size
)
788 filp
->f_pos
= newpos
;
792 static const struct file_operations fpga_fops
= {
794 .release
= fpga_release
,
797 .llseek
= fpga_llseek
,
804 static ssize_t
pfail_show(struct device
*dev
, struct device_attribute
*attr
,
807 struct fpga_dev
*priv
= dev_get_drvdata(dev
);
810 val
= ioread8(priv
->regs
+ CTL_PWR_FAIL
);
811 return snprintf(buf
, PAGE_SIZE
, "0x%.2x\n", val
);
814 static ssize_t
pgood_show(struct device
*dev
, struct device_attribute
*attr
,
817 struct fpga_dev
*priv
= dev_get_drvdata(dev
);
818 return snprintf(buf
, PAGE_SIZE
, "%d\n", fpga_power_good(priv
));
821 static ssize_t
penable_show(struct device
*dev
, struct device_attribute
*attr
,
824 struct fpga_dev
*priv
= dev_get_drvdata(dev
);
825 return snprintf(buf
, PAGE_SIZE
, "%d\n", fpga_power_enabled(priv
));
828 static ssize_t
penable_store(struct device
*dev
, struct device_attribute
*attr
,
829 const char *buf
, size_t count
)
831 struct fpga_dev
*priv
= dev_get_drvdata(dev
);
835 ret
= kstrtoul(buf
, 0, &val
);
840 ret
= fpga_enable_power_supplies(priv
);
845 fpga_disable_power_supplies(priv
);
851 static ssize_t
program_show(struct device
*dev
, struct device_attribute
*attr
,
854 struct fpga_dev
*priv
= dev_get_drvdata(dev
);
855 return snprintf(buf
, PAGE_SIZE
, "%d\n", fpga_running(priv
));
858 static ssize_t
program_store(struct device
*dev
, struct device_attribute
*attr
,
859 const char *buf
, size_t count
)
861 struct fpga_dev
*priv
= dev_get_drvdata(dev
);
865 ret
= kstrtoul(buf
, 0, &val
);
869 /* We can't have an image writer and be programming simultaneously */
870 if (mutex_lock_interruptible(&priv
->lock
))
873 /* Program or Reset the FPGA's */
874 ret
= val
? fpga_do_program(priv
) : fpga_do_stop(priv
);
882 mutex_unlock(&priv
->lock
);
886 static DEVICE_ATTR(power_fail
, S_IRUGO
, pfail_show
, NULL
);
887 static DEVICE_ATTR(power_good
, S_IRUGO
, pgood_show
, NULL
);
888 static DEVICE_ATTR(power_enable
, S_IRUGO
| S_IWUSR
,
889 penable_show
, penable_store
);
891 static DEVICE_ATTR(program
, S_IRUGO
| S_IWUSR
,
892 program_show
, program_store
);
894 static struct attribute
*fpga_attributes
[] = {
895 &dev_attr_power_fail
.attr
,
896 &dev_attr_power_good
.attr
,
897 &dev_attr_power_enable
.attr
,
898 &dev_attr_program
.attr
,
902 static const struct attribute_group fpga_attr_group
= {
903 .attrs
= fpga_attributes
,
907 * OpenFirmware Device Subsystem
910 #define SYS_REG_VERSION 0x00
911 #define SYS_REG_GEOGRAPHIC 0x10
913 static bool dma_filter(struct dma_chan
*chan
, void *data
)
916 * DMA Channel #0 is the only acceptable device
918 * This probably won't survive an unload/load cycle of the Freescale
919 * DMAEngine driver, but that won't be a problem
921 return chan
->chan_id
== 0 && chan
->device
->dev_id
== 0;
924 static int fpga_of_remove(struct platform_device
*op
)
926 struct fpga_dev
*priv
= platform_get_drvdata(op
);
927 struct device
*this_device
= priv
->miscdev
.this_device
;
929 sysfs_remove_group(&this_device
->kobj
, &fpga_attr_group
);
930 misc_deregister(&priv
->miscdev
);
932 free_irq(priv
->irq
, priv
);
933 irq_dispose_mapping(priv
->irq
);
935 /* make sure the power supplies are off */
936 fpga_disable_power_supplies(priv
);
938 /* unmap registers */
942 dma_release_channel(priv
->chan
);
944 /* drop our reference to the private data structure */
945 kref_put(&priv
->ref
, fpga_dev_remove
);
949 /* CTL-CPLD Version Register */
950 #define CTL_CPLD_VERSION 0x2000
952 static int fpga_of_probe(struct platform_device
*op
)
954 struct device_node
*of_node
= op
->dev
.of_node
;
955 struct device
*this_device
;
956 struct fpga_dev
*priv
;
961 /* Allocate private data */
962 priv
= kzalloc(sizeof(*priv
), GFP_KERNEL
);
964 dev_err(&op
->dev
, "Unable to allocate private data\n");
969 /* Setup the miscdevice */
970 priv
->miscdev
.minor
= MISC_DYNAMIC_MINOR
;
971 priv
->miscdev
.name
= drv_name
;
972 priv
->miscdev
.fops
= &fpga_fops
;
974 kref_init(&priv
->ref
);
976 platform_set_drvdata(op
, priv
);
977 priv
->dev
= &op
->dev
;
978 mutex_init(&priv
->lock
);
979 init_completion(&priv
->completion
);
980 videobuf_dma_init(&priv
->vb
);
982 dev_set_drvdata(priv
->dev
, priv
);
984 dma_cap_set(DMA_MEMCPY
, mask
);
985 dma_cap_set(DMA_SLAVE
, mask
);
986 dma_cap_set(DMA_SG
, mask
);
988 /* Get control of DMA channel #0 */
989 priv
->chan
= dma_request_channel(mask
, dma_filter
, NULL
);
991 dev_err(&op
->dev
, "Unable to acquire DMA channel #0\n");
996 /* Remap the registers for use */
997 priv
->regs
= of_iomap(of_node
, 0);
999 dev_err(&op
->dev
, "Unable to ioremap registers\n");
1001 goto out_dma_release_channel
;
1004 /* Remap the IMMR for use */
1005 priv
->immr
= ioremap(get_immrbase(), 0x100000);
1007 dev_err(&op
->dev
, "Unable to ioremap IMMR\n");
1009 goto out_unmap_regs
;
1013 * Check that external DMA is configured
1015 * U-Boot does this for us, but we should check it and bail out if
1016 * there is a problem. Failing to have this register setup correctly
1017 * will cause the DMA controller to transfer a single cacheline
1018 * worth of data, then wedge itself.
1020 if ((ioread32be(priv
->immr
+ 0x114) & 0xE00) != 0xE00) {
1021 dev_err(&op
->dev
, "External DMA control not configured\n");
1023 goto out_unmap_immr
;
1027 * Check the CTL-CPLD version
1029 * This driver uses the CTL-CPLD DATA-FPGA power sequencer, and we
1030 * don't want to run on any version of the CTL-CPLD that does not use
1031 * a compatible register layout.
1033 * v2: changed register layout, added power sequencer
1034 * v3: added glitch filter on the i2c overcurrent/overtemp outputs
1036 ver
= ioread8(priv
->regs
+ CTL_CPLD_VERSION
);
1037 if (ver
!= 0x02 && ver
!= 0x03) {
1038 dev_err(&op
->dev
, "CTL-CPLD is not version 0x02 or 0x03!\n");
1040 goto out_unmap_immr
;
1043 /* Set the exact size that the firmware image should be */
1044 ver
= ioread32be(priv
->regs
+ SYS_REG_VERSION
);
1045 priv
->fw_size
= (ver
& (1 << 18)) ? FW_SIZE_EP2S130
: FW_SIZE_EP2S90
;
1047 /* Find the correct IRQ number */
1048 priv
->irq
= irq_of_parse_and_map(of_node
, 0);
1049 if (priv
->irq
== NO_IRQ
) {
1050 dev_err(&op
->dev
, "Unable to find IRQ line\n");
1052 goto out_unmap_immr
;
1055 /* Request the IRQ */
1056 ret
= request_irq(priv
->irq
, fpga_irq
, IRQF_SHARED
, drv_name
, priv
);
1058 dev_err(&op
->dev
, "Unable to request IRQ %d\n", priv
->irq
);
1060 goto out_irq_dispose_mapping
;
1063 /* Reset and stop the FPGA's, just in case */
1066 /* Register the miscdevice */
1067 ret
= misc_register(&priv
->miscdev
);
1069 dev_err(&op
->dev
, "Unable to register miscdevice\n");
1073 /* Create the sysfs files */
1074 this_device
= priv
->miscdev
.this_device
;
1075 dev_set_drvdata(this_device
, priv
);
1076 ret
= sysfs_create_group(&this_device
->kobj
, &fpga_attr_group
);
1078 dev_err(&op
->dev
, "Unable to create sysfs files\n");
1079 goto out_misc_deregister
;
1082 dev_info(priv
->dev
, "CARMA FPGA Programmer: %s rev%s with %s FPGAs\n",
1083 (ver
& (1 << 17)) ? "Correlator" : "Digitizer",
1084 (ver
& (1 << 16)) ? "B" : "A",
1085 (ver
& (1 << 18)) ? "EP2S130" : "EP2S90");
1089 out_misc_deregister
:
1090 misc_deregister(&priv
->miscdev
);
1092 free_irq(priv
->irq
, priv
);
1093 out_irq_dispose_mapping
:
1094 irq_dispose_mapping(priv
->irq
);
1096 iounmap(priv
->immr
);
1098 iounmap(priv
->regs
);
1099 out_dma_release_channel
:
1100 dma_release_channel(priv
->chan
);
1102 kref_put(&priv
->ref
, fpga_dev_remove
);
1107 static struct of_device_id fpga_of_match
[] = {
1108 { .compatible
= "carma,fpga-programmer", },
1112 static struct platform_driver fpga_of_driver
= {
1113 .probe
= fpga_of_probe
,
1114 .remove
= fpga_of_remove
,
1117 .of_match_table
= fpga_of_match
,
1118 .owner
= THIS_MODULE
,
1123 * Module Init / Exit
1126 static int __init
fpga_init(void)
1128 led_trigger_register_simple("fpga", &ledtrig_fpga
);
1129 return platform_driver_register(&fpga_of_driver
);
1132 static void __exit
fpga_exit(void)
1134 platform_driver_unregister(&fpga_of_driver
);
1135 led_trigger_unregister_simple(ledtrig_fpga
);
1138 MODULE_AUTHOR("Ira W. Snyder <iws@ovro.caltech.edu>");
1139 MODULE_DESCRIPTION("CARMA Board DATA-FPGA Programmer");
1140 MODULE_LICENSE("GPL");
1142 module_init(fpga_init
);
1143 module_exit(fpga_exit
);