[thirdparty/u-boot.git] / include / smbios.h

/* SPDX-License-Identifier: GPL-2.0+ */
/*
 * Copyright (C) 2015, Bin Meng <bmeng.cn@gmail.com>
 *
 * Adapted from coreboot src/include/smbios.h
 */

#ifndef _SMBIOS_H_
#define _SMBIOS_H_

#include <linux/types.h>

/* SMBIOS spec version implemented */
#define SMBIOS_MAJOR_VER	3
#define SMBIOS_MINOR_VER	7

enum {
	SMBIOS_STR_MAX	= 64,	/* Maximum length allowed for a string */
};

/* SMBIOS structure types */
enum {
	SMBIOS_BIOS_INFORMATION = 0,
	SMBIOS_SYSTEM_INFORMATION = 1,
	SMBIOS_BOARD_INFORMATION = 2,
	SMBIOS_SYSTEM_ENCLOSURE = 3,
	SMBIOS_PROCESSOR_INFORMATION = 4,
	SMBIOS_CACHE_INFORMATION = 7,
	SMBIOS_SYSTEM_SLOTS = 9,
	SMBIOS_PHYS_MEMORY_ARRAY = 16,
	SMBIOS_MEMORY_DEVICE = 17,
	SMBIOS_MEMORY_ARRAY_MAPPED_ADDRESS = 19,
	SMBIOS_SYSTEM_BOOT_INFORMATION = 32,
	SMBIOS_END_OF_TABLE = 127
};

#define SMBIOS_INTERMEDIATE_OFFSET	16
#define SMBIOS_STRUCT_EOS_BYTES		2

struct __packed smbios_entry {
	u8 anchor[4];
	u8 checksum;
	u8 length;
	u8 major_ver;
	u8 minor_ver;
	u16 max_struct_size;
	u8 entry_point_rev;
	u8 formatted_area[5];
	u8 intermediate_anchor[5];
	u8 intermediate_checksum;
	u16 struct_table_length;
	u32 struct_table_address;
	u16 struct_count;
	u8 bcd_rev;
};

/**
 * struct smbios3_entry - SMBIOS 3.0 (64-bit) Entry Point structure
 */
struct __packed smbios3_entry {
	/** @anchor: anchor string */
	u8 anchor[5];
	/** @checksum: checksum of the entry point structure */
	u8 checksum;
	/** @length: length of the entry point structure */
	u8 length;
	/** @major_ver: major version of the SMBIOS specification */
	u8 major_ver;
	/** @minor_ver: minor version of the SMBIOS specification */
	u8 minor_ver;
	/** @docrev: revision of the SMBIOS specification */
	u8 doc_rev;
	/** @entry_point_rev: revision of the entry point structure */
	u8 entry_point_rev;
	/** @reserved: reserved */
	u8 reserved;
	/** maximum size of SMBIOS table */
	u32 table_maximum_size;
	/** @struct_table_address: 64-bit physical starting address */
	u64 struct_table_address;
};

/* BIOS characteristics */
#define BIOS_CHARACTERISTICS_PCI_SUPPORTED	(1 << 7)
#define BIOS_CHARACTERISTICS_UPGRADEABLE	(1 << 11)
#define BIOS_CHARACTERISTICS_SELECTABLE_BOOT	(1 << 16)

#define BIOS_CHARACTERISTICS_EXT1_ACPI		(1 << 0)
#define BIOS_CHARACTERISTICS_EXT2_UEFI		(1 << 3)
#define BIOS_CHARACTERISTICS_EXT2_TARGET	(1 << 2)

struct __packed smbios_type0 {
	u8 type;
	u8 length;
	u16 handle;
	u8 vendor;
	u8 bios_ver;
	u16 bios_start_segment;
	u8 bios_release_date;
	u8 bios_rom_size;
	u64 bios_characteristics;
	u8 bios_characteristics_ext1;
	u8 bios_characteristics_ext2;
	u8 bios_major_release;
	u8 bios_minor_release;
	u8 ec_major_release;
	u8 ec_minor_release;
	char eos[SMBIOS_STRUCT_EOS_BYTES];
};

