Where Online Learning is simpler!

The C and C++ Include Header Files

cat -n /usr/include/linux/media/raspberrypi/pisp_fe_config.h

     1	/* SPDX-License-Identifier: GPL-2.0-only WITH Linux-syscall-note */
     2	/*
     3	 * RP1 PiSP Front End Driver Configuration structures
     4	 *
     5	 * Copyright (C) 2021 - Raspberry Pi Ltd.
     6	 *
     7	 */
     8	#ifndef _PISP_FE_CONFIG_
     9	#define _PISP_FE_CONFIG_
    10	
    11	#include <linux/types.h>
    12	
    13	#include "pisp_common.h"
    14	#include "pisp_fe_statistics.h"
    15	
    16	#define PISP_FE_NUM_OUTPUTS 2
    17	
    18	enum pisp_fe_enable {
    19		PISP_FE_ENABLE_INPUT = 0x000001,
    20		PISP_FE_ENABLE_DECOMPRESS = 0x000002,
    21		PISP_FE_ENABLE_DECOMPAND = 0x000004,
    22		PISP_FE_ENABLE_BLA = 0x000008,
    23		PISP_FE_ENABLE_DPC = 0x000010,
    24		PISP_FE_ENABLE_STATS_CROP = 0x000020,
    25		PISP_FE_ENABLE_DECIMATE = 0x000040,
    26		PISP_FE_ENABLE_BLC = 0x000080,
    27		PISP_FE_ENABLE_CDAF_STATS = 0x000100,
    28		PISP_FE_ENABLE_AWB_STATS = 0x000200,
    29		PISP_FE_ENABLE_RGBY = 0x000400,
    30		PISP_FE_ENABLE_LSC = 0x000800,
    31		PISP_FE_ENABLE_AGC_STATS = 0x001000,
    32		PISP_FE_ENABLE_CROP0 = 0x010000,
    33		PISP_FE_ENABLE_DOWNSCALE0 = 0x020000,
    34		PISP_FE_ENABLE_COMPRESS0 = 0x040000,
    35		PISP_FE_ENABLE_OUTPUT0 = 0x080000,
    36		PISP_FE_ENABLE_CROP1 = 0x100000,
    37		PISP_FE_ENABLE_DOWNSCALE1 = 0x200000,
    38		PISP_FE_ENABLE_COMPRESS1 = 0x400000,
    39		PISP_FE_ENABLE_OUTPUT1 = 0x800000
    40	};
    41	
    42	#define PISP_FE_ENABLE_CROP(i) (PISP_FE_ENABLE_CROP0 << (4 * (i)))
    43	#define PISP_FE_ENABLE_DOWNSCALE(i) (PISP_FE_ENABLE_DOWNSCALE0 << (4 * (i)))
    44	#define PISP_FE_ENABLE_COMPRESS(i) (PISP_FE_ENABLE_COMPRESS0 << (4 * (i)))
    45	#define PISP_FE_ENABLE_OUTPUT(i) (PISP_FE_ENABLE_OUTPUT0 << (4 * (i)))
    46	
    47	/*
    48	 * We use the enable flags to show when blocks are "dirty", but we need some
    49	 * extra ones too.
    50	 */
    51	enum pisp_fe_dirty {
    52		PISP_FE_DIRTY_GLOBAL = 0x0001,
    53		PISP_FE_DIRTY_FLOATING = 0x0002,
    54		PISP_FE_DIRTY_OUTPUT_AXI = 0x0004
    55	};
    56	
    57	struct pisp_fe_global_config {
    58		__u32 enables;
    59		__u8 bayer_order;
    60		__u8 pad[3];
    61	} __attribute__((packed));
    62	
    63	struct pisp_fe_input_axi_config {
    64		/* burst length minus one, in the range 0..15; OR'd with flags */
    65		__u8 maxlen_flags;
    66		/* { prot[2:0], cache[3:0] } fields */
    67		__u8 cache_prot;
    68		/* QoS (only 4 LS bits are used) */
    69		__u16 qos;
    70	} __attribute__((packed));
    71	
    72	struct pisp_fe_output_axi_config {
    73		/* burst length minus one, in the range 0..15; OR'd with flags */
    74		__u8 maxlen_flags;
    75		/* { prot[2:0], cache[3:0] } fields */
    76		__u8 cache_prot;
    77		/* QoS (4 bitfields of 4 bits each for different panic levels) */
    78		__u16 qos;
    79		/*  For Panic mode: Output FIFO panic threshold */
    80		__u16 thresh;
    81		/*  For Panic mode: Output FIFO statistics throttle threshold */
    82		__u16 throttle;
    83	} __attribute__((packed));
    84	
    85	struct pisp_fe_input_config {
    86		__u8 streaming;
    87		__u8 pad[3];
    88		struct pisp_image_format_config format;
    89		struct pisp_fe_input_axi_config axi;
    90		/* Extra cycles delay before issuing each burst request */
    91		__u8 holdoff;
    92		__u8 pad2[3];
    93	} __attribute__((packed));
    94	
    95	struct pisp_fe_output_config {
    96		struct pisp_image_format_config format;
    97		__u16 ilines;
    98		__u8 pad[2];
    99	} __attribute__((packed));
   100	
   101	struct pisp_fe_input_buffer_config {
   102		__u32 addr_lo;
   103		__u32 addr_hi;
   104		__u16 frame_id;
   105		__u16 pad;
   106	} __attribute__((packed));
   107	
   108	#define PISP_FE_DECOMPAND_LUT_SIZE 65
   109	
   110	struct pisp_fe_decompand_config {
   111		__u16 lut[PISP_FE_DECOMPAND_LUT_SIZE];
   112		__u16 pad;
   113	} __attribute__((packed));
   114	
   115	struct pisp_fe_dpc_config {
   116		__u8 coeff_level;
   117		__u8 coeff_range;
   118		__u8 coeff_range2;
   119	#define PISP_FE_DPC_FLAG_FOLDBACK 1
   120	#define PISP_FE_DPC_FLAG_VFLAG 2
   121		__u8 flags;
   122	} __attribute__((packed));
   123	
   124	#define PISP_FE_LSC_LUT_SIZE 16
   125	
   126	struct pisp_fe_lsc_config {
   127		__u8 shift;
   128		__u8 pad0;
   129		__u16 scale;
   130		__u16 centre_x;
   131		__u16 centre_y;
   132		__u16 lut[PISP_FE_LSC_LUT_SIZE];
   133	} __attribute__((packed));
   134	
   135	struct pisp_fe_rgby_config {
   136		__u16 gain_r;
   137		__u16 gain_g;
   138		__u16 gain_b;
   139		__u8 maxflag;
   140		__u8 pad;
   141	} __attribute__((packed));
   142	
   143	struct pisp_fe_agc_stats_config {
   144		__u16 offset_x;
   145		__u16 offset_y;
   146		__u16 size_x;
   147		__u16 size_y;
   148		/* each weight only 4 bits */
   149		__u8 weights[PISP_AGC_STATS_NUM_ZONES / 2];
   150		__u16 row_offset_x;
   151		__u16 row_offset_y;
   152		__u16 row_size_x;
   153		__u16 row_size_y;
   154		__u8 row_shift;
   155		__u8 float_shift;
   156		__u8 pad1[2];
   157	} __attribute__((packed));
   158	
   159	struct pisp_fe_awb_stats_config {
   160		__u16 offset_x;
   161		__u16 offset_y;
   162		__u16 size_x;
   163		__u16 size_y;
   164		__u8 shift;
   165		__u8 pad[3];
   166		__u16 r_lo;
   167		__u16 r_hi;
   168		__u16 g_lo;
   169		__u16 g_hi;
   170		__u16 b_lo;
   171		__u16 b_hi;
   172	} __attribute__((packed));
   173	
   174	struct pisp_fe_floating_stats_region {
   175		__u16 offset_x;
   176		__u16 offset_y;
   177		__u16 size_x;
   178		__u16 size_y;
   179	} __attribute__((packed));
   180	
   181	struct pisp_fe_floating_stats_config {
   182		struct pisp_fe_floating_stats_region
   183			regions[PISP_FLOATING_STATS_NUM_ZONES];
   184	} __attribute__((packed));
   185	
   186	#define PISP_FE_CDAF_NUM_WEIGHTS 8
   187	
   188	struct pisp_fe_cdaf_stats_config {
   189		__u16 noise_constant;
   190		__u16 noise_slope;
   191		__u16 offset_x;
   192		__u16 offset_y;
   193		__u16 size_x;
   194		__u16 size_y;
   195		__u16 skip_x;
   196		__u16 skip_y;
   197		__u32 mode;
   198	} __attribute__((packed));
   199	
   200	struct pisp_fe_stats_buffer_config {
   201		__u32 addr_lo;
   202		__u32 addr_hi;
   203	} __attribute__((packed));
   204	
   205	struct pisp_fe_crop_config {
   206		__u16 offset_x;
   207		__u16 offset_y;
   208		__u16 width;
   209		__u16 height;
   210	} __attribute__((packed));
   211	
   212	enum pisp_fe_downscale_flags {
   213		/* downscale the four Bayer components independently... */
   214		DOWNSCALE_BAYER = 1,
   215		/* ...without trying to preserve their spatial relationship */
   216		DOWNSCALE_BIN = 2,
   217	};
   218	
   219	struct pisp_fe_downscale_config {
   220		__u8 xin;
   221		__u8 xout;
   222		__u8 yin;
   223		__u8 yout;
   224		__u8 flags; /* enum pisp_fe_downscale_flags */
   225		__u8 pad[3];
   226		__u16 output_width;
   227		__u16 output_height;
   228	} __attribute__((packed));
   229	
   230	struct pisp_fe_output_buffer_config {
   231		__u32 addr_lo;
   232		__u32 addr_hi;
   233	} __attribute__((packed));
   234	
   235	/* Each of the two output channels/branches: */
   236	struct pisp_fe_output_branch_config {
   237		struct pisp_fe_crop_config crop;
   238		struct pisp_fe_downscale_config downscale;
   239		struct pisp_compress_config compress;
   240		struct pisp_fe_output_config output;
   241		__u32 pad;
   242	} __attribute__((packed));
   243	
   244	/* And finally one to rule them all: */
   245	struct pisp_fe_config {
   246		/* I/O configuration: */
   247		struct pisp_fe_stats_buffer_config stats_buffer;
   248		struct pisp_fe_output_buffer_config output_buffer[PISP_FE_NUM_OUTPUTS];
   249		struct pisp_fe_input_buffer_config input_buffer;
   250		/* processing configuration: */
   251		struct pisp_fe_global_config global;
   252		struct pisp_fe_input_config input;
   253		struct pisp_decompress_config decompress;
   254		struct pisp_fe_decompand_config decompand;
   255		struct pisp_bla_config bla;
   256		struct pisp_fe_dpc_config dpc;
   257		struct pisp_fe_crop_config stats_crop;
   258		__u32 spare1; /* placeholder for future decimate configuration */
   259		struct pisp_bla_config blc;
   260		struct pisp_fe_rgby_config rgby;
   261		struct pisp_fe_lsc_config lsc;
   262		struct pisp_fe_agc_stats_config agc_stats;
   263		struct pisp_fe_awb_stats_config awb_stats;
   264		struct pisp_fe_cdaf_stats_config cdaf_stats;
   265		struct pisp_fe_floating_stats_config floating_stats;
   266		struct pisp_fe_output_axi_config output_axi;
   267		struct pisp_fe_output_branch_config ch[PISP_FE_NUM_OUTPUTS];
   268		/* non-register fields: */
   269		__u32 dirty_flags; /* these use pisp_fe_enable */
   270		__u32 dirty_flags_extra; /* these use pisp_fe_dirty */
   271	} __attribute__((packed));
   272	
   273	#endif /* _PISP_FE_CONFIG_ */