arch/arm/mach-tegra/board2.c - filogic/uboot - Gitiles

 /*
  *  (C) Copyright 2010,2011
  *  NVIDIA Corporation <www.nvidia.com>
  *
  * SPDX-License-Identifier:	GPL-2.0+
  */

 #include <common.h>
 #include <dm.h>
 #include <errno.h>
 #include <ns16550.h>
 #include <linux/compiler.h>
 #include <linux/sizes.h>
 #include <asm/io.h>
 #include <asm/arch/clock.h>
 #ifdef CONFIG_LCD
 #include <asm/arch/display.h>
 #endif
 #include <asm/arch/funcmux.h>
 #include <asm/arch/pinmux.h>
 #include <asm/arch/pmu.h>
 #ifdef CONFIG_PWM_TEGRA
 #include <asm/arch/pwm.h>
 #endif
 #include <asm/arch/tegra.h>
 #include <asm/arch-tegra/ap.h>
 #include <asm/arch-tegra/board.h>
 #include <asm/arch-tegra/clk_rst.h>
 #include <asm/arch-tegra/pmc.h>
 #include <asm/arch-tegra/sys_proto.h>
 #include <asm/arch-tegra/uart.h>
 #include <asm/arch-tegra/warmboot.h>
 #include <asm/arch-tegra/gpu.h>
 #ifdef CONFIG_TEGRA_CLOCK_SCALING
 #include <asm/arch/emc.h>
 #endif
 #include <asm/arch-tegra/usb.h>
 #ifdef CONFIG_USB_EHCI_TEGRA
 #include <usb.h>
 #endif
 #ifdef CONFIG_TEGRA_MMC
 #include <asm/arch-tegra/tegra_mmc.h>
 #include <asm/arch-tegra/mmc.h>
 #endif
 #include <asm/arch-tegra/xusb-padctl.h>
 #include <power/as3722.h>
 #include <i2c.h>
 #include <spi.h>
 #include "emc.h"

 DECLARE_GLOBAL_DATA_PTR;

 #ifdef CONFIG_SPL_BUILD
 /* TODO(sjg@chromium.org): Remove once SPL supports device tree */
 U_BOOT_DEVICE(tegra_gpios) = {
 	"gpio_tegra"
 };
 #endif

 __weak void pinmux_init(void) {}
 __weak void pin_mux_usb(void) {}
 __weak void pin_mux_spi(void) {}
 __weak void gpio_early_init_uart(void) {}
 __weak void pin_mux_display(void) {}
 __weak void start_cpu_fan(void) {}

 #if defined(CONFIG_TEGRA_NAND)
 __weak void pin_mux_nand(void)
 {
 	funcmux_select(PERIPH_ID_NDFLASH, FUNCMUX_DEFAULT);
 }
 #endif

 /*
  * Routine: power_det_init
  * Description: turn off power detects
  */
 static void power_det_init(void)
 {
 #if defined(CONFIG_TEGRA20)
 	struct pmc_ctlr *const pmc = (struct pmc_ctlr *)NV_PA_PMC_BASE;

 	/* turn off power detects */
 	writel(0, &pmc->pmc_pwr_det_latch);
 	writel(0, &pmc->pmc_pwr_det);
 #endif
 }

 __weak int tegra_board_id(void)
 {
 	return -1;
 }

 #ifdef CONFIG_DISPLAY_BOARDINFO
 int checkboard(void)
 {
 	int board_id = tegra_board_id();

 	printf("Board: %s", CONFIG_TEGRA_BOARD_STRING);
 	if (board_id != -1)
 		printf(", ID: %d\n", board_id);
 	printf("\n");

 	return 0;
 }
 #endif	/* CONFIG_DISPLAY_BOARDINFO */

 __weak int tegra_lcd_pmic_init(int board_it)
 {
 	return 0;
 }

 __weak int nvidia_board_init(void)
 {
 	return 0;
 }

 /*
  * Routine: board_init
  * Description: Early hardware init.
  */
 int board_init(void)
 {
 	__maybe_unused int err;
 	__maybe_unused int board_id;

 	/* Do clocks and UART first so that printf() works */
 	clock_init();
 	clock_verify();

 	tegra_gpu_config();

 #ifdef CONFIG_TEGRA_SPI
 	pin_mux_spi();
 #endif

 	/* Init is handled automatically in the driver-model case */
 #if defined(CONFIG_PWM_TEGRA) && !defined(CONFIG_PWM)
 	if (pwm_init(gd->fdt_blob))
 		debug("%s: Failed to init pwm\n", __func__);
 #endif
 #if defined(CONFIG_LCD) || defined(CONFIG_DM_VIDEO)
 	pin_mux_display();
 #endif
 #ifdef CONFIG_LCD
 	tegra_lcd_check_next_stage(gd->fdt_blob, 0);
 #endif
 	/* boot param addr */
 	gd->bd->bi_boot_params = (NV_PA_SDRAM_BASE + 0x100);

 	power_det_init();

 #ifdef CONFIG_SYS_I2C_TEGRA
 # ifdef CONFIG_TEGRA_PMU
 	if (pmu_set_nominal())
 		debug("Failed to select nominal voltages\n");
 #  ifdef CONFIG_TEGRA_CLOCK_SCALING
 	err = board_emc_init();
 	if (err)
 		debug("Memory controller init failed: %d\n", err);
 #  endif
 # endif /* CONFIG_TEGRA_PMU */
 #ifdef CONFIG_AS3722_POWER
 	err = as3722_init(NULL);
 	if (err && err != -ENODEV)
 		return err;
 #endif
 #endif /* CONFIG_SYS_I2C_TEGRA */

 #ifdef CONFIG_USB_EHCI_TEGRA
 	pin_mux_usb();
 #endif

 #if defined(CONFIG_LCD) || defined(CONFIG_DM_VIDEO)
 	board_id = tegra_board_id();
 	err = tegra_lcd_pmic_init(board_id);
 	if (err)
 		return err;
 #endif
 #ifdef CONFIG_LCD
 	tegra_lcd_check_next_stage(gd->fdt_blob, 0);
 #endif

 #ifdef CONFIG_TEGRA_NAND
 	pin_mux_nand();
 #endif

 	tegra_xusb_padctl_init(gd->fdt_blob);

 #ifdef CONFIG_TEGRA_LP0
 	/* save Sdram params to PMC 2, 4, and 24 for WB0 */
 	warmboot_save_sdram_params();

 	/* prepare the WB code to LP0 location */
 	warmboot_prepare_code(TEGRA_LP0_ADDR, TEGRA_LP0_SIZE);
 #endif
 	return nvidia_board_init();
 }

 #ifdef CONFIG_BOARD_EARLY_INIT_F
 static void __gpio_early_init(void)
 {
 }

 void gpio_early_init(void) __attribute__((weak, alias("__gpio_early_init")));

 int board_early_init_f(void)
 {
 #if defined(CONFIG_TEGRA_DISCONNECT_UDC_ON_BOOT)
 #define USBCMD_FS2 (1 << 15)
 	{
 		struct usb_ctlr *usbctlr = (struct usb_ctlr *)0x7d000000;
 		writel(USBCMD_FS2, &usbctlr->usb_cmd);
 	}
 #endif

 	/* Do any special system timer/TSC setup */
 #if defined(CONFIG_TEGRA_SUPPORT_NON_SECURE)
 	if (!tegra_cpu_is_non_secure())
 #endif
 		arch_timer_init();

 	pinmux_init();
 	board_init_uart_f();

 	/* Initialize periph GPIOs */
 	gpio_early_init();
 	gpio_early_init_uart();
 #ifdef CONFIG_LCD
 	tegra_lcd_early_init(gd->fdt_blob);
 #endif

 	return 0;
 }
 #endif	/* EARLY_INIT */

 int board_late_init(void)
 {
 #ifdef CONFIG_LCD
 	/* Make sure we finish initing the LCD */
 	tegra_lcd_check_next_stage(gd->fdt_blob, 1);
 #endif
 #if defined(CONFIG_TEGRA_SUPPORT_NON_SECURE)
 	if (tegra_cpu_is_non_secure()) {
 		printf("CPU is in NS mode\n");
 		setenv("cpu_ns_mode", "1");
 	} else {
 		setenv("cpu_ns_mode", "");
 	}
 #endif
 	start_cpu_fan();

 	return 0;
 }

 #if defined(CONFIG_TEGRA_MMC)
 __weak void pin_mux_mmc(void)
 {
 }

 /* this is a weak define that we are overriding */
 int board_mmc_init(bd_t *bd)
 {
 	debug("%s called\n", __func__);

 	/* Enable muxes, etc. for SDMMC controllers */
 	pin_mux_mmc();

 	debug("%s: init MMC\n", __func__);
 	tegra_mmc_init();

 	return 0;
 }

 void pad_init_mmc(struct mmc_host *host)
 {
 #if defined(CONFIG_TEGRA30)
 	enum periph_id id = host->mmc_id;
 	u32 val;

 	debug("%s: sdmmc address = %08x, id = %d\n", __func__,
 		(unsigned int)host->reg, id);

 	/* Set the pad drive strength for SDMMC1 or 3 only */
 	if (id != PERIPH_ID_SDMMC1 && id != PERIPH_ID_SDMMC3) {
 		debug("%s: settings are only valid for SDMMC1/SDMMC3!\n",
 			__func__);
 		return;
 	}

 	val = readl(&host->reg->sdmemcmppadctl);
 	val &= 0xFFFFFFF0;
 	val |= MEMCOMP_PADCTRL_VREF;
 	writel(val, &host->reg->sdmemcmppadctl);

 	val = readl(&host->reg->autocalcfg);
 	val &= 0xFFFF0000;
 	val |= AUTO_CAL_PU_OFFSET | AUTO_CAL_PD_OFFSET | AUTO_CAL_ENABLED;
 	writel(val, &host->reg->autocalcfg);
 #endif	/* T30 */
 }
 #endif	/* MMC */

 /*
  * In some SW environments, a memory carve-out exists to house a secure
  * monitor, a trusted OS, and/or various statically allocated media buffers.
  *
  * This carveout exists at the highest possible address that is within a
  * 32-bit physical address space.
  *
  * This function returns the total size of this carve-out. At present, the
  * returned value is hard-coded for simplicity. In the future, it may be
  * possible to determine the carve-out size:
  * - By querying some run-time information source, such as:
  *   - A structure passed to U-Boot by earlier boot software.
  *   - SoC registers.
  *   - A call into the secure monitor.
  * - In the per-board U-Boot configuration header, based on knowledge of the
  *   SW environment that U-Boot is being built for.
  *
  * For now, we support two configurations in U-Boot:
  * - 32-bit ports without any form of carve-out.
  * - 64 bit ports which are assumed to use a carve-out of a conservatively
  *   hard-coded size.
  */
 static ulong carveout_size(void)
 {
 #ifdef CONFIG_ARM64
 	return SZ_512M;
 #else
 	return 0;
 #endif
 }

 /*
  * Determine the amount of usable RAM below 4GiB, taking into account any
  * carve-out that may be assigned.
  */
 static ulong usable_ram_size_below_4g(void)
 {
 	ulong total_size_below_4g;
 	ulong usable_size_below_4g;

 	/*
 	 * The total size of RAM below 4GiB is the lesser address of:
 	 * (a) 2GiB itself (RAM starts at 2GiB, and 4GiB - 2GiB == 2GiB).
 	 * (b) The size RAM physically present in the system.
 	 */
 	if (gd->ram_size < SZ_2G)
 		total_size_below_4g = gd->ram_size;
 	else
 		total_size_below_4g = SZ_2G;

 	/* Calculate usable RAM by subtracting out any carve-out size */
 	usable_size_below_4g = total_size_below_4g - carveout_size();

 	return usable_size_below_4g;
 }

 /*
  * Represent all available RAM in either one or two banks.
  *
  * The first bank describes any usable RAM below 4GiB.
  * The second bank describes any RAM above 4GiB.
  *
  * This split is driven by the following requirements:
  * - The NVIDIA L4T kernel requires separate entries in the DT /memory/reg
  *   property for memory below and above the 4GiB boundary. The layout of that
  *   DT property is directly driven by the entries in the U-Boot bank array.
  * - The potential existence of a carve-out at the end of RAM below 4GiB can
  *   only be represented using multiple banks.
  *
  * Explicitly removing the carve-out RAM from the bank entries makes the RAM
  * layout a bit more obvious, e.g. when running "bdinfo" at the U-Boot
  * command-line.
  *
  * This does mean that the DT U-Boot passes to the Linux kernel will not
  * include this RAM in /memory/reg at all. An alternative would be to include
  * all RAM in the U-Boot banks (and hence DT), and add a /memreserve/ node
  * into DT to stop the kernel from using the RAM. IIUC, I don't /think/ the
  * Linux kernel will ever need to access any RAM in* the carve-out via a CPU
  * mapping, so either way is acceptable.
  *
  * On 32-bit systems, we never define a bank for RAM above 4GiB, since the
  * start address of that bank cannot be represented in the 32-bit .size
  * field.
  */
 void dram_init_banksize(void)
 {
 	gd->bd->bi_dram[0].start = CONFIG_SYS_SDRAM_BASE;
 	gd->bd->bi_dram[0].size = usable_ram_size_below_4g();

 #ifdef CONFIG_PCI
 	gd->pci_ram_top = gd->bd->bi_dram[0].start + gd->bd->bi_dram[0].size;
 #endif

 #ifdef CONFIG_PHYS_64BIT
 	if (gd->ram_size > SZ_2G) {
 		gd->bd->bi_dram[1].start = 0x100000000;
 		gd->bd->bi_dram[1].size = gd->ram_size - SZ_2G;
 	} else
 #endif
 	{
 		gd->bd->bi_dram[1].start = 0;
 		gd->bd->bi_dram[1].size = 0;
 	}
 }

 /*
  * Most hardware on 64-bit Tegra is still restricted to DMA to the lower
  * 32-bits of the physical address space. Cap the maximum usable RAM area
  * at 4 GiB to avoid DMA buffers from being allocated beyond the 32-bit
  * boundary that most devices can address. Also, don't let U-Boot use any
  * carve-out, as mentioned above.
  *
  * This function is called before dram_init_banksize(), so we can't simply
  * return gd->bd->bi_dram[1].start + gd->bd->bi_dram[1].size.
  */
 ulong board_get_usable_ram_top(ulong total_size)
 {
 	return CONFIG_SYS_SDRAM_BASE + usable_ram_size_below_4g();
 }

 /*
  * This function is called right before the kernel is booted. "blob" is the
  * device tree that will be passed to the kernel.
  */
 int ft_system_setup(void *blob, bd_t *bd)
 {
 	const char *gpu_path =
 #if defined(CONFIG_TEGRA124) || defined(CONFIG_TEGRA210)
 		"/gpu@0,57000000";
 #else
 		NULL;
 #endif

 	/* Enable GPU node if GPU setup has been performed */
 	if (gpu_path != NULL)
 		return tegra_gpu_enable_node(blob, gpu_path);

 	return 0;
 }
	/*
	* (C) Copyright 2010,2011
	* NVIDIA Corporation <www.nvidia.com>
	*
	* SPDX-License-Identifier: GPL-2.0+
	*/

	#include <common.h>
	#include <dm.h>
	#include <errno.h>
	#include <ns16550.h>
	#include <linux/compiler.h>
	#include <linux/sizes.h>
	#include <asm/io.h>
	#include <asm/arch/clock.h>
	#ifdef CONFIG_LCD
	#include <asm/arch/display.h>
	#endif
	#include <asm/arch/funcmux.h>
	#include <asm/arch/pinmux.h>
	#include <asm/arch/pmu.h>
	#ifdef CONFIG_PWM_TEGRA
	#include <asm/arch/pwm.h>
	#endif
	#include <asm/arch/tegra.h>
	#include <asm/arch-tegra/ap.h>
	#include <asm/arch-tegra/board.h>
	#include <asm/arch-tegra/clk_rst.h>
	#include <asm/arch-tegra/pmc.h>
	#include <asm/arch-tegra/sys_proto.h>
	#include <asm/arch-tegra/uart.h>
	#include <asm/arch-tegra/warmboot.h>
	#include <asm/arch-tegra/gpu.h>
	#ifdef CONFIG_TEGRA_CLOCK_SCALING
	#include <asm/arch/emc.h>
	#endif
	#include <asm/arch-tegra/usb.h>
	#ifdef CONFIG_USB_EHCI_TEGRA
	#include <usb.h>
	#endif
	#ifdef CONFIG_TEGRA_MMC
	#include <asm/arch-tegra/tegra_mmc.h>
	#include <asm/arch-tegra/mmc.h>
	#endif
	#include <asm/arch-tegra/xusb-padctl.h>
	#include <power/as3722.h>
	#include <i2c.h>
	#include <spi.h>
	#include "emc.h"

	DECLARE_GLOBAL_DATA_PTR;

	#ifdef CONFIG_SPL_BUILD
	/* TODO(sjg@chromium.org): Remove once SPL supports device tree */
	U_BOOT_DEVICE(tegra_gpios) = {
	"gpio_tegra"
	};
	#endif

	__weak void pinmux_init(void) {}
	__weak void pin_mux_usb(void) {}
	__weak void pin_mux_spi(void) {}
	__weak void gpio_early_init_uart(void) {}
	__weak void pin_mux_display(void) {}
	__weak void start_cpu_fan(void) {}

	#if defined(CONFIG_TEGRA_NAND)
	__weak void pin_mux_nand(void)
	{
	funcmux_select(PERIPH_ID_NDFLASH, FUNCMUX_DEFAULT);
	}
	#endif

	/*
	* Routine: power_det_init
	* Description: turn off power detects
	*/
	static void power_det_init(void)
	{
	#if defined(CONFIG_TEGRA20)
	struct pmc_ctlr const pmc = (struct pmc_ctlr )NV_PA_PMC_BASE;

	/* turn off power detects */
	writel(0, &pmc->pmc_pwr_det_latch);
	writel(0, &pmc->pmc_pwr_det);
	#endif
	}

	__weak int tegra_board_id(void)
	{
	return -1;
	}

	#ifdef CONFIG_DISPLAY_BOARDINFO
	int checkboard(void)
	{
	int board_id = tegra_board_id();

	printf("Board: %s", CONFIG_TEGRA_BOARD_STRING);
	if (board_id != -1)
	printf(", ID: %d\n", board_id);
	printf("\n");

	return 0;
	}
	#endif /* CONFIG_DISPLAY_BOARDINFO */

	__weak int tegra_lcd_pmic_init(int board_it)
	{
	return 0;
	}

	__weak int nvidia_board_init(void)
	{
	return 0;
	}

	/*
	* Routine: board_init
	* Description: Early hardware init.
	*/
	int board_init(void)
	{
	__maybe_unused int err;
	__maybe_unused int board_id;

	/* Do clocks and UART first so that printf() works */
	clock_init();
	clock_verify();

	tegra_gpu_config();

	#ifdef CONFIG_TEGRA_SPI
	pin_mux_spi();
	#endif

	/* Init is handled automatically in the driver-model case */
	#if defined(CONFIG_PWM_TEGRA) && !defined(CONFIG_PWM)
	if (pwm_init(gd->fdt_blob))
	debug("%s: Failed to init pwm\n", __func__);
	#endif
	#if defined(CONFIG_LCD) \|\| defined(CONFIG_DM_VIDEO)
	pin_mux_display();
	#endif
	#ifdef CONFIG_LCD
	tegra_lcd_check_next_stage(gd->fdt_blob, 0);
	#endif
	/* boot param addr */
	gd->bd->bi_boot_params = (NV_PA_SDRAM_BASE + 0x100);

	power_det_init();

	#ifdef CONFIG_SYS_I2C_TEGRA
	# ifdef CONFIG_TEGRA_PMU
	if (pmu_set_nominal())
	debug("Failed to select nominal voltages\n");
	# ifdef CONFIG_TEGRA_CLOCK_SCALING
	err = board_emc_init();
	if (err)
	debug("Memory controller init failed: %d\n", err);
	# endif
	# endif /* CONFIG_TEGRA_PMU */
	#ifdef CONFIG_AS3722_POWER
	err = as3722_init(NULL);
	if (err && err != -ENODEV)
	return err;
	#endif
	#endif /* CONFIG_SYS_I2C_TEGRA */

	#ifdef CONFIG_USB_EHCI_TEGRA
	pin_mux_usb();
	#endif

	#if defined(CONFIG_LCD) \|\| defined(CONFIG_DM_VIDEO)
	board_id = tegra_board_id();
	err = tegra_lcd_pmic_init(board_id);
	if (err)
	return err;
	#endif
	#ifdef CONFIG_LCD
	tegra_lcd_check_next_stage(gd->fdt_blob, 0);
	#endif

	#ifdef CONFIG_TEGRA_NAND
	pin_mux_nand();
	#endif

	tegra_xusb_padctl_init(gd->fdt_blob);

	#ifdef CONFIG_TEGRA_LP0
	/* save Sdram params to PMC 2, 4, and 24 for WB0 */
	warmboot_save_sdram_params();

	/* prepare the WB code to LP0 location */
	warmboot_prepare_code(TEGRA_LP0_ADDR, TEGRA_LP0_SIZE);
	#endif
	return nvidia_board_init();
	}

	#ifdef CONFIG_BOARD_EARLY_INIT_F
	static void __gpio_early_init(void)
	{
	}

	void gpio_early_init(void) __attribute__((weak, alias("__gpio_early_init")));

	int board_early_init_f(void)
	{
	#if defined(CONFIG_TEGRA_DISCONNECT_UDC_ON_BOOT)
	#define USBCMD_FS2 (1 << 15)
	{
	struct usb_ctlr usbctlr = (struct usb_ctlr )0x7d000000;
	writel(USBCMD_FS2, &usbctlr->usb_cmd);
	}
	#endif

	/* Do any special system timer/TSC setup */
	#if defined(CONFIG_TEGRA_SUPPORT_NON_SECURE)
	if (!tegra_cpu_is_non_secure())
	#endif
	arch_timer_init();

	pinmux_init();
	board_init_uart_f();

	/* Initialize periph GPIOs */
	gpio_early_init();
	gpio_early_init_uart();
	#ifdef CONFIG_LCD
	tegra_lcd_early_init(gd->fdt_blob);
	#endif

	return 0;
	}
	#endif /* EARLY_INIT */

	int board_late_init(void)
	{
	#ifdef CONFIG_LCD
	/* Make sure we finish initing the LCD */
	tegra_lcd_check_next_stage(gd->fdt_blob, 1);
	#endif
	#if defined(CONFIG_TEGRA_SUPPORT_NON_SECURE)
	if (tegra_cpu_is_non_secure()) {
	printf("CPU is in NS mode\n");
	setenv("cpu_ns_mode", "1");
	} else {
	setenv("cpu_ns_mode", "");
	}
	#endif
	start_cpu_fan();

	return 0;
	}

	#if defined(CONFIG_TEGRA_MMC)
	__weak void pin_mux_mmc(void)
	{
	}

	/* this is a weak define that we are overriding */
	int board_mmc_init(bd_t *bd)
	{
	debug("%s called\n", __func__);

	/* Enable muxes, etc. for SDMMC controllers */
	pin_mux_mmc();

	debug("%s: init MMC\n", __func__);
	tegra_mmc_init();

	return 0;
	}

	void pad_init_mmc(struct mmc_host *host)
	{
	#if defined(CONFIG_TEGRA30)
	enum periph_id id = host->mmc_id;
	u32 val;

	debug("%s: sdmmc address = %08x, id = %d\n", __func__,
	(unsigned int)host->reg, id);

	/* Set the pad drive strength for SDMMC1 or 3 only */
	if (id != PERIPH_ID_SDMMC1 && id != PERIPH_ID_SDMMC3) {
	debug("%s: settings are only valid for SDMMC1/SDMMC3!\n",
	__func__);
	return;
	}

	val = readl(&host->reg->sdmemcmppadctl);
	val &= 0xFFFFFFF0;
	val \|= MEMCOMP_PADCTRL_VREF;
	writel(val, &host->reg->sdmemcmppadctl);

	val = readl(&host->reg->autocalcfg);
	val &= 0xFFFF0000;
	val \|= AUTO_CAL_PU_OFFSET \| AUTO_CAL_PD_OFFSET \| AUTO_CAL_ENABLED;
	writel(val, &host->reg->autocalcfg);
	#endif /* T30 */
	}
	#endif /* MMC */

	/*
	* In some SW environments, a memory carve-out exists to house a secure
	* monitor, a trusted OS, and/or various statically allocated media buffers.
	*
	* This carveout exists at the highest possible address that is within a
	* 32-bit physical address space.
	*
	* This function returns the total size of this carve-out. At present, the
	* returned value is hard-coded for simplicity. In the future, it may be
	* possible to determine the carve-out size:
	* - By querying some run-time information source, such as:
	* - A structure passed to U-Boot by earlier boot software.
	* - SoC registers.
	* - A call into the secure monitor.
	* - In the per-board U-Boot configuration header, based on knowledge of the
	* SW environment that U-Boot is being built for.
	*
	* For now, we support two configurations in U-Boot:
	* - 32-bit ports without any form of carve-out.
	* - 64 bit ports which are assumed to use a carve-out of a conservatively
	* hard-coded size.
	*/
	static ulong carveout_size(void)
	{
	#ifdef CONFIG_ARM64
	return SZ_512M;
	#else
	return 0;
	#endif
	}

	/*
	* Determine the amount of usable RAM below 4GiB, taking into account any
	* carve-out that may be assigned.
	*/
	static ulong usable_ram_size_below_4g(void)
	{
	ulong total_size_below_4g;
	ulong usable_size_below_4g;

	/*
	* The total size of RAM below 4GiB is the lesser address of:
	* (a) 2GiB itself (RAM starts at 2GiB, and 4GiB - 2GiB == 2GiB).
	* (b) The size RAM physically present in the system.
	*/
	if (gd->ram_size < SZ_2G)
	total_size_below_4g = gd->ram_size;
	else
	total_size_below_4g = SZ_2G;

	/* Calculate usable RAM by subtracting out any carve-out size */
	usable_size_below_4g = total_size_below_4g - carveout_size();

	return usable_size_below_4g;
	}

	/*
	* Represent all available RAM in either one or two banks.
	*
	* The first bank describes any usable RAM below 4GiB.
	* The second bank describes any RAM above 4GiB.
	*
	* This split is driven by the following requirements:
	* - The NVIDIA L4T kernel requires separate entries in the DT /memory/reg
	* property for memory below and above the 4GiB boundary. The layout of that
	* DT property is directly driven by the entries in the U-Boot bank array.
	* - The potential existence of a carve-out at the end of RAM below 4GiB can
	* only be represented using multiple banks.
	*
	* Explicitly removing the carve-out RAM from the bank entries makes the RAM
	* layout a bit more obvious, e.g. when running "bdinfo" at the U-Boot
	* command-line.
	*
	* This does mean that the DT U-Boot passes to the Linux kernel will not
	* include this RAM in /memory/reg at all. An alternative would be to include
	* all RAM in the U-Boot banks (and hence DT), and add a /memreserve/ node
	* into DT to stop the kernel from using the RAM. IIUC, I don't /think/ the
	* Linux kernel will ever need to access any RAM in* the carve-out via a CPU
	* mapping, so either way is acceptable.
	*
	* On 32-bit systems, we never define a bank for RAM above 4GiB, since the
	* start address of that bank cannot be represented in the 32-bit .size
	* field.
	*/
	void dram_init_banksize(void)
	{
	gd->bd->bi_dram[0].start = CONFIG_SYS_SDRAM_BASE;
	gd->bd->bi_dram[0].size = usable_ram_size_below_4g();

	#ifdef CONFIG_PCI
	gd->pci_ram_top = gd->bd->bi_dram[0].start + gd->bd->bi_dram[0].size;
	#endif

	#ifdef CONFIG_PHYS_64BIT
	if (gd->ram_size > SZ_2G) {
	gd->bd->bi_dram[1].start = 0x100000000;
	gd->bd->bi_dram[1].size = gd->ram_size - SZ_2G;
	} else
	#endif
	{
	gd->bd->bi_dram[1].start = 0;
	gd->bd->bi_dram[1].size = 0;
	}
	}

	/*
	* Most hardware on 64-bit Tegra is still restricted to DMA to the lower
	* 32-bits of the physical address space. Cap the maximum usable RAM area
	* at 4 GiB to avoid DMA buffers from being allocated beyond the 32-bit
	* boundary that most devices can address. Also, don't let U-Boot use any
	* carve-out, as mentioned above.
	*
	* This function is called before dram_init_banksize(), so we can't simply
	* return gd->bd->bi_dram[1].start + gd->bd->bi_dram[1].size.
	*/
	ulong board_get_usable_ram_top(ulong total_size)
	{
	return CONFIG_SYS_SDRAM_BASE + usable_ram_size_below_4g();
	}

	/*
	* This function is called right before the kernel is booted. "blob" is the
	* device tree that will be passed to the kernel.
	*/
	int ft_system_setup(void blob, bd_t bd)
	{
	const char *gpu_path =
	#if defined(CONFIG_TEGRA124) \|\| defined(CONFIG_TEGRA210)
	"/gpu@0,57000000";
	#else
	NULL;
	#endif

	/* Enable GPU node if GPU setup has been performed */
	if (gpu_path != NULL)
	return tegra_gpu_enable_node(blob, gpu_path);

	return 0;
	}