/**
 * enum smbios_wakeup_type - wake-up type
 *
 * These constants are used for the Wake-Up Type field in the SMBIOS
 * System Information (Type 1) structure.
 */
enum smbios_wakeup_type {
	/** @SMBIOS_WAKEUP_TYPE_RESERVED: Reserved */
	SMBIOS_WAKEUP_TYPE_RESERVED,
	/** @SMBIOS_WAKEUP_TYPE_OTHER: Other */
	SMBIOS_WAKEUP_TYPE_OTHER,
	/** @SMBIOS_WAKEUP_TYPE_UNKNOWN: Unknown */
	SMBIOS_WAKEUP_TYPE_UNKNOWN,
	/** @SMBIOS_WAKEUP_TYPE_APM_TIMER: APM Timer */
	SMBIOS_WAKEUP_TYPE_APM_TIMER,
	/** @SMBIOS_WAKEUP_TYPE_MODEM_RING: Modem Ring */
	SMBIOS_WAKEUP_TYPE_MODEM_RING,
	/** @SMBIOS_WAKEUP_TYPE_LAN_REMOTE: LAN Remote */
	SMBIOS_WAKEUP_TYPE_LAN_REMOTE,
	/** @SMBIOS_WAKEUP_TYPE_POWER_SWITCH: Power Switch */
	SMBIOS_WAKEUP_TYPE_POWER_SWITCH,
	/** @SMBIOS_WAKEUP_TYPE_PCI_PME: PCI PME# */
	SMBIOS_WAKEUP_TYPE_PCI_PME,
	/** @SMBIOS_WAKEUP_TYPE_AC_POWER_RESTORED: AC Power Restored */
	SMBIOS_WAKEUP_TYPE_AC_POWER_RESTORED,
};

struct __packed smbios_type1 {
	u8 type;
	u8 length;
	u16 handle;
	u8 manufacturer;
	u8 product_name;
	u8 version;
	u8 serial_number;
	u8 uuid[16];
	u8 wakeup_type;
	u8 sku_number;
	u8 family;
	char eos[SMBIOS_STRUCT_EOS_BYTES];
};

#define SMBIOS_BOARD_FEATURE_HOSTING	(1 << 0)
#define SMBIOS_BOARD_MOTHERBOARD	10

struct __packed smbios_type2 {
	u8 type;
	u8 length;
	u16 handle;
	u8 manufacturer;
	u8 product_name;
	u8 version;
	u8 serial_number;
	u8 asset_tag_number;
	u8 feature_flags;
	u8 chassis_location;
	u16 chassis_handle;
	u8 board_type;
	u8 number_contained_objects;
	char eos[SMBIOS_STRUCT_EOS_BYTES];
};

#define SMBIOS_ENCLOSURE_DESKTOP	3
#define SMBIOS_STATE_SAFE		3
#define SMBIOS_SECURITY_NONE		3

struct __packed smbios_type3 {
	u8 type;
	u8 length;
	u16 handle;
	u8 manufacturer;
	u8 chassis_type;
	u8 version;
	u8 serial_number;
	u8 asset_tag_number;
	u8 bootup_state;
	u8 power_supply_state;
	u8 thermal_state;
	u8 security_status;
	u32 oem_defined;
	u8 height;
	u8 number_of_power_cords;
	u8 element_count;
	u8 element_record_length;
	char eos[SMBIOS_STRUCT_EOS_BYTES];
};

#define SMBIOS_PROCESSOR_TYPE_CENTRAL	3
#define SMBIOS_PROCESSOR_STATUS_ENABLED	1
#define SMBIOS_PROCESSOR_UPGRADE_NONE	6

#define SMBIOS_PROCESSOR_FAMILY_OTHER	1
#define SMBIOS_PROCESSOR_FAMILY_UNKNOWN	2

