src/gallium/drivers/panfrost/midgard/midgard.h

   1 /* Author(s):
   2  *   Connor Abbott
   3  *   Alyssa Rosenzweig
   4  *
   5  * Copyright (c) 2013 Connor Abbott (connor@abbott.cx)
   6  * Copyright (c) 2018 Alyssa Rosenzweig (alyssa@rosenzweig.io)
   7  *
   8  * Permission is hereby granted, free of charge, to any person obtaining a copy
   9  * of this software and associated documentation files (the "Software"), to deal
  10  * in the Software without restriction, including without limitation the rights
  11  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  12  * copies of the Software, and to permit persons to whom the Software is
  13  * furnished to do so, subject to the following conditions:
  14  *
  15  * The above copyright notice and this permission notice shall be included in
  16  * all copies or substantial portions of the Software.
  17  *
  18  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  19  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  20  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  21  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  22  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  23  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  24  * THE SOFTWARE.
  25  */
  26
  27 #ifndef __midgard_h__
  28 #define __midgard_h__
  29
  30 #include <stdint.h>
  31 #include <stdbool.h>
  32
  33 #define MIDGARD_DBG_MSGS                0x0001
  34 #define MIDGARD_DBG_SHADERS             0x0002
  35
  36 extern int midgard_debug;
  37
  38 typedef enum {
  39         midgard_word_type_alu,
  40         midgard_word_type_load_store,
  41         midgard_word_type_texture,
  42         midgard_word_type_unknown
  43 } midgard_word_type;
  44
  45 typedef enum {
  46         midgard_alu_vmul,
  47         midgard_alu_sadd,
  48         midgard_alu_smul,
  49         midgard_alu_vadd,
  50         midgard_alu_lut
  51 } midgard_alu;
  52
  53 /*
  54  * ALU words
  55  */
  56
  57 typedef enum {
  58         midgard_alu_op_fadd       = 0x10,
  59         midgard_alu_op_fmul       = 0x14,
  60         midgard_alu_op_fmin       = 0x28,
  61         midgard_alu_op_fmax       = 0x2C,
  62         midgard_alu_op_fmov       = 0x30,
  63         midgard_alu_op_froundeven = 0x34,
  64         midgard_alu_op_ftrunc     = 0x35,
  65         midgard_alu_op_ffloor     = 0x36,
  66         midgard_alu_op_fceil      = 0x37,
  67         midgard_alu_op_ffma       = 0x38,
  68         midgard_alu_op_fdot3      = 0x3C,
  69         midgard_alu_op_fdot3r     = 0x3D,
  70         midgard_alu_op_fdot4      = 0x3E,
  71         midgard_alu_op_freduce    = 0x3F,
  72         midgard_alu_op_iadd       = 0x40,
  73         midgard_alu_op_ishladd    = 0x41,
  74         midgard_alu_op_isub       = 0x46,
  75         midgard_alu_op_imul       = 0x58,
  76         midgard_alu_op_imin       = 0x60,
  77         midgard_alu_op_imax       = 0x62,
  78         midgard_alu_op_iasr       = 0x68,
  79         midgard_alu_op_ilsr       = 0x69,
  80         midgard_alu_op_ishl       = 0x6E,
  81         midgard_alu_op_iand       = 0x70,
  82         midgard_alu_op_ior        = 0x71,
  83         midgard_alu_op_inot       = 0x72,
  84         midgard_alu_op_iandnot    = 0x74, /* (a, b) -> a & ~b, used for not/b2f */
  85         midgard_alu_op_ixor       = 0x76,
  86         midgard_alu_op_imov       = 0x7B,
  87         midgard_alu_op_iabs       = 0x7C,
  88         midgard_alu_op_feq        = 0x80,
  89         midgard_alu_op_fne        = 0x81,
  90         midgard_alu_op_flt        = 0x82,
  91         midgard_alu_op_fle        = 0x83,
  92         midgard_alu_op_fball_eq   = 0x88,
  93         midgard_alu_op_bball_eq   = 0x89,
  94         midgard_alu_op_fball_lt   = 0x8A, /* all(lessThan(.., ..)) */
  95         midgard_alu_op_fball_lte  = 0x8B, /* all(lessThanEqual(.., ..)) */
  96         midgard_alu_op_bbany_neq  = 0x90, /* used for bvec4(1) */
  97         midgard_alu_op_fbany_neq  = 0x91, /* bvec4(0) also */
  98         midgard_alu_op_fbany_lt   = 0x92, /* any(lessThan(.., ..)) */
  99         midgard_alu_op_fbany_lte  = 0x93, /* any(lessThanEqual(.., ..)) */
 100         midgard_alu_op_f2i        = 0x99,
 101         midgard_alu_op_f2u8       = 0x9C,
 102         midgard_alu_op_f2u        = 0x9D,
 103
 104         midgard_alu_op_ieq        = 0xA0,
 105         midgard_alu_op_ine        = 0xA1,
 106         midgard_alu_op_ult        = 0xA2,
 107         midgard_alu_op_ule        = 0xA3,
 108         midgard_alu_op_ilt        = 0xA4,
 109         midgard_alu_op_ile        = 0xA5,
 110         midgard_alu_op_iball_eq   = 0xA8,
 111         midgard_alu_op_ball       = 0xA9,
 112         midgard_alu_op_uball_lt   = 0xAA,
 113         midgard_alu_op_uball_lte  = 0xAB,
 114         midgard_alu_op_iball_lt   = 0xAC,
 115         midgard_alu_op_iball_lte  = 0xAD,
 116         midgard_alu_op_ibany_eq   = 0xB0,
 117         midgard_alu_op_ibany_neq  = 0xB1,
 118         midgard_alu_op_ubany_lt   = 0xB2,
 119         midgard_alu_op_ubany_lte  = 0xB3,
 120         midgard_alu_op_ibany_lt   = 0xB4, /* any(lessThan(.., ..)) */
 121         midgard_alu_op_ibany_lte  = 0xB5, /* any(lessThanEqual(.., ..)) */
 122         midgard_alu_op_i2f        = 0xB8,
 123         midgard_alu_op_u2f        = 0xBC,
 124         midgard_alu_op_icsel      = 0xC1,
 125         midgard_alu_op_fcsel_i    = 0xC4,
 126         midgard_alu_op_fcsel      = 0xC5,
 127         midgard_alu_op_fround     = 0xC6,
 128         midgard_alu_op_fatan_pt2  = 0xE8,
 129         midgard_alu_op_fpow_pt1   = 0xEC,
 130         midgard_alu_op_frcp       = 0xF0,
 131         midgard_alu_op_frsqrt     = 0xF2,
 132         midgard_alu_op_fsqrt      = 0xF3,
 133         midgard_alu_op_fexp2      = 0xF4,
 134         midgard_alu_op_flog2      = 0xF5,
 135         midgard_alu_op_fsin       = 0xF6,
 136         midgard_alu_op_fcos       = 0xF7,
 137         midgard_alu_op_fatan2_pt1 = 0xF9,
 138 } midgard_alu_op;
 139
 140 typedef enum {
 141         midgard_outmod_none = 0,
 142         midgard_outmod_pos  = 1,
 143         midgard_outmod_int  = 2,
 144         midgard_outmod_sat  = 3
 145 } midgard_outmod;
 146
 147 typedef enum {
 148         midgard_reg_mode_quarter = 0,
 149         midgard_reg_mode_half = 1,
 150         midgard_reg_mode_full = 2,
 151         midgard_reg_mode_double = 3 /* TODO: verify */
 152 } midgard_reg_mode;
 153
 154 typedef enum {
 155         midgard_dest_override_lower = 0,
 156         midgard_dest_override_upper = 1,
 157         midgard_dest_override_none = 2
 158 } midgard_dest_override;
 159
 160 typedef struct
 161 __attribute__((__packed__))
 162 {
 163         bool abs         : 1;
 164         bool negate      : 1;
 165
 166         /* replicate lower half if dest = half, or low/high half selection if
 167          * dest = full
 168          */
 169         bool rep_low     : 1;
 170         bool rep_high    : 1; /* unused if dest = full */
 171         bool half        : 1; /* only matters if dest = full */
 172         unsigned swizzle : 8;
 173 }
 174 midgard_vector_alu_src;
 175
 176 typedef struct
 177 __attribute__((__packed__))
 178 {
 179         midgard_alu_op op               :  8;
 180         midgard_reg_mode reg_mode   :  2;
 181         unsigned src1 : 13;
 182         unsigned src2 : 13;
 183         midgard_dest_override dest_override : 2;
 184         midgard_outmod outmod               : 2;
 185         unsigned mask                           : 8;
 186 }
 187 midgard_vector_alu;
 188
 189 typedef struct
 190 __attribute__((__packed__))
 191 {
 192         bool abs           : 1;
 193         bool negate        : 1;
 194         bool full          : 1; /* 0 = half, 1 = full */
 195         unsigned component : 3;
 196 }
 197 midgard_scalar_alu_src;
 198
 199 typedef struct
 200 __attribute__((__packed__))
 201 {
 202         midgard_alu_op op         :  8;
 203         unsigned src1             :  6;
 204         unsigned src2             : 11;
 205         unsigned unknown          :  1;
 206         midgard_outmod outmod :  2;
 207         bool output_full          :  1;
 208         unsigned output_component :  3;
 209 }
 210 midgard_scalar_alu;
 211
 212 typedef struct
 213 __attribute__((__packed__))
 214 {
 215         unsigned src1_reg : 5;
 216         unsigned src2_reg : 5;
 217         unsigned out_reg  : 5;
 218         bool src2_imm     : 1;
 219 }
 220 midgard_reg_info;
 221
 222 typedef enum {
 223         midgard_jmp_writeout_op_branch_uncond = 1,
 224         midgard_jmp_writeout_op_branch_cond = 2,
 225         midgard_jmp_writeout_op_discard = 4,
 226         midgard_jmp_writeout_op_writeout = 7,
 227 } midgard_jmp_writeout_op;
 228
 229 typedef enum {
 230         midgard_condition_write0 = 0,
 231         midgard_condition_false = 1,
 232         midgard_condition_true = 2,
 233         midgard_condition_always = 3, /* Special for writeout/uncond discard */
 234 } midgard_condition;
 235
 236 typedef struct
 237 __attribute__((__packed__))
 238 {
 239         midgard_jmp_writeout_op op : 3; /* == branch_uncond */
 240         unsigned dest_tag : 4; /* tag of branch destination */
 241         unsigned unknown : 2;
 242         int offset : 7;
 243 }
 244 midgard_branch_uncond;
 245
 246 typedef struct
 247 __attribute__((__packed__))
 248 {
 249         midgard_jmp_writeout_op op : 3; /* == branch_cond */
 250         unsigned dest_tag : 4; /* tag of branch destination */
 251         int offset : 7;
 252         midgard_condition cond : 2;
 253 }
 254 midgard_branch_cond;
 255
 256 typedef struct
 257 __attribute__((__packed__))
 258 {
 259         midgard_jmp_writeout_op op : 3; /* == branch_cond */
 260         unsigned dest_tag : 4; /* tag of branch destination */
 261         unsigned unknown : 2;
 262         signed offset : 23;
 263         unsigned cond : 16;
 264 }
 265 midgard_branch_extended;
 266
 267 typedef struct
 268 __attribute__((__packed__))
 269 {
 270         midgard_jmp_writeout_op op : 3; /* == writeout */
 271         unsigned unknown : 13;
 272 }
 273 midgard_writeout;
 274
 275 /*
 276  * Load/store words
 277  */
 278
 279 typedef enum {
 280         midgard_op_ld_st_noop   = 0x03,
 281         midgard_op_load_attr_16 = 0x95,
 282         midgard_op_load_attr_32 = 0x94,
 283         midgard_op_load_vary_16 = 0x99,
 284         midgard_op_load_vary_32 = 0x98,
 285         midgard_op_load_color_buffer_16 = 0x9D,
 286         midgard_op_load_color_buffer_8 = 0xBA,
 287         midgard_op_load_uniform_16 = 0xAC,
 288         midgard_op_load_uniform_32 = 0xB0,
 289         midgard_op_store_vary_16 = 0xD5,
 290         midgard_op_store_vary_32 = 0xD4
 291 } midgard_load_store_op;
 292
 293 typedef enum {
 294         midgard_interp_centroid = 1,
 295         midgard_interp_default = 2
 296 } midgard_interpolation;
 297
 298 typedef struct
 299 __attribute__((__packed__))
 300 {
 301         unsigned zero1 : 4; /* Always zero */
 302
 303         /* Varying qualifiers, zero if not a varying */
 304         unsigned flat    : 1;
 305         unsigned is_varying : 1; /* Always one for varying, but maybe something else? */
 306         midgard_interpolation interpolation : 2;
 307
 308         unsigned zero2 : 2; /* Always zero */
 309 }
 310 midgard_varying_parameter;
 311
 312 typedef struct
 313 __attribute__((__packed__))
 314 {
 315         midgard_load_store_op op : 8;
 316         unsigned reg     : 5;
 317         unsigned mask    : 4;
 318         unsigned swizzle : 8;
 319         unsigned unknown : 16;
 320
 321         unsigned varying_parameters : 10;
 322
 323         unsigned address : 9;
 324 }
 325 midgard_load_store_word;
 326
 327 typedef struct
 328 __attribute__((__packed__))
 329 {
 330         unsigned type      : 4;
 331         unsigned next_type : 4;
 332         uint64_t word1     : 60;
 333         uint64_t word2     : 60;
 334 }
 335 midgard_load_store;
 336
 337 /* Texture pipeline results are in r28-r29 */
 338 #define REG_TEX_BASE 28
 339
 340 /* Texture opcodes... maybe? */
 341 #define TEXTURE_OP_NORMAL 0x11
 342 #define TEXTURE_OP_TEXEL_FETCH 0x14
 343
 344 /* Texture format types, found in format */
 345 #define TEXTURE_CUBE 0x00
 346 #define TEXTURE_2D 0x02
 347 #define TEXTURE_3D 0x03
 348
 349 typedef struct
 350 __attribute__((__packed__))
 351 {
 352         unsigned type      : 4;
 353         unsigned next_type : 4;
 354
 355         unsigned op  : 6;
 356         unsigned shadow    : 1;
 357         unsigned unknown3  : 1;
 358
 359         /* A little obscure, but last is set for the last texture operation in
 360          * a shader. cont appears to just be last's opposite (?). Yeah, I know,
 361          * kind of funky.. BiOpen thinks it could do with memory hinting, or
 362          * tile locking? */
 363
 364         unsigned cont  : 1;
 365         unsigned last  : 1;
 366
 367         unsigned format    : 5;
 368         unsigned has_offset : 1;
 369
 370         /* Like in Bifrost */
 371         unsigned filter  : 1;
 372
 373         unsigned in_reg_select : 1;
 374         unsigned in_reg_upper  : 1;
 375
 376         unsigned in_reg_swizzle_left : 2;
 377         unsigned in_reg_swizzle_right : 2;
 378
 379         unsigned unknown1 : 2;
 380
 381         unsigned unknown8  : 4;
 382
 383         unsigned out_full  : 1;
 384
 385         /* Always 1 afaict... */
 386         unsigned unknown7  : 2;
 387
 388         unsigned out_reg_select : 1;
 389         unsigned out_upper : 1;
 390
 391         unsigned mask : 4;
 392
 393         unsigned unknown2  : 2;
 394
 395         unsigned swizzle  : 8;
 396         unsigned unknown4  : 8;
 397
 398         unsigned unknownA  : 4;
 399
 400         unsigned offset_unknown1  : 1;
 401         unsigned offset_reg_select : 1;
 402         unsigned offset_reg_upper : 1;
 403         unsigned offset_unknown4  : 1;
 404         unsigned offset_unknown5  : 1;
 405         unsigned offset_unknown6  : 1;
 406         unsigned offset_unknown7  : 1;
 407         unsigned offset_unknown8  : 1;
 408         unsigned offset_unknown9  : 1;
 409
 410         unsigned unknownB  : 3;
 411
 412         /* Texture bias or LOD, depending on whether it is executed in a
 413          * fragment/vertex shader respectively. Compute as int(2^8 * biasf).
 414          *
 415          * For texel fetch, this is the LOD as is. */
 416         unsigned bias  : 8;
 417
 418         unsigned unknown9  : 8;
 419
 420         unsigned texture_handle : 16;
 421         unsigned sampler_handle : 16;
 422 }
 423 midgard_texture_word;
 424
 425 /* Opcode name table */
 426
 427 static char *alu_opcode_names[256] = {
 428         [midgard_alu_op_fadd]       = "fadd",
 429         [midgard_alu_op_fmul]       = "fmul",
 430         [midgard_alu_op_fmin]       = "fmin",
 431         [midgard_alu_op_fmax]       = "fmax",
 432         [midgard_alu_op_fmov]       = "fmov",
 433         [midgard_alu_op_froundeven] = "froundeven",
 434         [midgard_alu_op_ftrunc]     = "ftrunc",
 435         [midgard_alu_op_ffloor]     = "ffloor",
 436         [midgard_alu_op_fceil]      = "fceil",
 437         [midgard_alu_op_ffma]       = "ffma",
 438         [midgard_alu_op_fdot3]      = "fdot3",
 439         [midgard_alu_op_fdot3r]     = "fdot3r",
 440         [midgard_alu_op_fdot4]      = "fdot4",
 441         [midgard_alu_op_freduce]    = "freduce",
 442         [midgard_alu_op_imin]       = "imin",
 443         [midgard_alu_op_imax]       = "imax",
 444         [midgard_alu_op_ishl]       = "ishl",
 445         [midgard_alu_op_iasr]       = "iasr",
 446         [midgard_alu_op_ilsr]       = "ilsr",
 447         [midgard_alu_op_iadd]       = "iadd",
 448         [midgard_alu_op_ishladd]    = "ishladd",
 449         [midgard_alu_op_isub]       = "isub",
 450         [midgard_alu_op_imul]       = "imul",
 451         [midgard_alu_op_imov]       = "imov",
 452         [midgard_alu_op_iabs]       = "iabs",
 453         [midgard_alu_op_iand]       = "iand",
 454         [midgard_alu_op_ior]        = "ior",
 455         [midgard_alu_op_inot]       = "inot",
 456         [midgard_alu_op_iandnot]    = "iandnot",
 457         [midgard_alu_op_ixor]       = "ixor",
 458         [midgard_alu_op_feq]        = "feq",
 459         [midgard_alu_op_fne]        = "fne",
 460         [midgard_alu_op_flt]        = "flt",
 461         [midgard_alu_op_fle]        = "fle",
 462         [midgard_alu_op_fball_eq]   = "fball_eq",
 463         [midgard_alu_op_fbany_neq]  = "fbany_neq",
 464         [midgard_alu_op_bball_eq]   = "bball_eq",
 465         [midgard_alu_op_fball_lt]   = "fball_lt",
 466         [midgard_alu_op_fball_lte]  = "fball_lte",
 467         [midgard_alu_op_bbany_neq]  = "bbany_neq",
 468         [midgard_alu_op_fbany_lt]   = "fbany_lt",
 469         [midgard_alu_op_fbany_lte]  = "fbany_lte",
 470         [midgard_alu_op_f2i]        = "f2i",
 471         [midgard_alu_op_f2u]        = "f2u",
 472         [midgard_alu_op_f2u8]       = "f2u8",
 473         [midgard_alu_op_ieq]        = "ieq",
 474         [midgard_alu_op_ine]        = "ine",
 475         [midgard_alu_op_ult]        = "ult",
 476         [midgard_alu_op_ule]        = "ule",
 477         [midgard_alu_op_ilt]        = "ilt",
 478         [midgard_alu_op_ile]        = "ile",
 479         [midgard_alu_op_iball_eq]   = "iball_eq",
 480         [midgard_alu_op_ball]       = "ball",
 481         [midgard_alu_op_uball_lt]   = "uball_lt",
 482         [midgard_alu_op_uball_lte]  = "uball_lte",
 483         [midgard_alu_op_iball_lt]   = "iball_lt",
 484         [midgard_alu_op_iball_lte]  = "iball_lte",
 485         [midgard_alu_op_iball_eq]   = "iball_eq",
 486         [midgard_alu_op_ibany_neq]  = "ibany_neq",
 487         [midgard_alu_op_ubany_lt]   = "ubany_lt",
 488         [midgard_alu_op_ubany_lte]  = "ubany_lte",
 489         [midgard_alu_op_ibany_lt]   = "ibany_lt",
 490         [midgard_alu_op_ibany_lte]  = "ibany_lte",
 491         [midgard_alu_op_i2f]        = "i2f",
 492         [midgard_alu_op_u2f]        = "u2f",
 493         [midgard_alu_op_icsel]      = "icsel",
 494         [midgard_alu_op_fcsel_i]    = "fcsel_i",
 495         [midgard_alu_op_fcsel]      = "fcsel",
 496         [midgard_alu_op_fround]     = "fround",
 497         [midgard_alu_op_fatan_pt2]  = "fatan_pt2",
 498         [midgard_alu_op_frcp]       = "frcp",
 499         [midgard_alu_op_frsqrt]     = "frsqrt",
 500         [midgard_alu_op_fsqrt]      = "fsqrt",
 501         [midgard_alu_op_fpow_pt1]   = "fpow_pt1",
 502         [midgard_alu_op_fexp2]      = "fexp2",
 503         [midgard_alu_op_flog2]      = "flog2",
 504         [midgard_alu_op_fsin]       = "fsin",
 505         [midgard_alu_op_fcos]       = "fcos",
 506         [midgard_alu_op_fatan2_pt1] = "fatan2_pt1"
 507 };
 508
 509 static char *load_store_opcode_names[256] = {
 510         [midgard_op_load_attr_16] = "ld_attr_16",
 511         [midgard_op_load_attr_32] = "ld_attr_32",
 512         [midgard_op_load_vary_16] = "ld_vary_16",
 513         [midgard_op_load_vary_32] = "ld_vary_32",
 514         [midgard_op_load_uniform_16] = "ld_uniform_16",
 515         [midgard_op_load_uniform_32] = "ld_uniform_32",
 516         [midgard_op_load_color_buffer_8] = "ld_color_buffer_8",
 517         [midgard_op_load_color_buffer_16] = "ld_color_buffer_16",
 518         [midgard_op_store_vary_16] = "st_vary_16",
 519         [midgard_op_store_vary_32] = "st_vary_32"
 520 };
 521
 522 #endif