root/drivers/staging/media/ipu3/ipu3-abi.h
/* SPDX-License-Identifier: GPL-2.0 */
/* Copyright (C) 2018 Intel Corporation */

#ifndef __IPU3_ABI_H
#define __IPU3_ABI_H

#include "include/uapi/intel-ipu3.h"

/******************* IMGU Hardware information *******************/

typedef u32 imgu_addr_t;

#define IMGU_ISP_VMEM_ALIGN                     128
#define IMGU_DVS_BLOCK_W                        64
#define IMGU_DVS_BLOCK_H                        32
#define IMGU_GDC_BUF_X                          (2 * IMGU_DVS_BLOCK_W)
#define IMGU_GDC_BUF_Y                          IMGU_DVS_BLOCK_H
/* n = 0..1 */
#define IMGU_SP_PMEM_BASE(n)                    (0x20000 + (n) * 0x4000)
#define IMGU_MAX_BQ_GRID_WIDTH                  80
#define IMGU_MAX_BQ_GRID_HEIGHT                 60
#define IMGU_OBGRID_TILE_SIZE                   16
#define IMGU_PIXELS_PER_WORD                    50
#define IMGU_BYTES_PER_WORD                     64
#define IMGU_STRIPE_FIXED_HALF_OVERLAP          2
#define IMGU_SHD_SETS                           3
#define IMGU_BDS_MIN_CLIP_VAL                   0
#define IMGU_BDS_MAX_CLIP_VAL                   2

#define IMGU_ABI_AWB_MAX_CELLS_PER_SET          160
#define IMGU_ABI_AF_MAX_CELLS_PER_SET           32
#define IMGU_ABI_AWB_FR_MAX_CELLS_PER_SET       32

#define IMGU_ABI_ACC_OP_IDLE                    0
#define IMGU_ABI_ACC_OP_END_OF_ACK              1
#define IMGU_ABI_ACC_OP_END_OF_OPS              2
#define IMGU_ABI_ACC_OP_NO_OPS                  3

#define IMGU_ABI_ACC_OPTYPE_PROCESS_LINES       0
#define IMGU_ABI_ACC_OPTYPE_TRANSFER_DATA       1

/* Register definitions */

/* PM_CTRL_0_5_0_IMGHMMADR */
#define IMGU_REG_PM_CTRL                        0x0
#define IMGU_PM_CTRL_START                      BIT(0)
#define IMGU_PM_CTRL_CFG_DONE                   BIT(1)
#define IMGU_PM_CTRL_RACE_TO_HALT               BIT(2)
#define IMGU_PM_CTRL_NACK_ALL                   BIT(3)
#define IMGU_PM_CTRL_CSS_PWRDN                  BIT(4)
#define IMGU_PM_CTRL_RST_AT_EOF                 BIT(5)
#define IMGU_PM_CTRL_FORCE_HALT                 BIT(6)
#define IMGU_PM_CTRL_FORCE_UNHALT               BIT(7)
#define IMGU_PM_CTRL_FORCE_PWRDN                BIT(8)
#define IMGU_PM_CTRL_FORCE_RESET                BIT(9)

/* SYSTEM_REQ_0_5_0_IMGHMMADR */
#define IMGU_REG_SYSTEM_REQ                     0x18
#define IMGU_SYSTEM_REQ_FREQ_MASK               0x3f
#define IMGU_SYSTEM_REQ_FREQ_DIVIDER            25
#define IMGU_REG_INT_STATUS                     0x30
#define IMGU_REG_INT_ENABLE                     0x34
#define IMGU_REG_INT_CSS_IRQ                    BIT(31)
/* STATE_0_5_0_IMGHMMADR */
#define IMGU_REG_STATE                          0x130
#define IMGU_STATE_HALT_STS                     BIT(0)
#define IMGU_STATE_IDLE_STS                     BIT(1)
#define IMGU_STATE_POWER_UP                     BIT(2)
#define IMGU_STATE_POWER_DOWN                   BIT(3)
#define IMGU_STATE_CSS_BUSY_MASK                0xc0
#define IMGU_STATE_PM_FSM_MASK                  0x180
#define IMGU_STATE_PWRDNM_FSM_MASK              0x1E00000
/* PM_STS_0_5_0_IMGHMMADR */
#define IMGU_REG_PM_STS                         0x140

#define IMGU_REG_BASE                           0x4000

#define IMGU_REG_ISP_CTRL                       (IMGU_REG_BASE + 0x00)
#define IMGU_CTRL_RST                           BIT(0)
#define IMGU_CTRL_START                         BIT(1)
#define IMGU_CTRL_BREAK                         BIT(2)
#define IMGU_CTRL_RUN                           BIT(3)
#define IMGU_CTRL_BROKEN                        BIT(4)
#define IMGU_CTRL_IDLE                          BIT(5)
#define IMGU_CTRL_SLEEPING                      BIT(6)
#define IMGU_CTRL_STALLING                      BIT(7)
#define IMGU_CTRL_IRQ_CLEAR                     BIT(8)
#define IMGU_CTRL_IRQ_READY                     BIT(10)
#define IMGU_CTRL_IRQ_SLEEPING                  BIT(11)
#define IMGU_CTRL_ICACHE_INV                    BIT(12)
#define IMGU_CTRL_IPREFETCH_EN                  BIT(13)
#define IMGU_REG_ISP_START_ADDR                 (IMGU_REG_BASE + 0x04)
#define IMGU_REG_ISP_ICACHE_ADDR                (IMGU_REG_BASE + 0x10)
#define IMGU_REG_ISP_PC                         (IMGU_REG_BASE + 0x1c)

/* SP Registers, sp = 0:SP0; 1:SP1 */
#define IMGU_REG_SP_CTRL(sp)            (IMGU_REG_BASE + (sp) * 0x100 + 0x100)
        /* For bits in IMGU_REG_SP_CTRL, see IMGU_CTRL_* */
#define IMGU_REG_SP_START_ADDR(sp)      (IMGU_REG_BASE + (sp) * 0x100 + 0x104)
#define IMGU_REG_SP_ICACHE_ADDR(sp)     (IMGU_REG_BASE + (sp) * 0x100 + 0x11c)
#define IMGU_REG_SP_CTRL_SINK(sp)       (IMGU_REG_BASE + (sp) * 0x100 + 0x130)
#define IMGU_REG_SP_PC(sp)              (IMGU_REG_BASE + (sp) * 0x100 + 0x134)

#define IMGU_REG_TLB_INVALIDATE         (IMGU_REG_BASE + 0x300)
#define IMGU_TLB_INVALIDATE                     1
#define IMGU_REG_L1_PHYS                (IMGU_REG_BASE + 0x304) /* 27-bit pfn */

#define IMGU_REG_CIO_GATE_BURST_STATE   (IMGU_REG_BASE + 0x404)
#define IMGU_CIO_GATE_BURST_MASK        0x80

#define IMGU_REG_GP_BUSY                (IMGU_REG_BASE + 0x500)
#define IMGU_REG_GP_STARVING            (IMGU_REG_BASE + 0x504)
#define IMGU_REG_GP_WORKLOAD            (IMGU_REG_BASE + 0x508)
#define IMGU_REG_GP_IRQ(n)      (IMGU_REG_BASE + (n) * 4 + 0x50c) /* n = 0..4 */
#define IMGU_REG_GP_SP1_STRMON_STAT     (IMGU_REG_BASE + 0x520)
#define IMGU_REG_GP_SP2_STRMON_STAT     (IMGU_REG_BASE + 0x524)
#define IMGU_REG_GP_ISP_STRMON_STAT     (IMGU_REG_BASE + 0x528)
#define IMGU_REG_GP_MOD_STRMON_STAT     (IMGU_REG_BASE + 0x52c)

/* Port definitions for the streaming monitors. */
/* For each definition there is signal pair : valid [bit 0]- accept [bit 1] */
#define IMGU_GP_STRMON_STAT_SP1_PORT_SP12DMA            BIT(0)
#define IMGU_GP_STRMON_STAT_SP1_PORT_DMA2SP1            BIT(2)
#define IMGU_GP_STRMON_STAT_SP1_PORT_SP12SP2            BIT(4)
#define IMGU_GP_STRMON_STAT_SP1_PORT_SP22SP1            BIT(6)
#define IMGU_GP_STRMON_STAT_SP1_PORT_SP12ISP            BIT(8)
#define IMGU_GP_STRMON_STAT_SP1_PORT_ISP2SP1            BIT(10)

#define IMGU_GP_STRMON_STAT_SP2_PORT_SP22DMA            BIT(0)
#define IMGU_GP_STRMON_STAT_SP2_PORT_DMA2SP2            BIT(2)
#define IMGU_GP_STRMON_STAT_SP2_PORT_SP22SP1            BIT(4)
#define IMGU_GP_STRMON_STAT_SP2_PORT_SP12SP2            BIT(6)

#define IMGU_GP_STRMON_STAT_ISP_PORT_ISP2DMA            BIT(0)
#define IMGU_GP_STRMON_STAT_ISP_PORT_DMA2ISP            BIT(2)
#define IMGU_GP_STRMON_STAT_ISP_PORT_ISP2SP1            BIT(4)
#define IMGU_GP_STRMON_STAT_ISP_PORT_SP12ISP            BIT(6)

/* Between the devices and the fifo */
#define IMGU_GP_STRMON_STAT_MOD_PORT_SP12DMA            BIT(0)
#define IMGU_GP_STRMON_STAT_MOD_PORT_DMA2SP1            BIT(2)
#define IMGU_GP_STRMON_STAT_MOD_PORT_SP22DMA            BIT(4)
#define IMGU_GP_STRMON_STAT_MOD_PORT_DMA2SP2            BIT(6)
#define IMGU_GP_STRMON_STAT_MOD_PORT_ISP2DMA            BIT(8)
#define IMGU_GP_STRMON_STAT_MOD_PORT_DMA2ISP            BIT(10)
#define IMGU_GP_STRMON_STAT_MOD_PORT_CELLS2GDC          BIT(12)
#define IMGU_GP_STRMON_STAT_MOD_PORT_GDC2CELLS          BIT(14)
#define IMGU_GP_STRMON_STAT_MOD_PORT_CELLS2DECOMP       BIT(16)
#define IMGU_GP_STRMON_STAT_MOD_PORT_DECOMP2CELLS       BIT(18)
/* n = 1..6 */
#define IMGU_GP_STRMON_STAT_MOD_PORT_S2V(n)     (1 << (((n) - 1) * 2 + 20))

/* n = 1..15 */
#define IMGU_GP_STRMON_STAT_ACCS_PORT_ACC(n)            (1 << (((n) - 1) * 2))

/* After FIFO and demux before SP1, n = 1..15 */
#define IMGU_GP_STRMON_STAT_ACCS2SP1_MON_PORT_ACC(n)    (1 << (((n) - 1) * 2))

/* After FIFO and demux before SP2, n = 1..15 */
#define IMGU_GP_STRMON_STAT_ACCS2SP2_MON_PORT_ACC(n)    (1 << (((n) - 1) * 2))

#define IMGU_REG_GP_HALT                                (IMGU_REG_BASE + 0x5dc)

                                        /* n = 0..2 (main ctrl, SP0, SP1) */
