xref: /openbmc/linux/sound/usb/endpoint.h (revision ca637c0e)
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 void snd_usb_endpoint_close(struct snd_usb_audio *chip,
19 			    struct snd_usb_endpoint *ep);
20 int snd_usb_endpoint_set_params(struct snd_usb_audio *chip,
21 				struct snd_usb_endpoint *ep);
22 int snd_usb_endpoint_prepare(struct snd_usb_audio *chip,
23 			     struct snd_usb_endpoint *ep);
24 int snd_usb_endpoint_get_clock_rate(struct snd_usb_audio *chip, int clock);
25 
26 bool snd_usb_endpoint_compatible(struct snd_usb_audio *chip,
27 				 struct snd_usb_endpoint *ep,
28 				 const struct audioformat *fp,
29 				 const struct snd_pcm_hw_params *params);
30 
31 void snd_usb_endpoint_set_sync(struct snd_usb_audio *chip,
32 			       struct snd_usb_endpoint *data_ep,
33 			       struct snd_usb_endpoint *sync_ep);
34 void snd_usb_endpoint_set_callback(struct snd_usb_endpoint *ep,
35 				   int (*prepare)(struct snd_usb_substream *subs,
36 						  struct urb *urb,
37 						  bool in_stream_lock),
38 				   void (*retire)(struct snd_usb_substream *subs,
39 						  struct urb *urb),
40 				   struct snd_usb_substream *data_subs);
41 
42 int snd_usb_endpoint_start(struct snd_usb_endpoint *ep);
43 void snd_usb_endpoint_stop(struct snd_usb_endpoint *ep, bool keep_pending);
44 void snd_usb_endpoint_sync_pending_stop(struct snd_usb_endpoint *ep);
45 void snd_usb_endpoint_suspend(struct snd_usb_endpoint *ep);
46 int  snd_usb_endpoint_activate(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 void snd_usb_queue_pending_output_urbs(struct snd_usb_endpoint *ep,
55 				       bool in_stream_lock);
56 
57 #endif /* __USBAUDIO_ENDPOINT_H */
58