struct __packed smbios_type4 {
	u8 type;
	u8 length;
	u16 handle;
	u8 socket_designation;
	u8 processor_type;
	u8 processor_family;
	u8 processor_manufacturer;
	u32 processor_id[2];
	u8 processor_version;
	u8 voltage;
	u16 external_clock;
	u16 max_speed;
	u16 current_speed;
	u8 status;
	u8 processor_upgrade;
	u16 l1_cache_handle;
	u16 l2_cache_handle;
	u16 l3_cache_handle;
	u8 serial_number;
	u8 asset_tag;
	u8 part_number;
	u8 core_count;
	u8 core_enabled;
	u8 thread_count;
	u16 processor_characteristics;
	u16 processor_family2;
	u16 core_count2;
	u16 core_enabled2;
	u16 thread_count2;
	char eos[SMBIOS_STRUCT_EOS_BYTES];
};

struct __packed smbios_type32 {
	u8 type;
	u8 length;
	u16 handle;
	u8 reserved[6];
	u8 boot_status;
	char eos[SMBIOS_STRUCT_EOS_BYTES];
};

struct __packed smbios_type127 {
	u8 type;
	u8 length;
	u16 handle;
	char eos[SMBIOS_STRUCT_EOS_BYTES];
};

struct __packed smbios_header {
	u8 type;
	u8 length;
	u16 handle;
};

/**
 * fill_smbios_header() - Fill the header of an SMBIOS table
 *
 * This fills the header of an SMBIOS table structure.
 *
 * @table:	start address of the structure
 * @type:	the type of structure
 * @length:	the length of the formatted area of the structure
 * @handle:	the structure's handle, a unique 16-bit number
 */
static inline void fill_smbios_header(void *table, int type,
				      int length, int handle)
{
	struct smbios_header *header = table;

	header->type = type;
	header->length = length - SMBIOS_STRUCT_EOS_BYTES;
	header->handle = handle;
}

/**
 * write_smbios_table() - Write SMBIOS table
 *
 * This writes SMBIOS table at a given address.
 *
 * @addr:	start address to write SMBIOS table, 16-byte-alignment
 * recommended. Note that while the SMBIOS tables themself have no alignment
 * requirement, some systems may requires alignment. For example x86 systems
 * which put tables at f0000 require 16-byte alignment
 *
 * Return:	end address of SMBIOS table (and start address for next entry)
 *		or NULL in case of an error
 */
ulong write_smbios_table(ulong addr);

/**
 * smbios_entry() - Get a valid struct smbios_entry pointer
 *
 * @address:   address where smbios tables is located
 * @size:      size of smbios table
 * @return:    NULL or a valid pointer to a struct smbios_entry
 */
const struct smbios_entry *smbios_entry(u64 address, u32 size);

/**
 * smbios_header() - Search for SMBIOS header type
 *
 * @entry:     pointer to a struct smbios_entry
 * @type:      SMBIOS type
 * @return:    NULL or a valid pointer to a struct smbios_header
 */
const struct smbios_header *smbios_header(const struct smbios_entry *entry, int type);

/**
 * smbios_string() - Return string from SMBIOS
 *
 * @header:    pointer to struct smbios_header
 * @index:     string index
 * @return:    NULL or a valid char pointer
 */
char *smbios_string(const struct smbios_header *header, int index);

/**
 * smbios_update_version() - Update the version string
 *
 * This can be called after the SMBIOS tables are written (e.g. after the U-Boot
 * main loop has started) to update the BIOS version string (SMBIOS table 0).
 *
 * @version: New version string to use
 * Return: 0 if OK, -ENOENT if no version string was previously written,
 *	-ENOSPC if the new string is too large to fit
 */
int smbios_update_version(const char *version);

/**
 * smbios_update_version_full() - Update the version string
 *
 * This can be called after the SMBIOS tables are written (e.g. after the U-Boot
 * main loop has started) to update the BIOS version string (SMBIOS table 0).
 * It scans for the correct place to put the version, so does not need U-Boot
 * to have actually written the tables itself (e.g. if a previous bootloader
 * did it).
 *
 * @smbios_tab: Start of SMBIOS tables
 * @version: New version string to use
 * Return: 0 if OK, -ENOENT if no version string was previously written,
 *	-ENOSPC if the new string is too large to fit
 */
