sound/usb/endpoint.h

0001 /* SPDX-License-Identifier: GPL-2.0 */
0002 #ifndef __USBAUDIO_ENDPOINT_H
0003 #define __USBAUDIO_ENDPOINT_H
0004
0005 #define SND_USB_ENDPOINT_TYPE_DATA     0
0006 #define SND_USB_ENDPOINT_TYPE_SYNC     1
0007
0008 struct snd_usb_endpoint *snd_usb_get_endpoint(struct snd_usb_audio *chip,
0009                           int ep_num);
0010
0011 int snd_usb_add_endpoint(struct snd_usb_audio *chip, int ep_num, int type);
0012
0013 struct snd_usb_endpoint *
0014 snd_usb_endpoint_open(struct snd_usb_audio *chip,
0015               const struct audioformat *fp,
0016               const struct snd_pcm_hw_params *params,
0017               bool is_sync_ep);
0018 void snd_usb_endpoint_close(struct snd_usb_audio *chip,
0019                 struct snd_usb_endpoint *ep);
0020 int snd_usb_endpoint_configure(struct snd_usb_audio *chip,
0021                    struct snd_usb_endpoint *ep);
0022 int snd_usb_endpoint_get_clock_rate(struct snd_usb_audio *chip, int clock);
0023
0024 bool snd_usb_endpoint_compatible(struct snd_usb_audio *chip,
0025                  struct snd_usb_endpoint *ep,
0026                  const struct audioformat *fp,
0027                  const struct snd_pcm_hw_params *params);
0028
0029 void snd_usb_endpoint_set_sync(struct snd_usb_audio *chip,
0030                    struct snd_usb_endpoint *data_ep,
0031                    struct snd_usb_endpoint *sync_ep);
0032 void snd_usb_endpoint_set_callback(struct snd_usb_endpoint *ep,
0033                    int (*prepare)(struct snd_usb_substream *subs,
0034                           struct urb *urb,
0035                           bool in_stream_lock),
0036                    void (*retire)(struct snd_usb_substream *subs,
0037                           struct urb *urb),
0038                    struct snd_usb_substream *data_subs);
0039
0040 int snd_usb_endpoint_start(struct snd_usb_endpoint *ep);
0041 void snd_usb_endpoint_stop(struct snd_usb_endpoint *ep, bool keep_pending);
0042 void snd_usb_endpoint_sync_pending_stop(struct snd_usb_endpoint *ep);
0043 void snd_usb_endpoint_suspend(struct snd_usb_endpoint *ep);
0044 int  snd_usb_endpoint_activate(struct snd_usb_endpoint *ep);
0045 void snd_usb_endpoint_release(struct snd_usb_endpoint *ep);
0046 void snd_usb_endpoint_free_all(struct snd_usb_audio *chip);
0047
0048 int snd_usb_endpoint_implicit_feedback_sink(struct snd_usb_endpoint *ep);
0049 int snd_usb_endpoint_next_packet_size(struct snd_usb_endpoint *ep,
0050                       struct snd_urb_ctx *ctx, int idx,
0051                       unsigned int avail);
0052 void snd_usb_queue_pending_output_urbs(struct snd_usb_endpoint *ep,
0053                        bool in_stream_lock);
0054
0055 #endif /* __USBAUDIO_ENDPOINT_H */