xref: /linux/sound/core/pcm_local.h (revision 9a6b55ac)
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_constraints_init(struct snd_pcm_substream *substream);
24 int snd_pcm_hw_constraints_complete(struct snd_pcm_substream *substream);
25 
26 int snd_pcm_hw_constraint_mask(struct snd_pcm_runtime *runtime,
27 			       snd_pcm_hw_param_t var, u_int32_t mask);
28 
29 int pcm_lib_apply_appl_ptr(struct snd_pcm_substream *substream,
30 			   snd_pcm_uframes_t appl_ptr);
31 int snd_pcm_update_state(struct snd_pcm_substream *substream,
32 			 struct snd_pcm_runtime *runtime);
33 int snd_pcm_update_hw_ptr(struct snd_pcm_substream *substream);
34 
35 void snd_pcm_playback_silence(struct snd_pcm_substream *substream,
36 			      snd_pcm_uframes_t new_hw_ptr);
37 
38 static inline snd_pcm_uframes_t
39 snd_pcm_avail(struct snd_pcm_substream *substream)
40 {
41 	if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK)
42 		return snd_pcm_playback_avail(substream->runtime);
43 	else
44 		return snd_pcm_capture_avail(substream->runtime);
45 }
46 
47 static inline snd_pcm_uframes_t
48 snd_pcm_hw_avail(struct snd_pcm_substream *substream)
49 {
50 	if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK)
51 		return snd_pcm_playback_hw_avail(substream->runtime);
52 	else
53 		return snd_pcm_capture_hw_avail(substream->runtime);
54 }
55 
56 #ifdef CONFIG_SND_PCM_TIMER
57 void snd_pcm_timer_resolution_change(struct snd_pcm_substream *substream);
58 void snd_pcm_timer_init(struct snd_pcm_substream *substream);
59 void snd_pcm_timer_done(struct snd_pcm_substream *substream);
60 #else
61 static inline void
62 snd_pcm_timer_resolution_change(struct snd_pcm_substream *substream) {}
63 static inline void snd_pcm_timer_init(struct snd_pcm_substream *substream) {}
64 static inline void snd_pcm_timer_done(struct snd_pcm_substream *substream) {}
65 #endif
66 
67 void __snd_pcm_xrun(struct snd_pcm_substream *substream);
68 void snd_pcm_group_init(struct snd_pcm_group *group);
69 
70 #ifdef CONFIG_SND_DMA_SGBUF
71 struct page *snd_pcm_sgbuf_ops_page(struct snd_pcm_substream *substream,
72 				    unsigned long offset);
73 #endif
74 
75 #define PCM_RUNTIME_CHECK(sub) snd_BUG_ON(!(sub) || !(sub)->runtime)
76 
77 #endif	/* __SOUND_CORE_PCM_LOCAL_H */
78