v4l2-device.c 7.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279
  1. /*
  2. V4L2 device support.
  3. Copyright (C) 2008 Hans Verkuil <hverkuil@xs4all.nl>
  4. This program is free software; you can redistribute it and/or modify
  5. it under the terms of the GNU General Public License as published by
  6. the Free Software Foundation; either version 2 of the License, or
  7. (at your option) any later version.
  8. This program is distributed in the hope that it will be useful,
  9. but WITHOUT ANY WARRANTY; without even the implied warranty of
  10. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  11. GNU General Public License for more details.
  12. You should have received a copy of the GNU General Public License
  13. along with this program; if not, write to the Free Software
  14. Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  15. */
  16. #include <linux/types.h>
  17. #include <linux/ioctl.h>
  18. #include <linux/module.h>
  19. #include <linux/i2c.h>
  20. #include <linux/slab.h>
  21. #if defined(CONFIG_SPI)
  22. #include <linux/spi/spi.h>
  23. #endif
  24. #include <linux/videodev2.h>
  25. #include <media/v4l2-device.h>
  26. #include <media/v4l2-ctrls.h>
  27. int v4l2_device_register(struct device *dev, struct v4l2_device *v4l2_dev)
  28. {
  29. if (v4l2_dev == NULL)
  30. return -EINVAL;
  31. INIT_LIST_HEAD(&v4l2_dev->subdevs);
  32. spin_lock_init(&v4l2_dev->lock);
  33. mutex_init(&v4l2_dev->ioctl_lock);
  34. v4l2_prio_init(&v4l2_dev->prio);
  35. kref_init(&v4l2_dev->ref);
  36. get_device(dev);
  37. v4l2_dev->dev = dev;
  38. if (dev == NULL) {
  39. /* If dev == NULL, then name must be filled in by the caller */
  40. WARN_ON(!v4l2_dev->name[0]);
  41. return 0;
  42. }
  43. /* Set name to driver name + device name if it is empty. */
  44. if (!v4l2_dev->name[0])
  45. snprintf(v4l2_dev->name, sizeof(v4l2_dev->name), "%s %s",
  46. dev->driver->name, dev_name(dev));
  47. if (!dev_get_drvdata(dev))
  48. dev_set_drvdata(dev, v4l2_dev);
  49. return 0;
  50. }
  51. EXPORT_SYMBOL_GPL(v4l2_device_register);
  52. static void v4l2_device_release(struct kref *ref)
  53. {
  54. struct v4l2_device *v4l2_dev =
  55. container_of(ref, struct v4l2_device, ref);
  56. if (v4l2_dev->release)
  57. v4l2_dev->release(v4l2_dev);
  58. }
  59. int v4l2_device_put(struct v4l2_device *v4l2_dev)
  60. {
  61. return kref_put(&v4l2_dev->ref, v4l2_device_release);
  62. }
  63. EXPORT_SYMBOL_GPL(v4l2_device_put);
  64. int v4l2_device_set_name(struct v4l2_device *v4l2_dev, const char *basename,
  65. atomic_t *instance)
  66. {
  67. int num = atomic_inc_return(instance) - 1;
  68. int len = strlen(basename);
  69. if (basename[len - 1] >= '0' && basename[len - 1] <= '9')
  70. snprintf(v4l2_dev->name, sizeof(v4l2_dev->name),
  71. "%s-%d", basename, num);
  72. else
  73. snprintf(v4l2_dev->name, sizeof(v4l2_dev->name),
  74. "%s%d", basename, num);
  75. return num;
  76. }
  77. EXPORT_SYMBOL_GPL(v4l2_device_set_name);
  78. void v4l2_device_disconnect(struct v4l2_device *v4l2_dev)
  79. {
  80. if (v4l2_dev->dev == NULL)
  81. return;
  82. if (dev_get_drvdata(v4l2_dev->dev) == v4l2_dev)
  83. dev_set_drvdata(v4l2_dev->dev, NULL);
  84. put_device(v4l2_dev->dev);
  85. v4l2_dev->dev = NULL;
  86. }
  87. EXPORT_SYMBOL_GPL(v4l2_device_disconnect);
  88. void v4l2_device_unregister(struct v4l2_device *v4l2_dev)
  89. {
  90. struct v4l2_subdev *sd, *next;
  91. if (v4l2_dev == NULL)
  92. return;
  93. v4l2_device_disconnect(v4l2_dev);
  94. /* Unregister subdevs */
  95. list_for_each_entry_safe(sd, next, &v4l2_dev->subdevs, list) {
  96. v4l2_device_unregister_subdev(sd);
  97. #if defined(CONFIG_I2C) || (defined(CONFIG_I2C_MODULE) && defined(MODULE))
  98. if (sd->flags & V4L2_SUBDEV_FL_IS_I2C) {
  99. struct i2c_client *client = v4l2_get_subdevdata(sd);
  100. /* We need to unregister the i2c client explicitly.
  101. We cannot rely on i2c_del_adapter to always
  102. unregister clients for us, since if the i2c bus
  103. is a platform bus, then it is never deleted. */
  104. if (client)
  105. i2c_unregister_device(client);
  106. continue;
  107. }
  108. #endif
  109. #if defined(CONFIG_SPI)
  110. if (sd->flags & V4L2_SUBDEV_FL_IS_SPI) {
  111. struct spi_device *spi = v4l2_get_subdevdata(sd);
  112. if (spi)
  113. spi_unregister_device(spi);
  114. continue;
  115. }
  116. #endif
  117. }
  118. }
  119. EXPORT_SYMBOL_GPL(v4l2_device_unregister);
  120. int v4l2_device_register_subdev(struct v4l2_device *v4l2_dev,
  121. struct v4l2_subdev *sd)
  122. {
  123. #if defined(CONFIG_MEDIA_CONTROLLER)
  124. struct media_entity *entity = &sd->entity;
  125. #endif
  126. int err;
  127. /* Check for valid input */
  128. if (v4l2_dev == NULL || sd == NULL || !sd->name[0])
  129. return -EINVAL;
  130. /* Warn if we apparently re-register a subdev */
  131. WARN_ON(sd->v4l2_dev != NULL);
  132. if (!try_module_get(sd->owner))
  133. return -ENODEV;
  134. sd->v4l2_dev = v4l2_dev;
  135. if (sd->internal_ops && sd->internal_ops->registered) {
  136. err = sd->internal_ops->registered(sd);
  137. if (err)
  138. goto error_module;
  139. }
  140. /* This just returns 0 if either of the two args is NULL */
  141. err = v4l2_ctrl_add_handler(v4l2_dev->ctrl_handler, sd->ctrl_handler);
  142. if (err)
  143. goto error_unregister;
  144. #if defined(CONFIG_MEDIA_CONTROLLER)
  145. /* Register the entity. */
  146. if (v4l2_dev->mdev) {
  147. err = media_device_register_entity(v4l2_dev->mdev, entity);
  148. if (err < 0)
  149. goto error_unregister;
  150. }
  151. #endif
  152. spin_lock(&v4l2_dev->lock);
  153. list_add_tail(&sd->list, &v4l2_dev->subdevs);
  154. spin_unlock(&v4l2_dev->lock);
  155. return 0;
  156. error_unregister:
  157. if (sd->internal_ops && sd->internal_ops->unregistered)
  158. sd->internal_ops->unregistered(sd);
  159. error_module:
  160. module_put(sd->owner);
  161. sd->v4l2_dev = NULL;
  162. return err;
  163. }
  164. EXPORT_SYMBOL_GPL(v4l2_device_register_subdev);
  165. static void v4l2_device_release_subdev_node(struct video_device *vdev)
  166. {
  167. struct v4l2_subdev *sd = video_get_drvdata(vdev);
  168. sd->devnode = NULL;
  169. kfree(vdev);
  170. }
  171. int v4l2_device_register_subdev_nodes(struct v4l2_device *v4l2_dev)
  172. {
  173. struct video_device *vdev;
  174. struct v4l2_subdev *sd;
  175. int err;
  176. /* Register a device node for every subdev marked with the
  177. * V4L2_SUBDEV_FL_HAS_DEVNODE flag.
  178. */
  179. list_for_each_entry(sd, &v4l2_dev->subdevs, list) {
  180. if (!(sd->flags & V4L2_SUBDEV_FL_HAS_DEVNODE))
  181. continue;
  182. vdev = kzalloc(sizeof(*vdev), GFP_KERNEL);
  183. if (!vdev) {
  184. err = -ENOMEM;
  185. goto clean_up;
  186. }
  187. video_set_drvdata(vdev, sd);
  188. strlcpy(vdev->name, sd->name, sizeof(vdev->name));
  189. vdev->v4l2_dev = v4l2_dev;
  190. vdev->fops = &v4l2_subdev_fops;
  191. vdev->release = v4l2_device_release_subdev_node;
  192. vdev->ctrl_handler = sd->ctrl_handler;
  193. err = __video_register_device(vdev, VFL_TYPE_SUBDEV, -1, 1,
  194. sd->owner);
  195. if (err < 0) {
  196. kfree(vdev);
  197. goto clean_up;
  198. }
  199. #if defined(CONFIG_MEDIA_CONTROLLER)
  200. sd->entity.info.v4l.major = VIDEO_MAJOR;
  201. sd->entity.info.v4l.minor = vdev->minor;
  202. #endif
  203. sd->devnode = vdev;
  204. }
  205. return 0;
  206. clean_up:
  207. list_for_each_entry(sd, &v4l2_dev->subdevs, list) {
  208. if (!sd->devnode)
  209. break;
  210. video_unregister_device(sd->devnode);
  211. }
  212. return err;
  213. }
  214. EXPORT_SYMBOL_GPL(v4l2_device_register_subdev_nodes);
  215. void v4l2_device_unregister_subdev(struct v4l2_subdev *sd)
  216. {
  217. struct v4l2_device *v4l2_dev;
  218. /* return if it isn't registered */
  219. if (sd == NULL || sd->v4l2_dev == NULL)
  220. return;
  221. v4l2_dev = sd->v4l2_dev;
  222. spin_lock(&v4l2_dev->lock);
  223. list_del(&sd->list);
  224. spin_unlock(&v4l2_dev->lock);
  225. if (sd->internal_ops && sd->internal_ops->unregistered)
  226. sd->internal_ops->unregistered(sd);
  227. sd->v4l2_dev = NULL;
  228. #if defined(CONFIG_MEDIA_CONTROLLER)
  229. if (v4l2_dev->mdev)
  230. media_device_unregister_entity(&sd->entity);
  231. #endif
  232. video_unregister_device(sd->devnode);
  233. module_put(sd->owner);
  234. }
  235. EXPORT_SYMBOL_GPL(v4l2_device_unregister_subdev);