xref: /openbmc/linux/sound/usb/endpoint.h (revision c900529f3d9161bfde5cca0754f83b4d3c3e0220)
1  /* SPDX-License-Identifier: GPL-2.0 */
2  #ifndef __USBAUDIO_ENDPOINT_H
3  #define __USBAUDIO_ENDPOINT_H
4  
5  #define SND_USB_ENDPOINT_TYPE_DATA     0
6  #define SND_USB_ENDPOINT_TYPE_SYNC     1
7  
8  struct snd_usb_endpoint *snd_usb_get_endpoint(struct snd_usb_audio *chip,
9  					      int ep_num);
10  
11  int snd_usb_add_endpoint(struct snd_usb_audio *chip, int ep_num, int type);
12  
13  struct snd_usb_endpoint *
14  snd_usb_endpoint_open(struct snd_usb_audio *chip,
15  		      const struct audioformat *fp,
16  		      const struct snd_pcm_hw_params *params,
17  		      bool is_sync_ep,
18  		      bool fixed_rate);
19  void snd_usb_endpoint_close(struct snd_usb_audio *chip,
20  			    struct snd_usb_endpoint *ep);
21  int snd_usb_endpoint_set_params(struct snd_usb_audio *chip,
22  				struct snd_usb_endpoint *ep);
23  int snd_usb_endpoint_prepare(struct snd_usb_audio *chip,
24  			     struct snd_usb_endpoint *ep);
25  int snd_usb_endpoint_get_clock_rate(struct snd_usb_audio *chip, int clock);
26  
27  bool snd_usb_endpoint_compatible(struct snd_usb_audio *chip,
28  				 struct snd_usb_endpoint *ep,
29  				 const struct audioformat *fp,
30  				 const struct snd_pcm_hw_params *params);
31  
32  void snd_usb_endpoint_set_sync(struct snd_usb_audio *chip,
33  			       struct snd_usb_endpoint *data_ep,
34  			       struct snd_usb_endpoint *sync_ep);
35  void snd_usb_endpoint_set_callback(struct snd_usb_endpoint *ep,
36  				   int (*prepare)(struct snd_usb_substream *subs,
37  						  struct urb *urb,
38  						  bool in_stream_lock),
39  				   void (*retire)(struct snd_usb_substream *subs,
40  						  struct urb *urb),
41  				   struct snd_usb_substream *data_subs);
42  
43  int snd_usb_endpoint_start(struct snd_usb_endpoint *ep);
44  void snd_usb_endpoint_stop(struct snd_usb_endpoint *ep, bool keep_pending);
45  void snd_usb_endpoint_sync_pending_stop(struct snd_usb_endpoint *ep);
46  void snd_usb_endpoint_suspend(struct snd_usb_endpoint *ep);
47  void snd_usb_endpoint_release(struct snd_usb_endpoint *ep);
48  void snd_usb_endpoint_free_all(struct snd_usb_audio *chip);
49  
50  int snd_usb_endpoint_implicit_feedback_sink(struct snd_usb_endpoint *ep);
51  int snd_usb_endpoint_next_packet_size(struct snd_usb_endpoint *ep,
52  				      struct snd_urb_ctx *ctx, int idx,
53  				      unsigned int avail);
54  int snd_usb_queue_pending_output_urbs(struct snd_usb_endpoint *ep,
55  				      bool in_stream_lock);
56  
57  #endif /* __USBAUDIO_ENDPOINT_H */
58