include/sound/sof/ext_manifest.h

   1 /* SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause) */
   2 /*
   3  * This file is provided under a dual BSD/GPLv2 license.  When using or
   4  * redistributing this file, you may do so under either license.
   5  *
   6  * Copyright(c) 2020 Intel Corporation
   7  */
   8
   9 /*
  10  * Extended manifest is a place to store metadata about firmware, known during
  11  * compilation time - for example firmware version or used compiler.
  12  * Given information are read on host side before firmware startup.
  13  * This part of output binary is not signed.
  14  */
  15
  16 #ifndef __SOF_FIRMWARE_EXT_MANIFEST_H__
  17 #define __SOF_FIRMWARE_EXT_MANIFEST_H__
  18
  19 #include <linux/bits.h>
  20 #include <linux/compiler.h>
  21 #include <linux/types.h>
  22 #include <sound/sof/info.h>
  23
  24 /* In ASCII `XMan` */
  25 #define SOF_EXT_MAN_MAGIC_NUMBER        0x6e614d58
  26
  27 /* Build u32 number in format MMmmmppp */
  28 #define SOF_EXT_MAN_BUILD_VERSION(MAJOR, MINOR, PATH) ((uint32_t)( \
  29         ((MAJOR) << 24) | \
  30         ((MINOR) << 12) | \
  31         (PATH)))
  32
  33 /* check extended manifest version consistency */
  34 #define SOF_EXT_MAN_VERSION_INCOMPATIBLE(host_ver, cli_ver) ( \
  35         ((host_ver) & GENMASK(31, 24)) != \
  36         ((cli_ver) & GENMASK(31, 24)))
  37
  38 /* used extended manifest header version */
  39 #define SOF_EXT_MAN_VERSION             SOF_EXT_MAN_BUILD_VERSION(1, 0, 0)
  40
  41 /* extended manifest header, deleting any field breaks backward compatibility */
  42 struct sof_ext_man_header {
  43         uint32_t magic;         /*< identification number, */
  44                                 /*< EXT_MAN_MAGIC_NUMBER */
  45         uint32_t full_size;     /*< [bytes] full size of ext_man, */
  46                                 /*< (header + content + padding) */
  47         uint32_t header_size;   /*< [bytes] makes header extensionable, */
  48                                 /*< after append new field to ext_man header */
  49                                 /*< then backward compatible won't be lost */
  50         uint32_t header_version; /*< value of EXT_MAN_VERSION */
  51                                 /*< not related with following content */
  52
  53         /* just after this header should be list of ext_man_elem_* elements */
  54 } __packed;
  55
  56 /* Now define extended manifest elements */
  57
  58 /* Extended manifest elements types */
  59 enum sof_ext_man_elem_type {
  60         SOF_EXT_MAN_ELEM_FW_VERSION             = 0,
  61         SOF_EXT_MAN_ELEM_WINDOW                 = 1,
  62         SOF_EXT_MAN_ELEM_CC_VERSION             = 2,
  63         SOF_EXT_MAN_ELEM_PROBE_INFO             = 3,
  64         SOF_EXT_MAN_ELEM_DBG_ABI                = 4,
  65         SOF_EXT_MAN_ELEM_CONFIG_DATA            = 5, /**< ABI3.17 */
  66         SOF_EXT_MAN_ELEM_PLATFORM_CONFIG_DATA   = 6,
  67 };
  68
  69 /* extended manifest element header */
  70 struct sof_ext_man_elem_header {
  71         uint32_t type;          /*< SOF_EXT_MAN_ELEM_ */
  72         uint32_t size;          /*< in bytes, including header size */
  73
  74         /* just after this header should be type dependent content */
  75 } __packed;
  76
  77 /* FW version */
  78 struct sof_ext_man_fw_version {
  79         struct sof_ext_man_elem_header hdr;
  80         /* use sof_ipc struct because of code re-use */
  81         struct sof_ipc_fw_version version;
  82         uint32_t flags;
  83 } __packed;
  84
  85 /* extended data memory windows for IPC, trace and debug */
  86 struct sof_ext_man_window {
  87         struct sof_ext_man_elem_header hdr;
  88         /* use sof_ipc struct because of code re-use */
  89         struct sof_ipc_window ipc_window;
  90 } __packed;
  91
  92 /* Used C compiler description */
  93 struct sof_ext_man_cc_version {
  94         struct sof_ext_man_elem_header hdr;
  95         /* use sof_ipc struct because of code re-use */
  96         struct sof_ipc_cc_version cc_version;
  97 } __packed;
  98
  99 struct ext_man_dbg_abi {
 100         struct sof_ext_man_elem_header hdr;
 101         /* use sof_ipc struct because of code re-use */
 102         struct sof_ipc_user_abi_version dbg_abi;
 103 } __packed;
 104
 105 /* EXT_MAN_ELEM_CONFIG_DATA elements identificators, ABI3.17 */
 106 enum config_elem_type {
 107         SOF_EXT_MAN_CONFIG_EMPTY                = 0,
 108         SOF_EXT_MAN_CONFIG_IPC_MSG_SIZE         = 1,
 109         SOF_EXT_MAN_CONFIG_MEMORY_USAGE_SCAN    = 2, /**< ABI 3.18 */
 110 };
 111
 112 struct sof_config_elem {
 113         uint32_t token;
 114         uint32_t value;
 115 } __packed;
 116
 117 /* firmware configuration information */
 118 struct sof_ext_man_config_data {
 119         struct sof_ext_man_elem_header hdr;
 120
 121         struct sof_config_elem elems[];
 122 } __packed;
 123
 124 #endif /* __SOF_FIRMWARE_EXT_MANIFEST_H__ */