/* SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause) *//* * This file is provided under a dual BSD/GPLv2 license.  When using or * redistributing this file, you may do so under either license. * * Copyright(c) 2020 Intel Corporation */ /* * Extended manifest is a place to store metadata about firmware, known during * compilation time - for example firmware version or used compiler. * Given information are read on host side before firmware startup. * This part of output binary is not signed. */ #ifndef __SOF_FIRMWARE_EXT_MANIFEST_H__#define __SOF_FIRMWARE_EXT_MANIFEST_H__ #include <linux/bits.h>#include <linux/compiler.h>#include <linux/types.h>#include <sound/sof/info.h> /* In ASCII `XMan` */#define SOF_EXT_MAN_MAGIC_NUMBER	0x6e614d58 /* Build u32 number in format MMmmmppp */#define SOF_EXT_MAN_BUILD_VERSION(MAJOR, MINOR, PATH) ((uint32_t)( \	((MAJOR) << 24) | \	((MINOR) << 12) | \	(PATH))) /* check extended manifest version consistency */#define SOF_EXT_MAN_VERSION_INCOMPATIBLE(host_ver, cli_ver) ( \	((host_ver) & GENMASK(31, 24)) != \	((cli_ver) & GENMASK(31, 24))) /* used extended manifest header version */#define SOF_EXT_MAN_VERSION		SOF_EXT_MAN_BUILD_VERSION(1, 0, 0) /* extended manifest header, deleting any field breaks backward compatibility */struct sof_ext_man_header {	uint32_t magic;		/*< identification number, */				/*< EXT_MAN_MAGIC_NUMBER */	uint32_t full_size;	/*< [bytes] full size of ext_man, */				/*< (header + content + padding) */	uint32_t header_size;	/*< [bytes] makes header extensionable, */				/*< after append new field to ext_man header */				/*< then backward compatible won't be lost */	uint32_t header_version; /*< value of EXT_MAN_VERSION */				/*< not related with following content */ 	/* just after this header should be list of ext_man_elem_* elements */} __packed; /* Now define extended manifest elements */ /* Extended manifest elements types */enum sof_ext_man_elem_type {	SOF_EXT_MAN_ELEM_FW_VERSION		= 0,	SOF_EXT_MAN_ELEM_WINDOW			= 1,	SOF_EXT_MAN_ELEM_CC_VERSION		= 2,	SOF_EXT_MAN_ELEM_PROBE_INFO		= 3,	SOF_EXT_MAN_ELEM_DBG_ABI		= 4,	SOF_EXT_MAN_ELEM_CONFIG_DATA		= 5, /**< ABI3.17 */	SOF_EXT_MAN_ELEM_PLATFORM_CONFIG_DATA   = 6,}; /* extended manifest element header */struct sof_ext_man_elem_header {	uint32_t type;		/*< SOF_EXT_MAN_ELEM_ */	uint32_t size;		/*< in bytes, including header size */ 	/* just after this header should be type dependent content */} __packed; /* FW version */struct sof_ext_man_fw_version {	struct sof_ext_man_elem_header hdr;	/* use sof_ipc struct because of code re-use */	struct sof_ipc_fw_version version;	uint32_t flags;} __packed; /* extended data memory windows for IPC, trace and debug */struct sof_ext_man_window {	struct sof_ext_man_elem_header hdr;	/* use sof_ipc struct because of code re-use */	struct sof_ipc_window ipc_window;} __packed; /* Used C compiler description */struct sof_ext_man_cc_version {	struct sof_ext_man_elem_header hdr;	/* use sof_ipc struct because of code re-use */	struct sof_ipc_cc_version cc_version;} __packed; struct ext_man_dbg_abi {	struct sof_ext_man_elem_header hdr;	/* use sof_ipc struct because of code re-use */	struct sof_ipc_user_abi_version dbg_abi;} __packed; /* EXT_MAN_ELEM_CONFIG_DATA elements identificators, ABI3.17 */enum config_elem_type {	SOF_EXT_MAN_CONFIG_EMPTY		= 0,	SOF_EXT_MAN_CONFIG_IPC_MSG_SIZE		= 1,	SOF_EXT_MAN_CONFIG_MEMORY_USAGE_SCAN	= 2, /**< ABI 3.18 */}; struct sof_config_elem {	uint32_t token;	uint32_t value;} __packed; /* firmware configuration information */struct sof_ext_man_config_data {	struct sof_ext_man_elem_header hdr; 	struct sof_config_elem elems[];} __packed; #endif /* __SOF_FIRMWARE_EXT_MANIFEST_H__ */