os/linux-2.6-tag--devboard-R2_10-4/include/asm-cris/elphel/c313a.h

Go to the documentation of this file.

/*
 * 05.03.2002 changing for revA
 * 03.19.2002 Started support for different sensors
 */

#ifndef _ASM_CMOSCAM_H
#define _ASM_CMOSCAM_H

#define ELPHEL_DEBUG 0 //global debug on/off in multiple files

#define ETRAXFS_MMAP_CACHE_BUG y


/* _IOC_TYPE, bits 8 to 15 in ioctl cmd */

#define CMOSCAM_IOCTYPE 124

/* MINORS */

#define CMOSCAM_MINOR_FRAME     1
#define CMOSCAM_MINOR_FPN       2
//#define CMOSCAM_MINOR_IORW    1
//#define CMOSCAM_MINOR_I2C     2
//#define CMOSCAM_MINOR_RAW     3
#define CMOSCAM_MINOR_I2C       3
#define CMOSCAM_MINOR_DMA       4
#define CMOSCAM_MINOR_MCP       5
#define CMOSCAM_MINOR_LOCK      6
#define CMOSCAM_MINOR_UNLOCK    7
#define CMOSCAM_MINOR_SENSORJTAGFPGA 8
#define CMOSCAM_MINOR_RWTABLES 9
#define CMOSCAM_MINOR_SENSORFPGACOMM 10
#define CMOSCAM_MINOR_CIRCBUF   11
#define CMOSCAM_MINOR_HISTOGRAM 12
#define CMOSCAM_MINOR_JPEAGHEAD 13
#define CMOSCAM_MINOR_GAMMA     14
#define CMOSCAM_MINOR_SENSPARS  15

/* new i2c devices */
#define X3X3_I2C 134
// minors (add more later - maybe different minors for different speed - set speed when opening)
#define X3X3_I2C_CTRL       0  // control/reset i2c
#define X3X3_I2C_8_AINC     1  // 8bit  registers, autoincement while read/write
#define X3X3_I2C_16_AINC    2  // 16bit registers, autoincement while read/write
#define X3X3_I2C1_8_AINC    3  // 8bit  registers, autoincement while read/write (bus 1)
#define X3X3_I2C1_16_AINC   4  // 16bit registers, autoincement while read/write (bus 1)
#define X3X3_I2C_RAW        5  // 8bit  registers, no address byte (just slave, then read/write byte(s)
#define X3X3_I2C1_RAW       6  // 8bit  registers, no address byte (just slave, then read/write byte(s)
#define X3X3_I2C_ENABLE     7  // enable(/protect) different I2C devices for different types of I2C accesses
#define X3X3_I2C_ENABLE_RD   0 // bit 0 - enable i2c read
#define X3X3_I2C_ENABLE_WR   1 // bit 1 - enable i2c write
#define X3X3_I2C_ENABLE_RAW  2 // bit 2 - enable i2c raw (no address byte)
#define X3X3_I2C_ENABLE_8    3 // bit 3 - enable i2c 8-bit registers access
#define X3X3_I2C_ENABLE_16   4 // bit 4 - enable i2c 16-bit registers access
#define X3X3_I2C_MAXMINOR  7  //
#define X3X3_I2C_CHANNELS  2  // number of i2c channels
//xi2craw            c 134   5
//xi2craw_aux        c 134   6
//xi2cenable         c 134   7



/* camera sequencer states */

//New sequencer states

#define CAMSEQ_OFF       0 // off, not programmed (Video mode off on Zoran sensors)
#define CAMSEQ_READY     1 // sensor programmed may acquire at will (programSensor sets number of frames to skip (if any)
#define CAMSEQ_SKIP      2 // skipping specified number of frames, interrupt service routine counts and will start acquisition
#define CAMSEQ_WAIT_F    3 // set by "start exposure" or interrupt service routine. WAIT_F/WAIT_T/acquire/done differs by hardware register
#define CAMSEQ_WAIT_T    4 // set by "start exposure" or interrupt service routine. Wait/acquire/done differs by hardware register
#define CAMSEQ_ACQUIRE   5 // acquisition in progress (camSeqState is still CAMSEQ_WAIT)
#define CAMSEQ_DONE      6 // acquisition over  (camSeqState is still CAMSEQ_WAIT)
#define CAMSEQ_JPEG      7 // waiting for JPEG done interrupt, acquiring/compressing some frames

#define CAMSEQ_RUN       8 // compressor is constantly running (but if camSeqCount>0 - just skipping "bad" frames)
#define CAMSEQ_STOP      9 // compressor is constantly running but will stop after next "compressor ready"
#define CAMSEQ_SINGLE   10 // compressor is constantly running to fill one full buffer
/*
Status CAMSEQ_OFF may be changed to CAMSEQ_READY only by programSensor, it will also stop sensor (if needed)
  and set camSeqCount (if needed) to skip certain number of frames before actual acquisition
  camSeqStart (called mostly through ioctl) will return error if state was not "CAMSEQ_READY" or "CAMSEQ_DONE".
  If called from correct states will either start ISR-based waiting for specified number of frames  or just acquisition.
  In the first case ISR will start acquisition itself
  State "CAMSEQ_WAIT_F" is set at the same time as starting acquisition (by either camSeqStart() or ISR),
  States CAMSEQ_WAIT_F,CAMSEQ_ACQUIRE, CAMSEQ_DONE are returned after testing the hardware register in FPGA if camSeqState==CAMSEQ_WAIT_F
  camSeqStop will terminate any acquisition in progress and set state to CAMSEQ_READY (if it was not CAMSEQ_OFF)
*/
// For KAI11000 sensor board
#define sensorcom_W_size        1024
#define sensorcom_R_size        256

/* MCP definitions */

#define MCP_W_size      1024
#define MCP_R_size      256

#define MCPOtherBits    0xffa7a7ff
#define MCPOffReset     0x00101800
#define MCPReset        0x00001800
#define MCPNoReset      0x00105800
#define MCPToggleA      0x00080000
#define MCPToggleB      0x00001000
#define MCPctlseq       0x00
#define MCPsofttg       0x02
#define MCPeackn        0x03
#define MCPctlgate      0x04
#define MCPwstdly       0x06
#define MCPwrsmsk       0x07
#define MCPwrsup        0x08
#define MCPwrmons       0x09
#define MCPwnom         0x0a
#define MCPwdenom       0x0b
#define MCPwoutw        0x0c
#define MCPwinvctl      0x0d
#define MCPctlsync      0x0e
#define MCPwrdlys       0x10
#define MCPwinv         0x40
#define MCPwshared      0x80
#define MCPwrsynctb     0x100
#define MCPwrseq        0x200


