uio.c 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732
  1. /*
  2. * drivers/uio/uio.c
  3. *
  4. * Copyright(C) 2005, Benedikt Spranger <b.spranger@linutronix.de>
  5. * Copyright(C) 2005, Thomas Gleixner <tglx@linutronix.de>
  6. * Copyright(C) 2006, Hans J. Koch <hjk@linutronix.de>
  7. * Copyright(C) 2006, Greg Kroah-Hartman <greg@kroah.com>
  8. *
  9. * Userspace IO
  10. *
  11. * Base Functions
  12. *
  13. * Licensed under the GPLv2 only.
  14. */
  15. #include <linux/module.h>
  16. #include <linux/init.h>
  17. #include <linux/poll.h>
  18. #include <linux/device.h>
  19. #include <linux/mm.h>
  20. #include <linux/idr.h>
  21. #include <linux/string.h>
  22. #include <linux/kobject.h>
  23. #include <linux/uio_driver.h>
  24. #define UIO_MAX_DEVICES 255
  25. struct uio_device {
  26. struct module *owner;
  27. struct device *dev;
  28. int minor;
  29. atomic_t event;
  30. struct fasync_struct *async_queue;
  31. wait_queue_head_t wait;
  32. int vma_count;
  33. struct uio_info *info;
  34. struct kobject *map_dir;
  35. };
  36. static int uio_major;
  37. static DEFINE_IDR(uio_idr);
  38. static const struct file_operations uio_fops;
  39. /* UIO class infrastructure */
  40. static struct uio_class {
  41. struct kref kref;
  42. struct class *class;
  43. } *uio_class;
  44. /*
  45. * attributes
  46. */
  47. struct uio_map {
  48. struct kobject kobj;
  49. struct uio_mem *mem;
  50. };
  51. #define to_map(map) container_of(map, struct uio_map, kobj)
  52. static ssize_t map_addr_show(struct uio_mem *mem, char *buf)
  53. {
  54. return sprintf(buf, "0x%lx\n", mem->addr);
  55. }
  56. static ssize_t map_size_show(struct uio_mem *mem, char *buf)
  57. {
  58. return sprintf(buf, "0x%lx\n", mem->size);
  59. }
  60. struct uio_sysfs_entry {
  61. struct attribute attr;
  62. ssize_t (*show)(struct uio_mem *, char *);
  63. ssize_t (*store)(struct uio_mem *, const char *, size_t);
  64. };
  65. static struct uio_sysfs_entry addr_attribute =
  66. __ATTR(addr, S_IRUGO, map_addr_show, NULL);
  67. static struct uio_sysfs_entry size_attribute =
  68. __ATTR(size, S_IRUGO, map_size_show, NULL);
  69. static struct attribute *attrs[] = {
  70. &addr_attribute.attr,
  71. &size_attribute.attr,
  72. NULL, /* need to NULL terminate the list of attributes */
  73. };
  74. static void map_release(struct kobject *kobj)
  75. {
  76. struct uio_map *map = to_map(kobj);
  77. kfree(map);
  78. }
  79. static ssize_t map_type_show(struct kobject *kobj, struct attribute *attr,
  80. char *buf)
  81. {
  82. struct uio_map *map = to_map(kobj);
  83. struct uio_mem *mem = map->mem;
  84. struct uio_sysfs_entry *entry;
  85. entry = container_of(attr, struct uio_sysfs_entry, attr);
  86. if (!entry->show)
  87. return -EIO;
  88. return entry->show(mem, buf);
  89. }
  90. static struct sysfs_ops uio_sysfs_ops = {
  91. .show = map_type_show,
  92. };
  93. static struct kobj_type map_attr_type = {
  94. .release = map_release,
  95. .sysfs_ops = &uio_sysfs_ops,
  96. .default_attrs = attrs,
  97. };
  98. static ssize_t show_name(struct device *dev,
  99. struct device_attribute *attr, char *buf)
  100. {
  101. struct uio_device *idev = dev_get_drvdata(dev);
  102. if (idev)
  103. return sprintf(buf, "%s\n", idev->info->name);
  104. else
  105. return -ENODEV;
  106. }
  107. static DEVICE_ATTR(name, S_IRUGO, show_name, NULL);
  108. static ssize_t show_version(struct device *dev,
  109. struct device_attribute *attr, char *buf)
  110. {
  111. struct uio_device *idev = dev_get_drvdata(dev);
  112. if (idev)
  113. return sprintf(buf, "%s\n", idev->info->version);
  114. else
  115. return -ENODEV;
  116. }
  117. static DEVICE_ATTR(version, S_IRUGO, show_version, NULL);
  118. static ssize_t show_event(struct device *dev,
  119. struct device_attribute *attr, char *buf)
  120. {
  121. struct uio_device *idev = dev_get_drvdata(dev);
  122. if (idev)
  123. return sprintf(buf, "%u\n",
  124. (unsigned int)atomic_read(&idev->event));
  125. else
  126. return -ENODEV;
  127. }
  128. static DEVICE_ATTR(event, S_IRUGO, show_event, NULL);
  129. static struct attribute *uio_attrs[] = {
  130. &dev_attr_name.attr,
  131. &dev_attr_version.attr,
  132. &dev_attr_event.attr,
  133. NULL,
  134. };
  135. static struct attribute_group uio_attr_grp = {
  136. .attrs = uio_attrs,
  137. };
  138. /*
  139. * device functions
  140. */
  141. static int uio_dev_add_attributes(struct uio_device *idev)
  142. {
  143. int ret;
  144. int mi;
  145. int map_found = 0;
  146. struct uio_mem *mem;
  147. struct uio_map *map;
  148. ret = sysfs_create_group(&idev->dev->kobj, &uio_attr_grp);
  149. if (ret)
  150. goto err_group;
  151. for (mi = 0; mi < MAX_UIO_MAPS; mi++) {
  152. mem = &idev->info->mem[mi];
  153. if (mem->size == 0)
  154. break;
  155. if (!map_found) {
  156. map_found = 1;
  157. idev->map_dir = kobject_create_and_add("maps",
  158. &idev->dev->kobj);
  159. if (!idev->map_dir)
  160. goto err;
  161. }
  162. map = kzalloc(sizeof(*map), GFP_KERNEL);
  163. if (!map)
  164. goto err;
  165. kobject_init(&map->kobj, &map_attr_type);
  166. map->mem = mem;
  167. mem->map = map;
  168. ret = kobject_add(&map->kobj, idev->map_dir, "map%d", mi);
  169. if (ret)
  170. goto err;
  171. ret = kobject_uevent(&map->kobj, KOBJ_ADD);
  172. if (ret)
  173. goto err;
  174. }
  175. return 0;
  176. err:
  177. for (mi--; mi>=0; mi--) {
  178. mem = &idev->info->mem[mi];
  179. map = mem->map;
  180. kobject_put(&map->kobj);
  181. }
  182. kobject_put(idev->map_dir);
  183. sysfs_remove_group(&idev->dev->kobj, &uio_attr_grp);
  184. err_group:
  185. dev_err(idev->dev, "error creating sysfs files (%d)\n", ret);
  186. return ret;
  187. }
  188. static void uio_dev_del_attributes(struct uio_device *idev)
  189. {
  190. int mi;
  191. struct uio_mem *mem;
  192. for (mi = 0; mi < MAX_UIO_MAPS; mi++) {
  193. mem = &idev->info->mem[mi];
  194. if (mem->size == 0)
  195. break;
  196. kobject_put(&mem->map->kobj);
  197. }
  198. kobject_put(idev->map_dir);
  199. sysfs_remove_group(&idev->dev->kobj, &uio_attr_grp);
  200. }
  201. static int uio_get_minor(struct uio_device *idev)
  202. {
  203. static DEFINE_MUTEX(minor_lock);
  204. int retval = -ENOMEM;
  205. int id;
  206. mutex_lock(&minor_lock);
  207. if (idr_pre_get(&uio_idr, GFP_KERNEL) == 0)
  208. goto exit;
  209. retval = idr_get_new(&uio_idr, idev, &id);
  210. if (retval < 0) {
  211. if (retval == -EAGAIN)
  212. retval = -ENOMEM;
  213. goto exit;
  214. }
  215. idev->minor = id & MAX_ID_MASK;
  216. exit:
  217. mutex_unlock(&minor_lock);
  218. return retval;
  219. }
  220. static void uio_free_minor(struct uio_device *idev)
  221. {
  222. idr_remove(&uio_idr, idev->minor);
  223. }
  224. /**
  225. * uio_event_notify - trigger an interrupt event
  226. * @info: UIO device capabilities
  227. */
  228. void uio_event_notify(struct uio_info *info)
  229. {
  230. struct uio_device *idev = info->uio_dev;
  231. atomic_inc(&idev->event);
  232. wake_up_interruptible(&idev->wait);
  233. kill_fasync(&idev->async_queue, SIGIO, POLL_IN);
  234. }
  235. EXPORT_SYMBOL_GPL(uio_event_notify);
  236. /**
  237. * uio_interrupt - hardware interrupt handler
  238. * @irq: IRQ number, can be UIO_IRQ_CYCLIC for cyclic timer
  239. * @dev_id: Pointer to the devices uio_device structure
  240. */
  241. static irqreturn_t uio_interrupt(int irq, void *dev_id)
  242. {
  243. struct uio_device *idev = (struct uio_device *)dev_id;
  244. irqreturn_t ret = idev->info->handler(irq, idev->info);
  245. if (ret == IRQ_HANDLED)
  246. uio_event_notify(idev->info);
  247. return ret;
  248. }
  249. struct uio_listener {
  250. struct uio_device *dev;
  251. s32 event_count;
  252. };
  253. static int uio_open(struct inode *inode, struct file *filep)
  254. {
  255. struct uio_device *idev;
  256. struct uio_listener *listener;
  257. int ret = 0;
  258. idev = idr_find(&uio_idr, iminor(inode));
  259. if (!idev)
  260. return -ENODEV;
  261. if (!try_module_get(idev->owner))
  262. return -ENODEV;
  263. listener = kmalloc(sizeof(*listener), GFP_KERNEL);
  264. if (!listener) {
  265. ret = -ENOMEM;
  266. goto err_alloc_listener;
  267. }
  268. listener->dev = idev;
  269. listener->event_count = atomic_read(&idev->event);
  270. filep->private_data = listener;
  271. if (idev->info->open) {
  272. ret = idev->info->open(idev->info, inode);
  273. if (ret)
  274. goto err_infoopen;
  275. }
  276. return 0;
  277. err_infoopen:
  278. kfree(listener);
  279. err_alloc_listener:
  280. module_put(idev->owner);
  281. return ret;
  282. }
  283. static int uio_fasync(int fd, struct file *filep, int on)
  284. {
  285. struct uio_listener *listener = filep->private_data;
  286. struct uio_device *idev = listener->dev;
  287. return fasync_helper(fd, filep, on, &idev->async_queue);
  288. }
  289. static int uio_release(struct inode *inode, struct file *filep)
  290. {
  291. int ret = 0;
  292. struct uio_listener *listener = filep->private_data;
  293. struct uio_device *idev = listener->dev;
  294. if (idev->info->release)
  295. ret = idev->info->release(idev->info, inode);
  296. module_put(idev->owner);
  297. if (filep->f_flags & FASYNC)
  298. ret = uio_fasync(-1, filep, 0);
  299. kfree(listener);
  300. return ret;
  301. }
  302. static unsigned int uio_poll(struct file *filep, poll_table *wait)
  303. {
  304. struct uio_listener *listener = filep->private_data;
  305. struct uio_device *idev = listener->dev;
  306. if (idev->info->irq == UIO_IRQ_NONE)
  307. return -EIO;
  308. poll_wait(filep, &idev->wait, wait);
  309. if (listener->event_count != atomic_read(&idev->event))
  310. return POLLIN | POLLRDNORM;
  311. return 0;
  312. }
  313. static ssize_t uio_read(struct file *filep, char __user *buf,
  314. size_t count, loff_t *ppos)
  315. {
  316. struct uio_listener *listener = filep->private_data;
  317. struct uio_device *idev = listener->dev;
  318. DECLARE_WAITQUEUE(wait, current);
  319. ssize_t retval;
  320. s32 event_count;
  321. if (idev->info->irq == UIO_IRQ_NONE)
  322. return -EIO;
  323. if (count != sizeof(s32))
  324. return -EINVAL;
  325. add_wait_queue(&idev->wait, &wait);
  326. do {
  327. set_current_state(TASK_INTERRUPTIBLE);
  328. event_count = atomic_read(&idev->event);
  329. if (event_count != listener->event_count) {
  330. if (copy_to_user(buf, &event_count, count))
  331. retval = -EFAULT;
  332. else {
  333. listener->event_count = event_count;
  334. retval = count;
  335. }
  336. break;
  337. }
  338. if (filep->f_flags & O_NONBLOCK) {
  339. retval = -EAGAIN;
  340. break;
  341. }
  342. if (signal_pending(current)) {
  343. retval = -ERESTARTSYS;
  344. break;
  345. }
  346. schedule();
  347. } while (1);
  348. __set_current_state(TASK_RUNNING);
  349. remove_wait_queue(&idev->wait, &wait);
  350. return retval;
  351. }
  352. static int uio_find_mem_index(struct vm_area_struct *vma)
  353. {
  354. int mi;
  355. struct uio_device *idev = vma->vm_private_data;
  356. for (mi = 0; mi < MAX_UIO_MAPS; mi++) {
  357. if (idev->info->mem[mi].size == 0)
  358. return -1;
  359. if (vma->vm_pgoff == mi)
  360. return mi;
  361. }
  362. return -1;
  363. }
  364. static void uio_vma_open(struct vm_area_struct *vma)
  365. {
  366. struct uio_device *idev = vma->vm_private_data;
  367. idev->vma_count++;
  368. }
  369. static void uio_vma_close(struct vm_area_struct *vma)
  370. {
  371. struct uio_device *idev = vma->vm_private_data;
  372. idev->vma_count--;
  373. }
  374. static int uio_vma_fault(struct vm_area_struct *vma, struct vm_fault *vmf)
  375. {
  376. struct uio_device *idev = vma->vm_private_data;
  377. struct page *page;
  378. int mi = uio_find_mem_index(vma);
  379. if (mi < 0)
  380. return VM_FAULT_SIGBUS;
  381. if (idev->info->mem[mi].memtype == UIO_MEM_LOGICAL)
  382. page = virt_to_page(idev->info->mem[mi].addr);
  383. else
  384. page = vmalloc_to_page((void*)idev->info->mem[mi].addr);
  385. get_page(page);
  386. vmf->page = page;
  387. return 0;
  388. }
  389. static struct vm_operations_struct uio_vm_ops = {
  390. .open = uio_vma_open,
  391. .close = uio_vma_close,
  392. .fault = uio_vma_fault,
  393. };
  394. static int uio_mmap_physical(struct vm_area_struct *vma)
  395. {
  396. struct uio_device *idev = vma->vm_private_data;
  397. int mi = uio_find_mem_index(vma);
  398. if (mi < 0)
  399. return -EINVAL;
  400. vma->vm_flags |= VM_IO | VM_RESERVED;
  401. vma->vm_page_prot = pgprot_noncached(vma->vm_page_prot);
  402. return remap_pfn_range(vma,
  403. vma->vm_start,
  404. idev->info->mem[mi].addr >> PAGE_SHIFT,
  405. vma->vm_end - vma->vm_start,
  406. vma->vm_page_prot);
  407. }
  408. static int uio_mmap_logical(struct vm_area_struct *vma)
  409. {
  410. vma->vm_flags |= VM_RESERVED;
  411. vma->vm_ops = &uio_vm_ops;
  412. uio_vma_open(vma);
  413. return 0;
  414. }
  415. static int uio_mmap(struct file *filep, struct vm_area_struct *vma)
  416. {
  417. struct uio_listener *listener = filep->private_data;
  418. struct uio_device *idev = listener->dev;
  419. int mi;
  420. unsigned long requested_pages, actual_pages;
  421. int ret = 0;
  422. if (vma->vm_end < vma->vm_start)
  423. return -EINVAL;
  424. vma->vm_private_data = idev;
  425. mi = uio_find_mem_index(vma);
  426. if (mi < 0)
  427. return -EINVAL;
  428. requested_pages = (vma->vm_end - vma->vm_start) >> PAGE_SHIFT;
  429. actual_pages = (idev->info->mem[mi].size + PAGE_SIZE -1) >> PAGE_SHIFT;
  430. if (requested_pages > actual_pages)
  431. return -EINVAL;
  432. if (idev->info->mmap) {
  433. ret = idev->info->mmap(idev->info, vma);
  434. return ret;
  435. }
  436. switch (idev->info->mem[mi].memtype) {
  437. case UIO_MEM_PHYS:
  438. return uio_mmap_physical(vma);
  439. case UIO_MEM_LOGICAL:
  440. case UIO_MEM_VIRTUAL:
  441. return uio_mmap_logical(vma);
  442. default:
  443. return -EINVAL;
  444. }
  445. }
  446. static const struct file_operations uio_fops = {
  447. .owner = THIS_MODULE,
  448. .open = uio_open,
  449. .release = uio_release,
  450. .read = uio_read,
  451. .mmap = uio_mmap,
  452. .poll = uio_poll,
  453. .fasync = uio_fasync,
  454. };
  455. static int uio_major_init(void)
  456. {
  457. uio_major = register_chrdev(0, "uio", &uio_fops);
  458. if (uio_major < 0)
  459. return uio_major;
  460. return 0;
  461. }
  462. static void uio_major_cleanup(void)
  463. {
  464. unregister_chrdev(uio_major, "uio");
  465. }
  466. static int init_uio_class(void)
  467. {
  468. int ret = 0;
  469. if (uio_class != NULL) {
  470. kref_get(&uio_class->kref);
  471. goto exit;
  472. }
  473. /* This is the first time in here, set everything up properly */
  474. ret = uio_major_init();
  475. if (ret)
  476. goto exit;
  477. uio_class = kzalloc(sizeof(*uio_class), GFP_KERNEL);
  478. if (!uio_class) {
  479. ret = -ENOMEM;
  480. goto err_kzalloc;
  481. }
  482. kref_init(&uio_class->kref);
  483. uio_class->class = class_create(THIS_MODULE, "uio");
  484. if (IS_ERR(uio_class->class)) {
  485. ret = IS_ERR(uio_class->class);
  486. printk(KERN_ERR "class_create failed for uio\n");
  487. goto err_class_create;
  488. }
  489. return 0;
  490. err_class_create:
  491. kfree(uio_class);
  492. uio_class = NULL;
  493. err_kzalloc:
  494. uio_major_cleanup();
  495. exit:
  496. return ret;
  497. }
  498. static void release_uio_class(struct kref *kref)
  499. {
  500. /* Ok, we cheat as we know we only have one uio_class */
  501. class_destroy(uio_class->class);
  502. kfree(uio_class);
  503. uio_major_cleanup();
  504. uio_class = NULL;
  505. }
  506. static void uio_class_destroy(void)
  507. {
  508. if (uio_class)
  509. kref_put(&uio_class->kref, release_uio_class);
  510. }
  511. /**
  512. * uio_register_device - register a new userspace IO device
  513. * @owner: module that creates the new device
  514. * @parent: parent device
  515. * @info: UIO device capabilities
  516. *
  517. * returns zero on success or a negative error code.
  518. */
  519. int __uio_register_device(struct module *owner,
  520. struct device *parent,
  521. struct uio_info *info)
  522. {
  523. struct uio_device *idev;
  524. int ret = 0;
  525. if (!parent || !info || !info->name || !info->version)
  526. return -EINVAL;
  527. info->uio_dev = NULL;
  528. ret = init_uio_class();
  529. if (ret)
  530. return ret;
  531. idev = kzalloc(sizeof(*idev), GFP_KERNEL);
  532. if (!idev) {
  533. ret = -ENOMEM;
  534. goto err_kzalloc;
  535. }
  536. idev->owner = owner;
  537. idev->info = info;
  538. init_waitqueue_head(&idev->wait);
  539. atomic_set(&idev->event, 0);
  540. ret = uio_get_minor(idev);
  541. if (ret)
  542. goto err_get_minor;
  543. idev->dev = device_create(uio_class->class, parent,
  544. MKDEV(uio_major, idev->minor),
  545. "uio%d", idev->minor);
  546. if (IS_ERR(idev->dev)) {
  547. printk(KERN_ERR "UIO: device register failed\n");
  548. ret = PTR_ERR(idev->dev);
  549. goto err_device_create;
  550. }
  551. dev_set_drvdata(idev->dev, idev);
  552. ret = uio_dev_add_attributes(idev);
  553. if (ret)
  554. goto err_uio_dev_add_attributes;
  555. info->uio_dev = idev;
  556. if (idev->info->irq >= 0) {
  557. ret = request_irq(idev->info->irq, uio_interrupt,
  558. idev->info->irq_flags, idev->info->name, idev);
  559. if (ret)
  560. goto err_request_irq;
  561. }
  562. return 0;
  563. err_request_irq:
  564. uio_dev_del_attributes(idev);
  565. err_uio_dev_add_attributes:
  566. device_destroy(uio_class->class, MKDEV(uio_major, idev->minor));
  567. err_device_create:
  568. uio_free_minor(idev);
  569. err_get_minor:
  570. kfree(idev);
  571. err_kzalloc:
  572. uio_class_destroy();
  573. return ret;
  574. }
  575. EXPORT_SYMBOL_GPL(__uio_register_device);
  576. /**
  577. * uio_unregister_device - unregister a industrial IO device
  578. * @info: UIO device capabilities
  579. *
  580. */
  581. void uio_unregister_device(struct uio_info *info)
  582. {
  583. struct uio_device *idev;
  584. if (!info || !info->uio_dev)
  585. return;
  586. idev = info->uio_dev;
  587. uio_free_minor(idev);
  588. if (info->irq >= 0)
  589. free_irq(info->irq, idev);
  590. uio_dev_del_attributes(idev);
  591. dev_set_drvdata(idev->dev, NULL);
  592. device_destroy(uio_class->class, MKDEV(uio_major, idev->minor));
  593. kfree(idev);
  594. uio_class_destroy();
  595. return;
  596. }
  597. EXPORT_SYMBOL_GPL(uio_unregister_device);
  598. static int __init uio_init(void)
  599. {
  600. return 0;
  601. }
  602. static void __exit uio_exit(void)
  603. {
  604. }
  605. module_init(uio_init)
  606. module_exit(uio_exit)
  607. MODULE_LICENSE("GPL v2");