#define IMGU_REG_IRQCTRL_BASE(n)        (IMGU_REG_BASE + (n) * 0x100 + 0x700)
#define IMGU_IRQCTRL_MAIN                       0
#define IMGU_IRQCTRL_SP0                        1
#define IMGU_IRQCTRL_SP1                        2
#define IMGU_IRQCTRL_NUM                        3
#define IMGU_IRQCTRL_IRQ_SP1                    BIT(0)
#define IMGU_IRQCTRL_IRQ_SP2                    BIT(1)
#define IMGU_IRQCTRL_IRQ_ISP                    BIT(2)
#define IMGU_IRQCTRL_IRQ_SP1_STREAM_MON         BIT(3)
#define IMGU_IRQCTRL_IRQ_SP2_STREAM_MON         BIT(4)
#define IMGU_IRQCTRL_IRQ_ISP_STREAM_MON         BIT(5)
#define IMGU_IRQCTRL_IRQ_MOD_STREAM_MON         BIT(6)
#define IMGU_IRQCTRL_IRQ_MOD_ISP_STREAM_MON     BIT(7)
#define IMGU_IRQCTRL_IRQ_ACCS_STREAM_MON        BIT(8)
#define IMGU_IRQCTRL_IRQ_ACCS_SP1_STREAM_MON    BIT(9)
#define IMGU_IRQCTRL_IRQ_ACCS_SP2_STREAM_MON    BIT(10)
#define IMGU_IRQCTRL_IRQ_ISP_PMEM_ERROR         BIT(11)
#define IMGU_IRQCTRL_IRQ_ISP_BAMEM_ERROR        BIT(12)
#define IMGU_IRQCTRL_IRQ_ISP_VMEM_ERROR         BIT(13)
#define IMGU_IRQCTRL_IRQ_ISP_DMEM_ERROR         BIT(14)
#define IMGU_IRQCTRL_IRQ_SP1_ICACHE_MEM_ERROR   BIT(15)
#define IMGU_IRQCTRL_IRQ_SP1_DMEM_ERROR         BIT(16)
#define IMGU_IRQCTRL_IRQ_SP2_ICACHE_MEM_ERROR   BIT(17)
#define IMGU_IRQCTRL_IRQ_SP2_DMEM_ERROR         BIT(18)
#define IMGU_IRQCTRL_IRQ_ACCS_SCRATCH_MEM_ERROR BIT(19)
#define IMGU_IRQCTRL_IRQ_GP_TIMER(n)            BIT(20 + (n)) /* n=0..1 */
#define IMGU_IRQCTRL_IRQ_DMA                    BIT(22)
#define IMGU_IRQCTRL_IRQ_SW_PIN(n)              BIT(23 + (n)) /* n=0..4 */
#define IMGU_IRQCTRL_IRQ_ACC_SYS                BIT(28)
#define IMGU_IRQCTRL_IRQ_OUT_FORM_IRQ_CTRL      BIT(29)
#define IMGU_IRQCTRL_IRQ_SP1_IRQ_CTRL           BIT(30)
#define IMGU_IRQCTRL_IRQ_SP2_IRQ_CTRL           BIT(31)
#define IMGU_REG_IRQCTRL_EDGE(n)        (IMGU_REG_IRQCTRL_BASE(n) + 0x00)
#define IMGU_REG_IRQCTRL_MASK(n)        (IMGU_REG_IRQCTRL_BASE(n) + 0x04)
#define IMGU_REG_IRQCTRL_STATUS(n)      (IMGU_REG_IRQCTRL_BASE(n) + 0x08)
#define IMGU_REG_IRQCTRL_CLEAR(n)       (IMGU_REG_IRQCTRL_BASE(n) + 0x0c)
#define IMGU_REG_IRQCTRL_ENABLE(n)      (IMGU_REG_IRQCTRL_BASE(n) + 0x10)
#define IMGU_REG_IRQCTRL_EDGE_NOT_PULSE(n) (IMGU_REG_IRQCTRL_BASE(n) + 0x14)
#define IMGU_REG_IRQCTRL_STR_OUT_ENABLE(n) (IMGU_REG_IRQCTRL_BASE(n) + 0x18)

#define IMGU_REG_GP_TIMER               (IMGU_REG_BASE + 0xa34)

#define IMGU_REG_SP_DMEM_BASE(n)        (IMGU_REG_BASE + (n) * 0x4000 + 0x4000)
#define IMGU_REG_ISP_DMEM_BASE          (IMGU_REG_BASE + 0xc000)

#define IMGU_REG_GDC_BASE               (IMGU_REG_BASE + 0x18000)
#define IMGU_REG_GDC_LUT_BASE           (IMGU_REG_GDC_BASE + 0x140)
#define IMGU_GDC_LUT_MASK               ((1 << 12) - 1) /* Range -1024..+1024 */

#define IMGU_SCALER_PHASES                      32
#define IMGU_SCALER_COEFF_BITS                  24
#define IMGU_SCALER_PHASE_COUNTER_PREC_REF      6
#define IMGU_SCALER_MAX_EXPONENT_SHIFT          3
#define IMGU_SCALER_FILTER_TAPS                 4
#define IMGU_SCALER_TAPS_Y                      IMGU_SCALER_FILTER_TAPS
#define IMGU_SCALER_TAPS_UV                     (IMGU_SCALER_FILTER_TAPS / 2)
#define IMGU_SCALER_FIR_PHASES \
                (IMGU_SCALER_PHASES << IMGU_SCALER_PHASE_COUNTER_PREC_REF)

/******************* imgu_abi_acc_param *******************/

#define IMGU_ABI_SHD_MAX_PROCESS_LINES          31
#define IMGU_ABI_SHD_MAX_TRANSFERS              31
#define IMGU_ABI_SHD_MAX_OPERATIONS \
                (IMGU_ABI_SHD_MAX_PROCESS_LINES + IMGU_ABI_SHD_MAX_TRANSFERS)
#define IMGU_ABI_SHD_MAX_CELLS_PER_SET          146
/* largest grid is 73x56 */
#define IMGU_ABI_SHD_MAX_CFG_SETS               (2 * 28)

#define IMGU_ABI_DVS_STAT_MAX_OPERATIONS        100
#define IMGU_ABI_DVS_STAT_MAX_PROCESS_LINES     52
#define IMGU_ABI_DVS_STAT_MAX_TRANSFERS         52

#define IMGU_ABI_BDS_SAMPLE_PATTERN_ARRAY_SIZE  8
#define IMGU_ABI_BDS_PHASE_COEFFS_ARRAY_SIZE    32

#define IMGU_ABI_AWB_FR_MAX_TRANSFERS           30
#define IMGU_ABI_AWB_FR_MAX_PROCESS_LINES       30
#define IMGU_ABI_AWB_FR_MAX_OPERATIONS \
        (IMGU_ABI_AWB_FR_MAX_TRANSFERS + IMGU_ABI_AWB_FR_MAX_PROCESS_LINES)

#define IMGU_ABI_AF_MAX_TRANSFERS               30
#define IMGU_ABI_AF_MAX_PROCESS_LINES           30
#define IMGU_ABI_AF_MAX_OPERATIONS \
                (IMGU_ABI_AF_MAX_TRANSFERS + IMGU_ABI_AF_MAX_PROCESS_LINES)

#define IMGU_ABI_AWB_MAX_PROCESS_LINES          68
#define IMGU_ABI_AWB_MAX_TRANSFERS              68
#define IMGU_ABI_AWB_MAX_OPERATIONS \
                (IMGU_ABI_AWB_MAX_PROCESS_LINES + IMGU_ABI_AWB_MAX_TRANSFERS)

#define IMGU_ABI_OSYS_PIN_VF                    0
#define IMGU_ABI_OSYS_PIN_OUT                   1
#define IMGU_ABI_OSYS_PINS                      2

#define IMGU_ABI_DVS_STAT_LEVELS                3
#define IMGU_ABI_YUVP2_YTM_LUT_ENTRIES          256
#define IMGU_ABI_GDC_FRAC_BITS                  8
#define IMGU_ABI_BINARY_MAX_OUTPUT_PORTS        2
#define IMGU_ABI_MAX_BINARY_NAME                64
#define IMGU_ABI_ISP_DDR_WORD_BITS              256
#define IMGU_ABI_ISP_DDR_WORD_BYTES     (IMGU_ABI_ISP_DDR_WORD_BITS / 8)
#define IMGU_ABI_MAX_STAGES                     3
#define IMGU_ABI_MAX_IF_CONFIGS                 3
#define IMGU_ABI_PIPE_CONFIG_ACQUIRE_ISP        BIT(31)
#define IMGU_ABI_PORT_CONFIG_TYPE_INPUT_HOST    BIT(0)
#define IMGU_ABI_PORT_CONFIG_TYPE_OUTPUT_HOST   BIT(4)
#define IMGU_ABI_MAX_SP_THREADS                 4
#define IMGU_ABI_FRAMES_REF                     3
#define IMGU_ABI_FRAMES_TNR                     4
#define IMGU_ABI_BUF_SETS_TNR                   1

#define IMGU_ABI_EVENT_BUFFER_ENQUEUED(thread, queue)   \
                                (0 << 24 | (thread) << 16 | (queue) << 8)
#define IMGU_ABI_EVENT_BUFFER_DEQUEUED(queue)   (1 << 24 | (queue) << 8)
#define IMGU_ABI_EVENT_EVENT_DEQUEUED           (2 << 24)
#define IMGU_ABI_EVENT_START_STREAM             (3 << 24)
#define IMGU_ABI_EVENT_STOP_STREAM              (4 << 24)
#define IMGU_ABI_EVENT_MIPI_BUFFERS_READY       (5 << 24)
#define IMGU_ABI_EVENT_UNLOCK_RAW_BUFFER        (6 << 24)
#define IMGU_ABI_EVENT_STAGE_ENABLE_DISABLE     (7 << 24)

#define IMGU_ABI_HOST2SP_BUFQ_SIZE      3
#define IMGU_ABI_SP2HOST_BUFQ_SIZE      (2 * IMGU_ABI_MAX_SP_THREADS)
#define IMGU_ABI_HOST2SP_EVTQ_SIZE      (IMGU_ABI_QUEUE_NUM * \
                IMGU_ABI_MAX_SP_THREADS * 2 + IMGU_ABI_MAX_SP_THREADS * 4)
#define IMGU_ABI_SP2HOST_EVTQ_SIZE      (6 * IMGU_ABI_MAX_SP_THREADS)

#define IMGU_ABI_EVTTYPE_EVENT_SHIFT    0
#define IMGU_ABI_EVTTYPE_EVENT_MASK     (0xff << IMGU_ABI_EVTTYPE_EVENT_SHIFT)
#define IMGU_ABI_EVTTYPE_PIPE_SHIFT     8
#define IMGU_ABI_EVTTYPE_PIPE_MASK      (0xff << IMGU_ABI_EVTTYPE_PIPE_SHIFT)
#define IMGU_ABI_EVTTYPE_PIPEID_SHIFT   16
#define IMGU_ABI_EVTTYPE_PIPEID_MASK    (0xff << IMGU_ABI_EVTTYPE_PIPEID_SHIFT)
#define IMGU_ABI_EVTTYPE_MODULEID_SHIFT 8
#define IMGU_ABI_EVTTYPE_MODULEID_MASK (0xff << IMGU_ABI_EVTTYPE_MODULEID_SHIFT)
#define IMGU_ABI_EVTTYPE_LINENO_SHIFT   16
#define IMGU_ABI_EVTTYPE_LINENO_MASK   (0xffff << IMGU_ABI_EVTTYPE_LINENO_SHIFT)

/* Output frame ready */
#define IMGU_ABI_EVTTYPE_OUT_FRAME_DONE                 0
/* Second output frame ready */
#define IMGU_ABI_EVTTYPE_2ND_OUT_FRAME_DONE             1
/* Viewfinder Output frame ready */
#define IMGU_ABI_EVTTYPE_VF_OUT_FRAME_DONE              2
/* Second viewfinder Output frame ready */
#define IMGU_ABI_EVTTYPE_2ND_VF_OUT_FRAME_DONE          3
/* Indication that 3A statistics are available */
#define IMGU_ABI_EVTTYPE_3A_STATS_DONE                  4
/* Indication that DIS statistics are available */
#define IMGU_ABI_EVTTYPE_DIS_STATS_DONE                 5
/* Pipeline Done event, sent after last pipeline stage */
#define IMGU_ABI_EVTTYPE_PIPELINE_DONE                  6
/* Frame tagged */
#define IMGU_ABI_EVTTYPE_FRAME_TAGGED                   7
/* Input frame ready */
#define IMGU_ABI_EVTTYPE_INPUT_FRAME_DONE               8
/* Metadata ready */
#define IMGU_ABI_EVTTYPE_METADATA_DONE                  9
/* Indication that LACE statistics are available */
#define IMGU_ABI_EVTTYPE_LACE_STATS_DONE                10
/* Extension stage executed */
#define IMGU_ABI_EVTTYPE_ACC_STAGE_COMPLETE             11
/* Timing measurement data */
#define IMGU_ABI_EVTTYPE_TIMER                          12
/* End Of Frame event, sent when in buffered sensor mode */
#define IMGU_ABI_EVTTYPE_PORT_EOF                       13
/* Performance warning encountered by FW */
#define IMGU_ABI_EVTTYPE_FW_WARNING                     14
/* Assertion hit by FW */
#define IMGU_ABI_EVTTYPE_FW_ASSERT                      15

