libhwcomposer: Add initial support

Add basic HW Composer support that allows boot to UI. More
functionality will be added incrementally.

Test: Boot to UI with BeagleBoard X15
Change-Id: I9803cc892dfe85b8b9929229ba3b86f2bd9d36bc
Signed-off-by: Andrew F. Davis <afd@ti.com>

1 files changed, 245 insertions, 0 deletions

diff --git a/libhwcomposer/hal_public.h b/libhwcomposer/hal_public.h
new file mode 100644
index 0000000..5ca9bd2
--- /dev/null
+++ b/libhwcomposer/hal_public.h
@@ -0,0 +1,245 @@
+/* Copyright (c) Imagination Technologies Ltd.
+ *
+ * The contents of this file are subject to the MIT license as set out below.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+#ifndef HAL_PUBLIC_H
+#define HAL_PUBLIC_H
+
+/* Authors of third party hardware composer (HWC) modules will need to include
+ * this header to access functionality in the gralloc and framebuffer HALs.
+ */
+
+#include <hardware/gralloc.h>
+#include <hardware/memtrack.h>
+
+#define ALIGN(x,a)      (((x) + (a) - 1L) & ~((a) - 1L))
+#define HW_ALIGN        16
+
+/* This can be tuned down as appropriate for the SOC.
+ *
+ * IMG formats are usually a single sub-alloc.
+ * Some OEM video formats are two sub-allocs (Y, UV planes).
+ * Future OEM video formats might be three sub-allocs (Y, U, V planes).
+ */
+#define MAX_SUB_ALLOCS 3
+
+/* Format is not YCbCr (e.g. a RGB format) - bIsYUVFormat should be false */
+#define YUV_CHROMA_ORDER_NONE 0
+/* Cb follows Y */
+#define YUV_CHROMA_ORDER_CBCR_UV 1
+/* Cr follows Y */
+#define YUV_CHROMA_ORDER_CRCB_VU 2
+
+typedef struct
+{
+        native_handle_t base;
+
+        /* These fields can be sent cross process. They are also valid
+         * to duplicate within the same process.
+         *
+         * A table is stored within psPrivateData on gralloc_module_t (this
+         * is obviously per-process) which maps stamps to a mapped
+         * PVRSRV_CLIENT_MEM_INFO in that process. Each map entry has a lock
+         * count associated with it, satisfying the requirements of the
+         * Android API. This also prevents us from leaking maps/allocations.
+         *
+         * This table has entries inserted either by alloc()
+         * (alloc_device_t) or map() (gralloc_module_t). Entries are removed
+         * by free() (alloc_device_t) and unmap() (gralloc_module_t).
+         *
+         * As a special case for framebuffer_device_t, framebuffer_open()
+         * will add and framebuffer_close() will remove from this table.
+         */
+
+#define IMG_NATIVE_HANDLE_NUMFDS MAX_SUB_ALLOCS
+        /* The `fd' field is used to "export" a meminfo to another process.
+         * Therefore, it is allocated by alloc_device_t, and consumed by
+         * gralloc_module_t. The framebuffer_device_t does not need a handle,
+         * and the special value IMG_FRAMEBUFFER_FD is used instead.
+         */
+        int fd[MAX_SUB_ALLOCS];
+
+#define IMG_NATIVE_HANDLE_NUMINTS \
+        ((sizeof(unsigned long long) / sizeof(int)) + 5 + MAX_SUB_ALLOCS + 1 + MAX_SUB_ALLOCS + MAX_SUB_ALLOCS)
+        /* A KERNEL unique identifier for any exported kernel meminfo. Each
+         * exported kernel meminfo will have a unique stamp, but note that in
+         * userspace, several meminfos across multiple processes could have
+         * the same stamp. As the native_handle can be dup(2)'d, there could be
+         * multiple handles with the same stamp but different file descriptors.
+         */
+        unsigned long long ui64Stamp;
+
+        /* This is used for buffer usage validation when locking a buffer,
+         * and also in WSEGL (for the composition bypass feature).
+         */
+        int usage;
+
+        /* In order to do efficient cache flushes we need the buffer dimensions
+         * and format. These are available on the ANativeWindowBuffer,
+         * but the platform doesn't pass them down to the graphics HAL.
+         */
+        int iWidth;
+        int iHeight;
+        int iFormat;
+        unsigned int uiBpp;
+
+        /* The ion allocation path doesn't allow for the allocation size and
+         * mapping flags to be communicated cross-process automatically.
+         * Cache these here so we can map buffers in client processes.
+         */
+        unsigned int uiAllocSize[MAX_SUB_ALLOCS];
+        unsigned int uiFlags;
+        /* For multi-planar allocations, there will be multiple hstrides */
+        int aiStride[MAX_SUB_ALLOCS];
+
+        /* For multi-planar allocations, there will be multiple vstrides */
+        int aiVStride[MAX_SUB_ALLOCS];
+
+}
+__attribute__((aligned(sizeof(int)),packed)) IMG_native_handle_t;
+
+typedef struct
+{
+        int l, t, w, h;
+}
+IMG_write_lock_rect_t;
+
+typedef int (*IMG_buffer_format_compute_params_pfn)(
+        unsigned int uiPlane, int *piWidth, int *piHeight,
+        int *piStride, int *piVStride, unsigned long *pulPlaneOffset);
+
+typedef struct IMG_buffer_format_public_t
+{
+        /* Buffer formats are returned as a linked list */
+        struct IMG_buffer_format_public_t *psNext;
+
+        /* HAL_PIXEL_FORMAT_... enumerant */
+        int iHalPixelFormat;
+
+        /* WSEGL_PIXELFORMAT_... enumerant */
+        int iWSEGLPixelFormat;
+
+        /* Friendly name for format */
+        const char *const szName;
+
+        /* Bits (not bytes) per pixel */
+        unsigned int uiBpp;
+
+        /* Supported HW usage bits. If this is GRALLOC_USAGE_HW_MASK, all usages
+         * are supported. Used for HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED.
+         */
+        int iSupportedUsage;
+
+        /* YUV output format */
+        int bIsYUVFormat;
+
+        /* YCBCR_ORDERING_* defined the order of the Cb/Cr values */
+        int eYUVChromaOrder;
+
+        /* Utility function for adjusting YUV per-plane parameters */
+        IMG_buffer_format_compute_params_pfn pfnComputeParams;
+}
+IMG_buffer_format_public_t;
+
+typedef struct
+{
+        /* Base memtrack record, copied to caller */
+        struct memtrack_record  base;
+
+        /* Record type, for filtering cached records */
+        enum memtrack_type              eType;
+
+        /* Process ID, for filtering cached records */
+        pid_t                                   pid;
+}
+IMG_memtrack_record_public_t;
+
+typedef struct IMG_gralloc_module_public_t
+{
+        gralloc_module_t base;
+
+        /* This function is deprecated and might be NULL. Do not use it. */
+        int (*GetPhyAddrs)(gralloc_module_t const* module,
+                                           buffer_handle_t handle, void **ppvPhyAddr);
+
+        /* Obtain HAL's registered format list */
+        const IMG_buffer_format_public_t *(*GetBufferFormats)(void);
+
+        int (*GetImplementationFormat) (struct IMG_gralloc_module_public_t const *psGrallocModule, int usage);
+
+        int (*GetMemTrackRecords)(struct IMG_gralloc_module_public_t const *module,
+                                                          IMG_memtrack_record_public_t **ppsRecords,
+                                                          size_t *puNumRecords);
+
+        /* Custom-blit components in lieu of overlay hardware */
+        int (*Blit)(struct IMG_gralloc_module_public_t const *module,
+                                buffer_handle_t src,
+                                void *dest[MAX_SUB_ALLOCS], int format);
+
+        int (*Blit2)(struct IMG_gralloc_module_public_t const *module,
+                                 buffer_handle_t src, buffer_handle_t dest,
+                                 int w, int h, int x, int y);
+
+        int (*Blit3)(struct IMG_gralloc_module_public_t const *module,
+                                 unsigned long long ui64SrcStamp, int iSrcWidth,
+                                 int iSrcHeight, int iSrcFormat, int eSrcRotation,
+                                 buffer_handle_t dest, int eDestRotation);
+}
+IMG_gralloc_module_public_t;
+
+/**
+ * pixel format definitions
+ */
+
+enum {
+        /*
+         * 0x100 = 0x1FF
+         *
+         * This range is reserved for pixel formats that are specific to the HAL
+         * implementation. Implementations can use any value in this range to
+         * communicate video pixel formats between their HAL modules. These
+         * formats must not have an alpha channel. Additionally, an EGLimage
+         * created from a gralloc buffer of one of these formats must be
+         * supported for use with the GL_OES_EGL_image_external OpenGL ES
+         * extension.
+         */
+
+        /*
+         * These are vendor specific pixel format, by (informal) convention
+         * IMGTec formats start from the top of the range, TI formats start from
+         * the bottom
+         */
+        HAL_PIXEL_FORMAT_TI_NV12 = 0x100,
+        HAL_PIXEL_FORMAT_TI_UNUSED = 0x101,
+        HAL_PIXEL_FORMAT_TI_NV12_1D = 0x102,
+        HAL_PIXEL_FORMAT_TI_Y8 = 0x103,
+        HAL_PIXEL_FORMAT_TI_Y16 = 0x104,
+        HAL_PIXEL_FORMAT_TI_UYVY = 0x105,
+        HAL_PIXEL_FORMAT_BGRX_8888 = 0x1FF,
+
+        /* generic format missing from Android list, not specific to vendor
+         * implementation
+         */
+        HAL_PIXEL_FORMAT_NV12 = 0x3231564E, // FourCC for NV12
+};
+
+#endif /* HAL_PUBLIC_H */