// SPDX-License-Identifier: GPL-2.0+
  //
  // soc-pcm.c  --  ALSA SoC PCM
  //
  // Copyright 2005 Wolfson Microelectronics PLC.
  // Copyright 2005 Openedhand Ltd.
  // Copyright (C) 2010 Slimlogic Ltd.
  // Copyright (C) 2010 Texas Instruments Inc.
  //
  // Authors: Liam Girdwood <lrg@ti.com>
  //          Mark Brown <broonie@opensource.wolfsonmicro.com>

  
  #include <linux/kernel.h>
  #include <linux/init.h>
  #include <linux/delay.h>

  #include <linux/pinctrl/consumer.h>

  #include <linux/pm_runtime.h>

  #include <linux/slab.h>
  #include <linux/workqueue.h>

  #include <linux/export.h>

  #include <linux/debugfs.h>

  #include <sound/core.h>
  #include <sound/pcm.h>
  #include <sound/pcm_params.h>
  #include <sound/soc.h>

  #include <sound/soc-dpcm.h>

  #include <sound/soc-link.h>

  #include <sound/initval.h>

  #define DPCM_MAX_BE_USERS	8

  #ifdef CONFIG_DEBUG_FS
  static const char *dpcm_state_string(enum snd_soc_dpcm_state state)
  {
  	switch (state) {
  	case SND_SOC_DPCM_STATE_NEW:
  		return "new";
  	case SND_SOC_DPCM_STATE_OPEN:
  		return "open";
  	case SND_SOC_DPCM_STATE_HW_PARAMS:
  		return "hw_params";
  	case SND_SOC_DPCM_STATE_PREPARE:
  		return "prepare";
  	case SND_SOC_DPCM_STATE_START:
  		return "start";
  	case SND_SOC_DPCM_STATE_STOP:
  		return "stop";
  	case SND_SOC_DPCM_STATE_SUSPEND:
  		return "suspend";
  	case SND_SOC_DPCM_STATE_PAUSED:
  		return "paused";
  	case SND_SOC_DPCM_STATE_HW_FREE:
  		return "hw_free";
  	case SND_SOC_DPCM_STATE_CLOSE:
  		return "close";
  	}
  
  	return "unknown";
  }
  
  static ssize_t dpcm_show_state(struct snd_soc_pcm_runtime *fe,
  			       int stream, char *buf, size_t size)
  {
  	struct snd_pcm_hw_params *params = &fe->dpcm[stream].hw_params;
  	struct snd_soc_dpcm *dpcm;
  	ssize_t offset = 0;
  	unsigned long flags;
  
  	/* FE state */

  	offset += scnprintf(buf + offset, size - offset,

  			   "[%s - %s]
  ", fe->dai_link->name,
  			   stream ? "Capture" : "Playback");

  	offset += scnprintf(buf + offset, size - offset, "State: %s
  ",

  			   dpcm_state_string(fe->dpcm[stream].state));
  
  	if ((fe->dpcm[stream].state >= SND_SOC_DPCM_STATE_HW_PARAMS) &&
  	    (fe->dpcm[stream].state <= SND_SOC_DPCM_STATE_STOP))

  		offset += scnprintf(buf + offset, size - offset,

  				   "Hardware Params: "
  				   "Format = %s, Channels = %d, Rate = %d
  ",
  				   snd_pcm_format_name(params_format(params)),
  				   params_channels(params),
  				   params_rate(params));
  
  	/* BEs state */

  	offset += scnprintf(buf + offset, size - offset, "Backends:
  ");

  
  	if (list_empty(&fe->dpcm[stream].be_clients)) {

  		offset += scnprintf(buf + offset, size - offset,

  				   " No active DSP links
  ");
  		goto out;
  	}
  
  	spin_lock_irqsave(&fe->card->dpcm_lock, flags);
  	for_each_dpcm_be(fe, stream, dpcm) {
  		struct snd_soc_pcm_runtime *be = dpcm->be;
  		params = &dpcm->hw_params;

  		offset += scnprintf(buf + offset, size - offset,

  				   "- %s
  ", be->dai_link->name);

  		offset += scnprintf(buf + offset, size - offset,

  				   "   State: %s
  ",
  				   dpcm_state_string(be->dpcm[stream].state));
  
  		if ((be->dpcm[stream].state >= SND_SOC_DPCM_STATE_HW_PARAMS) &&
  		    (be->dpcm[stream].state <= SND_SOC_DPCM_STATE_STOP))

  			offset += scnprintf(buf + offset, size - offset,

  					   "   Hardware Params: "
  					   "Format = %s, Channels = %d, Rate = %d
  ",
  					   snd_pcm_format_name(params_format(params)),
  					   params_channels(params),
  					   params_rate(params));
  	}
  	spin_unlock_irqrestore(&fe->card->dpcm_lock, flags);
  out:
  	return offset;
  }
  
  static ssize_t dpcm_state_read_file(struct file *file, char __user *user_buf,
  				    size_t count, loff_t *ppos)
  {
  	struct snd_soc_pcm_runtime *fe = file->private_data;
  	ssize_t out_count = PAGE_SIZE, offset = 0, ret = 0;
  	int stream;
  	char *buf;

  	if (fe->num_cpus > 1) {
  		dev_err(fe->dev,
  			"%s doesn't support Multi CPU yet
  ", __func__);
  		return -EINVAL;
  	}

  	buf = kmalloc(out_count, GFP_KERNEL);
  	if (!buf)
  		return -ENOMEM;
  
  	for_each_pcm_streams(stream)

  		if (snd_soc_dai_stream_valid(asoc_rtd_to_cpu(fe, 0), stream))

  			offset += dpcm_show_state(fe, stream,
  						  buf + offset,
  						  out_count - offset);
  
  	ret = simple_read_from_buffer(user_buf, count, ppos, buf, offset);
  
  	kfree(buf);
  	return ret;
  }
  
  static const struct file_operations dpcm_state_fops = {
  	.open = simple_open,
  	.read = dpcm_state_read_file,
  	.llseek = default_llseek,
  };
  
  void soc_dpcm_debugfs_add(struct snd_soc_pcm_runtime *rtd)
  {
  	if (!rtd->dai_link)
  		return;
  
  	if (!rtd->dai_link->dynamic)
  		return;
  
  	if (!rtd->card->debugfs_card_root)
  		return;
  
  	rtd->debugfs_dpcm_root = debugfs_create_dir(rtd->dai_link->name,
  						    rtd->card->debugfs_card_root);
  
  	debugfs_create_file("state", 0444, rtd->debugfs_dpcm_root,
  			    rtd, &dpcm_state_fops);
  }

  
  static void dpcm_create_debugfs_state(struct snd_soc_dpcm *dpcm, int stream)
  {
  	char *name;
  
  	name = kasprintf(GFP_KERNEL, "%s:%s", dpcm->be->dai_link->name,
  			 stream ? "capture" : "playback");
  	if (name) {
  		dpcm->debugfs_state = debugfs_create_dir(
  			name, dpcm->fe->debugfs_dpcm_root);
  		debugfs_create_u32("state", 0644, dpcm->debugfs_state,
  				   &dpcm->state);
  		kfree(name);
  	}
  }
  
  static void dpcm_remove_debugfs_state(struct snd_soc_dpcm *dpcm)
  {
  	debugfs_remove_recursive(dpcm->debugfs_state);
  }
  
  #else
  static inline void dpcm_create_debugfs_state(struct snd_soc_dpcm *dpcm,
  					     int stream)
  {
  }
  
  static inline void dpcm_remove_debugfs_state(struct snd_soc_dpcm *dpcm)
  {
  }

  #endif

  /**
   * snd_soc_runtime_action() - Increment/Decrement active count for
   * PCM runtime components
   * @rtd: ASoC PCM runtime that is activated
   * @stream: Direction of the PCM stream

   * @action: Activate stream if 1. Deactivate if -1.

   *
   * Increments/Decrements the active count for all the DAIs and components
   * attached to a PCM runtime.
   * Should typically be called when a stream is opened.
   *
   * Must be called with the rtd->card->pcm_mutex being held
   */
  void snd_soc_runtime_action(struct snd_soc_pcm_runtime *rtd,
  			    int stream, int action)

  {

  	struct snd_soc_dai *dai;

  	int i;

  	lockdep_assert_held(&rtd->card->pcm_mutex);

  	for_each_rtd_dais(rtd, i, dai)
  		snd_soc_dai_action(dai, stream, action);

  }

  EXPORT_SYMBOL_GPL(snd_soc_runtime_action);

  
  /**

   * snd_soc_runtime_ignore_pmdown_time() - Check whether to ignore the power down delay
   * @rtd: The ASoC PCM runtime that should be checked.
   *
   * This function checks whether the power down delay should be ignored for a
   * specific PCM runtime. Returns true if the delay is 0, if it the DAI link has
   * been configured to ignore the delay, or if none of the components benefits
   * from having the delay.
   */
  bool snd_soc_runtime_ignore_pmdown_time(struct snd_soc_pcm_runtime *rtd)
  {

  	struct snd_soc_component *component;

  	bool ignore = true;

  	int i;

  	if (!rtd->pmdown_time || rtd->dai_link->ignore_pmdown_time)
  		return true;

  	for_each_rtd_components(rtd, i, component)

  		ignore &= !component->driver->use_pmdown_time;

  	return ignore;

  }
  
  /**

   * snd_soc_set_runtime_hwparams - set the runtime hardware parameters
   * @substream: the pcm substream
   * @hw: the hardware parameters
   *
   * Sets the substream runtime hardware parameters.
   */
  int snd_soc_set_runtime_hwparams(struct snd_pcm_substream *substream,
  	const struct snd_pcm_hardware *hw)
  {
  	struct snd_pcm_runtime *runtime = substream->runtime;
  	runtime->hw.info = hw->info;
  	runtime->hw.formats = hw->formats;
  	runtime->hw.period_bytes_min = hw->period_bytes_min;
  	runtime->hw.period_bytes_max = hw->period_bytes_max;
  	runtime->hw.periods_min = hw->periods_min;
  	runtime->hw.periods_max = hw->periods_max;
  	runtime->hw.buffer_bytes_max = hw->buffer_bytes_max;
  	runtime->hw.fifo_size = hw->fifo_size;
  	return 0;
  }
  EXPORT_SYMBOL_GPL(snd_soc_set_runtime_hwparams);

  /* DPCM stream event, send event to FE and all active BEs. */

  int dpcm_dapm_stream_event(struct snd_soc_pcm_runtime *fe, int dir,

  	int event)
  {
  	struct snd_soc_dpcm *dpcm;

  	for_each_dpcm_be(fe, dir, dpcm) {

  
  		struct snd_soc_pcm_runtime *be = dpcm->be;

  		dev_dbg(be->dev, "ASoC: BE %s event %d dir %d
  ",

  				be->dai_link->name, event, dir);

  		if ((event == SND_SOC_DAPM_STREAM_STOP) &&
  		    (be->dpcm[dir].users >= 1))
  			continue;

  		snd_soc_dapm_stream_event(be, dir, event);
  	}
  
  	snd_soc_dapm_stream_event(fe, dir, event);
  
  	return 0;
  }

  static int soc_pcm_apply_symmetry(struct snd_pcm_substream *substream,
  					struct snd_soc_dai *soc_dai)

  {

  	struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);

  	int ret;

  	if (soc_dai->rate && (soc_dai->driver->symmetric_rates ||
  				rtd->dai_link->symmetric_rates)) {
  		dev_dbg(soc_dai->dev, "ASoC: Symmetry forces %dHz rate
  ",
  				soc_dai->rate);

  		ret = snd_pcm_hw_constraint_single(substream->runtime,

  						SNDRV_PCM_HW_PARAM_RATE,

  						soc_dai->rate);

  		if (ret < 0) {
  			dev_err(soc_dai->dev,
  				"ASoC: Unable to apply rate constraint: %d
  ",
  				ret);
  			return ret;
  		}
  	}

  	if (soc_dai->channels && (soc_dai->driver->symmetric_channels ||
  				rtd->dai_link->symmetric_channels)) {
  		dev_dbg(soc_dai->dev, "ASoC: Symmetry forces %d channel(s)
  ",
  				soc_dai->channels);

  		ret = snd_pcm_hw_constraint_single(substream->runtime,

  						SNDRV_PCM_HW_PARAM_CHANNELS,

  						soc_dai->channels);
  		if (ret < 0) {
  			dev_err(soc_dai->dev,
  				"ASoC: Unable to apply channel symmetry constraint: %d
  ",
  				ret);
  			return ret;
  		}

  	}

  	if (soc_dai->sample_bits && (soc_dai->driver->symmetric_samplebits ||
  				rtd->dai_link->symmetric_samplebits)) {
  		dev_dbg(soc_dai->dev, "ASoC: Symmetry forces %d sample bits
  ",
  				soc_dai->sample_bits);

  		ret = snd_pcm_hw_constraint_single(substream->runtime,

  						SNDRV_PCM_HW_PARAM_SAMPLE_BITS,

  						soc_dai->sample_bits);
  		if (ret < 0) {
  			dev_err(soc_dai->dev,
  				"ASoC: Unable to apply sample bits symmetry constraint: %d
  ",
  				ret);
  			return ret;
  		}

  	}
  
  	return 0;
  }

  static int soc_pcm_params_symmetry(struct snd_pcm_substream *substream,
  				struct snd_pcm_hw_params *params)
  {

  	struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);

  	struct snd_soc_dai *dai;

  	struct snd_soc_dai *cpu_dai;

  	unsigned int rate, channels, sample_bits, symmetry, i;

  
  	rate = params_rate(params);
  	channels = params_channels(params);
  	sample_bits = snd_pcm_format_physical_width(params_format(params));
  
  	/* reject unmatched parameters when applying symmetry */

  	symmetry = rtd->dai_link->symmetric_rates;

  	for_each_rtd_cpu_dais(rtd, i, dai)
  		symmetry |= dai->driver->symmetric_rates;

  	if (symmetry) {

  		for_each_rtd_cpu_dais(rtd, i, cpu_dai) {

  			if (cpu_dai->rate && cpu_dai->rate != rate) {
  				dev_err(rtd->dev, "ASoC: unmatched rate symmetry: %d - %d
  ",
  					cpu_dai->rate, rate);
  				return -EINVAL;
  			}
  		}

  	}

  	symmetry = rtd->dai_link->symmetric_channels;

  	for_each_rtd_dais(rtd, i, dai)
  		symmetry |= dai->driver->symmetric_channels;

  	if (symmetry) {

  		for_each_rtd_cpu_dais(rtd, i, cpu_dai) {

  			if (cpu_dai->channels &&
  			    cpu_dai->channels != channels) {
  				dev_err(rtd->dev, "ASoC: unmatched channel symmetry: %d - %d
  ",
  					cpu_dai->channels, channels);
  				return -EINVAL;
  			}
  		}

  	}

  	symmetry = rtd->dai_link->symmetric_samplebits;

  	for_each_rtd_dais(rtd, i, dai)
  		symmetry |= dai->driver->symmetric_samplebits;

  	if (symmetry) {

  		for_each_rtd_cpu_dais(rtd, i, cpu_dai) {

  			if (cpu_dai->sample_bits &&
  			    cpu_dai->sample_bits != sample_bits) {
  				dev_err(rtd->dev, "ASoC: unmatched sample bits symmetry: %d - %d
  ",
  					cpu_dai->sample_bits, sample_bits);
  				return -EINVAL;
  			}
  		}

  	}
  
  	return 0;
  }

  static bool soc_pcm_has_symmetry(struct snd_pcm_substream *substream)
  {

  	struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);

  	struct snd_soc_dai_link *link = rtd->dai_link;

  	struct snd_soc_dai *dai;

  	unsigned int symmetry, i;

  	symmetry = link->symmetric_rates ||
  		link->symmetric_channels ||
  		link->symmetric_samplebits;

  	for_each_rtd_dais(rtd, i, dai)

  		symmetry = symmetry ||

  			dai->driver->symmetric_rates ||
  			dai->driver->symmetric_channels ||
  			dai->driver->symmetric_samplebits;

  
  	return symmetry;

  }

  static void soc_pcm_set_msb(struct snd_pcm_substream *substream, int bits)

  {

  	struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);

  	int ret;

  
  	if (!bits)
  		return;

  	ret = snd_pcm_hw_constraint_msbits(substream->runtime, 0, 0, bits);
  	if (ret != 0)
  		dev_warn(rtd->dev, "ASoC: Failed to set MSB %d: %d
  ",
  				 bits, ret);

  }

  static void soc_pcm_apply_msb(struct snd_pcm_substream *substream)
  {

  	struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);

  	struct snd_soc_dai *cpu_dai;

  	struct snd_soc_dai *codec_dai;

  	struct snd_soc_pcm_stream *pcm_codec, *pcm_cpu;
  	int stream = substream->stream;

  	int i;

  	unsigned int bits = 0, cpu_bits = 0;

  	for_each_rtd_codec_dais(rtd, i, codec_dai) {

  		pcm_codec = snd_soc_dai_get_pcm_stream(codec_dai, stream);
  
  		if (pcm_codec->sig_bits == 0) {
  			bits = 0;
  			break;

  		}

  		bits = max(pcm_codec->sig_bits, bits);

  	}

  	for_each_rtd_cpu_dais(rtd, i, cpu_dai) {

  		pcm_cpu = snd_soc_dai_get_pcm_stream(cpu_dai, stream);
  
  		if (pcm_cpu->sig_bits == 0) {
  			cpu_bits = 0;
  			break;
  		}
  		cpu_bits = max(pcm_cpu->sig_bits, cpu_bits);
  	}

  	soc_pcm_set_msb(substream, bits);
  	soc_pcm_set_msb(substream, cpu_bits);

  }

  /**
   * snd_soc_runtime_calc_hw() - Calculate hw limits for a PCM stream
   * @rtd: ASoC PCM runtime
   * @hw: PCM hardware parameters (output)
   * @stream: Direction of the PCM stream
   *
   * Calculates the subset of stream parameters supported by all DAIs
   * associated with the PCM stream.
   */
  int snd_soc_runtime_calc_hw(struct snd_soc_pcm_runtime *rtd,
  			    struct snd_pcm_hardware *hw, int stream)

  {

  	struct snd_soc_dai *codec_dai;

  	struct snd_soc_dai *cpu_dai;

  	struct snd_soc_pcm_stream *codec_stream;
  	struct snd_soc_pcm_stream *cpu_stream;
  	unsigned int chan_min = 0, chan_max = UINT_MAX;

  	unsigned int cpu_chan_min = 0, cpu_chan_max = UINT_MAX;

  	unsigned int rate_min = 0, rate_max = UINT_MAX;

  	unsigned int cpu_rate_min = 0, cpu_rate_max = UINT_MAX;
  	unsigned int rates = UINT_MAX, cpu_rates = UINT_MAX;

  	u64 formats = ULLONG_MAX;
  	int i;

  	/* first calculate min/max only for CPUs in the DAI link */

  	for_each_rtd_cpu_dais(rtd, i, cpu_dai) {

  
  		/*
  		 * Skip CPUs which don't support the current stream type.
  		 * Otherwise, since the rate, channel, and format values will
  		 * zero in that case, we would have no usable settings left,
  		 * causing the resulting setup to fail.

  		 */

  		if (!snd_soc_dai_stream_valid(cpu_dai, stream))

  			continue;

  		cpu_stream = snd_soc_dai_get_pcm_stream(cpu_dai, stream);
  
  		cpu_chan_min = max(cpu_chan_min, cpu_stream->channels_min);
  		cpu_chan_max = min(cpu_chan_max, cpu_stream->channels_max);
  		cpu_rate_min = max(cpu_rate_min, cpu_stream->rate_min);
  		cpu_rate_max = min_not_zero(cpu_rate_max, cpu_stream->rate_max);
  		formats &= cpu_stream->formats;
  		cpu_rates = snd_pcm_rate_mask_intersect(cpu_stream->rates,
  							cpu_rates);
  	}

  	/* second calculate min/max only for CODECs in the DAI link */

  	for_each_rtd_codec_dais(rtd, i, codec_dai) {

  
  		/*
  		 * Skip CODECs which don't support the current stream type.
  		 * Otherwise, since the rate, channel, and format values will
  		 * zero in that case, we would have no usable settings left,
  		 * causing the resulting setup to fail.

  		 */

  		if (!snd_soc_dai_stream_valid(codec_dai, stream))

  			continue;

  		codec_stream = snd_soc_dai_get_pcm_stream(codec_dai, stream);

  		chan_min = max(chan_min, codec_stream->channels_min);
  		chan_max = min(chan_max, codec_stream->channels_max);
  		rate_min = max(rate_min, codec_stream->rate_min);
  		rate_max = min_not_zero(rate_max, codec_stream->rate_max);
  		formats &= codec_stream->formats;
  		rates = snd_pcm_rate_mask_intersect(codec_stream->rates, rates);
  	}

  	/* Verify both a valid CPU DAI and a valid CODEC DAI were found */
  	if (!chan_min || !cpu_chan_min)
  		return -EINVAL;

  	/*
  	 * chan min/max cannot be enforced if there are multiple CODEC DAIs

  	 * connected to CPU DAI(s), use CPU DAI's directly and let

  	 * channel allocation be fixed up later
  	 */
  	if (rtd->num_codecs > 1) {

  		chan_min = cpu_chan_min;
  		chan_max = cpu_chan_max;

  	}

  	/* finally find a intersection between CODECs and CPUs */
  	hw->channels_min = max(chan_min, cpu_chan_min);
  	hw->channels_max = min(chan_max, cpu_chan_max);

  	hw->formats = formats;

  	hw->rates = snd_pcm_rate_mask_intersect(rates, cpu_rates);

  	snd_pcm_hw_limit_rates(hw);

  	hw->rate_min = max(hw->rate_min, cpu_rate_min);

  	hw->rate_min = max(hw->rate_min, rate_min);

  	hw->rate_max = min_not_zero(hw->rate_max, cpu_rate_max);

  	hw->rate_max = min_not_zero(hw->rate_max, rate_max);

  
  	return 0;
  }
  EXPORT_SYMBOL_GPL(snd_soc_runtime_calc_hw);
  
  static void soc_pcm_init_runtime_hw(struct snd_pcm_substream *substream)
  {
  	struct snd_pcm_hardware *hw = &substream->runtime->hw;

  	struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);

  	u64 formats = hw->formats;
  
  	/*
  	 * At least one CPU and one CODEC should match. Otherwise, we should
  	 * have bailed out on a higher level, since there would be no CPU or
  	 * CODEC to support the transfer direction in that case.
  	 */
  	snd_soc_runtime_calc_hw(rtd, hw, substream->stream);
  
  	if (formats)
  		hw->formats &= formats;

  }

  static int soc_pcm_components_open(struct snd_pcm_substream *substream)

  {

  	struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);

  	struct snd_soc_component *component;

  	int i, ret = 0;

  	for_each_rtd_components(rtd, i, component) {

  		ret = snd_soc_component_module_get_when_open(component, substream);

  		if (ret < 0)

  			break;

  		ret = snd_soc_component_open(component, substream);

  		if (ret < 0)

  			break;

  	}

  	return ret;

  }

  static int soc_pcm_components_close(struct snd_pcm_substream *substream,
  				    int rollback)

  {

  	struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);

  	struct snd_soc_component *component;

  	int i, r, ret = 0;

  	for_each_rtd_components(rtd, i, component) {

  		r = snd_soc_component_close(component, substream, rollback);

  		if (r < 0)
  			ret = r; /* use last ret */

  		snd_soc_component_module_put_when_close(component, substream, rollback);

  	}

  	return ret;

  }

  static int soc_pcm_clean(struct snd_pcm_substream *substream, int rollback)

  {

  	struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);

  	struct snd_soc_component *component;

  	struct snd_soc_dai *dai;

  	int i;
  
  	mutex_lock_nested(&rtd->card->pcm_mutex, rtd->card->pcm_subclass);

  	if (!rollback)
  		snd_soc_runtime_deactivate(rtd, substream->stream);

  	for_each_rtd_dais(rtd, i, dai)

  		snd_soc_dai_shutdown(dai, substream, rollback);

  	snd_soc_link_shutdown(substream, rollback);

  	soc_pcm_components_close(substream, rollback);

  	if (!rollback)
  		snd_soc_dapm_stream_stop(rtd, substream->stream);

  
  	mutex_unlock(&rtd->card->pcm_mutex);

  	snd_soc_pcm_component_pm_runtime_put(rtd, substream, rollback);

  
  	for_each_rtd_components(rtd, i, component)

  		if (!snd_soc_component_active(component))

  			pinctrl_pm_select_sleep_state(component->dev);
  
  	return 0;
  }
  
  /*

   * Called by ALSA when a PCM substream is closed. Private data can be
   * freed here. The cpu DAI, codec DAI, machine and components are also
   * shutdown.
   */
  static int soc_pcm_close(struct snd_pcm_substream *substream)
  {
  	return soc_pcm_clean(substream, 0);
  }
  
  /*

   * Called by ALSA when a PCM substream is opened, the runtime->hw record is
   * then initialized and any private data can be allocated. This also calls

   * startup for the cpu DAI, component, machine and codec DAI.

   */
  static int soc_pcm_open(struct snd_pcm_substream *substream)
  {

  	struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);

  	struct snd_pcm_runtime *runtime = substream->runtime;

  	struct snd_soc_component *component;

  	struct snd_soc_dai *dai;

  	const char *codec_dai_name = "multicodec";

  	const char *cpu_dai_name = "multicpu";

  	int i, ret = 0;

  	for_each_rtd_components(rtd, i, component)
  		pinctrl_pm_select_default_state(component->dev);

  	ret = snd_soc_pcm_component_pm_runtime_get(rtd, substream);
  	if (ret < 0)

  		goto pm_err;

  	mutex_lock_nested(&rtd->card->pcm_mutex, rtd->card->pcm_subclass);

  	ret = soc_pcm_components_open(substream);
  	if (ret < 0)

  		goto err;

  	ret = snd_soc_link_startup(substream);

  	if (ret < 0)

  		goto err;

  	/* startup the audio subsystem */

  	for_each_rtd_dais(rtd, i, dai) {
  		ret = snd_soc_dai_startup(dai, substream);

  		if (ret < 0)

  			goto err;

  
  		if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK)

  			dai->tx_mask = 0;

  		else

  			dai->rx_mask = 0;

  	}

  	/* Dynamic PCM DAI links compat checks use dynamic capabilities */
  	if (rtd->dai_link->dynamic || rtd->dai_link->no_pcm)
  		goto dynamic;

  	/* Check that the codec and cpu DAIs are compatible */

  	soc_pcm_init_runtime_hw(substream);
  
  	if (rtd->num_codecs == 1)

  		codec_dai_name = asoc_rtd_to_codec(rtd, 0)->name;

  	if (rtd->num_cpus == 1)

  		cpu_dai_name = asoc_rtd_to_cpu(rtd, 0)->name;

  	if (soc_pcm_has_symmetry(substream))
  		runtime->hw.info |= SNDRV_PCM_INFO_JOINT_DUPLEX;

  	ret = -EINVAL;

  	if (!runtime->hw.rates) {

  		printk(KERN_ERR "ASoC: %s <-> %s No matching rates
  ",

  			codec_dai_name, cpu_dai_name);

  		goto err;

  	}
  	if (!runtime->hw.formats) {

  		printk(KERN_ERR "ASoC: %s <-> %s No matching formats
  ",

  			codec_dai_name, cpu_dai_name);

  		goto err;

  	}
  	if (!runtime->hw.channels_min || !runtime->hw.channels_max ||
  	    runtime->hw.channels_min > runtime->hw.channels_max) {

  		printk(KERN_ERR "ASoC: %s <-> %s No matching channels
  ",

  				codec_dai_name, cpu_dai_name);

  		goto err;

  	}

  	soc_pcm_apply_msb(substream);

  	/* Symmetry only applies if we've already got an active stream. */

  	for_each_rtd_dais(rtd, i, dai) {

  		if (snd_soc_dai_active(dai)) {

  			ret = soc_pcm_apply_symmetry(substream, dai);

  			if (ret != 0)

  				goto err;

  		}

  	}

  	pr_debug("ASoC: %s <-> %s info:
  ",

  		 codec_dai_name, cpu_dai_name);

  	pr_debug("ASoC: rate mask 0x%x
  ", runtime->hw.rates);
  	pr_debug("ASoC: min ch %d max ch %d
  ", runtime->hw.channels_min,

  		 runtime->hw.channels_max);

  	pr_debug("ASoC: min rate %d max rate %d
  ", runtime->hw.rate_min,

  		 runtime->hw.rate_max);

  dynamic:

  	snd_soc_runtime_activate(rtd, substream->stream);

  	ret = 0;

  err:

  	mutex_unlock(&rtd->card->pcm_mutex);

  pm_err:

  	if (ret < 0)
  		soc_pcm_clean(substream, 1);

  	return ret;
  }

  static void codec2codec_close_delayed_work(struct snd_soc_pcm_runtime *rtd)

  {
  	/*
  	 * Currently nothing to do for c2c links
  	 * Since c2c links are internal nodes in the DAPM graph and
  	 * don't interface with the outside world or application layer
  	 * we don't have to do any special handling on close.
  	 */
  }

  /*

   * Called by ALSA when the PCM substream is prepared, can set format, sample
   * rate, etc.  This function is non atomic and can be called multiple times,
   * it can refer to the runtime info.
   */
  static int soc_pcm_prepare(struct snd_pcm_substream *substream)
  {

  	struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);

  	struct snd_soc_dai *dai;

  	int i, ret = 0;

  	mutex_lock_nested(&rtd->card->pcm_mutex, rtd->card->pcm_subclass);

  	ret = snd_soc_link_prepare(substream);

  	if (ret < 0)

  		goto out;

  	ret = snd_soc_pcm_component_prepare(substream);
  	if (ret < 0)
  		goto out;

  	ret = snd_soc_pcm_dai_prepare(substream);
  	if (ret < 0) {
  		dev_err(rtd->dev, "ASoC: DAI prepare error: %d
  ", ret);
  		goto out;

  	}

  	/* cancel any delayed stream shutdown that is pending */
  	if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK &&

  	    rtd->pop_wait) {
  		rtd->pop_wait = 0;

  		cancel_delayed_work(&rtd->delayed_work);
  	}

  	snd_soc_dapm_stream_event(rtd, substream->stream,
  			SND_SOC_DAPM_STREAM_START);

  	for_each_rtd_dais(rtd, i, dai)
  		snd_soc_dai_digital_mute(dai, 0, substream->stream);

  
  out:

  	mutex_unlock(&rtd->card->pcm_mutex);

  	return ret;
  }

  static void soc_pcm_codec_params_fixup(struct snd_pcm_hw_params *params,
  				       unsigned int mask)
  {
  	struct snd_interval *interval;
  	int channels = hweight_long(mask);
  
  	interval = hw_param_interval(params, SNDRV_PCM_HW_PARAM_CHANNELS);
  	interval->min = channels;
  	interval->max = channels;
  }

  /*
   * Called by ALSA when the hardware params are set by application. This
   * function can also be called multiple times and can allocate buffers
   * (using snd_pcm_lib_* ). It's non-atomic.
   */
  static int soc_pcm_hw_params(struct snd_pcm_substream *substream,
  				struct snd_pcm_hw_params *params)
  {

  	struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);

  	struct snd_soc_component *component;

  	struct snd_soc_dai *cpu_dai;

  	struct snd_soc_dai *codec_dai;

  	int i, ret = 0;

  	mutex_lock_nested(&rtd->card->pcm_mutex, rtd->card->pcm_subclass);

  
  	ret = soc_pcm_params_symmetry(substream, params);
  	if (ret)
  		goto out;

  	ret = snd_soc_link_hw_params(substream, params);

  	if (ret < 0)

  		goto out;

  	for_each_rtd_codec_dais(rtd, i, codec_dai) {

  		struct snd_pcm_hw_params codec_params;

  		/*
  		 * Skip CODECs which don't support the current stream type,
  		 * the idea being that if a CODEC is not used for the currently
  		 * set up transfer direction, it should not need to be
  		 * configured, especially since the configuration used might
  		 * not even be supported by that CODEC. There may be cases
  		 * however where a CODEC needs to be set up although it is
  		 * actually not being used for the transfer, e.g. if a
  		 * capture-only CODEC is acting as an LRCLK and/or BCLK master
  		 * for the DAI link including a playback-only CODEC.
  		 * If this becomes necessary, we will have to augment the
  		 * machine driver setup with information on how to act, so
  		 * we can do the right thing here.
  		 */
  		if (!snd_soc_dai_stream_valid(codec_dai, substream->stream))
  			continue;

  		/* copy params for each codec */
  		codec_params = *params;
  
  		/* fixup params based on TDM slot masks */

  		if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK &&
  		    codec_dai->tx_mask)

  			soc_pcm_codec_params_fixup(&codec_params,
  						   codec_dai->tx_mask);

  
  		if (substream->stream == SNDRV_PCM_STREAM_CAPTURE &&
  		    codec_dai->rx_mask)

  			soc_pcm_codec_params_fixup(&codec_params,
  						   codec_dai->rx_mask);

  		ret = snd_soc_dai_hw_params(codec_dai, substream,
  					    &codec_params);

  		if(ret < 0)

  			goto codec_err;

  		codec_dai->rate = params_rate(&codec_params);
  		codec_dai->channels = params_channels(&codec_params);
  		codec_dai->sample_bits = snd_pcm_format_physical_width(
  						params_format(&codec_params));

  
  		snd_soc_dapm_update_dai(substream, &codec_params, codec_dai);

  	}

  	for_each_rtd_cpu_dais(rtd, i, cpu_dai) {

  		/*
  		 * Skip CPUs which don't support the current stream
  		 * type. See soc_pcm_init_runtime_hw() for more details
  		 */
  		if (!snd_soc_dai_stream_valid(cpu_dai, substream->stream))
  			continue;

  		ret = snd_soc_dai_hw_params(cpu_dai, substream, params);
  		if (ret < 0)
  			goto interface_err;

  		/* store the parameters for each DAI */
  		cpu_dai->rate = params_rate(params);
  		cpu_dai->channels = params_channels(params);
  		cpu_dai->sample_bits =
  			snd_pcm_format_physical_width(params_format(params));

  		snd_soc_dapm_update_dai(substream, params, cpu_dai);
  	}

  	ret = snd_soc_pcm_component_hw_params(substream, params, &component);
  	if (ret < 0)
  		goto component_err;

  out:

  	mutex_unlock(&rtd->card->pcm_mutex);

  	return ret;

  component_err:

  	snd_soc_pcm_component_hw_free(substream, component);

  	i = rtd->num_cpus;

  
  interface_err:

  	for_each_rtd_cpu_dais_rollback(rtd, i, cpu_dai) {

  		if (!snd_soc_dai_stream_valid(cpu_dai, substream->stream))
  			continue;

  		snd_soc_dai_hw_free(cpu_dai, substream);
  		cpu_dai->rate = 0;
  	}

  	i = rtd->num_codecs;

  
  codec_err:

  	for_each_rtd_codec_dais_rollback(rtd, i, codec_dai) {

  		if (!snd_soc_dai_stream_valid(codec_dai, substream->stream))
  			continue;

  		snd_soc_dai_hw_free(codec_dai, substream);

  		codec_dai->rate = 0;
  	}

  	snd_soc_link_hw_free(substream);

  	mutex_unlock(&rtd->card->pcm_mutex);

  	return ret;
  }
  
  /*
   * Frees resources allocated by hw_params, can be called multiple times
   */
  static int soc_pcm_hw_free(struct snd_pcm_substream *substream)
  {

  	struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);

  	struct snd_soc_dai *dai;

  	int i;

  	mutex_lock_nested(&rtd->card->pcm_mutex, rtd->card->pcm_subclass);

  	/* clear the corresponding DAIs parameters when going to be inactive */

  	for_each_rtd_dais(rtd, i, dai) {

  		int active = snd_soc_dai_stream_active(dai, substream->stream);

  		if (snd_soc_dai_active(dai) == 1) {

  			dai->rate = 0;
  			dai->channels = 0;
  			dai->sample_bits = 0;

  		}

  		if (active == 1)

  			snd_soc_dai_digital_mute(dai, 1, substream->stream);

  	}

  	/* free any machine hw params */

  	snd_soc_link_hw_free(substream);

  	/* free any component resources */

  	snd_soc_pcm_component_hw_free(substream, NULL);

  	/* now free hw params for the DAIs  */

  	for_each_rtd_dais(rtd, i, dai) {
  		if (!snd_soc_dai_stream_valid(dai, substream->stream))

  			continue;

  		snd_soc_dai_hw_free(dai, substream);

  	}

  	mutex_unlock(&rtd->card->pcm_mutex);

  	return 0;
  }

  static int soc_pcm_trigger(struct snd_pcm_substream *substream, int cmd)
  {

  	int ret = -EINVAL;

  
  	switch (cmd) {
  	case SNDRV_PCM_TRIGGER_START:
  	case SNDRV_PCM_TRIGGER_RESUME:
  	case SNDRV_PCM_TRIGGER_PAUSE_RELEASE:

  		ret = snd_soc_link_trigger(substream, cmd);
  		if (ret < 0)
  			break;
  
  		ret = snd_soc_pcm_component_trigger(substream, cmd);
  		if (ret < 0)
  			break;
  
  		ret = snd_soc_pcm_dai_trigger(substream, cmd);

  		break;
  	case SNDRV_PCM_TRIGGER_STOP:
  	case SNDRV_PCM_TRIGGER_SUSPEND:
  	case SNDRV_PCM_TRIGGER_PAUSE_PUSH:

  		ret = snd_soc_pcm_dai_trigger(substream, cmd);
  		if (ret < 0)
  			break;
  
  		ret = snd_soc_pcm_component_trigger(substream, cmd);
  		if (ret < 0)
  			break;
  
  		ret = snd_soc_link_trigger(substream, cmd);

  		break;

  	}
  
  	return ret;
  }

  /*
   * soc level wrapper for pointer callback

   * If cpu_dai, codec_dai, component driver has the delay callback, then

   * the runtime->delay will be updated accordingly.
   */
  static snd_pcm_uframes_t soc_pcm_pointer(struct snd_pcm_substream *substream)
  {

  	struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);

  	struct snd_soc_dai *cpu_dai;

  	struct snd_soc_dai *codec_dai;

  	struct snd_pcm_runtime *runtime = substream->runtime;
  	snd_pcm_uframes_t offset = 0;
  	snd_pcm_sframes_t delay = 0;

  	snd_pcm_sframes_t codec_delay = 0;

  	snd_pcm_sframes_t cpu_delay = 0;

  	int i;

  	/* clearing the previous total delay */
  	runtime->delay = 0;

  	offset = snd_soc_pcm_component_pointer(substream);

  	/* base delay if assigned in pointer callback */
  	delay = runtime->delay;

  	for_each_rtd_cpu_dais(rtd, i, cpu_dai) {

  		cpu_delay = max(cpu_delay,
  				snd_soc_dai_delay(cpu_dai, substream));
  	}
  	delay += cpu_delay;

  	for_each_rtd_codec_dais(rtd, i, codec_dai) {

  		codec_delay = max(codec_delay,
  				  snd_soc_dai_delay(codec_dai, substream));

  	}
  	delay += codec_delay;

  	runtime->delay = delay;
  
  	return offset;
  }

  /* connect a FE and BE */
  static int dpcm_be_connect(struct snd_soc_pcm_runtime *fe,
  		struct snd_soc_pcm_runtime *be, int stream)
  {
  	struct snd_soc_dpcm *dpcm;

  	unsigned long flags;

  
  	/* only add new dpcms */

  	for_each_dpcm_be(fe, stream, dpcm) {

  		if (dpcm->be == be && dpcm->fe == fe)
  			return 0;
  	}
  
  	dpcm = kzalloc(sizeof(struct snd_soc_dpcm), GFP_KERNEL);
  	if (!dpcm)
  		return -ENOMEM;
  
  	dpcm->be = be;
  	dpcm->fe = fe;
  	be->dpcm[stream].runtime = fe->dpcm[stream].runtime;
  	dpcm->state = SND_SOC_DPCM_LINK_STATE_NEW;

  	spin_lock_irqsave(&fe->card->dpcm_lock, flags);

  	list_add(&dpcm->list_be, &fe->dpcm[stream].be_clients);
  	list_add(&dpcm->list_fe, &be->dpcm[stream].fe_clients);

  	spin_unlock_irqrestore(&fe->card->dpcm_lock, flags);

  	dev_dbg(fe->dev, "connected new DPCM %s path %s %s %s
  ",

  			stream ? "capture" : "playback",  fe->dai_link->name,
  			stream ? "<-" : "->", be->dai_link->name);

  	dpcm_create_debugfs_state(dpcm, stream);

  	return 1;
  }
  
  /* reparent a BE onto another FE */
  static void dpcm_be_reparent(struct snd_soc_pcm_runtime *fe,
  			struct snd_soc_pcm_runtime *be, int stream)
  {
  	struct snd_soc_dpcm *dpcm;
  	struct snd_pcm_substream *fe_substream, *be_substream;
  
  	/* reparent if BE is connected to other FEs */
  	if (!be->dpcm[stream].users)
  		return;
  
  	be_substream = snd_soc_dpcm_get_substream(be, stream);

  	for_each_dpcm_fe(be, stream, dpcm) {

  		if (dpcm->fe == fe)
  			continue;

  		dev_dbg(fe->dev, "reparent %s path %s %s %s
  ",

  			stream ? "capture" : "playback",
  			dpcm->fe->dai_link->name,
  			stream ? "<-" : "->", dpcm->be->dai_link->name);
  
  		fe_substream = snd_soc_dpcm_get_substream(dpcm->fe, stream);
  		be_substream->runtime = fe_substream->runtime;
  		break;
  	}
  }
  
  /* disconnect a BE and FE */

  void dpcm_be_disconnect(struct snd_soc_pcm_runtime *fe, int stream)

  {
  	struct snd_soc_dpcm *dpcm, *d;

  	unsigned long flags;

  	for_each_dpcm_be_safe(fe, stream, dpcm, d) {

  		dev_dbg(fe->dev, "ASoC: BE %s disconnect check for %s
  ",

  				stream ? "capture" : "playback",
  				dpcm->be->dai_link->name);
  
  		if (dpcm->state != SND_SOC_DPCM_LINK_STATE_FREE)
  			continue;

  		dev_dbg(fe->dev, "freed DSP %s path %s %s %s
  ",

  			stream ? "capture" : "playback", fe->dai_link->name,
  			stream ? "<-" : "->", dpcm->be->dai_link->name);
  
  		/* BEs still alive need new FE */
  		dpcm_be_reparent(fe, dpcm->be, stream);

  		dpcm_remove_debugfs_state(dpcm);

  		spin_lock_irqsave(&fe->card->dpcm_lock, flags);

  		list_del(&dpcm->list_be);
  		list_del(&dpcm->list_fe);

  		spin_unlock_irqrestore(&fe->card->dpcm_lock, flags);

  		kfree(dpcm);
  	}
  }
  
  /* get BE for DAI widget and stream */
  static struct snd_soc_pcm_runtime *dpcm_get_be(struct snd_soc_card *card,
  		struct snd_soc_dapm_widget *widget, int stream)
  {
  	struct snd_soc_pcm_runtime *be;

  	struct snd_soc_dapm_widget *w;

  	struct snd_soc_dai *dai;

  	int i;

  	dev_dbg(card->dev, "ASoC: find BE for widget %s
  ", widget->name);

  	for_each_card_rtds(card, be) {

  		if (!be->dai_link->no_pcm)
  			continue;

  		for_each_rtd_dais(be, i, dai) {

  			w = snd_soc_dai_get_widget(dai, stream);

  			dev_dbg(card->dev, "ASoC: try BE : %s
  ",
  				w ? w->name : "(not set)");

  			if (w == widget)
  				return be;
  		}

  	}

  	return NULL;
  }

  static int widget_in_list(struct snd_soc_dapm_widget_list *list,
  		struct snd_soc_dapm_widget *widget)
  {

  	struct snd_soc_dapm_widget *w;

  	int i;

  	for_each_dapm_widgets(list, i, w)
  		if (widget == w)

  			return 1;

  
  	return 0;
  }

  static bool dpcm_end_walk_at_be(struct snd_soc_dapm_widget *widget,
  		enum snd_soc_dapm_direction dir)
  {
  	struct snd_soc_card *card = widget->dapm->card;
  	struct snd_soc_pcm_runtime *rtd;

  	int stream;

  	/* adjust dir to stream */
  	if (dir == SND_SOC_DAPM_DIR_OUT)
  		stream = SNDRV_PCM_STREAM_PLAYBACK;
  	else
  		stream = SNDRV_PCM_STREAM_CAPTURE;

  	rtd = dpcm_get_be(card, widget, stream);
  	if (rtd)
  		return true;

  
  	return false;
  }

  int dpcm_path_get(struct snd_soc_pcm_runtime *fe,

  	int stream, struct snd_soc_dapm_widget_list **list)

  {

  	struct snd_soc_dai *cpu_dai = asoc_rtd_to_cpu(fe, 0);

  	int paths;

  	if (fe->num_cpus > 1) {
  		dev_err(fe->dev,
  			"%s doesn't support Multi CPU yet
  ", __func__);
  		return -EINVAL;
  	}

  	/* get number of valid DAI paths and their widgets */

  	paths = snd_soc_dapm_dai_get_connected_widgets(cpu_dai, stream, list,

  			dpcm_end_walk_at_be);

  	dev_dbg(fe->dev, "ASoC: found %d audio %s paths
  ", paths,

  			stream ? "capture" : "playback");

  	return paths;
  }

  void dpcm_path_put(struct snd_soc_dapm_widget_list **list)
  {
  	snd_soc_dapm_dai_free_widgets(list);
  }

  static bool dpcm_be_is_active(struct snd_soc_dpcm *dpcm, int stream,
  			      struct snd_soc_dapm_widget_list *list)

  {

  	struct snd_soc_dapm_widget *widget;

  	struct snd_soc_dai *dai;

  	unsigned int i;

  	/* is there a valid DAI widget for this BE */
  	for_each_rtd_dais(dpcm->be, i, dai) {

  		widget = snd_soc_dai_get_widget(dai, stream);
  
  		/*

  		 * The BE is pruned only if none of the dai

  		 * widgets are in the active list.
  		 */
  		if (widget && widget_in_list(list, widget))
  			return true;
  	}

  	return false;
  }
  
  static int dpcm_prune_paths(struct snd_soc_pcm_runtime *fe, int stream,
  			    struct snd_soc_dapm_widget_list **list_)
  {
  	struct snd_soc_dpcm *dpcm;

  	int prune = 0;
  
  	/* Destroy any old FE <--> BE connections */

  	for_each_dpcm_be(fe, stream, dpcm) {

  		if (dpcm_be_is_active(dpcm, stream, *list_))

  			continue;

  		dev_dbg(fe->dev, "ASoC: pruning %s BE %s for %s
  ",

  			stream ? "capture" : "playback",
  			dpcm->be->dai_link->name, fe->dai_link->name);
  		dpcm->state = SND_SOC_DPCM_LINK_STATE_FREE;
  		dpcm->be->dpcm[stream].runtime_update = SND_SOC_DPCM_UPDATE_BE;
  		prune++;
  	}

  	dev_dbg(fe->dev, "ASoC: found %d old BE paths for pruning
  ", prune);

  	return prune;
  }
  
  static int dpcm_add_paths(struct snd_soc_pcm_runtime *fe, int stream,
  	struct snd_soc_dapm_widget_list **list_)
  {
  	struct snd_soc_card *card = fe->card;
  	struct snd_soc_dapm_widget_list *list = *list_;
  	struct snd_soc_pcm_runtime *be;

  	struct snd_soc_dapm_widget *widget;

  	int i, new = 0, err;
  
  	/* Create any new FE <--> BE connections */

  	for_each_dapm_widgets(list, i, widget) {

  		switch (widget->id) {

  		case snd_soc_dapm_dai_in:

  			if (stream != SNDRV_PCM_STREAM_PLAYBACK)
  				continue;
  			break;

  		case snd_soc_dapm_dai_out:

  			if (stream != SNDRV_PCM_STREAM_CAPTURE)
  				continue;

  			break;
  		default:

  			continue;

  		}

  
  		/* is there a valid BE rtd for this widget */

  		be = dpcm_get_be(card, widget, stream);

  		if (!be) {

  			dev_dbg(fe->dev, "ASoC: no BE found for %s
  ",

  					widget->name);

  			continue;
  		}

  		/* don't connect if FE is not running */

  		if (!fe->dpcm[stream].runtime && !fe->fe_compr)

  			continue;
  
  		/* newly connected FE and BE */
  		err = dpcm_be_connect(fe, be, stream);
  		if (err < 0) {

  			dev_err(fe->dev, "ASoC: can't connect %s
  ",

  				widget->name);

  			break;
  		} else if (err == 0) /* already connected */
  			continue;
  
  		/* new */
  		be->dpcm[stream].runtime_update = SND_SOC_DPCM_UPDATE_BE;
  		new++;
  	}

  	dev_dbg(fe->dev, "ASoC: found %d new BE paths
  ", new);

  	return new;
  }
  
  /*
   * Find the corresponding BE DAIs that source or sink audio to this
   * FE substream.
   */

  int dpcm_process_paths(struct snd_soc_pcm_runtime *fe,

  	int stream, struct snd_soc_dapm_widget_list **list, int new)
  {
  	if (new)
  		return dpcm_add_paths(fe, stream, list);
  	else
  		return dpcm_prune_paths(fe, stream, list);
  }

  void dpcm_clear_pending_state(struct snd_soc_pcm_runtime *fe, int stream)

  {
  	struct snd_soc_dpcm *dpcm;

  	unsigned long flags;

  	spin_lock_irqsave(&fe->card->dpcm_lock, flags);

  	for_each_dpcm_be(fe, stream, dpcm)

  		dpcm->be->dpcm[stream].runtime_update =
  						SND_SOC_DPCM_UPDATE_NO;

  	spin_unlock_irqrestore(&fe->card->dpcm_lock, flags);

  }
  
  static void dpcm_be_dai_startup_unwind(struct snd_soc_pcm_runtime *fe,
  	int stream)
  {
  	struct snd_soc_dpcm *dpcm;
  
  	/* disable any enabled and non active backends */

  	for_each_dpcm_be(fe, stream, dpcm) {

  
  		struct snd_soc_pcm_runtime *be = dpcm->be;
  		struct snd_pcm_substream *be_substream =
  			snd_soc_dpcm_get_substream(be, stream);
  
  		if (be->dpcm[stream].users == 0)

  			dev_err(be->dev, "ASoC: no users %s at close - state %d
  ",

  				stream ? "capture" : "playback",
  				be->dpcm[stream].state);
  
  		if (--be->dpcm[stream].users != 0)
  			continue;
  
  		if (be->dpcm[stream].state != SND_SOC_DPCM_STATE_OPEN)
  			continue;
  
  		soc_pcm_close(be_substream);
  		be_substream->runtime = NULL;
  		be->dpcm[stream].state = SND_SOC_DPCM_STATE_CLOSE;
  	}
  }

  int dpcm_be_dai_startup(struct snd_soc_pcm_runtime *fe, int stream)

  {
  	struct snd_soc_dpcm *dpcm;
  	int err, count = 0;
  
  	/* only startup BE DAIs that are either sinks or sources to this FE DAI */

  	for_each_dpcm_be(fe, stream, dpcm) {

  
  		struct snd_soc_pcm_runtime *be = dpcm->be;
  		struct snd_pcm_substream *be_substream =
  			snd_soc_dpcm_get_substream(be, stream);

  		if (!be_substream) {
  			dev_err(be->dev, "ASoC: no backend %s stream
  ",
  				stream ? "capture" : "playback");
  			continue;
  		}

  		/* is this op for this BE ? */
  		if (!snd_soc_dpcm_be_can_update(fe, be, stream))
  			continue;
  
  		/* first time the dpcm is open ? */
  		if (be->dpcm[stream].users == DPCM_MAX_BE_USERS)

  			dev_err(be->dev, "ASoC: too many users %s at open %d
  ",

  				stream ? "capture" : "playback",
  				be->dpcm[stream].state);
  
  		if (be->dpcm[stream].users++ != 0)
  			continue;
  
  		if ((be->dpcm[stream].state != SND_SOC_DPCM_STATE_NEW) &&
  		    (be->dpcm[stream].state != SND_SOC_DPCM_STATE_CLOSE))
  			continue;

  		dev_dbg(be->dev, "ASoC: open %s BE %s
  ",
  			stream ? "capture" : "playback", be->dai_link->name);

  
  		be_substream->runtime = be->dpcm[stream].runtime;
  		err = soc_pcm_open(be_substream);
  		if (err < 0) {

  			dev_err(be->dev, "ASoC: BE open failed %d
  ", err);

  			be->dpcm[stream].users--;
  			if (be->dpcm[stream].users < 0)

  				dev_err(be->dev, "ASoC: no users %s at unwind %d
  ",

  					stream ? "capture" : "playback",
  					be->dpcm[stream].state);
  
  			be->dpcm[stream].state = SND_SOC_DPCM_STATE_CLOSE;
  			goto unwind;
  		}
  
  		be->dpcm[stream].state = SND_SOC_DPCM_STATE_OPEN;
  		count++;
  	}
  
  	return count;
  
  unwind:
  	/* disable any enabled and non active backends */

  	for_each_dpcm_be_rollback(fe, stream, dpcm) {

  		struct snd_soc_pcm_runtime *be = dpcm->be;
  		struct snd_pcm_substream *be_substream =
  			snd_soc_dpcm_get_substream(be, stream);
  
  		if (!snd_soc_dpcm_be_can_update(fe, be, stream))
  			continue;
  
  		if (be->dpcm[stream].users == 0)

  			dev_err(be->dev, "ASoC: no users %s at close %d
  ",

  				stream ? "capture" : "playback",
  				be->dpcm[stream].state);
  
  		if (--be->dpcm[stream].users != 0)
  			continue;
  
  		if (be->dpcm[stream].state != SND_SOC_DPCM_STATE_OPEN)
  			continue;
  
  		soc_pcm_close(be_substream);
  		be_substream->runtime = NULL;
  		be->dpcm[stream].state = SND_SOC_DPCM_STATE_CLOSE;
  	}
  
  	return err;
  }

  static void dpcm_init_runtime_hw(struct snd_pcm_runtime *runtime,

  				 struct snd_soc_pcm_stream *stream)

  {
  	runtime->hw.rate_min = stream->rate_min;

  	runtime->hw.rate_max = min_not_zero(stream->rate_max, UINT_MAX);

  	runtime->hw.channels_min = stream->channels_min;
  	runtime->hw.channels_max = stream->channels_max;

  	if (runtime->hw.formats)

  		runtime->hw.formats &= stream->formats;

  	else

  		runtime->hw.formats = stream->formats;

  	runtime->hw.rates = stream->rates;
  }

  static void dpcm_runtime_merge_format(struct snd_pcm_substream *substream,
  				      u64 *formats)

  {

  	struct snd_soc_pcm_runtime *fe = asoc_substream_to_rtd(substream);

  	struct snd_soc_dpcm *dpcm;

  	struct snd_soc_dai *dai;

  	int stream = substream->stream;
  
  	if (!fe->dai_link->dpcm_merged_format)

  		return;

  
  	/*
  	 * It returns merged BE codec format
  	 * if FE want to use it (= dpcm_merged_format)
  	 */

  	for_each_dpcm_be(fe, stream, dpcm) {

  		struct snd_soc_pcm_runtime *be = dpcm->be;

  		struct snd_soc_pcm_stream *codec_stream;
  		int i;

  		for_each_rtd_codec_dais(be, i, dai) {

  			/*
  			 * Skip CODECs which don't support the current stream
  			 * type. See soc_pcm_init_runtime_hw() for more details
  			 */