Loading...
1/*
2 * V4L2 asynchronous subdevice registration API
3 *
4 * Copyright (C) 2012-2013, Guennadi Liakhovetski <g.liakhovetski@gmx.de>
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 version 2 as
8 * published by the Free Software Foundation.
9 */
10
11#ifndef V4L2_ASYNC_H
12#define V4L2_ASYNC_H
13
14#include <linux/list.h>
15#include <linux/mutex.h>
16
17struct device;
18struct device_node;
19struct v4l2_device;
20struct v4l2_subdev;
21struct v4l2_async_notifier;
22
23/* A random max subdevice number, used to allocate an array on stack */
24#define V4L2_MAX_SUBDEVS 128U
25
26enum v4l2_async_match_type {
27 V4L2_ASYNC_MATCH_CUSTOM,
28 V4L2_ASYNC_MATCH_DEVNAME,
29 V4L2_ASYNC_MATCH_I2C,
30 V4L2_ASYNC_MATCH_OF,
31};
32
33/**
34 * struct v4l2_async_subdev - sub-device descriptor, as known to a bridge
35 * @bus_type: subdevice bus type to select the appropriate matching method
36 * @match: union of per-bus type matching data sets
37 * @list: used to link struct v4l2_async_subdev objects, waiting to be
38 * probed, to a notifier->waiting list
39 */
40struct v4l2_async_subdev {
41 enum v4l2_async_match_type match_type;
42 union {
43 struct {
44 const struct device_node *node;
45 } of;
46 struct {
47 const char *name;
48 } device_name;
49 struct {
50 int adapter_id;
51 unsigned short address;
52 } i2c;
53 struct {
54 bool (*match)(struct device *,
55 struct v4l2_async_subdev *);
56 void *priv;
57 } custom;
58 } match;
59
60 /* v4l2-async core private: not to be used by drivers */
61 struct list_head list;
62};
63
64/**
65 * v4l2_async_notifier - v4l2_device notifier data
66 * @num_subdevs:number of subdevices
67 * @subdevs: array of pointers to subdevice descriptors
68 * @v4l2_dev: pointer to struct v4l2_device
69 * @waiting: list of struct v4l2_async_subdev, waiting for their drivers
70 * @done: list of struct v4l2_subdev, already probed
71 * @list: member in a global list of notifiers
72 * @bound: a subdevice driver has successfully probed one of subdevices
73 * @complete: all subdevices have been probed successfully
74 * @unbind: a subdevice is leaving
75 */
76struct v4l2_async_notifier {
77 unsigned int num_subdevs;
78 struct v4l2_async_subdev **subdevs;
79 struct v4l2_device *v4l2_dev;
80 struct list_head waiting;
81 struct list_head done;
82 struct list_head list;
83 int (*bound)(struct v4l2_async_notifier *notifier,
84 struct v4l2_subdev *subdev,
85 struct v4l2_async_subdev *asd);
86 int (*complete)(struct v4l2_async_notifier *notifier);
87 void (*unbind)(struct v4l2_async_notifier *notifier,
88 struct v4l2_subdev *subdev,
89 struct v4l2_async_subdev *asd);
90};
91
92int v4l2_async_notifier_register(struct v4l2_device *v4l2_dev,
93 struct v4l2_async_notifier *notifier);
94void v4l2_async_notifier_unregister(struct v4l2_async_notifier *notifier);
95int v4l2_async_register_subdev(struct v4l2_subdev *sd);
96void v4l2_async_unregister_subdev(struct v4l2_subdev *sd);
97#endif
1/*
2 * V4L2 asynchronous subdevice registration API
3 *
4 * Copyright (C) 2012-2013, Guennadi Liakhovetski <g.liakhovetski@gmx.de>
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 version 2 as
8 * published by the Free Software Foundation.
9 */
10
11#ifndef V4L2_ASYNC_H
12#define V4L2_ASYNC_H
13
14#include <linux/list.h>
15#include <linux/mutex.h>
16
17struct device;
18struct device_node;
19struct v4l2_device;
20struct v4l2_subdev;
21struct v4l2_async_notifier;
22
23/* A random max subdevice number, used to allocate an array on stack */
24#define V4L2_MAX_SUBDEVS 128U
25
26enum v4l2_async_match_type {
27 V4L2_ASYNC_MATCH_CUSTOM,
28 V4L2_ASYNC_MATCH_DEVNAME,
29 V4L2_ASYNC_MATCH_I2C,
30 V4L2_ASYNC_MATCH_OF,
31};
32
33/**
34 * struct v4l2_async_subdev - sub-device descriptor, as known to a bridge
35 *
36 * @match_type: type of match that will be used
37 * @match: union of per-bus type matching data sets
38 * @list: used to link struct v4l2_async_subdev objects, waiting to be
39 * probed, to a notifier->waiting list
40 */
41struct v4l2_async_subdev {
42 enum v4l2_async_match_type match_type;
43 union {
44 struct {
45 const struct device_node *node;
46 } of;
47 struct {
48 const char *name;
49 } device_name;
50 struct {
51 int adapter_id;
52 unsigned short address;
53 } i2c;
54 struct {
55 bool (*match)(struct device *,
56 struct v4l2_async_subdev *);
57 void *priv;
58 } custom;
59 } match;
60
61 /* v4l2-async core private: not to be used by drivers */
62 struct list_head list;
63};
64
65/**
66 * struct v4l2_async_notifier - v4l2_device notifier data
67 *
68 * @num_subdevs: number of subdevices
69 * @subdevs: array of pointers to subdevice descriptors
70 * @v4l2_dev: pointer to struct v4l2_device
71 * @waiting: list of struct v4l2_async_subdev, waiting for their drivers
72 * @done: list of struct v4l2_subdev, already probed
73 * @list: member in a global list of notifiers
74 * @bound: a subdevice driver has successfully probed one of subdevices
75 * @complete: all subdevices have been probed successfully
76 * @unbind: a subdevice is leaving
77 */
78struct v4l2_async_notifier {
79 unsigned int num_subdevs;
80 struct v4l2_async_subdev **subdevs;
81 struct v4l2_device *v4l2_dev;
82 struct list_head waiting;
83 struct list_head done;
84 struct list_head list;
85 int (*bound)(struct v4l2_async_notifier *notifier,
86 struct v4l2_subdev *subdev,
87 struct v4l2_async_subdev *asd);
88 int (*complete)(struct v4l2_async_notifier *notifier);
89 void (*unbind)(struct v4l2_async_notifier *notifier,
90 struct v4l2_subdev *subdev,
91 struct v4l2_async_subdev *asd);
92};
93
94int v4l2_async_notifier_register(struct v4l2_device *v4l2_dev,
95 struct v4l2_async_notifier *notifier);
96void v4l2_async_notifier_unregister(struct v4l2_async_notifier *notifier);
97int v4l2_async_register_subdev(struct v4l2_subdev *sd);
98void v4l2_async_unregister_subdev(struct v4l2_subdev *sd);
99#endif