sound/core/pcm_local.h

   1 /* SPDX-License-Identifier: GPL-2.0-only */
   2 /*
   3  * pcm_local.h - a local header file for snd-pcm module.
   4  *
   5  * Copyright (c) Takashi Sakamoto <o-takashi@sakamocchi.jp>
   6  */
   7
   8 #ifndef __SOUND_CORE_PCM_LOCAL_H
   9 #define __SOUND_CORE_PCM_LOCAL_H
  10
  11 extern const struct snd_pcm_hw_constraint_list snd_pcm_known_rates;
  12
  13 void snd_interval_mul(const struct snd_interval *a,
  14                       const struct snd_interval *b, struct snd_interval *c);
  15 void snd_interval_div(const struct snd_interval *a,
  16                       const struct snd_interval *b, struct snd_interval *c);
  17 void snd_interval_muldivk(const struct snd_interval *a,
  18                           const struct snd_interval *b,
  19                           unsigned int k, struct snd_interval *c);
  20 void snd_interval_mulkdiv(const struct snd_interval *a, unsigned int k,
  21                           const struct snd_interval *b, struct snd_interval *c);
  22
  23 int snd_pcm_hw_constraint_mask(struct snd_pcm_runtime *runtime,
  24                                snd_pcm_hw_param_t var, u_int32_t mask);
  25
  26 int pcm_lib_apply_appl_ptr(struct snd_pcm_substream *substream,
  27                            snd_pcm_uframes_t appl_ptr);
  28 int snd_pcm_update_state(struct snd_pcm_substream *substream,
  29                          struct snd_pcm_runtime *runtime);
  30 int snd_pcm_update_hw_ptr(struct snd_pcm_substream *substream);
  31
  32 void snd_pcm_playback_silence(struct snd_pcm_substream *substream,
  33                               snd_pcm_uframes_t new_hw_ptr);
  34
  35 static inline snd_pcm_uframes_t
  36 snd_pcm_avail(struct snd_pcm_substream *substream)
  37 {
  38         if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK)
  39                 return snd_pcm_playback_avail(substream->runtime);
  40         else
  41                 return snd_pcm_capture_avail(substream->runtime);
  42 }
  43
  44 static inline snd_pcm_uframes_t
  45 snd_pcm_hw_avail(struct snd_pcm_substream *substream)
  46 {
  47         if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK)
  48                 return snd_pcm_playback_hw_avail(substream->runtime);
  49         else
  50                 return snd_pcm_capture_hw_avail(substream->runtime);
  51 }
  52
  53 #ifdef CONFIG_SND_PCM_TIMER
  54 void snd_pcm_timer_resolution_change(struct snd_pcm_substream *substream);
  55 void snd_pcm_timer_init(struct snd_pcm_substream *substream);
  56 void snd_pcm_timer_done(struct snd_pcm_substream *substream);
  57 #else
  58 static inline void
  59 snd_pcm_timer_resolution_change(struct snd_pcm_substream *substream) {}
  60 static inline void snd_pcm_timer_init(struct snd_pcm_substream *substream) {}
  61 static inline void snd_pcm_timer_done(struct snd_pcm_substream *substream) {}
  62 #endif
  63
  64 void __snd_pcm_xrun(struct snd_pcm_substream *substream);
  65 void snd_pcm_group_init(struct snd_pcm_group *group);
  66 void snd_pcm_sync_stop(struct snd_pcm_substream *substream, bool sync_irq);
  67
  68 #define PCM_RUNTIME_CHECK(sub) snd_BUG_ON(!(sub) || !(sub)->runtime)
  69
  70 /* loop over all PCM substreams */
  71 #define for_each_pcm_substream(pcm, str, subs) \
  72         for ((str) = 0; (str) < 2; (str)++) \
  73                 for ((subs) = (pcm)->streams[str].substream; (subs); \
  74                      (subs) = (subs)->next)
  75
  76 static inline void snd_pcm_dma_buffer_sync(struct snd_pcm_substream *substream,
  77                                            enum snd_dma_sync_mode mode)
  78 {
  79         if (substream->runtime->info & SNDRV_PCM_INFO_EXPLICIT_SYNC)
  80                 snd_dma_buffer_sync(snd_pcm_get_dma_buf(substream), mode);
  81 }
  82
  83 #endif  /* __SOUND_CORE_PCM_LOCAL_H */