linux/Documentation/usb
Ruslan Bilovol 0591bc2360 usb: gadget: add f_uac1 variant based on a new u_audio api
This patch adds a new function 'f_uac1'
(f_uac1 with virtual "ALSA card") that
uses recently created u_audio API. Comparing
to legacy f_uac1 function implementation it
doesn't require any real Audio codec to be
present on the device. In f_uac1 audio
streams are simply sinked to and sourced
from a virtual ALSA sound card created
using u_audio API.

Legacy f_uac1 approach is to write audio
samples directly to existing ALSA sound
card

f_uac1 approach is more generic/flexible
one - create an ALSA sound card that
represents USB Audio function and allows to
be used by userspace application that
may choose to do whatever it wants with the
data received from the USB Host and choose
to provide whatever it wants as audio data
to the USB Host.

f_uac1 also has capture support (gadget->host)
thanks to easy implementation via u_audio.
By default, capture interface has 48000kHz/2ch
configuration, same as playback channel has.

f_uac1 descriptors naming convention
uses f_uac2 driver naming convention that
makes it more common and meaningful.

Comparing to f_uac1_legacy, the f_uac1 doesn't
have volume/mute functionality. This is because
the f_uac1 volume/mute feature unit was dummy
implementation since that driver creation (2009)
and never had any real volume control or mute
functionality, so there is no any difference
here.

Since f_uac1 functionality, exposed
interface to userspace (virtual ALSA card),
input parameters are so different comparing
to f_uac1_legacy, that there is no any
reason to keep them in the same file/module,
and separate function was created.

g_audio can be built using one of existing
UAC functions (f_uac1, f_uac1_legacy or f_uac2)

Signed-off-by: Ruslan Bilovol <ruslan.bilovol@gmail.com>
Signed-off-by: Felipe Balbi <felipe.balbi@linux.intel.com>
2017-06-19 09:22:47 +03:00
..
acm.txt docs-rst: usb: update old usbfs-related documentation 2017-04-20 15:30:33 -06:00
authorization.txt usb: interface authorization: Documentation part 2015-09-22 12:08:40 -07:00
chipidea.txt doc: usb: chipidea: update the doc for OTG FSM 2016-05-04 13:40:31 +08:00
CREDITS
dwc3.txt
ehci.txt
functionfs.txt FunctionFS: enable multiple functions 2012-05-14 09:25:44 -07:00
gadget_configfs.txt gadget_configfs.txt: fix spelling of 'function' 2014-10-29 14:30:15 +01:00
gadget_hid.txt usb: gadget: hid: add configfs support 2014-11-06 16:18:19 -06:00
gadget_multi.txt Documentation: tiny typo fix in usb/gadget_multi.txt 2016-06-23 08:09:10 -06:00
gadget_printer.txt
gadget_serial.txt docs-rst: usb: update old usbfs-related documentation 2017-04-20 15:30:33 -06:00
gadget-testing.txt usb: gadget: add f_uac1 variant based on a new u_audio api 2017-06-19 09:22:47 +03:00
iuu_phoenix.txt
linux-cdc-acm.inf
linux.inf
mass-storage.txt doc: spelling error changes 2014-05-05 15:32:05 +02:00
misc_usbsevseg.txt
mtouchusb.txt
ohci.txt
rio.txt
usb-help.txt
usb-serial.txt Documentation usb serial: fixed how to provide vendor and product id 2015-05-07 09:44:04 -06:00
usbdevfs-drop-permissions.c usb: devio: Add ioctl to disallow detaching kernel USB drivers. 2016-03-05 12:05:01 -08:00
usbip_protocol.txt usbip: move usbip_protocol.txt to Documentation 2016-03-03 19:44:06 -08:00
usbmon.txt doc: usbmon: fix spelling s/unpriviledged/unprivileged/ 2015-01-09 12:25:54 -08:00
wusb-cbaf
WUSB-Design-overview.txt usb: hub: rename khubd to hub_wq in documentation and comments 2014-09-23 22:33:19 -07:00