/*
 * Copyright (c) 2015-2019, Texas Instruments Incorporated
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * *  Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *
 * *  Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * *  Neither the name of Texas Instruments Incorporated nor the names of
 *    its contributors may be used to endorse or promote products derived
 *    from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
 * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */
/** ============================================================================
 *  @file       CameraCC32XXDMA.h
 *
 *  @brief      Camera driver implementation for a CC32XX Camera controller
 *
 *  The Camera header file should be included in an application as follows:
 *  @code
 *  #include <ti/drivers/Camera.h>
 *  #include <ti/drivers/Camera/CameraCC32XXDMA.h>
 *  @endcode
 *
 *  Refer to @ref Camera.h for a complete description of APIs & example of use.
 *
 *  ============================================================================
 */

#ifndef ti_drivers_Camera_CameraCC32XXDMA__include
#define ti_drivers_Camera_CameraCC32XXDMA__include

#include <stdint.h>
#include <stdbool.h>
#include <ti/drivers/Camera.h>
#include <ti/drivers/dpl/HwiP.h>
#include <ti/drivers/dpl/SemaphoreP.h>

#ifdef __cplusplus
extern "C" {
#endif

/**
 *  @addtogroup Camera_STATUS
 *  CameraCC32XXDMA_STATUS_* macros are command codes only defined in the
 *  CameraCC32XXDMA.h driver implementation and need to:
 *  @code
 *  #include <ti/drivers/camera/CameraCC32XXDMA.h>
 *  @endcode
 *  @{
 */

/* Add CameraCC32XXDMA_STATUS_* macros here */

/** @}*/

/**
 *  @addtogroup Camera_CMD
 *  CameraCC32XXDMA_CMD_* macros are command codes only defined in the
 *  CameraCC32XXDMA.h driver implementation and need to:
 *  @code
 *  #include <ti/drivers/camera/CameraCC32XXDMA.h>
 *  @endcode
 *  @{
 */

/* Add CameraCC32XXDMA_CMD_* macros here */

/** @}*/

/* CC32XX camera DMA transfer size */
#define CameraCC32XXDMA_DMA_TRANSFER_SIZE  64

/* Camera function table pointer */
extern const Camera_FxnTable CameraCC32XXDMA_fxnTable;

/*!
 *  @brief      CameraCC32XXDMA Hardware attributes
 *
 *  These fields, with the exception of intPriority,
 *  are used by driverlib APIs and therefore must be populated by
 *  driverlib macro definitions. For CC32XXWare these definitions are found in:
 *      - inc/hw_memmap.h
 *      - inc/hw_ints.h
 *
 *  intPriority is the Camera peripheral's interrupt priority, as defined by the
 *  underlying OS.  It is passed unmodified to the underlying OS's interrupt
 *  handler creation code, so you need to refer to the OS documentation
 *  for usage.  If the driver uses the ti.dpl interface
 *  instead of making OS calls directly, then the HwiP port handles the
 *  interrupt priority in an OS specific way.  In the case of the SYS/BIOS
 *  port, intPriority is passed unmodified to Hwi_create().
 *
 *  A sample structure is shown below:
 *  @code
 *  const CameraCC32XXDMA_HWAttrs CameraCC32XXDMAHWAttrs[] = {
 *      {
 *          .baseAddr = CAMERA_BASE,
 *          .intNum = INT_CAMERA,
 *          .intPriority = (~0),
 *          .channelIndex = UDMA_CH22_CAMERA
 *      }
 *  };
 *  @endcode
 */
typedef struct {
    /*! Camera Peripheral's base address */
    uint32_t     baseAddr;
    /*! Camera Peripheral's interrupt vector */
    uint32_t    intNum;
    /*! Camera Peripheral's interrupt priority */
    uint32_t    intPriority;
    /*! uDMA controlTable channel index */
    unsigned long channelIndex;
} CameraCC32XXDMA_HWAttrs;

/*!
 *  @brief      CameraCC32XXDMA Object
 *
 *  The application must not access any member variables of this structure!
 */
typedef struct {
    /* Camera control variables */
    bool                opened;            /* Has the obj been opened */
    Camera_CaptureMode  operationMode;     /* Mode of operation of Camera */

    /* Camera capture variables */
    Camera_Callback     captureCallback;   /* Pointer to capture callback */
    uint32_t            captureTimeout;    /* Timeout for capture semaphore */
    void                *captureBuf;       /* Buffer data pointer */
    size_t              bufferlength;      /* Input Buffer length*/
    size_t              frameLength;       /* Captured frame length */

    bool                cameraDMA_PingPongMode; /* DMA ping pong mode */
    size_t              cameraDMAxIntrRcvd;     /* Number of DMA interrupts*/
    bool                inUse;                  /* Camera in Use */

    /* Camera OS objects */
    SemaphoreP_Handle   captureSem;
    HwiP_Handle         hwiHandle;
} CameraCC32XXDMA_Object, *CameraCC32XXDMA_Handle;

#ifdef __cplusplus
}
#endif

#endif /* ti_drivers_Camera_CameraCC32XXDMA__include */