#define IMGU_ABI_NUM_CONTINUOUS_FRAMES          10
#define IMGU_ABI_SP_COMM_COMMAND                0x00

/*
 * The host2sp_cmd_ready command is the only command written by the SP
 * It acknowledges that is previous command has been received.
 * (this does not mean that the command has been executed)
 * It also indicates that a new command can be send (it is a queue
 * with depth 1).
 */
#define IMGU_ABI_SP_COMM_COMMAND_READY          1
/* Command written by the Host */
#define IMGU_ABI_SP_COMM_COMMAND_DUMMY          2       /* No action */
#define IMGU_ABI_SP_COMM_COMMAND_START_FLASH    3       /* Start the flash */
#define IMGU_ABI_SP_COMM_COMMAND_TERMINATE      4       /* Terminate */

/* n = 0..IPU3_CSS_PIPE_ID_NUM-1 */
#define IMGU_ABI_SP_COMM_EVENT_IRQ_MASK(n)              ((n) * 4 + 0x60)
#define IMGU_ABI_SP_COMM_EVENT_IRQ_MASK_OR_SHIFT        0
#define IMGU_ABI_SP_COMM_EVENT_IRQ_MASK_AND_SHIFT       16

#define IMGU_ABI_BL_DMACMD_TYPE_SP_PMEM         1       /* sp_pmem */

/***** For parameter computation *****/

#define IMGU_HIVE_OF_SYS_SCALER_TO_FA_OFFSET    0xC
#define IMGU_HIVE_OF_SYS_OF_TO_FA_OFFSET        0x8
#define IMGU_HIVE_OF_SYS_OF_SYSTEM_NWAYS        32

#define IMGU_SCALER_ELEMS_PER_VEC               0x10
#define IMGU_SCALER_FILTER_TAPS_Y               0x4
#define IMGU_SCALER_OUT_BPP                     0x8

#define IMGU_SCALER_MS_TO_OUTFORMACC_SL_ADDR    0x400
#define IMGU_SCALER_TO_OF_ACK_FA_ADDR \
        (0xC00  + IMGU_HIVE_OF_SYS_SCALER_TO_FA_OFFSET)
#define IMGU_OF_TO_ACK_FA_ADDR (0xC00 + IMGU_HIVE_OF_SYS_OF_TO_FA_OFFSET)
#define IMGU_OUTFORMACC_MS_TO_SCALER_SL_ADDR 0
#define IMGU_SCALER_INTR_BPP                    10

#define IMGU_PS_SNR_PRESERVE_BITS               3
#define IMGU_CNTX_BPP                           11
#define IMGU_SCALER_FILTER_TAPS_UV      (IMGU_SCALER_FILTER_TAPS_Y / 2)

#define IMGU_VMEM2_ELEMS_PER_VEC        (IMGU_SCALER_ELEMS_PER_VEC)
#define IMGU_STRIDE_Y                   (IMGU_SCALER_FILTER_TAPS_Y + 1)
#define IMGU_MAX_FRAME_WIDTH            3840
#define IMGU_VMEM3_ELEMS_PER_VEC        (IMGU_SCALER_ELEMS_PER_VEC)

#define IMGU_VER_CNTX_WORDS             DIV_ROUND_UP((IMGU_SCALER_OUT_BPP + \
        IMGU_PS_SNR_PRESERVE_BITS), IMGU_CNTX_BPP)      /* 1 */
#define IMGU_MAX_INPUT_BLOCK_HEIGHT     64
#define IMGU_HOR_CNTX_WORDS             DIV_ROUND_UP((IMGU_SCALER_INTR_BPP + \
        IMGU_PS_SNR_PRESERVE_BITS), IMGU_CNTX_BPP)      /* 2 */
#define IMGU_MAX_OUTPUT_BLOCK_WIDTH             128
#define IMGU_CNTX_STRIDE_UV             (IMGU_SCALER_FILTER_TAPS_UV + 1)

#define IMGU_OSYS_DMA_CROP_W_LIMIT              64
#define IMGU_OSYS_DMA_CROP_H_LIMIT              4
#define IMGU_OSYS_BLOCK_WIDTH                   (2 * IPU3_UAPI_ISP_VEC_ELEMS)
#define IMGU_OSYS_BLOCK_HEIGHT                  32
#define IMGU_OSYS_PHASES                        0x20
#define IMGU_OSYS_FILTER_TAPS                   0x4
#define IMGU_OSYS_PHASE_COUNTER_PREC_REF        6
#define IMGU_OSYS_NUM_INPUT_BUFFERS             2
#define IMGU_OSYS_FIR_PHASES \
        (IMGU_OSYS_PHASES << IMGU_OSYS_PHASE_COUNTER_PREC_REF)
#define IMGU_OSYS_TAPS_UV                       (IMGU_OSYS_FILTER_TAPS / 2)
#define IMGU_OSYS_TAPS_Y                        (IMGU_OSYS_FILTER_TAPS)
#define IMGU_OSYS_NUM_INTERM_BUFFERS            2

#define IMGU_VMEM1_Y_SIZE \
        (IMGU_OSYS_BLOCK_HEIGHT * IMGU_VMEM1_Y_STRIDE)
#define IMGU_VMEM1_UV_SIZE                      (IMGU_VMEM1_Y_SIZE / 4)
#define IMGU_VMEM1_OUT_BUF_ADDR                 (IMGU_VMEM1_INP_BUF_ADDR + \
        (IMGU_OSYS_NUM_INPUT_BUFFERS * IMGU_VMEM1_BUF_SIZE))
#define IMGU_OSYS_NUM_OUTPUT_BUFFERS            2

/* transpose of input height */
#define IMGU_VMEM2_VECS_PER_LINE \
        (DIV_ROUND_UP(IMGU_OSYS_BLOCK_HEIGHT, IMGU_VMEM2_ELEMS_PER_VEC))
/* size in words (vectors)  */
#define IMGU_VMEM2_BUF_SIZE \
        (IMGU_VMEM2_VECS_PER_LINE * IMGU_VMEM2_LINES_PER_BLOCK)
#define IMGU_VMEM3_VER_Y_SIZE   \
                        ((IMGU_STRIDE_Y * IMGU_MAX_FRAME_WIDTH \
                         / IMGU_VMEM3_ELEMS_PER_VEC) * IMGU_VER_CNTX_WORDS)
#define IMGU_VMEM3_HOR_Y_SIZE \
        ((IMGU_STRIDE_Y * IMGU_MAX_INPUT_BLOCK_HEIGHT \
         / IMGU_VMEM3_ELEMS_PER_VEC) * IMGU_HOR_CNTX_WORDS)
#define IMGU_VMEM3_VER_Y_EXTRA \
        ((IMGU_STRIDE_Y * IMGU_MAX_OUTPUT_BLOCK_WIDTH \
         / IMGU_VMEM3_ELEMS_PER_VEC) * IMGU_VER_CNTX_WORDS)
#define IMGU_VMEM3_VER_U_SIZE \
        (((IMGU_CNTX_STRIDE_UV * IMGU_MAX_FRAME_WIDTH \
         / IMGU_VMEM3_ELEMS_PER_VEC) * IMGU_VER_CNTX_WORDS) / 2)
#define IMGU_VMEM3_HOR_U_SIZE \
        (((IMGU_STRIDE_Y * IMGU_MAX_INPUT_BLOCK_HEIGHT \
         / IMGU_VMEM3_ELEMS_PER_VEC) * IMGU_HOR_CNTX_WORDS) / 2)
#define IMGU_VMEM3_VER_U_EXTRA \
        (((IMGU_CNTX_STRIDE_UV * IMGU_MAX_OUTPUT_BLOCK_WIDTH \
         / IMGU_VMEM3_ELEMS_PER_VEC) * IMGU_VER_CNTX_WORDS) / 2)
#define IMGU_VMEM3_VER_V_SIZE \
        (((IMGU_CNTX_STRIDE_UV * IMGU_MAX_FRAME_WIDTH \
         / IMGU_VMEM3_ELEMS_PER_VEC) * IMGU_VER_CNTX_WORDS) / 2)

#define IMGU_ISP_VEC_NELEMS             64
#define IMGU_LUMA_TO_CHROMA_RATIO       2
#define IMGU_INPUT_BLOCK_WIDTH                  (128)
#define IMGU_FIFO_ADDR_SCALER_TO_FMT \
        (IMGU_SCALER_MS_TO_OUTFORMACC_SL_ADDR >> 2)
#define IMGU_FIFO_ADDR_SCALER_TO_SP     (IMGU_SCALER_TO_OF_ACK_FA_ADDR >> 2)
#define IMGU_VMEM1_INP_BUF_ADDR         0
#define IMGU_VMEM1_Y_STRIDE \
        (IMGU_OSYS_BLOCK_WIDTH / IMGU_VMEM1_ELEMS_PER_VEC)
#define IMGU_VMEM1_BUF_SIZE     (IMGU_VMEM1_V_OFFSET + IMGU_VMEM1_UV_SIZE)

#define IMGU_VMEM1_U_OFFSET             (IMGU_VMEM1_Y_SIZE)
#define IMGU_VMEM1_V_OFFSET     (IMGU_VMEM1_U_OFFSET + IMGU_VMEM1_UV_SIZE)
#define IMGU_VMEM1_UV_STRIDE            (IMGU_VMEM1_Y_STRIDE / 2)
#define IMGU_VMEM1_INT_BUF_ADDR         (IMGU_VMEM1_OUT_BUF_ADDR + \
        (IMGU_OSYS_NUM_OUTPUT_BUFFERS * IMGU_VMEM1_BUF_SIZE))

#define IMGU_VMEM1_ELEMS_PER_VEC        (IMGU_HIVE_OF_SYS_OF_SYSTEM_NWAYS)
#define IMGU_VMEM2_BUF_Y_ADDR           0
#define IMGU_VMEM2_BUF_Y_STRIDE         (IMGU_VMEM2_VECS_PER_LINE)
#define IMGU_VMEM2_BUF_U_ADDR \
        (IMGU_VMEM2_BUF_Y_ADDR + IMGU_VMEM2_BUF_SIZE)
#define IMGU_VMEM2_BUF_V_ADDR \
        (IMGU_VMEM2_BUF_U_ADDR + IMGU_VMEM2_BUF_SIZE / 4)
#define IMGU_VMEM2_BUF_UV_STRIDE        (IMGU_VMEM2_VECS_PER_LINE / 2)
/* 1.5 x depth of intermediate buffer */
#define IMGU_VMEM2_LINES_PER_BLOCK      192
#define IMGU_VMEM3_HOR_Y_ADDR \
        (IMGU_VMEM3_VER_Y_ADDR + IMGU_VMEM3_VER_Y_SIZE)
#define IMGU_VMEM3_HOR_U_ADDR \
        (IMGU_VMEM3_VER_U_ADDR + IMGU_VMEM3_VER_U_SIZE)
#define IMGU_VMEM3_HOR_V_ADDR \
        (IMGU_VMEM3_VER_V_ADDR + IMGU_VMEM3_VER_V_SIZE)
#define IMGU_VMEM3_VER_Y_ADDR           0
#define IMGU_VMEM3_VER_U_ADDR \
        (IMGU_VMEM3_VER_Y_ADDR + IMGU_VMEM3_VER_Y_SIZE + \
        max(IMGU_VMEM3_HOR_Y_SIZE, IMGU_VMEM3_VER_Y_EXTRA))
#define IMGU_VMEM3_VER_V_ADDR \
        (IMGU_VMEM3_VER_U_ADDR + IMGU_VMEM3_VER_U_SIZE + \
        max(IMGU_VMEM3_HOR_U_SIZE, IMGU_VMEM3_VER_U_EXTRA))