/* supported ioctl _IOC_NR's */
#ifndef I2C_WRITEARG
 #define I2C_WRITEARG(bus, slave, reg, value) (((bus) << 24) | ((slave) << 16) | ((reg) << 8) | (value))
 #define I2C_READARG(bus, slave, reg) (((bus) << 24) | ((slave) << 16) | ((reg) << 8))

 #define I2C_ARGBUS(arg) (((arg) >> 24)  & 0x1)
 #define I2C_ARGSLAVE(arg) (((arg) >> 16)  & 0xff)
 #define I2C_ARGREG(arg) (((arg) >> 8) & 0xff)
 #define I2C_ARGVALUE(arg) ((arg) & 0xff)

 #define I2C_DELAYS   0x0   /* read/write bit deleys for I2C */
// return new delays, if data==0 - don't change, just read
// lower (0) byte - SCL high,
// byte 1 - SCL low
// byte 2 - slave -> master (from slave driving SDA line to master driving SDA)
// byte 3 - master -> slave (from master driving SDA line to slave driving SDA)

 #define I2C_WRITEREG 0x1   /* write to an i2c register */
 #define I2C_READREG  0x2   /* read from an i2c register */
#endif

/* new for Micron sensors  - 16bit data, always bus 0 */
#ifndef I2C_16_WRITEARG
 #define I2C_16_WRITEREG 0x3   /* write 2 bytes to an i2c register */
 #define I2C_16_READREG  0x4   /* read 2 bytes from an i2c register */
  
 #define I2C_16_WRITEARG(slave, reg, value) (((slave) << 24) | ((reg) << 16) | (value))
 #define I2C_16_READARG(slave, reg) (((slave) << 24) | ((reg) << 16))

 #define I2C_16_ARGSLAVE(arg)   (((arg) >> 24) & 0xff)
 #define I2C_16_ARGREG(arg)     (((arg) >> 16) & 0xff)
 #define I2C_16_ARGVALUE(arg)   ( (arg)      & 0xffff)
 #define I2C_16_ARGVALUE_H(arg) (((arg) >>  8) & 0xff)
 #define I2C_16_ARGVALUE_L(arg) ( (arg)        & 0xff)
#endif



// otherParamsRO[16]

#define _CCCMD(x,y)  (_IO(CMOSCAM_IOCTYPE, (x << 6) | (y & 0x3f)))



#define CCAM_CTRL(x)  ((_IOC_NR(x) >> 6) & 0x03)
#define CCAM_ADDR(x)  (_IOC_NR(x) & 0x3f)

//#define CCAM_RWSENSOR   1 /* direct read/write first 32 sensor registers */  // will not use at all
#define CCAM_RPARS      2 /* read  parameters      0..0x3f */
#define CCAM_WPARS      3 /* write parameters      0..0x3f */

/* New parameters and update logic
 * Separate read and write set of 64 registers
 * User may specify:
 *   0 - do not update
 *   1 - update at once
 *   2 - update when appropriate
 * and read update status:
 *   0 - will not be updated
 *   1 - in sync
 *   2 - waiting to be updated
 *   3 - update in progress (TODO: - support async)
 *      When updating (validating) parameters and copying them to the read "registers" the I2C registers will be written
 *  only if they are different from the shadows
 */

/* abstract sensor register names */
#define P_NUMBER         1024   //number of registers (was 64)
#define P_UPDATE         0          /* R/W, see above */
#define P_SENSOR         1     /* read only
                           4  - ZR32112MLC - now there is no way to see color/mono
                           5  - ZR32112PLC
                           8  - ZR32212MLC
                           9  - ZR32112PLC
                           32 - KAC1310-mono
                           33 - KAC1310-RGB
                           34 - KAC1310-CMY
                           36 - KAC5000
                           48 - MI1300
                           49 - MT9M001 (1280x1024,same as MI1300)
                           50 - MT9M001 (1600x1200)
                           51 - MT9T001 (2048*1536)
                           52 - MT9P001 (2592*1944)
                           64 - IBIS5-1300*/

// leave it here - may be used in user applications
#define SENSOR_MASK      0xfc
#define SENSOR_ZR32112   0x04
#define SENSOR_ZR32212   0x08
#define SENSOR_KAC1310   0x20
#define SENSOR_KAC5000   0x24
#define SENSOR_MI1300    0x30
#define SENSOR_MT9X001   0x30 // MT9M001 - 31, MT9D001 - 32, MT9T001 - 33, MT9P001 - 34
#define SENSOR_MT9Y001   0x34 // MT9P001 - 34
#define SENSOR_IBIS51300 0x40
#define SENSOR_KAI11000  0x80
#define SENSOR_NONE      0xfc

// sensor sizes:
//#define SENSORWIDTH_ZR32112  1288
//#define SENSORHEIGHT_ZR32112 1032
#define SENSORWIDTH_ZR32112  1280
#define SENSORHEIGHT_ZR32112 1024
//#define SENSORWIDTH_ZR32212  1288
#define SENSORWIDTH_ZR32212  1280
#define SENSORHEIGHT_ZR32212 968
#define SENSORWIDTH_KAC1310  1280
#define SENSORHEIGHT_KAC1310 1024
//#define SENSORWIDTH_KAC1310  1296
//#define SENSORHEIGHT_KAC1310 1046
#define SENSORWIDTH_MI1300  1280
#define SENSORHEIGHT_MI1300 1024

#define SENSORWIDTH_MT9M001  1280
#define SENSORHEIGHT_MT9M001 1024
#define SENSORWIDTH_MT9D001  1600
#define SENSORHEIGHT_MT9D001 1200
#define SENSORWIDTH_MT9T001  2048
#define SENSORHEIGHT_MT9T001 1536
#define SENSORWIDTH_MT9P001  2592
#define SENSORHEIGHT_MT9P001 1944

#define SENSORWIDTH_KAC5000  2592
#define SENSORHEIGHT_KAC5000 1944


#define SENSORWIDTH_IBIS51300  1280
#define SENSORHEIGHT_IBIS51300 1024

#define P_PARS_CHANGED   2 /* RD P_RO_VALID  0  window parameters valid                  */
#define P_DMA_VALID      3 /* RD P_RO_VALID  0  window parameters valid                  */
#define P_ACTUAL_WIDTH   4 /* RD P_RO_WIDTH  1  pixels/row                               */
#define P_ACTUAL_HEIGHT  5 /* RD P_RO_HEIGHT 2  pixels/column                            */
#define P_LPR            6 /* RD P_RO_LPR    3  32-bit words per row (aligned each row)  */
#define P_IMAGE_SIZE     7 /* RD P_RO_SIZE   4  total image size (dma data) in bytes     */
#define P_BAYER          8 /* filter number at (0,0) 0-R, 1-G(R), 2-G(B), 3 - B. Write enabled at first, move to WindowSize later */
#define P_TRIGGERED         9 /* when trigger occured - 4 LSBs - pixel in DMA word, higher bits - number of DMA word */
#define P_PERIOD        10 // Frame period (read only)
#define P_FRAME         11 // Frame number (reset with JPEG pointers) -(read only)
#define P_JPEG_WP       12 // Last reported JPEG write pointer in the circular buffer. (may have cashe coherency problem,
#define P_CLK_FPGA      13 // FPGA clock in MHz
#define P_CLK_SENSOR    14 // Sensor clock in MHz
#define P_FPGA_XTRA     15 // Extra cycles needed to compressor (probably constant...)

