linux/habanalabs/hl_boot_if.h

1 /* SPDX-License-Identifier: GPL-2.0
3  * Copyright 2018-2023 HabanaLabs, Ltd.
11 #define LKD_HARD_RESET_MAGIC		0xED7BD694 /* deprecated - do not use */
47  * will clear the non-relevant ones.
67  *					Boot continues as usual, but keep in
89  *					started, but is not ready yet - chip
114  * CPU_BOOT_ERR0_PLL_FAIL		PLL settings failed, meaning that one
139  * CPU_BOOT_ERR0_ENABLED		Error registers enabled.
206  * CPU_BOOT_DEV_STS0_SECURITY_EN	Security is Enabled.
208  *					enabled in FW, which means that
210  *					device is indicated as security enabled,
215  * CPU_BOOT_DEV_STS0_DEBUG_EN		Debug is enabled.
216  *					Enabled when JTAG or DEBUG is enabled
220  * CPU_BOOT_DEV_STS0_WATCHDOG_EN	Watchdog is enabled.
221  *					Watchdog is enabled in FW.
224  * CPU_BOOT_DEV_STS0_DRAM_INIT_EN	DRAM initialization is enabled.
226  *					Initialized in: u-boot
228  * CPU_BOOT_DEV_STS0_BMC_WAIT_EN	Waiting for BMC data enabled.
231  *					Initialized in: u-boot
235  *					Initialized in: u-boot
239  *					Initialized in: u-boot
243  *					Initialized in: u-boot
245  * CPU_BOOT_DEV_STS0_SRAM_SCR_EN	SRAM scrambler enabled.
249  * CPU_BOOT_DEV_STS0_DRAM_SCR_EN	DRAM scrambler enabled.
251  *					Initialized in: u-boot
253  * CPU_BOOT_DEV_STS0_FW_HARD_RST_EN	FW hard reset procedure is enabled.
257  *					receiving the halt-machine event.
258  *					Initialized in: preboot, u-boot, linux
260  * CPU_BOOT_DEV_STS0_PLL_INFO_EN	FW retrieval of PLL info is enabled.
267  * CPU_BOOT_DEV_STS0_CLK_GATE_EN	Clock Gating enabled.
271  * CPU_BOOT_DEV_STS0_HBM_ECC_EN		HBM ECC handling Enabled.
280  *					protocol is enabled.
283  * CPU_BOOT_DEV_STS0_FW_IATU_CONF_EN	FW iATU configuration is enabled.
292  * CPU_BOOT_DEV_STS0_DYN_PLL_EN		Dynamic PLL configuration is enabled.
338  *					Initialized in: zephyr-mgmt
344  *					Initialized in: zephyr-mgmt
346  * CPU_BOOT_DEV_STS0_ENABLED		Device status register enabled.
394 	CPU_BOOT_STATUS_IN_SPL,		/* deprecated - not reported */
396 	CPU_BOOT_STATUS_DRAM_INIT_FAIL,	/* deprecated - will be removed */
397 	CPU_BOOT_STATUS_FIT_CORRUPTED,	/* deprecated - will be removed */
398 	/* U-Boot console prompt activated, commands are not processed */
402 	CPU_BOOT_STATUS_TS_INIT_FAIL,	/* deprecated - will be removed */
403 	CPU_BOOT_STATUS_DRAM_SKIPPED,	/* deprecated - will be removed */
404 	CPU_BOOT_STATUS_BMC_WAITING_SKIPPED, /* deprecated - will be removed */
407 	/* Internal Boot finished, ready for boot-fit */
431 /* communication registers mapping - consider ABI when changing */
475 /* HCDM - Habana Communications Descriptor Magic */
479 /* HCMv - Habana Communications Message + header version */
514  * @tpc_mask_l - TPC binning information lower 64 bit
515  * @dec_mask - Decoder binning information
516  * @dram_mask - DRAM binning information
517  * @edma_mask - EDMA binning information
518  * @mme_mask_l - MME binning information lower 32
519  * @mme_mask_h - MME binning information upper 32
520  * @rot_mask - Rotator binning information
521  * @xbar_mask - xBAR binning information
522  * @reserved - reserved field for future binning info w/o ABI change
523  * @tpc_mask_h - TPC binning information upper 64 bit
524  * @nic_mask - NIC binning information
542 /* this is the comms descriptor header - meta data */
551 /* this is the comms message header - meta data */
579 /* this is the main FW descriptor - consider ABI when changing */
626 			__u8 fw_cfg_skip; /* 1 - skip, 0 - don't skip */
638  * COMMS_CLR_STS		Clear status command - FW should clear the
666  * COMMS_GOTO_WFE		Execute WFE command. Allowed only on non-secure
669  * COMMS_SKIP_BMC		Perform actions required for BMC-less servers.
698  * @size	- FW component size
699  * @cmd		- command from enum comms_cmd
739 /* RAM types for FW components loading - defines the base address */
755  * @offset	- an offset from the base of the ram_type shifted right by
760  * @ram_type	- the RAM type that should be used for offset from
762  * @status	- status from enum comms_sts
782  * struct hl_component_versions - versions associated with hl component.