xref: /openbmc/linux/sound/soc/sof/intel/hda-dsp.c (revision 0fbd539f666a7783b55507675b6c68673db27766)
1e149ca29SPierre-Louis Bossart // SPDX-License-Identifier: (GPL-2.0-only OR BSD-3-Clause)
2747503b1SLiam Girdwood //
3747503b1SLiam Girdwood // This file is provided under a dual BSD/GPLv2 license.  When using or
4747503b1SLiam Girdwood // redistributing this file, you may do so under either license.
5747503b1SLiam Girdwood //
6747503b1SLiam Girdwood // Copyright(c) 2018 Intel Corporation. All rights reserved.
7747503b1SLiam Girdwood //
8747503b1SLiam Girdwood // Authors: Liam Girdwood <liam.r.girdwood@linux.intel.com>
9747503b1SLiam Girdwood //	    Ranjani Sridharan <ranjani.sridharan@linux.intel.com>
10747503b1SLiam Girdwood //	    Rander Wang <rander.wang@intel.com>
11747503b1SLiam Girdwood //          Keyon Jie <yang.jie@linux.intel.com>
12747503b1SLiam Girdwood //
13747503b1SLiam Girdwood 
14747503b1SLiam Girdwood /*
15747503b1SLiam Girdwood  * Hardware interface for generic Intel audio DSP HDA IP
16747503b1SLiam Girdwood  */
17747503b1SLiam Girdwood 
18851fd873SRanjani Sridharan #include <linux/module.h>
19747503b1SLiam Girdwood #include <sound/hdaudio_ext.h>
20747503b1SLiam Girdwood #include <sound/hda_register.h>
21d272b657SBard Liao #include <trace/events/sof_intel.h>
2263e51fd3SRanjani Sridharan #include "../sof-audio.h"
23747503b1SLiam Girdwood #include "../ops.h"
24747503b1SLiam Girdwood #include "hda.h"
25534037fdSKeyon Jie #include "hda-ipc.h"
26747503b1SLiam Girdwood 
27851fd873SRanjani Sridharan static bool hda_enable_trace_D0I3_S0;
28851fd873SRanjani Sridharan #if IS_ENABLED(CONFIG_SND_SOC_SOF_DEBUG)
29851fd873SRanjani Sridharan module_param_named(enable_trace_D0I3_S0, hda_enable_trace_D0I3_S0, bool, 0444);
30851fd873SRanjani Sridharan MODULE_PARM_DESC(enable_trace_D0I3_S0,
31851fd873SRanjani Sridharan 		 "SOF HDA enable trace when the DSP is in D0I3 in S0");
32851fd873SRanjani Sridharan #endif
33851fd873SRanjani Sridharan 
34747503b1SLiam Girdwood /*
35747503b1SLiam Girdwood  * DSP Core control.
36747503b1SLiam Girdwood  */
37747503b1SLiam Girdwood 
38189bf1deSPeter Ujfalusi static int hda_dsp_core_reset_enter(struct snd_sof_dev *sdev, unsigned int core_mask)
39747503b1SLiam Girdwood {
40747503b1SLiam Girdwood 	u32 adspcs;
41747503b1SLiam Girdwood 	u32 reset;
42747503b1SLiam Girdwood 	int ret;
43747503b1SLiam Girdwood 
44747503b1SLiam Girdwood 	/* set reset bits for cores */
45747503b1SLiam Girdwood 	reset = HDA_DSP_ADSPCS_CRST_MASK(core_mask);
46747503b1SLiam Girdwood 	snd_sof_dsp_update_bits_unlocked(sdev, HDA_DSP_BAR,
47747503b1SLiam Girdwood 					 HDA_DSP_REG_ADSPCS,
48bed5ed64SJulia Lawall 					 reset, reset);
49747503b1SLiam Girdwood 
50747503b1SLiam Girdwood 	/* poll with timeout to check if operation successful */
51747503b1SLiam Girdwood 	ret = snd_sof_dsp_read_poll_timeout(sdev, HDA_DSP_BAR,
52747503b1SLiam Girdwood 					HDA_DSP_REG_ADSPCS, adspcs,
53747503b1SLiam Girdwood 					((adspcs & reset) == reset),
54747503b1SLiam Girdwood 					HDA_DSP_REG_POLL_INTERVAL_US,
55747503b1SLiam Girdwood 					HDA_DSP_RESET_TIMEOUT_US);
566a414489SPierre-Louis Bossart 	if (ret < 0) {
576a414489SPierre-Louis Bossart 		dev_err(sdev->dev,
586a414489SPierre-Louis Bossart 			"error: %s: timeout on HDA_DSP_REG_ADSPCS read\n",
596a414489SPierre-Louis Bossart 			__func__);
606a414489SPierre-Louis Bossart 		return ret;
616a414489SPierre-Louis Bossart 	}
62747503b1SLiam Girdwood 
63747503b1SLiam Girdwood 	/* has core entered reset ? */
64747503b1SLiam Girdwood 	adspcs = snd_sof_dsp_read(sdev, HDA_DSP_BAR,
65747503b1SLiam Girdwood 				  HDA_DSP_REG_ADSPCS);
66747503b1SLiam Girdwood 	if ((adspcs & HDA_DSP_ADSPCS_CRST_MASK(core_mask)) !=
67747503b1SLiam Girdwood 		HDA_DSP_ADSPCS_CRST_MASK(core_mask)) {
68747503b1SLiam Girdwood 		dev_err(sdev->dev,
69747503b1SLiam Girdwood 			"error: reset enter failed: core_mask %x adspcs 0x%x\n",
70747503b1SLiam Girdwood 			core_mask, adspcs);
71747503b1SLiam Girdwood 		ret = -EIO;
72747503b1SLiam Girdwood 	}
73747503b1SLiam Girdwood 
74747503b1SLiam Girdwood 	return ret;
75747503b1SLiam Girdwood }
76747503b1SLiam Girdwood 
77189bf1deSPeter Ujfalusi static int hda_dsp_core_reset_leave(struct snd_sof_dev *sdev, unsigned int core_mask)
78747503b1SLiam Girdwood {
79747503b1SLiam Girdwood 	unsigned int crst;
80747503b1SLiam Girdwood 	u32 adspcs;
81747503b1SLiam Girdwood 	int ret;
82747503b1SLiam Girdwood 
83747503b1SLiam Girdwood 	/* clear reset bits for cores */
84747503b1SLiam Girdwood 	snd_sof_dsp_update_bits_unlocked(sdev, HDA_DSP_BAR,
85747503b1SLiam Girdwood 					 HDA_DSP_REG_ADSPCS,
86747503b1SLiam Girdwood 					 HDA_DSP_ADSPCS_CRST_MASK(core_mask),
87747503b1SLiam Girdwood 					 0);
88747503b1SLiam Girdwood 
89747503b1SLiam Girdwood 	/* poll with timeout to check if operation successful */
90747503b1SLiam Girdwood 	crst = HDA_DSP_ADSPCS_CRST_MASK(core_mask);
91747503b1SLiam Girdwood 	ret = snd_sof_dsp_read_poll_timeout(sdev, HDA_DSP_BAR,
92747503b1SLiam Girdwood 					    HDA_DSP_REG_ADSPCS, adspcs,
93747503b1SLiam Girdwood 					    !(adspcs & crst),
94747503b1SLiam Girdwood 					    HDA_DSP_REG_POLL_INTERVAL_US,
95747503b1SLiam Girdwood 					    HDA_DSP_RESET_TIMEOUT_US);
96747503b1SLiam Girdwood 
976a414489SPierre-Louis Bossart 	if (ret < 0) {
986a414489SPierre-Louis Bossart 		dev_err(sdev->dev,
996a414489SPierre-Louis Bossart 			"error: %s: timeout on HDA_DSP_REG_ADSPCS read\n",
1006a414489SPierre-Louis Bossart 			__func__);
1016a414489SPierre-Louis Bossart 		return ret;
1026a414489SPierre-Louis Bossart 	}
1036a414489SPierre-Louis Bossart 
104747503b1SLiam Girdwood 	/* has core left reset ? */
105747503b1SLiam Girdwood 	adspcs = snd_sof_dsp_read(sdev, HDA_DSP_BAR,
106747503b1SLiam Girdwood 				  HDA_DSP_REG_ADSPCS);
107747503b1SLiam Girdwood 	if ((adspcs & HDA_DSP_ADSPCS_CRST_MASK(core_mask)) != 0) {
108747503b1SLiam Girdwood 		dev_err(sdev->dev,
109747503b1SLiam Girdwood 			"error: reset leave failed: core_mask %x adspcs 0x%x\n",
110747503b1SLiam Girdwood 			core_mask, adspcs);
111747503b1SLiam Girdwood 		ret = -EIO;
112747503b1SLiam Girdwood 	}
113747503b1SLiam Girdwood 
114747503b1SLiam Girdwood 	return ret;
115747503b1SLiam Girdwood }
116747503b1SLiam Girdwood 
117556eb416SPierre-Louis Bossart int hda_dsp_core_stall_reset(struct snd_sof_dev *sdev, unsigned int core_mask)
118747503b1SLiam Girdwood {
119747503b1SLiam Girdwood 	/* stall core */
120747503b1SLiam Girdwood 	snd_sof_dsp_update_bits_unlocked(sdev, HDA_DSP_BAR,
121747503b1SLiam Girdwood 					 HDA_DSP_REG_ADSPCS,
122747503b1SLiam Girdwood 					 HDA_DSP_ADSPCS_CSTALL_MASK(core_mask),
123747503b1SLiam Girdwood 					 HDA_DSP_ADSPCS_CSTALL_MASK(core_mask));
124747503b1SLiam Girdwood 
125747503b1SLiam Girdwood 	/* set reset state */
126747503b1SLiam Girdwood 	return hda_dsp_core_reset_enter(sdev, core_mask);
127747503b1SLiam Girdwood }
128747503b1SLiam Girdwood 
129556eb416SPierre-Louis Bossart bool hda_dsp_core_is_enabled(struct snd_sof_dev *sdev, unsigned int core_mask)
130189bf1deSPeter Ujfalusi {
131189bf1deSPeter Ujfalusi 	int val;
132189bf1deSPeter Ujfalusi 	bool is_enable;
133189bf1deSPeter Ujfalusi 
134189bf1deSPeter Ujfalusi 	val = snd_sof_dsp_read(sdev, HDA_DSP_BAR, HDA_DSP_REG_ADSPCS);
135189bf1deSPeter Ujfalusi 
136189bf1deSPeter Ujfalusi #define MASK_IS_EQUAL(v, m, field) ({	\
137189bf1deSPeter Ujfalusi 	u32 _m = field(m);		\
138189bf1deSPeter Ujfalusi 	((v) & _m) == _m;		\
139189bf1deSPeter Ujfalusi })
140189bf1deSPeter Ujfalusi 
141189bf1deSPeter Ujfalusi 	is_enable = MASK_IS_EQUAL(val, core_mask, HDA_DSP_ADSPCS_CPA_MASK) &&
142189bf1deSPeter Ujfalusi 		MASK_IS_EQUAL(val, core_mask, HDA_DSP_ADSPCS_SPA_MASK) &&
143189bf1deSPeter Ujfalusi 		!(val & HDA_DSP_ADSPCS_CRST_MASK(core_mask)) &&
144189bf1deSPeter Ujfalusi 		!(val & HDA_DSP_ADSPCS_CSTALL_MASK(core_mask));
145189bf1deSPeter Ujfalusi 
146189bf1deSPeter Ujfalusi #undef MASK_IS_EQUAL
147189bf1deSPeter Ujfalusi 
148189bf1deSPeter Ujfalusi 	dev_dbg(sdev->dev, "DSP core(s) enabled? %d : core_mask %x\n",
149189bf1deSPeter Ujfalusi 		is_enable, core_mask);
150189bf1deSPeter Ujfalusi 
151189bf1deSPeter Ujfalusi 	return is_enable;
152189bf1deSPeter Ujfalusi }
153189bf1deSPeter Ujfalusi 
154747503b1SLiam Girdwood int hda_dsp_core_run(struct snd_sof_dev *sdev, unsigned int core_mask)
155747503b1SLiam Girdwood {
156747503b1SLiam Girdwood 	int ret;
157747503b1SLiam Girdwood 
158747503b1SLiam Girdwood 	/* leave reset state */
159747503b1SLiam Girdwood 	ret = hda_dsp_core_reset_leave(sdev, core_mask);
160747503b1SLiam Girdwood 	if (ret < 0)
161747503b1SLiam Girdwood 		return ret;
162747503b1SLiam Girdwood 
163747503b1SLiam Girdwood 	/* run core */
164747503b1SLiam Girdwood 	dev_dbg(sdev->dev, "unstall/run core: core_mask = %x\n", core_mask);
165747503b1SLiam Girdwood 	snd_sof_dsp_update_bits_unlocked(sdev, HDA_DSP_BAR,
166747503b1SLiam Girdwood 					 HDA_DSP_REG_ADSPCS,
167747503b1SLiam Girdwood 					 HDA_DSP_ADSPCS_CSTALL_MASK(core_mask),
168747503b1SLiam Girdwood 					 0);
169747503b1SLiam Girdwood 
170747503b1SLiam Girdwood 	/* is core now running ? */
171747503b1SLiam Girdwood 	if (!hda_dsp_core_is_enabled(sdev, core_mask)) {
172747503b1SLiam Girdwood 		hda_dsp_core_stall_reset(sdev, core_mask);
173747503b1SLiam Girdwood 		dev_err(sdev->dev, "error: DSP start core failed: core_mask %x\n",
174747503b1SLiam Girdwood 			core_mask);
175747503b1SLiam Girdwood 		ret = -EIO;
176747503b1SLiam Girdwood 	}
177747503b1SLiam Girdwood 
178747503b1SLiam Girdwood 	return ret;
179747503b1SLiam Girdwood }
180747503b1SLiam Girdwood 
181747503b1SLiam Girdwood /*
182747503b1SLiam Girdwood  * Power Management.
183747503b1SLiam Girdwood  */
184747503b1SLiam Girdwood 
185537b4a0cSPeter Ujfalusi int hda_dsp_core_power_up(struct snd_sof_dev *sdev, unsigned int core_mask)
186747503b1SLiam Girdwood {
187537b4a0cSPeter Ujfalusi 	struct sof_intel_hda_dev *hda = sdev->pdata->hw_pdata;
188537b4a0cSPeter Ujfalusi 	const struct sof_intel_dsp_desc *chip = hda->desc;
189747503b1SLiam Girdwood 	unsigned int cpa;
190747503b1SLiam Girdwood 	u32 adspcs;
191747503b1SLiam Girdwood 	int ret;
192747503b1SLiam Girdwood 
193537b4a0cSPeter Ujfalusi 	/* restrict core_mask to host managed cores mask */
194537b4a0cSPeter Ujfalusi 	core_mask &= chip->host_managed_cores_mask;
195537b4a0cSPeter Ujfalusi 	/* return if core_mask is not valid */
196537b4a0cSPeter Ujfalusi 	if (!core_mask)
197537b4a0cSPeter Ujfalusi 		return 0;
198537b4a0cSPeter Ujfalusi 
199747503b1SLiam Girdwood 	/* update bits */
200747503b1SLiam Girdwood 	snd_sof_dsp_update_bits(sdev, HDA_DSP_BAR, HDA_DSP_REG_ADSPCS,
201747503b1SLiam Girdwood 				HDA_DSP_ADSPCS_SPA_MASK(core_mask),
202747503b1SLiam Girdwood 				HDA_DSP_ADSPCS_SPA_MASK(core_mask));
203747503b1SLiam Girdwood 
204747503b1SLiam Girdwood 	/* poll with timeout to check if operation successful */
205747503b1SLiam Girdwood 	cpa = HDA_DSP_ADSPCS_CPA_MASK(core_mask);
206747503b1SLiam Girdwood 	ret = snd_sof_dsp_read_poll_timeout(sdev, HDA_DSP_BAR,
207747503b1SLiam Girdwood 					    HDA_DSP_REG_ADSPCS, adspcs,
208747503b1SLiam Girdwood 					    (adspcs & cpa) == cpa,
209747503b1SLiam Girdwood 					    HDA_DSP_REG_POLL_INTERVAL_US,
210747503b1SLiam Girdwood 					    HDA_DSP_RESET_TIMEOUT_US);
2116a414489SPierre-Louis Bossart 	if (ret < 0) {
2126a414489SPierre-Louis Bossart 		dev_err(sdev->dev,
2136a414489SPierre-Louis Bossart 			"error: %s: timeout on HDA_DSP_REG_ADSPCS read\n",
2146a414489SPierre-Louis Bossart 			__func__);
2156a414489SPierre-Louis Bossart 		return ret;
2166a414489SPierre-Louis Bossart 	}
217747503b1SLiam Girdwood 
218747503b1SLiam Girdwood 	/* did core power up ? */
219747503b1SLiam Girdwood 	adspcs = snd_sof_dsp_read(sdev, HDA_DSP_BAR,
220747503b1SLiam Girdwood 				  HDA_DSP_REG_ADSPCS);
221747503b1SLiam Girdwood 	if ((adspcs & HDA_DSP_ADSPCS_CPA_MASK(core_mask)) !=
222747503b1SLiam Girdwood 		HDA_DSP_ADSPCS_CPA_MASK(core_mask)) {
223747503b1SLiam Girdwood 		dev_err(sdev->dev,
224747503b1SLiam Girdwood 			"error: power up core failed core_mask %xadspcs 0x%x\n",
225747503b1SLiam Girdwood 			core_mask, adspcs);
226747503b1SLiam Girdwood 		ret = -EIO;
227747503b1SLiam Girdwood 	}
228747503b1SLiam Girdwood 
229747503b1SLiam Girdwood 	return ret;
230747503b1SLiam Girdwood }
231747503b1SLiam Girdwood 
232189bf1deSPeter Ujfalusi static int hda_dsp_core_power_down(struct snd_sof_dev *sdev, unsigned int core_mask)
233747503b1SLiam Girdwood {
234747503b1SLiam Girdwood 	u32 adspcs;
2356a414489SPierre-Louis Bossart 	int ret;
236747503b1SLiam Girdwood 
237747503b1SLiam Girdwood 	/* update bits */
238747503b1SLiam Girdwood 	snd_sof_dsp_update_bits_unlocked(sdev, HDA_DSP_BAR,
239747503b1SLiam Girdwood 					 HDA_DSP_REG_ADSPCS,
240747503b1SLiam Girdwood 					 HDA_DSP_ADSPCS_SPA_MASK(core_mask), 0);
241747503b1SLiam Girdwood 
2426a414489SPierre-Louis Bossart 	ret = snd_sof_dsp_read_poll_timeout(sdev, HDA_DSP_BAR,
243747503b1SLiam Girdwood 				HDA_DSP_REG_ADSPCS, adspcs,
244fd829918SPan Xiuli 				!(adspcs & HDA_DSP_ADSPCS_CPA_MASK(core_mask)),
245747503b1SLiam Girdwood 				HDA_DSP_REG_POLL_INTERVAL_US,
246747503b1SLiam Girdwood 				HDA_DSP_PD_TIMEOUT * USEC_PER_MSEC);
2476a414489SPierre-Louis Bossart 	if (ret < 0)
2486a414489SPierre-Louis Bossart 		dev_err(sdev->dev,
2496a414489SPierre-Louis Bossart 			"error: %s: timeout on HDA_DSP_REG_ADSPCS read\n",
2506a414489SPierre-Louis Bossart 			__func__);
2516a414489SPierre-Louis Bossart 
2526a414489SPierre-Louis Bossart 	return ret;
253747503b1SLiam Girdwood }
254747503b1SLiam Girdwood 
255747503b1SLiam Girdwood int hda_dsp_enable_core(struct snd_sof_dev *sdev, unsigned int core_mask)
256747503b1SLiam Girdwood {
257914fab3bSRanjani Sridharan 	struct sof_intel_hda_dev *hda = sdev->pdata->hw_pdata;
258914fab3bSRanjani Sridharan 	const struct sof_intel_dsp_desc *chip = hda->desc;
259747503b1SLiam Girdwood 	int ret;
260747503b1SLiam Girdwood 
261914fab3bSRanjani Sridharan 	/* restrict core_mask to host managed cores mask */
262914fab3bSRanjani Sridharan 	core_mask &= chip->host_managed_cores_mask;
263914fab3bSRanjani Sridharan 
264914fab3bSRanjani Sridharan 	/* return if core_mask is not valid or cores are already enabled */
265914fab3bSRanjani Sridharan 	if (!core_mask || hda_dsp_core_is_enabled(sdev, core_mask))
266747503b1SLiam Girdwood 		return 0;
267747503b1SLiam Girdwood 
268747503b1SLiam Girdwood 	/* power up */
269747503b1SLiam Girdwood 	ret = hda_dsp_core_power_up(sdev, core_mask);
270747503b1SLiam Girdwood 	if (ret < 0) {
271747503b1SLiam Girdwood 		dev_err(sdev->dev, "error: dsp core power up failed: core_mask %x\n",
272747503b1SLiam Girdwood 			core_mask);
273747503b1SLiam Girdwood 		return ret;
274747503b1SLiam Girdwood 	}
275747503b1SLiam Girdwood 
276747503b1SLiam Girdwood 	return hda_dsp_core_run(sdev, core_mask);
277747503b1SLiam Girdwood }
278747503b1SLiam Girdwood 
279747503b1SLiam Girdwood int hda_dsp_core_reset_power_down(struct snd_sof_dev *sdev,
280747503b1SLiam Girdwood 				  unsigned int core_mask)
281747503b1SLiam Girdwood {
282914fab3bSRanjani Sridharan 	struct sof_intel_hda_dev *hda = sdev->pdata->hw_pdata;
283914fab3bSRanjani Sridharan 	const struct sof_intel_dsp_desc *chip = hda->desc;
284747503b1SLiam Girdwood 	int ret;
285747503b1SLiam Girdwood 
286914fab3bSRanjani Sridharan 	/* restrict core_mask to host managed cores mask */
287914fab3bSRanjani Sridharan 	core_mask &= chip->host_managed_cores_mask;
288914fab3bSRanjani Sridharan 
289914fab3bSRanjani Sridharan 	/* return if core_mask is not valid */
290914fab3bSRanjani Sridharan 	if (!core_mask)
291914fab3bSRanjani Sridharan 		return 0;
292914fab3bSRanjani Sridharan 
293747503b1SLiam Girdwood 	/* place core in reset prior to power down */
294747503b1SLiam Girdwood 	ret = hda_dsp_core_stall_reset(sdev, core_mask);
295747503b1SLiam Girdwood 	if (ret < 0) {
296747503b1SLiam Girdwood 		dev_err(sdev->dev, "error: dsp core reset failed: core_mask %x\n",
297747503b1SLiam Girdwood 			core_mask);
298747503b1SLiam Girdwood 		return ret;
299747503b1SLiam Girdwood 	}
300747503b1SLiam Girdwood 
301747503b1SLiam Girdwood 	/* power down core */
302747503b1SLiam Girdwood 	ret = hda_dsp_core_power_down(sdev, core_mask);
303747503b1SLiam Girdwood 	if (ret < 0) {
304747503b1SLiam Girdwood 		dev_err(sdev->dev, "error: dsp core power down fail mask %x: %d\n",
305747503b1SLiam Girdwood 			core_mask, ret);
306747503b1SLiam Girdwood 		return ret;
307747503b1SLiam Girdwood 	}
308747503b1SLiam Girdwood 
309747503b1SLiam Girdwood 	/* make sure we are in OFF state */
310747503b1SLiam Girdwood 	if (hda_dsp_core_is_enabled(sdev, core_mask)) {
311747503b1SLiam Girdwood 		dev_err(sdev->dev, "error: dsp core disable fail mask %x: %d\n",
312747503b1SLiam Girdwood 			core_mask, ret);
313747503b1SLiam Girdwood 		ret = -EIO;
314747503b1SLiam Girdwood 	}
315747503b1SLiam Girdwood 
316747503b1SLiam Girdwood 	return ret;
317747503b1SLiam Girdwood }
318747503b1SLiam Girdwood 
319747503b1SLiam Girdwood void hda_dsp_ipc_int_enable(struct snd_sof_dev *sdev)
320747503b1SLiam Girdwood {
321747503b1SLiam Girdwood 	struct sof_intel_hda_dev *hda = sdev->pdata->hw_pdata;
322747503b1SLiam Girdwood 	const struct sof_intel_dsp_desc *chip = hda->desc;
323747503b1SLiam Girdwood 
324747503b1SLiam Girdwood 	/* enable IPC DONE and BUSY interrupts */
325747503b1SLiam Girdwood 	snd_sof_dsp_update_bits(sdev, HDA_DSP_BAR, chip->ipc_ctl,
326747503b1SLiam Girdwood 			HDA_DSP_REG_HIPCCTL_DONE | HDA_DSP_REG_HIPCCTL_BUSY,
327747503b1SLiam Girdwood 			HDA_DSP_REG_HIPCCTL_DONE | HDA_DSP_REG_HIPCCTL_BUSY);
328747503b1SLiam Girdwood 
329747503b1SLiam Girdwood 	/* enable IPC interrupt */
330747503b1SLiam Girdwood 	snd_sof_dsp_update_bits(sdev, HDA_DSP_BAR, HDA_DSP_REG_ADSPIC,
331747503b1SLiam Girdwood 				HDA_DSP_ADSPIC_IPC, HDA_DSP_ADSPIC_IPC);
332747503b1SLiam Girdwood }
333747503b1SLiam Girdwood 
334747503b1SLiam Girdwood void hda_dsp_ipc_int_disable(struct snd_sof_dev *sdev)
335747503b1SLiam Girdwood {
336747503b1SLiam Girdwood 	struct sof_intel_hda_dev *hda = sdev->pdata->hw_pdata;
337747503b1SLiam Girdwood 	const struct sof_intel_dsp_desc *chip = hda->desc;
338747503b1SLiam Girdwood 
339747503b1SLiam Girdwood 	/* disable IPC interrupt */
340747503b1SLiam Girdwood 	snd_sof_dsp_update_bits(sdev, HDA_DSP_BAR, HDA_DSP_REG_ADSPIC,
341747503b1SLiam Girdwood 				HDA_DSP_ADSPIC_IPC, 0);
342747503b1SLiam Girdwood 
343747503b1SLiam Girdwood 	/* disable IPC BUSY and DONE interrupt */
344747503b1SLiam Girdwood 	snd_sof_dsp_update_bits(sdev, HDA_DSP_BAR, chip->ipc_ctl,
345747503b1SLiam Girdwood 			HDA_DSP_REG_HIPCCTL_BUSY | HDA_DSP_REG_HIPCCTL_DONE, 0);
346747503b1SLiam Girdwood }
347747503b1SLiam Girdwood 
34865c56f5dSRanjani Sridharan static int hda_dsp_wait_d0i3c_done(struct snd_sof_dev *sdev)
34962f8f766SKeyon Jie {
35062f8f766SKeyon Jie 	struct hdac_bus *bus = sof_to_bus(sdev);
35165c56f5dSRanjani Sridharan 	int retry = HDA_DSP_REG_POLL_RETRY_COUNT;
35262f8f766SKeyon Jie 
35362f8f766SKeyon Jie 	while (snd_hdac_chip_readb(bus, VS_D0I3C) & SOF_HDA_VS_D0I3C_CIP) {
35462f8f766SKeyon Jie 		if (!retry--)
35562f8f766SKeyon Jie 			return -ETIMEDOUT;
35662f8f766SKeyon Jie 		usleep_range(10, 15);
35762f8f766SKeyon Jie 	}
35862f8f766SKeyon Jie 
35962f8f766SKeyon Jie 	return 0;
36062f8f766SKeyon Jie }
36162f8f766SKeyon Jie 
362534037fdSKeyon Jie static int hda_dsp_send_pm_gate_ipc(struct snd_sof_dev *sdev, u32 flags)
363534037fdSKeyon Jie {
364534037fdSKeyon Jie 	struct sof_ipc_pm_gate pm_gate;
365534037fdSKeyon Jie 	struct sof_ipc_reply reply;
366534037fdSKeyon Jie 
367534037fdSKeyon Jie 	memset(&pm_gate, 0, sizeof(pm_gate));
368534037fdSKeyon Jie 
369534037fdSKeyon Jie 	/* configure pm_gate ipc message */
370534037fdSKeyon Jie 	pm_gate.hdr.size = sizeof(pm_gate);
371534037fdSKeyon Jie 	pm_gate.hdr.cmd = SOF_IPC_GLB_PM_MSG | SOF_IPC_PM_GATE;
372534037fdSKeyon Jie 	pm_gate.flags = flags;
373534037fdSKeyon Jie 
374534037fdSKeyon Jie 	/* send pm_gate ipc to dsp */
3752a51c0f8SPeter Ujfalusi 	return sof_ipc_tx_message_no_pm(sdev->ipc, &pm_gate, sizeof(pm_gate),
3762a51c0f8SPeter Ujfalusi 					&reply, sizeof(reply));
377534037fdSKeyon Jie }
378534037fdSKeyon Jie 
37961e285caSRanjani Sridharan static int hda_dsp_update_d0i3c_register(struct snd_sof_dev *sdev, u8 value)
38062f8f766SKeyon Jie {
38162f8f766SKeyon Jie 	struct hdac_bus *bus = sof_to_bus(sdev);
38262f8f766SKeyon Jie 	int ret;
38362f8f766SKeyon Jie 
38462f8f766SKeyon Jie 	/* Write to D0I3C after Command-In-Progress bit is cleared */
38565c56f5dSRanjani Sridharan 	ret = hda_dsp_wait_d0i3c_done(sdev);
38662f8f766SKeyon Jie 	if (ret < 0) {
387aae7c82dSKeyon Jie 		dev_err(bus->dev, "CIP timeout before D0I3C update!\n");
38862f8f766SKeyon Jie 		return ret;
38962f8f766SKeyon Jie 	}
39062f8f766SKeyon Jie 
39162f8f766SKeyon Jie 	/* Update D0I3C register */
39262f8f766SKeyon Jie 	snd_hdac_chip_updateb(bus, VS_D0I3C, SOF_HDA_VS_D0I3C_I3, value);
39362f8f766SKeyon Jie 
39462f8f766SKeyon Jie 	/* Wait for cmd in progress to be cleared before exiting the function */
39565c56f5dSRanjani Sridharan 	ret = hda_dsp_wait_d0i3c_done(sdev);
39662f8f766SKeyon Jie 	if (ret < 0) {
397aae7c82dSKeyon Jie 		dev_err(bus->dev, "CIP timeout after D0I3C update!\n");
39862f8f766SKeyon Jie 		return ret;
39962f8f766SKeyon Jie 	}
40062f8f766SKeyon Jie 
401d272b657SBard Liao 	trace_sof_intel_D0I3C_updated(sdev, snd_hdac_chip_readb(bus, VS_D0I3C));
40262f8f766SKeyon Jie 
40361e285caSRanjani Sridharan 	return 0;
40461e285caSRanjani Sridharan }
405534037fdSKeyon Jie 
40661e285caSRanjani Sridharan static int hda_dsp_set_D0_state(struct snd_sof_dev *sdev,
40761e285caSRanjani Sridharan 				const struct sof_dsp_power_state *target_state)
40861e285caSRanjani Sridharan {
40961e285caSRanjani Sridharan 	u32 flags = 0;
41061e285caSRanjani Sridharan 	int ret;
41161e285caSRanjani Sridharan 	u8 value = 0;
41261e285caSRanjani Sridharan 
41361e285caSRanjani Sridharan 	/*
41461e285caSRanjani Sridharan 	 * Sanity check for illegal state transitions
41561e285caSRanjani Sridharan 	 * The only allowed transitions are:
41661e285caSRanjani Sridharan 	 * 1. D3 -> D0I0
41761e285caSRanjani Sridharan 	 * 2. D0I0 -> D0I3
41861e285caSRanjani Sridharan 	 * 3. D0I3 -> D0I0
41961e285caSRanjani Sridharan 	 */
42061e285caSRanjani Sridharan 	switch (sdev->dsp_power_state.state) {
42161e285caSRanjani Sridharan 	case SOF_DSP_PM_D0:
42261e285caSRanjani Sridharan 		/* Follow the sequence below for D0 substate transitions */
42361e285caSRanjani Sridharan 		break;
42461e285caSRanjani Sridharan 	case SOF_DSP_PM_D3:
42561e285caSRanjani Sridharan 		/* Follow regular flow for D3 -> D0 transition */
42661e285caSRanjani Sridharan 		return 0;
42761e285caSRanjani Sridharan 	default:
42861e285caSRanjani Sridharan 		dev_err(sdev->dev, "error: transition from %d to %d not allowed\n",
42961e285caSRanjani Sridharan 			sdev->dsp_power_state.state, target_state->state);
43061e285caSRanjani Sridharan 		return -EINVAL;
43161e285caSRanjani Sridharan 	}
43261e285caSRanjani Sridharan 
43361e285caSRanjani Sridharan 	/* Set flags and register value for D0 target substate */
43461e285caSRanjani Sridharan 	if (target_state->substate == SOF_HDA_DSP_PM_D0I3) {
43561e285caSRanjani Sridharan 		value = SOF_HDA_VS_D0I3C_I3;
43661e285caSRanjani Sridharan 
437851fd873SRanjani Sridharan 		/*
43879560b8aSMarcin Rajwa 		 * Trace DMA need to be disabled when the DSP enters
43979560b8aSMarcin Rajwa 		 * D0I3 for S0Ix suspend, but it can be kept enabled
44079560b8aSMarcin Rajwa 		 * when the DSP enters D0I3 while the system is in S0
44179560b8aSMarcin Rajwa 		 * for debug purpose.
442851fd873SRanjani Sridharan 		 */
44325b17da6SPeter Ujfalusi 		if (!sdev->fw_trace_is_supported ||
44479560b8aSMarcin Rajwa 		    !hda_enable_trace_D0I3_S0 ||
445851fd873SRanjani Sridharan 		    sdev->system_suspend_target != SOF_SUSPEND_NONE)
44661e285caSRanjani Sridharan 			flags = HDA_PM_NO_DMA_TRACE;
44761e285caSRanjani Sridharan 	} else {
44861e285caSRanjani Sridharan 		/* prevent power gating in D0I0 */
44961e285caSRanjani Sridharan 		flags = HDA_PM_PPG;
45061e285caSRanjani Sridharan 	}
45161e285caSRanjani Sridharan 
45261e285caSRanjani Sridharan 	/* update D0I3C register */
45361e285caSRanjani Sridharan 	ret = hda_dsp_update_d0i3c_register(sdev, value);
454534037fdSKeyon Jie 	if (ret < 0)
45561e285caSRanjani Sridharan 		return ret;
45661e285caSRanjani Sridharan 
45761e285caSRanjani Sridharan 	/*
45861e285caSRanjani Sridharan 	 * Notify the DSP of the state change.
45961e285caSRanjani Sridharan 	 * If this IPC fails, revert the D0I3C register update in order
46061e285caSRanjani Sridharan 	 * to prevent partial state change.
46161e285caSRanjani Sridharan 	 */
46261e285caSRanjani Sridharan 	ret = hda_dsp_send_pm_gate_ipc(sdev, flags);
46361e285caSRanjani Sridharan 	if (ret < 0) {
464534037fdSKeyon Jie 		dev_err(sdev->dev,
465534037fdSKeyon Jie 			"error: PM_GATE ipc error %d\n", ret);
46661e285caSRanjani Sridharan 		goto revert;
46761e285caSRanjani Sridharan 	}
46861e285caSRanjani Sridharan 
46961e285caSRanjani Sridharan 	return ret;
47061e285caSRanjani Sridharan 
47161e285caSRanjani Sridharan revert:
47261e285caSRanjani Sridharan 	/* fallback to the previous register value */
47361e285caSRanjani Sridharan 	value = value ? 0 : SOF_HDA_VS_D0I3C_I3;
47461e285caSRanjani Sridharan 
47561e285caSRanjani Sridharan 	/*
47661e285caSRanjani Sridharan 	 * This can fail but return the IPC error to signal that
47761e285caSRanjani Sridharan 	 * the state change failed.
47861e285caSRanjani Sridharan 	 */
47961e285caSRanjani Sridharan 	hda_dsp_update_d0i3c_register(sdev, value);
480534037fdSKeyon Jie 
481534037fdSKeyon Jie 	return ret;
48262f8f766SKeyon Jie }
48362f8f766SKeyon Jie 
48466de6bebSRanjani Sridharan /* helper to log DSP state */
48566de6bebSRanjani Sridharan static void hda_dsp_state_log(struct snd_sof_dev *sdev)
48666de6bebSRanjani Sridharan {
48766de6bebSRanjani Sridharan 	switch (sdev->dsp_power_state.state) {
48866de6bebSRanjani Sridharan 	case SOF_DSP_PM_D0:
48966de6bebSRanjani Sridharan 		switch (sdev->dsp_power_state.substate) {
49066de6bebSRanjani Sridharan 		case SOF_HDA_DSP_PM_D0I0:
49166de6bebSRanjani Sridharan 			dev_dbg(sdev->dev, "Current DSP power state: D0I0\n");
49266de6bebSRanjani Sridharan 			break;
49366de6bebSRanjani Sridharan 		case SOF_HDA_DSP_PM_D0I3:
49466de6bebSRanjani Sridharan 			dev_dbg(sdev->dev, "Current DSP power state: D0I3\n");
49566de6bebSRanjani Sridharan 			break;
49666de6bebSRanjani Sridharan 		default:
49766de6bebSRanjani Sridharan 			dev_dbg(sdev->dev, "Unknown DSP D0 substate: %d\n",
49866de6bebSRanjani Sridharan 				sdev->dsp_power_state.substate);
49966de6bebSRanjani Sridharan 			break;
50066de6bebSRanjani Sridharan 		}
50166de6bebSRanjani Sridharan 		break;
50266de6bebSRanjani Sridharan 	case SOF_DSP_PM_D1:
50366de6bebSRanjani Sridharan 		dev_dbg(sdev->dev, "Current DSP power state: D1\n");
50466de6bebSRanjani Sridharan 		break;
50566de6bebSRanjani Sridharan 	case SOF_DSP_PM_D2:
50666de6bebSRanjani Sridharan 		dev_dbg(sdev->dev, "Current DSP power state: D2\n");
50766de6bebSRanjani Sridharan 		break;
50866de6bebSRanjani Sridharan 	case SOF_DSP_PM_D3:
50966de6bebSRanjani Sridharan 		dev_dbg(sdev->dev, "Current DSP power state: D3\n");
51066de6bebSRanjani Sridharan 		break;
51166de6bebSRanjani Sridharan 	default:
51266de6bebSRanjani Sridharan 		dev_dbg(sdev->dev, "Unknown DSP power state: %d\n",
51366de6bebSRanjani Sridharan 			sdev->dsp_power_state.state);
51466de6bebSRanjani Sridharan 		break;
51566de6bebSRanjani Sridharan 	}
51666de6bebSRanjani Sridharan }
51766de6bebSRanjani Sridharan 
51861e285caSRanjani Sridharan /*
51961e285caSRanjani Sridharan  * All DSP power state transitions are initiated by the driver.
52061e285caSRanjani Sridharan  * If the requested state change fails, the error is simply returned.
52161e285caSRanjani Sridharan  * Further state transitions are attempted only when the set_power_save() op
52261e285caSRanjani Sridharan  * is called again either because of a new IPC sent to the DSP or
52361e285caSRanjani Sridharan  * during system suspend/resume.
52461e285caSRanjani Sridharan  */
52561e285caSRanjani Sridharan int hda_dsp_set_power_state(struct snd_sof_dev *sdev,
52661e285caSRanjani Sridharan 			    const struct sof_dsp_power_state *target_state)
52761e285caSRanjani Sridharan {
52861e285caSRanjani Sridharan 	int ret = 0;
52961e285caSRanjani Sridharan 
530851fd873SRanjani Sridharan 	/*
531851fd873SRanjani Sridharan 	 * When the DSP is already in D0I3 and the target state is D0I3,
532851fd873SRanjani Sridharan 	 * it could be the case that the DSP is in D0I3 during S0
533851fd873SRanjani Sridharan 	 * and the system is suspending to S0Ix. Therefore,
534851fd873SRanjani Sridharan 	 * hda_dsp_set_D0_state() must be called to disable trace DMA
535851fd873SRanjani Sridharan 	 * by sending the PM_GATE IPC to the FW.
536851fd873SRanjani Sridharan 	 */
537851fd873SRanjani Sridharan 	if (target_state->substate == SOF_HDA_DSP_PM_D0I3 &&
538851fd873SRanjani Sridharan 	    sdev->system_suspend_target == SOF_SUSPEND_S0IX)
539851fd873SRanjani Sridharan 		goto set_state;
540851fd873SRanjani Sridharan 
541851fd873SRanjani Sridharan 	/*
542851fd873SRanjani Sridharan 	 * For all other cases, return without doing anything if
543851fd873SRanjani Sridharan 	 * the DSP is already in the target state.
544851fd873SRanjani Sridharan 	 */
54561e285caSRanjani Sridharan 	if (target_state->state == sdev->dsp_power_state.state &&
54661e285caSRanjani Sridharan 	    target_state->substate == sdev->dsp_power_state.substate)
54761e285caSRanjani Sridharan 		return 0;
54861e285caSRanjani Sridharan 
549851fd873SRanjani Sridharan set_state:
55061e285caSRanjani Sridharan 	switch (target_state->state) {
55161e285caSRanjani Sridharan 	case SOF_DSP_PM_D0:
55261e285caSRanjani Sridharan 		ret = hda_dsp_set_D0_state(sdev, target_state);
55361e285caSRanjani Sridharan 		break;
55461e285caSRanjani Sridharan 	case SOF_DSP_PM_D3:
55561e285caSRanjani Sridharan 		/* The only allowed transition is: D0I0 -> D3 */
55661e285caSRanjani Sridharan 		if (sdev->dsp_power_state.state == SOF_DSP_PM_D0 &&
55761e285caSRanjani Sridharan 		    sdev->dsp_power_state.substate == SOF_HDA_DSP_PM_D0I0)
55861e285caSRanjani Sridharan 			break;
55961e285caSRanjani Sridharan 
56061e285caSRanjani Sridharan 		dev_err(sdev->dev,
56161e285caSRanjani Sridharan 			"error: transition from %d to %d not allowed\n",
56261e285caSRanjani Sridharan 			sdev->dsp_power_state.state, target_state->state);
56361e285caSRanjani Sridharan 		return -EINVAL;
56461e285caSRanjani Sridharan 	default:
56561e285caSRanjani Sridharan 		dev_err(sdev->dev, "error: target state unsupported %d\n",
56661e285caSRanjani Sridharan 			target_state->state);
56761e285caSRanjani Sridharan 		return -EINVAL;
56861e285caSRanjani Sridharan 	}
56961e285caSRanjani Sridharan 	if (ret < 0) {
57061e285caSRanjani Sridharan 		dev_err(sdev->dev,
57161e285caSRanjani Sridharan 			"failed to set requested target DSP state %d substate %d\n",
57261e285caSRanjani Sridharan 			target_state->state, target_state->substate);
57361e285caSRanjani Sridharan 		return ret;
57461e285caSRanjani Sridharan 	}
57561e285caSRanjani Sridharan 
57661e285caSRanjani Sridharan 	sdev->dsp_power_state = *target_state;
57766de6bebSRanjani Sridharan 	hda_dsp_state_log(sdev);
57861e285caSRanjani Sridharan 	return ret;
57961e285caSRanjani Sridharan }
58061e285caSRanjani Sridharan 
58161e285caSRanjani Sridharan /*
58261e285caSRanjani Sridharan  * Audio DSP states may transform as below:-
58361e285caSRanjani Sridharan  *
584207bf12fSRanjani Sridharan  *                                         Opportunistic D0I3 in S0
585207bf12fSRanjani Sridharan  *     Runtime    +---------------------+  Delayed D0i3 work timeout
58661e285caSRanjani Sridharan  *     suspend    |                     +--------------------+
587207bf12fSRanjani Sridharan  *   +------------+       D0I0(active)  |                    |
58861e285caSRanjani Sridharan  *   |            |                     <---------------+    |
589207bf12fSRanjani Sridharan  *   |   +-------->                     |    New IPC	|    |
590207bf12fSRanjani Sridharan  *   |   |Runtime +--^--+---------^--+--+ (via mailbox)	|    |
591207bf12fSRanjani Sridharan  *   |   |resume     |  |         |  |			|    |
592207bf12fSRanjani Sridharan  *   |   |           |  |         |  |			|    |
593207bf12fSRanjani Sridharan  *   |   |     System|  |         |  |			|    |
594207bf12fSRanjani Sridharan  *   |   |     resume|  | S3/S0IX |  |                  |    |
595207bf12fSRanjani Sridharan  *   |   |	     |  | suspend |  | S0IX             |    |
59661e285caSRanjani Sridharan  *   |   |           |  |         |  |suspend           |    |
59761e285caSRanjani Sridharan  *   |   |           |  |         |  |                  |    |
59861e285caSRanjani Sridharan  *   |   |           |  |         |  |                  |    |
59961e285caSRanjani Sridharan  * +-v---+-----------+--v-------+ |  |           +------+----v----+
60061e285caSRanjani Sridharan  * |                            | |  +----------->                |
601207bf12fSRanjani Sridharan  * |       D3 (suspended)       | |              |      D0I3      |
602207bf12fSRanjani Sridharan  * |                            | +--------------+                |
603207bf12fSRanjani Sridharan  * |                            |  System resume |                |
604207bf12fSRanjani Sridharan  * +----------------------------+		 +----------------+
60561e285caSRanjani Sridharan  *
606207bf12fSRanjani Sridharan  * S0IX suspend: The DSP is in D0I3 if any D0I3-compatible streams
607207bf12fSRanjani Sridharan  *		 ignored the suspend trigger. Otherwise the DSP
608207bf12fSRanjani Sridharan  *		 is in D3.
60961e285caSRanjani Sridharan  */
61061e285caSRanjani Sridharan 
6111c38c922SFred Oh static int hda_suspend(struct snd_sof_dev *sdev, bool runtime_suspend)
612747503b1SLiam Girdwood {
613747503b1SLiam Girdwood 	struct sof_intel_hda_dev *hda = sdev->pdata->hw_pdata;
614747503b1SLiam Girdwood 	const struct sof_intel_dsp_desc *chip = hda->desc;
615747503b1SLiam Girdwood #if IS_ENABLED(CONFIG_SND_SOC_SOF_HDA)
616747503b1SLiam Girdwood 	struct hdac_bus *bus = sof_to_bus(sdev);
617747503b1SLiam Girdwood #endif
618d4165199SRanjani Sridharan 	int ret, j;
619747503b1SLiam Girdwood 
62057724db1SPeter Ujfalusi 	/*
62157724db1SPeter Ujfalusi 	 * The memory used for IMR boot loses its content in deeper than S3 state
62257724db1SPeter Ujfalusi 	 * We must not try IMR boot on next power up (as it will fail).
6233b99852fSPeter Ujfalusi 	 *
6243b99852fSPeter Ujfalusi 	 * In case of firmware crash or boot failure set the skip_imr_boot to true
6253b99852fSPeter Ujfalusi 	 * as well in order to try to re-load the firmware to do a 'cold' boot.
62657724db1SPeter Ujfalusi 	 */
6273b99852fSPeter Ujfalusi 	if (sdev->system_suspend_target > SOF_SUSPEND_S3 ||
6283b99852fSPeter Ujfalusi 	    sdev->fw_state == SOF_FW_CRASHED ||
6293b99852fSPeter Ujfalusi 	    sdev->fw_state == SOF_FW_BOOT_FAILED)
63057724db1SPeter Ujfalusi 		hda->skip_imr_boot = true;
63157724db1SPeter Ujfalusi 
632*0fbd539fSRanjani Sridharan 	ret = chip->disable_interrupts(sdev);
633*0fbd539fSRanjani Sridharan 	if (ret < 0)
634*0fbd539fSRanjani Sridharan 		return ret;
635747503b1SLiam Girdwood 
636747503b1SLiam Girdwood #if IS_ENABLED(CONFIG_SND_SOC_SOF_HDA)
637fd572393SKai Vehmanen 	hda_codec_jack_wake_enable(sdev, runtime_suspend);
638fd15f2f5SRander Wang 
639747503b1SLiam Girdwood 	/* power down all hda link */
640747503b1SLiam Girdwood 	snd_hdac_ext_bus_link_power_down_all(bus);
641747503b1SLiam Girdwood #endif
642747503b1SLiam Girdwood 
643*0fbd539fSRanjani Sridharan 	ret = chip->power_down_dsp(sdev);
644747503b1SLiam Girdwood 	if (ret < 0) {
645*0fbd539fSRanjani Sridharan 		dev_err(sdev->dev, "failed to power down DSP during suspend\n");
646747503b1SLiam Girdwood 		return ret;
647747503b1SLiam Girdwood 	}
648747503b1SLiam Girdwood 
649d4165199SRanjani Sridharan 	/* reset ref counts for all cores */
650d4165199SRanjani Sridharan 	for (j = 0; j < chip->cores_num; j++)
651d4165199SRanjani Sridharan 		sdev->dsp_core_ref_count[j] = 0;
652d4165199SRanjani Sridharan 
653747503b1SLiam Girdwood 	/* disable ppcap interrupt */
654747503b1SLiam Girdwood 	hda_dsp_ctrl_ppcap_enable(sdev, false);
655747503b1SLiam Girdwood 	hda_dsp_ctrl_ppcap_int_enable(sdev, false);
656747503b1SLiam Girdwood 
6579a50ee58SZhu Yingjiang 	/* disable hda bus irq and streams */
6589a50ee58SZhu Yingjiang 	hda_dsp_ctrl_stop_chip(sdev);
659747503b1SLiam Girdwood 
660747503b1SLiam Girdwood 	/* disable LP retention mode */
661747503b1SLiam Girdwood 	snd_sof_pci_update_bits(sdev, PCI_PGCTL,
662747503b1SLiam Girdwood 				PCI_PGCTL_LSRMD_MASK, PCI_PGCTL_LSRMD_MASK);
663747503b1SLiam Girdwood 
664747503b1SLiam Girdwood 	/* reset controller */
665747503b1SLiam Girdwood 	ret = hda_dsp_ctrl_link_reset(sdev, true);
666747503b1SLiam Girdwood 	if (ret < 0) {
667747503b1SLiam Girdwood 		dev_err(sdev->dev,
668747503b1SLiam Girdwood 			"error: failed to reset controller during suspend\n");
669747503b1SLiam Girdwood 		return ret;
670747503b1SLiam Girdwood 	}
671747503b1SLiam Girdwood 
672816938b2SKai Vehmanen 	/* display codec can powered off after link reset */
673816938b2SKai Vehmanen 	hda_codec_i915_display_power(sdev, false);
674816938b2SKai Vehmanen 
675747503b1SLiam Girdwood 	return 0;
676747503b1SLiam Girdwood }
677747503b1SLiam Girdwood 
678fd15f2f5SRander Wang static int hda_resume(struct snd_sof_dev *sdev, bool runtime_resume)
679747503b1SLiam Girdwood {
680747503b1SLiam Girdwood #if IS_ENABLED(CONFIG_SND_SOC_SOF_HDA)
681747503b1SLiam Girdwood 	struct hdac_bus *bus = sof_to_bus(sdev);
682747503b1SLiam Girdwood 	struct hdac_ext_link *hlink = NULL;
683747503b1SLiam Girdwood #endif
684747503b1SLiam Girdwood 	int ret;
685747503b1SLiam Girdwood 
686816938b2SKai Vehmanen 	/* display codec must be powered before link reset */
687816938b2SKai Vehmanen 	hda_codec_i915_display_power(sdev, true);
688816938b2SKai Vehmanen 
689747503b1SLiam Girdwood 	/*
690747503b1SLiam Girdwood 	 * clear TCSEL to clear playback on some HD Audio
691747503b1SLiam Girdwood 	 * codecs. PCI TCSEL is defined in the Intel manuals.
692747503b1SLiam Girdwood 	 */
693747503b1SLiam Girdwood 	snd_sof_pci_update_bits(sdev, PCI_TCSEL, 0x07, 0);
694747503b1SLiam Girdwood 
695747503b1SLiam Girdwood 	/* reset and start hda controller */
696747503b1SLiam Girdwood 	ret = hda_dsp_ctrl_init_chip(sdev, true);
697747503b1SLiam Girdwood 	if (ret < 0) {
698747503b1SLiam Girdwood 		dev_err(sdev->dev,
699747503b1SLiam Girdwood 			"error: failed to start controller after resume\n");
7001372c768SKai Vehmanen 		goto cleanup;
701747503b1SLiam Girdwood 	}
702747503b1SLiam Girdwood 
703fd15f2f5SRander Wang #if IS_ENABLED(CONFIG_SND_SOC_SOF_HDA)
704fd15f2f5SRander Wang 	/* check jack status */
70531ba0c07SKai-Heng Feng 	if (runtime_resume) {
70631ba0c07SKai-Heng Feng 		hda_codec_jack_wake_enable(sdev, false);
707ef4d764cSKai-Heng Feng 		if (sdev->system_suspend_target == SOF_SUSPEND_NONE)
708fd15f2f5SRander Wang 			hda_codec_jack_check(sdev);
70931ba0c07SKai-Heng Feng 	}
7106aa232e1SRander Wang 
7116aa232e1SRander Wang 	/* turn off the links that were off before suspend */
7126aa232e1SRander Wang 	list_for_each_entry(hlink, &bus->hlink_list, list) {
7136aa232e1SRander Wang 		if (!hlink->ref_count)
7146aa232e1SRander Wang 			snd_hdac_ext_bus_link_power_down(hlink);
7156aa232e1SRander Wang 	}
7166aa232e1SRander Wang 
7176aa232e1SRander Wang 	/* check dma status and clean up CORB/RIRB buffers */
7186aa232e1SRander Wang 	if (!bus->cmd_dma_state)
7196aa232e1SRander Wang 		snd_hdac_bus_stop_cmd_io(bus);
72024b6ff68SZhu Yingjiang #endif
721747503b1SLiam Girdwood 
722747503b1SLiam Girdwood 	/* enable ppcap interrupt */
723747503b1SLiam Girdwood 	hda_dsp_ctrl_ppcap_enable(sdev, true);
724747503b1SLiam Girdwood 	hda_dsp_ctrl_ppcap_int_enable(sdev, true);
725747503b1SLiam Girdwood 
7261372c768SKai Vehmanen cleanup:
7271372c768SKai Vehmanen 	/* display codec can powered off after controller init */
7281372c768SKai Vehmanen 	hda_codec_i915_display_power(sdev, false);
7291372c768SKai Vehmanen 
730747503b1SLiam Girdwood 	return 0;
731747503b1SLiam Girdwood }
732747503b1SLiam Girdwood 
733747503b1SLiam Girdwood int hda_dsp_resume(struct snd_sof_dev *sdev)
734747503b1SLiam Girdwood {
73516299326SKeyon Jie 	struct sof_intel_hda_dev *hda = sdev->pdata->hw_pdata;
73666e40876SKeyon Jie 	struct pci_dev *pci = to_pci_dev(sdev->dev);
73761e285caSRanjani Sridharan 	const struct sof_dsp_power_state target_state = {
73861e285caSRanjani Sridharan 		.state = SOF_DSP_PM_D0,
73961e285caSRanjani Sridharan 		.substate = SOF_HDA_DSP_PM_D0I0,
74061e285caSRanjani Sridharan 	};
741195f1019SMarcin Rajwa #if IS_ENABLED(CONFIG_SND_SOC_SOF_HDA)
742195f1019SMarcin Rajwa 	struct hdac_bus *bus = sof_to_bus(sdev);
743195f1019SMarcin Rajwa 	struct hdac_ext_link *hlink = NULL;
744195f1019SMarcin Rajwa #endif
74561e285caSRanjani Sridharan 	int ret;
74666e40876SKeyon Jie 
74761e285caSRanjani Sridharan 	/* resume from D0I3 */
74861e285caSRanjani Sridharan 	if (sdev->dsp_power_state.state == SOF_DSP_PM_D0) {
749195f1019SMarcin Rajwa #if IS_ENABLED(CONFIG_SND_SOC_SOF_HDA)
750195f1019SMarcin Rajwa 		/* power up links that were active before suspend */
751195f1019SMarcin Rajwa 		list_for_each_entry(hlink, &bus->hlink_list, list) {
752195f1019SMarcin Rajwa 			if (hlink->ref_count) {
753195f1019SMarcin Rajwa 				ret = snd_hdac_ext_bus_link_power_up(hlink);
754195f1019SMarcin Rajwa 				if (ret < 0) {
7556d5e37b0SPierre-Louis Bossart 					dev_err(sdev->dev,
756ce1f55baSCurtis Malainey 						"error %d in %s: failed to power up links",
757195f1019SMarcin Rajwa 						ret, __func__);
758195f1019SMarcin Rajwa 					return ret;
759195f1019SMarcin Rajwa 				}
760195f1019SMarcin Rajwa 			}
761195f1019SMarcin Rajwa 		}
762195f1019SMarcin Rajwa 
763195f1019SMarcin Rajwa 		/* set up CORB/RIRB buffers if was on before suspend */
764195f1019SMarcin Rajwa 		if (bus->cmd_dma_state)
765195f1019SMarcin Rajwa 			snd_hdac_bus_init_cmd_io(bus);
766195f1019SMarcin Rajwa #endif
767195f1019SMarcin Rajwa 
76861e285caSRanjani Sridharan 		/* Set DSP power state */
769787c5214SRanjani Sridharan 		ret = snd_sof_dsp_set_power_state(sdev, &target_state);
77061e285caSRanjani Sridharan 		if (ret < 0) {
77161e285caSRanjani Sridharan 			dev_err(sdev->dev, "error: setting dsp state %d substate %d\n",
77261e285caSRanjani Sridharan 				target_state.state, target_state.substate);
77361e285caSRanjani Sridharan 			return ret;
77461e285caSRanjani Sridharan 		}
77561e285caSRanjani Sridharan 
77616299326SKeyon Jie 		/* restore L1SEN bit */
77716299326SKeyon Jie 		if (hda->l1_support_changed)
77816299326SKeyon Jie 			snd_sof_dsp_update_bits(sdev, HDA_DSP_HDA_BAR,
77916299326SKeyon Jie 						HDA_VS_INTEL_EM2,
78016299326SKeyon Jie 						HDA_VS_INTEL_EM2_L1SEN, 0);
78116299326SKeyon Jie 
78266e40876SKeyon Jie 		/* restore and disable the system wakeup */
78366e40876SKeyon Jie 		pci_restore_state(pci);
78466e40876SKeyon Jie 		disable_irq_wake(pci->irq);
78566e40876SKeyon Jie 		return 0;
78666e40876SKeyon Jie 	}
78766e40876SKeyon Jie 
788747503b1SLiam Girdwood 	/* init hda controller. DSP cores will be powered up during fw boot */
78961e285caSRanjani Sridharan 	ret = hda_resume(sdev, false);
79061e285caSRanjani Sridharan 	if (ret < 0)
79161e285caSRanjani Sridharan 		return ret;
79261e285caSRanjani Sridharan 
793787c5214SRanjani Sridharan 	return snd_sof_dsp_set_power_state(sdev, &target_state);
794747503b1SLiam Girdwood }
795747503b1SLiam Girdwood 
796747503b1SLiam Girdwood int hda_dsp_runtime_resume(struct snd_sof_dev *sdev)
797747503b1SLiam Girdwood {
79861e285caSRanjani Sridharan 	const struct sof_dsp_power_state target_state = {
79961e285caSRanjani Sridharan 		.state = SOF_DSP_PM_D0,
80061e285caSRanjani Sridharan 	};
80161e285caSRanjani Sridharan 	int ret;
80261e285caSRanjani Sridharan 
803747503b1SLiam Girdwood 	/* init hda controller. DSP cores will be powered up during fw boot */
80461e285caSRanjani Sridharan 	ret = hda_resume(sdev, true);
80561e285caSRanjani Sridharan 	if (ret < 0)
80661e285caSRanjani Sridharan 		return ret;
80761e285caSRanjani Sridharan 
808787c5214SRanjani Sridharan 	return snd_sof_dsp_set_power_state(sdev, &target_state);
809747503b1SLiam Girdwood }
810747503b1SLiam Girdwood 
81187a6fe80SKai Vehmanen int hda_dsp_runtime_idle(struct snd_sof_dev *sdev)
81287a6fe80SKai Vehmanen {
81387a6fe80SKai Vehmanen 	struct hdac_bus *hbus = sof_to_bus(sdev);
81487a6fe80SKai Vehmanen 
81587a6fe80SKai Vehmanen 	if (hbus->codec_powered) {
81687a6fe80SKai Vehmanen 		dev_dbg(sdev->dev, "some codecs still powered (%08X), not idle\n",
81787a6fe80SKai Vehmanen 			(unsigned int)hbus->codec_powered);
81887a6fe80SKai Vehmanen 		return -EBUSY;
81987a6fe80SKai Vehmanen 	}
82087a6fe80SKai Vehmanen 
82187a6fe80SKai Vehmanen 	return 0;
82287a6fe80SKai Vehmanen }
82387a6fe80SKai Vehmanen 
8241c38c922SFred Oh int hda_dsp_runtime_suspend(struct snd_sof_dev *sdev)
825747503b1SLiam Girdwood {
8260084364dSRanjani Sridharan 	struct sof_intel_hda_dev *hda = sdev->pdata->hw_pdata;
82761e285caSRanjani Sridharan 	const struct sof_dsp_power_state target_state = {
82861e285caSRanjani Sridharan 		.state = SOF_DSP_PM_D3,
82961e285caSRanjani Sridharan 	};
83061e285caSRanjani Sridharan 	int ret;
83161e285caSRanjani Sridharan 
8320084364dSRanjani Sridharan 	/* cancel any attempt for DSP D0I3 */
8330084364dSRanjani Sridharan 	cancel_delayed_work_sync(&hda->d0i3_work);
8340084364dSRanjani Sridharan 
835747503b1SLiam Girdwood 	/* stop hda controller and power dsp off */
83661e285caSRanjani Sridharan 	ret = hda_suspend(sdev, true);
83761e285caSRanjani Sridharan 	if (ret < 0)
83861e285caSRanjani Sridharan 		return ret;
83961e285caSRanjani Sridharan 
840787c5214SRanjani Sridharan 	return snd_sof_dsp_set_power_state(sdev, &target_state);
841747503b1SLiam Girdwood }
842747503b1SLiam Girdwood 
84361e285caSRanjani Sridharan int hda_dsp_suspend(struct snd_sof_dev *sdev, u32 target_state)
844747503b1SLiam Girdwood {
84516299326SKeyon Jie 	struct sof_intel_hda_dev *hda = sdev->pdata->hw_pdata;
846747503b1SLiam Girdwood 	struct hdac_bus *bus = sof_to_bus(sdev);
84766e40876SKeyon Jie 	struct pci_dev *pci = to_pci_dev(sdev->dev);
84861e285caSRanjani Sridharan 	const struct sof_dsp_power_state target_dsp_state = {
84961e285caSRanjani Sridharan 		.state = target_state,
85061e285caSRanjani Sridharan 		.substate = target_state == SOF_DSP_PM_D0 ?
85161e285caSRanjani Sridharan 				SOF_HDA_DSP_PM_D0I3 : 0,
85261e285caSRanjani Sridharan 	};
853747503b1SLiam Girdwood 	int ret;
854747503b1SLiam Girdwood 
85563e51fd3SRanjani Sridharan 	/* cancel any attempt for DSP D0I3 */
85663e51fd3SRanjani Sridharan 	cancel_delayed_work_sync(&hda->d0i3_work);
85763e51fd3SRanjani Sridharan 
85861e285caSRanjani Sridharan 	if (target_state == SOF_DSP_PM_D0) {
85961e285caSRanjani Sridharan 		/* Set DSP power state */
860787c5214SRanjani Sridharan 		ret = snd_sof_dsp_set_power_state(sdev, &target_dsp_state);
86161e285caSRanjani Sridharan 		if (ret < 0) {
86261e285caSRanjani Sridharan 			dev_err(sdev->dev, "error: setting dsp state %d substate %d\n",
86361e285caSRanjani Sridharan 				target_dsp_state.state,
86461e285caSRanjani Sridharan 				target_dsp_state.substate);
86561e285caSRanjani Sridharan 			return ret;
86661e285caSRanjani Sridharan 		}
86761e285caSRanjani Sridharan 
86816299326SKeyon Jie 		/* enable L1SEN to make sure the system can enter S0Ix */
86916299326SKeyon Jie 		hda->l1_support_changed =
87016299326SKeyon Jie 			snd_sof_dsp_update_bits(sdev, HDA_DSP_HDA_BAR,
87116299326SKeyon Jie 						HDA_VS_INTEL_EM2,
87216299326SKeyon Jie 						HDA_VS_INTEL_EM2_L1SEN,
87316299326SKeyon Jie 						HDA_VS_INTEL_EM2_L1SEN);
87416299326SKeyon Jie 
875195f1019SMarcin Rajwa #if IS_ENABLED(CONFIG_SND_SOC_SOF_HDA)
876195f1019SMarcin Rajwa 		/* stop the CORB/RIRB DMA if it is On */
877195f1019SMarcin Rajwa 		if (bus->cmd_dma_state)
878195f1019SMarcin Rajwa 			snd_hdac_bus_stop_cmd_io(bus);
879195f1019SMarcin Rajwa 
880195f1019SMarcin Rajwa 		/* no link can be powered in s0ix state */
881195f1019SMarcin Rajwa 		ret = snd_hdac_ext_bus_link_power_down_all(bus);
882195f1019SMarcin Rajwa 		if (ret < 0) {
8836d5e37b0SPierre-Louis Bossart 			dev_err(sdev->dev,
884195f1019SMarcin Rajwa 				"error %d in %s: failed to power down links",
885195f1019SMarcin Rajwa 				ret, __func__);
886195f1019SMarcin Rajwa 			return ret;
887195f1019SMarcin Rajwa 		}
888195f1019SMarcin Rajwa #endif
889195f1019SMarcin Rajwa 
89066e40876SKeyon Jie 		/* enable the system waking up via IPC IRQ */
89166e40876SKeyon Jie 		enable_irq_wake(pci->irq);
89266e40876SKeyon Jie 		pci_save_state(pci);
89366e40876SKeyon Jie 		return 0;
89466e40876SKeyon Jie 	}
89566e40876SKeyon Jie 
896747503b1SLiam Girdwood 	/* stop hda controller and power dsp off */
8971c38c922SFred Oh 	ret = hda_suspend(sdev, false);
898747503b1SLiam Girdwood 	if (ret < 0) {
899747503b1SLiam Girdwood 		dev_err(bus->dev, "error: suspending dsp\n");
900747503b1SLiam Girdwood 		return ret;
901747503b1SLiam Girdwood 	}
902747503b1SLiam Girdwood 
903787c5214SRanjani Sridharan 	return snd_sof_dsp_set_power_state(sdev, &target_dsp_state);
904747503b1SLiam Girdwood }
905ed3baacdSRanjani Sridharan 
90622aa9e02SLibin Yang int hda_dsp_shutdown(struct snd_sof_dev *sdev)
90722aa9e02SLibin Yang {
90822aa9e02SLibin Yang 	sdev->system_suspend_target = SOF_SUSPEND_S3;
90922aa9e02SLibin Yang 	return snd_sof_suspend(sdev->dev);
91022aa9e02SLibin Yang }
91122aa9e02SLibin Yang 
9127077a07aSRanjani Sridharan int hda_dsp_set_hw_params_upon_resume(struct snd_sof_dev *sdev)
913ed3baacdSRanjani Sridharan {
914f09e9284SPierre-Louis Bossart 	int ret;
9157077a07aSRanjani Sridharan 
916f09e9284SPierre-Louis Bossart 	/* make sure all DAI resources are freed */
917f09e9284SPierre-Louis Bossart 	ret = hda_dsp_dais_suspend(sdev);
918f09e9284SPierre-Louis Bossart 	if (ret < 0)
919f09e9284SPierre-Louis Bossart 		dev_warn(sdev->dev, "%s: failure in hda_dsp_dais_suspend\n", __func__);
920a3ebccb5SKai Vehmanen 
921f09e9284SPierre-Louis Bossart 	return ret;
922ed3baacdSRanjani Sridharan }
92363e51fd3SRanjani Sridharan 
92463e51fd3SRanjani Sridharan void hda_dsp_d0i3_work(struct work_struct *work)
92563e51fd3SRanjani Sridharan {
92663e51fd3SRanjani Sridharan 	struct sof_intel_hda_dev *hdev = container_of(work,
92763e51fd3SRanjani Sridharan 						      struct sof_intel_hda_dev,
92863e51fd3SRanjani Sridharan 						      d0i3_work.work);
92963e51fd3SRanjani Sridharan 	struct hdac_bus *bus = &hdev->hbus.core;
93063e51fd3SRanjani Sridharan 	struct snd_sof_dev *sdev = dev_get_drvdata(bus->dev);
931f1bb0235SGuennadi Liakhovetski 	struct sof_dsp_power_state target_state = {
932f1bb0235SGuennadi Liakhovetski 		.state = SOF_DSP_PM_D0,
933f1bb0235SGuennadi Liakhovetski 		.substate = SOF_HDA_DSP_PM_D0I3,
934f1bb0235SGuennadi Liakhovetski 	};
93563e51fd3SRanjani Sridharan 	int ret;
93663e51fd3SRanjani Sridharan 
93763e51fd3SRanjani Sridharan 	/* DSP can enter D0I3 iff only D0I3-compatible streams are active */
938f1bb0235SGuennadi Liakhovetski 	if (!snd_sof_dsp_only_d0i3_compatible_stream_active(sdev))
93963e51fd3SRanjani Sridharan 		/* remain in D0I0 */
94063e51fd3SRanjani Sridharan 		return;
94163e51fd3SRanjani Sridharan 
94263e51fd3SRanjani Sridharan 	/* This can fail but error cannot be propagated */
943787c5214SRanjani Sridharan 	ret = snd_sof_dsp_set_power_state(sdev, &target_state);
94463e51fd3SRanjani Sridharan 	if (ret < 0)
94563e51fd3SRanjani Sridharan 		dev_err_ratelimited(sdev->dev,
94663e51fd3SRanjani Sridharan 				    "error: failed to set DSP state %d substate %d\n",
94763e51fd3SRanjani Sridharan 				    target_state.state, target_state.substate);
94863e51fd3SRanjani Sridharan }
9499cdcbc9fSRanjani Sridharan 
9509cdcbc9fSRanjani Sridharan int hda_dsp_core_get(struct snd_sof_dev *sdev, int core)
9519cdcbc9fSRanjani Sridharan {
9527a567740SPeter Ujfalusi 	const struct sof_ipc_pm_ops *pm_ops = sdev->ipc->ops->pm;
9539cdcbc9fSRanjani Sridharan 	int ret, ret1;
9549cdcbc9fSRanjani Sridharan 
9559cdcbc9fSRanjani Sridharan 	/* power up core */
9569cdcbc9fSRanjani Sridharan 	ret = hda_dsp_enable_core(sdev, BIT(core));
9579cdcbc9fSRanjani Sridharan 	if (ret < 0) {
9589cdcbc9fSRanjani Sridharan 		dev_err(sdev->dev, "failed to power up core %d with err: %d\n",
9599cdcbc9fSRanjani Sridharan 			core, ret);
9609cdcbc9fSRanjani Sridharan 		return ret;
9619cdcbc9fSRanjani Sridharan 	}
9629cdcbc9fSRanjani Sridharan 
9639cdcbc9fSRanjani Sridharan 	/* No need to send IPC for primary core or if FW boot is not complete */
9649cdcbc9fSRanjani Sridharan 	if (sdev->fw_state != SOF_FW_BOOT_COMPLETE || core == SOF_DSP_PRIMARY_CORE)
9659cdcbc9fSRanjani Sridharan 		return 0;
9669cdcbc9fSRanjani Sridharan 
9677a567740SPeter Ujfalusi 	/* No need to continue the set_core_state ops is not available */
9687a567740SPeter Ujfalusi 	if (!pm_ops->set_core_state)
9697a567740SPeter Ujfalusi 		return 0;
9707a567740SPeter Ujfalusi 
9719cdcbc9fSRanjani Sridharan 	/* Now notify DSP for secondary cores */
9727a567740SPeter Ujfalusi 	ret = pm_ops->set_core_state(sdev, core, true);
9739cdcbc9fSRanjani Sridharan 	if (ret < 0) {
9749cdcbc9fSRanjani Sridharan 		dev_err(sdev->dev, "failed to enable secondary core '%d' failed with %d\n",
9759cdcbc9fSRanjani Sridharan 			core, ret);
9769cdcbc9fSRanjani Sridharan 		goto power_down;
9779cdcbc9fSRanjani Sridharan 	}
9789cdcbc9fSRanjani Sridharan 
9799cdcbc9fSRanjani Sridharan 	return ret;
9809cdcbc9fSRanjani Sridharan 
9819cdcbc9fSRanjani Sridharan power_down:
9829cdcbc9fSRanjani Sridharan 	/* power down core if it is host managed and return the original error if this fails too */
9839cdcbc9fSRanjani Sridharan 	ret1 = hda_dsp_core_reset_power_down(sdev, BIT(core));
9849cdcbc9fSRanjani Sridharan 	if (ret1 < 0)
9859cdcbc9fSRanjani Sridharan 		dev_err(sdev->dev, "failed to power down core: %d with err: %d\n", core, ret1);
9869cdcbc9fSRanjani Sridharan 
9879cdcbc9fSRanjani Sridharan 	return ret;
9889cdcbc9fSRanjani Sridharan }
989b2520dbcSRanjani Sridharan 
990b2520dbcSRanjani Sridharan int hda_dsp_disable_interrupts(struct snd_sof_dev *sdev)
991b2520dbcSRanjani Sridharan {
992b2520dbcSRanjani Sridharan 	hda_sdw_int_enable(sdev, false);
993b2520dbcSRanjani Sridharan 	hda_dsp_ipc_int_disable(sdev);
994b2520dbcSRanjani Sridharan 
995b2520dbcSRanjani Sridharan 	return 0;
996b2520dbcSRanjani Sridharan }
997