int smbios_update_version_full(void *smbios_tab, const char *version);

/**
 * smbios_prepare_measurement() - Update smbios table for the measurement
 *
 * TCG specification requires to measure static configuration information.
 * This function clear the device dependent parameters such as
 * serial number for the measurement.
 *
 * @entry: pointer to a struct smbios3_entry
 * @header: pointer to a struct smbios_header
 */
void smbios_prepare_measurement(const struct smbios3_entry *entry,
				struct smbios_header *header);

#endif /* _SMBIOS_H_ */
Commit	Line	Data
83d290c5	1	/* SPDX-License-Identifier: GPL-2.0+ */
721e992a BM	2	/*
	3	* Copyright (C) 2015, Bin Meng <bmeng.cn@gmail.com>
	4	*
	5	* Adapted from coreboot src/include/smbios.h
721e992a BM	6	*/
	7
	8	#ifndef _SMBIOS_H_
	9	#define _SMBIOS_H_
	10
efe441a0	11	#include <linux/types.h>
78227d4e	12
721e992a BM	13	/* SMBIOS spec version implemented */
721e992a BM	14	#define SMBIOS_MAJOR_VER 3
70924294	15	#define SMBIOS_MINOR_VER 7
721e992a	16
272e62cb SG	17	enum {
	18	SMBIOS_STR_MAX = 64, /* Maximum length allowed for a string */
	19	};
	20
721e992a BM	21	/* SMBIOS structure types */
	22	enum {
	23	SMBIOS_BIOS_INFORMATION = 0,
	24	SMBIOS_SYSTEM_INFORMATION = 1,
	25	SMBIOS_BOARD_INFORMATION = 2,
	26	SMBIOS_SYSTEM_ENCLOSURE = 3,
	27	SMBIOS_PROCESSOR_INFORMATION = 4,
	28	SMBIOS_CACHE_INFORMATION = 7,
	29	SMBIOS_SYSTEM_SLOTS = 9,
	30	SMBIOS_PHYS_MEMORY_ARRAY = 16,
	31	SMBIOS_MEMORY_DEVICE = 17,
	32	SMBIOS_MEMORY_ARRAY_MAPPED_ADDRESS = 19,
	33	SMBIOS_SYSTEM_BOOT_INFORMATION = 32,
	34	SMBIOS_END_OF_TABLE = 127
	35	};
	36
	37	#define SMBIOS_INTERMEDIATE_OFFSET 16
	38	#define SMBIOS_STRUCT_EOS_BYTES 2
	39
	40	struct __packed smbios_entry {
	41	u8 anchor[4];
	42	u8 checksum;
	43	u8 length;
	44	u8 major_ver;
	45	u8 minor_ver;
	46	u16 max_struct_size;
	47	u8 entry_point_rev;
	48	u8 formatted_area[5];
	49	u8 intermediate_anchor[5];
	50	u8 intermediate_checksum;
	51	u16 struct_table_length;
	52	u32 struct_table_address;
	53	u16 struct_count;
	54	u8 bcd_rev;
	55	};
	56
de4b91ca HS	57	/**
	58	* struct smbios3_entry - SMBIOS 3.0 (64-bit) Entry Point structure
	59	*/
	60	struct __packed smbios3_entry {
	61	/** @anchor: anchor string */
	62	u8 anchor[5];
	63	/** @checksum: checksum of the entry point structure */
	64	u8 checksum;
	65	/** @length: length of the entry point structure */
	66	u8 length;
	67	/** @major_ver: major version of the SMBIOS specification */
	68	u8 major_ver;
	69	/** @minor_ver: minor version of the SMBIOS specification */
	70	u8 minor_ver;
	71	/** @docrev: revision of the SMBIOS specification */
	72	u8 doc_rev;
	73	/** @entry_point_rev: revision of the entry point structure */
	74	u8 entry_point_rev;
	75	/** @reserved: reserved */
	76	u8 reserved;
	77	/** maximum size of SMBIOS table */
406c410e	78	u32 table_maximum_size;
de4b91ca HS	79	/** @struct_table_address: 64-bit physical starting address */
	80	u64 struct_table_address;
	81	};
	82
