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) 2018 Intel Corporation. All rights reserved. 7 */ 8 9 /* 10 * Firmware file format . 11 */ 12 13 #ifndef __INCLUDE_UAPI_SOF_FW_H__ 14 #define __INCLUDE_UAPI_SOF_FW_H__ 15 16 #include <linux/types.h> 17 18 #define SND_SOF_FW_SIG_SIZE 4 19 #define SND_SOF_FW_ABI 1 20 #define SND_SOF_FW_SIG "Reef" 21 22 /* 23 * Firmware module is made up of 1 . N blocks of different types. The 24 * Block header is used to determine where and how block is to be copied in the 25 * DSP/host memory space. 26 */ 27 enum snd_sof_fw_blk_type { 28 SOF_FW_BLK_TYPE_INVALID = -1, 29 SOF_FW_BLK_TYPE_START = 0, 30 SOF_FW_BLK_TYPE_RSRVD0 = SOF_FW_BLK_TYPE_START, 31 SOF_FW_BLK_TYPE_IRAM = 1, /* local instruction RAM */ 32 SOF_FW_BLK_TYPE_DRAM = 2, /* local data RAM */ 33 SOF_FW_BLK_TYPE_SRAM = 3, /* system RAM */ 34 SOF_FW_BLK_TYPE_ROM = 4, 35 SOF_FW_BLK_TYPE_IMR = 5, 36 SOF_FW_BLK_TYPE_RSRVD6 = 6, 37 SOF_FW_BLK_TYPE_RSRVD7 = 7, 38 SOF_FW_BLK_TYPE_RSRVD8 = 8, 39 SOF_FW_BLK_TYPE_RSRVD9 = 9, 40 SOF_FW_BLK_TYPE_RSRVD10 = 10, 41 SOF_FW_BLK_TYPE_RSRVD11 = 11, 42 SOF_FW_BLK_TYPE_RSRVD12 = 12, 43 SOF_FW_BLK_TYPE_RSRVD13 = 13, 44 SOF_FW_BLK_TYPE_RSRVD14 = 14, 45 /* use SOF_FW_BLK_TYPE_RSVRDX for new block types */ 46 SOF_FW_BLK_TYPE_NUM 47 }; 48 49 struct snd_sof_blk_hdr { 50 enum snd_sof_fw_blk_type type; 51 __u32 size; /* bytes minus this header */ 52 __u32 offset; /* offset from base */ 53 } __packed; 54 55 /* 56 * Firmware file is made up of 1 .. N different modules types. The module 57 * type is used to determine how to load and parse the module. 58 */ 59 enum snd_sof_fw_mod_type { 60 SOF_FW_BASE = 0, /* base firmware image */ 61 SOF_FW_MODULE = 1, /* firmware module */ 62 }; 63 64 struct snd_sof_mod_hdr { 65 enum snd_sof_fw_mod_type type; 66 __u32 size; /* bytes minus this header */ 67 __u32 num_blocks; /* number of blocks */ 68 } __packed; 69 70 /* 71 * Firmware file header. 72 */ 73 struct snd_sof_fw_header { 74 unsigned char sig[SND_SOF_FW_SIG_SIZE]; /* "Reef" */ 75 __u32 file_size; /* size of file minus this header */ 76 __u32 num_modules; /* number of modules */ 77 __u32 abi; /* version of header format */ 78 } __packed; 79 80 #endif 81