include/tlv_eeprom.h

   1 /* SPDX-License-Identifier: GPL-2.0+ */
   2 /*
   3  * See file CREDITS for list of people who contributed to this
   4  * project.
   5  */
   6
   7 #ifndef __TLV_EEPROM_H_
   8 #define __TLV_EEPROM_H_
   9
  10 /*
  11  *  The Definition of the TlvInfo EEPROM format can be found at onie.org or
  12  *  github.com/onie
  13  */
  14
  15 /*
  16  * TlvInfo header: Layout of the header for the TlvInfo format
  17  *
  18  * See the end of this file for details of this eeprom format
  19  */
  20 struct __attribute__ ((__packed__)) tlvinfo_header {
  21         char    signature[8]; /* 0x00 - 0x07 EEPROM Tag "TlvInfo" */
  22         u8      version;      /* 0x08        Structure version    */
  23         u16     totallen;     /* 0x09 - 0x0A Length of all data which follows */
  24 };
  25
  26 // Header Field Constants
  27 #define TLV_INFO_ID_STRING      "TlvInfo"
  28 #define TLV_INFO_VERSION        0x01
  29 #define TLV_INFO_MAX_LEN        2048
  30 #define TLV_TOTAL_LEN_MAX       (TLV_INFO_MAX_LEN - \
  31                                 sizeof(struct tlvinfo_header))
  32
  33 /*
  34  * TlvInfo TLV: Layout of a TLV field
  35  */
  36 struct __attribute__ ((__packed__)) tlvinfo_tlv {
  37         u8  type;
  38         u8  length;
  39         u8  value[0];
  40 };
  41
  42 /* Maximum length of a TLV value in bytes */
  43 #define TLV_VALUE_MAX_LEN        255
  44
  45 /**
  46  *  The TLV Types.
  47  *
  48  *  Keep these in sync with tlv_code_list in cmd/tlv_eeprom.c
  49  */
  50 #define TLV_CODE_PRODUCT_NAME   0x21
  51 #define TLV_CODE_PART_NUMBER    0x22
  52 #define TLV_CODE_SERIAL_NUMBER  0x23
  53 #define TLV_CODE_MAC_BASE       0x24
  54 #define TLV_CODE_MANUF_DATE     0x25
  55 #define TLV_CODE_DEVICE_VERSION 0x26
  56 #define TLV_CODE_LABEL_REVISION 0x27
  57 #define TLV_CODE_PLATFORM_NAME  0x28
  58 #define TLV_CODE_ONIE_VERSION   0x29
  59 #define TLV_CODE_MAC_SIZE       0x2A
  60 #define TLV_CODE_MANUF_NAME     0x2B
  61 #define TLV_CODE_MANUF_COUNTRY  0x2C
  62 #define TLV_CODE_VENDOR_NAME    0x2D
  63 #define TLV_CODE_DIAG_VERSION   0x2E
  64 #define TLV_CODE_SERVICE_TAG    0x2F
  65 #define TLV_CODE_VENDOR_EXT     0xFD
  66 #define TLV_CODE_CRC_32         0xFE
  67
  68 #if CONFIG_IS_ENABLED(CMD_TLV_EEPROM)
  69
  70 /**
  71  * read_tlv_eeprom - Read the EEPROM binary data from the hardware
  72  * @eeprom: Pointer to buffer to hold the binary data
  73  * @offset: Offset within EEPROM block to read data from
  74  * @len   : Maximum size of buffer
  75  * @dev   : EEPROM device to read
  76  *
  77  * Note: this routine does not validate the EEPROM data.
  78  *
  79  */
  80
  81 int read_tlv_eeprom(void *eeprom, int offset, int len, int dev);
  82
  83 /**
  84  * write_tlv_eeprom - Write the entire EEPROM binary data to the hardware
  85  * @eeprom: Pointer to buffer to hold the binary data
  86  * @len   : Maximum size of buffer
  87  *
  88  * Note: this routine does not validate the EEPROM data.
  89  *
  90  */
  91 int write_tlv_eeprom(void *eeprom, int len);
  92
  93 /**
  94  * read_tlvinfo_tlv_eeprom - Read the TLV from EEPROM, and validate
  95  * @eeprom: Pointer to buffer to hold the binary data. Must point to a buffer
  96  *          of size at least TLV_INFO_MAX_LEN.
  97  * @hdr   : Points to pointer to TLV header (output)
  98  * @first_entry : Points to pointer to first TLV entry (output)
  99  * @dev   : EEPROM device to read
 100  *
 101  * Store the raw EEPROM data from EEPROM @dev in the @eeprom buffer. If TLV is
 102  * valid set *@hdr and *@first_entry.
 103  *
 104  * Returns 0 when read from EEPROM is successful, and the data is valid.
 105  * Returns <0 error value when EEPROM read fails. Return -EINVAL when TLV is
 106  * invalid.
 107  *
 108  */
 109
 110 int read_tlvinfo_tlv_eeprom(void *eeprom, struct tlvinfo_header **hdr,
 111                             struct tlvinfo_tlv **first_entry, int dev);
 112
 113 #else /* !CONFIG_IS_ENABLED(CMD_TLV_EEPROM) */
 114
 115 static inline int read_tlv_eeprom(void *eeprom, int offset, int len, int dev)
 116 {
 117         return -ENOTSUPP;
 118 }
 119
 120 static inline int write_tlv_eeprom(void *eeprom, int len)
 121 {
 122         return -ENOTSUPP;
 123 }
 124
 125 static inline int
 126 read_tlvinfo_tlv_eeprom(void *eeprom, struct tlvinfo_header **hdr,
 127                         struct tlvinfo_tlv **first_entry, int dev)
 128 {
 129         return -ENOTSUPP;
 130 }
 131
 132 #endif /* CONFIG_IS_ENABLED(CMD_TLV_EEPROM) */
 133
 134 /**
 135  *  is_valid_tlvinfo_header
 136  *
 137  *  Perform sanity checks on the first 11 bytes of the TlvInfo EEPROM
 138  *  data pointed to by the parameter:
 139  *      1. First 8 bytes contain null-terminated ASCII string "TlvInfo"
 140  *      2. Version byte is 1
 141  *      3. Total length bytes contain value which is less than or equal
 142  *         to the allowed maximum (2048-11)
 143  *
 144  */
 145 static inline bool is_valid_tlvinfo_header(struct tlvinfo_header *hdr)
 146 {
 147         return ((strcmp(hdr->signature, TLV_INFO_ID_STRING) == 0) &&
 148                 (hdr->version == TLV_INFO_VERSION) &&
 149                 (be16_to_cpu(hdr->totallen) <= TLV_TOTAL_LEN_MAX));
 150 }
 151
 152 #endif /* __TLV_EEPROM_H_ */