Vita:UDCD Video Streaming Plugin: Difference between revisions

From ConsoleMods Wiki
Jump to navigation Jump to search
(Mostly copied text from udcd GitHub page, with extras added like the alternative versions and linking to the github release page)
 
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
Stream Vita screen over USB cable, Vita appears as a USB class camera and is accessible from VLC and OBS, additionally any device that supports the USB Video class (There are apps on Android, but at this time nothing on IOS)
[https://github.com/xerpi/vita-udcd-uvc The UDCD Video streaming plugin] is a kernel plugin that allows you to stream the Vita screen over a USB cable. The Vita appears as a USB class camera and is accessible from VLC and OBS on a PC or on any other device that supports the USB Video class (such as Androids).


[https://github.com/xerpi/vita-udcd-uvc GitHub Project]
The plugin uses the SceUdcd module of the PSVita OS to setup the necessary USB descriptors to simulate and behave as an USB Video class device, similar to a webcam or a USB video capture card. The hardware color space converter of the PSVita's SoC is used to perform the conversion to the destination pixel format; then the USB controller directly performs a DMA transfer from the physical address of the resulting converted framebuffer, saving CPU usage and and reducing power consumption.


This is a kernel plugin that lets you stream your PSVita screen to your computer via USB.
{{Note|The plugin ''doesn't'' stream audio. For that, use a 3.5mm jack to jack adapter (a ferrite bead might help reduce the electromagnetic noise).}}


== How does it work? ==
== Supported Formats and Resolutions ==
The plugin uses the SceUdcd module of the PSVita OS to setup the necessary USB descriptors to simulate and behave as an USB Video Class device (like a webcam or an USB video capture card).
 
The hardware color space converter of the PSVita's SoC is used to perform the conversion to the destination pixel format; then the USB controller directly performs a DMA transfer from the physical address of the resulting converted framebuffer, and therefore, saving CPU usage and power consumption.
 
== Supported formats and resolutions ==


* 960x544 @ 30 FPS and (less than) 60 FPS
* 960x544 @ 30 FPS and (less than) 60 FPS
Line 19: Line 14:


== Download and installation ==
== Download and installation ==
'''Download''':
'''Download''':  


* udcd_uvc.skprx - [https://github.com/xerpi/vita-udcd-uvc/releases From the GitHub projects releases page]
* udcd_uvc.skprx - [https://github.com/xerpi/vita-udcd-uvc/releases GitHub releases page]


'''Compilation'''
'''Compilation'''
Line 31: Line 26:
# Copy <code>udcd_uvc.skprx</code> to your PSVita
# Copy <code>udcd_uvc.skprx</code> to your PSVita
# Add <code>udcd_uvc.skprx</code> to taiHEN's config (<code>ur0:/tai/config.txt</code> or <code>ux0:/tai/config.txt</code>):
# Add <code>udcd_uvc.skprx</code> to taiHEN's config (<code>ur0:/tai/config.txt</code> or <code>ux0:/tai/config.txt</code>):
 
#:<pre>
<code>*KERNEL
#:: *KERNEL
ur0:tai/udcd_uvc.skprx</code>
#:: ur0:tai/udcd_uvc.skprx</pre>
 
# Reboot your PSVita.
# Reboot your PSVita.


== Troubleshooting ==
== Troubleshooting ==
If the video looks glitched, try to change the video player configuration to use the ''NV12'' format or switch to another player (like PotPlayer or OBS). If the colors look wrong, set color range to full and color space to BT.601 (Rec. 601).
{{Note|Remember that if anything goes wrong (like the Vita not booting), you can always press L at boot to skip plugin loading.}}


If you use Windows 10 you might have to change the Camera access permissions on the Privacy Settings.
* '''Not working on Windows 10'''
** You might have to change the Camera access permissions on the Privacy Settings.


On Linux I recommend using ''mplayer'' (<code>mplayer tv:// -tv driver=v4l2:device=/dev/videoX:width=960:height=544</code>).
* '''Not working on Linux'''
** Try using ''mplayer'' (<code>mplayer tv:// -tv driver=v4l2:device=/dev/videoX:width=960:height=544</code>).


'''Audio noise fix:'''
* '''Video looks glitched'''
** Try to change the video player configuration to use the NV12 format or switch to another player (like PotPlayer or OBS). If the colors look wrong, set color range to full and color space to BT.601 (Rec. 601).


* Disable USB power supply (Settings > System)
* '''Audio is noisy'''
 
** Disable USB power supply (Settings > System)
Note: Remember that if anything goes wrong (like PSVita not booting) you can always press L at boot to skip plugin loading.
 
Note 2: No, it ''doesn't'' stream audio. For that use a 3.5mm jack to jack adapter (a ferrite bead might help reduce the electromagnetic noise).


== Turning the screen off during streaming ==
== Turning the screen off during streaming ==
These 2 projects are not on GitHub and are actually quite hard to find. They are included in AutoPlugin 2
These 2 modified projects are not on GitHub and are quite hard to find. They are included in [[Vita:Autoplugin 2|Autoplugin 2]]
 
udcd_uvc OLED - Turns the screen black, turning it off


udcd_uvc LCD - Turns the screen off while streaming
* udcd_uvc OLED - For OLED screens model 1000 - Turns the screen black, turning it off
* udcd_uvc LCD - For LCD screens model 2000+ - Turns the screen off while streaming

Latest revision as of 02:59, 8 August 2022

The UDCD Video streaming plugin is a kernel plugin that allows you to stream the Vita screen over a USB cable. The Vita appears as a USB class camera and is accessible from VLC and OBS on a PC or on any other device that supports the USB Video class (such as Androids).

The plugin uses the SceUdcd module of the PSVita OS to setup the necessary USB descriptors to simulate and behave as an USB Video class device, similar to a webcam or a USB video capture card. The hardware color space converter of the PSVita's SoC is used to perform the conversion to the destination pixel format; then the USB controller directly performs a DMA transfer from the physical address of the resulting converted framebuffer, saving CPU usage and and reducing power consumption.

Exclamation-circle-fill.svgThe plugin doesn't stream audio. For that, use a 3.5mm jack to jack adapter (a ferrite bead might help reduce the electromagnetic noise).


Supported Formats and Resolutions

  • 960x544 @ 30 FPS and (less than) 60 FPS
  • 896x504 @ 30 FPS and (almost) 60 FPS
  • 864x488 @ 30 FPS and 60 FPS
  • 480x272 @ 30 FPS and 60 FPS
  • 1280x720 @ 30 FPS

Download and installation

Download:

Compilation

  • vitasdk is needed.

Installation:

  1. Copy udcd_uvc.skprx to your PSVita
  2. Add udcd_uvc.skprx to taiHEN's config (ur0:/tai/config.txt or ux0:/tai/config.txt): 
    *KERNEL
    

    ur0:tai/udcd_uvc.skprx
  3. Reboot your PSVita.

Troubleshooting

Exclamation-circle-fill.svgRemember that if anything goes wrong (like the Vita not booting), you can always press L at boot to skip plugin loading.


  • Not working on Windows 10
    • You might have to change the Camera access permissions on the Privacy Settings.
  • Not working on Linux
    • Try using mplayer (mplayer tv:// -tv driver=v4l2:device=/dev/videoX:width=960:height=544).
  • Video looks glitched
    • Try to change the video player configuration to use the NV12 format or switch to another player (like PotPlayer or OBS). If the colors look wrong, set color range to full and color space to BT.601 (Rec. 601).
  • Audio is noisy
    • Disable USB power supply (Settings > System)

Turning the screen off during streaming

These 2 modified projects are not on GitHub and are quite hard to find. They are included in Autoplugin 2

  • udcd_uvc OLED - For OLED screens model 1000 - Turns the screen black, turning it off
  • udcd_uvc LCD - For LCD screens model 2000+ - Turns the screen off while streaming
Retrieved from "https://consolemods.org/wiki/index.php?title=Vita:UDCD_Video_Streaming_Plugin&oldid=16216"