#define IMGU_FIFO_ADDR_FMT_TO_SP        (IMGU_OF_TO_ACK_FA_ADDR >> 2)
#define IMGU_FIFO_ADDR_FMT_TO_SCALER (IMGU_OUTFORMACC_MS_TO_SCALER_SL_ADDR >> 2)
#define IMGU_VMEM1_HST_BUF_ADDR         (IMGU_VMEM1_INT_BUF_ADDR + \
        (IMGU_OSYS_NUM_INTERM_BUFFERS * IMGU_VMEM1_BUF_SIZE))
#define IMGU_VMEM1_HST_BUF_STRIDE       120
#define IMGU_VMEM1_HST_BUF_NLINES       3

enum imgu_abi_frame_format {
        IMGU_ABI_FRAME_FORMAT_NV11,     /* 12 bit YUV 411, Y, UV plane */
        IMGU_ABI_FRAME_FORMAT_NV12,     /* 12 bit YUV 420, Y, UV plane */
        IMGU_ABI_FRAME_FORMAT_NV12_16,  /* 16 bit YUV 420, Y, UV plane */
        IMGU_ABI_FRAME_FORMAT_NV12_TILEY,/* 12 bit YUV 420,Intel tiled format */
        IMGU_ABI_FRAME_FORMAT_NV16,     /* 16 bit YUV 422, Y, UV plane */
        IMGU_ABI_FRAME_FORMAT_NV21,     /* 12 bit YUV 420, Y, VU plane */
        IMGU_ABI_FRAME_FORMAT_NV61,     /* 16 bit YUV 422, Y, VU plane */
        IMGU_ABI_FRAME_FORMAT_YV12,     /* 12 bit YUV 420, Y, V, U plane */
        IMGU_ABI_FRAME_FORMAT_YV16,     /* 16 bit YUV 422, Y, V, U plane */
        IMGU_ABI_FRAME_FORMAT_YUV420,   /* 12 bit YUV 420, Y, U, V plane */
        IMGU_ABI_FRAME_FORMAT_YUV420_16,/* yuv420, 16 bits per subpixel */
        IMGU_ABI_FRAME_FORMAT_YUV422,   /* 16 bit YUV 422, Y, U, V plane */
        IMGU_ABI_FRAME_FORMAT_YUV422_16,/* yuv422, 16 bits per subpixel */
        IMGU_ABI_FRAME_FORMAT_UYVY,     /* 16 bit YUV 422, UYVY interleaved */
        IMGU_ABI_FRAME_FORMAT_YUYV,     /* 16 bit YUV 422, YUYV interleaved */
        IMGU_ABI_FRAME_FORMAT_YUV444,   /* 24 bit YUV 444, Y, U, V plane */
        IMGU_ABI_FRAME_FORMAT_YUV_LINE, /* Internal format, 2 y lines */
                                        /* followed by a uv-interleaved line */
        IMGU_ABI_FRAME_FORMAT_RAW,      /* RAW, 1 plane */
        IMGU_ABI_FRAME_FORMAT_RGB565,   /* 16 bit RGB, 1 plane. Each 3 sub
                                         * pixels are packed into one 16 bit
                                         * value, 5 bits for R, 6 bits for G
                                         * and 5 bits for B.
                                         */
        IMGU_ABI_FRAME_FORMAT_PLANAR_RGB888, /* 24 bit RGB, 3 planes */
        IMGU_ABI_FRAME_FORMAT_RGBA888,  /* 32 bit RGBA, 1 plane, A=Alpha
                                         * (alpha is unused)
                                         */
        IMGU_ABI_FRAME_FORMAT_QPLANE6,  /* Internal, for advanced ISP */
        IMGU_ABI_FRAME_FORMAT_BINARY_8, /* byte stream, used for jpeg. For
                                         * frames of this type, we set the
                                         * height to 1 and the width to the
                                         * number of allocated bytes.
                                         */
        IMGU_ABI_FRAME_FORMAT_MIPI,     /* MIPI frame, 1 plane */
        IMGU_ABI_FRAME_FORMAT_RAW_PACKED,        /* RAW, 1 plane, packed */
        IMGU_ABI_FRAME_FORMAT_CSI_MIPI_YUV420_8, /* 8 bit per Y/U/V. Y odd line
                                                  * UYVY interleaved even line
                                                  */
        IMGU_ABI_FRAME_FORMAT_CSI_MIPI_LEGACY_YUV420_8, /* Legacy YUV420.
                                                         * UY odd line;
                                                         * VY even line
                                                         */
        IMGU_ABI_FRAME_FORMAT_CSI_MIPI_YUV420_10,/* 10 bit per Y/U/V. Y odd
                                                  * line; UYVY interleaved
                                                  * even line
                                                  */
        IMGU_ABI_FRAME_FORMAT_YCGCO444_16, /* Internal format for ISP2.7,
                                            * 16 bits per plane YUV 444,
                                            * Y, U, V plane
                                            */
        IMGU_ABI_FRAME_FORMAT_NUM
};

enum imgu_abi_bayer_order {
        IMGU_ABI_BAYER_ORDER_GRBG,
        IMGU_ABI_BAYER_ORDER_RGGB,
        IMGU_ABI_BAYER_ORDER_BGGR,
        IMGU_ABI_BAYER_ORDER_GBRG
};

enum imgu_abi_osys_format {
        IMGU_ABI_OSYS_FORMAT_YUV420,
        IMGU_ABI_OSYS_FORMAT_YV12,
        IMGU_ABI_OSYS_FORMAT_NV12,
        IMGU_ABI_OSYS_FORMAT_NV21,
        IMGU_ABI_OSYS_FORMAT_YUV_LINE,
        IMGU_ABI_OSYS_FORMAT_YUY2,      /* = IMGU_ABI_OSYS_FORMAT_YUYV */
        IMGU_ABI_OSYS_FORMAT_NV16,
        IMGU_ABI_OSYS_FORMAT_RGBA,
        IMGU_ABI_OSYS_FORMAT_BGRA
};

enum imgu_abi_osys_tiling {
        IMGU_ABI_OSYS_TILING_NONE,
        IMGU_ABI_OSYS_TILING_Y,
        IMGU_ABI_OSYS_TILING_YF,
};

enum imgu_abi_osys_procmode {
        IMGU_ABI_OSYS_PROCMODE_BYPASS,
        IMGU_ABI_OSYS_PROCMODE_UPSCALE,
        IMGU_ABI_OSYS_PROCMODE_DOWNSCALE,
};

enum imgu_abi_queue_id {
        IMGU_ABI_QUEUE_EVENT_ID = -1,
        IMGU_ABI_QUEUE_A_ID = 0,
        IMGU_ABI_QUEUE_B_ID,
        IMGU_ABI_QUEUE_C_ID,
        IMGU_ABI_QUEUE_D_ID,
        IMGU_ABI_QUEUE_E_ID,
        IMGU_ABI_QUEUE_F_ID,
        IMGU_ABI_QUEUE_G_ID,
        IMGU_ABI_QUEUE_H_ID,            /* input frame queue for skycam */
        IMGU_ABI_QUEUE_NUM
};

enum imgu_abi_buffer_type {
        IMGU_ABI_BUFFER_TYPE_INVALID = -1,
        IMGU_ABI_BUFFER_TYPE_3A_STATISTICS = 0,
        IMGU_ABI_BUFFER_TYPE_DIS_STATISTICS,
        IMGU_ABI_BUFFER_TYPE_LACE_STATISTICS,
        IMGU_ABI_BUFFER_TYPE_INPUT_FRAME,
        IMGU_ABI_BUFFER_TYPE_OUTPUT_FRAME,
        IMGU_ABI_BUFFER_TYPE_SEC_OUTPUT_FRAME,
        IMGU_ABI_BUFFER_TYPE_VF_OUTPUT_FRAME,
        IMGU_ABI_BUFFER_TYPE_SEC_VF_OUTPUT_FRAME,
        IMGU_ABI_BUFFER_TYPE_RAW_OUTPUT_FRAME,
        IMGU_ABI_BUFFER_TYPE_CUSTOM_INPUT,
        IMGU_ABI_BUFFER_TYPE_CUSTOM_OUTPUT,
        IMGU_ABI_BUFFER_TYPE_METADATA,
        IMGU_ABI_BUFFER_TYPE_PARAMETER_SET,
        IMGU_ABI_BUFFER_TYPE_PER_FRAME_PARAMETER_SET,
        IMGU_ABI_NUM_DYNAMIC_BUFFER_TYPE,
        IMGU_ABI_NUM_BUFFER_TYPE
};

enum imgu_abi_raw_type {
        IMGU_ABI_RAW_TYPE_BAYER,
        IMGU_ABI_RAW_TYPE_IR_ON_GR,
        IMGU_ABI_RAW_TYPE_IR_ON_GB
};

enum imgu_abi_memories {
        IMGU_ABI_MEM_ISP_PMEM0 = 0,
        IMGU_ABI_MEM_ISP_DMEM0,
        IMGU_ABI_MEM_ISP_VMEM0,
        IMGU_ABI_MEM_ISP_VAMEM0,
        IMGU_ABI_MEM_ISP_VAMEM1,
        IMGU_ABI_MEM_ISP_VAMEM2,
        IMGU_ABI_MEM_ISP_HMEM0,
        IMGU_ABI_MEM_SP0_DMEM0,
        IMGU_ABI_MEM_SP1_DMEM0,
        IMGU_ABI_MEM_DDR,
        IMGU_ABI_NUM_MEMORIES
};

enum imgu_abi_param_class {
        IMGU_ABI_PARAM_CLASS_PARAM,     /* Late binding parameters, like 3A */
        IMGU_ABI_PARAM_CLASS_CONFIG,    /* Pipe config time parameters */
        IMGU_ABI_PARAM_CLASS_STATE,     /* State parameters, eg. buffer index */
        IMGU_ABI_PARAM_CLASS_NUM
};

enum imgu_abi_bin_input_src {
        IMGU_ABI_BINARY_INPUT_SOURCE_SENSOR,
        IMGU_ABI_BINARY_INPUT_SOURCE_MEMORY,
        IMGU_ABI_BINARY_INPUT_SOURCE_VARIABLE,
};

enum imgu_abi_sp_swstate {
        IMGU_ABI_SP_SWSTATE_TERMINATED,
        IMGU_ABI_SP_SWSTATE_INITIALIZED,
        IMGU_ABI_SP_SWSTATE_CONNECTED,
        IMGU_ABI_SP_SWSTATE_RUNNING,
};

enum imgu_abi_bl_swstate {
        IMGU_ABI_BL_SWSTATE_OK = 0x100,
        IMGU_ABI_BL_SWSTATE_BUSY,
        IMGU_ABI_BL_SWSTATE_ERR,
};

/* The type of pipe stage */
enum imgu_abi_stage_type {
        IMGU_ABI_STAGE_TYPE_SP,
        IMGU_ABI_STAGE_TYPE_ISP,
};

struct imgu_abi_acc_operation {
        /*
         * zero means on init,
         * others mean upon receiving an ack signal from the BC acc.
         */
        u8 op_indicator;
        u8 op_type;
} __packed;

struct imgu_abi_acc_process_lines_cmd_data {
        u16 lines;
        u8 cfg_set;
        u8 reserved;            /* Align to 4 bytes */
} __packed;

/* Bayer shading definitions */

struct imgu_abi_shd_transfer_luts_set_data {
        u8 set_number;
        u8 padding[3];
        imgu_addr_t rg_lut_ddr_addr;
        imgu_addr_t bg_lut_ddr_addr;
        u32 align_dummy;
} __packed;

struct imgu_abi_shd_grid_config {
        /* reg 0 */
        u32 grid_width:8;
        u32 grid_height:8;
        u32 block_width:3;
        u32 reserved0:1;
        u32 block_height:3;
        u32 reserved1:1;
        u32 grid_height_per_slice:8;
        /* reg 1 */
        s32 x_start:13;
        s32 reserved2:3;
        s32 y_start:13;
        s32 reserved3:3;
} __packed;

