[media] davinci vpbe: V4L2 display driver for DM644X SoC

/*

 * Copyright (C) 2010 Texas Instruments Incorporated - http://www.ti.com/

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License as

 * published by the Free Software Foundation version 2.

 *

 * This program is distributed WITHOUT ANY WARRANTY of any

 * kind, whether express or implied; without even the implied warranty

 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 */

#ifndef VPBE_DISPLAY_H

#define VPBE_DISPLAY_H

/* Header files */

#include <linux/videodev2.h>

#include <media/v4l2-common.h>

#include <media/videobuf-dma-contig.h>

#include <media/davinci/vpbe_types.h>

#include <media/davinci/vpbe_osd.h>

#include <media/davinci/vpbe.h>

#define VPBE_DISPLAY_MAX_DEVICES 2

enum vpbe_display_device_id {

	VPBE_DISPLAY_DEVICE_0,

	VPBE_DISPLAY_DEVICE_1

};

#define VPBE_DISPLAY_DRV_NAME	"vpbe-display"

#define VPBE_DISPLAY_MAJOR_RELEASE              1

#define VPBE_DISPLAY_MINOR_RELEASE              0

#define VPBE_DISPLAY_BUILD                      1

#define VPBE_DISPLAY_VERSION_CODE ((VPBE_DISPLAY_MAJOR_RELEASE << 16) | \

	(VPBE_DISPLAY_MINOR_RELEASE << 8)  | \

	VPBE_DISPLAY_BUILD)

#define VPBE_DISPLAY_VALID_FIELD(field)   ((V4L2_FIELD_NONE == field) || \

	 (V4L2_FIELD_ANY == field) || (V4L2_FIELD_INTERLACED == field))

/* Exp ratio numerator and denominator constants */

#define VPBE_DISPLAY_H_EXP_RATIO_N	9

#define VPBE_DISPLAY_H_EXP_RATIO_D	8

#define VPBE_DISPLAY_V_EXP_RATIO_N	6

#define VPBE_DISPLAY_V_EXP_RATIO_D	5

/* Zoom multiplication factor */

#define VPBE_DISPLAY_ZOOM_4X	4

#define VPBE_DISPLAY_ZOOM_2X	2

/* Structures */

struct display_layer_info {

	int enable;

	/* Layer ID used by Display Manager */

	enum osd_layer id;

	struct osd_layer_config config;

	enum osd_zoom_factor h_zoom;

	enum osd_zoom_factor v_zoom;

	enum osd_h_exp_ratio h_exp;

	enum osd_v_exp_ratio v_exp;

};

/* vpbe display object structure */

struct vpbe_layer {

	/* number of buffers in fbuffers */

	unsigned int numbuffers;

	/* Pointer to the vpbe_display */

	struct vpbe_display *disp_dev;

	/* Pointer pointing to current v4l2_buffer */

	struct videobuf_buffer *cur_frm;

	/* Pointer pointing to next v4l2_buffer */

	struct videobuf_buffer *next_frm;

	/* videobuf specific parameters

	 * Buffer queue used in video-buf

	 */

	struct videobuf_queue buffer_queue;

	/* Queue of filled frames */

	struct list_head dma_queue;

	/* Used in video-buf */

	spinlock_t irqlock;

	/* V4l2 specific parameters */

	/* Identifies video device for this layer */

	struct video_device video_dev;

	/* This field keeps track of type of buffer exchange mechanism user

	 * has selected

	 */

	enum v4l2_memory memory;

	/* Used to keep track of state of the priority */

	struct v4l2_prio_state prio;

	/* Used to store pixel format */

	struct v4l2_pix_format pix_fmt;

	enum v4l2_field buf_field;

	/* Video layer configuration params */

	struct display_layer_info layer_info;

	/* vpbe specific parameters

	 * enable window for display

	 */

	unsigned char window_enable;

	/* number of open instances of the layer */

	unsigned int usrs;

	/* number of users performing IO */

	unsigned int io_usrs;

	/* Indicates id of the field which is being displayed */

	unsigned int field_id;

	/* Indicates whether streaming started */

	unsigned char started;

	/* Identifies device object */

	enum vpbe_display_device_id device_id;

