Commit 238e4a5b authored by Hans Verkuil's avatar Hans Verkuil Committed by Mauro Carvalho Chehab
Browse files

media: rename VFL_TYPE_GRABBER to _VIDEO 



We currently have the following devnode types:

enum vfl_devnode_type {
        VFL_TYPE_GRABBER        = 0,
        VFL_TYPE_VBI,
        VFL_TYPE_RADIO,
        VFL_TYPE_SUBDEV,
        VFL_TYPE_SDR,
        VFL_TYPE_TOUCH,
        VFL_TYPE_MAX /* Shall be the last one */
};

They all make sense, except for the first: GRABBER really refers to /dev/videoX
devices, which can be capture, output or m2m, so 'grabber' doesn't even refer to
their function anymore.

Let's call a spade a spade and rename this to VFL_TYPE_VIDEO.

Signed-off-by: default avatarHans Verkuil <hverkuil-cisco@xs4all.nl>
Acked-by: default avatarSakari Ailus <sakari.ailus@linux.intel.com>
Reviewed-by: default avatarLaurent Pinchart <laurent.pinchart@ideasonboard.com>
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+huawei@kernel.org>
parent cc62c747

Documentation/media/kapi/v4l2-dev.rst

+2 −2
Original line number Diff line number Diff line
@@ -185,7 +185,7 @@ This will create the character device for you. 