721e992a BM	83	/* BIOS characteristics */
	84	#define BIOS_CHARACTERISTICS_PCI_SUPPORTED (1 << 7)
	85	#define BIOS_CHARACTERISTICS_UPGRADEABLE (1 << 11)
	86	#define BIOS_CHARACTERISTICS_SELECTABLE_BOOT (1 << 16)
	87
	88	#define BIOS_CHARACTERISTICS_EXT1_ACPI (1 << 0)
ff192304	89	#define BIOS_CHARACTERISTICS_EXT2_UEFI (1 << 3)
721e992a BM	90	#define BIOS_CHARACTERISTICS_EXT2_TARGET (1 << 2)
	91
	92	struct __packed smbios_type0 {
	93	u8 type;
	94	u8 length;
	95	u16 handle;
	96	u8 vendor;
	97	u8 bios_ver;
	98	u16 bios_start_segment;
	99	u8 bios_release_date;
	100	u8 bios_rom_size;
	101	u64 bios_characteristics;
	102	u8 bios_characteristics_ext1;
	103	u8 bios_characteristics_ext2;
	104	u8 bios_major_release;
	105	u8 bios_minor_release;
	106	u8 ec_major_release;
	107	u8 ec_minor_release;
	108	char eos[SMBIOS_STRUCT_EOS_BYTES];
	109	};
	110
6eca28b6 HS	111	/**
	112	* enum smbios_wakeup_type - wake-up type
	113	*
	114	* These constants are used for the Wake-Up Type field in the SMBIOS
	115	* System Information (Type 1) structure.
	116	*/
	117	enum smbios_wakeup_type {
	118	/** @SMBIOS_WAKEUP_TYPE_RESERVED: Reserved */
	119	SMBIOS_WAKEUP_TYPE_RESERVED,
	120	/** @SMBIOS_WAKEUP_TYPE_OTHER: Other */
	121	SMBIOS_WAKEUP_TYPE_OTHER,
	122	/** @SMBIOS_WAKEUP_TYPE_UNKNOWN: Unknown */
	123	SMBIOS_WAKEUP_TYPE_UNKNOWN,
	124	/** @SMBIOS_WAKEUP_TYPE_APM_TIMER: APM Timer */
	125	SMBIOS_WAKEUP_TYPE_APM_TIMER,
	126	/** @SMBIOS_WAKEUP_TYPE_MODEM_RING: Modem Ring */
	127	SMBIOS_WAKEUP_TYPE_MODEM_RING,
	128	/** @SMBIOS_WAKEUP_TYPE_LAN_REMOTE: LAN Remote */
	129	SMBIOS_WAKEUP_TYPE_LAN_REMOTE,
	130	/** @SMBIOS_WAKEUP_TYPE_POWER_SWITCH: Power Switch */
	131	SMBIOS_WAKEUP_TYPE_POWER_SWITCH,
	132	/** @SMBIOS_WAKEUP_TYPE_PCI_PME: PCI PME# */
	133	SMBIOS_WAKEUP_TYPE_PCI_PME,
	134	/** @SMBIOS_WAKEUP_TYPE_AC_POWER_RESTORED: AC Power Restored */
	135	SMBIOS_WAKEUP_TYPE_AC_POWER_RESTORED,
	136	};
	137
