sys/dev/sfxge/common/ef10_tlv_layout.h

   1 /*-
   2  * Copyright (c) 2012-2016 Solarflare Communications Inc.
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions are met:
   7  *
   8  * 1. Redistributions of source code must retain the above copyright notice,
   9  *    this list of conditions and the following disclaimer.
  10  * 2. Redistributions in binary form must reproduce the above copyright notice,
  11  *    this list of conditions and the following disclaimer in the documentation
  12  *    and/or other materials provided with the distribution.
  13  *
  14  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  15  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
  16  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  17  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
  18  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  19  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  20  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
  21  * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
  22  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
  23  * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
  24  * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  25  *
  26  * The views and conclusions contained in the software and documentation are
  27  * those of the authors and should not be interpreted as representing official
  28  * policies, either expressed or implied, of the FreeBSD Project.
  29  *
  30  * $FreeBSD$
  31  */
  32
  33 /* These structures define the layouts for the TLV items stored in static and
  34  * dynamic configuration partitions in NVRAM for EF10 (Huntington etc.).
  35  *
  36  * They contain the same sort of information that was kept in the
  37  * siena_mc_static_config_hdr_t and siena_mc_dynamic_config_hdr_t structures
  38  * (defined in <ci/mgmt/mc_flash_layout.h> and <ci/mgmt/mc_dynamic_cfg.h>) for
  39  * Siena.
  40  *
  41  * These are used directly by the MC and should also be usable directly on host
  42  * systems which are little-endian and do not do strange things with structure
  43  * padding.  (Big-endian host systems will require some byte-swapping.)
  44  *
  45  *                                    -----
  46  *
  47  * Please refer to SF-108797-SW for a general overview of the TLV partition
  48  * format.
  49  *
  50  *                                    -----
  51  *
  52  * The current tag IDs have a general structure: with the exception of the
  53  * special values defined in the document, they are of the form 0xLTTTNNNN,
  54  * where:
  55  *
  56  *   -  L is a location, indicating where this tag is expected to be found:
  57  *        0: static configuration
  58  *        1: dynamic configuration
  59  *        2: firmware internal use
  60  *        3: license partition
  61  *
  62  *   -  TTT is a type, which is just a unique value.  The same type value
  63  *      might appear in both locations, indicating a relationship between
  64  *      the items (e.g. static and dynamic VPD below).
  65  *
  66  *   -  NNNN is an index of some form.  Some item types are per-port, some
  67  *      are per-PF, some are per-partition-type.
  68  *
  69  *                                    -----
  70  *
  71  * As with the previous Siena structures, each structure here is laid out
  72  * carefully: values are aligned to their natural boundary, with explicit
  73  * padding fields added where necessary.  (No, technically this does not
  74  * absolutely guarantee portability.  But, in practice, compilers are generally
  75  * sensible enough not to introduce completely pointless padding, and it works
  76  * well enough.)
  77  */
  78
  79
  80 #ifndef CI_MGMT_TLV_LAYOUT_H
  81 #define CI_MGMT_TLV_LAYOUT_H
  82
  83
  84 /* ----------------------------------------------------------------------------
  85  *  General structure (defined by SF-108797-SW)
  86  * ----------------------------------------------------------------------------
  87  */
  88
  89
  90 /* The "end" tag.
  91  *
  92  * (Note that this is *not* followed by length or value fields: anything after
  93  * the tag itself is irrelevant.)
  94  */
  95
  96 #define TLV_TAG_END                     (0xEEEEEEEE)
  97
  98
  99 /* Other special reserved tag values.
 100  */
 101
 102 #define TLV_TAG_SKIP                    (0x00000000)
 103 #define TLV_TAG_INVALID                 (0xFFFFFFFF)
 104
 105
 106 /* TLV partition header.
 107  *
 108  * In a TLV partition, this must be the first item in the sequence, at offset
 109  * 0.
 110  */
 111
 112 #define TLV_TAG_PARTITION_HEADER        (0xEF10DA7A)
 113
 114 struct tlv_partition_header {
 115   uint32_t tag;
 116   uint32_t length;
 117   uint16_t type_id;
 118 /* 0 indicates the default segment (always located at offset 0), while other values
 119  * are for RFID-selectable presets that should immediately follow the default segment.
 120  * The default segment may also have preset > 0, which means that it is a preset
 121  * selected through an RFID command and copied by FW to the location at offset 0. */
 122   uint16_t preset;
 123   uint32_t generation;
 124   uint32_t total_length;
 125 };
 126
 127
 128 /* TLV partition trailer.
 129  *
 130  * In a TLV partition, this must be the last item in the sequence, immediately
 131  * preceding the TLV_TAG_END word.
 132  */
 133
 134 #define TLV_TAG_PARTITION_TRAILER       (0xEF101A57)
 135
 136 struct tlv_partition_trailer {
 137   uint32_t tag;
 138   uint32_t length;
 139   uint32_t generation;
 140   uint32_t checksum;
 141 };
 142
 143
 144 /* Appendable TLV partition header.
 145  *
 146  * In an appendable TLV partition, this must be the first item in the sequence,
 147  * at offset 0.  (Note that, unlike the configuration partitions, there is no
 148  * trailer before the TLV_TAG_END word.)
 149  */
 150
 151 #define TLV_TAG_APPENDABLE_PARTITION_HEADER (0xEF10ADA7)
 152
 153 struct tlv_appendable_partition_header {
 154   uint32_t tag;
 155   uint32_t length;
 156   uint16_t type_id;
 157   uint16_t reserved;
 158 };
 159
 160
 161 /* ----------------------------------------------------------------------------
 162  *  Configuration items
 163  * ----------------------------------------------------------------------------
 164  */
 165
 166
 167 /* NIC global capabilities.
 168  */
 169
 170 #define TLV_TAG_GLOBAL_CAPABILITIES     (0x00010000)
 171
 172 struct tlv_global_capabilities {
 173   uint32_t tag;
 174   uint32_t length;
 175   uint32_t flags;
 176 };
 177
 178
 179 /* Siena-style per-port MAC address allocation.
 180  *
 181  * There are <count> addresses, starting at <base_address> and incrementing
 182  * by adding <stride> to the low-order byte(s).
 183  *
 184  * (See also TLV_TAG_GLOBAL_MAC for an alternative, specifying a global pool
 185  * of contiguous MAC addresses for the firmware to allocate as it sees fit.)
 186  */
 187
 188 #define TLV_TAG_PORT_MAC(port)          (0x00020000 + (port))
 189
 190 struct tlv_port_mac {
 191   uint32_t tag;
 192   uint32_t length;
 193   uint8_t  base_address[6];
 194   uint16_t reserved;
 195   uint16_t count;
 196   uint16_t stride;
 197 };
 198
 199
 200 /* Static VPD.
 201  *
 202  * This is the portion of VPD which is set at manufacturing time and not
 203  * expected to change.  It is formatted as a standard PCI VPD block. There are
 204  * global and per-pf TLVs for this, the global TLV is new for Medford and is
 205  * used in preference to the per-pf TLV.
 206  */
 207
 208 #define TLV_TAG_PF_STATIC_VPD(pf)       (0x00030000 + (pf))
 209
 210 struct tlv_pf_static_vpd {
 211   uint32_t tag;
 212   uint32_t length;
 213   uint8_t  bytes[];
 214 };
 215
 216 #define TLV_TAG_GLOBAL_STATIC_VPD       (0x001f0000)
 217
 218 struct tlv_global_static_vpd {
 219   uint32_t tag;
 220   uint32_t length;
 221   uint8_t  bytes[];
 222 };
 223
 224
 225 /* Dynamic VPD.
 226  *
 227  * This is the portion of VPD which may be changed (e.g. by firmware updates).
 228  * It is formatted as a standard PCI VPD block. There are global and per-pf TLVs
 229  * for this, the global TLV is new for Medford and is used in preference to the
 230  * per-pf TLV.
 231  */
 232
 233 #define TLV_TAG_PF_DYNAMIC_VPD(pf)      (0x10030000 + (pf))
 234
 235 struct tlv_pf_dynamic_vpd {
 236   uint32_t tag;
 237   uint32_t length;
 238   uint8_t  bytes[];
 239 };
 240
 241 #define TLV_TAG_GLOBAL_DYNAMIC_VPD      (0x10200000)
 242
 243 struct tlv_global_dynamic_vpd {
 244   uint32_t tag;
 245   uint32_t length;
 246   uint8_t  bytes[];
 247 };
 248
 249
 250 /* "DBI" PCI config space changes.
 251  *
 252  * This is a set of edits made to the default PCI config space values before
 253  * the device is allowed to enumerate. There are global and per-pf TLVs for
 254  * this, the global TLV is new for Medford and is used in preference to the
 255  * per-pf TLV.
 256  */
 257
 258 #define TLV_TAG_PF_DBI(pf)              (0x00040000 + (pf))
 259
 260 struct tlv_pf_dbi {
 261   uint32_t tag;
 262   uint32_t length;
 263   struct {
 264     uint16_t addr;
 265     uint16_t byte_enables;
 266     uint32_t value;
 267   } items[];
 268 };
 269
 270
 271 #define TLV_TAG_GLOBAL_DBI              (0x00210000)
 272
 273 struct tlv_global_dbi {
 274   uint32_t tag;
 275   uint32_t length;
 276   struct {
 277     uint16_t addr;
 278     uint16_t byte_enables;
 279     uint32_t value;
 280   } items[];
 281 };
 282
 283
 284 /* Partition subtype codes.
 285  *
 286  * A subtype may optionally be stored for each type of partition present in
 287  * the NVRAM.  For example, this may be used to allow a generic firmware update
 288  * utility to select a specific variant of firmware for a specific variant of
 289  * board.
 290  *
 291  * The description[] field is an optional string which is returned in the
 292  * MC_CMD_NVRAM_METADATA response if present.
 293  */
 294
 295 #define TLV_TAG_PARTITION_SUBTYPE(type) (0x00050000 + (type))
 296
 297 struct tlv_partition_subtype {
 298   uint32_t tag;
 299   uint32_t length;
 300   uint32_t subtype;
 301   uint8_t  description[];
 302 };
 303
 304
 305 /* Partition version codes.
 306  *
 307  * A version may optionally be stored for each type of partition present in
 308  * the NVRAM.  This provides a standard way of tracking the currently stored
 309  * version of each of the various component images.
 310  */
 311
 312 #define TLV_TAG_PARTITION_VERSION(type) (0x10060000 + (type))
 313
 314 struct tlv_partition_version {
 315   uint32_t tag;
 316   uint32_t length;
 317   uint16_t version_w;
 318   uint16_t version_x;
 319   uint16_t version_y;
 320   uint16_t version_z;
 321 };
 322
 323 /* Global PCIe configuration */
 324
 325 #define TLV_TAG_GLOBAL_PCIE_CONFIG (0x10070000)
 326
 327 struct tlv_pcie_config {
 328   uint32_t tag;
 329   uint32_t length;
 330   int16_t max_pf_number;                        /**< Largest PF RID (lower PFs may be hidden) */
 331   uint16_t pf_aper;                             /**< BIU aperture for PF BAR2 */
 332   uint16_t vf_aper;                             /**< BIU aperture for VF BAR0 */
 333   uint16_t int_aper;                            /**< BIU aperture for PF BAR4 and VF BAR2 */
 334 #define TLV_MAX_PF_DEFAULT (-1)                 /* Use FW default for largest PF RID  */
 335 #define TLV_APER_DEFAULT (0xFFFF)               /* Use FW default for a given aperture */
 336 };
 337
 338 /* Per-PF configuration. Note that not all these fields are necessarily useful
 339  * as the apertures are constrained by the BIU settings (the one case we do
 340  * use is to make BAR2 bigger than the BIU thinks to reserve space), but we can
 341  * tidy things up later */
 342
 343 #define TLV_TAG_PF_PCIE_CONFIG(pf)  (0x10080000 + (pf))
 344
 345 struct tlv_per_pf_pcie_config {
 346   uint32_t tag;
 347   uint32_t length;
 348   uint8_t vfs_total;
 349   uint8_t port_allocation;
 350   uint16_t vectors_per_pf;
 351   uint16_t vectors_per_vf;
 352   uint8_t pf_bar0_aperture;
 353   uint8_t pf_bar2_aperture;
 354   uint8_t vf_bar0_aperture;
 355   uint8_t vf_base;
 356   uint16_t supp_pagesz;
 357   uint16_t msix_vec_base;
 358 };
 359
 360
 361 /* Development ONLY. This is a single TLV tag for all the gubbins
 362  * that can be set through the MC command-line other than the PCIe
 363  * settings. This is a temporary measure. */
 364 #define TLV_TAG_TMP_GUBBINS (0x10090000)        /* legacy symbol - do not use */
 365 #define TLV_TAG_TMP_GUBBINS_HUNT TLV_TAG_TMP_GUBBINS
 366
 367 struct tlv_tmp_gubbins {
 368   uint32_t tag;
 369   uint32_t length;
 370   /* Consumed by dpcpu.c */
 371   uint64_t tx0_tags;     /* Bitmap */
 372   uint64_t tx1_tags;     /* Bitmap */
 373   uint64_t dl_tags;      /* Bitmap */
 374   uint32_t flags;
 375 #define TLV_DPCPU_TX_STRIPE (1) /* No longer used, has no effect */
 376 #define TLV_DPCPU_BIU_TAGS  (2) /* Use BIU tag manager */
 377 #define TLV_DPCPU_TX0_TAGS  (4) /* tx0_tags is valid */
 378 #define TLV_DPCPU_TX1_TAGS  (8) /* tx1_tags is valid */
 379 #define TLV_DPCPU_DL_TAGS  (16) /* dl_tags is valid */
 380   /* Consumed by features.c */
 381   uint32_t dut_features;        /* All 1s -> leave alone */
 382   int8_t with_rmon;             /* 0 -> off, 1 -> on, -1 -> leave alone */
 383   /* Consumed by clocks_hunt.c */
 384   int8_t clk_mode;             /* 0 -> off, 1 -> on, -1 -> leave alone */
 385   /* No longer used, superseded by TLV_TAG_DESCRIPTOR_CACHE_CONFIG. */
 386   int8_t rx_dc_size;           /* -1 -> leave alone */
 387   int8_t tx_dc_size;
 388   int16_t num_q_allocs;
 389 };
 390
 391 /* Global port configuration
 392  *
 393  * This is now deprecated in favour of a platform-provided default
 394  * and dynamic config override via tlv_global_port_options.
 395  */
 396 #define TLV_TAG_GLOBAL_PORT_CONFIG      (0x000a0000)
 397
 398 struct tlv_global_port_config {
 399   uint32_t tag;
 400   uint32_t length;
 401   uint32_t ports_per_core;
 402   uint32_t max_port_speed;
 403 };
 404
 405
 406 /* Firmware options.
 407  *
 408  * This is intended for user-configurable selection of optional firmware
 409  * features and variants.
 410  *
 411  * Initially, this consists only of the satellite CPU firmware variant
 412  * selection, but this tag could be extended in the future (using the
 413  * tag length to determine whether additional fields are present).
 414  */
 415
 416 #define TLV_TAG_FIRMWARE_OPTIONS        (0x100b0000)
 417
 418 struct tlv_firmware_options {
 419   uint32_t tag;
 420   uint32_t length;
 421   uint32_t firmware_variant;
 422 #define TLV_FIRMWARE_VARIANT_DRIVER_SELECTED (0xffffffff)
 423
 424 /* These are the values for overriding the driver's choice; the definitions
 425  * are taken from MCDI so that they don't get out of step.  Include
 426  * <ci/mgmt/mc_driver_pcol.h> or the equivalent from your driver's tree if
 427  * you need to use these constants.
 428  */
 429 #define TLV_FIRMWARE_VARIANT_FULL_FEATURED   MC_CMD_FW_FULL_FEATURED
 430 #define TLV_FIRMWARE_VARIANT_LOW_LATENCY     MC_CMD_FW_LOW_LATENCY
 431 #define TLV_FIRMWARE_VARIANT_PACKED_STREAM   MC_CMD_FW_PACKED_STREAM
 432 #define TLV_FIRMWARE_VARIANT_HIGH_TX_RATE    MC_CMD_FW_HIGH_TX_RATE
 433 #define TLV_FIRMWARE_VARIANT_PACKED_STREAM_HASH_MODE_1 \
 434                                              MC_CMD_FW_PACKED_STREAM_HASH_MODE_1
 435 #define TLV_FIRMWARE_VARIANT_RULES_ENGINE    MC_CMD_FW_RULES_ENGINE
 436 };
 437
 438 /* Voltage settings
 439  *
 440  * Intended for boards with A0 silicon where the core voltage may
 441  * need tweaking. Most likely set once when the pass voltage is
 442  * determined. */
 443
 444 #define TLV_TAG_0V9_SETTINGS (0x000c0000)
 445
 446 struct tlv_0v9_settings {
 447   uint32_t tag;
 448   uint32_t length;
 449   uint16_t flags; /* Boards with high 0v9 settings may need active cooling */
 450 #define TLV_TAG_0V9_REQUIRES_FAN (1)
 451   uint16_t target_voltage; /* In millivolts */
 452   /* Since the limits are meant to be centred to the target (and must at least
 453    * contain it) they need setting as well. */
 454   uint16_t warn_low;       /* In millivolts */
 455   uint16_t warn_high;      /* In millivolts */
 456   uint16_t panic_low;      /* In millivolts */
 457   uint16_t panic_high;     /* In millivolts */
 458 };
 459
 460
 461 /* Clock configuration */
 462
 463 #define TLV_TAG_CLOCK_CONFIG       (0x000d0000) /* legacy symbol - do not use */
 464 #define TLV_TAG_CLOCK_CONFIG_HUNT  TLV_TAG_CLOCK_CONFIG
 465
 466 struct tlv_clock_config {
 467   uint32_t tag;
 468   uint32_t length;
 469   uint16_t clk_sys;        /* MHz */
 470   uint16_t clk_dpcpu;      /* MHz */
 471   uint16_t clk_icore;      /* MHz */
 472   uint16_t clk_pcs;        /* MHz */
 473 };
 474
 475 #define TLV_TAG_CLOCK_CONFIG_MEDFORD      (0x00100000)
 476
 477 struct tlv_clock_config_medford {
 478   uint32_t tag;
 479   uint32_t length;
 480   uint16_t clk_sys;        /* MHz */
 481   uint16_t clk_mc;         /* MHz */
 482   uint16_t clk_rmon;       /* MHz */
 483   uint16_t clk_vswitch;    /* MHz */
 484   uint16_t clk_dpcpu;      /* MHz */
 485   uint16_t clk_pcs;        /* MHz */
 486 };
 487
 488
 489 /* EF10-style global pool of MAC addresses.
 490  *
 491  * There are <count> addresses, starting at <base_address>, which are
 492  * contiguous.  Firmware is responsible for allocating addresses from this
 493  * pool to ports / PFs as appropriate.
 494  */
 495
 496 #define TLV_TAG_GLOBAL_MAC              (0x000e0000)
 497
 498 struct tlv_global_mac {
 499   uint32_t tag;
 500   uint32_t length;
 501   uint8_t  base_address[6];
 502   uint16_t reserved1;
 503   uint16_t count;
 504   uint16_t reserved2;
 505 };
 506
 507 #define TLV_TAG_ATB_0V9_TARGET     (0x000f0000) /* legacy symbol - do not use */
 508 #define TLV_TAG_ATB_0V9_TARGET_HUNT     TLV_TAG_ATB_0V9_TARGET
 509
 510 /* The target value for the 0v9 power rail measured on-chip at the
 511  * analogue test bus */
 512 struct tlv_0v9_atb_target {
 513   uint32_t tag;
 514   uint32_t length;
 515   uint16_t millivolts;
 516   uint16_t reserved;
 517 };
 518
 519 /* Global PCIe configuration, second revision. This represents the visible PFs
 520  * by a bitmap rather than having the number of the highest visible one. As such
 521  * it can (for a 16-PF chip) represent a superset of what TLV_TAG_GLOBAL_PCIE_CONFIG
 522  * can and it should be used in place of that tag in future (but compatibility with
 523  * the old tag will be left in the firmware indefinitely).  */
 524
 525 #define TLV_TAG_GLOBAL_PCIE_CONFIG_R2 (0x10100000)
 526
 527 struct tlv_pcie_config_r2 {
 528   uint32_t tag;
 529   uint32_t length;
 530   uint16_t visible_pfs;                         /**< Bitmap of visible PFs */
 531   uint16_t pf_aper;                             /**< BIU aperture for PF BAR2 */
 532   uint16_t vf_aper;                             /**< BIU aperture for VF BAR0 */
 533   uint16_t int_aper;                            /**< BIU aperture for PF BAR4 and VF BAR2 */
 534 };
 535
 536 /* Dynamic port mode.
 537  *
 538  * Allows selecting alternate port configuration for platforms that support it
 539  * (e.g. 1x40G vs 2x10G on Milano, 1x40G vs 4x10G on Medford). This affects the
 540  * number of externally visible ports (and, hence, PF to port mapping), so must
 541  * be done at boot time.
 542  *
 543  * This tag supercedes tlv_global_port_config.
 544  */
 545
 546 #define TLV_TAG_GLOBAL_PORT_MODE         (0x10110000)
 547
 548 struct tlv_global_port_mode {
 549   uint32_t tag;
 550   uint32_t length;
 551   uint32_t port_mode;
 552 #define TLV_PORT_MODE_DEFAULT           (0xffffffff) /* Default for given platform */
 553 #define TLV_PORT_MODE_10G                        (0) /* 10G, single SFP/10G-KR */
 554 #define TLV_PORT_MODE_40G                        (1) /* 40G, single QSFP/40G-KR */
 555 #define TLV_PORT_MODE_10G_10G                    (2) /* 2x10G, dual SFP/10G-KR or single QSFP */
 556 #define TLV_PORT_MODE_40G_40G                    (3) /* 40G + 40G, dual QSFP/40G-KR (Greenport, Medford) */
 557 #define TLV_PORT_MODE_10G_10G_10G_10G            (4) /* 2x10G + 2x10G, quad SFP/10G-KR or dual QSFP (Greenport) */
 558 #define TLV_PORT_MODE_10G_10G_10G_10G_Q1         (4) /* 4x10G, single QSFP, cage 0 (Medford) */
 559 #define TLV_PORT_MODE_10G_10G_10G_10G_Q          (5) /* 4x10G, single QSFP, cage 0 (Medford) OBSOLETE DO NOT USE */
 560 #define TLV_PORT_MODE_40G_10G_10G                (6) /* 1x40G + 2x10G, dual QSFP (Greenport, Medford) */
 561 #define TLV_PORT_MODE_10G_10G_40G                (7) /* 2x10G + 1x40G, dual QSFP (Greenport, Medford) */
 562 #define TLV_PORT_MODE_10G_10G_10G_10G_Q2         (8) /* 4x10G, single QSFP, cage 1 (Medford) */
 563 #define TLV_PORT_MODE_10G_10G_10G_10G_Q1_Q2      (9) /* 2x10G + 2x10G, dual QSFP (Medford) */
 564 #define TLV_PORT_MODE_MAX TLV_PORT_MODE_10G_10G_10G_10G_Q1_Q2
 565 };
 566
 567 /* Type of the v-switch created implicitly by the firmware */
 568
 569 #define TLV_TAG_VSWITCH_TYPE(port)       (0x10120000 + (port))
 570
 571 struct tlv_vswitch_type {
 572   uint32_t tag;
 573   uint32_t length;
 574   uint32_t vswitch_type;
 575 #define TLV_VSWITCH_TYPE_DEFAULT        (0xffffffff) /* Firmware default; equivalent to no TLV present for a given port */
 576 #define TLV_VSWITCH_TYPE_NONE                    (0)
 577 #define TLV_VSWITCH_TYPE_VLAN                    (1)
 578 #define TLV_VSWITCH_TYPE_VEB                     (2)
 579 #define TLV_VSWITCH_TYPE_VEPA                    (3)
 580 #define TLV_VSWITCH_TYPE_MUX                     (4)
 581 #define TLV_VSWITCH_TYPE_TEST                    (5)
 582 };
 583
 584 /* A VLAN tag for the v-port created implicitly by the firmware */
 585
 586 #define TLV_TAG_VPORT_VLAN_TAG(pf)               (0x10130000 + (pf))
 587
 588 struct tlv_vport_vlan_tag {
 589   uint32_t tag;
 590   uint32_t length;
 591   uint32_t vlan_tag;
 592 #define TLV_VPORT_NO_VLAN_TAG                    (0xFFFFFFFF) /* Default in the absence of TLV for a given PF */
 593 };
 594
 595 /* Offset to be applied to the 0v9 setting, wherever it came from */
 596
 597 #define TLV_TAG_ATB_0V9_OFFSET           (0x10140000)
 598
 599 struct tlv_0v9_atb_offset {
 600   uint32_t tag;
 601   uint32_t length;
 602   int16_t  offset_millivolts;
 603   uint16_t reserved;
 604 };
 605
 606 /* A privilege mask given on reset to all non-admin PCIe functions (that is other than first-PF-per-port).
 607  * The meaning of particular bits is defined in mcdi_ef10.yml under MC_CMD_PRIVILEGE_MASK, see also bug 44583.
 608  * TLV_TAG_PRIVILEGE_MASK_ADD specifies bits that should be added (ORed) to firmware default while
 609  * TLV_TAG_PRIVILEGE_MASK_REM specifies bits that should be removed (ANDed) from firmware default:
 610  * Initial_privilege_mask = (firmware_default_mask | privilege_mask_add) & ~privilege_mask_rem */
 611
 612 #define TLV_TAG_PRIVILEGE_MASK          (0x10150000) /* legacy symbol - do not use */
 613
 614 struct tlv_privilege_mask {                          /* legacy structure - do not use */
 615   uint32_t tag;
 616   uint32_t length;
 617   uint32_t privilege_mask;
 618 };
 619
 620 #define TLV_TAG_PRIVILEGE_MASK_ADD      (0x10150000)
 621
 622 struct tlv_privilege_mask_add {
 623   uint32_t tag;
 624   uint32_t length;
 625   uint32_t privilege_mask_add;
 626 };
 627
 628 #define TLV_TAG_PRIVILEGE_MASK_REM      (0x10160000)
 629
 630 struct tlv_privilege_mask_rem {
 631   uint32_t tag;
 632   uint32_t length;
 633   uint32_t privilege_mask_rem;
 634 };
 635
 636 /* Additional privileges given to all PFs.
 637  * This tag takes precedence over TLV_TAG_PRIVILEGE_MASK_REM. */
 638
 639 #define TLV_TAG_PRIVILEGE_MASK_ADD_ALL_PFS         (0x10190000)
 640
 641 struct tlv_privilege_mask_add_all_pfs {
 642   uint32_t tag;
 643   uint32_t length;
 644   uint32_t privilege_mask_add;
 645 };
 646
 647 /* Additional privileges given to a selected PF.
 648  * This tag takes precedence over TLV_TAG_PRIVILEGE_MASK_REM. */
 649
 650 #define TLV_TAG_PRIVILEGE_MASK_ADD_SINGLE_PF(pf)   (0x101A0000 + (pf))
 651
 652 struct tlv_privilege_mask_add_single_pf {
 653   uint32_t tag;
 654   uint32_t length;
 655   uint32_t privilege_mask_add;
 656 };
 657
 658 /* Turning on/off the PFIOV mode.
 659  * This tag only takes effect if TLV_TAG_VSWITCH_TYPE is missing or set to DEFAULT. */
 660
 661 #define TLV_TAG_PFIOV(port)             (0x10170000 + (port))
 662
 663 struct tlv_pfiov {
 664   uint32_t tag;
 665   uint32_t length;
 666   uint32_t pfiov;
 667 #define TLV_PFIOV_OFF                    (0) /* Default */
 668 #define TLV_PFIOV_ON                     (1)
 669 };
 670
 671 /* Multicast filter chaining mode selection.
 672  *
 673  * When enabled, multicast packets are delivered to all recipients of all
 674  * matching multicast filters, with the exception that IP multicast filters
 675  * will steal traffic from MAC multicast filters on a per-function basis.
 676  * (New behaviour.)
 677  *
 678  * When disabled, multicast packets will always be delivered only to the
 679  * recipients of the highest priority matching multicast filter.
 680  * (Legacy behaviour.)
 681  *
 682  * The DEFAULT mode (which is the same as the tag not being present at all)
 683  * is equivalent to ENABLED in production builds, and DISABLED in eftest
 684  * builds.
 685  *
 686  * This option is intended to provide run-time control over this feature
 687  * while it is being stabilised and may be withdrawn at some point in the
 688  * future; the new behaviour is intended to become the standard behaviour.
 689  */
 690
 691 #define TLV_TAG_MCAST_FILTER_CHAINING   (0x10180000)
 692
 693 struct tlv_mcast_filter_chaining {
 694   uint32_t tag;
 695   uint32_t length;
 696   uint32_t mode;
 697 #define TLV_MCAST_FILTER_CHAINING_DEFAULT  (0xffffffff)
 698 #define TLV_MCAST_FILTER_CHAINING_DISABLED (0)
 699 #define TLV_MCAST_FILTER_CHAINING_ENABLED  (1)
 700 };
 701
 702 /* Pacer rate limit per PF */
 703 #define TLV_TAG_RATE_LIMIT(pf)    (0x101b0000 + (pf))
 704
 705 struct tlv_rate_limit {
 706   uint32_t tag;
 707   uint32_t length;
 708   uint32_t rate_mbps;
 709 };
 710
 711 /* OCSD Enable/Disable
 712  *
 713  * This setting allows OCSD to be disabled. This is a requirement for HP
 714  * servers to support PCI passthrough for virtualization.
 715  *
 716  * The DEFAULT mode (which is the same as the tag not being present) is
 717  * equivalent to ENABLED.
 718  *
 719  * This option is not used by the MCFW, and is entirely handled by the various
 720  * drivers that support OCSD, by reading the setting before they attempt
 721  * to enable OCSD.
 722  *
 723  * bit0: OCSD Disabled/Enabled
 724  */
 725
 726 #define TLV_TAG_OCSD (0x101C0000)
 727
 728 struct tlv_ocsd {
 729   uint32_t tag;
 730   uint32_t length;
 731   uint32_t mode;
 732 #define TLV_OCSD_DISABLED 0
 733 #define TLV_OCSD_ENABLED 1 /* Default */
 734 };
 735
 736 /* Descriptor cache config.
 737  *
 738  * Sets the sizes of the TX and RX descriptor caches as a power of 2. It also
 739  * sets the total number of VIs. When the number of VIs is reduced VIs are taken
 740  * away from the highest numbered port first, so a vi_count of 1024 means 1024
 741  * VIs on the first port and 0 on the second (on a Torino).
 742  */
 743
 744 #define TLV_TAG_DESCRIPTOR_CACHE_CONFIG    (0x101d0000)
 745
 746 struct tlv_descriptor_cache_config {
 747   uint32_t tag;
 748   uint32_t length;
 749   uint8_t rx_desc_cache_size;
 750   uint8_t tx_desc_cache_size;
 751   uint16_t vi_count;
 752 };
 753 #define TLV_DESC_CACHE_DEFAULT (0xff)
 754 #define TLV_VI_COUNT_DEFAULT   (0xffff)
 755
 756 /* RX event merging config (read batching).
 757  *
 758  * Sets the global maximum number of events for the merging bins, and the
 759  * global timeout configuration for the bins.
 760  */
 761
 762 #define TLV_TAG_RX_EVENT_MERGING_CONFIG    (0x101e0000)
 763
 764 struct tlv_rx_event_merging_config {
 765   uint32_t  tag;
 766   uint32_t  length;
 767   uint32_t  max_events;
 768 #define TLV_RX_EVENT_MERGING_CONFIG_MAX_EVENTS_MAX ((1 << 4) - 1)
 769   uint32_t  timeout_ns;
 770 };
 771 #define TLV_RX_EVENT_MERGING_MAX_EVENTS_DEFAULT (0xffffffff)
 772 #define TLV_RX_EVENT_MERGING_TIMEOUT_NS_DEFAULT (0xffffffff)
 773
 774 #define TLV_TAG_PCIE_LINK_SETTINGS (0x101f0000)
 775 struct tlv_pcie_link_settings {
 776   uint32_t tag;
 777   uint32_t length;
 778   uint16_t gen;   /* Target PCIe generation: 1, 2, 3 */
 779   uint16_t width; /* Number of lanes */
 780 };
 781
 782 /* TX event merging config.
 783  *
 784  * Sets the global maximum number of events for the merging bins, and the
 785  * global timeout configuration for the bins, and the global timeout for
 786  * empty queues.
 787  */
 788 #define TLV_TAG_TX_EVENT_MERGING_CONFIG    (0x10210000)
 789 struct tlv_tx_event_merging_config {
 790   uint32_t  tag;
 791   uint32_t  length;
 792   uint32_t  max_events;
 793 #define TLV_TX_EVENT_MERGING_CONFIG_MAX_EVENTS_MAX ((1 << 4) - 1)
 794   uint32_t  timeout_ns;
 795   uint32_t  qempty_timeout_ns; /* Medford only */
 796 };
 797 #define TLV_TX_EVENT_MERGING_MAX_EVENTS_DEFAULT (0xffffffff)
 798 #define TLV_TX_EVENT_MERGING_TIMEOUT_NS_DEFAULT (0xffffffff)
 799 #define TLV_TX_EVENT_MERGING_QEMPTY_TIMEOUT_NS_DEFAULT (0xffffffff)
 800
 801 /* BIU mode
 802  *
 803  * Medford2 tag for selecting VI window decode (see values below)
 804  */
 805 #define TLV_TAG_BIU_VI_WINDOW_MODE       (0x10280000)
 806 struct tlv_biu_vi_window_mode {
 807   uint32_t tag;
 808   uint32_t length;
 809   uint8_t  mode;
 810 #define TLV_BIU_VI_WINDOW_MODE_8K    0  /*  8k per VI, CTPIO not mapped, medford/hunt compatible */
 811 #define TLV_BIU_VI_WINDOW_MODE_16K   1  /* 16k per VI, CTPIO mapped */
 812 #define TLV_BIU_VI_WINDOW_MODE_64K   2  /* 64k per VI, CTPIO mapped, POWER-friendly */
 813 };
 814
 815 #define TLV_TAG_LICENSE (0x30800000)
 816
 817 typedef struct tlv_license {
 818   uint32_t  tag;
 819   uint32_t  length;
 820   uint8_t   data[];
 821 } tlv_license_t;
 822
 823 /* TSA NIC IP address configuration
 824  *
 825  * Sets the TSA NIC IP address statically via configuration tool or dynamically
 826  * via DHCP via snooping based on the mode selection (0=Static, 1=DHCP, 2=Snoop)
 827  *
 828  * NOTE: This TAG is temporarily placed in the dynamic config partition and will
 829  * be moved to a private partition during TSA development. It is not used in any
 830  * released code yet.
 831  */
 832
 833 #define TLV_TAG_TMP_TSAN_CONFIG         (0x10220000)
 834
 835 #define TLV_TSAN_IP_MODE_STATIC         (0)
 836 #define TLV_TSAN_IP_MODE_DHCP           (1)
 837 #define TLV_TSAN_IP_MODE_SNOOP          (2)
 838 typedef struct tlv_tsan_config {
 839   uint32_t tag;
 840   uint32_t length;
 841   uint32_t mode;
 842   uint32_t ip;
 843   uint32_t netmask;
 844   uint32_t gateway;
 845   uint32_t port;
 846   uint32_t bind_retry;  /* DEPRECATED */
 847   uint32_t bind_bkout;  /* DEPRECATED */
 848 } tlv_tsan_config_t;
 849
 850 /* TSA Controller IP address configuration
 851  *
 852  * Sets the TSA Controller IP address statically via configuration tool
 853  *
 854  * NOTE: This TAG is temporarily placed in the dynamic config partition and will
 855  * be moved to a private partition during TSA development. It is not used in any
 856  * released code yet.
 857  */
 858
 859 #define TLV_TAG_TMP_TSAC_CONFIG         (0x10230000)
 860
 861 #define TLV_MAX_TSACS (4)
 862 typedef struct tlv_tsac_config {
 863   uint32_t tag;
 864   uint32_t length;
 865   uint32_t num_tsacs;
 866   uint32_t ip[TLV_MAX_TSACS];
 867   uint32_t port[TLV_MAX_TSACS];
 868 } tlv_tsac_config_t;
 869
 870 /* Binding ticket
 871  *
 872  * Sets the TSA NIC binding ticket used for binding process between the TSA NIC
 873  * and the TSA Controller
 874  *
 875  * NOTE: This TAG is temporarily placed in the dynamic config partition and will
 876  * be moved to a private partition during TSA development. It is not used in any
 877  * released code yet.
 878  */
 879
 880 #define TLV_TAG_TMP_BINDING_TICKET      (0x10240000)
 881
 882 typedef struct tlv_binding_ticket {
 883   uint32_t tag;
 884   uint32_t length;
 885   uint8_t  bytes[];
 886 } tlv_binding_ticket_t;
 887
 888 /* Solarflare private key  (DEPRECATED)
 889  *
 890  * Sets the Solareflare private key used for signing during the binding process
 891  *
 892  * NOTE: This TAG is temporarily placed in the dynamic config partition and will
 893  * be moved to a private partition during TSA development. It is not used in any
 894  * released code yet.
 895  */
 896
 897 #define TLV_TAG_TMP_PIK_SF              (0x10250000)    /* DEPRECATED */
 898
 899 typedef struct tlv_pik_sf {
 900   uint32_t tag;
 901   uint32_t length;
 902   uint8_t  bytes[];
 903 } tlv_pik_sf_t;
 904
 905 /* CA root certificate
 906  *
 907  * Sets the CA root certificate used for TSA Controller verfication during
 908  * TLS connection setup between the TSA NIC and the TSA Controller
 909  *
 910  * NOTE: This TAG is temporarily placed in the dynamic config partition and will
 911  * be moved to a private partition during TSA development. It is not used in any
 912  * released code yet.
 913  */
 914
 915 #define TLV_TAG_TMP_CA_ROOT_CERT        (0x10260000)
 916
 917 typedef struct tlv_ca_root_cert {
 918   uint32_t tag;
 919   uint32_t length;
 920   uint8_t  bytes[];
 921 } tlv_ca_root_cert_t;
 922
 923 /* Tx vFIFO Low latency configuration
 924  *
 925  * To keep the desired booting behaviour for the switch, it just requires to
 926  * know if the low latency mode is enabled.
 927  */
 928
 929 #define TLV_TAG_TX_VFIFO_ULL_MODE       (0x10270000)
 930 struct tlv_tx_vfifo_ull_mode {
 931   uint32_t tag;
 932   uint32_t length;
 933   uint8_t  mode;
 934 #define TLV_TX_VFIFO_ULL_MODE_DEFAULT    0
 935 };
 936
 937 #endif /* CI_MGMT_TLV_LAYOUT_H */