1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
|
/* SPDX-License-Identifier: (GPL-2.0+ OR MIT) */
/*
* Rockchip isp1 driver
* Copyright (C) 2017 Rockchip Electronics Co., Ltd.
*/
/*
* TODO: Improve documentation, mostly regarding abbreviation and hardware
* specificities.
*/
#ifndef _RKISP1_CONFIG_H
#define _RKISP1_CONFIG_H
#include <linux/types.h>
#include <linux/v4l2-controls.h>
#define CIFISP_MODULE_DPCC (1 << 0)
#define CIFISP_MODULE_BLS (1 << 1)
#define CIFISP_MODULE_SDG (1 << 2)
#define CIFISP_MODULE_HST (1 << 3)
#define CIFISP_MODULE_LSC (1 << 4)
#define CIFISP_MODULE_AWB_GAIN (1 << 5)
#define CIFISP_MODULE_FLT (1 << 6)
#define CIFISP_MODULE_BDM (1 << 7)
#define CIFISP_MODULE_CTK (1 << 8)
#define CIFISP_MODULE_GOC (1 << 9)
#define CIFISP_MODULE_CPROC (1 << 10)
#define CIFISP_MODULE_AFC (1 << 11)
#define CIFISP_MODULE_AWB (1 << 12)
#define CIFISP_MODULE_IE (1 << 13)
#define CIFISP_MODULE_AEC (1 << 14)
#define CIFISP_MODULE_WDR (1 << 15)
#define CIFISP_MODULE_DPF (1 << 16)
#define CIFISP_MODULE_DPF_STRENGTH (1 << 17)
#define CIFISP_CTK_COEFF_MAX 0x100
#define CIFISP_CTK_OFFSET_MAX 0x800
#define CIFISP_AE_MEAN_MAX 25
#define CIFISP_HIST_BIN_N_MAX 16
#define CIFISP_AFM_MAX_WINDOWS 3
#define CIFISP_DEGAMMA_CURVE_SIZE 17
#define CIFISP_BDM_MAX_TH 0xFF
/*
* Black level compensation
*/
/* maximum value for horizontal start address */
#define CIFISP_BLS_START_H_MAX 0x00000FFF
/* maximum value for horizontal stop address */
#define CIFISP_BLS_STOP_H_MAX 0x00000FFF
/* maximum value for vertical start address */
#define CIFISP_BLS_START_V_MAX 0x00000FFF
/* maximum value for vertical stop address */
#define CIFISP_BLS_STOP_V_MAX 0x00000FFF
/* maximum is 2^18 = 262144*/
#define CIFISP_BLS_SAMPLES_MAX 0x00000012
/* maximum value for fixed black level */
#define CIFISP_BLS_FIX_SUB_MAX 0x00000FFF
/* minimum value for fixed black level */
#define CIFISP_BLS_FIX_SUB_MIN 0xFFFFF000
/* 13 bit range (signed)*/
#define CIFISP_BLS_FIX_MASK 0x00001FFF
/*
* Automatic white balance measurments
*/
#define CIFISP_AWB_MAX_GRID 1
#define CIFISP_AWB_MAX_FRAMES 7
/*
* Gamma out
*/
/* Maximum number of color samples supported */
#define CIFISP_GAMMA_OUT_MAX_SAMPLES 17
/*
* Lens shade correction
*/
#define CIFISP_LSC_GRAD_TBL_SIZE 8
#define CIFISP_LSC_SIZE_TBL_SIZE 8
/*
* The following matches the tuning process,
* not the max capabilities of the chip.
* Last value unused.
*/
#define CIFISP_LSC_DATA_TBL_SIZE 290
/*
* Histogram calculation
*/
/* Last 3 values unused. */
#define CIFISP_HISTOGRAM_WEIGHT_GRIDS_SIZE 28
/*
* Defect Pixel Cluster Correction
*/
#define CIFISP_DPCC_METHODS_MAX 3
/*
* Denoising pre filter
*/
#define CIFISP_DPF_MAX_NLF_COEFFS 17
#define CIFISP_DPF_MAX_SPATIAL_COEFFS 6
/*
* Measurement types
*/
#define CIFISP_STAT_AWB (1 << 0)
#define CIFISP_STAT_AUTOEXP (1 << 1)
#define CIFISP_STAT_AFM_FIN (1 << 2)
#define CIFISP_STAT_HIST (1 << 3)
enum cifisp_histogram_mode {
CIFISP_HISTOGRAM_MODE_DISABLE,
CIFISP_HISTOGRAM_MODE_RGB_COMBINED,
CIFISP_HISTOGRAM_MODE_R_HISTOGRAM,
CIFISP_HISTOGRAM_MODE_G_HISTOGRAM,
CIFISP_HISTOGRAM_MODE_B_HISTOGRAM,
CIFISP_HISTOGRAM_MODE_Y_HISTOGRAM
};
enum cifisp_awb_mode_type {
CIFISP_AWB_MODE_MANUAL,
CIFISP_AWB_MODE_RGB,
CIFISP_AWB_MODE_YCBCR
};
enum cifisp_flt_mode {
CIFISP_FLT_STATIC_MODE,
CIFISP_FLT_DYNAMIC_MODE
};
/**
* enum cifisp_exp_ctrl_autostop - stop modes
* @CIFISP_EXP_CTRL_AUTOSTOP_0: continuous measurement
* @CIFISP_EXP_CTRL_AUTOSTOP_1: stop measuring after a complete frame
*/
enum cifisp_exp_ctrl_autostop {
CIFISP_EXP_CTRL_AUTOSTOP_0 = 0,
CIFISP_EXP_CTRL_AUTOSTOP_1 = 1,
};
/**
* enum cifisp_exp_meas_mode - Exposure measure mode
* @CIFISP_EXP_MEASURING_MODE_0: Y = 16 + 0.25R + 0.5G + 0.1094B
* @CIFISP_EXP_MEASURING_MODE_1: Y = (R + G + B) x (85/256)
*/
enum cifisp_exp_meas_mode {
CIFISP_EXP_MEASURING_MODE_0,
CIFISP_EXP_MEASURING_MODE_1,
};
/*---------- PART1: Input Parameters ------------*/
struct cifisp_window {
__u16 h_offs;
__u16 v_offs;
__u16 h_size;
__u16 v_size;
} __attribute__ ((packed));
/**
* struct cifisp_bls_fixed_val - BLS fixed subtraction values
*
* The values will be subtracted from the sensor
* values. Therefore a negative value means addition instead of subtraction!
*
* @r: Fixed (signed!) subtraction value for Bayer pattern R
* @gr: Fixed (signed!) subtraction value for Bayer pattern Gr
* @gb: Fixed (signed!) subtraction value for Bayer pattern Gb
* @b: Fixed (signed!) subtraction value for Bayer pattern B
*/
struct cifisp_bls_fixed_val {
__s16 r;
__s16 gr;
__s16 gb;
__s16 b;
} __attribute__ ((packed));
/**
* struct cifisp_bls_config - Configuration used by black level subtraction
*
* @enable_auto: Automatic mode activated means that the measured values
* are subtracted. Otherwise the fixed subtraction
* values will be subtracted.
* @en_windows: enabled window
* @bls_window1: Measurement window 1 size
* @bls_window2: Measurement window 2 size
* @bls_samples: Set amount of measured pixels for each Bayer position
* (A, B,C and D) to 2^bls_samples.
* @cifisp_bls_fixed_val: Fixed subtraction values
*/
struct cifisp_bls_config {
__u8 enable_auto;
__u8 en_windows;
struct cifisp_window bls_window1;
struct cifisp_window bls_window2;
__u8 bls_samples;
struct cifisp_bls_fixed_val fixed_val;
} __attribute__ ((packed));
/**
* struct cifisp_dpcc_methods_config - Methods Configuration used by DPCC
*
* Methods Configuration used by Defect Pixel Cluster Correction
*
* @method: Method enable bits
* @line_thresh: Line threshold
* @line_mad_fac: Line MAD factor
* @pg_fac: Peak gradient factor
* @rnd_thresh: Rank Neighbor Difference threshold
* @rg_fac: Rank gradient factor
*/
struct cifisp_dpcc_methods_config {
__u32 method;
__u32 line_thresh;
__u32 line_mad_fac;
__u32 pg_fac;
__u32 rnd_thresh;
__u32 rg_fac;
} __attribute__ ((packed));
/**
* struct cifisp_dpcc_methods_config - Configuration used by DPCC
*
* Configuration used by Defect Pixel Cluster Correction
*
* @mode: dpcc output mode
* @output_mode: whether use hard coded methods
* @set_use: stage1 methods set
* @methods: methods config
* @ro_limits: rank order limits
* @rnd_offs: differential rank offsets for rank neighbor difference
*/
struct cifisp_dpcc_config {
__u32 mode;
__u32 output_mode;
__u32 set_use;
struct cifisp_dpcc_methods_config methods[CIFISP_DPCC_METHODS_MAX];
__u32 ro_limits;
__u32 rnd_offs;
} __attribute__ ((packed));
struct cifisp_gamma_corr_curve {
__u16 gamma_y[CIFISP_DEGAMMA_CURVE_SIZE];
} __attribute__ ((packed));
struct cifisp_gamma_curve_x_axis_pnts {
__u32 gamma_dx0;
__u32 gamma_dx1;
} __attribute__ ((packed));
/**
* struct cifisp_gamma_corr_curve - Configuration used by sensor degamma
*
* @curve_x: gamma curve point definition axis for x
* @xa_pnts: x increments
*/
struct cifisp_sdg_config {
struct cifisp_gamma_corr_curve curve_r;
struct cifisp_gamma_corr_curve curve_g;
struct cifisp_gamma_corr_curve curve_b;
struct cifisp_gamma_curve_x_axis_pnts xa_pnts;
} __attribute__ ((packed));
/**
* struct cifisp_lsc_config - Configuration used by Lens shading correction
*
* refer to REF_01 for details
*/
struct cifisp_lsc_config {
__u32 r_data_tbl[CIFISP_LSC_DATA_TBL_SIZE];
__u32 gr_data_tbl[CIFISP_LSC_DATA_TBL_SIZE];
__u32 gb_data_tbl[CIFISP_LSC_DATA_TBL_SIZE];
__u32 b_data_tbl[CIFISP_LSC_DATA_TBL_SIZE];
__u32 x_grad_tbl[CIFISP_LSC_GRAD_TBL_SIZE];
__u32 y_grad_tbl[CIFISP_LSC_GRAD_TBL_SIZE];
__u32 x_size_tbl[CIFISP_LSC_SIZE_TBL_SIZE];
__u32 y_size_tbl[CIFISP_LSC_SIZE_TBL_SIZE];
__u16 config_width;
__u16 config_height;
} __attribute__ ((packed));
/**
* struct cifisp_ie_config - Configuration used by image effects
*
* @eff_mat_1: 3x3 Matrix Coefficients for Emboss Effect 1
* @eff_mat_2: 3x3 Matrix Coefficients for Emboss Effect 2
* @eff_mat_3: 3x3 Matrix Coefficients for Emboss 3/Sketch 1
* @eff_mat_4: 3x3 Matrix Coefficients for Sketch Effect 2
* @eff_mat_5: 3x3 Matrix Coefficients for Sketch Effect 3
* @eff_tint: Chrominance increment values of tint (used for sepia effect)
*/
struct cifisp_ie_config {
__u16 effect;
__u16 color_sel;
__u16 eff_mat_1;
__u16 eff_mat_2;
__u16 eff_mat_3;
__u16 eff_mat_4;
__u16 eff_mat_5;
__u16 eff_tint;
} __attribute__ ((packed));
/**
* struct cifisp_cproc_config - Configuration used by Color Processing
*
* @c_out_range: Chrominance pixel clipping range at output.
* (0 for limit, 1 for full)
* @y_in_range: Luminance pixel clipping range at output.
* @y_out_range: Luminance pixel clipping range at output.
* @contrast: 00~ff, 0.0~1.992
* @brightness: 80~7F, -128~+127
* @sat: saturation, 00~FF, 0.0~1.992
* @hue: 80~7F, -90~+87.188
*/
struct cifisp_cproc_config {
__u8 c_out_range;
__u8 y_in_range;
__u8 y_out_range;
__u8 contrast;
__u8 brightness;
__u8 sat;
__u8 hue;
} __attribute__ ((packed));
/**
* struct cifisp_awb_meas_config - Configuration used by auto white balance
*
* @awb_wnd: white balance measurement window (in pixels)
* (from enum cifisp_awb_mode_type)
* @max_y: only pixels values < max_y contribute to awb measurement, set to 0
* to disable this feature
* @min_y: only pixels values > min_y contribute to awb measurement
* @max_csum: Chrominance sum maximum value, only consider pixels with Cb+Cr,
* smaller than threshold for awb measurements
* @min_c: Chrominance minimum value, only consider pixels with Cb/Cr
* each greater than threshold value for awb measurements
* @frames: number of frames - 1 used for mean value calculation
* (ucFrames=0 means 1 Frame)
* @awb_ref_cr: reference Cr value for AWB regulation, target for AWB
* @awb_ref_cb: reference Cb value for AWB regulation, target for AWB
*/
struct cifisp_awb_meas_config {
/*
* Note: currently the h and v offsets are mapped to grid offsets
*/
struct cifisp_window awb_wnd;
__u32 awb_mode;
__u8 max_y;
__u8 min_y;
__u8 max_csum;
__u8 min_c;
__u8 frames;
__u8 awb_ref_cr;
__u8 awb_ref_cb;
__u8 enable_ymax_cmp;
} __attribute__ ((packed));
/**
* struct cifisp_awb_gain_config - Configuration used by auto white balance gain
*
* out_data_x = ( AWB_GEAIN_X * in_data + 128) >> 8
*/
struct cifisp_awb_gain_config {
__u16 gain_red;
__u16 gain_green_r;
__u16 gain_blue;
__u16 gain_green_b;
} __attribute__ ((packed));
/**
* struct cifisp_flt_config - Configuration used by ISP filtering
*
* @mode: ISP_FILT_MODE register fields (from enum cifisp_flt_mode)
* @grn_stage1: ISP_FILT_MODE register fields
* @chr_h_mode: ISP_FILT_MODE register fields
* @chr_v_mode: ISP_FILT_MODE register fields
*
* refer to REF_01 for details.
*/
struct cifisp_flt_config {
__u32 mode;
__u8 grn_stage1;
__u8 chr_h_mode;
__u8 chr_v_mode;
__u32 thresh_bl0;
__u32 thresh_bl1;
__u32 thresh_sh0;
__u32 thresh_sh1;
__u32 lum_weight;
__u32 fac_sh1;
__u32 fac_sh0;
__u32 fac_mid;
__u32 fac_bl0;
__u32 fac_bl1;
} __attribute__ ((packed));
/**
* struct cifisp_bdm_config - Configuration used by Bayer DeMosaic
*
* @demosaic_th: threshod for bayer demosaicing texture detection
*/
struct cifisp_bdm_config {
__u8 demosaic_th;
} __attribute__ ((packed));
/**
* struct cifisp_ctk_config - Configuration used by Cross Talk correction
*
* @coeff: color correction matrix
* @ct_offset_b: offset for the crosstalk correction matrix
*/
struct cifisp_ctk_config {
__u16 coeff0;
__u16 coeff1;
__u16 coeff2;
__u16 coeff3;
__u16 coeff4;
__u16 coeff5;
__u16 coeff6;
__u16 coeff7;
__u16 coeff8;
__u16 ct_offset_r;
__u16 ct_offset_g;
__u16 ct_offset_b;
} __attribute__ ((packed));
enum cifisp_goc_mode {
CIFISP_GOC_MODE_LOGARITHMIC,
CIFISP_GOC_MODE_EQUIDISTANT
};
/**
* struct cifisp_goc_config - Configuration used by Gamma Out correction
*
* @mode: goc mode (from enum cifisp_goc_mode)
* @gamma_y: gamma out curve y-axis for all color components
*/
struct cifisp_goc_config {
__u32 mode;
__u16 gamma_y[CIFISP_GAMMA_OUT_MAX_SAMPLES];
} __attribute__ ((packed));
/**
* struct cifisp_hst_config - Configuration used by Histogram
*
* @mode: histogram mode (from enum cifisp_histogram_mode)
* @histogram_predivider: process every stepsize pixel, all other pixels are
* skipped
* @meas_window: coordinates of the measure window
* @hist_weight: weighting factor for sub-windows
*/
struct cifisp_hst_config {
__u32 mode;
__u8 histogram_predivider;
struct cifisp_window meas_window;
__u8 hist_weight[CIFISP_HISTOGRAM_WEIGHT_GRIDS_SIZE];
} __attribute__ ((packed));
/**
* struct cifisp_aec_config - Configuration used by Auto Exposure Control
*
* @mode: Exposure measure mode (from enum cifisp_exp_meas_mode)
* @autostop: stop mode (from enum cifisp_exp_ctrl_autostop)
* @meas_window: coordinates of the measure window
*/
struct cifisp_aec_config {
__u32 mode;
__u32 autostop;
struct cifisp_window meas_window;
} __attribute__ ((packed));
/**
* struct cifisp_afc_config - Configuration used by Auto Focus Control
*
* @num_afm_win: max CIFISP_AFM_MAX_WINDOWS
* @afm_win: coordinates of the meas window
* @thres: threshold used for minimizing the influence of noise
* @var_shift: the number of bits for the shift operation at the end of the
* calculation chain.
*/
struct cifisp_afc_config {
__u8 num_afm_win;
struct cifisp_window afm_win[CIFISP_AFM_MAX_WINDOWS];
__u32 thres;
__u32 var_shift;
} __attribute__ ((packed));
/**
* enum cifisp_dpf_gain_usage - dpf gain usage
* @CIFISP_DPF_GAIN_USAGE_DISABLED: don't use any gains in preprocessing stage
* @CIFISP_DPF_GAIN_USAGE_NF_GAINS: use only the noise function gains from
* registers DPF_NF_GAIN_R, ...
* @CIFISP_DPF_GAIN_USAGE_LSC_GAINS: use only the gains from LSC module
* @CIFISP_DPF_GAIN_USAGE_NF_LSC_GAINS: use the noise function gains and the
* gains from LSC module
* @CIFISP_DPF_GAIN_USAGE_AWB_GAINS: use only the gains from AWB module
* @CIFISP_DPF_GAIN_USAGE_AWB_LSC_GAINS: use the gains from AWB and LSC module
* @CIFISP_DPF_GAIN_USAGE_MAX: upper border (only for an internal evaluation)
*/
enum cifisp_dpf_gain_usage {
CIFISP_DPF_GAIN_USAGE_DISABLED,
CIFISP_DPF_GAIN_USAGE_NF_GAINS,
CIFISP_DPF_GAIN_USAGE_LSC_GAINS,
CIFISP_DPF_GAIN_USAGE_NF_LSC_GAINS,
CIFISP_DPF_GAIN_USAGE_AWB_GAINS,
CIFISP_DPF_GAIN_USAGE_AWB_LSC_GAINS,
CIFISP_DPF_GAIN_USAGE_MAX
};
/**
* enum cifisp_dpf_gain_usage - dpf gain usage
* @CIFISP_DPF_RB_FILTERSIZE_13x9: red and blue filter kernel size 13x9
* (means 7x5 active pixel)
* @CIFISP_DPF_RB_FILTERSIZE_9x9: red and blue filter kernel size 9x9
* (means 5x5 active pixel)
*/
enum cifisp_dpf_rb_filtersize {
CIFISP_DPF_RB_FILTERSIZE_13x9,
CIFISP_DPF_RB_FILTERSIZE_9x9,
};
|