1 // SPDX-License-Identifier: GPL-2.0
3 * Xilinx AXIS FIFO: interface to the Xilinx AXI-Stream FIFO IP core
5 * Copyright (C) 2018 Jacob Feder
7 * Authors: Jacob Feder <jacobsfeder@gmail.com>
9 * See Xilinx PG080 document for IP details
12 /* ----------------------------
14 * ----------------------------
17 #include <linux/kernel.h>
18 #include <linux/wait.h>
19 #include <linux/mutex.h>
20 #include <linux/device.h>
21 #include <linux/cdev.h>
22 #include <linux/init.h>
23 #include <linux/module.h>
24 #include <linux/slab.h>
26 #include <linux/moduleparam.h>
27 #include <linux/interrupt.h>
28 #include <linux/param.h>
30 #include <linux/types.h>
31 #include <linux/uaccess.h>
32 #include <linux/jiffies.h>
34 #include <linux/of_address.h>
35 #include <linux/of_device.h>
36 #include <linux/of_platform.h>
38 /* ----------------------------
40 * ----------------------------
43 #define DRIVER_NAME "axis_fifo"
45 #define READ_BUF_SIZE 128U /* read buffer length in words */
46 #define WRITE_BUF_SIZE 128U /* write buffer length in words */
48 /* ----------------------------
50 * ----------------------------
53 #define XLLF_ISR_OFFSET 0x00000000 /* Interrupt Status */
54 #define XLLF_IER_OFFSET 0x00000004 /* Interrupt Enable */
56 #define XLLF_TDFR_OFFSET 0x00000008 /* Transmit Reset */
57 #define XLLF_TDFV_OFFSET 0x0000000c /* Transmit Vacancy */
58 #define XLLF_TDFD_OFFSET 0x00000010 /* Transmit Data */
59 #define XLLF_TLR_OFFSET 0x00000014 /* Transmit Length */
61 #define XLLF_RDFR_OFFSET 0x00000018 /* Receive Reset */
62 #define XLLF_RDFO_OFFSET 0x0000001c /* Receive Occupancy */
63 #define XLLF_RDFD_OFFSET 0x00000020 /* Receive Data */
64 #define XLLF_RLR_OFFSET 0x00000024 /* Receive Length */
65 #define XLLF_SRR_OFFSET 0x00000028 /* Local Link Reset */
66 #define XLLF_TDR_OFFSET 0x0000002C /* Transmit Destination */
67 #define XLLF_RDR_OFFSET 0x00000030 /* Receive Destination */
69 /* ----------------------------
70 * reset register masks
71 * ----------------------------
74 #define XLLF_RDFR_RESET_MASK 0x000000a5 /* receive reset value */
75 #define XLLF_TDFR_RESET_MASK 0x000000a5 /* Transmit reset value */
76 #define XLLF_SRR_RESET_MASK 0x000000a5 /* Local Link reset value */
78 /* ----------------------------
80 * ----------------------------
83 #define XLLF_INT_RPURE_MASK 0x80000000 /* Receive under-read */
84 #define XLLF_INT_RPORE_MASK 0x40000000 /* Receive over-read */
85 #define XLLF_INT_RPUE_MASK 0x20000000 /* Receive underrun (empty) */
86 #define XLLF_INT_TPOE_MASK 0x10000000 /* Transmit overrun */
87 #define XLLF_INT_TC_MASK 0x08000000 /* Transmit complete */
88 #define XLLF_INT_RC_MASK 0x04000000 /* Receive complete */
89 #define XLLF_INT_TSE_MASK 0x02000000 /* Transmit length mismatch */
90 #define XLLF_INT_TRC_MASK 0x01000000 /* Transmit reset complete */
91 #define XLLF_INT_RRC_MASK 0x00800000 /* Receive reset complete */
92 #define XLLF_INT_TFPF_MASK 0x00400000 /* Tx FIFO Programmable Full */
93 #define XLLF_INT_TFPE_MASK 0x00200000 /* Tx FIFO Programmable Empty */
94 #define XLLF_INT_RFPF_MASK 0x00100000 /* Rx FIFO Programmable Full */
95 #define XLLF_INT_RFPE_MASK 0x00080000 /* Rx FIFO Programmable Empty */
96 #define XLLF_INT_ALL_MASK 0xfff80000 /* All the ints */
97 #define XLLF_INT_ERROR_MASK 0xf2000000 /* Error status ints */
98 #define XLLF_INT_RXERROR_MASK 0xe0000000 /* Receive Error status ints */
99 #define XLLF_INT_TXERROR_MASK 0x12000000 /* Transmit Error status ints */
101 /* ----------------------------
103 * ----------------------------
106 static struct class *axis_fifo_driver_class
; /* char device class */
108 static int read_timeout
= 1000; /* ms to wait before read() times out */
109 static int write_timeout
= 1000; /* ms to wait before write() times out */
111 /* ----------------------------
112 * module command-line arguments
113 * ----------------------------
116 module_param(read_timeout
, int, 0444);
117 MODULE_PARM_DESC(read_timeout
, "ms to wait before blocking read() timing out; set to -1 for no timeout");
118 module_param(write_timeout
, int, 0444);
119 MODULE_PARM_DESC(write_timeout
, "ms to wait before blocking write() timing out; set to -1 for no timeout");
121 /* ----------------------------
123 * ----------------------------
127 int irq
; /* interrupt */
128 void __iomem
*base_addr
; /* kernel space memory */
130 unsigned int rx_fifo_depth
; /* max words in the receive fifo */
131 unsigned int tx_fifo_depth
; /* max words in the transmit fifo */
132 int has_rx_fifo
; /* whether the IP has the rx fifo enabled */
133 int has_tx_fifo
; /* whether the IP has the tx fifo enabled */
135 wait_queue_head_t read_queue
; /* wait queue for asynchronos read */
136 struct mutex read_lock
; /* lock for reading */
137 wait_queue_head_t write_queue
; /* wait queue for asynchronos write */
138 struct mutex write_lock
; /* lock for writing */
139 unsigned int write_flags
; /* write file flags */
140 unsigned int read_flags
; /* read file flags */
142 struct device
*dt_device
; /* device created from the device tree */
143 struct device
*device
; /* device associated with char_device */
144 dev_t devt
; /* our char device number */
145 struct cdev char_device
; /* our char device */
148 /* ----------------------------
150 * ----------------------------
153 static ssize_t
sysfs_write(struct device
*dev
, const char *buf
,
154 size_t count
, unsigned int addr_offset
)
156 struct axis_fifo
*fifo
= dev_get_drvdata(dev
);
160 rc
= kstrtoul(buf
, 0, &tmp
);
164 iowrite32(tmp
, fifo
->base_addr
+ addr_offset
);
169 static ssize_t
sysfs_read(struct device
*dev
, char *buf
,
170 unsigned int addr_offset
)
172 struct axis_fifo
*fifo
= dev_get_drvdata(dev
);
173 unsigned int read_val
;
177 read_val
= ioread32(fifo
->base_addr
+ addr_offset
);
178 len
= snprintf(tmp
, sizeof(tmp
), "0x%x\n", read_val
);
179 memcpy(buf
, tmp
, len
);
184 static ssize_t
isr_store(struct device
*dev
, struct device_attribute
*attr
,
185 const char *buf
, size_t count
)
187 return sysfs_write(dev
, buf
, count
, XLLF_ISR_OFFSET
);
190 static ssize_t
isr_show(struct device
*dev
,
191 struct device_attribute
*attr
, char *buf
)
193 return sysfs_read(dev
, buf
, XLLF_ISR_OFFSET
);
196 static DEVICE_ATTR_RW(isr
);
198 static ssize_t
ier_store(struct device
*dev
, struct device_attribute
*attr
,
199 const char *buf
, size_t count
)
201 return sysfs_write(dev
, buf
, count
, XLLF_IER_OFFSET
);
204 static ssize_t
ier_show(struct device
*dev
,
205 struct device_attribute
*attr
, char *buf
)
207 return sysfs_read(dev
, buf
, XLLF_IER_OFFSET
);
210 static DEVICE_ATTR_RW(ier
);
212 static ssize_t
tdfr_store(struct device
*dev
, struct device_attribute
*attr
,
213 const char *buf
, size_t count
)
215 return sysfs_write(dev
, buf
, count
, XLLF_TDFR_OFFSET
);
218 static DEVICE_ATTR_WO(tdfr
);
220 static ssize_t
tdfv_show(struct device
*dev
,
221 struct device_attribute
*attr
, char *buf
)
223 return sysfs_read(dev
, buf
, XLLF_TDFV_OFFSET
);
226 static DEVICE_ATTR_RO(tdfv
);
228 static ssize_t
tdfd_store(struct device
*dev
, struct device_attribute
*attr
,
229 const char *buf
, size_t count
)
231 return sysfs_write(dev
, buf
, count
, XLLF_TDFD_OFFSET
);
234 static DEVICE_ATTR_WO(tdfd
);
236 static ssize_t
tlr_store(struct device
*dev
, struct device_attribute
*attr
,
237 const char *buf
, size_t count
)
239 return sysfs_write(dev
, buf
, count
, XLLF_TLR_OFFSET
);
242 static DEVICE_ATTR_WO(tlr
);
244 static ssize_t
rdfr_store(struct device
*dev
, struct device_attribute
*attr
,
245 const char *buf
, size_t count
)
247 return sysfs_write(dev
, buf
, count
, XLLF_RDFR_OFFSET
);
250 static DEVICE_ATTR_WO(rdfr
);
252 static ssize_t
rdfo_show(struct device
*dev
,
253 struct device_attribute
*attr
, char *buf
)
255 return sysfs_read(dev
, buf
, XLLF_RDFO_OFFSET
);
258 static DEVICE_ATTR_RO(rdfo
);
260 static ssize_t
rdfd_show(struct device
*dev
,
261 struct device_attribute
*attr
, char *buf
)
263 return sysfs_read(dev
, buf
, XLLF_RDFD_OFFSET
);
266 static DEVICE_ATTR_RO(rdfd
);
268 static ssize_t
rlr_show(struct device
*dev
,
269 struct device_attribute
*attr
, char *buf
)
271 return sysfs_read(dev
, buf
, XLLF_RLR_OFFSET
);
274 static DEVICE_ATTR_RO(rlr
);
276 static ssize_t
srr_store(struct device
*dev
, struct device_attribute
*attr
,
277 const char *buf
, size_t count
)
279 return sysfs_write(dev
, buf
, count
, XLLF_SRR_OFFSET
);
282 static DEVICE_ATTR_WO(srr
);
284 static ssize_t
tdr_store(struct device
*dev
, struct device_attribute
*attr
,
285 const char *buf
, size_t count
)
287 return sysfs_write(dev
, buf
, count
, XLLF_TDR_OFFSET
);
290 static DEVICE_ATTR_WO(tdr
);
292 static ssize_t
rdr_show(struct device
*dev
,
293 struct device_attribute
*attr
, char *buf
)
295 return sysfs_read(dev
, buf
, XLLF_RDR_OFFSET
);
298 static DEVICE_ATTR_RO(rdr
);
300 static struct attribute
*axis_fifo_attrs
[] = {
317 static const struct attribute_group axis_fifo_attrs_group
= {
318 .name
= "ip_registers",
319 .attrs
= axis_fifo_attrs
,
322 /* ----------------------------
324 * ----------------------------
327 static void reset_ip_core(struct axis_fifo
*fifo
)
329 iowrite32(XLLF_SRR_RESET_MASK
, fifo
->base_addr
+ XLLF_SRR_OFFSET
);
330 iowrite32(XLLF_TDFR_RESET_MASK
, fifo
->base_addr
+ XLLF_TDFR_OFFSET
);
331 iowrite32(XLLF_RDFR_RESET_MASK
, fifo
->base_addr
+ XLLF_RDFR_OFFSET
);
332 iowrite32(XLLF_INT_TC_MASK
| XLLF_INT_RC_MASK
| XLLF_INT_RPURE_MASK
|
333 XLLF_INT_RPORE_MASK
| XLLF_INT_RPUE_MASK
|
334 XLLF_INT_TPOE_MASK
| XLLF_INT_TSE_MASK
,
335 fifo
->base_addr
+ XLLF_IER_OFFSET
);
336 iowrite32(XLLF_INT_ALL_MASK
, fifo
->base_addr
+ XLLF_ISR_OFFSET
);
340 * axis_fifo_write() - Read a packet from AXIS-FIFO character device.
342 * @buf User space buffer to read to.
343 * @len User space buffer length.
344 * @off Buffer offset.
346 * As defined by the device's documentation, we need to check the device's
347 * occupancy before reading the length register and then the data. All these
348 * operations must be executed atomically, in order and one after the other
349 * without missing any.
351 * Returns the number of bytes read from the device or negative error code
354 static ssize_t
axis_fifo_read(struct file
*f
, char __user
*buf
,
355 size_t len
, loff_t
*off
)
357 struct axis_fifo
*fifo
= (struct axis_fifo
*)f
->private_data
;
358 size_t bytes_available
;
359 unsigned int words_available
;
364 u32 tmp_buf
[READ_BUF_SIZE
];
366 if (fifo
->read_flags
& O_NONBLOCK
) {
368 * Device opened in non-blocking mode. Try to lock it and then
369 * check if any packet is available.
371 if (!mutex_trylock(&fifo
->read_lock
))
374 if (!ioread32(fifo
->base_addr
+ XLLF_RDFO_OFFSET
)) {
379 /* opened in blocking mode
380 * wait for a packet available interrupt (or timeout)
381 * if nothing is currently available
383 mutex_lock(&fifo
->read_lock
);
384 ret
= wait_event_interruptible_timeout(fifo
->read_queue
,
385 ioread32(fifo
->base_addr
+ XLLF_RDFO_OFFSET
),
386 (read_timeout
>= 0) ? msecs_to_jiffies(read_timeout
) :
387 MAX_SCHEDULE_TIMEOUT
);
392 } else if (ret
!= -ERESTARTSYS
) {
393 dev_err(fifo
->dt_device
, "wait_event_interruptible_timeout() error in read (ret=%i)\n",
401 bytes_available
= ioread32(fifo
->base_addr
+ XLLF_RLR_OFFSET
);
402 if (!bytes_available
) {
403 dev_err(fifo
->dt_device
, "received a packet of length 0 - fifo core will be reset\n");
409 if (bytes_available
> len
) {
410 dev_err(fifo
->dt_device
, "user read buffer too small (available bytes=%zu user buffer bytes=%zu) - fifo core will be reset\n",
411 bytes_available
, len
);
417 if (bytes_available
% sizeof(u32
)) {
418 /* this probably can't happen unless IP
419 * registers were previously mishandled
421 dev_err(fifo
->dt_device
, "received a packet that isn't word-aligned - fifo core will be reset\n");
427 words_available
= bytes_available
/ sizeof(u32
);
429 /* read data into an intermediate buffer, copying the contents
430 * to userspace when the buffer is full
433 while (words_available
> 0) {
434 copy
= min(words_available
, READ_BUF_SIZE
);
436 for (i
= 0; i
< copy
; i
++) {
437 tmp_buf
[i
] = ioread32(fifo
->base_addr
+
441 if (copy_to_user(buf
+ copied
* sizeof(u32
), tmp_buf
,
442 copy
* sizeof(u32
))) {
449 words_available
-= copy
;
452 ret
= bytes_available
;
455 mutex_unlock(&fifo
->read_lock
);
461 * axis_fifo_write() - Write buffer to AXIS-FIFO character device.
463 * @buf User space buffer to write to the device.
464 * @len User space buffer length.
465 * @off Buffer offset.
467 * As defined by the device's documentation, we need to write to the device's
468 * data buffer then to the device's packet length register atomically. Also,
469 * we need to lock before checking if the device has available space to avoid
470 * any concurrency issue.
472 * Returns the number of bytes written to the device or negative error code
475 static ssize_t
axis_fifo_write(struct file
*f
, const char __user
*buf
,
476 size_t len
, loff_t
*off
)
478 struct axis_fifo
*fifo
= (struct axis_fifo
*)f
->private_data
;
479 unsigned int words_to_write
;
484 u32 tmp_buf
[WRITE_BUF_SIZE
];
486 if (len
% sizeof(u32
)) {
487 dev_err(fifo
->dt_device
,
488 "tried to send a packet that isn't word-aligned\n");
492 words_to_write
= len
/ sizeof(u32
);
494 if (!words_to_write
) {
495 dev_err(fifo
->dt_device
,
496 "tried to send a packet of length 0\n");
500 if (words_to_write
> fifo
->tx_fifo_depth
) {
501 dev_err(fifo
->dt_device
, "tried to write more words [%u] than slots in the fifo buffer [%u]\n",
502 words_to_write
, fifo
->tx_fifo_depth
);
506 if (fifo
->write_flags
& O_NONBLOCK
) {
508 * Device opened in non-blocking mode. Try to lock it and then
509 * check if there is any room to write the given buffer.
511 if (!mutex_trylock(&fifo
->write_lock
))
514 if (words_to_write
> ioread32(fifo
->base_addr
+
520 /* opened in blocking mode */
522 /* wait for an interrupt (or timeout) if there isn't
523 * currently enough room in the fifo
525 mutex_lock(&fifo
->write_lock
);
526 ret
= wait_event_interruptible_timeout(fifo
->write_queue
,
527 ioread32(fifo
->base_addr
+ XLLF_TDFV_OFFSET
)
529 (write_timeout
>= 0) ? msecs_to_jiffies(write_timeout
) :
530 MAX_SCHEDULE_TIMEOUT
);
535 } else if (ret
!= -ERESTARTSYS
) {
536 dev_err(fifo
->dt_device
, "wait_event_interruptible_timeout() error in write (ret=%i)\n",
544 /* write data from an intermediate buffer into the fifo IP, refilling
545 * the buffer with userspace data as needed
548 while (words_to_write
> 0) {
549 copy
= min(words_to_write
, WRITE_BUF_SIZE
);
551 if (copy_from_user(tmp_buf
, buf
+ copied
* sizeof(u32
),
552 copy
* sizeof(u32
))) {
558 for (i
= 0; i
< copy
; i
++)
559 iowrite32(tmp_buf
[i
], fifo
->base_addr
+
563 words_to_write
-= copy
;
566 ret
= copied
* sizeof(u32
);
568 /* write packet size to fifo */
569 iowrite32(ret
, fifo
->base_addr
+ XLLF_TLR_OFFSET
);
572 mutex_unlock(&fifo
->write_lock
);
577 static irqreturn_t
axis_fifo_irq(int irq
, void *dw
)
579 struct axis_fifo
*fifo
= (struct axis_fifo
*)dw
;
580 unsigned int pending_interrupts
;
583 pending_interrupts
= ioread32(fifo
->base_addr
+
585 ioread32(fifo
->base_addr
587 if (pending_interrupts
& XLLF_INT_RC_MASK
) {
588 /* packet received */
590 /* wake the reader process if it is waiting */
591 wake_up(&fifo
->read_queue
);
593 /* clear interrupt */
594 iowrite32(XLLF_INT_RC_MASK
& XLLF_INT_ALL_MASK
,
595 fifo
->base_addr
+ XLLF_ISR_OFFSET
);
596 } else if (pending_interrupts
& XLLF_INT_TC_MASK
) {
599 /* wake the writer process if it is waiting */
600 wake_up(&fifo
->write_queue
);
602 iowrite32(XLLF_INT_TC_MASK
& XLLF_INT_ALL_MASK
,
603 fifo
->base_addr
+ XLLF_ISR_OFFSET
);
604 } else if (pending_interrupts
& XLLF_INT_TFPF_MASK
) {
605 /* transmit fifo programmable full */
607 iowrite32(XLLF_INT_TFPF_MASK
& XLLF_INT_ALL_MASK
,
608 fifo
->base_addr
+ XLLF_ISR_OFFSET
);
609 } else if (pending_interrupts
& XLLF_INT_TFPE_MASK
) {
610 /* transmit fifo programmable empty */
612 iowrite32(XLLF_INT_TFPE_MASK
& XLLF_INT_ALL_MASK
,
613 fifo
->base_addr
+ XLLF_ISR_OFFSET
);
614 } else if (pending_interrupts
& XLLF_INT_RFPF_MASK
) {
615 /* receive fifo programmable full */
617 iowrite32(XLLF_INT_RFPF_MASK
& XLLF_INT_ALL_MASK
,
618 fifo
->base_addr
+ XLLF_ISR_OFFSET
);
619 } else if (pending_interrupts
& XLLF_INT_RFPE_MASK
) {
620 /* receive fifo programmable empty */
622 iowrite32(XLLF_INT_RFPE_MASK
& XLLF_INT_ALL_MASK
,
623 fifo
->base_addr
+ XLLF_ISR_OFFSET
);
624 } else if (pending_interrupts
& XLLF_INT_TRC_MASK
) {
625 /* transmit reset complete interrupt */
627 iowrite32(XLLF_INT_TRC_MASK
& XLLF_INT_ALL_MASK
,
628 fifo
->base_addr
+ XLLF_ISR_OFFSET
);
629 } else if (pending_interrupts
& XLLF_INT_RRC_MASK
) {
630 /* receive reset complete interrupt */
632 iowrite32(XLLF_INT_RRC_MASK
& XLLF_INT_ALL_MASK
,
633 fifo
->base_addr
+ XLLF_ISR_OFFSET
);
634 } else if (pending_interrupts
& XLLF_INT_RPURE_MASK
) {
635 /* receive fifo under-read error interrupt */
636 dev_err(fifo
->dt_device
,
637 "receive under-read interrupt\n");
639 iowrite32(XLLF_INT_RPURE_MASK
& XLLF_INT_ALL_MASK
,
640 fifo
->base_addr
+ XLLF_ISR_OFFSET
);
641 } else if (pending_interrupts
& XLLF_INT_RPORE_MASK
) {
642 /* receive over-read error interrupt */
643 dev_err(fifo
->dt_device
,
644 "receive over-read interrupt\n");
646 iowrite32(XLLF_INT_RPORE_MASK
& XLLF_INT_ALL_MASK
,
647 fifo
->base_addr
+ XLLF_ISR_OFFSET
);
648 } else if (pending_interrupts
& XLLF_INT_RPUE_MASK
) {
649 /* receive underrun error interrupt */
650 dev_err(fifo
->dt_device
,
651 "receive underrun error interrupt\n");
653 iowrite32(XLLF_INT_RPUE_MASK
& XLLF_INT_ALL_MASK
,
654 fifo
->base_addr
+ XLLF_ISR_OFFSET
);
655 } else if (pending_interrupts
& XLLF_INT_TPOE_MASK
) {
656 /* transmit overrun error interrupt */
657 dev_err(fifo
->dt_device
,
658 "transmit overrun error interrupt\n");
660 iowrite32(XLLF_INT_TPOE_MASK
& XLLF_INT_ALL_MASK
,
661 fifo
->base_addr
+ XLLF_ISR_OFFSET
);
662 } else if (pending_interrupts
& XLLF_INT_TSE_MASK
) {
663 /* transmit length mismatch error interrupt */
664 dev_err(fifo
->dt_device
,
665 "transmit length mismatch error interrupt\n");
667 iowrite32(XLLF_INT_TSE_MASK
& XLLF_INT_ALL_MASK
,
668 fifo
->base_addr
+ XLLF_ISR_OFFSET
);
669 } else if (pending_interrupts
) {
670 /* unknown interrupt type */
671 dev_err(fifo
->dt_device
,
672 "unknown interrupt(s) 0x%x\n",
675 iowrite32(XLLF_INT_ALL_MASK
,
676 fifo
->base_addr
+ XLLF_ISR_OFFSET
);
678 } while (pending_interrupts
);
683 static int axis_fifo_open(struct inode
*inod
, struct file
*f
)
685 struct axis_fifo
*fifo
= (struct axis_fifo
*)container_of(inod
->i_cdev
,
686 struct axis_fifo
, char_device
);
687 f
->private_data
= fifo
;
689 if (((f
->f_flags
& O_ACCMODE
) == O_WRONLY
) ||
690 ((f
->f_flags
& O_ACCMODE
) == O_RDWR
)) {
691 if (fifo
->has_tx_fifo
) {
692 fifo
->write_flags
= f
->f_flags
;
694 dev_err(fifo
->dt_device
, "tried to open device for write but the transmit fifo is disabled\n");
699 if (((f
->f_flags
& O_ACCMODE
) == O_RDONLY
) ||
700 ((f
->f_flags
& O_ACCMODE
) == O_RDWR
)) {
701 if (fifo
->has_rx_fifo
) {
702 fifo
->read_flags
= f
->f_flags
;
704 dev_err(fifo
->dt_device
, "tried to open device for read but the receive fifo is disabled\n");
712 static int axis_fifo_close(struct inode
*inod
, struct file
*f
)
714 f
->private_data
= NULL
;
719 static const struct file_operations fops
= {
720 .owner
= THIS_MODULE
,
721 .open
= axis_fifo_open
,
722 .release
= axis_fifo_close
,
723 .read
= axis_fifo_read
,
724 .write
= axis_fifo_write
727 /* read named property from the device tree */
728 static int get_dts_property(struct axis_fifo
*fifo
,
729 char *name
, unsigned int *var
)
733 rc
= of_property_read_u32(fifo
->dt_device
->of_node
, name
, var
);
735 dev_err(fifo
->dt_device
, "couldn't read IP dts property '%s'",
739 dev_dbg(fifo
->dt_device
, "dts property '%s' = %u\n",
745 static int axis_fifo_parse_dt(struct axis_fifo
*fifo
)
750 ret
= get_dts_property(fifo
, "xlnx,axi-str-rxd-tdata-width", &value
);
752 dev_err(fifo
->dt_device
, "missing xlnx,axi-str-rxd-tdata-width property\n");
754 } else if (value
!= 32) {
755 dev_err(fifo
->dt_device
, "xlnx,axi-str-rxd-tdata-width only supports 32 bits\n");
760 ret
= get_dts_property(fifo
, "xlnx,axi-str-txd-tdata-width", &value
);
762 dev_err(fifo
->dt_device
, "missing xlnx,axi-str-txd-tdata-width property\n");
764 } else if (value
!= 32) {
765 dev_err(fifo
->dt_device
, "xlnx,axi-str-txd-tdata-width only supports 32 bits\n");
770 ret
= get_dts_property(fifo
, "xlnx,rx-fifo-depth",
771 &fifo
->rx_fifo_depth
);
773 dev_err(fifo
->dt_device
, "missing xlnx,rx-fifo-depth property\n");
778 ret
= get_dts_property(fifo
, "xlnx,tx-fifo-depth",
779 &fifo
->tx_fifo_depth
);
781 dev_err(fifo
->dt_device
, "missing xlnx,tx-fifo-depth property\n");
786 /* IP sets TDFV to fifo depth - 4 so we will do the same */
787 fifo
->tx_fifo_depth
-= 4;
789 ret
= get_dts_property(fifo
, "xlnx,use-rx-data", &fifo
->has_rx_fifo
);
791 dev_err(fifo
->dt_device
, "missing xlnx,use-rx-data property\n");
796 ret
= get_dts_property(fifo
, "xlnx,use-tx-data", &fifo
->has_tx_fifo
);
798 dev_err(fifo
->dt_device
, "missing xlnx,use-tx-data property\n");
807 static int axis_fifo_probe(struct platform_device
*pdev
)
809 struct resource
*r_irq
; /* interrupt resources */
810 struct resource
*r_mem
; /* IO mem resources */
811 struct device
*dev
= &pdev
->dev
; /* OS device (from device tree) */
812 struct axis_fifo
*fifo
= NULL
;
814 char device_name
[32];
816 int rc
= 0; /* error return value */
818 /* ----------------------------
819 * init wrapper device
820 * ----------------------------
823 /* allocate device wrapper memory */
824 fifo
= devm_kmalloc(dev
, sizeof(*fifo
), GFP_KERNEL
);
828 dev_set_drvdata(dev
, fifo
);
829 fifo
->dt_device
= dev
;
831 init_waitqueue_head(&fifo
->read_queue
);
832 init_waitqueue_head(&fifo
->write_queue
);
834 mutex_init(&fifo
->read_lock
);
835 mutex_init(&fifo
->write_lock
);
837 /* ----------------------------
838 * init device memory space
839 * ----------------------------
842 /* get iospace for the device */
843 r_mem
= platform_get_resource(pdev
, IORESOURCE_MEM
, 0);
845 dev_err(fifo
->dt_device
, "invalid address\n");
850 /* request physical memory */
851 fifo
->base_addr
= devm_ioremap_resource(fifo
->dt_device
, r_mem
);
852 if (IS_ERR(fifo
->base_addr
)) {
853 rc
= PTR_ERR(fifo
->base_addr
);
854 dev_err(fifo
->dt_device
, "can't remap IO resource (%d)\n", rc
);
858 dev_dbg(fifo
->dt_device
, "remapped memory to 0x%p\n", fifo
->base_addr
);
860 /* create unique device name */
861 snprintf(device_name
, sizeof(device_name
), "%s_%pa",
862 DRIVER_NAME
, &r_mem
->start
);
864 dev_dbg(fifo
->dt_device
, "device name [%s]\n", device_name
);
866 /* ----------------------------
868 * ----------------------------
871 rc
= axis_fifo_parse_dt(fifo
);
877 /* ----------------------------
878 * init device interrupts
879 * ----------------------------
882 /* get IRQ resource */
883 r_irq
= platform_get_resource(pdev
, IORESOURCE_IRQ
, 0);
885 dev_err(fifo
->dt_device
, "no IRQ found for 0x%pa\n",
892 fifo
->irq
= r_irq
->start
;
893 rc
= devm_request_irq(fifo
->dt_device
, fifo
->irq
, &axis_fifo_irq
, 0,
896 dev_err(fifo
->dt_device
, "couldn't allocate interrupt %i\n",
901 /* ----------------------------
903 * ----------------------------
906 /* allocate device number */
907 rc
= alloc_chrdev_region(&fifo
->devt
, 0, 1, DRIVER_NAME
);
910 dev_dbg(fifo
->dt_device
, "allocated device number major %i minor %i\n",
911 MAJOR(fifo
->devt
), MINOR(fifo
->devt
));
913 /* create driver file */
914 fifo
->device
= device_create(axis_fifo_driver_class
, NULL
, fifo
->devt
,
916 if (IS_ERR(fifo
->device
)) {
917 dev_err(fifo
->dt_device
,
918 "couldn't create driver file\n");
919 rc
= PTR_ERR(fifo
->device
);
920 goto err_chrdev_region
;
922 dev_set_drvdata(fifo
->device
, fifo
);
924 /* create character device */
925 cdev_init(&fifo
->char_device
, &fops
);
926 rc
= cdev_add(&fifo
->char_device
, fifo
->devt
, 1);
928 dev_err(fifo
->dt_device
, "couldn't create character device\n");
932 /* create sysfs entries */
933 rc
= devm_device_add_group(fifo
->device
, &axis_fifo_attrs_group
);
935 dev_err(fifo
->dt_device
, "couldn't register sysfs group\n");
939 dev_info(fifo
->dt_device
, "axis-fifo created at %pa mapped to 0x%pa, irq=%i, major=%i, minor=%i\n",
940 &r_mem
->start
, &fifo
->base_addr
, fifo
->irq
,
941 MAJOR(fifo
->devt
), MINOR(fifo
->devt
));
946 cdev_del(&fifo
->char_device
);
948 device_destroy(axis_fifo_driver_class
, fifo
->devt
);
950 unregister_chrdev_region(fifo
->devt
, 1);
952 dev_set_drvdata(dev
, NULL
);
956 static int axis_fifo_remove(struct platform_device
*pdev
)
958 struct device
*dev
= &pdev
->dev
;
959 struct axis_fifo
*fifo
= dev_get_drvdata(dev
);
961 cdev_del(&fifo
->char_device
);
962 dev_set_drvdata(fifo
->device
, NULL
);
963 device_destroy(axis_fifo_driver_class
, fifo
->devt
);
964 unregister_chrdev_region(fifo
->devt
, 1);
965 dev_set_drvdata(dev
, NULL
);
970 static const struct of_device_id axis_fifo_of_match
[] = {
971 { .compatible
= "xlnx,axi-fifo-mm-s-4.1", },
974 MODULE_DEVICE_TABLE(of
, axis_fifo_of_match
);
976 static struct platform_driver axis_fifo_driver
= {
979 .of_match_table
= axis_fifo_of_match
,
981 .probe
= axis_fifo_probe
,
982 .remove
= axis_fifo_remove
,
985 static int __init
axis_fifo_init(void)
987 pr_info("axis-fifo driver loaded with parameters read_timeout = %i, write_timeout = %i\n",
988 read_timeout
, write_timeout
);
989 axis_fifo_driver_class
= class_create(THIS_MODULE
, DRIVER_NAME
);
990 if (IS_ERR(axis_fifo_driver_class
))
991 return PTR_ERR(axis_fifo_driver_class
);
992 return platform_driver_register(&axis_fifo_driver
);
995 module_init(axis_fifo_init
);
997 static void __exit
axis_fifo_exit(void)
999 platform_driver_unregister(&axis_fifo_driver
);
1000 class_destroy(axis_fifo_driver_class
);
1003 module_exit(axis_fifo_exit
);
1005 MODULE_LICENSE("GPL");
1006 MODULE_AUTHOR("Jacob Feder <jacobsfeder@gmail.com>");
1007 MODULE_DESCRIPTION("Xilinx AXI-Stream FIFO v4.1 IP core driver");