//#define P_TRIG          16 /* R/W P_RW_TRIG   0        0 - internal, 1 - external               */
#define P_TRIG          16 /* External trigger mode                                           */
                           /* bit 0  - "old" external mode (0- internal, 1 - external )       */
                           /* bit 1 - enable(1) or disable(0) external trigger to stop clip   */
                           /* bit 2 - async (snapshot, ext trigger) mode, 0 - continuous   */
                           /* ... to be continued */
#define P_EXPOS         17 /* P_RW_EXPOS  1      exposure time                            */
#define P_BGFRAME       18 // Background measurement mode - will use 16-bit mode and no FPN correction 



// image page numbers depend on image size/pixel depth, so changing any of them will invalidate all pages
#define P_PAGE_ACQ      19  // Number of image page buffer to acquire to (0.1?)
#define P_PAGE_READ     20  // Number of image page buffer to read from to (0.1?)

#define P_OVERLAP       21 // number of EXRA lines to be acquired
#define P_VIDEO         22 /* still (stopped) - 0, video - 1. KAC1310 - video only */

#define P_AUXCM         23 /* signal on AUXCLK pin: 0 - 0, 1 - 1, 1x - 20MHz */

#define P_VIRT_WIDTH    24 /* Virtual window width - KAC-1310 sensor */
#define P_VIRT_HEIGHT   25 /* Virtual window height - KAC-1310 sensor */
#define P_WOI_LEFT      26 /* WOI left corner (before applying decimation) */
#define P_WOI_TOP       27 /* WOI top corner */
#define P_WOI_WIDTH     28 /* WOI width */
#define P_WOI_HEIGHT    29 /* WOI height */

#define P_FLIP          30 // bit 0 - horizontal, bit 1 - vertical
//#define P_FLIPH         30
//#define P_FLIPV         31

#define P_FPSLM           31 // FPS limit mode - bit 0 - limit fps (not higher than), bit 1 - maintain fps (not lower than)

#define P_DCM_HOR       32 /* Horizontal decimation (1/2/4/8) */
#define P_DCM_VERT      33 /* Vertical   decimation (1/2/4/8) copied from horizontal for Zoran chips */
#define P_BIN_HOR       34 /* binning 1/2 - KAC1310 only - now for mt9t001 */
#define P_BIN_VERT      35 /* not used yet binning 1/2 - KAC1310 only  - now for mt9t001*/

#define P_COLOR         36 /* mono - 0, color mode - 1, +0 - normal, 256 - sensor test, 512 - FPGA test */
#define P_FRAMESYNC_DLY     37 /* maybe - temporary - delay of frame sync (vacts) by number of scan lines - for photofinish mode*/
#define P_MCLK          38 /* 2..129  0 - disable?*/
#define P_PF_HEIGHT     39 /*height of each strip in photofinish mode - normally 2 lines */
                           /*also now includes timestamping mode +0x10000 - for normal frames, 0x20000 - for photo-finish */

#define P_BITS          40 /* pixel depth - bits 10/8/4 */

#define P_SHIFTL        41 /* "digital gain" - shift left by 0/1/2 bits  (3 ->-1)*/
#define P_FPNS          42 // FPN correction mode (subtract) 0..3
                           // 0-none, 1 - fine(25%), 2 - 50%, 3 - coarse(100%)
#define P_FPNM          43 // FPN correction mode (multiply) 0..3
                           // 0-none, 1 - fine(+/-12.5%), 2 - medium (+/-25%), +3 - coarse(+/-50%)
#define P_VEXPOS        44 /* video exposure (if 0 - use P_RW_EXPOS in ms) */
#define P_VIRTTRIG      45 // Sum of pixels in a line greater than this value - trigger acquisition

#define P_GAINR         46 /* R channel gain (mono gain)  8.8 0x100 - 1.0 */
#define P_GAING         47 /* G channel gain ("red line" in ZR32212) */
#define P_GAINB         48 /* B channel gain (mono gain) */
#define P_GAINGB        49 /* G channel gain ("blue line" in ZR32212) - copied from P_RW_GAING in ZR2112 */
#define P_FATZERO       50 // subtract while adding data from to consequitive frames (async trigger)
// will be removed
#define P_SPEC_KAC_GGA  51 // KAC-1310 Global gain A , 6 bits, (14)
#define P_SPEC_KAC_GGB  52 // KAC-1310 Global gain B , 6 bits, (14)
#define P_SPEC_KAC_GGM  53 // KAC-1310 Global gain mode, 3 bits, 0
// new gains
#define P_GAIN          51 // 8.8 (0x100 - gain==1.0)  - not used now
#define P_RSCALE        52 // 8.8 (0x100 - rscale==1.0). This parameter applies to digital processing ("gamma" tables, not analog settings)
#define P_BSCALE        53 // 8.8 (0x100 - rscale==1.0). This parameter applies to digital processing ("gamma" tables, not analog settings)



#define P_QUALITY       54 // JPEG IMAGE QUALITY
#define P_FP100S        55 // Frames per 100 sec (fps * 100)
#define P_SENSOR_WIDTH  56
#define P_SENSOR_HEIGHT 57
#define P_COLOR_SATURATION_BLUE 58 // 100*realtive saturation blue
#define P_COLOR_SATURATION_RED  59 // 100*realtive saturation red
#define P_GAMMA         60 // 100*gamma  (for now - just a hint table could be more complex. Use higher bytes for colors in 333)
#define P_PIXEL_LOW     61 //  (just a hint for gamma table) "fat zero" (on 8-bit scale)
#define P_PIXEL_HIGH    62 //  (just a hint for gamma table) highest pixel value (before table) on a 256-scale


#define P_DONTCARE      63 // write anything - just to force update
#define P_PGMSENSRSLT   64 // result of last programSensor() call
#define P_CAMSEQSTATE   65 // sequncer state (to replace camSeqState eventually)?
#define P_CAMSEQCOUNT   66 // sequncer counter (to replace camSeqCount eventually)?
#define P_CIRCBUFSIZE   67 // Size of the circular buffer (in bytes)
#define P_FREECIRCBUF   68 //* Free space in circbuf (uses global read pointer, in bytes)
#define P_CIRCBUFWP     69 //* circbuf write pointer (in bytes - similar P_JPEG_WP is in long words)
#define P_CIRCBUFRP     70 //* circbuf global read pointer (in bytes )
#define P_SECONDS       71 // seconds (R/W to FPGA timer)
#define P_MICROSECONDS  72 // microseconds (R/W to FPGA timer)
#define P_TILES         73 // Number of 16x16 (20x20) tiles in a compressed frame
#define P_SENSOR_PHASE  74 // packed, low 16 bit - signed fine phase, bits [18:17] - 90-degrees shift
#define P_GSCALE        75 // 8.8 (0x100 - gscale==1.0). Additional parameter to compensate for difference in Green/Green1 gains

