1 /* SPDX-License-Identifier: GPL-2.0 */ 2 #ifndef __SAA7146_VV__ 3 #define __SAA7146_VV__ 4 5 #include <media/v4l2-common.h> 6 #include <media/v4l2-ioctl.h> 7 #include <media/v4l2-fh.h> 8 #include <media/drv-intf/saa7146.h> 9 #include <media/videobuf-dma-sg.h> 10 11 #define MAX_SAA7146_CAPTURE_BUFFERS 32 /* arbitrary */ 12 #define BUFFER_TIMEOUT (HZ/2) /* 0.5 seconds */ 13 14 #define WRITE_RPS0(x) do { \ 15 dev->d_rps0.cpu_addr[ count++ ] = cpu_to_le32(x); \ 16 } while (0); 17 18 #define WRITE_RPS1(x) do { \ 19 dev->d_rps1.cpu_addr[ count++ ] = cpu_to_le32(x); \ 20 } while (0); 21 22 struct saa7146_video_dma { 23 u32 base_odd; 24 u32 base_even; 25 u32 prot_addr; 26 u32 pitch; 27 u32 base_page; 28 u32 num_line_byte; 29 }; 30 31 #define FORMAT_BYTE_SWAP 0x1 32 #define FORMAT_IS_PLANAR 0x2 33 34 struct saa7146_format { 35 char *name; 36 u32 pixelformat; 37 u32 trans; 38 u8 depth; 39 u8 flags; 40 u8 swap; 41 }; 42 43 struct saa7146_standard 44 { 45 char *name; 46 v4l2_std_id id; 47 48 int v_offset; /* number of lines of vertical offset before processing */ 49 int v_field; /* number of lines in a field for HPS to process */ 50 51 int h_offset; /* horizontal offset of processing window */ 52 int h_pixels; /* number of horizontal pixels to process */ 53 54 int v_max_out; 55 int h_max_out; 56 }; 57 58 /* buffer for one video/vbi frame */ 59 struct saa7146_buf { 60 /* common v4l buffer stuff -- must be first */ 61 struct videobuf_buffer vb; 62 63 /* saa7146 specific */ 64 struct v4l2_pix_format *fmt; 65 int (*activate)(struct saa7146_dev *dev, 66 struct saa7146_buf *buf, 67 struct saa7146_buf *next); 68 69 /* page tables */ 70 struct saa7146_pgtable pt[3]; 71 }; 72 73 struct saa7146_dmaqueue { 74 struct saa7146_dev *dev; 75 struct saa7146_buf *curr; 76 struct list_head queue; 77 struct timer_list timeout; 78 }; 79 80 struct saa7146_overlay { 81 struct saa7146_fh *fh; 82 struct v4l2_window win; 83 struct v4l2_clip clips[16]; 84 int nclips; 85 }; 86 87 /* per open data */ 88 struct saa7146_fh { 89 /* Must be the first field! */ 90 struct v4l2_fh fh; 91 struct saa7146_dev *dev; 92 93 /* video capture */ 94 struct videobuf_queue video_q; 95 96 /* vbi capture */ 97 struct videobuf_queue vbi_q; 98 99 unsigned int resources; /* resource management for device open */ 100 }; 101 102 #define STATUS_OVERLAY 0x01 103 #define STATUS_CAPTURE 0x02 104 105 struct saa7146_vv 106 { 107 /* vbi capture */ 108 struct saa7146_dmaqueue vbi_dmaq; 109 struct v4l2_vbi_format vbi_fmt; 110 struct timer_list vbi_read_timeout; 111 struct file *vbi_read_timeout_file; 112 /* vbi workaround interrupt queue */ 113 wait_queue_head_t vbi_wq; 114 int vbi_fieldcount; 115 struct saa7146_fh *vbi_streaming; 116 117 int video_status; 118 struct saa7146_fh *video_fh; 119 120 /* video overlay */ 121 struct saa7146_overlay ov; 122 struct v4l2_framebuffer ov_fb; 123 struct saa7146_format *ov_fmt; 124 struct saa7146_fh *ov_suspend; 125 126 /* video capture */ 127 struct saa7146_dmaqueue video_dmaq; 128 struct v4l2_pix_format video_fmt; 129 enum v4l2_field last_field; 130 131 /* common: fixme? shouldn't this be in saa7146_fh? 132 (this leads to a more complicated question: shall the driver 133 store the different settings (for example S_INPUT) for every open 134 and restore it appropriately, or should all settings be common for 135 all opens? currently, we do the latter, like all other 136 drivers do... */ 137 struct saa7146_standard *standard; 138 139 int vflip; 140 int hflip; 141 int current_hps_source; 142 int current_hps_sync; 143 144 struct saa7146_dma d_clipping; /* pointer to clipping memory */ 145 146 unsigned int resources; /* resource management for device */ 147 }; 148 149 /* flags */ 150 #define SAA7146_USE_PORT_B_FOR_VBI 0x2 /* use input port b for vbi hardware bug workaround */ 151 152 struct saa7146_ext_vv 153 { 154 /* information about the video capabilities of the device */ 155 int inputs; 156 int audios; 157 u32 capabilities; 158 int flags; 159 160 /* additionally supported transmission standards */ 161 struct saa7146_standard *stds; 162 int num_stds; 163 int (*std_callback)(struct saa7146_dev*, struct saa7146_standard *); 164 165 /* the extension can override this */ 166 struct v4l2_ioctl_ops vid_ops; 167 struct v4l2_ioctl_ops vbi_ops; 168 /* pointer to the saa7146 core ops */ 169 const struct v4l2_ioctl_ops *core_ops; 170 171 struct v4l2_file_operations vbi_fops; 172 }; 173 174 struct saa7146_use_ops { 175 void (*init)(struct saa7146_dev *, struct saa7146_vv *); 176 int(*open)(struct saa7146_dev *, struct file *); 177 void (*release)(struct saa7146_dev *, struct file *); 178 void (*irq_done)(struct saa7146_dev *, unsigned long status); 179 ssize_t (*read)(struct file *, char __user *, size_t, loff_t *); 180 }; 181 182 /* from saa7146_fops.c */ 183 int saa7146_register_device(struct video_device *vid, struct saa7146_dev *dev, char *name, int type); 184 int saa7146_unregister_device(struct video_device *vid, struct saa7146_dev *dev); 185 void saa7146_buffer_finish(struct saa7146_dev *dev, struct saa7146_dmaqueue *q, int state); 186 void saa7146_buffer_next(struct saa7146_dev *dev, struct saa7146_dmaqueue *q,int vbi); 187 int saa7146_buffer_queue(struct saa7146_dev *dev, struct saa7146_dmaqueue *q, struct saa7146_buf *buf); 188 void saa7146_buffer_timeout(struct timer_list *t); 189 void saa7146_dma_free(struct saa7146_dev* dev,struct videobuf_queue *q, 190 struct saa7146_buf *buf); 191 192 int saa7146_vv_init(struct saa7146_dev* dev, struct saa7146_ext_vv *ext_vv); 193 int saa7146_vv_release(struct saa7146_dev* dev); 194 195 /* from saa7146_hlp.c */ 196 int saa7146_enable_overlay(struct saa7146_fh *fh); 197 void saa7146_disable_overlay(struct saa7146_fh *fh); 198 199 void saa7146_set_capture(struct saa7146_dev *dev, struct saa7146_buf *buf, struct saa7146_buf *next); 200 void saa7146_write_out_dma(struct saa7146_dev* dev, int which, struct saa7146_video_dma* vdma) ; 201 void saa7146_set_hps_source_and_sync(struct saa7146_dev *saa, int source, int sync); 202 void saa7146_set_gpio(struct saa7146_dev *saa, u8 pin, u8 data); 203 204 /* from saa7146_video.c */ 205 extern const struct v4l2_ioctl_ops saa7146_video_ioctl_ops; 206 extern const struct v4l2_ioctl_ops saa7146_vbi_ioctl_ops; 207 extern const struct saa7146_use_ops saa7146_video_uops; 208 int saa7146_start_preview(struct saa7146_fh *fh); 209 int saa7146_stop_preview(struct saa7146_fh *fh); 210 long saa7146_video_do_ioctl(struct file *file, unsigned int cmd, void *arg); 211 int saa7146_s_ctrl(struct v4l2_ctrl *ctrl); 212 213 /* from saa7146_vbi.c */ 214 extern const struct saa7146_use_ops saa7146_vbi_uops; 215 216 /* resource management functions */ 217 int saa7146_res_get(struct saa7146_fh *fh, unsigned int bit); 218 void saa7146_res_free(struct saa7146_fh *fh, unsigned int bits); 219 220 #define RESOURCE_DMA1_HPS 0x1 221 #define RESOURCE_DMA2_CLP 0x2 222 #define RESOURCE_DMA3_BRS 0x4 223 224 /* saa7146 source inputs */ 225 #define SAA7146_HPS_SOURCE_PORT_A 0x00 226 #define SAA7146_HPS_SOURCE_PORT_B 0x01 227 #define SAA7146_HPS_SOURCE_YPB_CPA 0x02 228 #define SAA7146_HPS_SOURCE_YPA_CPB 0x03 229 230 /* sync inputs */ 231 #define SAA7146_HPS_SYNC_PORT_A 0x00 232 #define SAA7146_HPS_SYNC_PORT_B 0x01 233 234 /* some memory sizes */ 235 /* max. 16 clipping rectangles */ 236 #define SAA7146_CLIPPING_MEM (16 * 4 * sizeof(u32)) 237 238 /* some defines for the various clipping-modes */ 239 #define SAA7146_CLIPPING_RECT 0x4 240 #define SAA7146_CLIPPING_RECT_INVERTED 0x5 241 #define SAA7146_CLIPPING_MASK 0x6 242 #define SAA7146_CLIPPING_MASK_INVERTED 0x7 243 244 /* output formats: each entry holds four information */ 245 #define RGB08_COMPOSED 0x0217 /* composed is used in the sense of "not-planar" */ 246 /* this means: planar?=0, yuv2rgb-conversation-mode=2, dither=yes(=1), format-mode = 7 */ 247 #define RGB15_COMPOSED 0x0213 248 #define RGB16_COMPOSED 0x0210 249 #define RGB24_COMPOSED 0x0201 250 #define RGB32_COMPOSED 0x0202 251 252 #define Y8 0x0006 253 #define YUV411_COMPOSED 0x0003 254 #define YUV422_COMPOSED 0x0000 255 /* this means: planar?=1, yuv2rgb-conversion-mode=0, dither=no(=0), format-mode = b */ 256 #define YUV411_DECOMPOSED 0x100b 257 #define YUV422_DECOMPOSED 0x1009 258 #define YUV420_DECOMPOSED 0x100a 259 260 #define IS_PLANAR(x) (x & 0xf000) 261 262 /* misc defines */ 263 #define SAA7146_NO_SWAP (0x0) 264 #define SAA7146_TWO_BYTE_SWAP (0x1) 265 #define SAA7146_FOUR_BYTE_SWAP (0x2) 266 267 #endif 268