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