[linux-block.git] / include / sound / sof.h

/* SPDX-License-Identifier: (GPL-2.0-only 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
 *
 * Author: Liam Girdwood <liam.r.girdwood@linux.intel.com>
 */

#ifndef __INCLUDE_SOUND_SOF_H
#define __INCLUDE_SOUND_SOF_H

#include <linux/pci.h>
#include <sound/soc.h>
#include <sound/soc-acpi.h>

struct snd_sof_dsp_ops;
struct snd_sof_dev;

/**
 * enum sof_fw_state - DSP firmware state definitions
 * @SOF_FW_BOOT_NOT_STARTED:	firmware boot is not yet started
 * @SOF_DSPLESS_MODE:		DSP is not used
 * @SOF_FW_BOOT_PREPARE:	preparing for boot (firmware loading for exaqmple)
 * @SOF_FW_BOOT_IN_PROGRESS:	firmware boot is in progress
 * @SOF_FW_BOOT_FAILED:		firmware boot failed
 * @SOF_FW_BOOT_READY_FAILED:	firmware booted but fw_ready op failed
 * @SOF_FW_BOOT_READY_OK:	firmware booted and fw_ready op passed
 * @SOF_FW_BOOT_COMPLETE:	firmware is booted up and functional
 * @SOF_FW_CRASHED:		firmware crashed after successful boot
 */
enum sof_fw_state {
	SOF_FW_BOOT_NOT_STARTED = 0,
	SOF_DSPLESS_MODE,
	SOF_FW_BOOT_PREPARE,
	SOF_FW_BOOT_IN_PROGRESS,
	SOF_FW_BOOT_FAILED,
	SOF_FW_BOOT_READY_FAILED,
	SOF_FW_BOOT_READY_OK,
	SOF_FW_BOOT_COMPLETE,
	SOF_FW_CRASHED,
};

/* DSP power states */
enum sof_dsp_power_states {
	SOF_DSP_PM_D0,
	SOF_DSP_PM_D1,
	SOF_DSP_PM_D2,
	SOF_DSP_PM_D3,
};

/* Definitions for multiple IPCs */
enum sof_ipc_type {
	SOF_IPC_TYPE_3,
	SOF_IPC_TYPE_4,
	SOF_IPC_TYPE_COUNT
};

struct sof_loadable_file_profile {
	enum sof_ipc_type ipc_type;

	const char *fw_path;
	const char *fw_path_postfix;
	const char *fw_name;
	const char *fw_lib_path;
	const char *fw_lib_path_postfix;
	const char *tplg_path;
	const char *tplg_name;
};

/*
 * SOF Platform data.
 */
struct snd_sof_pdata {
	const char *name;
	const char *platform;

	/*
	 * PCI SSID. As PCI does not define 0 as invalid, the subsystem_id_set
	 * flag indicates that a value has been written to these members.
	 */
	unsigned short subsystem_vendor;
	unsigned short subsystem_device;
	bool subsystem_id_set;

	struct device *dev;

	/*
	 * notification callback used if the hardware initialization
	 * can take time or is handled in a workqueue. This callback
	 * can be used by the caller to e.g. enable runtime_pm
	 * or limit functionality until all low-level inits are
	 * complete.
	 */
	void (*sof_probe_complete)(struct device *dev);

	/* descriptor */
	const struct sof_dev_desc *desc;

	/* platform's preferred IPC type and path overrides */
	struct sof_loadable_file_profile ipc_file_profile_base;

	/* firmware and topology filenames */
	const char *fw_filename_prefix;
	const char *fw_filename;
	const char *tplg_filename_prefix;
	const char *tplg_filename;
	bool disable_function_topology;

	/* loadable external libraries available under this directory */
	const char *fw_lib_prefix;

	/* machine */
	struct platform_device *pdev_mach;
	const struct snd_soc_acpi_mach *machine;
	const struct snd_sof_of_mach *of_machine;

	void *hw_pdata;

	enum sof_ipc_type ipc_type;
};

/*
 * Descriptor used for setting up SOF platform data. This is used when
 * ACPI/PCI data is missing or mapped differently.
 */
struct sof_dev_desc {
	/* list of machines using this configuration */
	struct snd_soc_acpi_mach *machines;
	struct snd_sof_of_mach *of_machines;