#define P_AUTOEXP_ON    76 // unsigned long on;
#define P_AUTOEXP_RWIDTH 77 // unsigned long width (%);
#define P_AUTOEXP_RHEIGHT 78 //unsigned long height (%);
#define P_AUTOEXP_RLEFT  79 // unsigned long left (%);
#define P_AUTOEXP_RTOP   80 // unsigned long top (%);
#define P_AUTOEXP_EXP_MAX 81 //unsigned long exp_max;           /* 100 usec == 1 etc... */
#define P_AUTOEXP_OVEREXP_MAX 82 // unsigned long overexp_max;  /* percentages for overexposured pixels - 1% == 100, 5% == 500, 0.02% == 2 etc... */
#define P_AUTOEXP_S_PERCENT 83 // unsigned long s_percent;(controlling that % of pixels that should have value greater than S_INDEX - below)
#define P_AUTOEXP_S_INDEX 84 // unsigned long s_index; Specified number of pixels (S_PERCENT) should have value above S_INDEX
#define P_AUTOEXP_EXP   85 // unsigned long exp; Current exposure time
#define P_AUTOEXP_SKIP_PMIN 86 // unsigned long skip_pmin;      /* percent of delta for skip changes: 1% == 100 */ - no exposure corrections if the desired change is less than that
#define P_AUTOEXP_SKIP_PMAX 87 // unsigned long skip_pmax;      /* percent of changes for wait one frame before apply changes: 1% == 100 */ - do not apply chnanges if they are to big - wait for the next frame
#define P_AUTOEXP_SKIP_T 88 //  unsigned long skip_t;           /* time for skip changes: 100 usec == 1 */ Not quite sure what it is
#define P_AEXPWND_WIDTH  89 // autoexposure window width  (pixels)
#define P_AEXPWND_HEIGHT 90 // autoexposure window height (pixels)
#define P_AEXPWND_TOP    91 // autoexposure window top    (pixels)
#define P_AEXPWND_LEFT   92 // autoexposure window left   (pixels)
#define P_FOCUS_SHOW     93 // show focus information instead of/combined with the image:
                            // 0 - regular image, 1 - block focus instead of Y DC (AC=0), 2 - image Y DC combined all frame, 3 combined in WOI
#define P_FOCUS_SHOW1    94 // Additional parameter that modifies visualization mode. Currently just a single bit (how much to add)
#define P_FOCUS_VALUE    95 // (readonly) - sum of all blocks focus values inside focus WOI
#define P_FOCUS_LEFT     96 // focus WOI left margin, inclusive (3 LSB will be zeroed as it should be multiple of 8x8 block width) 
#define P_FOCUS_WIDTH    97 // focus WOI width (3 LSB will be zeroed as it should be multiple of 8x8 block width) 
#define P_FOCUS_TOP      98 // focus WOI top margin, inclusive (3 LSB will be zeroed as it should be multiple of 8x8 block height) 
#define P_FOCUS_HEIGHT   99 // focus WOI height (3 LSB will be zeroed as it should be multiple of 8x8 block height) 
#define P_FOCUS_TOTWIDTH 100 // (readonly) - total width of the image frame in pixels
#define P_FOCUS_FILTER   101 // select 8x8 filter used for the focus calculation (same order as quantization coefficients), 0..14


#define P_TRIG_CONDITION 102 // trigger condition, 0 - internal, else dibits ((use<<1) | level) for each GPIO[11:0] pin
#define P_TRIG_DELAY     103 // trigger delay, 32 bits in pixel clocks
#define P_TRIG_OUT       104 // trigger output to GPIO, dibits ((use << 1) | level_when_active). Bit 24 - test mode, when GPIO[11:10] are controlled by other internal signals
#define P_TRIG_PERIOD    105 // output sync period (32 bits, in pixel clocks). 0- stop. 1..256 - single, >=256 repetitive with specified period.

#define P_TASKLET_CTL    106 // disable individual tasklets
#define P_COMPRESSOR_CMD 107 // read only - compressor command, last written to FPGA
// bit fields
  #define COMPRESSOR_CMD_RUN    0x080
  #define COMPRESSOR_CMD_SINGLE 0x800  
#define P_SKIP_FRAMES    108 // number of frames to skip after restarting sensor+compressor
#define P_I2C_QPERIOD    109 // number of system clock periods in 1/4 of i2c SCL period to the sensor/sensor board
#define P_I2C_BYTES      110 // number of bytes in hardware i2c write (after slave addr) -0/1/2
#define P_IRQ_SMART      111 // "smart" IRQ modes: +1 - wait for VACT in early compressor_done, +2 - wait for dma fifo ready
#define P_EARLY_TIMESTAMP 112 // "1" - use start of TRIG pulse as a timetamp moment (0 - use start of first visible line readout) - prevent jitter in async mode
#define P_OVERSIZE       113 // ignore sensor dimensions, use absolute WOI_LEFT, WOI_TOP

#define P_MAX_PAR        127 // maximal # of used parameter
#define P_HIST_NOT_CHANGE 0xffff // will be available as ELPHEL_HIST_NOT_CHANGE constant in PHP


#define P_AUTOEXP P_AUTOEXP_ON
#define P_AEXPWND P_AEXPWND_WIDTH


struct autoexp_t {
        unsigned long on;
        /*
         * in percents: 1 == 1, 100 == 100
         */
        unsigned long width;
        unsigned long height;
        unsigned long left;
        unsigned long top;
        /*
         * start exposure time really not needed...
         */
        unsigned long exp_max;          /* 100 usec == 1 etc... */
        unsigned long overexp_max;      /* percentages for overexposured pixels - 1% == 100, 5% == 500, 0.02% == 2 etc... */
        /*
         * changed chema - balance exposition for set percent of pixels in needed index
         */
        unsigned long s_percent;
        unsigned long s_index;
        /*
         * return current state
         */
        unsigned long exp;
        /*
         * "sleep" settings
         */
        unsigned long skip_pmin;        /* percent of delta for skip changes: 1% == 100 */
        unsigned long skip_pmax;        /* percent of changes for wait one frame before apply changes: 1% == 100 */
        unsigned long skip_t;           /* time for skip changes: 100 usec == 1 */
};
struct aexp_window_t {
        unsigned long width;
        unsigned long height;
        unsigned long top;
        unsigned long left;
};


struct p_names_t {
  int   value;
  char* name;
};