721e992a BM	138	struct __packed smbios_type1 {
	139	u8 type;
	140	u8 length;
	141	u16 handle;
	142	u8 manufacturer;
	143	u8 product_name;
	144	u8 version;
	145	u8 serial_number;
	146	u8 uuid[16];
	147	u8 wakeup_type;
	148	u8 sku_number;
	149	u8 family;
	150	char eos[SMBIOS_STRUCT_EOS_BYTES];
	151	};
	152
	153	#define SMBIOS_BOARD_FEATURE_HOSTING (1 << 0)
	154	#define SMBIOS_BOARD_MOTHERBOARD 10
	155
	156	struct __packed smbios_type2 {
	157	u8 type;
	158	u8 length;
	159	u16 handle;
	160	u8 manufacturer;
	161	u8 product_name;
	162	u8 version;
	163	u8 serial_number;
	164	u8 asset_tag_number;
	165	u8 feature_flags;
	166	u8 chassis_location;
	167	u16 chassis_handle;
	168	u8 board_type;
a5866c3c	169	u8 number_contained_objects;
721e992a BM	170	char eos[SMBIOS_STRUCT_EOS_BYTES];
	171	};
	172
	173	#define SMBIOS_ENCLOSURE_DESKTOP 3
	174	#define SMBIOS_STATE_SAFE 3
	175	#define SMBIOS_SECURITY_NONE 3
	176
	177	struct __packed smbios_type3 {
	178	u8 type;
	179	u8 length;
	180	u16 handle;
	181	u8 manufacturer;
	182	u8 chassis_type;
	183	u8 version;
	184	u8 serial_number;
	185	u8 asset_tag_number;
	186	u8 bootup_state;
	187	u8 power_supply_state;
	188	u8 thermal_state;
	189	u8 security_status;
	190	u32 oem_defined;
	191	u8 height;
	192	u8 number_of_power_cords;
	193	u8 element_count;
	194	u8 element_record_length;
	195	char eos[SMBIOS_STRUCT_EOS_BYTES];
	196	};
	197
	198	#define SMBIOS_PROCESSOR_TYPE_CENTRAL 3
	199	#define SMBIOS_PROCESSOR_STATUS_ENABLED 1
	200	#define SMBIOS_PROCESSOR_UPGRADE_NONE 6
	201
96476206 AG	202	#define SMBIOS_PROCESSOR_FAMILY_OTHER 1
	203	#define SMBIOS_PROCESSOR_FAMILY_UNKNOWN 2
	204
721e992a BM	205	struct __packed smbios_type4 {
	206	u8 type;
	207	u8 length;
	208	u16 handle;
	209	u8 socket_designation;
	210	u8 processor_type;
	211	u8 processor_family;
	212	u8 processor_manufacturer;
	213	u32 processor_id[2];
	214	u8 processor_version;
	215	u8 voltage;
	216	u16 external_clock;
	217	u16 max_speed;
	218	u16 current_speed;
	219	u8 status;
	220	u8 processor_upgrade;
	221	u16 l1_cache_handle;
	222	u16 l2_cache_handle;
	223	u16 l3_cache_handle;
	224	u8 serial_number;
	225	u8 asset_tag;
	226	u8 part_number;
	227	u8 core_count;
	228	u8 core_enabled;
	229	u8 thread_count;
	230	u16 processor_characteristics;
	231	u16 processor_family2;
	232	u16 core_count2;
	233	u16 core_enabled2;
	234	u16 thread_count2;
	235	char eos[SMBIOS_STRUCT_EOS_BYTES];
	236	};
	237
	238	struct __packed smbios_type32 {
	239	u8 type;
	240	u8 length;
	241	u16 handle;
	242	u8 reserved[6];
	243	u8 boot_status;
dc090586	244	char eos[SMBIOS_STRUCT_EOS_BYTES];
721e992a BM	245	};
	246
	247	struct __packed smbios_type127 {
	248	u8 type;
	249	u8 length;
	250	u16 handle;
dc090586	251	char eos[SMBIOS_STRUCT_EOS_BYTES];
721e992a BM	252	};
	253
	254	struct __packed smbios_header {
	255	u8 type;
	256	u8 length;
	257	u16 handle;
	258	};
	259
	260	/**
	261	* fill_smbios_header() - Fill the header of an SMBIOS table
	262	*
	263	* This fills the header of an SMBIOS table structure.
	264	*
	265	* @table: start address of the structure
	266	* @type: the type of structure
	267	* @length: the length of the formatted area of the structure
	268	* @handle: the structure's handle, a unique 16-bit number
	269	*/
	270	static inline void fill_smbios_header(void *table, int type,
	271	int length, int handle)
	272	{
	273	struct smbios_header *header = table;
	274
	275	header->type = type;
	276	header->length = length - SMBIOS_STRUCT_EOS_BYTES;
	277	header->handle = handle;
	278	}
	279