	/* alternate list of machines using this configuration */
	struct snd_soc_acpi_mach *alt_machines;

	bool use_acpi_target_states;

	/* Platform resource indexes in BAR / ACPI resources. */
	/* Must set to -1 if not used - add new items to end */
	int resindex_lpe_base;
	int resindex_pcicfg_base;
	int resindex_imr_base;
	int irqindex_host_ipc;

	/* IPC timeouts in ms */
	int ipc_timeout;
	int boot_timeout;

	/* chip information for dsp */
	const void *chip_info;

	/* defaults for no codec mode */
	const char *nocodec_tplg_filename;

	/* information on supported IPCs */
	unsigned int ipc_supported_mask;
	enum sof_ipc_type ipc_default;

	/* The platform supports DSPless mode */
	bool dspless_mode_supported;

	/* defaults paths for firmware, library and topology files */
	const char *default_fw_path[SOF_IPC_TYPE_COUNT];
	const char *default_lib_path[SOF_IPC_TYPE_COUNT];
	const char *default_tplg_path[SOF_IPC_TYPE_COUNT];

	/* default firmware name */
	const char *default_fw_filename[SOF_IPC_TYPE_COUNT];

	const struct snd_sof_dsp_ops *ops;
	int (*ops_init)(struct snd_sof_dev *sdev);
	void (*ops_free)(struct snd_sof_dev *sdev);
};

int sof_dai_get_mclk(struct snd_soc_pcm_runtime *rtd);
int sof_dai_get_bclk(struct snd_soc_pcm_runtime *rtd);
int sof_dai_get_tdm_slots(struct snd_soc_pcm_runtime *rtd);