#define P_NAME_ENTRY(y) { P_##y, #y }
#define DEFINE_P_NAMES(x) struct p_names_t x[]= { \
          P_NAME_ENTRY(NUMBER), \
          P_NAME_ENTRY(UPDATE), \
          P_NAME_ENTRY(SENSOR), \
          P_NAME_ENTRY(PARS_CHANGED), \
          P_NAME_ENTRY(DMA_VALID), \
          P_NAME_ENTRY(ACTUAL_WIDTH), \
          P_NAME_ENTRY(ACTUAL_HEIGHT), \
          P_NAME_ENTRY(LPR), \
          P_NAME_ENTRY(IMAGE_SIZE), \
          P_NAME_ENTRY(BAYER), \
          P_NAME_ENTRY(TRIGGERED), \
          P_NAME_ENTRY(PERIOD), \
          P_NAME_ENTRY(FRAME), \
          P_NAME_ENTRY(JPEG_WP), \
          P_NAME_ENTRY(CLK_FPGA), \
          P_NAME_ENTRY(CLK_SENSOR), \
          P_NAME_ENTRY(FPGA_XTRA), \
          P_NAME_ENTRY(TRIG), \
          P_NAME_ENTRY(EXPOS), \
          P_NAME_ENTRY(BGFRAME), \
          P_NAME_ENTRY(PAGE_ACQ), \
          P_NAME_ENTRY(PAGE_READ), \
          P_NAME_ENTRY(OVERLAP), \
          P_NAME_ENTRY(VIDEO), \
          P_NAME_ENTRY(AUXCM), \
          P_NAME_ENTRY(VIRT_WIDTH), \
          P_NAME_ENTRY(VIRT_HEIGHT), \
          P_NAME_ENTRY(WOI_LEFT), \
          P_NAME_ENTRY(WOI_TOP), \
          P_NAME_ENTRY(WOI_WIDTH), \
          P_NAME_ENTRY(WOI_HEIGHT), \
          P_NAME_ENTRY(FLIP), \
          P_NAME_ENTRY(FPSLM), \
          P_NAME_ENTRY(DCM_HOR), \
          P_NAME_ENTRY(DCM_VERT), \
          P_NAME_ENTRY(BIN_HOR), \
          P_NAME_ENTRY(BIN_VERT), \
          P_NAME_ENTRY(COLOR), \
          P_NAME_ENTRY(FRAMESYNC_DLY), \
          P_NAME_ENTRY(MCLK), \
          P_NAME_ENTRY(PF_HEIGHT), \
          P_NAME_ENTRY(BITS), \
          P_NAME_ENTRY(SHIFTL), \
          P_NAME_ENTRY(FPNS), \
          P_NAME_ENTRY(FPNM), \
          P_NAME_ENTRY(VEXPOS), \
          P_NAME_ENTRY(VIRTTRIG), \
          P_NAME_ENTRY(GAINR), \
          P_NAME_ENTRY(GAING), \
          P_NAME_ENTRY(GAINB), \
          P_NAME_ENTRY(GAINGB), \
          P_NAME_ENTRY(FATZERO), \
          P_NAME_ENTRY(SPEC_KAC_GGA), \
          P_NAME_ENTRY(SPEC_KAC_GGB), \
          P_NAME_ENTRY(SPEC_KAC_GGM), \
          P_NAME_ENTRY(GAIN), \
          P_NAME_ENTRY(RSCALE), \
          P_NAME_ENTRY(BSCALE), \
          P_NAME_ENTRY(GSCALE), \
          P_NAME_ENTRY(QUALITY), \
          P_NAME_ENTRY(FP100S), \
          P_NAME_ENTRY(SENSOR_WIDTH), \
          P_NAME_ENTRY(SENSOR_HEIGHT), \
          P_NAME_ENTRY(COLOR_SATURATION_BLUE), \
          P_NAME_ENTRY(COLOR_SATURATION_RED), \
          P_NAME_ENTRY(GAMMA), \
          P_NAME_ENTRY(PIXEL_LOW), \
          P_NAME_ENTRY(PIXEL_HIGH), \
          P_NAME_ENTRY(DONTCARE), \
          P_NAME_ENTRY(PGMSENSRSLT), \
          P_NAME_ENTRY(CAMSEQSTATE), \
          P_NAME_ENTRY(CAMSEQCOUNT), \
          P_NAME_ENTRY(CIRCBUFSIZE), \
          P_NAME_ENTRY(FREECIRCBUF), \
          P_NAME_ENTRY(CIRCBUFWP), \
          P_NAME_ENTRY(CIRCBUFRP), \
          P_NAME_ENTRY(TILES), \
          P_NAME_ENTRY(SENSOR_PHASE), \
          P_NAME_ENTRY(SECONDS), \
          P_NAME_ENTRY(MICROSECONDS), \
          P_NAME_ENTRY(TILES), \
          P_NAME_ENTRY(SENSOR_PHASE), \
          P_NAME_ENTRY(AUTOEXP_ON), \
          P_NAME_ENTRY(AUTOEXP_RWIDTH), \
          P_NAME_ENTRY(AUTOEXP_RHEIGHT), \
          P_NAME_ENTRY(AUTOEXP_RLEFT), \
          P_NAME_ENTRY(AUTOEXP_RTOP), \
          P_NAME_ENTRY(AUTOEXP_EXP_MAX), \
          P_NAME_ENTRY(AUTOEXP_OVEREXP_MAX), \
          P_NAME_ENTRY(AUTOEXP_S_PERCENT), \
          P_NAME_ENTRY(AUTOEXP_S_INDEX), \
          P_NAME_ENTRY(AUTOEXP_EXP), \
          P_NAME_ENTRY(AUTOEXP_SKIP_PMIN), \
          P_NAME_ENTRY(AUTOEXP_SKIP_PMAX), \
          P_NAME_ENTRY(AUTOEXP_SKIP_T), \
          P_NAME_ENTRY(AEXPWND_WIDTH), \
          P_NAME_ENTRY(AEXPWND_HEIGHT), \
          P_NAME_ENTRY(AEXPWND_TOP), \
          P_NAME_ENTRY(AEXPWND_LEFT), \
          P_NAME_ENTRY(HIST_NOT_CHANGE), \
          P_NAME_ENTRY(FOCUS_SHOW), \
          P_NAME_ENTRY(FOCUS_SHOW1), \
          P_NAME_ENTRY(FOCUS_VALUE), \
          P_NAME_ENTRY(FOCUS_LEFT), \
          P_NAME_ENTRY(FOCUS_WIDTH), \
          P_NAME_ENTRY(FOCUS_TOP), \
          P_NAME_ENTRY(FOCUS_HEIGHT), \
          P_NAME_ENTRY(FOCUS_TOTWIDTH), \
          P_NAME_ENTRY(FOCUS_FILTER), \
          P_NAME_ENTRY(TRIG_CONDITION), \
          P_NAME_ENTRY(TRIG_DELAY), \
          P_NAME_ENTRY(TRIG_OUT), \
          P_NAME_ENTRY(TRIG_PERIOD), \
          P_NAME_ENTRY(TASKLET_CTL), \
          P_NAME_ENTRY(COMPRESSOR_CMD), \
          P_NAME_ENTRY(SKIP_FRAMES), \
          P_NAME_ENTRY(I2C_QPERIOD), \
          P_NAME_ENTRY(I2C_BYTES), \
          P_NAME_ENTRY(IRQ_SMART), \
          P_NAME_ENTRY(EARLY_TIMESTAMP), \
          P_NAME_ENTRY(OVERSIZE) \
};

