xref: /linux/sound/usb/endpoint.h (revision 4317892db474ddcf0f9d4a9bca8e0d2ddb1d0ab9)
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_configure(struct snd_usb_audio *chip,
21 			       struct snd_usb_endpoint *ep);
22 int snd_usb_endpoint_get_clock_rate(struct snd_usb_audio *chip, int clock);
23 
24 bool snd_usb_endpoint_compatible(struct snd_usb_audio *chip,
25 				 struct snd_usb_endpoint *ep,
26 				 const struct audioformat *fp,
27 				 const struct snd_pcm_hw_params *params);
28 
29 void snd_usb_endpoint_set_sync(struct snd_usb_audio *chip,
30 			       struct snd_usb_endpoint *data_ep,
31 			       struct snd_usb_endpoint *sync_ep);
32 void snd_usb_endpoint_set_callback(struct snd_usb_endpoint *ep,
33 				   int (*prepare)(struct snd_usb_substream *subs,
34 						  struct urb *urb,
35 						  bool in_stream_lock),
36 				   void (*retire)(struct snd_usb_substream *subs,
37 						  struct urb *urb),
38 				   struct snd_usb_substream *data_subs);
39 
40 int snd_usb_endpoint_start(struct snd_usb_endpoint *ep);
41 void snd_usb_endpoint_stop(struct snd_usb_endpoint *ep, bool keep_pending);
42 void snd_usb_endpoint_sync_pending_stop(struct snd_usb_endpoint *ep);
43 void snd_usb_endpoint_suspend(struct snd_usb_endpoint *ep);
44 int  snd_usb_endpoint_activate(struct snd_usb_endpoint *ep);
45 void snd_usb_endpoint_release(struct snd_usb_endpoint *ep);
46 void snd_usb_endpoint_free_all(struct snd_usb_audio *chip);
47 
48 int snd_usb_endpoint_implicit_feedback_sink(struct snd_usb_endpoint *ep);
49 int snd_usb_endpoint_next_packet_size(struct snd_usb_endpoint *ep,
50 				      struct snd_urb_ctx *ctx, int idx,
51 				      unsigned int avail);
52 void snd_usb_queue_pending_output_urbs(struct snd_usb_endpoint *ep,
53 				       bool in_stream_lock);
54 
55 #endif /* __USBAUDIO_ENDPOINT_H */
56