Add driver for StarTech USB3HDCAP capture device
Subsystems (2)
v2 cover Add driver for StarTech USB3HDCAP capture device
Add a V4L2/ALSA driver for the StarTech USB3HDCAP (and Micomsoft XCAPTURE-1 variant), a USB 3.0 video capture device based on the MST3367 HDMI receiver, TW9900 composite decoder, and CS53L21 audio codec.
The driver supports composite, S-Video, component, and HDMI inputs, including audio capture. I'm targeting staging because the I2C chip drivers are currently embedded rather than using proper subdevice drivers, and some other minor issues remain (see TODO).
Tested on all four inputs at various resolutions. All v4l2-compliance tests pass, including streaming tests, but I did find what might be a bug in v4l2-compliance that causes any device that uses V4L2_FIELD_ALTERNATE to fail the streaming tests - I believe the sequence number checks in v4l2-test-buffers.cpp are contradictory for V4L2_FIELD_ALTERNATE and impossible to satisfy. I temporarily changed my driver to report FIELD_NONE to have the streaming tests run. I'm happy to fix the v4l2-compliance issue if it is indeed an issue, or fix my driver if it's not :)
This is my first contribution. I based this driver heavily on the existing usbtv driver and welcome all feedback. I am committed to eventually getting this out of staging and will stick around to make any improvements needed so that can happen.
Thanks,
Matthew
$ v4l2-compliance -s -d /dev/video2 v4l2-compliance 1.33.0-5455, 64 bits, 64-bit time_t v4l2-compliance SHA: 95ad25f6a77a 2026-03-17 13:08:36
Compliance test for usb3hdcap device /dev/video2:
Driver Info:
Driver name : usb3hdcap Card type : StarTech USB3HDCAP Bus info : usb-0000:00:14.0-2 Driver version : 6.12.73 Capabilities : 0x85200001
Video Capture
Read/Write
Streaming
Extended Pix Format
Device Capabilities
Device Caps : 0x05200001
Video Capture
Read/Write
Streaming
Extended Pix Format
Required ioctls:
test VIDIOC_QUERYCAP: OK
test invalid ioctls: OK
Allow for multiple opens:
test second /dev/video2 open: OK
test VIDIOC_QUERYCAP: OK
test VIDIOC_G/S_PRIORITY: OK
test for unlimited opens: OK
Debug ioctls:
test VIDIOC_DBG_G/S_REGISTER: OK (Not Supported) test VIDIOC_LOG_STATUS: OK
Input ioctls:
test VIDIOC_G/S_TUNER/ENUM_FREQ_BANDS: OK (Not Supported) test VIDIOC_G/S_FREQUENCY: OK (Not Supported) test VIDIOC_S_HW_FREQ_SEEK: OK (Not Supported) test VIDIOC_ENUMAUDIO: OK (Not Supported)
test VIDIOC_G/S/ENUMINPUT: OK
test VIDIOC_G/S_AUDIO: OK (Not Supported)
Inputs: 4 Audio Inputs: 0 Tuners: 0
Output ioctls:
test VIDIOC_G/S_MODULATOR: OK (Not Supported) test VIDIOC_G/S_FREQUENCY: OK (Not Supported) test VIDIOC_ENUMAUDOUT: OK (Not Supported) test VIDIOC_G/S/ENUMOUTPUT: OK (Not Supported) test VIDIOC_G/S_AUDOUT: OK (Not Supported)
Outputs: 0 Audio Outputs: 0 Modulators: 0
Input/Output configuration ioctls:
test VIDIOC_ENUM/G/S/QUERY_STD: OK
fail: v4l2-test-io-config.cpp(210): field == V4L2_FIELD_NONE
fail: v4l2-test-io-config.cpp(386): Timings check failed for input 2.
test VIDIOC_ENUM/G/S/QUERY_DV_TIMINGS: FAIL
test VIDIOC_DV_TIMINGS_CAP: OK
test VIDIOC_G/S_EDID: OK (Not Supported)
Control ioctls (Input 0):
test VIDIOC_QUERY_EXT_CTRL/QUERYMENU: OK test VIDIOC_QUERYCTRL: OK
test VIDIOC_G/S_CTRL: OK
test VIDIOC_G/S/TRY_EXT_CTRLS: OK test VIDIOC_(UN)SUBSCRIBE_EVENT/DQEVENT: OK test VIDIOC_G/S_JPEGCOMP: OK (Not Supported) Standard Controls: 8 Private Controls: 0
Format ioctls (Input 0):
test VIDIOC_ENUM_FMT/FRAMESIZES/FRAMEINTERVALS: OK test VIDIOC_G/S_PARM: OK
test VIDIOC_G_FBUF: OK (Not Supported) test VIDIOC_G_FMT: OK
test VIDIOC_TRY_FMT: OK
test VIDIOC_S_FMT: OK
test VIDIOC_G_SLICED_VBI_CAP: OK (Not Supported) test Cropping: OK (Not Supported)
test Composing: OK (Not Supported)
test Scaling: OK (Not Supported)
Codec ioctls (Input 0):
test VIDIOC_(TRY_)ENCODER_CMD: OK (Not Supported) test VIDIOC_G_ENC_INDEX: OK (Not Supported) test VIDIOC_(TRY_)DECODER_CMD: OK (Not Supported)
Buffer ioctls (Input 0):
test VIDIOC_REQBUFS/CREATE_BUFS/QUERYBUF: OK test CREATE_BUFS maximum buffers: OK test VIDIOC_REMOVE_BUFS: OK
test VIDIOC_EXPBUF: OK (Not Supported) test Requests: OK (Not Supported) test blocking wait: OK
Control ioctls (Input 1):
test VIDIOC_QUERY_EXT_CTRL/QUERYMENU: OK test VIDIOC_QUERYCTRL: OK
test VIDIOC_G/S_CTRL: OK
test VIDIOC_G/S/TRY_EXT_CTRLS: OK test VIDIOC_(UN)SUBSCRIBE_EVENT/DQEVENT: OK test VIDIOC_G/S_JPEGCOMP: OK (Not Supported) Standard Controls: 8 Private Controls: 0
Format ioctls (Input 1):
test VIDIOC_ENUM_FMT/FRAMESIZES/FRAMEINTERVALS: OK test VIDIOC_G/S_PARM: OK
test VIDIOC_G_FBUF: OK (Not Supported) test VIDIOC_G_FMT: OK
test VIDIOC_TRY_FMT: OK
test VIDIOC_S_FMT: OK
test VIDIOC_G_SLICED_VBI_CAP: OK (Not Supported) test Cropping: OK (Not Supported)
test Composing: OK (Not Supported)
test Scaling: OK (Not Supported)
Codec ioctls (Input 1):
test VIDIOC_(TRY_)ENCODER_CMD: OK (Not Supported) test VIDIOC_G_ENC_INDEX: OK (Not Supported) test VIDIOC_(TRY_)DECODER_CMD: OK (Not Supported)
Buffer ioctls (Input 1):
test VIDIOC_REQBUFS/CREATE_BUFS/QUERYBUF: OK test CREATE_BUFS maximum buffers: OK test VIDIOC_REMOVE_BUFS: OK
test VIDIOC_EXPBUF: OK (Not Supported) test Requests: OK (Not Supported) test blocking wait: OK
Control ioctls (Input 2):
test VIDIOC_QUERY_EXT_CTRL/QUERYMENU: OK test VIDIOC_QUERYCTRL: OK
test VIDIOC_G/S_CTRL: OK
test VIDIOC_G/S/TRY_EXT_CTRLS: OK test VIDIOC_(UN)SUBSCRIBE_EVENT/DQEVENT: OK test VIDIOC_G/S_JPEGCOMP: OK (Not Supported) Standard Controls: 8 Private Controls: 0
Format ioctls (Input 2):
test VIDIOC_ENUM_FMT/FRAMESIZES/FRAMEINTERVALS: OK test VIDIOC_G/S_PARM: OK
test VIDIOC_G_FBUF: OK (Not Supported) test VIDIOC_G_FMT: OK
test VIDIOC_TRY_FMT: OK
test VIDIOC_S_FMT: OK
test VIDIOC_G_SLICED_VBI_CAP: OK (Not Supported) test Cropping: OK (Not Supported)
test Composing: OK (Not Supported)
test Scaling: OK (Not Supported)
Codec ioctls (Input 2):
test VIDIOC_(TRY_)ENCODER_CMD: OK (Not Supported) test VIDIOC_G_ENC_INDEX: OK (Not Supported) test VIDIOC_(TRY_)DECODER_CMD: OK (Not Supported)
Buffer ioctls (Input 2):
test VIDIOC_REQBUFS/CREATE_BUFS/QUERYBUF: OK test CREATE_BUFS maximum buffers: OK test VIDIOC_REMOVE_BUFS: OK
test VIDIOC_EXPBUF: OK (Not Supported) test Requests: OK (Not Supported) test blocking wait: OK
Control ioctls (Input 3):
test VIDIOC_QUERY_EXT_CTRL/QUERYMENU: OK test VIDIOC_QUERYCTRL: OK
test VIDIOC_G/S_CTRL: OK
test VIDIOC_G/S/TRY_EXT_CTRLS: OK test VIDIOC_(UN)SUBSCRIBE_EVENT/DQEVENT: OK test VIDIOC_G/S_JPEGCOMP: OK (Not Supported) Standard Controls: 8 Private Controls: 0
Format ioctls (Input 3):
test VIDIOC_ENUM_FMT/FRAMESIZES/FRAMEINTERVALS: OK test VIDIOC_G/S_PARM: OK
test VIDIOC_G_FBUF: OK (Not Supported) test VIDIOC_G_FMT: OK
test VIDIOC_TRY_FMT: OK
test VIDIOC_S_FMT: OK
test VIDIOC_G_SLICED_VBI_CAP: OK (Not Supported) test Cropping: OK (Not Supported)
test Composing: OK (Not Supported)
test Scaling: OK (Not Supported)
Codec ioctls (Input 3):
test VIDIOC_(TRY_)ENCODER_CMD: OK (Not Supported) test VIDIOC_G_ENC_INDEX: OK (Not Supported) test VIDIOC_(TRY_)DECODER_CMD: OK (Not Supported)
Buffer ioctls (Input 3):
test VIDIOC_REQBUFS/CREATE_BUFS/QUERYBUF: OK test CREATE_BUFS maximum buffers: OK test VIDIOC_REMOVE_BUFS: OK
test VIDIOC_EXPBUF: OK (Not Supported) test Requests: OK (Not Supported) test blocking wait: OK
Test input 0:
Streaming ioctls:
test read/write: OK
test MMAP (no poll, REQBUFS): OK
test MMAP (select, REQBUFS): OK
test MMAP (epoll, REQBUFS): OK
test MMAP (no poll, CREATE_BUFS): OK
test MMAP (select, CREATE_BUFS): OK
test MMAP (epoll, CREATE_BUFS): OK
test USERPTR (no poll): OK
test USERPTR (select): OK
test DMABUF (no poll): OK (Not Supported)
test DMABUF (select): OK (Not Supported)
Total for usb3hdcap device /dev/video2: 134, Succeeded: 133, Failed: 1,
Warnings: 0
Matthew Laux (1):
staging: media: add driver for StarTech USB3HDCAP
MAINTAINERS | 8 + drivers/staging/media/Kconfig | 2 + drivers/staging/media/Makefile | 1 + drivers/staging/media/usb3hdcap/Kconfig | 13 + drivers/staging/media/usb3hdcap/Makefile | 4 + drivers/staging/media/usb3hdcap/TODO | 15 + .../staging/media/usb3hdcap/usb3hdcap-audio.c | 301 +++++ .../media/usb3hdcap/usb3hdcap-composite.c | 182 +++ .../staging/media/usb3hdcap/usb3hdcap-core.c | 1002 +++++++++++++++++ .../staging/media/usb3hdcap/usb3hdcap-hdmi.c | 802 +++++++++++++ .../staging/media/usb3hdcap/usb3hdcap-video.c | 505 +++++++++ drivers/staging/media/usb3hdcap/usb3hdcap.h | 234 ++++ 12 files changed, 3069 insertions(+) create mode 100644 drivers/staging/media/usb3hdcap/Kconfig create mode 100644 drivers/staging/media/usb3hdcap/Makefile create mode 100644 drivers/staging/media/usb3hdcap/TODO create mode 100644 drivers/staging/media/usb3hdcap/usb3hdcap-audio.c create mode 100644 drivers/staging/media/usb3hdcap/usb3hdcap-composite.c create mode 100644 drivers/staging/media/usb3hdcap/usb3hdcap-core.c create mode 100644 drivers/staging/media/usb3hdcap/usb3hdcap-hdmi.c create mode 100644 drivers/staging/media/usb3hdcap/usb3hdcap-video.c create mode 100644 drivers/staging/media/usb3hdcap/usb3hdcap.h
base-commit: 2c8fe1f14240d75f2002e16b2b69c5c2d27ed41c
Signature · 1 line
2.47.3
PATCH v2 1/1 staging: media: add driver for StarTech USB3HDCAP
Add a V4L2 driver for the StarTech USB3HDCAP video capture device. This is a popular capture card based on the MST3367 HDMI receiver and TW9900 composite video decoder. Support is included for the composite, S-Video, component, and HDMI inputs, and these inputs have been tested at various resolutions. Audio support is provided by an ALSA device.
Also includes preliminary support for the Micomsoft XCAPTURE-1 hardware variant. I've provided a TODO containing the remaining items necessary to get this out of staging.
---
v2: remove unused CSC matrix control, remove version.h include,
fix all remaining check-level checkpatch issues, update TODO
MAINTAINERS | 8 + drivers/staging/media/Kconfig | 2 + drivers/staging/media/Makefile | 1 + drivers/staging/media/usb3hdcap/Kconfig | 13 + drivers/staging/media/usb3hdcap/Makefile | 4 + drivers/staging/media/usb3hdcap/TODO | 15 + .../staging/media/usb3hdcap/usb3hdcap-audio.c | 301 +++++ .../media/usb3hdcap/usb3hdcap-composite.c | 182 +++ .../staging/media/usb3hdcap/usb3hdcap-core.c | 1002 +++++++++++++++++ .../staging/media/usb3hdcap/usb3hdcap-hdmi.c | 802 +++++++++++++ .../staging/media/usb3hdcap/usb3hdcap-video.c | 505 +++++++++ drivers/staging/media/usb3hdcap/usb3hdcap.h | 234 ++++ 12 files changed, 3069 insertions(+) create mode 100644 drivers/staging/media/usb3hdcap/Kconfig create mode 100644 drivers/staging/media/usb3hdcap/Makefile create mode 100644 drivers/staging/media/usb3hdcap/TODO create mode 100644 drivers/staging/media/usb3hdcap/usb3hdcap-audio.c create mode 100644 drivers/staging/media/usb3hdcap/usb3hdcap-composite.c create mode 100644 drivers/staging/media/usb3hdcap/usb3hdcap-core.c create mode 100644 drivers/staging/media/usb3hdcap/usb3hdcap-hdmi.c create mode 100644 drivers/staging/media/usb3hdcap/usb3hdcap-video.c create mode 100644 drivers/staging/media/usb3hdcap/usb3hdcap.h
MAINTAINERS +8 -0
@@ -25303,6 +25303,14 @@ S: Supported F: Documentation/devicetree/bindings/interrupt-controller/starfive,jh8100-intc.yaml F: drivers/irqchip/irq-starfive-jh8100-intc.c +STARTECH USB3HDCAP MEDIA DRIVER +M: Matthew Laux <[email protected]> +L: [email protected] +S: Supported +W: https://linuxtv.org +Q: http://patchwork.linuxtv.org/project/linux-media/list/ +F: drivers/staging/media/usb3hdcap/ + STATIC BRANCH/CALL M: Peter Zijlstra <[email protected]> M: Josh Poimboeuf <[email protected]>
drivers/staging/media/Kconfig +2 -0
@@ -38,6 +38,8 @@ source "drivers/staging/media/sunxi/Kconfig" source "drivers/staging/media/tegra-video/Kconfig" +source "drivers/staging/media/usb3hdcap/Kconfig" + menuconfig STAGING_MEDIA_DEPRECATED bool "Media staging drivers (DEPRECATED)" default n
drivers/staging/media/Makefile +1 -0
@@ -9,3 +9,4 @@ obj-$(CONFIG_VIDEO_TEGRA) += tegra-video/ obj-$(CONFIG_VIDEO_IPU3_IMGU) += ipu3/ obj-$(CONFIG_VIDEO_INTEL_IPU7) += ipu7/ obj-$(CONFIG_DVB_AV7110) += av7110/ +obj-$(CONFIG_VIDEO_USB3HDCAP) += usb3hdcap/
drivers/staging/media/usb3hdcap/Kconfig new file +13 -0
@@ -0,0 +1,13 @@ +# SPDX-License-Identifier: GPL-2.0 +config VIDEO_USB3HDCAP + tristate "USB3HDCAP video capture support" + depends on VIDEO_DEV && SND + select SND_PCM + select VIDEOBUF2_VMALLOC + + help + This is a video4linux2 driver for the StarTech USB3HDCAP video/audio + capture device. + + To compile this driver as a module, choose M here; the + module will be called usb3hdcap.
drivers/staging/media/usb3hdcap/Makefile new file +4 -0
@@ -0,0 +1,4 @@ +# SPDX-License-Identifier: GPL-2.0 +usb3hdcap-y := usb3hdcap-core.o usb3hdcap-video.o usb3hdcap-composite.o \ + usb3hdcap-hdmi.o usb3hdcap-audio.o +obj-$(CONFIG_VIDEO_USB3HDCAP) += usb3hdcap.o
drivers/staging/media/usb3hdcap/TODO new file +15 -0
@@ -0,0 +1,15 @@ +* Prerequisite for using subdevices: i2c_algorithm/i2c_adapter that converts + to the correct USB vendor requests depending on whether the hardware has the + NUC100 or not +* Use existing tw9900 subdevice + * Need to make the regulator optional + * Need to only call `v4l2_async_register_subdev` when registering from + device tree so this driver can call `v4l2_device_register_subdev` + directly + * Need to port over my additional functionality to tw9900.c +* Write new subdevice for MST3367 + * Won't be much use to any other driver initially +* Generify CS53L21 support (can probably base it on sound/soc/codecs/cs53l30.c) +* Use v4l2_fh +* Investigate MST3367 situation with XCAPTURE-1 - hdmi signal disappears after + a frame or two - HDCP related?
drivers/staging/media/usb3hdcap/usb3hdcap-audio.c new file +301 -0
301 lines not on this page · raw message
drivers/staging/media/usb3hdcap/usb3hdcap-composite.c new file +182 -0
182 lines not on this page · raw message
drivers/staging/media/usb3hdcap/usb3hdcap-core.c new file +1002 -0
1,002 lines not on this page · raw message
drivers/staging/media/usb3hdcap/usb3hdcap-hdmi.c new file +802 -0
802 lines not on this page · raw message
drivers/staging/media/usb3hdcap/usb3hdcap-video.c new file +505 -0
505 lines not on this page · raw message
drivers/staging/media/usb3hdcap/usb3hdcap.h new file +234 -0
150 lines not on this page · raw message
The rest of this diff is not shown. View the raw message.
Signature · 1 line
2.47.3
Part of the diff is not shown here. View the raw message.