2.20. V4L2 Media Bus functions and data structures

struct v4l2_mbus_config_mipi_csi2

MIPI CSI-2 data bus configuration

Definition

struct v4l2_mbus_config_mipi_csi2 {
  unsigned int flags;
  unsigned char data_lanes[V4L2_MBUS_CSI2_MAX_DATA_LANES];
  unsigned char clock_lane;
  unsigned char num_data_lanes;
  bool lane_polarities[1 + V4L2_MBUS_CSI2_MAX_DATA_LANES];
};

Members

flags
media bus (V4L2_MBUS_*) flags
data_lanes
an array of physical data lane indexes
clock_lane
physical lane index of the clock lane
num_data_lanes
number of data lanes
lane_polarities
polarity of the lanes. The order is the same of the physical lanes.
struct v4l2_mbus_config_parallel

parallel data bus configuration

Definition

struct v4l2_mbus_config_parallel {
  unsigned int flags;
  unsigned char bus_width;
  unsigned char data_shift;
};

Members

flags
media bus (V4L2_MBUS_*) flags
bus_width
bus width in bits
data_shift
data shift in bits
struct v4l2_mbus_config_mipi_csi1

CSI-1/CCP2 data bus configuration

Definition

struct v4l2_mbus_config_mipi_csi1 {
  unsigned char clock_inv:1;
  unsigned char strobe:1;
  bool lane_polarity[2];
  unsigned char data_lane;
  unsigned char clock_lane;
};

Members

clock_inv
polarity of clock/strobe signal false - not inverted, true - inverted
strobe
false - data/clock, true - data/strobe
lane_polarity
the polarities of the clock (index 0) and data lanes index (1)
data_lane
the number of the data lane
clock_lane
the number of the clock lane
enum v4l2_mbus_type

media bus type

Constants

V4L2_MBUS_UNKNOWN
unknown bus type, no V4L2 mediabus configuration
V4L2_MBUS_PARALLEL
parallel interface with hsync and vsync
V4L2_MBUS_BT656
parallel interface with embedded synchronisation, can also be used for BT.1120
V4L2_MBUS_CSI1
MIPI CSI-1 serial interface
V4L2_MBUS_CCP2
CCP2 (Compact Camera Port 2)
V4L2_MBUS_CSI2_DPHY
MIPI CSI-2 serial interface, with D-PHY
V4L2_MBUS_CSI2_CPHY
MIPI CSI-2 serial interface, with C-PHY
V4L2_MBUS_DPI
MIPI VIDEO DPI interface
V4L2_MBUS_INVALID
invalid bus type (keep as last)
struct v4l2_mbus_config

media bus configuration

Definition

struct v4l2_mbus_config {
  enum v4l2_mbus_type type;
  union {
    struct v4l2_mbus_config_parallel parallel;
    struct v4l2_mbus_config_mipi_csi1 mipi_csi1;
    struct v4l2_mbus_config_mipi_csi2 mipi_csi2;
  } bus;
};

Members

type
interface type
bus
bus configuration data structure
bus.parallel
embedded struct v4l2_mbus_config_parallel. Used if the bus is parallel or BT.656.
bus.mipi_csi1
embedded struct v4l2_mbus_config_mipi_csi1. Used if the bus is MIPI Alliance's Camera Serial Interface version 1 (MIPI CSI1) or Standard Mobile Imaging Architecture's Compact Camera Port 2 (SMIA CCP2).
bus.mipi_csi2
embedded struct v4l2_mbus_config_mipi_csi2. Used if the bus is MIPI Alliance's Camera Serial Interface version 2 (MIPI CSI2).
void v4l2_fill_pix_format(struct v4l2_pix_format *pix_fmt, const struct v4l2_mbus_framefmt *mbus_fmt)

Ancillary routine that fills a struct v4l2_pix_format fields from a struct v4l2_mbus_framefmt.

Parameters

struct v4l2_pix_format *pix_fmt
pointer to struct v4l2_pix_format to be filled
const struct v4l2_mbus_framefmt *mbus_fmt
pointer to struct v4l2_mbus_framefmt to be used as model
void v4l2_fill_mbus_format(struct v4l2_mbus_framefmt *mbus_fmt, const struct v4l2_pix_format *pix_fmt, u32 code)

Ancillary routine that fills a struct v4l2_mbus_framefmt from a struct v4l2_pix_format and a data format code.

Parameters

struct v4l2_mbus_framefmt *mbus_fmt
pointer to struct v4l2_mbus_framefmt to be filled
const struct v4l2_pix_format *pix_fmt
pointer to struct v4l2_pix_format to be used as model
u32 code
data format code (from enum v4l2_mbus_pixelcode)
void v4l2_fill_pix_format_mplane(struct v4l2_pix_format_mplane *pix_mp_fmt, const struct v4l2_mbus_framefmt *mbus_fmt)

Ancillary routine that fills a struct v4l2_pix_format_mplane fields from a media bus structure.

Parameters

struct v4l2_pix_format_mplane *pix_mp_fmt
pointer to struct v4l2_pix_format_mplane to be filled
const struct v4l2_mbus_framefmt *mbus_fmt
pointer to struct v4l2_mbus_framefmt to be used as model
void v4l2_fill_mbus_format_mplane(struct v4l2_mbus_framefmt *mbus_fmt, const struct v4l2_pix_format_mplane *pix_mp_fmt)

Ancillary routine that fills a struct v4l2_mbus_framefmt from a struct v4l2_pix_format_mplane.

Parameters

struct v4l2_mbus_framefmt *mbus_fmt
pointer to struct v4l2_mbus_framefmt to be filled
const struct v4l2_pix_format_mplane *pix_mp_fmt
pointer to struct v4l2_pix_format_mplane to be used as model