xref: /linux/drivers/char/xilinx_hwicap/xilinx_hwicap.c (revision bd628c1bed7902ec1f24ba0fe70758949146abbe)
1 /*****************************************************************************
2  *
3  *     Author: Xilinx, Inc.
4  *
5  *     This program is free software; you can redistribute it and/or modify it
6  *     under the terms of the GNU General Public License as published by the
7  *     Free Software Foundation; either version 2 of the License, or (at your
8  *     option) any later version.
9  *
10  *     XILINX IS PROVIDING THIS DESIGN, CODE, OR INFORMATION "AS IS"
11  *     AS A COURTESY TO YOU, SOLELY FOR USE IN DEVELOPING PROGRAMS AND
12  *     SOLUTIONS FOR XILINX DEVICES.  BY PROVIDING THIS DESIGN, CODE,
13  *     OR INFORMATION AS ONE POSSIBLE IMPLEMENTATION OF THIS FEATURE,
14  *     APPLICATION OR STANDARD, XILINX IS MAKING NO REPRESENTATION
15  *     THAT THIS IMPLEMENTATION IS FREE FROM ANY CLAIMS OF INFRINGEMENT,
16  *     AND YOU ARE RESPONSIBLE FOR OBTAINING ANY RIGHTS YOU MAY REQUIRE
17  *     FOR YOUR IMPLEMENTATION.  XILINX EXPRESSLY DISCLAIMS ANY
18  *     WARRANTY WHATSOEVER WITH RESPECT TO THE ADEQUACY OF THE
19  *     IMPLEMENTATION, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OR
20  *     REPRESENTATIONS THAT THIS IMPLEMENTATION IS FREE FROM CLAIMS OF
21  *     INFRINGEMENT, IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
22  *     FOR A PARTICULAR PURPOSE.
23  *
24  *     (c) Copyright 2002 Xilinx Inc., Systems Engineering Group
25  *     (c) Copyright 2004 Xilinx Inc., Systems Engineering Group
26  *     (c) Copyright 2007-2008 Xilinx Inc.
27  *     All rights reserved.
28  *
29  *     You should have received a copy of the GNU General Public License along
30  *     with this program; if not, write to the Free Software Foundation, Inc.,
31  *     675 Mass Ave, Cambridge, MA 02139, USA.
32  *
33  *****************************************************************************/
34 
35 /*
36  * This is the code behind /dev/icap* -- it allows a user-space
37  * application to use the Xilinx ICAP subsystem.
38  *
39  * The following operations are possible:
40  *
41  * open         open the port and initialize for access.
42  * release      release port
43  * write        Write a bitstream to the configuration processor.
44  * read         Read a data stream from the configuration processor.
45  *
46  * After being opened, the port is initialized and accessed to avoid a
47  * corrupted first read which may occur with some hardware.  The port
48  * is left in a desynched state, requiring that a synch sequence be
49  * transmitted before any valid configuration data.  A user will have
50  * exclusive access to the device while it remains open, and the state
51  * of the ICAP cannot be guaranteed after the device is closed.  Note
52  * that a complete reset of the core and the state of the ICAP cannot
53  * be performed on many versions of the cores, hence users of this
54  * device should avoid making inconsistent accesses to the device.  In
55  * particular, accessing the read interface, without first generating
56  * a write containing a readback packet can leave the ICAP in an
57  * inaccessible state.
58  *
59  * Note that in order to use the read interface, it is first necessary
60  * to write a request packet to the write interface.  i.e., it is not
61  * possible to simply readback the bitstream (or any configuration
62  * bits) from a device without specifically requesting them first.
63  * The code to craft such packets is intended to be part of the
64  * user-space application code that uses this device.  The simplest
65  * way to use this interface is simply:
66  *
67  * cp foo.bit /dev/icap0
68  *
69  * Note that unless foo.bit is an appropriately constructed partial
70  * bitstream, this has a high likelihood of overwriting the design
71  * currently programmed in the FPGA.
72  */
73 
74 #include <linux/module.h>
75 #include <linux/kernel.h>
76 #include <linux/types.h>
77 #include <linux/ioport.h>
78 #include <linux/interrupt.h>
79 #include <linux/fcntl.h>
80 #include <linux/init.h>
81 #include <linux/poll.h>
82 #include <linux/proc_fs.h>
83 #include <linux/mutex.h>
84 #include <linux/sysctl.h>
85 #include <linux/fs.h>
86 #include <linux/cdev.h>
87 #include <linux/platform_device.h>
88 #include <linux/slab.h>
89 #include <linux/io.h>
90 #include <linux/uaccess.h>
91 
92 #ifdef CONFIG_OF
93 /* For open firmware. */
94 #include <linux/of_address.h>
95 #include <linux/of_device.h>
96 #include <linux/of_platform.h>
97 #endif
98 
99 #include "xilinx_hwicap.h"
100 #include "buffer_icap.h"
101 #include "fifo_icap.h"
102 
103 #define DRIVER_NAME "icap"
104 
105 #define HWICAP_REGS   (0x10000)
106 
107 #define XHWICAP_MAJOR 259
108 #define XHWICAP_MINOR 0
109 #define HWICAP_DEVICES 1
110 
111 /* An array, which is set to true when the device is registered. */
112 static DEFINE_MUTEX(hwicap_mutex);
113 static bool probed_devices[HWICAP_DEVICES];
114 static struct mutex icap_sem;
115 
116 static struct class *icap_class;
117 
118 #define UNIMPLEMENTED 0xFFFF
119 
120 static const struct config_registers v2_config_registers = {
121 	.CRC = 0,
122 	.FAR = 1,
123 	.FDRI = 2,
124 	.FDRO = 3,
125 	.CMD = 4,
126 	.CTL = 5,
127 	.MASK = 6,
128 	.STAT = 7,
129 	.LOUT = 8,
130 	.COR = 9,
131 	.MFWR = 10,
132 	.FLR = 11,
133 	.KEY = 12,
134 	.CBC = 13,
135 	.IDCODE = 14,
136 	.AXSS = UNIMPLEMENTED,
137 	.C0R_1 = UNIMPLEMENTED,
138 	.CSOB = UNIMPLEMENTED,
139 	.WBSTAR = UNIMPLEMENTED,
140 	.TIMER = UNIMPLEMENTED,
141 	.BOOTSTS = UNIMPLEMENTED,
142 	.CTL_1 = UNIMPLEMENTED,
143 };
144 
145 static const struct config_registers v4_config_registers = {
146 	.CRC = 0,
147 	.FAR = 1,
148 	.FDRI = 2,
149 	.FDRO = 3,
150 	.CMD = 4,
151 	.CTL = 5,
152 	.MASK = 6,
153 	.STAT = 7,
154 	.LOUT = 8,
155 	.COR = 9,
156 	.MFWR = 10,
157 	.FLR = UNIMPLEMENTED,
158 	.KEY = UNIMPLEMENTED,
159 	.CBC = 11,
160 	.IDCODE = 12,
161 	.AXSS = 13,
162 	.C0R_1 = UNIMPLEMENTED,
163 	.CSOB = UNIMPLEMENTED,
164 	.WBSTAR = UNIMPLEMENTED,
165 	.TIMER = UNIMPLEMENTED,
166 	.BOOTSTS = UNIMPLEMENTED,
167 	.CTL_1 = UNIMPLEMENTED,
168 };
169 
170 static const struct config_registers v5_config_registers = {
171 	.CRC = 0,
172 	.FAR = 1,
173 	.FDRI = 2,
174 	.FDRO = 3,
175 	.CMD = 4,
176 	.CTL = 5,
177 	.MASK = 6,
178 	.STAT = 7,
179 	.LOUT = 8,
180 	.COR = 9,
181 	.MFWR = 10,
182 	.FLR = UNIMPLEMENTED,
183 	.KEY = UNIMPLEMENTED,
184 	.CBC = 11,
185 	.IDCODE = 12,
186 	.AXSS = 13,
187 	.C0R_1 = 14,
188 	.CSOB = 15,
189 	.WBSTAR = 16,
190 	.TIMER = 17,
191 	.BOOTSTS = 18,
192 	.CTL_1 = 19,
193 };
194 
195 static const struct config_registers v6_config_registers = {
196 	.CRC = 0,
197 	.FAR = 1,
198 	.FDRI = 2,
199 	.FDRO = 3,
200 	.CMD = 4,
201 	.CTL = 5,
202 	.MASK = 6,
203 	.STAT = 7,
204 	.LOUT = 8,
205 	.COR = 9,
206 	.MFWR = 10,
207 	.FLR = UNIMPLEMENTED,
208 	.KEY = UNIMPLEMENTED,
209 	.CBC = 11,
210 	.IDCODE = 12,
211 	.AXSS = 13,
212 	.C0R_1 = 14,
213 	.CSOB = 15,
214 	.WBSTAR = 16,
215 	.TIMER = 17,
216 	.BOOTSTS = 22,
217 	.CTL_1 = 24,
218 };
219 
220 /**
221  * hwicap_command_desync - Send a DESYNC command to the ICAP port.
222  * @drvdata: a pointer to the drvdata.
223  *
224  * Returns: '0' on success and failure value on error
225  *
226  * This command desynchronizes the ICAP After this command, a
227  * bitstream containing a NULL packet, followed by a SYNCH packet is
228  * required before the ICAP will recognize commands.
229  */
230 static int hwicap_command_desync(struct hwicap_drvdata *drvdata)
231 {
232 	u32 buffer[4];
233 	u32 index = 0;
234 
235 	/*
236 	 * Create the data to be written to the ICAP.
237 	 */
238 	buffer[index++] = hwicap_type_1_write(drvdata->config_regs->CMD) | 1;
239 	buffer[index++] = XHI_CMD_DESYNCH;
240 	buffer[index++] = XHI_NOOP_PACKET;
241 	buffer[index++] = XHI_NOOP_PACKET;
242 
243 	/*
244 	 * Write the data to the FIFO and intiate the transfer of data present
245 	 * in the FIFO to the ICAP device.
246 	 */
247 	return drvdata->config->set_configuration(drvdata,
248 			&buffer[0], index);
249 }
250 
251 /**
252  * hwicap_get_configuration_register - Query a configuration register.
253  * @drvdata: a pointer to the drvdata.
254  * @reg: a constant which represents the configuration
255  * register value to be returned.
256  * Examples: XHI_IDCODE, XHI_FLR.
257  * @reg_data: returns the value of the register.
258  *
259  * Returns: '0' on success and failure value on error
260  *
261  * Sends a query packet to the ICAP and then receives the response.
262  * The icap is left in Synched state.
263  */
264 static int hwicap_get_configuration_register(struct hwicap_drvdata *drvdata,
265 		u32 reg, u32 *reg_data)
266 {
267 	int status;
268 	u32 buffer[6];
269 	u32 index = 0;
270 
271 	/*
272 	 * Create the data to be written to the ICAP.
273 	 */
274 	buffer[index++] = XHI_DUMMY_PACKET;
275 	buffer[index++] = XHI_NOOP_PACKET;
276 	buffer[index++] = XHI_SYNC_PACKET;
277 	buffer[index++] = XHI_NOOP_PACKET;
278 	buffer[index++] = XHI_NOOP_PACKET;
279 
280 	/*
281 	 * Write the data to the FIFO and initiate the transfer of data present
282 	 * in the FIFO to the ICAP device.
283 	 */
284 	status = drvdata->config->set_configuration(drvdata,
285 						    &buffer[0], index);
286 	if (status)
287 		return status;
288 
289 	/* If the syncword was not found, then we need to start over. */
290 	status = drvdata->config->get_status(drvdata);
291 	if ((status & XHI_SR_DALIGN_MASK) != XHI_SR_DALIGN_MASK)
292 		return -EIO;
293 
294 	index = 0;
295 	buffer[index++] = hwicap_type_1_read(reg) | 1;
296 	buffer[index++] = XHI_NOOP_PACKET;
297 	buffer[index++] = XHI_NOOP_PACKET;
298 
299 	/*
300 	 * Write the data to the FIFO and intiate the transfer of data present
301 	 * in the FIFO to the ICAP device.
302 	 */
303 	status = drvdata->config->set_configuration(drvdata,
304 			&buffer[0], index);
305 	if (status)
306 		return status;
307 
308 	/*
309 	 * Read the configuration register
310 	 */
311 	status = drvdata->config->get_configuration(drvdata, reg_data, 1);
312 	if (status)
313 		return status;
314 
315 	return 0;
316 }
317 
318 static int hwicap_initialize_hwicap(struct hwicap_drvdata *drvdata)
319 {
320 	int status;
321 	u32 idcode;
322 
323 	dev_dbg(drvdata->dev, "initializing\n");
324 
325 	/* Abort any current transaction, to make sure we have the
326 	 * ICAP in a good state.
327 	 */
328 	dev_dbg(drvdata->dev, "Reset...\n");
329 	drvdata->config->reset(drvdata);
330 
331 	dev_dbg(drvdata->dev, "Desync...\n");
332 	status = hwicap_command_desync(drvdata);
333 	if (status)
334 		return status;
335 
336 	/* Attempt to read the IDCODE from ICAP.  This
337 	 * may not be returned correctly, due to the design of the
338 	 * hardware.
339 	 */
340 	dev_dbg(drvdata->dev, "Reading IDCODE...\n");
341 	status = hwicap_get_configuration_register(
342 			drvdata, drvdata->config_regs->IDCODE, &idcode);
343 	dev_dbg(drvdata->dev, "IDCODE = %x\n", idcode);
344 	if (status)
345 		return status;
346 
347 	dev_dbg(drvdata->dev, "Desync...\n");
348 	status = hwicap_command_desync(drvdata);
349 	if (status)
350 		return status;
351 
352 	return 0;
353 }
354 
355 static ssize_t
356 hwicap_read(struct file *file, char __user *buf, size_t count, loff_t *ppos)
357 {
358 	struct hwicap_drvdata *drvdata = file->private_data;
359 	ssize_t bytes_to_read = 0;
360 	u32 *kbuf;
361 	u32 words;
362 	u32 bytes_remaining;
363 	int status;
364 
365 	status = mutex_lock_interruptible(&drvdata->sem);
366 	if (status)
367 		return status;
368 
369 	if (drvdata->read_buffer_in_use) {
370 		/* If there are leftover bytes in the buffer, just */
371 		/* return them and don't try to read more from the */
372 		/* ICAP device. */
373 		bytes_to_read =
374 			(count < drvdata->read_buffer_in_use) ? count :
375 			drvdata->read_buffer_in_use;
376 
377 		/* Return the data currently in the read buffer. */
378 		if (copy_to_user(buf, drvdata->read_buffer, bytes_to_read)) {
379 			status = -EFAULT;
380 			goto error;
381 		}
382 		drvdata->read_buffer_in_use -= bytes_to_read;
383 		memmove(drvdata->read_buffer,
384 		       drvdata->read_buffer + bytes_to_read,
385 		       4 - bytes_to_read);
386 	} else {
387 		/* Get new data from the ICAP, and return was was requested. */
388 		kbuf = (u32 *) get_zeroed_page(GFP_KERNEL);
389 		if (!kbuf) {
390 			status = -ENOMEM;
391 			goto error;
392 		}
393 
394 		/* The ICAP device is only able to read complete */
395 		/* words.  If a number of bytes that do not correspond */
396 		/* to complete words is requested, then we read enough */
397 		/* words to get the required number of bytes, and then */
398 		/* save the remaining bytes for the next read. */
399 
400 		/* Determine the number of words to read, rounding up */
401 		/* if necessary. */
402 		words = ((count + 3) >> 2);
403 		bytes_to_read = words << 2;
404 
405 		if (bytes_to_read > PAGE_SIZE)
406 			bytes_to_read = PAGE_SIZE;
407 
408 		/* Ensure we only read a complete number of words. */
409 		bytes_remaining = bytes_to_read & 3;
410 		bytes_to_read &= ~3;
411 		words = bytes_to_read >> 2;
412 
413 		status = drvdata->config->get_configuration(drvdata,
414 				kbuf, words);
415 
416 		/* If we didn't read correctly, then bail out. */
417 		if (status) {
418 			free_page((unsigned long)kbuf);
419 			goto error;
420 		}
421 
422 		/* If we fail to return the data to the user, then bail out. */
423 		if (copy_to_user(buf, kbuf, bytes_to_read)) {
424 			free_page((unsigned long)kbuf);
425 			status = -EFAULT;
426 			goto error;
427 		}
428 		memcpy(drvdata->read_buffer,
429 		       kbuf,
430 		       bytes_remaining);
431 		drvdata->read_buffer_in_use = bytes_remaining;
432 		free_page((unsigned long)kbuf);
433 	}
434 	status = bytes_to_read;
435  error:
436 	mutex_unlock(&drvdata->sem);
437 	return status;
438 }
439 
440 static ssize_t
441 hwicap_write(struct file *file, const char __user *buf,
442 		size_t count, loff_t *ppos)
443 {
444 	struct hwicap_drvdata *drvdata = file->private_data;
445 	ssize_t written = 0;
446 	ssize_t left = count;
447 	u32 *kbuf;
448 	ssize_t len;
449 	ssize_t status;
450 
451 	status = mutex_lock_interruptible(&drvdata->sem);
452 	if (status)
453 		return status;
454 
455 	left += drvdata->write_buffer_in_use;
456 
457 	/* Only write multiples of 4 bytes. */
458 	if (left < 4) {
459 		status = 0;
460 		goto error;
461 	}
462 
463 	kbuf = (u32 *) __get_free_page(GFP_KERNEL);
464 	if (!kbuf) {
465 		status = -ENOMEM;
466 		goto error;
467 	}
468 
469 	while (left > 3) {
470 		/* only write multiples of 4 bytes, so there might */
471 		/* be as many as 3 bytes left (at the end). */
472 		len = left;
473 
474 		if (len > PAGE_SIZE)
475 			len = PAGE_SIZE;
476 		len &= ~3;
477 
478 		if (drvdata->write_buffer_in_use) {
479 			memcpy(kbuf, drvdata->write_buffer,
480 					drvdata->write_buffer_in_use);
481 			if (copy_from_user(
482 			    (((char *)kbuf) + drvdata->write_buffer_in_use),
483 			    buf + written,
484 			    len - (drvdata->write_buffer_in_use))) {
485 				free_page((unsigned long)kbuf);
486 				status = -EFAULT;
487 				goto error;
488 			}
489 		} else {
490 			if (copy_from_user(kbuf, buf + written, len)) {
491 				free_page((unsigned long)kbuf);
492 				status = -EFAULT;
493 				goto error;
494 			}
495 		}
496 
497 		status = drvdata->config->set_configuration(drvdata,
498 				kbuf, len >> 2);
499 
500 		if (status) {
501 			free_page((unsigned long)kbuf);
502 			status = -EFAULT;
503 			goto error;
504 		}
505 		if (drvdata->write_buffer_in_use) {
506 			len -= drvdata->write_buffer_in_use;
507 			left -= drvdata->write_buffer_in_use;
508 			drvdata->write_buffer_in_use = 0;
509 		}
510 		written += len;
511 		left -= len;
512 	}
513 	if ((left > 0) && (left < 4)) {
514 		if (!copy_from_user(drvdata->write_buffer,
515 						buf + written, left)) {
516 			drvdata->write_buffer_in_use = left;
517 			written += left;
518 			left = 0;
519 		}
520 	}
521 
522 	free_page((unsigned long)kbuf);
523 	status = written;
524  error:
525 	mutex_unlock(&drvdata->sem);
526 	return status;
527 }
528 
529 static int hwicap_open(struct inode *inode, struct file *file)
530 {
531 	struct hwicap_drvdata *drvdata;
532 	int status;
533 
534 	mutex_lock(&hwicap_mutex);
535 	drvdata = container_of(inode->i_cdev, struct hwicap_drvdata, cdev);
536 
537 	status = mutex_lock_interruptible(&drvdata->sem);
538 	if (status)
539 		goto out;
540 
541 	if (drvdata->is_open) {
542 		status = -EBUSY;
543 		goto error;
544 	}
545 
546 	status = hwicap_initialize_hwicap(drvdata);
547 	if (status) {
548 		dev_err(drvdata->dev, "Failed to open file");
549 		goto error;
550 	}
551 
552 	file->private_data = drvdata;
553 	drvdata->write_buffer_in_use = 0;
554 	drvdata->read_buffer_in_use = 0;
555 	drvdata->is_open = 1;
556 
557  error:
558 	mutex_unlock(&drvdata->sem);
559  out:
560 	mutex_unlock(&hwicap_mutex);
561 	return status;
562 }
563 
564 static int hwicap_release(struct inode *inode, struct file *file)
565 {
566 	struct hwicap_drvdata *drvdata = file->private_data;
567 	int i;
568 	int status = 0;
569 
570 	mutex_lock(&drvdata->sem);
571 
572 	if (drvdata->write_buffer_in_use) {
573 		/* Flush write buffer. */
574 		for (i = drvdata->write_buffer_in_use; i < 4; i++)
575 			drvdata->write_buffer[i] = 0;
576 
577 		status = drvdata->config->set_configuration(drvdata,
578 				(u32 *) drvdata->write_buffer, 1);
579 		if (status)
580 			goto error;
581 	}
582 
583 	status = hwicap_command_desync(drvdata);
584 	if (status)
585 		goto error;
586 
587  error:
588 	drvdata->is_open = 0;
589 	mutex_unlock(&drvdata->sem);
590 	return status;
591 }
592 
593 static const struct file_operations hwicap_fops = {
594 	.owner = THIS_MODULE,
595 	.write = hwicap_write,
596 	.read = hwicap_read,
597 	.open = hwicap_open,
598 	.release = hwicap_release,
599 	.llseek = noop_llseek,
600 };
601 
602 static int hwicap_setup(struct device *dev, int id,
603 		const struct resource *regs_res,
604 		const struct hwicap_driver_config *config,
605 		const struct config_registers *config_regs)
606 {
607 	dev_t devt;
608 	struct hwicap_drvdata *drvdata = NULL;
609 	int retval = 0;
610 
611 	dev_info(dev, "Xilinx icap port driver\n");
612 
613 	mutex_lock(&icap_sem);
614 
615 	if (id < 0) {
616 		for (id = 0; id < HWICAP_DEVICES; id++)
617 			if (!probed_devices[id])
618 				break;
619 	}
620 	if (id < 0 || id >= HWICAP_DEVICES) {
621 		mutex_unlock(&icap_sem);
622 		dev_err(dev, "%s%i too large\n", DRIVER_NAME, id);
623 		return -EINVAL;
624 	}
625 	if (probed_devices[id]) {
626 		mutex_unlock(&icap_sem);
627 		dev_err(dev, "cannot assign to %s%i; it is already in use\n",
628 			DRIVER_NAME, id);
629 		return -EBUSY;
630 	}
631 
632 	probed_devices[id] = 1;
633 	mutex_unlock(&icap_sem);
634 
635 	devt = MKDEV(XHWICAP_MAJOR, XHWICAP_MINOR + id);
636 
637 	drvdata = kzalloc(sizeof(struct hwicap_drvdata), GFP_KERNEL);
638 	if (!drvdata) {
639 		retval = -ENOMEM;
640 		goto failed0;
641 	}
642 	dev_set_drvdata(dev, (void *)drvdata);
643 
644 	if (!regs_res) {
645 		dev_err(dev, "Couldn't get registers resource\n");
646 		retval = -EFAULT;
647 		goto failed1;
648 	}
649 
650 	drvdata->mem_start = regs_res->start;
651 	drvdata->mem_end = regs_res->end;
652 	drvdata->mem_size = resource_size(regs_res);
653 
654 	if (!request_mem_region(drvdata->mem_start,
655 					drvdata->mem_size, DRIVER_NAME)) {
656 		dev_err(dev, "Couldn't lock memory region at %Lx\n",
657 			(unsigned long long) regs_res->start);
658 		retval = -EBUSY;
659 		goto failed1;
660 	}
661 
662 	drvdata->devt = devt;
663 	drvdata->dev = dev;
664 	drvdata->base_address = ioremap(drvdata->mem_start, drvdata->mem_size);
665 	if (!drvdata->base_address) {
666 		dev_err(dev, "ioremap() failed\n");
667 		retval = -ENOMEM;
668 		goto failed2;
669 	}
670 
671 	drvdata->config = config;
672 	drvdata->config_regs = config_regs;
673 
674 	mutex_init(&drvdata->sem);
675 	drvdata->is_open = 0;
676 
677 	dev_info(dev, "ioremap %llx to %p with size %llx\n",
678 		 (unsigned long long) drvdata->mem_start,
679 		 drvdata->base_address,
680 		 (unsigned long long) drvdata->mem_size);
681 
682 	cdev_init(&drvdata->cdev, &hwicap_fops);
683 	drvdata->cdev.owner = THIS_MODULE;
684 	retval = cdev_add(&drvdata->cdev, devt, 1);
685 	if (retval) {
686 		dev_err(dev, "cdev_add() failed\n");
687 		goto failed3;
688 	}
689 
690 	device_create(icap_class, dev, devt, NULL, "%s%d", DRIVER_NAME, id);
691 	return 0;		/* success */
692 
693  failed3:
694 	iounmap(drvdata->base_address);
695 
696  failed2:
697 	release_mem_region(regs_res->start, drvdata->mem_size);
698 
699  failed1:
700 	kfree(drvdata);
701 
702  failed0:
703 	mutex_lock(&icap_sem);
704 	probed_devices[id] = 0;
705 	mutex_unlock(&icap_sem);
706 
707 	return retval;
708 }
709 
710 static struct hwicap_driver_config buffer_icap_config = {
711 	.get_configuration = buffer_icap_get_configuration,
712 	.set_configuration = buffer_icap_set_configuration,
713 	.get_status = buffer_icap_get_status,
714 	.reset = buffer_icap_reset,
715 };
716 
717 static struct hwicap_driver_config fifo_icap_config = {
718 	.get_configuration = fifo_icap_get_configuration,
719 	.set_configuration = fifo_icap_set_configuration,
720 	.get_status = fifo_icap_get_status,
721 	.reset = fifo_icap_reset,
722 };
723 
724 static int hwicap_remove(struct device *dev)
725 {
726 	struct hwicap_drvdata *drvdata;
727 
728 	drvdata = dev_get_drvdata(dev);
729 
730 	if (!drvdata)
731 		return 0;
732 
733 	device_destroy(icap_class, drvdata->devt);
734 	cdev_del(&drvdata->cdev);
735 	iounmap(drvdata->base_address);
736 	release_mem_region(drvdata->mem_start, drvdata->mem_size);
737 	kfree(drvdata);
738 
739 	mutex_lock(&icap_sem);
740 	probed_devices[MINOR(dev->devt)-XHWICAP_MINOR] = 0;
741 	mutex_unlock(&icap_sem);
742 	return 0;		/* success */
743 }
744 
745 #ifdef CONFIG_OF
746 static int hwicap_of_probe(struct platform_device *op,
747 				     const struct hwicap_driver_config *config)
748 {
749 	struct resource res;
750 	const unsigned int *id;
751 	const char *family;
752 	int rc;
753 	const struct config_registers *regs;
754 
755 
756 	rc = of_address_to_resource(op->dev.of_node, 0, &res);
757 	if (rc) {
758 		dev_err(&op->dev, "invalid address\n");
759 		return rc;
760 	}
761 
762 	id = of_get_property(op->dev.of_node, "port-number", NULL);
763 
764 	/* It's most likely that we're using V4, if the family is not
765 	 * specified
766 	 */
767 	regs = &v4_config_registers;
768 	family = of_get_property(op->dev.of_node, "xlnx,family", NULL);
769 
770 	if (family) {
771 		if (!strcmp(family, "virtex2p"))
772 			regs = &v2_config_registers;
773 		else if (!strcmp(family, "virtex4"))
774 			regs = &v4_config_registers;
775 		else if (!strcmp(family, "virtex5"))
776 			regs = &v5_config_registers;
777 		else if (!strcmp(family, "virtex6"))
778 			regs = &v6_config_registers;
779 	}
780 	return hwicap_setup(&op->dev, id ? *id : -1, &res, config,
781 			regs);
782 }
783 #else
784 static inline int hwicap_of_probe(struct platform_device *op,
785 				  const struct hwicap_driver_config *config)
786 {
787 	return -EINVAL;
788 }
789 #endif /* CONFIG_OF */
790 
791 static const struct of_device_id hwicap_of_match[];
792 static int hwicap_drv_probe(struct platform_device *pdev)
793 {
794 	const struct of_device_id *match;
795 	struct resource *res;
796 	const struct config_registers *regs;
797 	const char *family;
798 
799 	match = of_match_device(hwicap_of_match, &pdev->dev);
800 	if (match)
801 		return hwicap_of_probe(pdev, match->data);
802 
803 	res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
804 	if (!res)
805 		return -ENODEV;
806 
807 	/* It's most likely that we're using V4, if the family is not
808 	 * specified
809 	 */
810 	regs = &v4_config_registers;
811 	family = pdev->dev.platform_data;
812 
813 	if (family) {
814 		if (!strcmp(family, "virtex2p"))
815 			regs = &v2_config_registers;
816 		else if (!strcmp(family, "virtex4"))
817 			regs = &v4_config_registers;
818 		else if (!strcmp(family, "virtex5"))
819 			regs = &v5_config_registers;
820 		else if (!strcmp(family, "virtex6"))
821 			regs = &v6_config_registers;
822 	}
823 
824 	return hwicap_setup(&pdev->dev, pdev->id, res,
825 			&buffer_icap_config, regs);
826 }
827 
828 static int hwicap_drv_remove(struct platform_device *pdev)
829 {
830 	return hwicap_remove(&pdev->dev);
831 }
832 
833 #ifdef CONFIG_OF
834 /* Match table for device tree binding */
835 static const struct of_device_id hwicap_of_match[] = {
836 	{ .compatible = "xlnx,opb-hwicap-1.00.b", .data = &buffer_icap_config},
837 	{ .compatible = "xlnx,xps-hwicap-1.00.a", .data = &fifo_icap_config},
838 	{},
839 };
840 MODULE_DEVICE_TABLE(of, hwicap_of_match);
841 #else
842 #define hwicap_of_match NULL
843 #endif
844 
845 static struct platform_driver hwicap_platform_driver = {
846 	.probe = hwicap_drv_probe,
847 	.remove = hwicap_drv_remove,
848 	.driver = {
849 		.name = DRIVER_NAME,
850 		.of_match_table = hwicap_of_match,
851 	},
852 };
853 
854 static int __init hwicap_module_init(void)
855 {
856 	dev_t devt;
857 	int retval;
858 
859 	icap_class = class_create(THIS_MODULE, "xilinx_config");
860 	mutex_init(&icap_sem);
861 
862 	devt = MKDEV(XHWICAP_MAJOR, XHWICAP_MINOR);
863 	retval = register_chrdev_region(devt,
864 					HWICAP_DEVICES,
865 					DRIVER_NAME);
866 	if (retval < 0)
867 		return retval;
868 
869 	retval = platform_driver_register(&hwicap_platform_driver);
870 	if (retval)
871 		goto failed;
872 
873 	return retval;
874 
875  failed:
876 	unregister_chrdev_region(devt, HWICAP_DEVICES);
877 
878 	return retval;
879 }
880 
881 static void __exit hwicap_module_cleanup(void)
882 {
883 	dev_t devt = MKDEV(XHWICAP_MAJOR, XHWICAP_MINOR);
884 
885 	class_destroy(icap_class);
886 
887 	platform_driver_unregister(&hwicap_platform_driver);
888 
889 	unregister_chrdev_region(devt, HWICAP_DEVICES);
890 }
891 
892 module_init(hwicap_module_init);
893 module_exit(hwicap_module_cleanup);
894 
895 MODULE_AUTHOR("Xilinx, Inc; Xilinx Research Labs Group");
896 MODULE_DESCRIPTION("Xilinx ICAP Port Driver");
897 MODULE_LICENSE("GPL");
898