root/drivers/media/platform/ti/omap/omap_voutlib.c
/*
 * omap_voutlib.c
 *
 * Copyright (C) 2005-2010 Texas Instruments.
 *
 * This file is licensed under the terms of the GNU General Public License
 * version 2. This program is licensed "as is" without any warranty of any
 * kind, whether express or implied.
 *
 * Based on the OMAP2 camera driver
 * Video-for-Linux (Version 2) camera capture driver for
 * the OMAP24xx camera controller.
 *
 * Author: Andy Lowe (source@mvista.com)
 *
 * Copyright (C) 2004 MontaVista Software, Inc.
 * Copyright (C) 2010 Texas Instruments.
 *
 */

#include <linux/module.h>
#include <linux/errno.h>
#include <linux/kernel.h>
#include <linux/types.h>
#include <linux/videodev2.h>

#include <linux/dma-mapping.h>

#include <video/omapfb_dss.h>

#include "omap_voutlib.h"

MODULE_AUTHOR("Texas Instruments");
MODULE_DESCRIPTION("OMAP Video library");
MODULE_LICENSE("GPL");

/* Return the default overlay cropping rectangle in crop given the image
 * size in pix and the video display size in fbuf.  The default
 * cropping rectangle is the largest rectangle no larger than the capture size
 * that will fit on the display.  The default cropping rectangle is centered in
 * the image.  All dimensions and offsets are rounded down to even numbers.
 */
void omap_vout_default_crop(struct v4l2_pix_format *pix,
                  struct v4l2_framebuffer *fbuf, struct v4l2_rect *crop)
{
        crop->width = (pix->width < fbuf->fmt.width) ?
                pix->width : fbuf->fmt.width;
        crop->height = (pix->height < fbuf->fmt.height) ?
                pix->height : fbuf->fmt.height;
        crop->width &= ~1;
        crop->height &= ~1;
        crop->left = ((pix->width - crop->width) >> 1) & ~1;
        crop->top = ((pix->height - crop->height) >> 1) & ~1;
}
EXPORT_SYMBOL_GPL(omap_vout_default_crop);

/* Given a new render window in new_win, adjust the window to the
 * nearest supported configuration.  The adjusted window parameters are
 * returned in new_win.
 * Returns zero if successful, or -EINVAL if the requested window is
 * impossible and cannot reasonably be adjusted.
 */
int omap_vout_try_window(struct v4l2_framebuffer *fbuf,
                        struct v4l2_window *new_win)
{
        struct v4l2_rect try_win;

        /* make a working copy of the new_win rectangle */
        try_win = new_win->w;

        /* adjust the preview window so it fits on the display by clipping any
         * offscreen areas
         */
        if (try_win.left < 0) {
                try_win.width += try_win.left;
                try_win.left = 0;
        }
        if (try_win.top < 0) {
                try_win.height += try_win.top;
                try_win.top = 0;
        }
        try_win.width = (try_win.width < fbuf->fmt.width) ?
                try_win.width : fbuf->fmt.width;
        try_win.height = (try_win.height < fbuf->fmt.height) ?
                try_win.height : fbuf->fmt.height;
        if (try_win.left + try_win.width > fbuf->fmt.width)
                try_win.width = fbuf->fmt.width - try_win.left;
        if (try_win.top + try_win.height > fbuf->fmt.height)
                try_win.height = fbuf->fmt.height - try_win.top;
        try_win.width &= ~1;
        try_win.height &= ~1;

        if (try_win.width <= 0 || try_win.height <= 0)
                return -EINVAL;

        /* We now have a valid preview window, so go with it */
        new_win->w = try_win;
        new_win->field = V4L2_FIELD_NONE;
        new_win->clips = NULL;
        new_win->clipcount = 0;
        new_win->bitmap = NULL;

        return 0;
}
EXPORT_SYMBOL_GPL(omap_vout_try_window);

/* Given a new render window in new_win, adjust the window to the
 * nearest supported configuration.  The image cropping window in crop
 * will also be adjusted if necessary.  Preference is given to keeping the
 * window as close to the requested configuration as possible.  If
 * successful, new_win, vout->win, and crop are updated.
 * Returns zero if successful, or -EINVAL if the requested preview window is
 * impossible and cannot reasonably be adjusted.
 */
int omap_vout_new_window(struct v4l2_rect *crop,
                struct v4l2_window *win, struct v4l2_framebuffer *fbuf,
                struct v4l2_window *new_win)
{
        int err;