struct imgu_abi_shd_general_config {
        u32 init_set_vrt_offst_ul:8;
        u32 shd_enable:1;
        /* aka 'gf' */
        u32 gain_factor:2;
        u32 reserved:21;
} __packed;

struct imgu_abi_shd_black_level_config {
        /* reg 0 */
        s32 bl_r:12;
        s32 reserved0:4;
        s32 bl_gr:12;
        u32 reserved1:1;
        /* aka 'nf' */
        u32 normalization_shift:3;
        /* reg 1 */
        s32 bl_gb:12;
        s32 reserved2:4;
        s32 bl_b:12;
        s32 reserved3:4;
} __packed;

struct imgu_abi_shd_intra_frame_operations_data {
        struct imgu_abi_acc_operation
                operation_list[IMGU_ABI_SHD_MAX_OPERATIONS] __aligned(32);
        struct imgu_abi_acc_process_lines_cmd_data
                process_lines_data[IMGU_ABI_SHD_MAX_PROCESS_LINES] __aligned(32);
        struct imgu_abi_shd_transfer_luts_set_data
                transfer_data[IMGU_ABI_SHD_MAX_TRANSFERS] __aligned(32);
} __packed;

struct imgu_abi_shd_config {
        struct ipu3_uapi_shd_config_static shd __aligned(32);
        struct imgu_abi_shd_intra_frame_operations_data shd_ops __aligned(32);
        struct ipu3_uapi_shd_lut shd_lut __aligned(32);
} __packed;

struct imgu_abi_stripe_input_frame_resolution {
        u16 width;
        u16 height;
        u32 bayer_order;                /* enum ipu3_uapi_bayer_order */
        u32 raw_bit_depth;
} __packed;

/* Stripe-based processing */

struct imgu_abi_stripes {
        /* offset from start of frame - measured in pixels */
        u16 offset;
        /* stripe width - measured in pixels */
        u16 width;
        /* stripe width - measured in pixels */
        u16 height;
} __packed;

struct imgu_abi_stripe_data {
        /*
         * number of stripes for current processing source
         * - VLIW binary parameter we currently support 1 or 2 stripes
         */
        u16 num_of_stripes;

        u8 padding[2];

        /*
         * the following data is derived from resolution-related
         * pipe config and from num_of_stripes
         */

        /*
         *'input-stripes' - before input cropping
         * used by input feeder
         */
        struct imgu_abi_stripe_input_frame_resolution input_frame;

        /*'effective-stripes' - after input cropping used dpc, bds */
        struct imgu_abi_stripes effective_stripes[IPU3_UAPI_MAX_STRIPES];

        /* 'down-scaled-stripes' - after down-scaling ONLY. used by BDS */
        struct imgu_abi_stripes down_scaled_stripes[IPU3_UAPI_MAX_STRIPES];

        /*
         *'bds-out-stripes' - after bayer down-scaling and padding.
         * used by all algos starting with norm up to the ref-frame for GDC
         * (currently up to the output kernel)
         */
        struct imgu_abi_stripes bds_out_stripes[IPU3_UAPI_MAX_STRIPES];

        /* 'bds-out-stripes (no overlap)' - used for ref kernel */
        struct imgu_abi_stripes
                        bds_out_stripes_no_overlap[IPU3_UAPI_MAX_STRIPES];

        /*
         * input resolution for output system (equal to bds_out - envelope)
         * output-system input frame width as configured by user
         */
        u16 output_system_in_frame_width;
        /* output-system input frame height as configured by user */
        u16 output_system_in_frame_height;

        /*
         * 'output-stripes' - accounts for stiching on the output (no overlap)
         * used by the output kernel
         */
        struct imgu_abi_stripes output_stripes[IPU3_UAPI_MAX_STRIPES];

        /*
         * 'block-stripes' - accounts for stiching by the output system
         * (1 or more blocks overlap)
         * used by DVS, TNR and the output system kernel
         */
        struct imgu_abi_stripes block_stripes[IPU3_UAPI_MAX_STRIPES];

        u16 effective_frame_width;      /* Needed for vertical cropping */
        u16 bds_frame_width;
        u16 out_frame_width;    /* Output frame width as configured by user */
        u16 out_frame_height;   /* Output frame height as configured by user */

        /* GDC in buffer (A.K.A delay frame,ref buffer) info */
        u16 gdc_in_buffer_width;        /* GDC in buffer width  */
        u16 gdc_in_buffer_height;       /* GDC in buffer height */
        /* GDC in buffer first valid pixel x offset */
        u16 gdc_in_buffer_offset_x;
        /* GDC in buffer first valid pixel y offset */
        u16 gdc_in_buffer_offset_y;

        /* Display frame width as configured by user */
        u16 display_frame_width;
        /* Display frame height as configured by user */
        u16 display_frame_height;
        u16 bds_aligned_frame_width;
        /* Number of vectors to left-crop when writing stripes (not stripe 0) */
        u16 half_overlap_vectors;
        /* Decimate ISP and fixed func resolutions after BDS (ir_extraction) */
        u16 ir_ext_decimation;
        u8 padding1[2];
} __packed;

/* Input feeder related structs */

struct imgu_abi_input_feeder_data {
        u32 row_stride;                 /* row stride */
        u32 start_row_address;          /* start row address */
        u32 start_pixel;                /* start pixel */
} __packed;

struct imgu_abi_input_feeder_data_aligned {
        struct imgu_abi_input_feeder_data data __aligned(32);
} __packed;

struct imgu_abi_input_feeder_data_per_stripe {
        struct imgu_abi_input_feeder_data_aligned
                input_feeder_data[IPU3_UAPI_MAX_STRIPES];
} __packed;

struct imgu_abi_input_feeder_config {
        struct imgu_abi_input_feeder_data data;
        struct imgu_abi_input_feeder_data_per_stripe data_per_stripe
                __aligned(32);
} __packed;

/* DVS related definitions */

struct imgu_abi_dvs_stat_grd_config {
        u8 grid_width;
        u8 grid_height;
        u8 block_width;
        u8 block_height;
        u16 x_start;
        u16 y_start;
        u16 enable;
        u16 x_end;
        u16 y_end;
} __packed;

struct imgu_abi_dvs_stat_cfg {
        u8 reserved0[4];
        struct imgu_abi_dvs_stat_grd_config
                                        grd_config[IMGU_ABI_DVS_STAT_LEVELS];
        u8 reserved1[18];
} __packed;

struct imgu_abi_dvs_stat_transfer_op_data {
        u8 set_number;
} __packed;

struct imgu_abi_dvs_stat_intra_frame_operations_data {
        struct imgu_abi_acc_operation
                ops[IMGU_ABI_DVS_STAT_MAX_OPERATIONS] __aligned(32);
        struct imgu_abi_acc_process_lines_cmd_data
                process_lines_data[IMGU_ABI_DVS_STAT_MAX_PROCESS_LINES]
                __aligned(32);
        struct imgu_abi_dvs_stat_transfer_op_data
                transfer_data[IMGU_ABI_DVS_STAT_MAX_TRANSFERS] __aligned(32);
} __packed;

struct imgu_abi_dvs_stat_config {
        struct imgu_abi_dvs_stat_cfg cfg __aligned(32);
        u8 reserved0[128];
        struct imgu_abi_dvs_stat_intra_frame_operations_data operations_data;
        u8 reserved1[64];
} __packed;

/* Y-tone Mapping */

struct imgu_abi_yuvp2_y_tm_lut_static_config {
        u16 entries[IMGU_ABI_YUVP2_YTM_LUT_ENTRIES];
        u32 enable;
} __packed;

/* Output formatter related structs */

struct imgu_abi_osys_formatter_params {
        u32 format;
        u32 flip;
        u32 mirror;
        u32 tiling;
        u32 reduce_range;
        u32 alpha_blending;
        u32 release_inp_addr;
        u32 release_inp_en;
        u32 process_out_buf_addr;
        u32 image_width_vecs;
        u32 image_height_lines;
        u32 inp_buff_y_st_addr;
        u32 inp_buff_y_line_stride;
        u32 inp_buff_y_buffer_stride;
        u32 int_buff_u_st_addr;
        u32 int_buff_v_st_addr;
        u32 inp_buff_uv_line_stride;
        u32 inp_buff_uv_buffer_stride;
        u32 out_buff_level;
        u32 out_buff_nr_y_lines;
        u32 out_buff_u_st_offset;
        u32 out_buff_v_st_offset;
        u32 out_buff_y_line_stride;
        u32 out_buff_uv_line_stride;
        u32 hist_buff_st_addr;
        u32 hist_buff_line_stride;
        u32 hist_buff_nr_lines;
} __packed;

struct imgu_abi_osys_formatter {
        struct imgu_abi_osys_formatter_params param __aligned(32);
} __packed;

struct imgu_abi_osys_scaler_params {
        u32 inp_buf_y_st_addr;
        u32 inp_buf_y_line_stride;
        u32 inp_buf_y_buffer_stride;
        u32 inp_buf_u_st_addr;
        u32 inp_buf_v_st_addr;
        u32 inp_buf_uv_line_stride;
        u32 inp_buf_uv_buffer_stride;
        u32 inp_buf_chunk_width;
        u32 inp_buf_nr_buffers;
        /* Output buffers */
        u32 out_buf_y_st_addr;
        u32 out_buf_y_line_stride;
        u32 out_buf_y_buffer_stride;
        u32 out_buf_u_st_addr;
        u32 out_buf_v_st_addr;
        u32 out_buf_uv_line_stride;
        u32 out_buf_uv_buffer_stride;
        u32 out_buf_nr_buffers;
        /* Intermediate buffers */
        u32 int_buf_y_st_addr;
        u32 int_buf_y_line_stride;
        u32 int_buf_u_st_addr;
        u32 int_buf_v_st_addr;
        u32 int_buf_uv_line_stride;
        u32 int_buf_height;
        u32 int_buf_chunk_width;
        u32 int_buf_chunk_height;
        /* Context buffers */
        u32 ctx_buf_hor_y_st_addr;
        u32 ctx_buf_hor_u_st_addr;
        u32 ctx_buf_hor_v_st_addr;
        u32 ctx_buf_ver_y_st_addr;
        u32 ctx_buf_ver_u_st_addr;
        u32 ctx_buf_ver_v_st_addr;
        /* Addresses for release-input and process-output tokens */
        u32 release_inp_buf_addr;
        u32 release_inp_buf_en;
        u32 release_out_buf_en;
        u32 process_out_buf_addr;
        /* Settings dimensions, padding, cropping */
        u32 input_image_y_width;
        u32 input_image_y_height;
        u32 input_image_y_start_column;
        u32 input_image_uv_start_column;
        u32 input_image_y_left_pad;
        u32 input_image_uv_left_pad;
        u32 input_image_y_right_pad;
        u32 input_image_uv_right_pad;
        u32 input_image_y_top_pad;
        u32 input_image_uv_top_pad;
        u32 input_image_y_bottom_pad;
        u32 input_image_uv_bottom_pad;
        u32 processing_mode;    /* enum imgu_abi_osys_procmode */
        u32 scaling_ratio;
        u32 y_left_phase_init;
        u32 uv_left_phase_init;
        u32 y_top_phase_init;
        u32 uv_top_phase_init;
        u32 coeffs_exp_shift;
        u32 out_y_left_crop;
        u32 out_uv_left_crop;
        u32 out_y_top_crop;
        u32 out_uv_top_crop;
} __packed;

struct imgu_abi_osys_scaler {
        struct imgu_abi_osys_scaler_params param __aligned(32);
} __packed;

struct imgu_abi_osys_frame_params {
        /* Output pins */
        u32 enable;
        u32 format;             /* enum imgu_abi_osys_format */
        u32 flip;
        u32 mirror;
        u32 tiling;             /* enum imgu_abi_osys_tiling */
        u32 width;
        u32 height;
        u32 stride;
        u32 scaled;
} __packed;

struct imgu_abi_osys_frame {
        struct imgu_abi_osys_frame_params param __aligned(32);
} __packed;

