xref: /linux/sound/usb/endpoint.h (revision 4b132aacb0768ac1e652cf517097ea6f237214b9)
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