#endif
Commit	Line	Data
	1	/* SPDX-License-Identifier: (GPL-2.0-only 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
	7	*
	8	* Author: Liam Girdwood <liam.r.girdwood@linux.intel.com>
	9	*/
	10
	11	#ifndef __INCLUDE_SOUND_SOF_H
	12	#define __INCLUDE_SOUND_SOF_H
	13
	14	#include <linux/pci.h>
	15	#include <sound/soc.h>
	16	#include <sound/soc-acpi.h>
	17
	18	struct snd_sof_dsp_ops;
	19	struct snd_sof_dev;
	20
	21	/**
	22	* enum sof_fw_state - DSP firmware state definitions
	23	* @SOF_FW_BOOT_NOT_STARTED: firmware boot is not yet started
	24	* @SOF_DSPLESS_MODE: DSP is not used
	25	* @SOF_FW_BOOT_PREPARE: preparing for boot (firmware loading for exaqmple)
	26	* @SOF_FW_BOOT_IN_PROGRESS: firmware boot is in progress
	27	* @SOF_FW_BOOT_FAILED: firmware boot failed
	28	* @SOF_FW_BOOT_READY_FAILED: firmware booted but fw_ready op failed
	29	* @SOF_FW_BOOT_READY_OK: firmware booted and fw_ready op passed
	30	* @SOF_FW_BOOT_COMPLETE: firmware is booted up and functional
	31	* @SOF_FW_CRASHED: firmware crashed after successful boot
	32	*/
	33	enum sof_fw_state {
	34	SOF_FW_BOOT_NOT_STARTED = 0,
	35	SOF_DSPLESS_MODE,
	36	SOF_FW_BOOT_PREPARE,
	37	SOF_FW_BOOT_IN_PROGRESS,
	38	SOF_FW_BOOT_FAILED,
	39	SOF_FW_BOOT_READY_FAILED,
	40	SOF_FW_BOOT_READY_OK,
	41	SOF_FW_BOOT_COMPLETE,
	42	SOF_FW_CRASHED,
	43	};
	44
	45	/* DSP power states */
	46	enum sof_dsp_power_states {
	47	SOF_DSP_PM_D0,
	48	SOF_DSP_PM_D1,
	49	SOF_DSP_PM_D2,
	50	SOF_DSP_PM_D3,
	51	};
	52
	53	/* Definitions for multiple IPCs */
	54	enum sof_ipc_type {
	55	SOF_IPC_TYPE_3,
	56	SOF_IPC_TYPE_4,
	57	SOF_IPC_TYPE_COUNT
	58	};
	59
	60	struct sof_loadable_file_profile {
	61	enum sof_ipc_type ipc_type;
	62
	63	const char *fw_path;
	64	const char *fw_path_postfix;
	65	const char *fw_name;
	66	const char *fw_lib_path;
	67	const char *fw_lib_path_postfix;
	68	const char *tplg_path;
	69	const char *tplg_name;
	70	};
	71
	72	/*
	73	* SOF Platform data.
	74	*/
	75	struct snd_sof_pdata {
	76	const char *name;
	77	const char *platform;
	78
	79	/*
	80	* PCI SSID. As PCI does not define 0 as invalid, the subsystem_id_set
	81	* flag indicates that a value has been written to these members.
	82	*/
	83	unsigned short subsystem_vendor;
	84	unsigned short subsystem_device;
	85	bool subsystem_id_set;
	86
	87	struct device *dev;
	88
	89	/*
	90	* notification callback used if the hardware initialization
	91	* can take time or is handled in a workqueue. This callback
	92	* can be used by the caller to e.g. enable runtime_pm
	93	* or limit functionality until all low-level inits are
	94	* complete.
	95	*/
	96	void (sof_probe_complete)(struct device dev);
	97
	98	/* descriptor */
	99	const struct sof_dev_desc *desc;
	100
	101	/* platform's preferred IPC type and path overrides */
	102	struct sof_loadable_file_profile ipc_file_profile_base;
	103
	104	/* firmware and topology filenames */
	105	const char *fw_filename_prefix;
	106	const char *fw_filename;
	107	const char *tplg_filename_prefix;
	108	const char *tplg_filename;
	109	bool disable_function_topology;
	110
	111	/* loadable external libraries available under this directory */
	112	const char *fw_lib_prefix;
	113
	114	/* machine */
	115	struct platform_device *pdev_mach;
	116	const struct snd_soc_acpi_mach *machine;
	117	const struct snd_sof_of_mach *of_machine;
	118
	119	void *hw_pdata;
	120
	121	enum sof_ipc_type ipc_type;
	122	};
	123
	124	/*
	125	* Descriptor used for setting up SOF platform data. This is used when
	126	* ACPI/PCI data is missing or mapped differently.
	127	*/
	128	struct sof_dev_desc {
	129	/* list of machines using this configuration */
	130	struct snd_soc_acpi_mach *machines;
	131	struct snd_sof_of_mach *of_machines;
	132
	133	/* alternate list of machines using this configuration */
	134	struct snd_soc_acpi_mach *alt_machines;
	135
	136	bool use_acpi_target_states;
	137
	138	/* Platform resource indexes in BAR / ACPI resources. */
	139	/* Must set to -1 if not used - add new items to end */
	140	int resindex_lpe_base;
	141	int resindex_pcicfg_base;
	142	int resindex_imr_base;
	143	int irqindex_host_ipc;
	144
	145	/* IPC timeouts in ms */
	146	int ipc_timeout;
	147	int boot_timeout;
	148
	149	/* chip information for dsp */
	150	const void *chip_info;
	151
	152	/* defaults for no codec mode */
	153	const char *nocodec_tplg_filename;
	154
	155	/* information on supported IPCs */
	156	unsigned int ipc_supported_mask;
	157	enum sof_ipc_type ipc_default;
	158
	159	/* The platform supports DSPless mode */
	160	bool dspless_mode_supported;
	161
	162	/* defaults paths for firmware, library and topology files */
	163	const char *default_fw_path[SOF_IPC_TYPE_COUNT];
	164	const char *default_lib_path[SOF_IPC_TYPE_COUNT];
	165	const char *default_tplg_path[SOF_IPC_TYPE_COUNT];
	166
	167	/* default firmware name */
	168	const char *default_fw_filename[SOF_IPC_TYPE_COUNT];
	169
	170	const struct snd_sof_dsp_ops *ops;
	171	int (ops_init)(struct snd_sof_dev sdev);
	172	void (ops_free)(struct snd_sof_dev sdev);
	173	};
	174
	175	int sof_dai_get_mclk(struct snd_soc_pcm_runtime *rtd);
	176	int sof_dai_get_bclk(struct snd_soc_pcm_runtime *rtd);
	177	int sof_dai_get_tdm_slots(struct snd_soc_pcm_runtime *rtd);
	178
	179	#endif