721e992a BM	280	/**
	281	* write_smbios_table() - Write SMBIOS table
	282	*
	283	* This writes SMBIOS table at a given address.
	284	*
31f950a9 SG	285	* @addr: start address to write SMBIOS table, 16-byte-alignment
	286	* recommended. Note that while the SMBIOS tables themself have no alignment
	287	* requirement, some systems may requires alignment. For example x86 systems
	288	* which put tables at f0000 require 16-byte alignment
	289	*
c193d9bd HS	290	* Return: end address of SMBIOS table (and start address for next entry)
c193d9bd HS	291	* or NULL in case of an error
721e992a	292	*/
42fd8c19	293	ulong write_smbios_table(ulong addr);
721e992a	294
415eab06 CG	295	/**
	296	* smbios_entry() - Get a valid struct smbios_entry pointer
	297	*
	298	* @address: address where smbios tables is located
	299	* @size: size of smbios table
	300	* @return: NULL or a valid pointer to a struct smbios_entry
	301	*/
	302	const struct smbios_entry *smbios_entry(u64 address, u32 size);
	303
	304	/**
	305	* smbios_header() - Search for SMBIOS header type
	306	*
	307	* @entry: pointer to a struct smbios_entry
	308	* @type: SMBIOS type
	309	* @return: NULL or a valid pointer to a struct smbios_header
	310	*/
	311	const struct smbios_header smbios_header(const struct smbios_entry entry, int type);
	312
	313	/**
	314	* smbios_string() - Return string from SMBIOS
	315	*
	316	* @header: pointer to struct smbios_header
	317	* @index: string index
3d49ee85	318	* @return: NULL or a valid char pointer
415eab06	319	*/
3d49ee85	320	char smbios_string(const struct smbios_header header, int index);
415eab06	321
e9adaa75 SG	322	/**
	323	* smbios_update_version() - Update the version string
	324	*
	325	* This can be called after the SMBIOS tables are written (e.g. after the U-Boot
	326	* main loop has started) to update the BIOS version string (SMBIOS table 0).
	327	*
	328	* @version: New version string to use
185f812c	329	* Return: 0 if OK, -ENOENT if no version string was previously written,
e9adaa75 SG	330	* -ENOSPC if the new string is too large to fit
	331	*/
	332	int smbios_update_version(const char *version);
	333
272e62cb SG	334	/**
	335	* smbios_update_version_full() - Update the version string
	336	*
	337	* This can be called after the SMBIOS tables are written (e.g. after the U-Boot
	338	* main loop has started) to update the BIOS version string (SMBIOS table 0).
	339	* It scans for the correct place to put the version, so does not need U-Boot
	340	* to have actually written the tables itself (e.g. if a previous bootloader
	341	* did it).
	342	*
	343	* @smbios_tab: Start of SMBIOS tables
	344	* @version: New version string to use
185f812c	345	* Return: 0 if OK, -ENOENT if no version string was previously written,
272e62cb SG	346	* -ENOSPC if the new string is too large to fit
	347	*/
	348	int smbios_update_version_full(void smbios_tab, const char version);
	349
3d49ee85 MK	350	/**
	351	* smbios_prepare_measurement() - Update smbios table for the measurement
	352	*
	353	* TCG specification requires to measure static configuration information.
	354	* This function clear the device dependent parameters such as
	355	* serial number for the measurement.
	356	*
2497f6a8	357	* @entry: pointer to a struct smbios3_entry
3d49ee85 MK	358	* @header: pointer to a struct smbios_header
3d49ee85 MK	359	*/
2497f6a8	360	void smbios_prepare_measurement(const struct smbios3_entry *entry,
3d49ee85 MK	361	struct smbios_header *header);
3d49ee85 MK	362
721e992a	363	#endif /* _SMBIOS_H_ */