linux/habanalabs/hl_boot_if.h

1 /* SPDX-License-Identifier: GPL-2.0
3  * Copyright 2018-2020 HabanaLabs, Ltd.
11 #define LKD_HARD_RESET_MAGIC		0xED7BD694 /* deprecated - do not use */
47  * will clear the non-relevant ones.
68  *					Boot continues as usual, but keep in
90  *					started, but is not ready yet - chip
115  * CPU_BOOT_ERR0_PLL_FAIL		PLL settings failed, meaning that one
140  * CPU_BOOT_ERR0_ENABLED		Error registers enabled.
205  * CPU_BOOT_DEV_STS0_SECURITY_EN	Security is Enabled.
207  *					enabled in FW, which means that
209  *					device is indicated as security enabled,
214  * CPU_BOOT_DEV_STS0_DEBUG_EN		Debug is enabled.
215  *					Enabled when JTAG or DEBUG is enabled
219  * CPU_BOOT_DEV_STS0_WATCHDOG_EN	Watchdog is enabled.
220  *					Watchdog is enabled in FW.
223  * CPU_BOOT_DEV_STS0_DRAM_INIT_EN	DRAM initialization is enabled.
225  *					Initialized in: u-boot
227  * CPU_BOOT_DEV_STS0_BMC_WAIT_EN	Waiting for BMC data enabled.
230  *					Initialized in: u-boot
234  *					Initialized in: u-boot
238  *					Initialized in: u-boot
242  *					Initialized in: u-boot
244  * CPU_BOOT_DEV_STS0_SRAM_SCR_EN	SRAM scrambler enabled.
248  * CPU_BOOT_DEV_STS0_DRAM_SCR_EN	DRAM scrambler enabled.
250  *					Initialized in: u-boot
252  * CPU_BOOT_DEV_STS0_FW_HARD_RST_EN	FW hard reset procedure is enabled.
256  *					receiving the halt-machine event.
257  *					Initialized in: preboot, u-boot, linux
259  * CPU_BOOT_DEV_STS0_PLL_INFO_EN	FW retrieval of PLL info is enabled.
266  * CPU_BOOT_DEV_STS0_CLK_GATE_EN	Clock Gating enabled.
270  * CPU_BOOT_DEV_STS0_HBM_ECC_EN		HBM ECC handling Enabled.
279  *					protocol is enabled.
282  * CPU_BOOT_DEV_STS0_FW_IATU_CONF_EN	FW iATU configuration is enabled.
291  * CPU_BOOT_DEV_STS0_DYN_PLL_EN		Dynamic PLL configuration is enabled.
334  * CPU_BOOT_DEV_STS0_ENABLED		Device status register enabled.
380 	CPU_BOOT_STATUS_IN_SPL,		/* deprecated - not reported */
382 	CPU_BOOT_STATUS_DRAM_INIT_FAIL,	/* deprecated - will be removed */
383 	CPU_BOOT_STATUS_FIT_CORRUPTED,	/* deprecated - will be removed */
384 	/* U-Boot console prompt activated, commands are not processed */
388 	CPU_BOOT_STATUS_TS_INIT_FAIL,	/* deprecated - will be removed */
389 	CPU_BOOT_STATUS_DRAM_SKIPPED,	/* deprecated - will be removed */
390 	CPU_BOOT_STATUS_BMC_WAITING_SKIPPED, /* deprecated - will be removed */
393 	/* Internal Boot finished, ready for boot-fit */
417 /* communication registers mapping - consider ABI when changing */
461 /* HCDM - Habana Communications Descriptor Magic */
465 /* HCMv - Habana Communications Message + header version */
500  * @tpc_mask_l - TPC binning information lower 64 bit
501  * @dec_mask - Decoder binning information
502  * @dram_mask - DRAM binning information
503  * @edma_mask - EDMA binning information
504  * @mme_mask_l - MME binning information lower 32
505  * @mme_mask_h - MME binning information upper 32
506  * @rot_mask - Rotator binning information
507  * @xbar_mask - xBAR binning information
508  * @reserved - reserved field for future binning info w/o ABI change
509  * @tpc_mask_h - TPC binning information upper 64 bit
510  * @nic_mask - NIC binning information
528 /* this is the comms descriptor header - meta data */
537 /* this is the comms message header - meta data */
564 /* this is the main FW descriptor - consider ABI when changing */
611 			__u8 fw_cfg_skip; /* 1 - skip, 0 - don't skip */
623  * COMMS_CLR_STS		Clear status command - FW should clear the
651  * COMMS_GOTO_WFE		Execute WFE command. Allowed only on non-secure
654  * COMMS_SKIP_BMC		Perform actions required for BMC-less servers.
683  * @size	- FW component size
684  * @cmd		- command from enum comms_cmd
724 /* RAM types for FW components loading - defines the base address */
740  * @offset	- an offset from the base of the ram_type shifted right by
745  * @ram_type	- the RAM type that should be used for offset from
747  * @status	- status from enum comms_sts
767  * struct hl_component_versions - versions associated with hl component.