struct imgu_abi_osys_stripe {
        /* Input resolution */
        u32 input_width;
        u32 input_height;
        /* Output Stripe */
        u32 output_width[IMGU_ABI_OSYS_PINS];
        u32 output_height[IMGU_ABI_OSYS_PINS];
        u32 output_offset[IMGU_ABI_OSYS_PINS];
        u32 buf_stride[IMGU_ABI_OSYS_PINS];
        /* Scaler params */
        u32 block_width;
        u32 block_height;
        /* Output Crop factor */
        u32 crop_top[IMGU_ABI_OSYS_PINS];
        u32 crop_left[IMGU_ABI_OSYS_PINS];
} __packed;

struct imgu_abi_osys_config {
        struct imgu_abi_osys_formatter
                formatter[IPU3_UAPI_MAX_STRIPES][IMGU_ABI_OSYS_PINS];
        struct imgu_abi_osys_scaler scaler[IPU3_UAPI_MAX_STRIPES];
        struct imgu_abi_osys_frame frame[IMGU_ABI_OSYS_PINS];
        struct imgu_abi_osys_stripe stripe[IPU3_UAPI_MAX_STRIPES];
        /* 32 packed coefficients for luma and chroma */
        s8 scaler_coeffs_chroma[128];
        s8 scaler_coeffs_luma[128];
} __packed;

/* BDS */

struct imgu_abi_bds_hor_ctrl0 {
        u32 sample_patrn_length:9;
        u32 reserved0:3;
        u32 hor_ds_en:1;
        u32 min_clip_val:1;
        u32 max_clip_val:2;
        u32 out_frame_width:13;
        u32 reserved1:3;
} __packed;

struct imgu_abi_bds_ptrn_arr {
        u32 elems[IMGU_ABI_BDS_SAMPLE_PATTERN_ARRAY_SIZE];
} __packed;

struct imgu_abi_bds_phase_entry {
        s8 coeff_min2;
        s8 coeff_min1;
        s8 coeff_0;
        s8 nf;
        s8 coeff_pls1;
        s8 coeff_pls2;
        s8 coeff_pls3;
        u8 reserved;
} __packed;

struct imgu_abi_bds_phase_arr {
        struct imgu_abi_bds_phase_entry
                even[IMGU_ABI_BDS_PHASE_COEFFS_ARRAY_SIZE];
        struct imgu_abi_bds_phase_entry
                odd[IMGU_ABI_BDS_PHASE_COEFFS_ARRAY_SIZE];
} __packed;

struct imgu_abi_bds_hor_ctrl1 {
        u32 hor_crop_start:13;
        u32 reserved0:3;
        u32 hor_crop_end:13;
        u32 reserved1:1;
        u32 hor_crop_en:1;
        u32 reserved2:1;
} __packed;

struct imgu_abi_bds_hor_ctrl2 {
        u32 input_frame_height:13;
        u32 reserved0:19;
} __packed;

struct imgu_abi_bds_hor {
        struct imgu_abi_bds_hor_ctrl0 hor_ctrl0;
        struct imgu_abi_bds_ptrn_arr hor_ptrn_arr;
        struct imgu_abi_bds_phase_arr hor_phase_arr;
        struct imgu_abi_bds_hor_ctrl1 hor_ctrl1;
        struct imgu_abi_bds_hor_ctrl2 hor_ctrl2;
} __packed;

struct imgu_abi_bds_ver_ctrl0 {
        u32 sample_patrn_length:9;
        u32 reserved0:3;
        u32 ver_ds_en:1;
        u32 min_clip_val:1;
        u32 max_clip_val:2;
        u32 reserved1:16;
} __packed;

struct imgu_abi_bds_ver_ctrl1 {
        u32 out_frame_width:13;
        u32 reserved0:3;
        u32 out_frame_height:13;
        u32 reserved1:3;
} __packed;

struct imgu_abi_bds_ver {
        struct imgu_abi_bds_ver_ctrl0 ver_ctrl0;
        struct imgu_abi_bds_ptrn_arr ver_ptrn_arr;
        struct imgu_abi_bds_phase_arr ver_phase_arr;
        struct imgu_abi_bds_ver_ctrl1 ver_ctrl1;
} __packed;

struct imgu_abi_bds_per_stripe_data {
        struct imgu_abi_bds_hor_ctrl0 hor_ctrl0;
        struct imgu_abi_bds_ver_ctrl1 ver_ctrl1;
        struct imgu_abi_bds_hor_ctrl1 crop;
} __packed;

struct imgu_abi_bds_per_stripe_data_aligned {
        struct imgu_abi_bds_per_stripe_data data __aligned(32);
} __packed;

struct imgu_abi_bds_per_stripe {
        struct imgu_abi_bds_per_stripe_data_aligned
                aligned_data[IPU3_UAPI_MAX_STRIPES];
} __packed;

struct imgu_abi_bds_config {
        struct imgu_abi_bds_hor hor __aligned(32);
        struct imgu_abi_bds_ver ver __aligned(32);
        struct imgu_abi_bds_per_stripe per_stripe __aligned(32);
        u32 enabled;
} __packed;

/* ANR */

struct imgu_abi_anr_search_config {
        u32 enable;
        u16 frame_width;
        u16 frame_height;
} __packed;

struct imgu_abi_anr_stitch_config {
        u32 anr_stitch_en;
        u16 frame_width;
        u16 frame_height;
        u8 reserved[40];
        struct ipu3_uapi_anr_stitch_pyramid pyramid[IPU3_UAPI_ANR_PYRAMID_SIZE];
} __packed;

struct imgu_abi_anr_tile2strm_config {
        u32 enable;
        u16 frame_width;
        u16 frame_height;
} __packed;

struct imgu_abi_anr_config {
        struct imgu_abi_anr_search_config search __aligned(32);
        struct ipu3_uapi_anr_transform_config transform __aligned(32);
        struct imgu_abi_anr_stitch_config stitch __aligned(32);
        struct imgu_abi_anr_tile2strm_config tile2strm __aligned(32);
} __packed;

/* AF */

struct imgu_abi_af_frame_size {
        u16 width;
        u16 height;
} __packed;

struct imgu_abi_af_config_s {
        struct ipu3_uapi_af_filter_config filter_config __aligned(32);
        struct imgu_abi_af_frame_size frame_size;
        struct ipu3_uapi_grid_config grid_cfg __aligned(32);
} __packed;

struct imgu_abi_af_intra_frame_operations_data {
        struct imgu_abi_acc_operation ops[IMGU_ABI_AF_MAX_OPERATIONS]
                __aligned(32);
        struct imgu_abi_acc_process_lines_cmd_data
                process_lines_data[IMGU_ABI_AF_MAX_PROCESS_LINES] __aligned(32);
} __packed;

struct imgu_abi_af_stripe_config {
        struct imgu_abi_af_frame_size frame_size __aligned(32);
        struct ipu3_uapi_grid_config grid_cfg __aligned(32);
} __packed;

struct imgu_abi_af_config {
        struct imgu_abi_af_config_s config;
        struct imgu_abi_af_intra_frame_operations_data operations_data;
        struct imgu_abi_af_stripe_config stripes[IPU3_UAPI_MAX_STRIPES];
} __packed;

/* AE */

struct imgu_abi_ae_config {
        struct ipu3_uapi_ae_grid_config grid_cfg __aligned(32);
        struct ipu3_uapi_ae_weight_elem weights[IPU3_UAPI_AE_WEIGHTS]
                                                                __aligned(32);
        struct ipu3_uapi_ae_ccm ae_ccm __aligned(32);
        struct {
                struct ipu3_uapi_ae_grid_config grid __aligned(32);
        } stripes[IPU3_UAPI_MAX_STRIPES];
} __packed;

/* AWB_FR */

struct imgu_abi_awb_fr_intra_frame_operations_data {
        struct imgu_abi_acc_operation ops[IMGU_ABI_AWB_FR_MAX_OPERATIONS]
                                                                __aligned(32);
        struct imgu_abi_acc_process_lines_cmd_data
              process_lines_data[IMGU_ABI_AWB_FR_MAX_PROCESS_LINES] __aligned(32);
} __packed;

struct imgu_abi_awb_fr_config {
        struct ipu3_uapi_awb_fr_config_s config;
        struct imgu_abi_awb_fr_intra_frame_operations_data operations_data;
        struct ipu3_uapi_awb_fr_config_s stripes[IPU3_UAPI_MAX_STRIPES];
} __packed;

struct imgu_abi_acc_transfer_op_data {
        u8 set_number;
} __packed;

struct imgu_abi_awb_intra_frame_operations_data {
        struct imgu_abi_acc_operation ops[IMGU_ABI_AWB_MAX_OPERATIONS]
                __aligned(32);
        struct imgu_abi_acc_process_lines_cmd_data
                process_lines_data[IMGU_ABI_AWB_MAX_PROCESS_LINES] __aligned(32);
        struct imgu_abi_acc_transfer_op_data
                transfer_data[IMGU_ABI_AWB_MAX_TRANSFERS] __aligned(32);
} __aligned(32) __packed;

struct imgu_abi_awb_config {
        struct ipu3_uapi_awb_config_s config __aligned(32);
        struct imgu_abi_awb_intra_frame_operations_data operations_data;
        struct ipu3_uapi_awb_config_s stripes[IPU3_UAPI_MAX_STRIPES];
} __packed;

struct imgu_abi_acc_param {
        struct imgu_abi_stripe_data stripe;
        u8 padding[8];
        struct imgu_abi_input_feeder_config input_feeder;
        struct ipu3_uapi_bnr_static_config bnr;
        struct ipu3_uapi_bnr_static_config_green_disparity green_disparity
                __aligned(32);
        struct ipu3_uapi_dm_config dm __aligned(32);
        struct ipu3_uapi_ccm_mat_config ccm __aligned(32);
        struct ipu3_uapi_gamma_config gamma __aligned(32);
        struct ipu3_uapi_csc_mat_config csc __aligned(32);
        struct ipu3_uapi_cds_params cds __aligned(32);
        struct imgu_abi_shd_config shd __aligned(32);
        struct imgu_abi_dvs_stat_config dvs_stat;
        u8 padding1[224];       /* reserved for lace_stat */
        struct ipu3_uapi_yuvp1_iefd_config iefd __aligned(32);
        struct ipu3_uapi_yuvp1_yds_config yds_c0 __aligned(32);
        struct ipu3_uapi_yuvp1_chnr_config chnr_c0 __aligned(32);
        struct ipu3_uapi_yuvp1_y_ee_nr_config y_ee_nr __aligned(32);
        struct ipu3_uapi_yuvp1_yds_config yds __aligned(32);
        struct ipu3_uapi_yuvp1_chnr_config chnr __aligned(32);
        struct imgu_abi_yuvp2_y_tm_lut_static_config ytm __aligned(32);
        struct ipu3_uapi_yuvp1_yds_config yds2 __aligned(32);
        struct ipu3_uapi_yuvp2_tcc_static_config tcc __aligned(32);
        /* reserved for defect pixel correction */
        u8 dpc[240832] __aligned(32);
        struct imgu_abi_bds_config bds;
        struct imgu_abi_anr_config anr;
        struct imgu_abi_awb_fr_config awb_fr;
        struct imgu_abi_ae_config ae;
        struct imgu_abi_af_config af;
        struct imgu_abi_awb_config awb;
        struct imgu_abi_osys_config osys;
} __packed;

/***** Morphing table entry *****/

struct imgu_abi_gdc_warp_param {
        u32 origin_x;
        u32 origin_y;
        u32 in_addr_offset;
        u32 in_block_width;
        u32 in_block_height;
        u32 p0_x;
        u32 p0_y;
        u32 p1_x;
        u32 p1_y;
        u32 p2_x;
        u32 p2_y;
        u32 p3_x;
        u32 p3_y;
        u32 in_block_width_a;
        u32 in_block_width_b;
        u32 padding;            /* struct size multiple of DDR word */
} __packed;

/******************* Firmware ABI definitions *******************/

/***** struct imgu_abi_sp_stage *****/

struct imgu_abi_crop_pos {
        u16 x;
        u16 y;
} __packed;

struct imgu_abi_sp_resolution {
        u16 width;                      /* Width of valid data in pixels */
        u16 height;                     /* Height of valid data in lines */
} __packed;