.. code-block:: c



	err = video_register_device(vdev, VFL_TYPE_GRABBER, -1);

	err = video_register_device(vdev, VFL_TYPE_VIDEO, -1);

	if (err) {

		video_device_release(vdev); /* or kfree(my_vdev); */

		return err;
@@ -201,7 +201,7 @@ types exist: 
========================== ====================	 ==============================

:c:type:`vfl_devnode_type` Device name		 Usage

========================== ====================	 ==============================

``VFL_TYPE_GRABBER``       ``/dev/videoX``       for video input/output devices

``VFL_TYPE_VIDEO``         ``/dev/videoX``       for video input/output devices

``VFL_TYPE_VBI``           ``/dev/vbiX``         for vertical blank data (i.e.

						 closed captions, teletext)

``VFL_TYPE_RADIO``         ``/dev/radioX``       for radio tuners

Documentation/translations/zh_CN/video4linux/v4l2-framework.txt

+2 −2
Original line number Diff line number Diff line
@@ -649,7 +649,7 @@ video_device注册 


接下来你需要注册视频设备：这会为你创建一个字符设备。



	err = video_register_device(vdev, VFL_TYPE_GRABBER, -1);

	err = video_register_device(vdev, VFL_TYPE_VIDEO, -1);

	if (err) {

		video_device_release(vdev); /* or kfree(my_vdev); */

		return err;
@@ -660,7 +660,7 @@ video_device注册 


注册哪种设备是根据类型（type）参数。存在以下类型：



VFL_TYPE_GRABBER: 用于视频输入/输出设备的 videoX

VFL_TYPE_VIDEO: 用于视频输入/输出设备的 videoX

VFL_TYPE_VBI: 用于垂直消隐数据的 vbiX (例如，隐藏式字幕，图文电视)

VFL_TYPE_RADIO: 用于广播调谐器的 radioX

drivers/media/v4l2-core/v4l2-dev.c

+5 −5
Original line number Diff line number Diff line
@@ -542,13 +542,13 @@ static void determine_valid_ioctls(struct video_device *vdev) 
			      V4L2_CAP_META_OUTPUT;

	DECLARE_BITMAP(valid_ioctls, BASE_VIDIOC_PRIVATE);

	const struct v4l2_ioctl_ops *ops = vdev->ioctl_ops;

	bool is_vid = vdev->vfl_type == VFL_TYPE_GRABBER &&

	bool is_vid = vdev->vfl_type == VFL_TYPE_VIDEO &&

		      (vdev->device_caps & vid_caps);

	bool is_vbi = vdev->vfl_type == VFL_TYPE_VBI;

	bool is_radio = vdev->vfl_type == VFL_TYPE_RADIO;

	bool is_sdr = vdev->vfl_type == VFL_TYPE_SDR;

	bool is_tch = vdev->vfl_type == VFL_TYPE_TOUCH;

	bool is_meta = vdev->vfl_type == VFL_TYPE_GRABBER &&

	bool is_meta = vdev->vfl_type == VFL_TYPE_VIDEO &&

		       (vdev->device_caps & meta_caps);

	bool is_rx = vdev->vfl_dir != VFL_DIR_TX;

	bool is_tx = vdev->vfl_dir != VFL_DIR_RX;
@@ -783,7 +783,7 @@ static int video_register_media_controller(struct video_device *vdev) 
	vdev->entity.function = MEDIA_ENT_F_UNKNOWN;



	switch (vdev->vfl_type) {

	case VFL_TYPE_GRABBER:

	case VFL_TYPE_VIDEO:

		intf_type = MEDIA_INTF_T_V4L_VIDEO;

		vdev->entity.function = MEDIA_ENT_F_IO_V4L;

		break;
@@ -891,7 +891,7 @@ int __video_register_device(struct video_device *vdev, 


	/* Part 1: check device type */

	switch (type) {

	case VFL_TYPE_GRABBER:

	case VFL_TYPE_VIDEO:

		name_base = "video";

		break;

	case VFL_TYPE_VBI:
@@ -935,7 +935,7 @@ int __video_register_device(struct video_device *vdev, 
	 * of 128-191 and just pick the first free minor there

	 * (new style). */

	switch (type) {

	case VFL_TYPE_GRABBER:

	case VFL_TYPE_VIDEO:

		minor_offset = 0;

		minor_cnt = 64;

		break;

drivers/media/v4l2-core/v4l2-ioctl.c

+2 −2
Original line number Diff line number Diff line
@@ -941,12 +941,12 @@ static int check_fmt(struct file *file, enum v4l2_buf_type type) 
			      V4L2_CAP_META_OUTPUT;

	struct video_device *vfd = video_devdata(file);

	const struct v4l2_ioctl_ops *ops = vfd->ioctl_ops;

	bool is_vid = vfd->vfl_type == VFL_TYPE_GRABBER &&

	bool is_vid = vfd->vfl_type == VFL_TYPE_VIDEO &&

		      (vfd->device_caps & vid_caps);

	bool is_vbi = vfd->vfl_type == VFL_TYPE_VBI;

	bool is_sdr = vfd->vfl_type == VFL_TYPE_SDR;

	bool is_tch = vfd->vfl_type == VFL_TYPE_TOUCH;

	bool is_meta = vfd->vfl_type == VFL_TYPE_GRABBER &&

	bool is_meta = vfd->vfl_type == VFL_TYPE_VIDEO &&

		       (vfd->device_caps & meta_caps);

	bool is_rx = vfd->vfl_dir != VFL_DIR_TX;

	bool is_tx = vfd->vfl_dir != VFL_DIR_RX;

include/media/v4l2-dev.h

+4 −2
Original line number Diff line number Diff line
@@ -24,7 +24,8 @@ 
/**

 * enum vfl_devnode_type - type of V4L2 device node

 *

 * @VFL_TYPE_GRABBER:	for video input/output devices

 * @VFL_TYPE_VIDEO:	for video input/output devices

 * @VFL_TYPE_GRABBER:	deprecated, same as VFL_TYPE_VIDEO

 * @VFL_TYPE_VBI:	for vertical blank data (i.e. closed captions, teletext)

 * @VFL_TYPE_RADIO:	for radio tuners

 * @VFL_TYPE_SUBDEV:	for V4L2 subdevices
@@ -33,7 +34,8 @@ 
 * @VFL_TYPE_MAX:	number of VFL types, must always be last in the enum

 */

enum vfl_devnode_type {

	VFL_TYPE_GRABBER	= 0,

	VFL_TYPE_VIDEO,

	VFL_TYPE_GRABBER = VFL_TYPE_VIDEO,

	VFL_TYPE_VBI,

	VFL_TYPE_RADIO,

	VFL_TYPE_SUBDEV,

CRA Git | Maintained and supported by SUSTech CRA and CCSE