root/drivers/gpu/ipu-v3/ipu-ic-csc.c

DEFINITIONS

1. calc_csc_coeffs
2. __ipu_ic_calc_csc
3. ipu_ic_calc_csc

   1 // SPDX-License-Identifier: GPL-2.0+
   2 /*
   3  * Copyright (C) 2019 Mentor Graphics Inc.
   4  */
   5 
   6 #include <linux/types.h>
   7 #include <linux/init.h>
   8 #include <linux/errno.h>
   9 #include <linux/err.h>
  10 #include <linux/sizes.h>
  11 #include "ipu-prv.h"
  12 
  13 #define QUANT_MAP(q)                                    \
  14         ((q) == V4L2_QUANTIZATION_FULL_RANGE ||         \
  15          (q) == V4L2_QUANTIZATION_DEFAULT ? 0 : 1)
  16 
  17 /* identity matrix */
  18 static const struct ipu_ic_csc_params identity = {
  19         .coeff = {
  20                 {  128,    0,    0, },
  21                 {    0,  128,    0, },
  22                 {    0,    0,  128, },
  23         },
  24         .offset = { 0, 0, 0, },
  25         .scale = 2,
  26 };
  27 
  28 /*
  29  * RGB full-range to RGB limited-range
  30  *
  31  * R_lim = 0.8588 * R_full + 16
  32  * G_lim = 0.8588 * G_full + 16
  33  * B_lim = 0.8588 * B_full + 16
  34  */
  35 static const struct ipu_ic_csc_params rgbf2rgbl = {
  36         .coeff = {
  37                 {  220,    0,    0, },
  38                 {    0,  220,    0, },
  39                 {    0,    0,  220, },
  40         },
  41         .offset = { 64, 64, 64, },
  42         .scale = 1,
  43 };
  44 
  45 /*
  46  * RGB limited-range to RGB full-range
  47  *
  48  * R_full = 1.1644 * (R_lim - 16)
  49  * G_full = 1.1644 * (G_lim - 16)
  50  * B_full = 1.1644 * (B_lim - 16)
  51  */
  52 static const struct ipu_ic_csc_params rgbl2rgbf = {
  53         .coeff = {
  54                 {  149,    0,    0, },
  55                 {    0,  149,    0, },
  56                 {    0,    0,  149, },
  57         },
  58         .offset = { -37, -37, -37, },
  59         .scale = 2,
  60 };
  61 
  62 /*
  63  * YUV full-range to YUV limited-range
  64  *
  65  * Y_lim  = 0.8588 * Y_full + 16
  66  * Cb_lim = 0.8784 * (Cb_full - 128) + 128
  67  * Cr_lim = 0.8784 * (Cr_full - 128) + 128
  68  */
  69 static const struct ipu_ic_csc_params yuvf2yuvl = {
  70         .coeff = {
  71                 {  220,    0,    0, },
  72                 {    0,  225,    0, },
  73                 {    0,    0,  225, },
  74         },
  75         .offset = { 64, 62, 62, },
  76         .scale = 1,
  77         .sat = true,
  78 };
  79 
  80 /*
  81  * YUV limited-range to YUV full-range
  82  *
  83  * Y_full  = 1.1644 * (Y_lim - 16)
  84  * Cb_full = 1.1384 * (Cb_lim - 128) + 128
  85  * Cr_full = 1.1384 * (Cr_lim - 128) + 128
  86  */
  87 static const struct ipu_ic_csc_params yuvl2yuvf = {
  88         .coeff = {
  89                 {  149,    0,    0, },
  90                 {    0,  146,    0, },
  91                 {    0,    0,  146, },
  92         },
  93         .offset = { -37, -35, -35, },
  94         .scale = 2,
  95 };
  96 
  97 static const struct ipu_ic_csc_params *rgb2rgb[] = {
  98         &identity,
  99         &rgbf2rgbl,
 100         &rgbl2rgbf,
 101         &identity,
 102 };
 103 
 104 static const struct ipu_ic_csc_params *yuv2yuv[] = {
 105         &identity,
 106         &yuvf2yuvl,
 107         &yuvl2yuvf,
 108         &identity,
 109 };
 110 
 111 /*
 112  * BT.601 RGB full-range to YUV full-range
 113  *
 114  * Y =  .2990 * R + .5870 * G + .1140 * B
 115  * U = -.1687 * R - .3313 * G + .5000 * B + 128
 116  * V =  .5000 * R - .4187 * G - .0813 * B + 128
 117  */
 118 static const struct ipu_ic_csc_params rgbf2yuvf_601 = {
 119         .coeff = {
 120                 {   77,  150,   29, },
 121                 {  -43,  -85,  128, },
 122                 {  128, -107,  -21, },
 123         },
 124         .offset = { 0, 512, 512, },
 125         .scale = 1,
 126 };
 127 
 128 /* BT.601 RGB full-range to YUV limited-range */
 129 static const struct ipu_ic_csc_params rgbf2yuvl_601 = {
 130         .coeff = {
 131                 {   66,  129,   25, },
 132                 {  -38,  -74,  112, },
 133                 {  112,  -94,  -18, },
 134         },
 135         .offset = { 64, 512, 512, },
 136         .scale = 1,
 137         .sat = true,
 138 };
 139 
 140 /* BT.601 RGB limited-range to YUV full-range */
 141 static const struct ipu_ic_csc_params rgbl2yuvf_601 = {
 142         .coeff = {
 143                 {   89,  175,   34, },
 144                 {  -50,  -99,  149, },
 145                 {  149, -125,  -24, },
 146         },
 147         .offset = { -75, 512, 512, },
 148         .scale = 1,
 149 };
 150 
 151 /* BT.601 RGB limited-range to YUV limited-range */
 152 static const struct ipu_ic_csc_params rgbl2yuvl_601 = {
 153         .coeff = {
 154                 {   77,  150,   29, },
 155                 {  -44,  -87,  131, },
 156                 {  131, -110,  -21, },
 157         },
 158         .offset = { 0, 512, 512, },
 159         .scale = 1,
 160         .sat = true,
 161 };
 162 
 163 /*
 164  * BT.601 YUV full-range to RGB full-range
 165  *
 166  * R = 1. * Y +      0 * (Cb - 128) + 1.4020 * (Cr - 128)
 167  * G = 1. * Y -  .3441 * (Cb - 128) -  .7141 * (Cr - 128)
 168  * B = 1. * Y + 1.7720 * (Cb - 128) +      0 * (Cr - 128)
 169  *
 170  * equivalently (factoring out the offsets):
 171  *
 172  * R = 1. * Y  +      0 * Cb + 1.4020 * Cr - 179.456
 173  * G = 1. * Y  -  .3441 * Cb -  .7141 * Cr + 135.450
 174  * B = 1. * Y  + 1.7720 * Cb +      0 * Cr - 226.816
 175  */
 176 static const struct ipu_ic_csc_params yuvf2rgbf_601 = {
 177         .coeff = {
 178                 {  128,    0,  179, },
 179                 {  128,  -44,  -91, },
 180                 {  128,  227,    0, },
 181         },
 182         .offset = { -359, 271, -454, },
 183         .scale = 2,
 184 };
 185 
 186 /* BT.601 YUV full-range to RGB limited-range */
 187 static const struct ipu_ic_csc_params yuvf2rgbl_601 = {
 188         .coeff = {
 189                 {  110,    0,  154, },
 190                 {  110,  -38,  -78, },
 191                 {  110,  195,    0, },
 192         },
 193         .offset = { -276, 265, -358, },
 194         .scale = 2,
 195 };
 196 
 197 /* BT.601 YUV limited-range to RGB full-range */
 198 static const struct ipu_ic_csc_params yuvl2rgbf_601 = {
 199         .coeff = {
 200                 {   75,    0,  102, },
 201                 {   75,  -25,  -52, },
 202                 {   75,  129,    0, },
 203         },
 204         .offset = { -223, 136, -277, },
 205         .scale = 3,
 206 };
 207 
 208 /* BT.601 YUV limited-range to RGB limited-range */
 209 static const struct ipu_ic_csc_params yuvl2rgbl_601 = {
 210         .coeff = {
 211                 {  128,    0,  175, },
 212                 {  128,  -43,  -89, },
 213                 {  128,  222,    0, },
 214         },
 215         .offset = { -351, 265, -443, },
 216         .scale = 2,
 217 };
 218 
 219 static const struct ipu_ic_csc_params *rgb2yuv_601[] = {
 220         &rgbf2yuvf_601,
 221         &rgbf2yuvl_601,
 222         &rgbl2yuvf_601,
 223         &rgbl2yuvl_601,
 224 };
 225 
 226 static const struct ipu_ic_csc_params *yuv2rgb_601[] = {
 227         &yuvf2rgbf_601,
 228         &yuvf2rgbl_601,
 229         &yuvl2rgbf_601,
 230         &yuvl2rgbl_601,
 231 };
 232 
 233 /*
 234  * REC.709 encoding from RGB full range to YUV full range:
 235  *
 236  * Y =  .2126 * R + .7152 * G + .0722 * B
 237  * U = -.1146 * R - .3854 * G + .5000 * B + 128
 238  * V =  .5000 * R - .4542 * G - .0458 * B + 128
 239  */
 240 static const struct ipu_ic_csc_params rgbf2yuvf_709 = {
 241         .coeff = {
 242                 {  54,  183,  19 },
 243                 { -29,  -99, 128 },
 244                 { 128, -116, -12 },
 245         },
 246         .offset = { 0, 512, 512 },
 247         .scale = 1,
 248 };
 249 
 250 /* Rec.709 RGB full-range to YUV limited-range */
 251 static const struct ipu_ic_csc_params rgbf2yuvl_709 = {
 252         .coeff = {
 253                 {   47,  157,   16, },
 254                 {  -26,  -87,  112, },
 255                 {  112, -102,  -10, },
 256         },
 257         .offset = { 64, 512, 512, },
 258         .scale = 1,
 259         .sat = true,
 260 };
 261 
 262 /* Rec.709 RGB limited-range to YUV full-range */
 263 static const struct ipu_ic_csc_params rgbl2yuvf_709 = {
 264         .coeff = {
 265                 {   63,  213,   22, },
 266                 {  -34, -115,  149, },
 267                 {  149, -135,  -14, },
 268         },
 269         .offset = { -75, 512, 512, },
 270         .scale = 1,
 271 };
 272 
 273 /* Rec.709 RGB limited-range to YUV limited-range */
 274 static const struct ipu_ic_csc_params rgbl2yuvl_709 = {
 275         .coeff = {
 276                 {   54,  183,   18, },
 277                 {  -30, -101,  131, },
 278                 {  131, -119,  -12, },
 279         },
 280         .offset = { 0, 512, 512, },
 281         .scale = 1,
 282         .sat = true,
 283 };
 284 
 285 /*
 286  * Inverse REC.709 encoding from YUV full range to RGB full range:
 287  *
 288  * R = 1. * Y +      0 * (Cb - 128) + 1.5748 * (Cr - 128)
 289  * G = 1. * Y -  .1873 * (Cb - 128) -  .4681 * (Cr - 128)
 290  * B = 1. * Y + 1.8556 * (Cb - 128) +      0 * (Cr - 128)
 291  *
 292  * equivalently (factoring out the offsets):
 293  *
 294  * R = 1. * Y  +      0 * Cb + 1.5748 * Cr - 201.574
 295  * G = 1. * Y  -  .1873 * Cb -  .4681 * Cr +  83.891
 296  * B = 1. * Y  + 1.8556 * Cb +      0 * Cr - 237.517
 297  */
 298 static const struct ipu_ic_csc_params yuvf2rgbf_709 = {
 299         .coeff = {
 300                 {  128,   0, 202 },
 301                 {  128, -24, -60 },
 302                 {  128, 238,   0 },
 303         },
 304         .offset = { -403, 168, -475 },
 305         .scale = 2,
 306 };
 307 
 308 /* Rec.709 YUV full-range to RGB limited-range */
 309 static const struct ipu_ic_csc_params yuvf2rgbl_709 = {
 310         .coeff = {
 311                 {  110,    0,  173, },
 312                 {  110,  -21,  -51, },
 313                 {  110,  204,    0, },
 314         },
 315         .offset = { -314, 176, -376, },
 316         .scale = 2,
 317 };
 318 
 319 /* Rec.709 YUV limited-range to RGB full-range */
 320 static const struct ipu_ic_csc_params yuvl2rgbf_709 = {
 321         .coeff = {
 322                 {   75,    0,  115, },
 323                 {   75,  -14,  -34, },
 324                 {   75,  135,    0, },
 325         },
 326         .offset = { -248, 77, -289, },
 327         .scale = 3,
 328 };
 329 
 330 /* Rec.709 YUV limited-range to RGB limited-range */
 331 static const struct ipu_ic_csc_params yuvl2rgbl_709 = {
 332         .coeff = {
 333                 {  128,    0,  197, },
 334                 {  128,  -23,  -59, },
 335                 {  128,  232,    0, },
 336         },
 337         .offset = { -394, 164, -464, },
 338         .scale = 2,
 339 };
 340 
 341 static const struct ipu_ic_csc_params *rgb2yuv_709[] = {
 342         &rgbf2yuvf_709,
 343         &rgbf2yuvl_709,
 344         &rgbl2yuvf_709,
 345         &rgbl2yuvl_709,
 346 };
 347 
 348 static const struct ipu_ic_csc_params *yuv2rgb_709[] = {
 349         &yuvf2rgbf_709,
 350         &yuvf2rgbl_709,
 351         &yuvl2rgbf_709,
 352         &yuvl2rgbl_709,
 353 };
 354 
 355 static int calc_csc_coeffs(struct ipu_ic_csc *csc)
 356 {
 357         const struct ipu_ic_csc_params **params_tbl;
 358         int tbl_idx;
 359 
 360         tbl_idx = (QUANT_MAP(csc->in_cs.quant) << 1) |
 361                 QUANT_MAP(csc->out_cs.quant);
 362 
 363         if (csc->in_cs.cs == csc->out_cs.cs) {
 364                 csc->params = (csc->in_cs.cs == IPUV3_COLORSPACE_YUV) ?
 365                         *yuv2yuv[tbl_idx] : *rgb2rgb[tbl_idx];
 366 
 367                 return 0;
 368         }
 369 
 370         /* YUV <-> RGB encoding is required */
 371 
 372         switch (csc->out_cs.enc) {
 373         case V4L2_YCBCR_ENC_601:
 374                 params_tbl = (csc->in_cs.cs == IPUV3_COLORSPACE_YUV) ?
 375                         yuv2rgb_601 : rgb2yuv_601;
 376                 break;
 377         case V4L2_YCBCR_ENC_709:
 378                 params_tbl = (csc->in_cs.cs == IPUV3_COLORSPACE_YUV) ?
 379                         yuv2rgb_709 : rgb2yuv_709;
 380                 break;
 381         default:
 382                 return -ENOTSUPP;
 383         }
 384 
 385         csc->params = *params_tbl[tbl_idx];
 386 
 387         return 0;
 388 }
 389 
 390 int __ipu_ic_calc_csc(struct ipu_ic_csc *csc)
 391 {
 392         return calc_csc_coeffs(csc);
 393 }
 394 EXPORT_SYMBOL_GPL(__ipu_ic_calc_csc);
 395 
 396 int ipu_ic_calc_csc(struct ipu_ic_csc *csc,
 397                     enum v4l2_ycbcr_encoding in_enc,
 398                     enum v4l2_quantization in_quant,
 399                     enum ipu_color_space in_cs,
 400                     enum v4l2_ycbcr_encoding out_enc,
 401                     enum v4l2_quantization out_quant,
 402                     enum ipu_color_space out_cs)
 403 {
 404         ipu_ic_fill_colorspace(&csc->in_cs, in_enc, in_quant, in_cs);
 405         ipu_ic_fill_colorspace(&csc->out_cs, out_enc, out_quant, out_cs);
 406 
 407         return __ipu_ic_calc_csc(csc);
 408 }
 409 EXPORT_SYMBOL_GPL(ipu_ic_calc_csc);