/*
 * Frame info struct. This describes the contents of an image frame buffer.
 */
struct imgu_abi_frame_sp_info {
        struct imgu_abi_sp_resolution res;
        u16 padded_width;               /* stride of line in memory
                                         * (in pixels)
                                         */
        u8 format;                      /* format of the frame data */
        u8 raw_bit_depth;               /* number of valid bits per pixel,
                                         * only valid for RAW bayer frames
                                         */
        u8 raw_bayer_order;             /* bayer order, only valid
                                         * for RAW bayer frames
                                         */
        u8 raw_type;            /* To choose the proper raw frame type. for
                                 * Legacy SKC pipes/Default is set to
                                 * IMGU_ABI_RAW_TYPE_BAYER. For RGB IR sensor -
                                 * driver should set it to:
                                 * IronGr case - IMGU_ABI_RAW_TYPE_IR_ON_GR
                                 * IronGb case - IMGU_ABI_RAW_TYPE_IR_ON_GB
                                 */
        u8 padding[2];                  /* Extend to 32 bit multiple */
} __packed;

struct imgu_abi_buffer_sp {
        union {
                imgu_addr_t xmem_addr;
                s32 queue_id;   /* enum imgu_abi_queue_id */
        } buf_src;
        s32 buf_type;   /* enum imgu_abi_buffer_type */
} __packed;

struct imgu_abi_frame_sp_plane {
        u32 offset;             /* offset in bytes to start of frame data */
                                /* offset is wrt data in imgu_abi_sp_sp_frame */
} __packed;

struct imgu_abi_frame_sp_rgb_planes {
        struct imgu_abi_frame_sp_plane r;
        struct imgu_abi_frame_sp_plane g;
        struct imgu_abi_frame_sp_plane b;
} __packed;

struct imgu_abi_frame_sp_yuv_planes {
        struct imgu_abi_frame_sp_plane y;
        struct imgu_abi_frame_sp_plane u;
        struct imgu_abi_frame_sp_plane v;
} __packed;

struct imgu_abi_frame_sp_nv_planes {
        struct imgu_abi_frame_sp_plane y;
        struct imgu_abi_frame_sp_plane uv;
} __packed;

struct imgu_abi_frame_sp_plane6 {
        struct imgu_abi_frame_sp_plane r;
        struct imgu_abi_frame_sp_plane r_at_b;
        struct imgu_abi_frame_sp_plane gr;
        struct imgu_abi_frame_sp_plane gb;
        struct imgu_abi_frame_sp_plane b;
        struct imgu_abi_frame_sp_plane b_at_r;
} __packed;

struct imgu_abi_frame_sp_binary_plane {
        u32 size;
        struct imgu_abi_frame_sp_plane data;
} __packed;

struct imgu_abi_frame_sp {
        struct imgu_abi_frame_sp_info info;
        struct imgu_abi_buffer_sp buf_attr;
        union {
                struct imgu_abi_frame_sp_plane raw;
                struct imgu_abi_frame_sp_plane rgb;
                struct imgu_abi_frame_sp_rgb_planes planar_rgb;
                struct imgu_abi_frame_sp_plane yuyv;
                struct imgu_abi_frame_sp_yuv_planes yuv;
                struct imgu_abi_frame_sp_nv_planes nv;
                struct imgu_abi_frame_sp_plane6 plane6;
                struct imgu_abi_frame_sp_binary_plane binary;
        } planes;
} __packed;

struct imgu_abi_resolution {
        u32 width;
        u32 height;
} __packed;

struct imgu_abi_frames_sp {
        struct imgu_abi_frame_sp in;
        struct imgu_abi_frame_sp out[IMGU_ABI_BINARY_MAX_OUTPUT_PORTS];
        struct imgu_abi_resolution effective_in_res;
        struct imgu_abi_frame_sp out_vf;
        struct imgu_abi_frame_sp_info internal_frame_info;
        struct imgu_abi_buffer_sp s3a_buf;
        struct imgu_abi_buffer_sp dvs_buf;
        struct imgu_abi_buffer_sp lace_buf;
} __packed;

struct imgu_abi_uds_info {
        u16 curr_dx;
        u16 curr_dy;
        u16 xc;
        u16 yc;
} __packed;

/* Information for a single pipeline stage */
struct imgu_abi_sp_stage {
        /* Multiple boolean flags can be stored in an integer */
        u8 num;                 /* Stage number */
        u8 isp_online;
        u8 isp_copy_vf;
        u8 isp_copy_output;
        u8 sp_enable_xnr;
        u8 isp_deci_log_factor;
        u8 isp_vf_downscale_bits;
        u8 deinterleaved;
        /*
         * NOTE: Programming the input circuit can only be done at the
         * start of a session. It is illegal to program it during execution
         * The input circuit defines the connectivity
         */
        u8 program_input_circuit;
        u8 func;
        u8 stage_type;          /* enum imgu_abi_stage_type */
        u8 num_stripes;
        u8 isp_pipe_version;
        struct {
                u8 vf_output;
                u8 s3a;
                u8 sdis;
                u8 dvs_stats;
                u8 lace_stats;
        } enable;

        struct imgu_abi_crop_pos sp_out_crop_pos;
        u8 padding[2];
        struct imgu_abi_frames_sp frames;
        struct imgu_abi_resolution dvs_envelope;
        struct imgu_abi_uds_info uds;
        imgu_addr_t isp_stage_addr;
        imgu_addr_t xmem_bin_addr;
        imgu_addr_t xmem_map_addr;

        u16 top_cropping;
        u16 row_stripes_height;
        u16 row_stripes_overlap_lines;
        u8 if_config_index;     /* Which should be applied by this stage. */
        u8 padding2;
} __packed;

/***** struct imgu_abi_isp_stage *****/

struct imgu_abi_isp_param_memory_offsets {
        u32 offsets[IMGU_ABI_PARAM_CLASS_NUM];  /* offset wrt hdr in bytes */
} __packed;

/*
 * Blob descriptor.
 * This structure describes an SP or ISP blob.
 * It describes the test, data and bss sections as well as position in a
 * firmware file.
 * For convenience, it contains dynamic data after loading.
 */
struct imgu_abi_blob_info {
        /* Static blob data */
        u32 offset;                     /* Blob offset in fw file */
        struct imgu_abi_isp_param_memory_offsets memory_offsets;
                                        /* offset wrt hdr in bytes */
        u32 prog_name_offset;           /* offset wrt hdr in bytes */
        u32 size;                       /* Size of blob */
        u32 padding_size;               /* total cumulative of bytes added
                                         * due to section alignment
                                         */
        u32 icache_source;              /* Position of icache in blob */
        u32 icache_size;                /* Size of icache section */
        u32 icache_padding;     /* added due to icache section alignment */
        u32 text_source;                /* Position of text in blob */
        u32 text_size;                  /* Size of text section */
        u32 text_padding;       /* bytes added due to text section alignment */
        u32 data_source;                /* Position of data in blob */
        u32 data_target;                /* Start of data in SP dmem */
        u32 data_size;                  /* Size of text section */
        u32 data_padding;       /* bytes added due to data section alignment */
        u32 bss_target;         /* Start position of bss in SP dmem */
        u32 bss_size;                   /* Size of bss section
                                         * Dynamic data filled by loader
                                         */
        u64 code __aligned(8);  /* Code section absolute pointer */
                                        /* within fw, code = icache + text */
        u64 data __aligned(8);  /* Data section absolute pointer */
                                        /* within fw, data = data + bss */
} __packed;

struct imgu_abi_binary_pipeline_info {
        u32 mode;
        u32 isp_pipe_version;
        u32 pipelining;
        u32 c_subsampling;
        u32 top_cropping;
        u32 left_cropping;
        u32 variable_resolution;
} __packed;

struct imgu_abi_binary_input_info {
        u32 min_width;
        u32 min_height;
        u32 max_width;
        u32 max_height;
        u32 source;     /* enum imgu_abi_bin_input_src */
} __packed;

struct imgu_abi_binary_output_info {
        u32 min_width;
        u32 min_height;
        u32 max_width;
        u32 max_height;
        u32 num_chunks;
        u32 variable_format;
} __packed;

struct imgu_abi_binary_internal_info {
        u32 max_width;
        u32 max_height;
} __packed;

struct imgu_abi_binary_bds_info {
        u32 supported_bds_factors;
} __packed;

struct imgu_abi_binary_dvs_info {
        u32 max_envelope_width;
        u32 max_envelope_height;
} __packed;

struct imgu_abi_binary_vf_dec_info {
        u32 is_variable;
        u32 max_log_downscale;
} __packed;

struct imgu_abi_binary_s3a_info {
        u32 s3atbl_use_dmem;
        u32 fixed_s3a_deci_log;
} __packed;

struct imgu_abi_binary_dpc_info {
        u32 bnr_lite;                   /* bnr lite enable flag */
} __packed;

struct imgu_abi_binary_iterator_info {
        u32 num_stripes;
        u32 row_stripes_height;
        u32 row_stripes_overlap_lines;
} __packed;

struct imgu_abi_binary_address_info {
        u32 isp_addresses;              /* Address in ISP dmem */
        u32 main_entry;                 /* Address of entry fct */
        u32 in_frame;                   /* Address in ISP dmem */
        u32 out_frame;                  /* Address in ISP dmem */
        u32 in_data;                    /* Address in ISP dmem */
        u32 out_data;                   /* Address in ISP dmem */
        u32 sh_dma_cmd_ptr;             /* In ISP dmem */
} __packed;

struct imgu_abi_binary_uds_info {
        u16 bpp;
        u16 use_bci;
        u16 use_str;
        u16 woix;
        u16 woiy;
        u16 extra_out_vecs;
        u16 vectors_per_line_in;
        u16 vectors_per_line_out;
        u16 vectors_c_per_line_in;
        u16 vectors_c_per_line_out;
        u16 vmem_gdc_in_block_height_y;
        u16 vmem_gdc_in_block_height_c;
} __packed;

struct imgu_abi_binary_block_info {
        u32 block_width;
        u32 block_height;
        u32 output_block_height;
} __packed;

struct imgu_abi_isp_data {
        imgu_addr_t address;            /* ISP address */
        u32 size;                       /* Disabled if 0 */
} __packed;

struct imgu_abi_isp_param_segments {
        struct imgu_abi_isp_data
                        params[IMGU_ABI_PARAM_CLASS_NUM][IMGU_ABI_NUM_MEMORIES];
} __packed;

