drivers/gpu/drm/amd/amdkfd/kfd_crat.h

   1 /*
   2  * Copyright 2014 Advanced Micro Devices, Inc.
   3  *
   4  * Permission is hereby granted, free of charge, to any person obtaining a
   5  * copy of this software and associated documentation files (the "Software"),
   6  * to deal in the Software without restriction, including without limitation
   7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
   8  * and/or sell copies of the Software, and to permit persons to whom the
   9  * Software is furnished to do so, subject to the following conditions:
  10  *
  11  * The above copyright notice and this permission notice shall be included in
  12  * all copies or substantial portions of the Software.
  13  *
  14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  15  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  17  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
  18  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  19  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  20  * OTHER DEALINGS IN THE SOFTWARE.
  21  */
  22
  23 #ifndef KFD_CRAT_H_INCLUDED
  24 #define KFD_CRAT_H_INCLUDED
  25
  26 #include <linux/types.h>
  27
  28 #pragma pack(1)
  29
  30 /*
  31  * 4CC signature values for the CRAT and CDIT ACPI tables
  32  */
  33
  34 #define CRAT_SIGNATURE  "CRAT"
  35 #define CDIT_SIGNATURE  "CDIT"
  36
  37 /*
  38  * Component Resource Association Table (CRAT)
  39  */
  40
  41 #define CRAT_OEMID_LENGTH       6
  42 #define CRAT_OEMTABLEID_LENGTH  8
  43 #define CRAT_RESERVED_LENGTH    6
  44
  45 #define CRAT_OEMID_64BIT_MASK ((1ULL << (CRAT_OEMID_LENGTH * 8)) - 1)
  46
  47 struct crat_header {
  48         uint32_t        signature;
  49         uint32_t        length;
  50         uint8_t         revision;
  51         uint8_t         checksum;
  52         uint8_t         oem_id[CRAT_OEMID_LENGTH];
  53         uint8_t         oem_table_id[CRAT_OEMTABLEID_LENGTH];
  54         uint32_t        oem_revision;
  55         uint32_t        creator_id;
  56         uint32_t        creator_revision;
  57         uint32_t        total_entries;
  58         uint16_t        num_domains;
  59         uint8_t         reserved[CRAT_RESERVED_LENGTH];
  60 };
  61
  62 /*
  63  * The header structure is immediately followed by total_entries of the
  64  * data definitions
  65  */
  66
  67 /*
  68  * The currently defined subtype entries in the CRAT
  69  */
  70 #define CRAT_SUBTYPE_COMPUTEUNIT_AFFINITY       0
  71 #define CRAT_SUBTYPE_MEMORY_AFFINITY            1
  72 #define CRAT_SUBTYPE_CACHE_AFFINITY             2
  73 #define CRAT_SUBTYPE_TLB_AFFINITY               3
  74 #define CRAT_SUBTYPE_CCOMPUTE_AFFINITY          4
  75 #define CRAT_SUBTYPE_IOLINK_AFFINITY            5
  76 #define CRAT_SUBTYPE_MAX                        6
  77
  78 #define CRAT_SIBLINGMAP_SIZE    32
  79
  80 /*
  81  * ComputeUnit Affinity structure and definitions
  82  */
  83 #define CRAT_CU_FLAGS_ENABLED           0x00000001
  84 #define CRAT_CU_FLAGS_HOT_PLUGGABLE     0x00000002
  85 #define CRAT_CU_FLAGS_CPU_PRESENT       0x00000004
  86 #define CRAT_CU_FLAGS_GPU_PRESENT       0x00000008
  87 #define CRAT_CU_FLAGS_IOMMU_PRESENT     0x00000010
  88 #define CRAT_CU_FLAGS_RESERVED          0xffffffe0
  89
  90 #define CRAT_COMPUTEUNIT_RESERVED_LENGTH 4
  91
  92 struct crat_subtype_computeunit {
  93         uint8_t         type;
  94         uint8_t         length;
  95         uint16_t        reserved;
  96         uint32_t        flags;
  97         uint32_t        proximity_domain;
  98         uint32_t        processor_id_low;
  99         uint16_t        num_cpu_cores;
 100         uint16_t        num_simd_cores;
 101         uint16_t        max_waves_simd;
 102         uint16_t        io_count;
 103         uint16_t        hsa_capability;
 104         uint16_t        lds_size_in_kb;
 105         uint8_t         wave_front_size;
 106         uint8_t         num_banks;
 107         uint16_t        micro_engine_id;
 108         uint8_t         num_arrays;
 109         uint8_t         num_cu_per_array;
 110         uint8_t         num_simd_per_cu;
 111         uint8_t         max_slots_scatch_cu;
 112         uint8_t         reserved2[CRAT_COMPUTEUNIT_RESERVED_LENGTH];
 113 };
 114
 115 /*
 116  * HSA Memory Affinity structure and definitions
 117  */
 118 #define CRAT_MEM_FLAGS_ENABLED          0x00000001
 119 #define CRAT_MEM_FLAGS_HOT_PLUGGABLE    0x00000002
 120 #define CRAT_MEM_FLAGS_NON_VOLATILE     0x00000004
 121 #define CRAT_MEM_FLAGS_RESERVED         0xfffffff8
 122
 123 #define CRAT_MEMORY_RESERVED_LENGTH 8
 124
 125 struct crat_subtype_memory {
 126         uint8_t         type;
 127         uint8_t         length;
 128         uint16_t        reserved;
 129         uint32_t        flags;
 130         uint32_t        promixity_domain;
 131         uint32_t        base_addr_low;
 132         uint32_t        base_addr_high;
 133         uint32_t        length_low;
 134         uint32_t        length_high;
 135         uint32_t        width;
 136         uint8_t         reserved2[CRAT_MEMORY_RESERVED_LENGTH];
 137 };
 138
 139 /*
 140  * HSA Cache Affinity structure and definitions
 141  */
 142 #define CRAT_CACHE_FLAGS_ENABLED        0x00000001
 143 #define CRAT_CACHE_FLAGS_DATA_CACHE     0x00000002
 144 #define CRAT_CACHE_FLAGS_INST_CACHE     0x00000004
 145 #define CRAT_CACHE_FLAGS_CPU_CACHE      0x00000008
 146 #define CRAT_CACHE_FLAGS_SIMD_CACHE     0x00000010
 147 #define CRAT_CACHE_FLAGS_RESERVED       0xffffffe0
 148
 149 #define CRAT_CACHE_RESERVED_LENGTH 8
 150
 151 struct crat_subtype_cache {
 152         uint8_t         type;
 153         uint8_t         length;
 154         uint16_t        reserved;
 155         uint32_t        flags;
 156         uint32_t        processor_id_low;
 157         uint8_t         sibling_map[CRAT_SIBLINGMAP_SIZE];
 158         uint32_t        cache_size;
 159         uint8_t         cache_level;
 160         uint8_t         lines_per_tag;
 161         uint16_t        cache_line_size;
 162         uint8_t         associativity;
 163         uint8_t         cache_properties;
 164         uint16_t        cache_latency;
 165         uint8_t         reserved2[CRAT_CACHE_RESERVED_LENGTH];
 166 };
 167
 168 /*
 169  * HSA TLB Affinity structure and definitions
 170  */
 171 #define CRAT_TLB_FLAGS_ENABLED  0x00000001
 172 #define CRAT_TLB_FLAGS_DATA_TLB 0x00000002
 173 #define CRAT_TLB_FLAGS_INST_TLB 0x00000004
 174 #define CRAT_TLB_FLAGS_CPU_TLB  0x00000008
 175 #define CRAT_TLB_FLAGS_SIMD_TLB 0x00000010
 176 #define CRAT_TLB_FLAGS_RESERVED 0xffffffe0
 177
 178 #define CRAT_TLB_RESERVED_LENGTH 4
 179
 180 struct crat_subtype_tlb {
 181         uint8_t         type;
 182         uint8_t         length;
 183         uint16_t        reserved;
 184         uint32_t        flags;
 185         uint32_t        processor_id_low;
 186         uint8_t         sibling_map[CRAT_SIBLINGMAP_SIZE];
 187         uint32_t        tlb_level;
 188         uint8_t         data_tlb_associativity_2mb;
 189         uint8_t         data_tlb_size_2mb;
 190         uint8_t         instruction_tlb_associativity_2mb;
 191         uint8_t         instruction_tlb_size_2mb;
 192         uint8_t         data_tlb_associativity_4k;
 193         uint8_t         data_tlb_size_4k;
 194         uint8_t         instruction_tlb_associativity_4k;
 195         uint8_t         instruction_tlb_size_4k;
 196         uint8_t         data_tlb_associativity_1gb;
 197         uint8_t         data_tlb_size_1gb;
 198         uint8_t         instruction_tlb_associativity_1gb;
 199         uint8_t         instruction_tlb_size_1gb;
 200         uint8_t         reserved2[CRAT_TLB_RESERVED_LENGTH];
 201 };
 202
 203 /*
 204  * HSA CCompute/APU Affinity structure and definitions
 205  */
 206 #define CRAT_CCOMPUTE_FLAGS_ENABLED     0x00000001
 207 #define CRAT_CCOMPUTE_FLAGS_RESERVED    0xfffffffe
 208
 209 #define CRAT_CCOMPUTE_RESERVED_LENGTH 16
 210
 211 struct crat_subtype_ccompute {
 212         uint8_t         type;
 213         uint8_t         length;
 214         uint16_t        reserved;
 215         uint32_t        flags;
 216         uint32_t        processor_id_low;
 217         uint8_t         sibling_map[CRAT_SIBLINGMAP_SIZE];
 218         uint32_t        apu_size;
 219         uint8_t         reserved2[CRAT_CCOMPUTE_RESERVED_LENGTH];
 220 };
 221
 222 /*
 223  * HSA IO Link Affinity structure and definitions
 224  */
 225 #define CRAT_IOLINK_FLAGS_ENABLED       0x00000001
 226 #define CRAT_IOLINK_FLAGS_COHERENCY     0x00000002
 227 #define CRAT_IOLINK_FLAGS_RESERVED      0xfffffffc
 228
 229 /*
 230  * IO interface types
 231  */
 232 #define CRAT_IOLINK_TYPE_UNDEFINED      0
 233 #define CRAT_IOLINK_TYPE_HYPERTRANSPORT 1
 234 #define CRAT_IOLINK_TYPE_PCIEXPRESS     2
 235 #define CRAT_IOLINK_TYPE_OTHER          3
 236 #define CRAT_IOLINK_TYPE_MAX            255
 237
 238 #define CRAT_IOLINK_RESERVED_LENGTH 24
 239
 240 struct crat_subtype_iolink {
 241         uint8_t         type;
 242         uint8_t         length;
 243         uint16_t        reserved;
 244         uint32_t        flags;
 245         uint32_t        proximity_domain_from;
 246         uint32_t        proximity_domain_to;
 247         uint8_t         io_interface_type;
 248         uint8_t         version_major;
 249         uint16_t        version_minor;
 250         uint32_t        minimum_latency;
 251         uint32_t        maximum_latency;
 252         uint32_t        minimum_bandwidth_mbs;
 253         uint32_t        maximum_bandwidth_mbs;
 254         uint32_t        recommended_transfer_size;
 255         uint8_t         reserved2[CRAT_IOLINK_RESERVED_LENGTH];
 256 };
 257
 258 /*
 259  * HSA generic sub-type header
 260  */
 261
 262 #define CRAT_SUBTYPE_FLAGS_ENABLED 0x00000001
 263
 264 struct crat_subtype_generic {
 265         uint8_t         type;
 266         uint8_t         length;
 267         uint16_t        reserved;
 268         uint32_t        flags;
 269 };
 270
 271 /*
 272  * Component Locality Distance Information Table (CDIT)
 273  */
 274 #define CDIT_OEMID_LENGTH       6
 275 #define CDIT_OEMTABLEID_LENGTH  8
 276
 277 struct cdit_header {
 278         uint32_t        signature;
 279         uint32_t        length;
 280         uint8_t         revision;
 281         uint8_t         checksum;
 282         uint8_t         oem_id[CDIT_OEMID_LENGTH];
 283         uint8_t         oem_table_id[CDIT_OEMTABLEID_LENGTH];
 284         uint32_t        oem_revision;
 285         uint32_t        creator_id;
 286         uint32_t        creator_revision;
 287         uint32_t        total_entries;
 288         uint16_t        num_domains;
 289         uint8_t         entry[1];
 290 };
 291
 292 #pragma pack()
 293
 294 #endif /* KFD_CRAT_H_INCLUDED */