ti/common/board_detect.h

1 /* SPDX-License-Identifier: GPL-2.0+ */
3  * Library to support early TI EVM EEPROM handling
5  * Copyright (C) 2015-2016 Texas Instruments Incorporated - http://www.ti.com
11 /* TI EEPROM MAGIC Header identifier */
23  * struct ti_am_eeprom - This structure holds data read in from the
30  * @mac_addr: Any MAC addresses written in the EEPROM
32  * The data is this structure is read from the EEPROM on the board.
35  * TI boards with a single MLO and u-boot.
46 /* DRA7 EEPROM MAGIC Header identifier */
52  * struct dra7_eeprom - This structure holds data read in from the DRA7 EVM
62  * The data is this structure is read from the EEPROM on the board.
65  * DRA7 boards with a single MLO and u-boot.
78  * struct ti_common_eeprom - Null terminated, usable EEPROM contents.
103  * ti_i2c_eeprom_am_get() - Consolidated eeprom data collection for AM* TI EVMs
113  * ti_i2c_eeprom_dra7_get() - Consolidated eeprom data for DRA7 TI EVMs
120  * board_ti_is() - Board detection logic for TI EVMs
121  * @name_tag:	Tag used in eeprom for the board
123  * Return: false if board information does not match OR eeprom wasn't read.
129  * board_ti_rev_is() - Compare board revision for TI EVMs
130  * @rev_tag:	Revision tag to check in eeprom
135  * Return: false if board information does not match OR eeprom wasn't read.
141  * board_ti_get_rev() - Get board revision for TI EVMs
143  * Return: Empty string if eeprom wasn't read.
149  * board_ti_get_config() - Get board config for TI EVMs
151  * Return: Empty string if eeprom wasn't read.
157  * board_ti_get_name() - Get board name for TI EVMs
159  * Return: Empty string if eeprom wasn't read.
165  * board_ti_get_eth_mac_addr() - Get Ethernet MAC address from EEPROM MAC list
169  * Does not sanity check the mac_addr. Whatever is stored in EEPROM is returned.
174  * board_ti_get_emif1_size() - Get size of the DDR on emif1 for TI EVMs
176  * Return: NULL if eeprom wasn't read or emif1_size is not available.
181  * board_ti_get_emif2_size() - Get size of the DDR on emif2 for TI EVMs
183  * Return: NULL if eeprom wasn't read or emif2_size is not available.
188  * set_board_info_env() - Setup commonly used board information environment vars
196  * board_ti_set_ethaddr- Sets the ethaddr environment from EEPROM
199  * EEPROM should be already read before calling this function.
200  * The EEPROM contains 2 MAC addresses which define the MAC address
208  * board_ti_was_eeprom_read() - Check to see if the eeprom contents have been read
210  * This function is useful to determine if the eeprom has already been read and
212  * number that the header value is set to upon successful eeprom read.
217  * ti_i2c_eeprom_am_set() - Setup the eeprom data with predefined values
221  * In some cases such as in RTC-only mode, we are able to skip reading eeprom
224  * a handy function to pre-program information.
226  * NOTE: many eeprom information such as serial number, mac address etc is not