struct imgu_abi_binary_info {
        u32 id __aligned(8);            /* IMGU_ABI_BINARY_ID_* */
        struct imgu_abi_binary_pipeline_info pipeline;
        struct imgu_abi_binary_input_info input;
        struct imgu_abi_binary_output_info output;
        struct imgu_abi_binary_internal_info internal;
        struct imgu_abi_binary_bds_info bds;
        struct imgu_abi_binary_dvs_info dvs;
        struct imgu_abi_binary_vf_dec_info vf_dec;
        struct imgu_abi_binary_s3a_info s3a;
        struct imgu_abi_binary_dpc_info dpc_bnr; /* DPC related binary info */
        struct imgu_abi_binary_iterator_info iterator;
        struct imgu_abi_binary_address_info addresses;
        struct imgu_abi_binary_uds_info uds;
        struct imgu_abi_binary_block_info block;
        struct imgu_abi_isp_param_segments mem_initializers;
        struct {
                u8 input_feeder;
                u8 output_system;
                u8 obgrid;
                u8 lin;
                u8 dpc_acc;
                u8 bds_acc;
                u8 shd_acc;
                u8 shd_ff;
                u8 stats_3a_raw_buffer;
                u8 acc_bayer_denoise;
                u8 bnr_ff;
                u8 awb_acc;
                u8 awb_fr_acc;
                u8 anr_acc;
                u8 rgbpp_acc;
                u8 rgbpp_ff;
                u8 demosaic_acc;
                u8 demosaic_ff;
                u8 dvs_stats;
                u8 lace_stats;
                u8 yuvp1_b0_acc;
                u8 yuvp1_c0_acc;
                u8 yuvp2_acc;
                u8 ae;
                u8 af;
                u8 dergb;
                u8 rgb2yuv;
                u8 high_quality;
                u8 kerneltest;
                u8 routing_shd_to_bnr;          /* connect SHD with BNR ACCs */
                u8 routing_bnr_to_anr;          /* connect BNR with ANR ACCs */
                u8 routing_anr_to_de;           /* connect ANR with DE ACCs */
                u8 routing_rgb_to_yuvp1;        /* connect RGB with YUVP1 */
                u8 routing_yuvp1_to_yuvp2;      /* connect YUVP1 with YUVP2 */
                u8 luma_only;
                u8 input_yuv;
                u8 input_raw;
                u8 reduced_pipe;
                u8 vf_veceven;
                u8 dis;
                u8 dvs_envelope;
                u8 uds;
                u8 dvs_6axis;
                u8 block_output;
                u8 streaming_dma;
                u8 ds;
                u8 bayer_fir_6db;
                u8 raw_binning;
                u8 continuous;
                u8 s3a;
                u8 fpnr;
                u8 sc;
                u8 macc;
                u8 output;
                u8 ref_frame;
                u8 tnr;
                u8 xnr;
                u8 params;
                u8 ca_gdc;
                u8 isp_addresses;
                u8 in_frame;
                u8 out_frame;
                u8 high_speed;
                u8 dpc;
                u8 padding[2];
                u8 rgbir;
        } enable;
        struct {
                u8 ref_y_channel;
                u8 ref_c_channel;
                u8 tnr_channel;
                u8 tnr_out_channel;
                u8 dvs_coords_channel;
                u8 output_channel;
                u8 c_channel;
                u8 vfout_channel;
                u8 vfout_c_channel;
                u8 vfdec_bits_per_pixel;
                u8 claimed_by_isp;
                u8 padding[2];
        } dma;
} __packed;

struct imgu_abi_isp_stage {
        struct imgu_abi_blob_info blob_info;
        struct imgu_abi_binary_info binary_info;
        char binary_name[IMGU_ABI_MAX_BINARY_NAME];
        struct imgu_abi_isp_param_segments mem_initializers;
} __packed;

/***** struct imgu_abi_ddr_address_map and parameter set *****/

/* xmem address map allocation */
struct imgu_abi_ddr_address_map {
        imgu_addr_t isp_mem_param[IMGU_ABI_MAX_STAGES][IMGU_ABI_NUM_MEMORIES];
        imgu_addr_t obgrid_tbl[IPU3_UAPI_MAX_STRIPES];
        imgu_addr_t acc_cluster_params_for_sp;
        imgu_addr_t dvs_6axis_params_y;
} __packed;

struct imgu_abi_parameter_set_info {
        /* Pointers to Parameters in ISP format IMPT */
        struct imgu_abi_ddr_address_map mem_map;
        /* Unique ID to track per-frame configurations */
        u32 isp_parameters_id;
        /* Output frame to which this config has to be applied (optional) */
        imgu_addr_t output_frame_ptr;
} __packed;

/***** struct imgu_abi_sp_group *****/

/* SP configuration information */
struct imgu_abi_sp_config {
        u8 no_isp_sync;         /* Signal host immediately after start */
        u8 enable_raw_pool_locking;    /* Enable Raw Buffer Locking for HALv3 */
        u8 lock_all;
        u8 disable_cont_vf;
        u8 disable_preview_on_capture;
        u8 padding[3];
} __packed;

/* Information for a pipeline */
struct imgu_abi_sp_pipeline {
        u32 pipe_id;                    /* the pipe ID */
        u32 pipe_num;                   /* the dynamic pipe number */
        u32 thread_id;                  /* the sp thread ID */
        u32 pipe_config;                /* the pipe config */
        u32 pipe_qos_config;            /* Bitmap of multiple QOS extension fw
                                         * state, 0xffffffff indicates non
                                         * QOS pipe.
                                         */
        u32 inout_port_config;
        u32 required_bds_factor;
        u32 dvs_frame_delay;
        u32 num_stages;         /* the pipe config */
        u32 running;                    /* needed for pipe termination */
        imgu_addr_t sp_stage_addr[IMGU_ABI_MAX_STAGES];
        imgu_addr_t scaler_pp_lut;      /* Early bound LUT */
        u32 stage;                      /* stage ptr is only used on sp */
        s32 num_execs;                  /* number of times to run if this is
                                         * an acceleration pipe.
                                         */
        union {
                struct {
                        u32 bytes_available;
                } bin;
                struct {
                        u32 height;
                        u32 width;
                        u32 padded_width;
                        u32 max_input_width;
                        u32 raw_bit_depth;
                } raw;
        } copy;

        /* Parameters passed to Shading Correction kernel. */
        struct {
                /* Origin X (bqs) of internal frame on shading table */
                u32 internal_frame_origin_x_bqs_on_sctbl;
                /* Origin Y (bqs) of internal frame on shading table */
                u32 internal_frame_origin_y_bqs_on_sctbl;
        } shading;
} __packed;

struct imgu_abi_sp_debug_command {
        /*
         * The DMA software-mask,
         *      Bit 31...24: unused.
         *      Bit 23...16: unused.
         *      Bit 15...08: reading-request enabling bits for DMA channel 7..0
         *      Bit 07...00: writing-request enabling bits for DMA channel 7..0
         *
         * For example, "0...0 0...0 11111011 11111101" indicates that the
         * writing request through DMA Channel 1 and the reading request
         * through DMA channel 2 are both disabled. The others are enabled.
         */
        u32 dma_sw_reg;
} __packed;

/*
 * Group all host initialized SP variables into this struct.
 * This is initialized every stage through dma.
 * The stage part itself is transferred through imgu_abi_sp_stage.
 */
struct imgu_abi_sp_group {
        struct imgu_abi_sp_config config;
        struct imgu_abi_sp_pipeline pipe[IMGU_ABI_MAX_SP_THREADS];
        struct imgu_abi_sp_debug_command debug;
} __packed;

/***** parameter and state class binary configurations *****/

struct imgu_abi_isp_iterator_config {
        struct imgu_abi_frame_sp_info input_info;
        struct imgu_abi_frame_sp_info internal_info;
        struct imgu_abi_frame_sp_info output_info;
        struct imgu_abi_frame_sp_info vf_info;
        struct imgu_abi_sp_resolution dvs_envelope;
} __packed;

struct imgu_abi_dma_port_config {
        u8 crop, elems;
        u16 width;
        u32 stride;
} __packed;

struct imgu_abi_isp_ref_config {
        u32 width_a_over_b;
        struct imgu_abi_dma_port_config port_b;
        u32 ref_frame_addr_y[IMGU_ABI_FRAMES_REF];
        u32 ref_frame_addr_c[IMGU_ABI_FRAMES_REF];
        u32 dvs_frame_delay;
} __packed;

struct imgu_abi_isp_ref_dmem_state {
        u32 ref_in_buf_idx;
        u32 ref_out_buf_idx;
} __packed;

struct imgu_abi_isp_dvs_config {
        u32 num_horizontal_blocks;
        u32 num_vertical_blocks;
} __packed;

struct imgu_abi_isp_tnr3_config {
        u32 width_a_over_b;
        u32 frame_height;
        struct imgu_abi_dma_port_config port_b;
        u32 delay_frame;
        u32 frame_addr[IMGU_ABI_FRAMES_TNR];
} __packed;

struct imgu_abi_isp_tnr3_dmem_state {
        u32 in_bufidx;
        u32 out_bufidx;
        u32 total_frame_counter;
        u32 buffer_frame_counter[IMGU_ABI_BUF_SETS_TNR];
        u32 bypass_filter;
} __packed;

/***** Queues *****/

struct imgu_abi_queue_info {
        u8 size;                /* the maximum number of elements*/
        u8 step;                /* number of bytes per element */
        u8 start;               /* index of the oldest element */
        u8 end;                 /* index at which to write the new element */
} __packed;

struct imgu_abi_queues {
        /*
         * Queues for the dynamic frame information,
         * i.e. the "in_frame" buffer, the "out_frame"
         * buffer and the "vf_out_frame" buffer.
         */
        struct imgu_abi_queue_info host2sp_bufq_info
                        [IMGU_ABI_MAX_SP_THREADS][IMGU_ABI_QUEUE_NUM];
        u32 host2sp_bufq[IMGU_ABI_MAX_SP_THREADS][IMGU_ABI_QUEUE_NUM]
                        [IMGU_ABI_HOST2SP_BUFQ_SIZE];
        struct imgu_abi_queue_info sp2host_bufq_info[IMGU_ABI_QUEUE_NUM];
        u32 sp2host_bufq[IMGU_ABI_QUEUE_NUM][IMGU_ABI_SP2HOST_BUFQ_SIZE];

        /*
         * The queues for the events.
         */
        struct imgu_abi_queue_info host2sp_evtq_info;
        u32 host2sp_evtq[IMGU_ABI_HOST2SP_EVTQ_SIZE];
        struct imgu_abi_queue_info sp2host_evtq_info;
        u32 sp2host_evtq[IMGU_ABI_SP2HOST_EVTQ_SIZE];
} __packed;

/***** Buffer descriptor *****/

struct imgu_abi_metadata_info {
        struct imgu_abi_resolution resolution;  /* Resolution */
        u32 stride;                             /* Stride in bytes */
        u32 size;                               /* Total size in bytes */
} __packed;

struct imgu_abi_isp_3a_statistics {
        union {
                struct {
                        imgu_addr_t s3a_tbl;
                } dmem;
                struct {
                        imgu_addr_t s3a_tbl_hi;
                        imgu_addr_t s3a_tbl_lo;
                } vmem;
        } data;
        struct {
                imgu_addr_t rgby_tbl;
        } data_hmem;
        u32 exp_id;     /* exposure id, to match statistics to a frame, */
        u32 isp_config_id;              /* Tracks per-frame configs */
        imgu_addr_t data_ptr;           /* pointer to base of all data */
        u32 size;                       /* total size of all data */
        u32 dmem_size;
        u32 vmem_size;                  /* both lo and hi have this size */
        u32 hmem_size;
} __packed;

struct imgu_abi_metadata {
        struct imgu_abi_metadata_info info;     /* Layout info */
        imgu_addr_t address;            /* CSS virtual address */
        u32 exp_id;                     /* Exposure ID */
} __packed;

struct imgu_abi_time_meas {
        u32 start_timer_value;          /* measured time in ticks */
        u32 end_timer_value;            /* measured time in ticks */
} __packed;

struct imgu_abi_buffer {
        union {
                struct imgu_abi_isp_3a_statistics s3a;
                u8 reserved[28];
                imgu_addr_t skc_dvs_statistics;
                imgu_addr_t lace_stat;
                struct imgu_abi_metadata metadata;
                struct {
                        imgu_addr_t frame_data;
                        u32 flashed;
                        u32 exp_id;
                        u32 isp_parameters_id;   /* Tracks per-frame configs */
                        u32 padded_width;
                } frame;
                imgu_addr_t ddr_ptrs;
        } payload;
        /*
         * kernel_ptr is present for host administration purposes only.
         * type is uint64_t in order to be 64-bit host compatible.
         * uint64_t does not exist on SP/ISP.
         * Size of the struct is checked by sp.hive.c.
         */
        u64 cookie_ptr __aligned(8);
        u64 kernel_ptr;
        struct imgu_abi_time_meas timing_data;
        u32 isys_eof_clock_tick;
} __packed;

struct imgu_abi_bl_dma_cmd_entry {
        u32 src_addr;                   /* virtual DDR address */
        u32 size;                       /* number of bytes to transferred */
        u32 dst_type;
        u32 dst_addr;                   /* hmm address of xMEM or MMIO */
} __packed;

struct imgu_abi_sp_init_dmem_cfg {
        u32 ddr_data_addr;              /* data segment address in ddr  */
        u32 dmem_data_addr;             /* data segment address in dmem */
        u32 dmem_bss_addr;              /* bss segment address in dmem  */
        u32 data_size;                  /* data segment size            */
        u32 bss_size;                   /* bss segment size             */
        u32 sp_id;                      /* sp id */
} __packed;

#endif