saa7146_vv.h 7.6 KB

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