/* i2c errors */
#ifndef ERR_I2C_SCL_ST0
 #define        ERR_I2C_SCL_ST0          1
 #define        ERR_I2C_SDA_ST0          2
 #define        ERR_I2C_SCL_ST1          4
 #define        ERR_I2C_SDA_ST1          8
 #define        ERR_I2C_SCL_NOPULLUP 16
 #define        ERR_I2C_SDA_NOPULLUP 32

/* i2c_diagnose called by i2c_start (?) could not find any problems. Try again start */
 #define    ERR_I2C_NOTDETECTED  64
 #define        ERR_I2C_SHORT            128
 #define        ERR_I2C_BSY                  256
 #define        ERR_I2C_NACK             512
#endif


/* supported ioctl _IOC_NR's */
#define IO_CCAM_SET_EXT_EXPOSURE  0x06
#define IO_CCAM_MONITOR_SEQ       0x07

// HW configuration requests
#define IO_EXT_BOARD_PRESENT       0xF0

//#define IO_CCAM_STOP_DMA      0x08
//#define IO_CCAM_START_DMA     0x09 // just starts DMA - descriptor list should be set eatlier
//#define IO_CCAM_START_RAW     0x0a // Programs DMA descriptor list according to current frame size, FPGA registers and starts DMA


#define IO_CCAM_JPEG            0x08 // JPEG-compressor related commands
#define      JPEG_CMD_RESET     0x00 // Resets pointers - both acquisition and readout
//#define      JPEG_CMD_ARM     0x01 // Prepare compressor to read next frame acquired
#define      JPEG_CMD_GET              0x02 // Read current page (will return empty (and length==0) if not ready
#define      JPEG_CMD_FORGET        0x03 // increment read frame pointer
#define      JPEG_CMD_CATCHUP       0x04 // set read pointer to the last acquired (or acquiring if none is acquired yet)
#define      JPEG_CMD_ACQUIRE       0x05 // acquire and compress one frame
#define      JPEG_CMD_SAVE_RP       0x06 // save read pointer
#define      JPEG_CMD_RESTORE_RP  0x07 // restore read pointer
#define      JPEG_CMD_N_DONE      0x08 // return 1 if no more frames to be acquired (frame number)
#define      JPEG_CMD_L_DONE      0x09 // return 1 if no more frames to be acquired (total length)
#define      JPEG_CMD_START       0x0a // start constant compression mode
#define      JPEG_CMD_STOP        0x0b // stop constant compression mode (may want to wait for CAMSEQ_DONE)
#define      JPEG_CMD_FRAMES      0x0c // returns number of frames in buffer, (re)uilds frames chain
#define      JPEG_CMD_JUST_STOP   0x0d // just stop - don't start cycle if was allready off!
#define      JPEG_CMD_DUMP        0x0f // printk all static data/tables
#define      JPEG_CMD_RESET0      0x10 // same as JPEG_CMD_RESET, but non-zero, to be used from lseek (SEEK_END)
#define      PROGRAM_SENSOR_0     0x11 // programSensor(0) - to be used from lseek (SEEK_END)
#define      PROGRAM_SENSOR_1     0x12 // programSensor(1) - to be used from lseek (SEEK_END)
#define      LSEEK_CAMSEQSTATE    0x13 // return camSeqState - to be used from lseek (SEEK_END)
#define      LSEEK_RESET_SENSOR   0x14 // reset sensor and FPGA - next time will reprogram it
#define      LSEEK_INIT_SENSOR    0x15 // initialise SDRAM and sensor if it is not programmed yet (or reset)
#define      LSEEK_GET_FPGA_TIME  0x16 // get FPGA timer to P_SECONDS, P_MICROSECONDS
#define      LSEEK_SET_FPGA_TIME  0x17 // set FPGA timer to P_SECONDS, P_MICROSECONDS
#define      LSEEK_FLUSH_CACHE    0x18 // workaround for Axis mmap cache coherency problems - flush all cache (8KB)
#define      LSEEK_AUTOEXP_SET    0x19 // set autoexposure parameters
#define      LSEEK_AUTOEXP_GET    0x1a // copy window and exposure parameters to autoexp_state
#define      LSEEK_TRIGGER_PGM    0x1b // program trigger parameters
#define      LSEEK_I2C_PGM        0x1c // program hardware i2c speed/bytes
#define      LSEEK_IRQ_SMART_PGM  0x1d // program "smart" irq modes (+1 - wait VACT, +2 - wait dma fifo)
#define      LSEEK_EARLY_TIMESTAMP_PGM 0x1e // 1 - early timestamp in async mode, 0 (or sync) - uses start of first visible line readout
#define      JPEG_CTRL_MONOCHROME    0x400
#define      JPEG_CTRL_MONOCHROME_BLOCKED    0x1000
#define      JPEG_CTRL_NOMOSAIC    0x1000

#define IO_CCAM_JPEG_QUALITY    0x09 // Set P_QUALITY

#define IO_CCAM_JPEG_GET_N      0x0a    // get specified number of frames (will add to already asked for if any)
#define IO_CCAM_JPEG_GET_L      0x0b    // get specified length (will stop after frame if got more)

#define IO_CCAM_JPEG_CTRL       0x0c // Write JPEG control word (0x10000 - use header, LSW - other settings)
#define IO_CCAM_DMA             0x0d
  #define CCAM_DMA_CMD_STOP       0x00
  #define CCAM_DMA_CMD_START  0x01 // just starts DMA - descriptor list should be set eatlier

#define IO_CCAM_CR_MODIFY 0x0e  //(bit number)<<2 | op; op= 0 - nop, 1 - set, 2 - reset, 3 - toggle)
#define IO_CCAM_CR_SHADOW 0x0f

#define IO_CCAM_PINS_WRITE      0x20
#define IO_CCAM_PINS_READ       0x21


/* Memory mappable memory... can be mmap'd by application.
*       Contains the following layout:
*       offset                          content
*       -------------------             ---------------------
*       CCAM_MMAP_OFFSET_MMAP_HEADER    struct ccamMmapHeader + fill
*       CCAM_MMAP_OFFSET_JPEG_HEADER    jpeg header to use + fill
*       CCAM_MMAP_OFFSET_DMABUF         dma buffer, contiguous
*/

