76ab546cd8
This step is needed to add possibility to pack sof_ipc_window inside another one in used FW build tools - for example in extended manifest. Structure reusability leads to easy parsing function reuse, so source code is shorter and easier to maintain. Using structures with constant size is less tricky and properly supported by each toolchain by contrast to variable size elements. This is minor ABI change - backward compatibility is kept. Signed-off-by: Karol Trzcinski <karolx.trzcinski@linux.intel.com> Reviewed-by: Guennadi Liakhovetski <guennadi.liakhovetski@linux.intel.com> Reviewed-by: Kai Vehmanen <kai.vehmanen@linux.intel.com> Reviewed-by: Pierre-Louis Bossart <pierre-louis.bossart@linux.intel.com> Signed-off-by: Ranjani Sridharan <ranjani.sridharan@linux.intel.com> Link: https://lore.kernel.org/r/20200825235854.1588034-2-ranjani.sridharan@linux.intel.com Signed-off-by: Mark Brown <broonie@kernel.org>
63 lines
2.0 KiB
C
63 lines
2.0 KiB
C
/* 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) 2018 Intel Corporation. All rights reserved.
|
|
*/
|
|
|
|
/**
|
|
* SOF ABI versioning is based on Semantic Versioning where we have a given
|
|
* MAJOR.MINOR.PATCH version number. See https://semver.org/
|
|
*
|
|
* Rules for incrementing or changing version :-
|
|
*
|
|
* 1) Increment MAJOR version if you make incompatible API changes. MINOR and
|
|
* PATCH should be reset to 0.
|
|
*
|
|
* 2) Increment MINOR version if you add backwards compatible features or
|
|
* changes. PATCH should be reset to 0.
|
|
*
|
|
* 3) Increment PATCH version if you add backwards compatible bug fixes.
|
|
*/
|
|
|
|
#ifndef __INCLUDE_UAPI_SOUND_SOF_ABI_H__
|
|
#define __INCLUDE_UAPI_SOUND_SOF_ABI_H__
|
|
|
|
/* SOF ABI version major, minor and patch numbers */
|
|
#define SOF_ABI_MAJOR 3
|
|
#define SOF_ABI_MINOR 17
|
|
#define SOF_ABI_PATCH 0
|
|
|
|
/* SOF ABI version number. Format within 32bit word is MMmmmppp */
|
|
#define SOF_ABI_MAJOR_SHIFT 24
|
|
#define SOF_ABI_MAJOR_MASK 0xff
|
|
#define SOF_ABI_MINOR_SHIFT 12
|
|
#define SOF_ABI_MINOR_MASK 0xfff
|
|
#define SOF_ABI_PATCH_SHIFT 0
|
|
#define SOF_ABI_PATCH_MASK 0xfff
|
|
|
|
#define SOF_ABI_VER(major, minor, patch) \
|
|
(((major) << SOF_ABI_MAJOR_SHIFT) | \
|
|
((minor) << SOF_ABI_MINOR_SHIFT) | \
|
|
((patch) << SOF_ABI_PATCH_SHIFT))
|
|
|
|
#define SOF_ABI_VERSION_MAJOR(version) \
|
|
(((version) >> SOF_ABI_MAJOR_SHIFT) & SOF_ABI_MAJOR_MASK)
|
|
#define SOF_ABI_VERSION_MINOR(version) \
|
|
(((version) >> SOF_ABI_MINOR_SHIFT) & SOF_ABI_MINOR_MASK)
|
|
#define SOF_ABI_VERSION_PATCH(version) \
|
|
(((version) >> SOF_ABI_PATCH_SHIFT) & SOF_ABI_PATCH_MASK)
|
|
|
|
#define SOF_ABI_VERSION_INCOMPATIBLE(sof_ver, client_ver) \
|
|
(SOF_ABI_VERSION_MAJOR((sof_ver)) != \
|
|
SOF_ABI_VERSION_MAJOR((client_ver)) \
|
|
)
|
|
|
|
#define SOF_ABI_VERSION SOF_ABI_VER(SOF_ABI_MAJOR, SOF_ABI_MINOR, SOF_ABI_PATCH)
|
|
|
|
/* SOF ABI magic number "SOF\0". */
|
|
#define SOF_ABI_MAGIC 0x00464F53
|
|
|
|
#endif
|