xref: /linux/sound/core/pcm_local.h (revision 24bce201d79807b668bf9d9e0aca801c5c0d5f78)
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 */
84