/* JPEG DMA buffer. Buffer must be a multiple of
*       64Kbyte because one dma descriptor conveniently handles that many...
*       (can not handle more than that also).
*  The #define CCAM_CHUNK_PER_DMABUF can be increased to allow acquiring
*  larger images, if system memory can be freed up elsewhere.
*  A value of 128 means 128*64Kbytes per buffer, or 8Mbyte for buffer,
*  of 16Mbyte total system memory.
*  Jpeg images rarely get as big as 4MB, but they can get bigger.
*/
#define CCAM_BYTES_PER_CHUNK  (1<<16)  /* dma buffer bytes per descriptor */
#define CCAM_DESCR_PER_CHUNK  1
/* If CCAM_CHUNK_PER_DMABUF is 100 then buffer is about 6.5 million bytes
*       which is probably bigger than any single image we'll generate,
*       and is also bigger than raw data (which is 5.5MB).
*       However, images bigger than 6.5/2 == 3.25 million bytes will
*       not be able to be double-buffered and thus will slow things down.
*/
// increasing 3 times - about 20MB
//#define CCAM_CHUNK_PER_DMABUF 102  /* no. of 64Kbyte chunks per buffer */
#define CCAM_CHUNK_PER_DMABUF 302  /* no. of 64Kbyte chunks per buffer */
#define CCAM_WORDS_PER_DMABUF (CCAM_CHUNK_PER_DMABUF<<14) /*32bit words...*/
#define CCAM_BYTES_PER_DMABUF (CCAM_CHUNK_PER_DMABUF<<16)
/*  For past compatibility, CCMA_DMA_SIZE...
*/
#define CCAM_DMA_SIZE CCAM_WORDS_PER_DMABUF
/*
*       CCAM_MMAP_OFFSET... -- offsets in bytes in memory mapped region.
*       CCAM_MMAP_SIZE -- no. of bytes to mmap.
*/       
#define CCAM_MMAP_OFFSET_MMAP_HEADER 0
#define CCAM_MMAP_OFFSET_JPEG_HEADER (PAGE_SIZE)
#define CCAM_MMAP_OFFSET_DMABUF (4*PAGE_SIZE)
#define CCAM_MMAP_SIZE (PAGE_SIZE*sizeof(long)+CCAM_BYTES_PER_DMABUF)

#define CCAM_MMAP_META 12 // extra bytes included at the end of each frame (last aligned to 32 bytes)
#define CCAM_MMAP_META_LENGTH 4 // displacement to length frame length data from the end of the 32-byte aligned frame slot
#define CCAM_MMAP_META_USEC 8 // (negative) displacement to USEC data - 20 bits (frame timestamp)
#define CCAM_MMAP_META_SEC 12 // (negative) displacement to SEC data - 32 bits (frame timestamp)

#define CX313_FPGA_TABLES_SIZE 0xC00 //=3000 bytes, 32-bit wide, LSB first, some tables use less
#define CX313_FPGA_TABLES_GAMMA 0x400 // 0x400 words gamma-correction (or arbitrary table)
#define CX313_FPGA_TABLES_FOCUS 0x800 // 15*64 16-bit words (now high 16 bits are unused)
#define CX313_FPGA_TABLES_FOCUSPARS 0xbc0 //block of focus-related parameters: left[11:0],right[11:0],top[11:0],bottom[11:0],full_width[11:0],filter_sel[3:0]





// ccamMmapHeader -- Data structure at beginning of mmap'able memory:
// this allows quick access by an application to this data.
// NOTE: this must not exceed PAGESIZE bytes since the jpeg header lives there.
struct ccamMmapHeader
{
    /* Application must not change use_header except through setting
    *  of parameters.
    */
    int use_header;     /* should jpeg header/tailer be added? */
    /* Application must not change headerSize; doing so would only
    *   confuse
    */
    int headerSize;     /* no. of bytes in jpeg header */
    /* Application may set exposureIdx and jpegIdx to any desired value
    *   when no acquisition is going on (e.g. before JPEG_CMD_ACQUIRE).
    */
    int exposureIdx;    /* incremented on every frame sync (exposure) irupt*/
    int jpegIdx;        /* incremented on every jpeg done interrupt */
    /* Data buffering info.
    *   This is readonly by application, which should use:
    *   JPEG_CMD_RESET to zero readOffset and writeOffset and buf[readOffset].
    *   JPEG_CMD_ACQUIRE to acquire image (when done, sets buf[writeOffset]
    *   and then advances writeOffset and zeroes buf[writeOffset]).
    *   JPEG_CMD_FORGET to advance readOffset.
    *
    *   readOffset and writeOffset are byte offsets from beginning of
    *   the dma buffer where one can find the respective ccamFileDataHeader.
    */
    int readOffset;     /* where we (maybe) can read next image from (bytes) */
    int writeOffset;    /* where next image will be placed at (bytes) */
    /* nfr is the number of frames left to acquire in a sequnce of frames 
    */
    int nfr;
    /* lfr is the length (in bytes) of frames left to acquire.
    *   This is a crude measurement that basically says how much of the
    *   dma buffer we're willing to consume.
    */
    int lfr;
    /* While dma of jpeg data is enabled/ongoing, jpegBusy is set nonzero.
    */
    int jpegBusy;
};

// ccamFileDataHeader -- Data structure preceding each image in dma buffer.
// (Note that the actual image may wrap around, but the 
// this struct is always placed so as to avoid wraparound and be aligned).
// Note that this does not include jpeg header or tailer, and any way
// the actual data is in parts (the offset to is given in part[i].offset,
// a byte count relative to start of dma buffer).
struct ccamFileDataHeader
{
    /* Image is not acquired / valid yet until Valid set to 1 or -1  .
    *   A value of -1 indicates buffer overflow error.
    */
    int valid;
    /* Value for "valid: (note, OVERFLOW can be recovered from) */
    #define CCAM_IMAGE_VALIDFLAG_NOTDONE 0  /* MUST be zero */
    #define CCAM_IMAGE_VALIDFLAG_DONEOK  1 
    #define CCAM_IMAGE_VALIDFLAG_OVERFLOW -1  /* buffer was too small */
    #define CCAM_IMAGE_VALIDFLAG_FATAL  -2  /* misc. unexpected error */
    /* nBytes -- Total size of image stored in dma buffer.
    *   This does not include e.g. jpeg header (or this header).
    */
    int nBytes;
    /* nBytesMax -- maximum available during acquisition.
    *   However, the last CCAM_IMAGE_OVERFLOW_BYTES bytes, if used,
    *   should be taken to indicate that an overlow occurred.
    *   The value for CCAM_IMAGE_OVERFLOW_BYTES should be large enough
    *   to accomodate various corrections without adding a bunch of extra logic.
    */
    #define CCAM_IMAGE_OVERFLOW_BYTES 512
    int nBytesMax;
    /* Offset (bytes) in dma buffer of next image header (IFF Valid is 1) */
    int nextOffset;
    /* Offset and size (bytes) in dma buffer of parts of data 
    *   However, only some part(s) may be used, skip those with zero count.
    *   Before acq is done, part[i].nBytes is maximum size of the part;
    *   after acq (when valid is set to 1) it is set to actual amount.
    *   Two parts is enough for a simple ring buffer approach.
    */
    #define CCAM_IMAGE_NPARTS_MAX 2
    struct
    {
        int offset;     /* w/in dma buffer, bytes */
        int nBytes;     /* size of this part */
    } part[CCAM_IMAGE_NPARTS_MAX];
};

