omap_voutlib.c (11026B)
1/* 2 * omap_voutlib.c 3 * 4 * Copyright (C) 2005-2010 Texas Instruments. 5 * 6 * This file is licensed under the terms of the GNU General Public License 7 * version 2. This program is licensed "as is" without any warranty of any 8 * kind, whether express or implied. 9 * 10 * Based on the OMAP2 camera driver 11 * Video-for-Linux (Version 2) camera capture driver for 12 * the OMAP24xx camera controller. 13 * 14 * Author: Andy Lowe (source@mvista.com) 15 * 16 * Copyright (C) 2004 MontaVista Software, Inc. 17 * Copyright (C) 2010 Texas Instruments. 18 * 19 */ 20 21#include <linux/module.h> 22#include <linux/errno.h> 23#include <linux/kernel.h> 24#include <linux/types.h> 25#include <linux/videodev2.h> 26 27#include <linux/dma-mapping.h> 28 29#include <video/omapfb_dss.h> 30 31#include "omap_voutlib.h" 32 33MODULE_AUTHOR("Texas Instruments"); 34MODULE_DESCRIPTION("OMAP Video library"); 35MODULE_LICENSE("GPL"); 36 37/* Return the default overlay cropping rectangle in crop given the image 38 * size in pix and the video display size in fbuf. The default 39 * cropping rectangle is the largest rectangle no larger than the capture size 40 * that will fit on the display. The default cropping rectangle is centered in 41 * the image. All dimensions and offsets are rounded down to even numbers. 42 */ 43void omap_vout_default_crop(struct v4l2_pix_format *pix, 44 struct v4l2_framebuffer *fbuf, struct v4l2_rect *crop) 45{ 46 crop->width = (pix->width < fbuf->fmt.width) ? 47 pix->width : fbuf->fmt.width; 48 crop->height = (pix->height < fbuf->fmt.height) ? 49 pix->height : fbuf->fmt.height; 50 crop->width &= ~1; 51 crop->height &= ~1; 52 crop->left = ((pix->width - crop->width) >> 1) & ~1; 53 crop->top = ((pix->height - crop->height) >> 1) & ~1; 54} 55EXPORT_SYMBOL_GPL(omap_vout_default_crop); 56 57/* Given a new render window in new_win, adjust the window to the 58 * nearest supported configuration. The adjusted window parameters are 59 * returned in new_win. 60 * Returns zero if successful, or -EINVAL if the requested window is 61 * impossible and cannot reasonably be adjusted. 62 */ 63int omap_vout_try_window(struct v4l2_framebuffer *fbuf, 64 struct v4l2_window *new_win) 65{ 66 struct v4l2_rect try_win; 67 68 /* make a working copy of the new_win rectangle */ 69 try_win = new_win->w; 70 71 /* adjust the preview window so it fits on the display by clipping any 72 * offscreen areas 73 */ 74 if (try_win.left < 0) { 75 try_win.width += try_win.left; 76 try_win.left = 0; 77 } 78 if (try_win.top < 0) { 79 try_win.height += try_win.top; 80 try_win.top = 0; 81 } 82 try_win.width = (try_win.width < fbuf->fmt.width) ? 83 try_win.width : fbuf->fmt.width; 84 try_win.height = (try_win.height < fbuf->fmt.height) ? 85 try_win.height : fbuf->fmt.height; 86 if (try_win.left + try_win.width > fbuf->fmt.width) 87 try_win.width = fbuf->fmt.width - try_win.left; 88 if (try_win.top + try_win.height > fbuf->fmt.height) 89 try_win.height = fbuf->fmt.height - try_win.top; 90 try_win.width &= ~1; 91 try_win.height &= ~1; 92 93 if (try_win.width <= 0 || try_win.height <= 0) 94 return -EINVAL; 95 96 /* We now have a valid preview window, so go with it */ 97 new_win->w = try_win; 98 new_win->field = V4L2_FIELD_NONE; 99 new_win->clips = NULL; 100 new_win->clipcount = 0; 101 new_win->bitmap = NULL; 102 103 return 0; 104} 105EXPORT_SYMBOL_GPL(omap_vout_try_window); 106 107/* Given a new render window in new_win, adjust the window to the 108 * nearest supported configuration. The image cropping window in crop 109 * will also be adjusted if necessary. Preference is given to keeping the 110 * the window as close to the requested configuration as possible. If 111 * successful, new_win, vout->win, and crop are updated. 112 * Returns zero if successful, or -EINVAL if the requested preview window is 113 * impossible and cannot reasonably be adjusted. 114 */ 115int omap_vout_new_window(struct v4l2_rect *crop, 116 struct v4l2_window *win, struct v4l2_framebuffer *fbuf, 117 struct v4l2_window *new_win) 118{ 119 int err; 120 121 err = omap_vout_try_window(fbuf, new_win); 122 if (err) 123 return err; 124 125 /* update our preview window */ 126 win->w = new_win->w; 127 win->field = new_win->field; 128 win->chromakey = new_win->chromakey; 129 130 /* Adjust the cropping window to allow for resizing limitation */ 131 if (omap_vout_dss_omap24xx()) { 132 /* For 24xx limit is 8x to 1/2x scaling. */ 133 if ((crop->height/win->w.height) >= 2) 134 crop->height = win->w.height * 2; 135 136 if ((crop->width/win->w.width) >= 2) 137 crop->width = win->w.width * 2; 138 139 if (crop->width > 768) { 140 /* The OMAP2420 vertical resizing line buffer is 768 141 * pixels wide. If the cropped image is wider than 142 * 768 pixels then it cannot be vertically resized. 143 */ 144 if (crop->height != win->w.height) 145 crop->width = 768; 146 } 147 } else if (omap_vout_dss_omap34xx()) { 148 /* For 34xx limit is 8x to 1/4x scaling. */ 149 if ((crop->height/win->w.height) >= 4) 150 crop->height = win->w.height * 4; 151 152 if ((crop->width/win->w.width) >= 4) 153 crop->width = win->w.width * 4; 154 } 155 return 0; 156} 157EXPORT_SYMBOL_GPL(omap_vout_new_window); 158 159/* Given a new cropping rectangle in new_crop, adjust the cropping rectangle to 160 * the nearest supported configuration. The image render window in win will 161 * also be adjusted if necessary. The preview window is adjusted such that the 162 * horizontal and vertical rescaling ratios stay constant. If the render 163 * window would fall outside the display boundaries, the cropping rectangle 164 * will also be adjusted to maintain the rescaling ratios. If successful, crop 165 * and win are updated. 166 * Returns zero if successful, or -EINVAL if the requested cropping rectangle is 167 * impossible and cannot reasonably be adjusted. 168 */ 169int omap_vout_new_crop(struct v4l2_pix_format *pix, 170 struct v4l2_rect *crop, struct v4l2_window *win, 171 struct v4l2_framebuffer *fbuf, const struct v4l2_rect *new_crop) 172{ 173 struct v4l2_rect try_crop; 174 unsigned long vresize, hresize; 175 176 /* make a working copy of the new_crop rectangle */ 177 try_crop = *new_crop; 178 179 /* adjust the cropping rectangle so it fits in the image */ 180 if (try_crop.left < 0) { 181 try_crop.width += try_crop.left; 182 try_crop.left = 0; 183 } 184 if (try_crop.top < 0) { 185 try_crop.height += try_crop.top; 186 try_crop.top = 0; 187 } 188 try_crop.width = (try_crop.width < pix->width) ? 189 try_crop.width : pix->width; 190 try_crop.height = (try_crop.height < pix->height) ? 191 try_crop.height : pix->height; 192 if (try_crop.left + try_crop.width > pix->width) 193 try_crop.width = pix->width - try_crop.left; 194 if (try_crop.top + try_crop.height > pix->height) 195 try_crop.height = pix->height - try_crop.top; 196 197 try_crop.width &= ~1; 198 try_crop.height &= ~1; 199 200 if (try_crop.width <= 0 || try_crop.height <= 0) 201 return -EINVAL; 202 203 if (omap_vout_dss_omap24xx()) { 204 if (try_crop.height != win->w.height) { 205 /* If we're resizing vertically, we can't support a 206 * crop width wider than 768 pixels. 207 */ 208 if (try_crop.width > 768) 209 try_crop.width = 768; 210 } 211 } 212 /* vertical resizing */ 213 vresize = (1024 * try_crop.height) / win->w.height; 214 if (omap_vout_dss_omap24xx() && (vresize > 2048)) 215 vresize = 2048; 216 else if (omap_vout_dss_omap34xx() && (vresize > 4096)) 217 vresize = 4096; 218 219 win->w.height = ((1024 * try_crop.height) / vresize) & ~1; 220 if (win->w.height == 0) 221 win->w.height = 2; 222 if (win->w.height + win->w.top > fbuf->fmt.height) { 223 /* We made the preview window extend below the bottom of the 224 * display, so clip it to the display boundary and resize the 225 * cropping height to maintain the vertical resizing ratio. 226 */ 227 win->w.height = (fbuf->fmt.height - win->w.top) & ~1; 228 if (try_crop.height == 0) 229 try_crop.height = 2; 230 } 231 /* horizontal resizing */ 232 hresize = (1024 * try_crop.width) / win->w.width; 233 if (omap_vout_dss_omap24xx() && (hresize > 2048)) 234 hresize = 2048; 235 else if (omap_vout_dss_omap34xx() && (hresize > 4096)) 236 hresize = 4096; 237 238 win->w.width = ((1024 * try_crop.width) / hresize) & ~1; 239 if (win->w.width == 0) 240 win->w.width = 2; 241 if (win->w.width + win->w.left > fbuf->fmt.width) { 242 /* We made the preview window extend past the right side of the 243 * display, so clip it to the display boundary and resize the 244 * cropping width to maintain the horizontal resizing ratio. 245 */ 246 win->w.width = (fbuf->fmt.width - win->w.left) & ~1; 247 if (try_crop.width == 0) 248 try_crop.width = 2; 249 } 250 if (omap_vout_dss_omap24xx()) { 251 if ((try_crop.height/win->w.height) >= 2) 252 try_crop.height = win->w.height * 2; 253 254 if ((try_crop.width/win->w.width) >= 2) 255 try_crop.width = win->w.width * 2; 256 257 if (try_crop.width > 768) { 258 /* The OMAP2420 vertical resizing line buffer is 259 * 768 pixels wide. If the cropped image is wider 260 * than 768 pixels then it cannot be vertically resized. 261 */ 262 if (try_crop.height != win->w.height) 263 try_crop.width = 768; 264 } 265 } else if (omap_vout_dss_omap34xx()) { 266 if ((try_crop.height/win->w.height) >= 4) 267 try_crop.height = win->w.height * 4; 268 269 if ((try_crop.width/win->w.width) >= 4) 270 try_crop.width = win->w.width * 4; 271 } 272 /* update our cropping rectangle and we're done */ 273 *crop = try_crop; 274 return 0; 275} 276EXPORT_SYMBOL_GPL(omap_vout_new_crop); 277 278/* Given a new format in pix and fbuf, crop and win 279 * structures are initialized to default values. crop 280 * is initialized to the largest window size that will fit on the display. The 281 * crop window is centered in the image. win is initialized to 282 * the same size as crop and is centered on the display. 283 * All sizes and offsets are constrained to be even numbers. 284 */ 285void omap_vout_new_format(struct v4l2_pix_format *pix, 286 struct v4l2_framebuffer *fbuf, struct v4l2_rect *crop, 287 struct v4l2_window *win) 288{ 289 /* crop defines the preview source window in the image capture 290 * buffer 291 */ 292 omap_vout_default_crop(pix, fbuf, crop); 293 294 /* win defines the preview target window on the display */ 295 win->w.width = crop->width; 296 win->w.height = crop->height; 297 win->w.left = ((fbuf->fmt.width - win->w.width) >> 1) & ~1; 298 win->w.top = ((fbuf->fmt.height - win->w.height) >> 1) & ~1; 299} 300EXPORT_SYMBOL_GPL(omap_vout_new_format); 301 302/* 303 * Allocate buffers 304 */ 305unsigned long omap_vout_alloc_buffer(u32 buf_size, u32 *phys_addr) 306{ 307 u32 order, size; 308 unsigned long virt_addr, addr; 309 310 size = PAGE_ALIGN(buf_size); 311 order = get_order(size); 312 virt_addr = __get_free_pages(GFP_KERNEL, order); 313 addr = virt_addr; 314 315 if (virt_addr) { 316 while (size > 0) { 317 SetPageReserved(virt_to_page(addr)); 318 addr += PAGE_SIZE; 319 size -= PAGE_SIZE; 320 } 321 } 322 *phys_addr = (u32) virt_to_phys((void *) virt_addr); 323 return virt_addr; 324} 325 326/* 327 * Free buffers 328 */ 329void omap_vout_free_buffer(unsigned long virtaddr, u32 buf_size) 330{ 331 u32 order, size; 332 unsigned long addr = virtaddr; 333 334 size = PAGE_ALIGN(buf_size); 335 order = get_order(size); 336 337 while (size > 0) { 338 ClearPageReserved(virt_to_page(addr)); 339 addr += PAGE_SIZE; 340 size -= PAGE_SIZE; 341 } 342 free_pages((unsigned long) virtaddr, order); 343} 344 345bool omap_vout_dss_omap24xx(void) 346{ 347 return omapdss_get_version() == OMAPDSS_VER_OMAP24xx; 348} 349 350bool omap_vout_dss_omap34xx(void) 351{ 352 switch (omapdss_get_version()) { 353 case OMAPDSS_VER_OMAP34xx_ES1: 354 case OMAPDSS_VER_OMAP34xx_ES3: 355 case OMAPDSS_VER_OMAP3630: 356 case OMAPDSS_VER_AM35xx: 357 return true; 358 default: 359 return false; 360 } 361}