media: v4l2-subdev: convert frame description to enum

As kernel-doc doesn't support documenting #define values,
and using enum makes easier to identify where the values
are used, convert V4L2_MBUS_FRAME_DESC_FL_* to enum, and
use BIT() macro.

While here, fix the description at v4l2_mbus_frame_desc_entry,
in order to match what's described for
V4L2_MBUS_FRAME_DESC_FL_LEN_MAX.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
This commit is contained in:
Mauro Carvalho Chehab 2017-10-05 16:32:30 -04:00
parent 4eb2f55728
commit bb92895a1c

View file

@ -313,25 +313,32 @@ struct v4l2_subdev_audio_ops {
int (*s_stream)(struct v4l2_subdev *sd, int enable); int (*s_stream)(struct v4l2_subdev *sd, int enable);
}; };
/* Indicates the @length field specifies maximum data length. */ /**
#define V4L2_MBUS_FRAME_DESC_FL_LEN_MAX (1U << 0) * enum v4l2_mbus_frame_desc_entry - media bus frame description flags
/* *
* Indicates that the format does not have line offsets, i.e. the * @V4L2_MBUS_FRAME_DESC_FL_LEN_MAX:
* receiver should use 1D DMA. * Indicates that &struct v4l2_mbus_frame_desc_entry->length field
* specifies maximum data length.
* @V4L2_MBUS_FRAME_DESC_FL_BLOB:
* Indicates that the format does not have line offsets, i.e.
* the receiver should use 1D DMA.
*/ */
#define V4L2_MBUS_FRAME_DESC_FL_BLOB (1U << 1) enum v4l2_mbus_frame_desc_flags {
V4L2_MBUS_FRAME_DESC_FL_LEN_MAX = BIT(0),
V4L2_MBUS_FRAME_DESC_FL_BLOB = BIT(1),
};
/** /**
* struct v4l2_mbus_frame_desc_entry - media bus frame description structure * struct v4l2_mbus_frame_desc_entry - media bus frame description structure
* *
* @flags: bitmask flags: %V4L2_MBUS_FRAME_DESC_FL_LEN_MAX and * @flags: bitmask flags, as defined by &enum v4l2_mbus_frame_desc_flags.
* %V4L2_MBUS_FRAME_DESC_FL_BLOB. * @pixelcode: media bus pixel code, valid if @flags
* @pixelcode: media bus pixel code, valid if FRAME_DESC_FL_BLOB is not set * %FRAME_DESC_FL_BLOB is not set.
* @length: number of octets per frame, valid if V4L2_MBUS_FRAME_DESC_FL_BLOB * @length: number of octets per frame, valid if @flags
* is set * %V4L2_MBUS_FRAME_DESC_FL_LEN_MAX is set.
*/ */
struct v4l2_mbus_frame_desc_entry { struct v4l2_mbus_frame_desc_entry {
u16 flags; enum v4l2_mbus_frame_desc_flags flags;
u32 pixelcode; u32 pixelcode;
u32 length; u32 length;
}; };