// make this structure common for sensors, add fields as needed
struct sensor_t {
// sensor constants
   unsigned long  imageWidth;     //nominal image width for final images
   unsigned long  imageHeight;    //nominal image height for final images
   unsigned long  clearWidth;     //maximal clear (useful) image width
   unsigned long  clearHeight;    //maximal clear (useful) image height;
   unsigned long  clearTop;       //top margin to the first clear pixel
   unsigned long  clearLeft;      //left margin to the first clear pixel
   unsigned long  arrayWidth;     //total image array width (including black and boundary)
   unsigned long  arrayHeight;    //total image array height (including black and boundary)
   unsigned long  minWidth;       // minimal WOI width
   unsigned long  minHeight;      // minimal WOI height
   unsigned long  minHorBlank;    // minimal horizontal blanking, in pixels in no-decimation, no-binning mode.
   unsigned long  minLineDur;     // minimal total line duration, in pixels in no-decimation, no-binning mode.
   unsigned long  maxHorBlank;    // maximal horizontal blanking/Virtual frame width (depends on sensor type)
   unsigned long  minVertBlank;   // minimal vertical blanking
   unsigned long  maxVertBlank;   // maximal vertical blanking/Virtual frame height (depends on sensor type)
   unsigned long  maxShutter;     // Maximal shutter duration (in lines)
   unsigned long  flips;          // bit mask bit 0 - flipX, 1 - flipY
   unsigned long  dcmHor;         // bit mask bit 0 - 1:1, bit 31 - by 32
   unsigned long  dcmVert;        // bit mask bit 0 - 1:1, bit 31 - by 32
   unsigned long  binHor;         // bit mask bit 0 - 1:1, bit 31 - by 32
   unsigned long  binVert;        // bit mask bit 0 - 1:1, bit 31 - by 32
   unsigned long  maxGain256;     // maximal analog gain times 0x100
   unsigned long  maxClockFreq;   // Maximal clock frequency
   unsigned long  nomClockFreq;   //nominal clock frequency
   unsigned long  sensorType;     // sensor type (for Elphel cameras)
   unsigned long  i2c_addr;       // i2c address
   unsigned long  i2c_period;     // SCL period in ns, (standard i2c - 2500)
   unsigned long  i2c_bytes;      // number of bytes/ register
   unsigned long  margins;        // actually - property of FPGA code, not the sensor
   unsigned long  hact_delay;     // hact delay (in ps) from data
// dynamic variables
   unsigned long  pixelWidth;     // number of the pixels output in a line (including margins, decimation)
   unsigned long  pixelHeight;    // number of the lines output in a frame (including margins, decimation)
   unsigned short sensorPhase90;  // (0..3) 90-degree shift (fpcf -w 8 80)
   signed   short sensorPhase;    // positive "fpcf -w 8 20", negative - "fpcf -w 8 10"
};
/*!***************************************************************************************************
*! This is essential data related to the last frame aquired to be stored in the circular buffer before
*! each frame received from the FPGA - place where FPGA data is padded by 32 bytes of 0.
*! 6 bytes are already used by next frame pointer signature, so only 26 bytes are left
*! Structure also includes 8 bytes of timestamp (after 2 bytes skipped) - they will be obtained from the circbuf data
*! that goes after the encoded frame, so total is 36 bytes (26+2+8)
!****************************************************************************************************/
// move fram x353.h 
#define DEFAULT_COLOR_SATURATION_BLUE 0x90 // 100*realtive saturation blue
#define DEFAULT_COLOR_SATURATION_RED  0xb6 // 100*realtive saturation red

#define EXPOSURE_UNIT 100 // to move to finer exposure settings - current unit in microseconds. TODO: Propagate it to drivers...

// most parameters are moved out, but width, height, quolity are needed for JPEG header, so currently the following are used:
struct frame_params_t {
/*00-03*/ unsigned long  exposure;       //  currently - exposure time measured in 100usec. Really need to change it to smaller increments?
/*04-05*/ unsigned short width;          
/*06-07*/ unsigned short height;         
/*08-11*/ unsigned long  colorsat;       //  matches FPGA format , for 1.0 it is DEFAULT_COLOR_SATURATION_RED<<16 + DEFAULT_COLOR_SATURATION_BLUE
/*12   */ unsigned char  color;          //  0 - mono, 1 - color, 2 - jp4 + (0x40 - flipX) + (0x80 - flipY) 
/*13   */ unsigned char  quality;        
/*14   */ unsigned char  gamma;          //  (%), 255 - non-gamma curve, 0 - raw (16-bit data) - not yet implemented
/*15   */ unsigned char  black;          //  black level shift (255 - full scale)
/*16-17*/ unsigned short rscale;         //  8.8 - red  relative to green - "gamma" table, not sensor gain
/*18-19*/ unsigned short bscale;         //  8.8 - blue relative to green - "gamma" table, not sensor gain

/*20   */ unsigned char  gain_r;         //  color gain Red   (sensor specific), is set
/*21   */ unsigned char  gain_g;         //  color gain Green (sensor specific)
/*22   */ unsigned char  gain_b;         //  color gain Blue  (sensor specific)
/*23   */ unsigned char  gain_gb;        //  color gain Green in Blue line (sensor specific)
/*24   */
/*25   */
/*24-25*/ unsigned short meta_index;     

/*26-27*/ unsigned short signffff;       

    union {
/*28-31*/ unsigned long  timestamp_sec ; 
/*28-31*/ unsigned long  frame_length ;  
          };
/*32-35*/ unsigned long  timestamp_usec; 
};

// parameters for lseek circbuf
#define CIRCLSEEK_TORP  1
#define CIRCLSEEK_TOWP  2
#define CIRCLSEEK_PREV  3
#define CIRCLSEEK_NEXT  4
#define CIRCLSEEK_LAST  5
#define CIRCLSEEK_FIRST 6
#define CIRCLSEEK_SCND  7
#define CIRCLSEEK_SETP  8
#define CIRCLSEEK_VALID 9
#define CIRCLSEEK_READY 10
#define CIRCLSEEK_WAIT  11
#define CIRCLSEEK_FREE  12
#define CIRCLSEEK_USED  13

struct i2c_timing_t {
        unsigned char scl_high; //0x02, //! SCL high:
        unsigned char scl_low;  //0x02, //! SCL low:
        unsigned char slave2master; //0x01, //! slave -> master
        unsigned char master2slave; //0x01, //! master -> slave
        unsigned char filter_sda;   //0x07, //! filter SDA read data by testing multiple times - currently just zero/non zero
        unsigned char filter_scl;  //0x07};//! filter SCL read data by testing multiple times - currently just zero/non zero 
};


#endif /* _ASM_CMOSCAM_H */

---