	/* facilitation of ioctl ops lock by v4l2*/

	struct mutex opslock;

	u8 layer_first_int;

};

/* vpbe device structure */

struct vpbe_display {

	/* layer specific parameters */

	/* lock for isr updates to buf layers*/

	spinlock_t dma_queue_lock;

	/* C-Plane offset from start of y-plane */

	unsigned int cbcr_ofst;

	struct vpbe_layer *dev[VPBE_DISPLAY_MAX_DEVICES];

	struct vpbe_device *vpbe_dev;

	struct osd_state *osd_device;

};

/* File handle structure */

struct vpbe_fh {

	/* vpbe device structure */

	struct vpbe_display *disp_dev;

	/* pointer to layer object for opened device */

	struct vpbe_layer *layer;

	/* Indicates whether this file handle is doing IO */

	unsigned char io_allowed;

	/* Used to keep track priority of this instance */

	enum v4l2_priority prio;

};

struct buf_config_params {

	unsigned char min_numbuffers;

	unsigned char numbuffers[VPBE_DISPLAY_MAX_DEVICES];

	unsigned int min_bufsize[VPBE_DISPLAY_MAX_DEVICES];

	unsigned int layer_bufsize[VPBE_DISPLAY_MAX_DEVICES];

};

#endif	/* VPBE_DISPLAY_H */

/*

 * Copyright (C) 2010 Texas Instruments Inc

 *

 * This program is free software; you can redistribute it and/or modify

 * it under the terms of the GNU General Public License as published by

 * the Free Software Foundation version 2.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

 */

#ifndef _VPBE_TYPES_H

#define _VPBE_TYPES_H

enum vpbe_version {

	VPBE_VERSION_1 = 1,

	VPBE_VERSION_2,

	VPBE_VERSION_3,

};

/* vpbe_timing_type - Timing types used in vpbe device */

enum vpbe_enc_timings_type {

	VPBE_ENC_STD = 0x1,

	VPBE_ENC_DV_PRESET = 0x2,

	VPBE_ENC_CUSTOM_TIMINGS = 0x4,

	/* Used when set timings through FB device interface */

	VPBE_ENC_TIMINGS_INVALID = 0x8,

};

union vpbe_timings {

	v4l2_std_id std_id;

	unsigned int dv_preset;

};

/*

 * struct vpbe_enc_mode_info

 * @name: ptr to name string of the standard, "NTSC", "PAL" etc

 * @std: standard or non-standard mode. 1 - standard, 0 - nonstandard

 * @interlaced: 1 - interlaced, 0 - non interlaced/progressive

 * @xres: x or horizontal resolution of the display

 * @yres: y or vertical resolution of the display

 * @fps: frame per second

 * @left_margin: left margin of the display

 * @right_margin: right margin of the display

 * @upper_margin: upper margin of the display

 * @lower_margin: lower margin of the display

 * @hsync_len: h-sync length

 * @vsync_len: v-sync length

 * @flags: bit field: bit usage is documented below

 *

 * Description:

 *  Structure holding timing and resolution information of a standard.

 * Used by vpbe_device to set required non-standard timing in the

 * venc when lcd controller output is connected to a external encoder.

 * A table of timings is maintained in vpbe device to set this in

 * venc when external encoder is connected to lcd controller output.

 * Encoder may provide a g_dv_timings() API to override these values

 * as needed.

 *

 *  Notes

 *  ------

 *  if_type should be used only by encoder manager and encoder.

 *  flags usage

 *     b0 (LSB) - hsync polarity, 0 - negative, 1 - positive

 *     b1       - vsync polarity, 0 - negative, 1 - positive

 *     b2       - field id polarity, 0 - negative, 1  - positive

 */

struct vpbe_enc_mode_info {

	unsigned char *name;

	enum vpbe_enc_timings_type timings_type;

	union vpbe_timings timings;

	unsigned int interlaced;

	unsigned int xres;

	unsigned int yres;

	struct v4l2_fract aspect;

	struct v4l2_fract fps;

	unsigned int left_margin;

	unsigned int right_margin;

	unsigned int upper_margin;

	unsigned int lower_margin;

	unsigned int hsync_len;

	unsigned int vsync_len;

	unsigned int flags;

};

#endif