blob: c21b4c5f587192ce206689bf083a3552e10060e8 [file] [log] [blame]
Laurent Pinchart176fb0d2009-12-09 08:39:58 -03001/*
2 * Media device
3 *
4 * Copyright (C) 2010 Nokia Corporation
5 *
6 * Contacts: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
7 * Sakari Ailus <sakari.ailus@iki.fi>
8 *
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License version 2 as
11 * published by the Free Software Foundation.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
21 */
22
23#ifndef _MEDIA_DEVICE_H
24#define _MEDIA_DEVICE_H
25
Laurent Pinchart176fb0d2009-12-09 08:39:58 -030026#include <linux/list.h>
Laurent Pinchart503c3d822010-03-07 15:04:59 -030027#include <linux/mutex.h>
Laurent Pinchart176fb0d2009-12-09 08:39:58 -030028
29#include <media/media-devnode.h>
Laurent Pinchart53e269c2009-12-09 08:40:00 -030030#include <media/media-entity.h>
Laurent Pinchart176fb0d2009-12-09 08:39:58 -030031
Sakari Ailus665faa92015-12-16 11:32:17 -020032struct ida;
Paul Gortmaker313162d2012-01-30 11:46:54 -050033struct device;
34
Laurent Pinchart176fb0d2009-12-09 08:39:58 -030035/**
Shuah Khanafcbdb52016-02-11 21:41:21 -020036 * struct media_entity_notify - Media Entity Notify
37 *
38 * @list: List head
39 * @notify_data: Input data to invoke the callback
40 * @notify: Callback function pointer
41 *
Shuah Khanfc641262016-03-14 19:24:25 -030042 * Drivers may register a callback to take action when new entities get
43 * registered with the media device. This handler is intended for creating
44 * links between existing entities and should not create entities and register
45 * them.
Shuah Khanafcbdb52016-02-11 21:41:21 -020046 */
47struct media_entity_notify {
48 struct list_head list;
49 void *notify_data;
50 void (*notify)(struct media_entity *entity, void *notify_data);
51};
52
53/**
Laurent Pinchart68429f52015-11-03 00:27:51 -020054 * struct media_device_ops - Media device operations
55 * @link_notify: Link state change notification callback. This callback is
56 * called with the graph_mutex held.
57 */
58struct media_device_ops {
59 int (*link_notify)(struct media_link *link, u32 flags,
60 unsigned int notification);
61};
62
63/**
Laurent Pinchart176fb0d2009-12-09 08:39:58 -030064 * struct media_device - Media device
65 * @dev: Parent device
66 * @devnode: Media device node
Mauro Carvalho Chehabbb07bd62016-02-11 14:24:23 -020067 * @driver_name: Optional device driver name. If not set, calls to
Mauro Carvalho Chehab48a7c4b2016-08-29 16:09:11 -030068 * %MEDIA_IOC_DEVICE_INFO will return ``dev->driver->name``.
Mauro Carvalho Chehabbb07bd62016-02-11 14:24:23 -020069 * This is needed for USB drivers for example, as otherwise
70 * they'll all appear as if the driver name was "usb".
Laurent Pinchart176fb0d2009-12-09 08:39:58 -030071 * @model: Device model name
72 * @serial: Device serial number (optional)
73 * @bus_info: Unique and stable device location identifier
74 * @hw_revision: Hardware device revision
75 * @driver_version: Device driver version
Mauro Carvalho Chehab2521fda2015-08-23 09:40:26 -030076 * @topology_version: Monotonic counter for storing the version of the graph
77 * topology. Should be incremented each time the topology changes.
Mauro Carvalho Chehab05b3b772015-12-16 14:28:01 -020078 * @id: Unique ID used on the last registered graph object
Mauro Carvalho Chehab03e49332015-12-16 13:58:31 -020079 * @entity_internal_idx: Unique internal entity ID used by the graph traversal
80 * algorithms
81 * @entity_internal_idx_max: Allocated internal entity indices
Laurent Pinchart53e269c2009-12-09 08:40:00 -030082 * @entities: List of registered entities
Mauro Carvalho Chehab57cf79b2015-08-21 09:23:22 -030083 * @interfaces: List of registered interfaces
Mauro Carvalho Chehab9155d852015-08-23 08:00:33 -030084 * @pads: List of registered pads
85 * @links: List of registered links
Shuah Khanafcbdb52016-02-11 21:41:21 -020086 * @entity_notify: List of registered entity_notify callbacks
Mauro Carvalho Chehabe2c91d42016-04-06 10:55:24 -030087 * @graph_mutex: Protects access to struct media_device data
Sakari Ailus0c426c42016-02-21 13:25:08 -030088 * @pm_count_walk: Graph walk for power state walk. Access serialised using
89 * graph_mutex.
Shuah Khancd87ce82016-02-11 21:41:22 -020090 *
91 * @source_priv: Driver Private data for enable/disable source handlers
92 * @enable_source: Enable Source Handler function pointer
93 * @disable_source: Disable Source Handler function pointer
94 *
Laurent Pinchart68429f52015-11-03 00:27:51 -020095 * @ops: Operation handler callbacks
Laurent Pinchart176fb0d2009-12-09 08:39:58 -030096 *
97 * This structure represents an abstract high-level media device. It allows easy
98 * access to entities and provides basic media device-level support. The
99 * structure can be allocated directly or embedded in a larger structure.
100 *
101 * The parent @dev is a physical device. It must be set before registering the
102 * media device.
103 *
104 * @model is a descriptive model name exported through sysfs. It doesn't have to
105 * be unique.
Shuah Khancd87ce82016-02-11 21:41:22 -0200106 *
107 * @enable_source is a handler to find source entity for the
108 * sink entity and activate the link between them if source
109 * entity is free. Drivers should call this handler before
110 * accessing the source.
111 *
112 * @disable_source is a handler to find source entity for the
113 * sink entity and deactivate the link between them. Drivers
114 * should call this handler to release the source.
115 *
Shuah Khancd87ce82016-02-11 21:41:22 -0200116 * Use-case: find tuner entity connected to the decoder
117 * entity and check if it is available, and activate the
Mauro Carvalho Chehab48a7c4b2016-08-29 16:09:11 -0300118 * the link between them from @enable_source and deactivate
119 * from @disable_source.
120 *
121 * .. note::
122 *
123 * Bridge driver is expected to implement and set the
124 * handler when &media_device is registered or when
125 * bridge driver finds the media_device during probe.
126 * Bridge driver sets source_priv with information
127 * necessary to run @enable_source and @disable_source handlers.
Laurent Pinchart176fb0d2009-12-09 08:39:58 -0300128 */
129struct media_device {
130 /* dev->driver_data points to this struct. */
131 struct device *dev;
Mauro Carvalho Chehaba087ce72016-04-27 19:28:26 -0300132 struct media_devnode *devnode;
Laurent Pinchart176fb0d2009-12-09 08:39:58 -0300133
134 char model[32];
Mauro Carvalho Chehabbb07bd62016-02-11 14:24:23 -0200135 char driver_name[32];
Laurent Pinchart176fb0d2009-12-09 08:39:58 -0300136 char serial[40];
137 char bus_info[32];
138 u32 hw_revision;
139 u32 driver_version;
Laurent Pinchart53e269c2009-12-09 08:40:00 -0300140
Mauro Carvalho Chehab952f8ee2016-03-16 05:34:39 -0700141 u64 topology_version;
Mauro Carvalho Chehab2521fda2015-08-23 09:40:26 -0300142
Mauro Carvalho Chehab05b3b772015-12-16 14:28:01 -0200143 u32 id;
Sakari Ailus665faa92015-12-16 11:32:17 -0200144 struct ida entity_internal_idx;
145 int entity_internal_idx_max;
Mauro Carvalho Chehabbfab2aac2015-08-14 12:47:48 -0300146
Laurent Pinchart53e269c2009-12-09 08:40:00 -0300147 struct list_head entities;
Mauro Carvalho Chehab57cf79b2015-08-21 09:23:22 -0300148 struct list_head interfaces;
Mauro Carvalho Chehab9155d852015-08-23 08:00:33 -0300149 struct list_head pads;
150 struct list_head links;
Laurent Pinchart53e269c2009-12-09 08:40:00 -0300151
Shuah Khanafcbdb52016-02-11 21:41:21 -0200152 /* notify callback list invoked when a new entity is registered */
153 struct list_head entity_notify;
154
Laurent Pinchart503c3d822010-03-07 15:04:59 -0300155 /* Serializes graph operations. */
156 struct mutex graph_mutex;
Sakari Ailus0c426c42016-02-21 13:25:08 -0300157 struct media_entity_graph pm_count_walk;
Laurent Pinchart97548ed2009-12-09 08:40:03 -0300158
Shuah Khancd87ce82016-02-11 21:41:22 -0200159 void *source_priv;
160 int (*enable_source)(struct media_entity *entity,
161 struct media_pipeline *pipe);
162 void (*disable_source)(struct media_entity *entity);
163
Laurent Pinchart68429f52015-11-03 00:27:51 -0200164 const struct media_device_ops *ops;
Laurent Pinchart176fb0d2009-12-09 08:39:58 -0300165};
166
Mauro Carvalho Chehab41b44e32016-02-22 11:42:04 -0300167/* We don't need to include pci.h or usb.h here */
168struct pci_dev;
169struct usb_device;
170
Shuah Khane576d60b2015-06-05 17:11:54 -0300171#ifdef CONFIG_MEDIA_CONTROLLER
172
Sylwester Nawrocki813f5c02013-05-31 10:37:26 -0300173/* Supported link_notify @notification values. */
174#define MEDIA_DEV_NOTIFY_PRE_LINK_CH 0
175#define MEDIA_DEV_NOTIFY_POST_LINK_CH 1
176
Mauro Carvalho Chehabdb7ee322015-12-11 11:06:08 -0200177/**
Sakari Ailusc8d54cd2015-12-16 11:44:32 -0200178 * media_entity_enum_init - Initialise an entity enumeration
179 *
Mauro Carvalho Chehab03e49332015-12-16 13:58:31 -0200180 * @ent_enum: Entity enumeration to be initialised
Sakari Ailusc8d54cd2015-12-16 11:44:32 -0200181 * @mdev: The related media device
182 *
Mauro Carvalho Chehab48a7c4b2016-08-29 16:09:11 -0300183 * Return: zero on success or a negative error code.
Sakari Ailusc8d54cd2015-12-16 11:44:32 -0200184 */
185static inline __must_check int media_entity_enum_init(
186 struct media_entity_enum *ent_enum, struct media_device *mdev)
187{
188 return __media_entity_enum_init(ent_enum,
189 mdev->entity_internal_idx_max + 1);
190}
191
192/**
Javier Martinez Canillas9832e152015-12-11 20:57:08 -0200193 * media_device_init() - Initializes a media device element
194 *
195 * @mdev: pointer to struct &media_device
196 *
197 * This function initializes the media device prior to its registration.
198 * The media device initialization and registration is split in two functions
199 * to avoid race conditions and make the media device available to user-space
200 * before the media graph has been completed.
201 *
202 * So drivers need to first initialize the media device, register any entity
203 * within the media device, create pad to pad links and then finally register
204 * the media device by calling media_device_register() as a final step.
205 */
206void media_device_init(struct media_device *mdev);
207
208/**
209 * media_device_cleanup() - Cleanups a media device element
210 *
211 * @mdev: pointer to struct &media_device
212 *
213 * This function that will destroy the graph_mutex that is
214 * initialized in media_device_init().
215 */
216void media_device_cleanup(struct media_device *mdev);
217
218/**
Mauro Carvalho Chehabdb7ee322015-12-11 11:06:08 -0200219 * __media_device_register() - Registers a media device element
220 *
221 * @mdev: pointer to struct &media_device
222 * @owner: should be filled with %THIS_MODULE
223 *
224 * Users, should, instead, call the media_device_register() macro.
225 *
Mauro Carvalho Chehab48a7c4b2016-08-29 16:09:11 -0300226 * The caller is responsible for initializing the &media_device structure
227 * before registration. The following fields of &media_device must be set:
Mauro Carvalho Chehabdb7ee322015-12-11 11:06:08 -0200228 *
Mauro Carvalho Chehab48a7c4b2016-08-29 16:09:11 -0300229 * - &media_entity.dev must point to the parent device (usually a &pci_dev,
230 * &usb_interface or &platform_device instance).
Mauro Carvalho Chehabdb7ee322015-12-11 11:06:08 -0200231 *
Mauro Carvalho Chehab48a7c4b2016-08-29 16:09:11 -0300232 * - &media_entity.model must be filled with the device model name as a
233 * NUL-terminated UTF-8 string. The device/model revision must not be
234 * stored in this field.
Mauro Carvalho Chehabdb7ee322015-12-11 11:06:08 -0200235 *
236 * The following fields are optional:
237 *
Mauro Carvalho Chehab48a7c4b2016-08-29 16:09:11 -0300238 * - &media_entity.serial is a unique serial number stored as a
239 * NUL-terminated ASCII string. The field is big enough to store a GUID
240 * in text form. If the hardware doesn't provide a unique serial number
241 * this field must be left empty.
Mauro Carvalho Chehabdb7ee322015-12-11 11:06:08 -0200242 *
Mauro Carvalho Chehab48a7c4b2016-08-29 16:09:11 -0300243 * - &media_entity.bus_info represents the location of the device in the
244 * system as a NUL-terminated ASCII string. For PCI/PCIe devices
245 * &media_entity.bus_info must be set to "PCI:" (or "PCIe:") followed by
246 * the value of pci_name(). For USB devices,the usb_make_path() function
247 * must be used. This field is used by applications to distinguish between
248 * otherwise identical devices that don't provide a serial number.
Mauro Carvalho Chehabdb7ee322015-12-11 11:06:08 -0200249 *
Mauro Carvalho Chehab48a7c4b2016-08-29 16:09:11 -0300250 * - &media_entity.hw_revision is the hardware device revision in a
251 * driver-specific format. When possible the revision should be formatted
252 * with the KERNEL_VERSION() macro.
Mauro Carvalho Chehabdb7ee322015-12-11 11:06:08 -0200253 *
Mauro Carvalho Chehab48a7c4b2016-08-29 16:09:11 -0300254 * - &media_entity.driver_version is formatted with the KERNEL_VERSION()
255 * macro. The version minor must be incremented when new features are added
256 * to the userspace API without breaking binary compatibility. The version
257 * major must be incremented when binary compatibility is broken.
Mauro Carvalho Chehabdb7ee322015-12-11 11:06:08 -0200258 *
Mauro Carvalho Chehab74604b72016-07-17 09:18:03 -0300259 * .. note::
Mauro Carvalho Chehabdb7ee322015-12-11 11:06:08 -0200260 *
Mauro Carvalho Chehab74604b72016-07-17 09:18:03 -0300261 * #) Upon successful registration a character device named media[0-9]+ is created. The device major and minor numbers are dynamic. The model name is exported as a sysfs attribute.
Mauro Carvalho Chehabdb7ee322015-12-11 11:06:08 -0200262 *
Mauro Carvalho Chehab74604b72016-07-17 09:18:03 -0300263 * #) Unregistering a media device that hasn't been registered is **NOT** safe.
Mauro Carvalho Chehab92777992015-12-16 13:53:04 -0200264 *
265 * Return: returns zero on success or a negative error code.
Mauro Carvalho Chehabdb7ee322015-12-11 11:06:08 -0200266 */
Sakari Ailus85de7212013-12-12 12:38:17 -0300267int __must_check __media_device_register(struct media_device *mdev,
268 struct module *owner);
Mauro Carvalho Chehab48a7c4b2016-08-29 16:09:11 -0300269
270
271/**
272 * media_device_register() - Registers a media device element
273 *
274 * @mdev: pointer to struct &media_device
275 *
276 * This macro calls __media_device_register() passing %THIS_MODULE as
277 * the __media_device_register() second argument (**owner**).
278 */
Sakari Ailus85de7212013-12-12 12:38:17 -0300279#define media_device_register(mdev) __media_device_register(mdev, THIS_MODULE)
Mauro Carvalho Chehabdb7ee322015-12-11 11:06:08 -0200280
281/**
Mauro Carvalho Chehab3047f3f2016-03-16 05:04:03 -0700282 * media_device_unregister() - Unregisters a media device element
Mauro Carvalho Chehabdb7ee322015-12-11 11:06:08 -0200283 *
284 * @mdev: pointer to struct &media_device
Mauro Carvalho Chehab92777992015-12-16 13:53:04 -0200285 *
Mauro Carvalho Chehab92777992015-12-16 13:53:04 -0200286 * It is safe to call this function on an unregistered (but initialised)
287 * media device.
Mauro Carvalho Chehabdb7ee322015-12-11 11:06:08 -0200288 */
Laurent Pinchart176fb0d2009-12-09 08:39:58 -0300289void media_device_unregister(struct media_device *mdev);
290
Mauro Carvalho Chehabdb7ee322015-12-11 11:06:08 -0200291/**
292 * media_device_register_entity() - registers a media entity inside a
293 * previously registered media device.
294 *
295 * @mdev: pointer to struct &media_device
296 * @entity: pointer to struct &media_entity to be registered
297 *
298 * Entities are identified by a unique positive integer ID. The media
299 * controller framework will such ID automatically. IDs are not guaranteed
300 * to be contiguous, and the ID number can change on newer Kernel versions.
301 * So, neither the driver nor userspace should hardcode ID numbers to refer
302 * to the entities, but, instead, use the framework to find the ID, when
303 * needed.
304 *
305 * The media_entity name, type and flags fields should be initialized before
306 * calling media_device_register_entity(). Entities embedded in higher-level
307 * standard structures can have some of those fields set by the higher-level
308 * framework.
309 *
310 * If the device has pads, media_entity_pads_init() should be called before
Mauro Carvalho Chehab48a7c4b2016-08-29 16:09:11 -0300311 * this function. Otherwise, the &media_entity.pad and &media_entity.num_pads
Mauro Carvalho Chehabdb7ee322015-12-11 11:06:08 -0200312 * should be zeroed before calling this function.
313 *
314 * Entities have flags that describe the entity capabilities and state:
315 *
Mauro Carvalho Chehab48a7c4b2016-08-29 16:09:11 -0300316 * %MEDIA_ENT_FL_DEFAULT
317 * indicates the default entity for a given type.
318 * This can be used to report the default audio and video devices or the
319 * default camera sensor.
Mauro Carvalho Chehabd1b9da22015-12-11 12:41:12 -0200320 *
Mauro Carvalho Chehab74604b72016-07-17 09:18:03 -0300321 * .. note::
322 *
323 * Drivers should set the entity function before calling this function.
324 * Please notice that the values %MEDIA_ENT_F_V4L2_SUBDEV_UNKNOWN and
325 * %MEDIA_ENT_F_UNKNOWN should not be used by the drivers.
Mauro Carvalho Chehabdb7ee322015-12-11 11:06:08 -0200326 */
Laurent Pinchart53e269c2009-12-09 08:40:00 -0300327int __must_check media_device_register_entity(struct media_device *mdev,
328 struct media_entity *entity);
Mauro Carvalho Chehabdb7ee322015-12-11 11:06:08 -0200329
Mauro Carvalho Chehab74604b72016-07-17 09:18:03 -0300330/**
Mauro Carvalho Chehabdb7ee322015-12-11 11:06:08 -0200331 * media_device_unregister_entity() - unregisters a media entity.
332 *
333 * @entity: pointer to struct &media_entity to be unregistered
334 *
335 * All links associated with the entity and all PADs are automatically
336 * unregistered from the media_device when this function is called.
337 *
338 * Unregistering an entity will not change the IDs of the other entities and
339 * the previoully used ID will never be reused for a newly registered entities.
340 *
341 * When a media device is unregistered, all its entities are unregistered
342 * automatically. No manual entities unregistration is then required.
343 *
Mauro Carvalho Chehab74604b72016-07-17 09:18:03 -0300344 * .. note::
345 *
346 * The media_entity instance itself must be freed explicitly by
347 * the driver if required.
Mauro Carvalho Chehabdb7ee322015-12-11 11:06:08 -0200348 */
Laurent Pinchart53e269c2009-12-09 08:40:00 -0300349void media_device_unregister_entity(struct media_entity *entity);
Mauro Carvalho Chehabb6e4ca82015-12-13 08:36:58 -0200350
351/**
Shuah Khanafcbdb52016-02-11 21:41:21 -0200352 * media_device_register_entity_notify() - Registers a media entity_notify
353 * callback
354 *
355 * @mdev: The media device
356 * @nptr: The media_entity_notify
357 *
Mauro Carvalho Chehab48a7c4b2016-08-29 16:09:11 -0300358 * .. note::
359 *
360 * When a new entity is registered, all the registered
361 * media_entity_notify callbacks are invoked.
Shuah Khanafcbdb52016-02-11 21:41:21 -0200362 */
363
364int __must_check media_device_register_entity_notify(struct media_device *mdev,
365 struct media_entity_notify *nptr);
366
367/**
368 * media_device_unregister_entity_notify() - Unregister a media entity notify
369 * callback
370 *
371 * @mdev: The media device
372 * @nptr: The media_entity_notify
373 *
374 */
375void media_device_unregister_entity_notify(struct media_device *mdev,
376 struct media_entity_notify *nptr);
377
Laurent Pinchart53e269c2009-12-09 08:40:00 -0300378/* Iterate over all entities. */
379#define media_device_for_each_entity(entity, mdev) \
Mauro Carvalho Chehab05bfa9f2015-08-23 07:51:33 -0300380 list_for_each_entry(entity, &(mdev)->entities, graph_obj.list)
Laurent Pinchart53e269c2009-12-09 08:40:00 -0300381
Mauro Carvalho Chehabcf975a42015-08-23 07:51:22 -0300382/* Iterate over all interfaces. */
383#define media_device_for_each_intf(intf, mdev) \
Mauro Carvalho Chehab05bfa9f2015-08-23 07:51:33 -0300384 list_for_each_entry(intf, &(mdev)->interfaces, graph_obj.list)
Mauro Carvalho Chehabcf975a42015-08-23 07:51:22 -0300385
Mauro Carvalho Chehab9155d852015-08-23 08:00:33 -0300386/* Iterate over all pads. */
387#define media_device_for_each_pad(pad, mdev) \
388 list_for_each_entry(pad, &(mdev)->pads, graph_obj.list)
389
390/* Iterate over all links. */
391#define media_device_for_each_link(link, mdev) \
392 list_for_each_entry(link, &(mdev)->links, graph_obj.list)
Mauro Carvalho Chehab41b44e32016-02-22 11:42:04 -0300393
394/**
395 * media_device_pci_init() - create and initialize a
396 * struct &media_device from a PCI device.
397 *
Mauro Carvalho Chehab6cf5dad2016-02-22 12:10:49 -0300398 * @mdev: pointer to struct &media_device
Mauro Carvalho Chehab41b44e32016-02-22 11:42:04 -0300399 * @pci_dev: pointer to struct pci_dev
400 * @name: media device name. If %NULL, the routine will use the default
401 * name for the pci device, given by pci_name() macro.
402 */
Mauro Carvalho Chehab6cf5dad2016-02-22 12:10:49 -0300403void media_device_pci_init(struct media_device *mdev,
404 struct pci_dev *pci_dev,
405 const char *name);
Mauro Carvalho Chehab41b44e32016-02-22 11:42:04 -0300406/**
407 * __media_device_usb_init() - create and initialize a
408 * struct &media_device from a PCI device.
409 *
Mauro Carvalho Chehab6cf5dad2016-02-22 12:10:49 -0300410 * @mdev: pointer to struct &media_device
Mauro Carvalho Chehab41b44e32016-02-22 11:42:04 -0300411 * @udev: pointer to struct usb_device
412 * @board_name: media device name. If %NULL, the routine will use the usb
413 * product name, if available.
414 * @driver_name: name of the driver. if %NULL, the routine will use the name
Mauro Carvalho Chehab48a7c4b2016-08-29 16:09:11 -0300415 * given by ``udev->dev->driver->name``, with is usually the wrong
Mauro Carvalho Chehab41b44e32016-02-22 11:42:04 -0300416 * thing to do.
417 *
Mauro Carvalho Chehab48a7c4b2016-08-29 16:09:11 -0300418 * .. note::
419 *
420 * It is better to call media_device_usb_init() instead, as
421 * such macro fills driver_name with %KBUILD_MODNAME.
Mauro Carvalho Chehab41b44e32016-02-22 11:42:04 -0300422 */
Mauro Carvalho Chehab6cf5dad2016-02-22 12:10:49 -0300423void __media_device_usb_init(struct media_device *mdev,
424 struct usb_device *udev,
425 const char *board_name,
426 const char *driver_name);
Mauro Carvalho Chehab41b44e32016-02-22 11:42:04 -0300427
Shuah Khane576d60b2015-06-05 17:11:54 -0300428#else
429static inline int media_device_register(struct media_device *mdev)
430{
431 return 0;
432}
433static inline void media_device_unregister(struct media_device *mdev)
434{
435}
436static inline int media_device_register_entity(struct media_device *mdev,
437 struct media_entity *entity)
438{
439 return 0;
440}
441static inline void media_device_unregister_entity(struct media_entity *entity)
442{
443}
Shuah Khanafcbdb52016-02-11 21:41:21 -0200444static inline int media_device_register_entity_notify(
445 struct media_device *mdev,
446 struct media_entity_notify *nptr)
447{
448 return 0;
449}
450static inline void media_device_unregister_entity_notify(
451 struct media_device *mdev,
452 struct media_entity_notify *nptr)
453{
454}
Mauro Carvalho Chehab41b44e32016-02-22 11:42:04 -0300455
Mauro Carvalho Chehab6cf5dad2016-02-22 12:10:49 -0300456static inline void media_device_pci_init(struct media_device *mdev,
457 struct pci_dev *pci_dev,
458 char *name)
Mauro Carvalho Chehab41b44e32016-02-22 11:42:04 -0300459{
Mauro Carvalho Chehab41b44e32016-02-22 11:42:04 -0300460}
461
Mauro Carvalho Chehab6cf5dad2016-02-22 12:10:49 -0300462static inline void __media_device_usb_init(struct media_device *mdev,
463 struct usb_device *udev,
464 char *board_name,
465 char *driver_name)
Mauro Carvalho Chehab41b44e32016-02-22 11:42:04 -0300466{
Mauro Carvalho Chehab41b44e32016-02-22 11:42:04 -0300467}
468
Shuah Khane576d60b2015-06-05 17:11:54 -0300469#endif /* CONFIG_MEDIA_CONTROLLER */
Mauro Carvalho Chehab41b44e32016-02-22 11:42:04 -0300470
Mauro Carvalho Chehab48a7c4b2016-08-29 16:09:11 -0300471/**
472 * media_device_usb_init() - create and initialize a
473 * struct &media_device from a PCI device.
474 *
475 * @mdev: pointer to struct &media_device
476 * @udev: pointer to struct usb_device
477 * @name: media device name. If %NULL, the routine will use the usb
478 * product name, if available.
479 *
480 * This macro calls media_device_usb_init() passing the
481 * media_device_usb_init() **driver_name** parameter filled with
482 * %KBUILD_MODNAME.
483 */
Mauro Carvalho Chehab6cf5dad2016-02-22 12:10:49 -0300484#define media_device_usb_init(mdev, udev, name) \
485 __media_device_usb_init(mdev, udev, name, KBUILD_MODNAME)
Mauro Carvalho Chehab41b44e32016-02-22 11:42:04 -0300486
Laurent Pinchart176fb0d2009-12-09 08:39:58 -0300487#endif