blob: 06473791c08adb7c5b0a7080ea9600d927c09d94 [file] [log] [blame]
Stefani Seibold5bf2b192010-08-10 18:03:39 -07001/*
2 * Sample fifo dma implementation
3 *
4 * Copyright (C) 2010 Stefani Seibold <stefani@seibold.net>
5 *
6 * Released under the GPL version 2 only.
7 *
8 */
9
10#include <linux/init.h>
11#include <linux/module.h>
12#include <linux/kfifo.h>
13
14/*
15 * This module shows how to handle fifo dma operations.
16 */
17
18/* fifo size in elements (bytes) */
19#define FIFO_SIZE 32
20
21static struct kfifo fifo;
22
23static int __init example_init(void)
24{
25 int i;
26 unsigned int ret;
Ira W. Snyder399f1e32010-09-30 15:15:27 -070027 unsigned int nents;
Stefani Seibold5bf2b192010-08-10 18:03:39 -070028 struct scatterlist sg[10];
29
30 printk(KERN_INFO "DMA fifo test start\n");
31
32 if (kfifo_alloc(&fifo, FIFO_SIZE, GFP_KERNEL)) {
Andrea Righia25effa2010-08-19 14:13:30 -070033 printk(KERN_WARNING "error kfifo_alloc\n");
34 return -ENOMEM;
Stefani Seibold5bf2b192010-08-10 18:03:39 -070035 }
36
37 printk(KERN_INFO "queue size: %u\n", kfifo_size(&fifo));
38
39 kfifo_in(&fifo, "test", 4);
40
41 for (i = 0; i != 9; i++)
42 kfifo_put(&fifo, &i);
43
44 /* kick away first byte */
Andrea Righia25effa2010-08-19 14:13:30 -070045 kfifo_skip(&fifo);
Stefani Seibold5bf2b192010-08-10 18:03:39 -070046
47 printk(KERN_INFO "queue len: %u\n", kfifo_len(&fifo));
48
Andrea Righia25effa2010-08-19 14:13:30 -070049 /*
50 * Configure the kfifo buffer to receive data from DMA input.
51 *
52 * .--------------------------------------.
53 * | 0 | 1 | 2 | ... | 12 | 13 | ... | 31 |
54 * |---|------------------|---------------|
55 * \_/ \________________/ \_____________/
56 * \ \ \
57 * \ \_allocated data \
58 * \_*free space* \_*free space*
59 *
60 * We need two different SG entries: one for the free space area at the
61 * end of the kfifo buffer (19 bytes) and another for the first free
62 * byte at the beginning, after the kfifo_skip().
63 */
Andrea Righi7b34d522010-08-19 14:13:29 -070064 sg_init_table(sg, ARRAY_SIZE(sg));
Ira W. Snyder399f1e32010-09-30 15:15:27 -070065 nents = kfifo_dma_in_prepare(&fifo, sg, ARRAY_SIZE(sg), FIFO_SIZE);
66 printk(KERN_INFO "DMA sgl entries: %d\n", nents);
67 if (!nents) {
Andrea Righia25effa2010-08-19 14:13:30 -070068 /* fifo is full and no sgl was created */
69 printk(KERN_WARNING "error kfifo_dma_in_prepare\n");
70 return -EIO;
Stefani Seibold5bf2b192010-08-10 18:03:39 -070071 }
72
Andrea Righia25effa2010-08-19 14:13:30 -070073 /* receive data */
74 printk(KERN_INFO "scatterlist for receive:\n");
Ira W. Snyder399f1e32010-09-30 15:15:27 -070075 for (i = 0; i < nents; i++) {
Andrea Righia25effa2010-08-19 14:13:30 -070076 printk(KERN_INFO
77 "sg[%d] -> "
78 "page_link 0x%.8lx offset 0x%.8x length 0x%.8x\n",
79 i, sg[i].page_link, sg[i].offset, sg[i].length);
80
81 if (sg_is_last(&sg[i]))
82 break;
83 }
84
85 /* put here your code to setup and exectute the dma operation */
86 /* ... */
87
88 /* example: zero bytes received */
89 ret = 0;
90
91 /* finish the dma operation and update the received data */
92 kfifo_dma_in_finish(&fifo, ret);
93
94 /* Prepare to transmit data, example: 8 bytes */
Ira W. Snyder399f1e32010-09-30 15:15:27 -070095 nents = kfifo_dma_out_prepare(&fifo, sg, ARRAY_SIZE(sg), 8);
96 printk(KERN_INFO "DMA sgl entries: %d\n", nents);
97 if (!nents) {
Andrea Righia25effa2010-08-19 14:13:30 -070098 /* no data was available and no sgl was created */
99 printk(KERN_WARNING "error kfifo_dma_out_prepare\n");
100 return -EIO;
Stefani Seibold5bf2b192010-08-10 18:03:39 -0700101 }
102
Andrea Righia25effa2010-08-19 14:13:30 -0700103 printk(KERN_INFO "scatterlist for transmit:\n");
Ira W. Snyder399f1e32010-09-30 15:15:27 -0700104 for (i = 0; i < nents; i++) {
Andrea Righia25effa2010-08-19 14:13:30 -0700105 printk(KERN_INFO
106 "sg[%d] -> "
107 "page_link 0x%.8lx offset 0x%.8x length 0x%.8x\n",
108 i, sg[i].page_link, sg[i].offset, sg[i].length);
109
110 if (sg_is_last(&sg[i]))
111 break;
112 }
113
114 /* put here your code to setup and exectute the dma operation */
115 /* ... */
116
117 /* example: 5 bytes transmitted */
118 ret = 5;
119
120 /* finish the dma operation and update the transmitted data */
121 kfifo_dma_out_finish(&fifo, ret);
122
123 ret = kfifo_len(&fifo);
Stefani Seibold5bf2b192010-08-10 18:03:39 -0700124 printk(KERN_INFO "queue len: %u\n", kfifo_len(&fifo));
125
Andrea Righia25effa2010-08-19 14:13:30 -0700126 if (ret != 7) {
127 printk(KERN_WARNING "size mismatch: test failed");
128 return -EIO;
129 }
130 printk(KERN_INFO "test passed\n");
131
Stefani Seibold5bf2b192010-08-10 18:03:39 -0700132 return 0;
133}
134
135static void __exit example_exit(void)
136{
Andrea Righid83a71c2010-08-19 14:13:30 -0700137 kfifo_free(&fifo);
Stefani Seibold5bf2b192010-08-10 18:03:39 -0700138}
139
140module_init(example_init);
141module_exit(example_exit);
142MODULE_LICENSE("GPL");
143MODULE_AUTHOR("Stefani Seibold <stefani@seibold.net>");