        err = omap_vout_try_window(fbuf, new_win);
        if (err)
                return err;

        /* update our preview window */
        win->w = new_win->w;
        win->field = new_win->field;
        win->chromakey = new_win->chromakey;

        /* Adjust the cropping window to allow for resizing limitation */
        if (omap_vout_dss_omap24xx()) {
                /* For 24xx limit is 8x to 1/2x scaling. */
                if ((crop->height/win->w.height) >= 2)
                        crop->height = win->w.height * 2;

                if ((crop->width/win->w.width) >= 2)
                        crop->width = win->w.width * 2;

                if (crop->width > 768) {
                        /* The OMAP2420 vertical resizing line buffer is 768
                         * pixels wide. If the cropped image is wider than
                         * 768 pixels then it cannot be vertically resized.
                         */
                        if (crop->height != win->w.height)
                                crop->width = 768;
                }
        } else if (omap_vout_dss_omap34xx()) {
                /* For 34xx limit is 8x to 1/4x scaling. */
                if ((crop->height/win->w.height) >= 4)
                        crop->height = win->w.height * 4;

                if ((crop->width/win->w.width) >= 4)
                        crop->width = win->w.width * 4;
        }
        return 0;
}
EXPORT_SYMBOL_GPL(omap_vout_new_window);

/* Given a new cropping rectangle in new_crop, adjust the cropping rectangle to
 * the nearest supported configuration.  The image render window in win will
 * also be adjusted if necessary.  The preview window is adjusted such that the
 * horizontal and vertical rescaling ratios stay constant.  If the render
 * window would fall outside the display boundaries, the cropping rectangle
 * will also be adjusted to maintain the rescaling ratios.  If successful, crop
 * and win are updated.
 * Returns zero if successful, or -EINVAL if the requested cropping rectangle is
 * impossible and cannot reasonably be adjusted.
 */
int omap_vout_new_crop(struct v4l2_pix_format *pix,
              struct v4l2_rect *crop, struct v4l2_window *win,
              struct v4l2_framebuffer *fbuf, const struct v4l2_rect *new_crop)
{
        struct v4l2_rect try_crop;
        unsigned long vresize, hresize;

        /* make a working copy of the new_crop rectangle */
        try_crop = *new_crop;

        /* adjust the cropping rectangle so it fits in the image */
        if (try_crop.left < 0) {
                try_crop.width += try_crop.left;
                try_crop.left = 0;
        }
        if (try_crop.top < 0) {
                try_crop.height += try_crop.top;
                try_crop.top = 0;
        }
        try_crop.width = (try_crop.width < pix->width) ?
                try_crop.width : pix->width;
        try_crop.height = (try_crop.height < pix->height) ?
                try_crop.height : pix->height;
        if (try_crop.left + try_crop.width > pix->width)
                try_crop.width = pix->width - try_crop.left;
        if (try_crop.top + try_crop.height > pix->height)
                try_crop.height = pix->height - try_crop.top;

        try_crop.width &= ~1;
        try_crop.height &= ~1;

        if (try_crop.width <= 0 || try_crop.height <= 0)
                return -EINVAL;

        if (omap_vout_dss_omap24xx()) {
                if (try_crop.height != win->w.height) {
                        /* If we're resizing vertically, we can't support a
                         * crop width wider than 768 pixels.
                         */
                        if (try_crop.width > 768)
                                try_crop.width = 768;
                }
        }
        /* vertical resizing */
        vresize = (1024 * try_crop.height) / win->w.height;
        if (omap_vout_dss_omap24xx() && (vresize > 2048))
                vresize = 2048;
        else if (omap_vout_dss_omap34xx() && (vresize > 4096))
                vresize = 4096;

        win->w.height = ((1024 * try_crop.height) / vresize) & ~1;
        if (win->w.height == 0)
                win->w.height = 2;
        if (win->w.height + win->w.top > fbuf->fmt.height) {
                /* We made the preview window extend below the bottom of the
                 * display, so clip it to the display boundary and resize the
                 * cropping height to maintain the vertical resizing ratio.
                 */
                win->w.height = (fbuf->fmt.height - win->w.top) & ~1;
                if (try_crop.height == 0)
                        try_crop.height = 2;
        }
        /* horizontal resizing */
        hresize = (1024 * try_crop.width) / win->w.width;
        if (omap_vout_dss_omap24xx() && (hresize > 2048))
                hresize = 2048;
        else if (omap_vout_dss_omap34xx() && (hresize > 4096))
                hresize = 4096;

