1 /* 2 * 3 * V 4 L 2 D R I V E R H E L P E R A P I 4 * 5 * Moved from videodev2.h 6 * 7 * Some commonly needed functions for drivers (v4l2-common.o module) 8 */ 9 #ifndef _V4L2_DEV_H 10 #define _V4L2_DEV_H 11 12 #define OBSOLETE_DEVDATA 1 /* to be removed soon */ 13 14 #include <linux/poll.h> 15 #include <linux/fs.h> 16 #include <linux/device.h> 17 #include <linux/mutex.h> 18 #include <linux/compiler.h> /* need __user */ 19 #include <linux/videodev2.h> 20 21 #define VIDEO_MAJOR 81 22 /* Minor device allocation */ 23 #define MINOR_VFL_TYPE_GRABBER_MIN 0 24 #define MINOR_VFL_TYPE_GRABBER_MAX 63 25 #define MINOR_VFL_TYPE_RADIO_MIN 64 26 #define MINOR_VFL_TYPE_RADIO_MAX 127 27 #define MINOR_VFL_TYPE_VTX_MIN 192 28 #define MINOR_VFL_TYPE_VTX_MAX 223 29 #define MINOR_VFL_TYPE_VBI_MIN 224 30 #define MINOR_VFL_TYPE_VBI_MAX 255 31 32 #define VFL_TYPE_GRABBER 0 33 #define VFL_TYPE_VBI 1 34 #define VFL_TYPE_RADIO 2 35 #define VFL_TYPE_VTX 3 36 37 struct v4l2_ioctl_callbacks; 38 39 /* 40 * Newer version of video_device, handled by videodev2.c 41 * This version moves redundant code from video device code to 42 * the common handler 43 */ 44 45 struct video_device 46 { 47 /* device ops */ 48 const struct file_operations *fops; 49 50 /* sysfs */ 51 struct device dev; /* v4l device */ 52 struct device *parent; /* device parent */ 53 54 /* device info */ 55 char name[32]; 56 int vfl_type; 57 int minor; 58 /* attribute to differentiate multiple indices on one physical device */ 59 int index; 60 61 int debug; /* Activates debug level*/ 62 63 /* Video standard vars */ 64 v4l2_std_id tvnorms; /* Supported tv norms */ 65 v4l2_std_id current_norm; /* Current tvnorm */ 66 67 /* callbacks */ 68 void (*release)(struct video_device *vfd); 69 70 /* ioctl callbacks */ 71 const struct v4l2_ioctl_ops *ioctl_ops; 72 73 #ifdef OBSOLETE_DEVDATA /* to be removed soon */ 74 /* dev->driver_data will be used instead some day. 75 * Use the video_{get|set}_drvdata() helper functions, 76 * so the switch over will be transparent for you. 77 * Or use {pci|usb}_{get|set}_drvdata() directly. */ 78 void *priv; 79 #endif 80 81 /* for videodev.c internal usage -- please don't touch */ 82 int users; /* video_exclusive_{open|close} ... */ 83 struct mutex lock; /* ... helper function uses these */ 84 }; 85 86 /* Class-dev to video-device */ 87 #define to_video_device(cd) container_of(cd, struct video_device, dev) 88 89 /* Version 2 functions */ 90 extern int video_register_device(struct video_device *vfd, int type, int nr); 91 int video_register_device_index(struct video_device *vfd, int type, int nr, 92 int index); 93 void video_unregister_device(struct video_device *); 94 95 /* helper functions to alloc / release struct video_device, the 96 later can be used for video_device->release() */ 97 struct video_device *video_device_alloc(void); 98 void video_device_release(struct video_device *vfd); 99 100 #ifdef OBSOLETE_DEVDATA /* to be removed soon */ 101 /* helper functions to access driver private data. */ 102 static inline void *video_get_drvdata(struct video_device *dev) 103 { 104 return dev->priv; 105 } 106 107 static inline void video_set_drvdata(struct video_device *dev, void *data) 108 { 109 dev->priv = data; 110 } 111 112 /* Obsolete stuff - Still needed for radio devices and obsolete drivers */ 113 extern struct video_device* video_devdata(struct file*); 114 extern int video_exclusive_open(struct inode *inode, struct file *file); 115 extern int video_exclusive_release(struct inode *inode, struct file *file); 116 #endif 117 118 #endif /* _V4L2_DEV_H */ 119