2014-12-10 12:34:02 +01:00
What: /config/usb-gadget/gadget/functions/uvc.name
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: UVC function directory
2020-10-30 08:40:39 +01:00
=================== =============================
streaming_maxburst 0..15 (ss only)
streaming_maxpacket 1..1023 (fs), 1..3072 (hs/ss)
streaming_interval 1..16
2022-04-01 11:04:45 -05:00
function_name string [32]
2020-10-30 08:40:39 +01:00
=================== =============================
2014-12-10 12:34:02 +01:00
What: /config/usb-gadget/gadget/functions/uvc.name/control
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Control descriptors
2023-01-30 10:50:44 +00:00
All attributes read only except enable_interrupt_ep:
2020-10-30 08:40:39 +01:00
2023-02-06 15:11:31 +00:00
=================== =============================
2020-10-30 08:40:39 +01:00
bInterfaceNumber USB interface number for this
streaming interface
2023-01-30 10:50:44 +00:00
enable_interrupt_ep flag to enable the interrupt
endpoint for the VC interface
2023-02-06 15:11:31 +00:00
=================== =============================
2018-05-23 18:47:56 +03:00
2014-12-10 12:34:02 +01:00
What: /config/usb-gadget/gadget/functions/uvc.name/control/class
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Class descriptors
What: /config/usb-gadget/gadget/functions/uvc.name/control/class/ss
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Super speed control class descriptors
What: /config/usb-gadget/gadget/functions/uvc.name/control/class/fs
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Full speed control class descriptors
What: /config/usb-gadget/gadget/functions/uvc.name/control/terminal
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Terminal descriptors
What: /config/usb-gadget/gadget/functions/uvc.name/control/terminal/output
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Output terminal descriptors
What: /config/usb-gadget/gadget/functions/uvc.name/control/terminal/output/default
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Default output terminal descriptors
2023-02-06 16:17:52 +00:00
All attributes read only except bSourceID:
2020-10-30 08:40:39 +01:00
============== =============================================
iTerminal index of string descriptor
2020-10-30 08:40:50 +01:00
bSourceID id of the terminal to which this terminal
2014-12-10 12:34:02 +01:00
is connected
2020-10-30 08:40:39 +01:00
bAssocTerminal id of the input terminal to which this output
2014-12-10 12:34:02 +01:00
terminal is associated
2020-10-30 08:40:39 +01:00
wTerminalType terminal type
bTerminalID a non-zero id of this terminal
============== =============================================
2014-12-10 12:34:02 +01:00
What: /config/usb-gadget/gadget/functions/uvc.name/control/terminal/camera
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Camera terminal descriptors
What: /config/usb-gadget/gadget/functions/uvc.name/control/terminal/camera/default
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Default camera terminal descriptors
2023-03-09 10:58:25 +00:00
All attributes read only except bmControls, which is read/write:
2020-10-30 08:40:39 +01:00
======================== ====================================
bmControls bitmap specifying which controls are
supported for the video stream
wOcularFocalLength the value of Locular
wObjectiveFocalLengthMax the value of Lmin
wObjectiveFocalLengthMin the value of Lmax
iTerminal index of string descriptor
bAssocTerminal id of the output terminal to which
this terminal is connected
wTerminalType terminal type
bTerminalID a non-zero id of this terminal
======================== ====================================
2014-12-10 12:34:02 +01:00
What: /config/usb-gadget/gadget/functions/uvc.name/control/processing
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Processing unit descriptors
What: /config/usb-gadget/gadget/functions/uvc.name/control/processing/default
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Default processing unit descriptors
2023-03-09 10:58:25 +00:00
All attributes read only except bmControls, which is read/write:
2020-10-30 08:40:39 +01:00
=============== ========================================
iProcessing index of string descriptor
bmControls bitmap specifying which controls are
2014-12-10 12:34:02 +01:00
supported for the video stream
2020-10-30 08:40:39 +01:00
wMaxMultiplier maximum digital magnification x100
bSourceID id of the terminal to which this unit is
2014-12-10 12:34:02 +01:00
connected
2020-10-30 08:40:39 +01:00
bUnitID a non-zero id of this unit
=============== ========================================
2014-12-10 12:34:02 +01:00
2023-02-06 16:17:54 +00:00
What: /config/usb-gadget/gadget/functions/uvc.name/control/extensions
Date: Nov 2022
KernelVersion: 6.1
Description: Extension unit descriptors
What: /config/usb-gadget/gadget/functions/uvc.name/control/extensions/name
Date: Nov 2022
KernelVersion: 6.1
Description: Extension Unit (XU) Descriptor
bLength, bUnitID and iExtension are read-only. All others are
read-write.
================= ========================================
bLength size of the descriptor in bytes
bUnitID non-zero ID of this unit
guidExtensionCode Vendor-specific code identifying the XU
bNumControls number of controls in this XU
bNrInPins number of input pins for this unit
baSourceID list of the IDs of the units or terminals
to which this XU is connected
bControlSize size of the bmControls field in bytes
bmControls list of bitmaps detailing which vendor
specific controls are supported
iExtension index of a string descriptor that describes
this extension unit
================= ========================================
2014-12-10 12:34:02 +01:00
What: /config/usb-gadget/gadget/functions/uvc.name/control/header
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Control header descriptors
What: /config/usb-gadget/gadget/functions/uvc.name/control/header/name
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Specific control header descriptors
dwClockFrequency
bcdUVC
What: /config/usb-gadget/gadget/functions/uvc.name/streaming
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Streaming descriptors
2018-05-23 18:47:56 +03:00
All attributes read only:
2020-10-30 08:40:39 +01:00
================ =============================
bInterfaceNumber USB interface number for this
streaming interface
================ =============================
2018-05-23 18:47:56 +03:00
2014-12-10 12:34:02 +01:00
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/class
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Streaming class descriptors
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/class/ss
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Super speed streaming class descriptors
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/class/hs
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: High speed streaming class descriptors
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/class/fs
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Full speed streaming class descriptors
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/color_matching
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Color matching descriptors
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/color_matching/default
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Default color matching descriptors
2023-02-02 11:41:41 +00:00
All attributes read/write:
2020-10-30 08:40:39 +01:00
======================== ======================================
bMatrixCoefficients matrix used to compute luma and
chroma values from the color primaries
bTransferCharacteristics optoelectronic transfer
docs: typo fixes in Documentation/ABI/
Fix the following typos in the Documentation/ABI/ directory:
- In file obsolete/sysfs-cpuidle, change "obselete" for "obsolete".
- In file removed/sysfs-kernel-uids, change "propotional" for "proportional".
- In directory stable/, fix the following words: "associtated" for "associated",
"hexidecimal" for "hexadecimal", "vlue" for "value", "csed" for "caused" and
"wrtie" for "write". This updates a total of five files.
- In directory testing/, fix the following words: "subystem" for "subsystem",
"isochrnous" for "isochronous", "Desctiptors" for "Descriptors", "picutre" for
"picture", "capture" for "capture", "occured" for "ocurred", "connnected" for
"connected","agressively" for "aggressively","manufacturee" for "manufacturer"
and "transaction" for "transaction", "malformatted" for "incorrectly formated"
,"internel" for "internal", "writtento" for "written to", "specificed" for
"specified", "beyound" for "beyond", "Symetric" for "Symmetric". This updates
a total of eleven files.
Signed-off-by: Carlos Bilbao <bilbao@vt.edu>
Reviewed-by: Randy Dunlap <rdunlap@infradead.org>
Reviewed-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Link: https://lore.kernel.org/r/5710038.lOV4Wx5bFT@iron-maiden
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2021-05-13 09:31:10 -04:00
characteristic of the source picture,
2020-10-30 08:40:39 +01:00
also called the gamma function
bColorPrimaries color primaries and the reference
white
======================== ======================================
2014-12-10 12:34:02 +01:00
2023-02-02 11:41:42 +00:00
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/color_matching/name
Date: Dec 2022
KernelVersion: 6.3
Description: Additional color matching descriptors
All attributes read/write:
======================== ======================================
bMatrixCoefficients matrix used to compute luma and
chroma values from the color primaries
bTransferCharacteristics optoelectronic transfer
characteristic of the source picture,
also called the gamma function
bColorPrimaries color primaries and the reference
white
======================== ======================================
2014-12-10 12:34:02 +01:00
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/mjpeg
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: MJPEG format descriptors
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/mjpeg/name
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Specific MJPEG format descriptors
All attributes read only,
except bmaControls and bDefaultFrameIndex:
2020-10-30 08:40:39 +01:00
=================== =====================================
bFormatIndex unique id for this format descriptor;
2018-05-27 00:51:57 +03:00
only defined after parent header is
linked into the streaming class;
read-only
2020-10-30 08:40:39 +01:00
bmaControls this format's data for bmaControls in
2014-12-10 12:34:02 +01:00
the streaming header
2022-12-06 16:12:03 +00:00
bmInterlaceFlags specifies interlace information,
2014-12-10 12:34:02 +01:00
read-only
2020-10-30 08:40:39 +01:00
bAspectRatioY the X dimension of the picture aspect
2014-12-10 12:34:02 +01:00
ratio, read-only
2020-10-30 08:40:39 +01:00
bAspectRatioX the Y dimension of the picture aspect
2014-12-10 12:34:02 +01:00
ratio, read-only
2020-10-30 08:40:39 +01:00
bmFlags characteristics of this format,
2014-12-10 12:34:02 +01:00
read-only
2020-10-30 08:40:39 +01:00
bDefaultFrameIndex optimum frame index for this stream
=================== =====================================
2014-12-10 12:34:02 +01:00
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/mjpeg/name/name
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Specific MJPEG frame descriptors
2020-10-30 08:40:39 +01:00
========================= =====================================
bFrameIndex unique id for this framedescriptor;
only defined after parent format is
linked into the streaming header;
read-only
dwFrameInterval indicates how frame interval can be
programmed; a number of values
separated by newline can be specified
dwDefaultFrameInterval the frame interval the device would
like to use as default
dwMaxVideoFrameBufferSize the maximum number of bytes the
compressor will produce for a video
frame or still image
dwMaxBitRate the maximum bit rate at the shortest
frame interval in bps
dwMinBitRate the minimum bit rate at the longest
frame interval in bps
wHeight height of decoded bitmap frame in px
wWidth width of decoded bitmam frame in px
bmCapabilities still image support, fixed frame-rate
support
========================= =====================================
2014-12-10 12:34:02 +01:00
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/uncompressed
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Uncompressed format descriptors
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/uncompressed/name
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Specific uncompressed format descriptors
2020-10-30 08:40:39 +01:00
================== =======================================
bFormatIndex unique id for this format descriptor;
2018-05-27 00:51:57 +03:00
only defined after parent header is
linked into the streaming class;
read-only
2020-10-30 08:40:39 +01:00
bmaControls this format's data for bmaControls in
2014-12-10 12:34:02 +01:00
the streaming header
2022-12-06 16:12:03 +00:00
bmInterlaceFlags specifies interlace information,
2014-12-10 12:34:02 +01:00
read-only
2020-10-30 08:40:39 +01:00
bAspectRatioY the X dimension of the picture aspect
2014-12-10 12:34:02 +01:00
ratio, read-only
2020-10-30 08:40:39 +01:00
bAspectRatioX the Y dimension of the picture aspect
2014-12-10 12:34:02 +01:00
ratio, read-only
2020-10-30 08:40:39 +01:00
bDefaultFrameIndex optimum frame index for this stream
bBitsPerPixel number of bits per pixel used to
2014-12-10 12:34:02 +01:00
specify color in the decoded video
frame
2020-10-30 08:40:39 +01:00
guidFormat globally unique id used to identify
2014-12-10 12:34:02 +01:00
stream-encoding format
2020-10-30 08:40:39 +01:00
================== =======================================
2014-12-10 12:34:02 +01:00
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/uncompressed/name/name
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Specific uncompressed frame descriptors
2020-10-30 08:40:39 +01:00
========================= =====================================
bFrameIndex unique id for this framedescriptor;
only defined after parent format is
linked into the streaming header;
read-only
dwFrameInterval indicates how frame interval can be
programmed; a number of values
separated by newline can be specified
dwDefaultFrameInterval the frame interval the device would
like to use as default
dwMaxVideoFrameBufferSize the maximum number of bytes the
compressor will produce for a video
frame or still image
dwMaxBitRate the maximum bit rate at the shortest
frame interval in bps
dwMinBitRate the minimum bit rate at the longest
frame interval in bps
wHeight height of decoded bitmap frame in px
wWidth width of decoded bitmam frame in px
bmCapabilities still image support, fixed frame-rate
support
========================= =====================================
2014-12-10 12:34:02 +01:00
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/header
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Streaming header descriptors
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/header/name
Date: Dec 2014
2016-05-22 15:35:13 +02:00
KernelVersion: 4.0
2014-12-10 12:34:02 +01:00
Description: Specific streaming header descriptors
All attributes read only:
2020-10-30 08:40:39 +01:00
==================== =====================================
bTriggerUsage how the host software will respond to
2014-12-10 12:34:02 +01:00
a hardware trigger interrupt event
2020-10-30 08:40:39 +01:00
bTriggerSupport flag specifying if hardware
2014-12-10 12:34:02 +01:00
triggering is supported
docs: typo fixes in Documentation/ABI/
Fix the following typos in the Documentation/ABI/ directory:
- In file obsolete/sysfs-cpuidle, change "obselete" for "obsolete".
- In file removed/sysfs-kernel-uids, change "propotional" for "proportional".
- In directory stable/, fix the following words: "associtated" for "associated",
"hexidecimal" for "hexadecimal", "vlue" for "value", "csed" for "caused" and
"wrtie" for "write". This updates a total of five files.
- In directory testing/, fix the following words: "subystem" for "subsystem",
"isochrnous" for "isochronous", "Desctiptors" for "Descriptors", "picutre" for
"picture", "capture" for "capture", "occured" for "ocurred", "connnected" for
"connected","agressively" for "aggressively","manufacturee" for "manufacturer"
and "transaction" for "transaction", "malformatted" for "incorrectly formated"
,"internel" for "internal", "writtento" for "written to", "specificed" for
"specified", "beyound" for "beyond", "Symetric" for "Symmetric". This updates
a total of eleven files.
Signed-off-by: Carlos Bilbao <bilbao@vt.edu>
Reviewed-by: Randy Dunlap <rdunlap@infradead.org>
Reviewed-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Link: https://lore.kernel.org/r/5710038.lOV4Wx5bFT@iron-maiden
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2021-05-13 09:31:10 -04:00
bStillCaptureMethod method of still image capture
2014-12-10 12:34:02 +01:00
supported
2020-10-30 08:40:39 +01:00
bTerminalLink id of the output terminal to which
2014-12-10 12:34:02 +01:00
the video endpoint of this interface
is connected
2020-10-30 08:40:39 +01:00
bmInfo capabilities of this video streaming
2014-12-10 12:34:02 +01:00
interface
2020-10-30 08:40:39 +01:00
==================== =====================================
2018-05-24 17:16:12 +01:00
What: /sys/class/udc/udc.name/device/gadget/video4linux/video.name/function_name
Date: May 2018
KernelVersion: 4.19
Description: UVC configfs function instance name