        win->w.width = ((1024 * try_crop.width) / hresize) & ~1;
        if (win->w.width == 0)
                win->w.width = 2;
        if (win->w.width + win->w.left > fbuf->fmt.width) {
                /* We made the preview window extend past the right side of the
                 * display, so clip it to the display boundary and resize the
                 * cropping width to maintain the horizontal resizing ratio.
                 */
                win->w.width = (fbuf->fmt.width - win->w.left) & ~1;
                if (try_crop.width == 0)
                        try_crop.width = 2;
        }
        if (omap_vout_dss_omap24xx()) {
                if ((try_crop.height/win->w.height) >= 2)
                        try_crop.height = win->w.height * 2;

                if ((try_crop.width/win->w.width) >= 2)
                        try_crop.width = win->w.width * 2;

                if (try_crop.width > 768) {
                        /* The OMAP2420 vertical resizing line buffer is
                         * 768 pixels wide.  If the cropped image is wider
                         * than 768 pixels then it cannot be vertically resized.
                         */
                        if (try_crop.height != win->w.height)
                                try_crop.width = 768;
                }
        } else if (omap_vout_dss_omap34xx()) {
                if ((try_crop.height/win->w.height) >= 4)
                        try_crop.height = win->w.height * 4;

                if ((try_crop.width/win->w.width) >= 4)
                        try_crop.width = win->w.width * 4;
        }
        /* update our cropping rectangle and we're done */
        *crop = try_crop;
        return 0;
}
EXPORT_SYMBOL_GPL(omap_vout_new_crop);

/* Given a new format in pix and fbuf,  crop and win
 * structures are initialized to default values. crop
 * is initialized to the largest window size that will fit on the display.  The
 * crop window is centered in the image. win is initialized to
 * the same size as crop and is centered on the display.
 * All sizes and offsets are constrained to be even numbers.
 */
void omap_vout_new_format(struct v4l2_pix_format *pix,
                struct v4l2_framebuffer *fbuf, struct v4l2_rect *crop,
                struct v4l2_window *win)
{
        /* crop defines the preview source window in the image capture
         * buffer
         */
        omap_vout_default_crop(pix, fbuf, crop);

        /* win defines the preview target window on the display */
        win->w.width = crop->width;
        win->w.height = crop->height;
        win->w.left = ((fbuf->fmt.width - win->w.width) >> 1) & ~1;
        win->w.top = ((fbuf->fmt.height - win->w.height) >> 1) & ~1;
}
EXPORT_SYMBOL_GPL(omap_vout_new_format);

/*
 * Allocate buffers
 */
unsigned long omap_vout_alloc_buffer(u32 buf_size, u32 *phys_addr)
{
        u32 order, size;
        unsigned long virt_addr, addr;

        size = PAGE_ALIGN(buf_size);
        order = get_order(size);
        virt_addr = __get_free_pages(GFP_KERNEL, order);
        addr = virt_addr;

        if (virt_addr) {
                while (size > 0) {
                        SetPageReserved(virt_to_page((void *)addr));
                        addr += PAGE_SIZE;
                        size -= PAGE_SIZE;
                }
        }
        *phys_addr = (u32) virt_to_phys((void *) virt_addr);
        return virt_addr;
}

/*
 * Free buffers
 */
void omap_vout_free_buffer(unsigned long virtaddr, u32 buf_size)
{
        u32 order, size;
        unsigned long addr = virtaddr;

        size = PAGE_ALIGN(buf_size);
        order = get_order(size);

        while (size > 0) {
                ClearPageReserved(virt_to_page((void *)addr));
                addr += PAGE_SIZE;
                size -= PAGE_SIZE;
        }
        free_pages((unsigned long) virtaddr, order);
}

bool omap_vout_dss_omap24xx(void)
{
        return omapdss_get_version() == OMAPDSS_VER_OMAP24xx;
}

bool omap_vout_dss_omap34xx(void)
{
        switch (omapdss_get_version()) {
        case OMAPDSS_VER_OMAP34xx_ES1:
        case OMAPDSS_VER_OMAP34xx_ES3:
        case OMAPDSS_VER_OMAP3630:
        case OMAPDSS_VER_AM35xx:
                return true;
        default:
                return false;
        }
}