Mimir/research/visual-spatial-map/mirrors/psmoveapi-camera-docs.html
2026-05-21 18:50:11 +01:00

194 lines
No EOL
11 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html lang="en" data-content_root="./">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Tracking and Camera &#8212; PS Move API 4.0.12 documentation</title>
<link rel="stylesheet" type="text/css" href="_static/pygments.css?v=03e43079" />
<link rel="stylesheet" type="text/css" href="_static/classic.css?v=2bf1fcf8" />
<script src="_static/documentation_options.js?v=2b25b4f2"></script>
<script src="_static/doctools.js?v=fd6eb6e6"></script>
<script src="_static/sphinx_highlight.js?v=6ffebe34"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Networking (Move Daemon)" href="moved.html" />
<link rel="prev" title="Pairing the Controller to your PC" href="pairing.html" />
<script async type="text/javascript" src="/_/static/javascript/readthedocs-addons.js"></script><meta name="readthedocs-project-slug" content="psmoveapi" /><meta name="readthedocs-version-slug" content="latest" /><meta name="readthedocs-resolver-filename" content="/camera.html" /><meta name="readthedocs-http-status" content="200" /></head><body>
<div class="related" role="navigation" aria-label="Related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="moved.html" title="Networking (Move Daemon)"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="pairing.html" title="Pairing the Controller to your PC"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">PS Move API 4.0.12 documentation</a> &#187;</li>
<li class="nav-item nav-item-this"><a href="">Tracking and Camera</a></li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<section id="tracking-and-camera">
<h1>Tracking and Camera<a class="headerlink" href="#tracking-and-camera" title="Link to this heading"></a></h1>
<p>This page contains information about the camera integration, especially
as it relates to tracking and the different variants for different OSes.</p>
<section id="ps3-camera">
<h2>PS3 Camera<a class="headerlink" href="#ps3-camera" title="Link to this heading"></a></h2>
<p>This camera is always supported on Linux, and supported on macOS and Windows
when using the PS3EYEDriver camera control driver.</p>
<p>On Linux, the kernel includes built-in support for the camera using the
<code class="docutils literal notranslate"><span class="pre">ov534</span></code> driver, so the V4L2 camera control driver also support the PS3 Eye.</p>
<p>The camera needs a USB 2.0 port.</p>
<p>On Windows, you need to install <a class="reference external" href="https://zadig.akeo.ie/">Zadig</a> (WinUSB driver) for the
“USBCamera-B4.09.24.1” (or similar) device so that the PS3EYEDriver
can access the camera using <code class="docutils literal notranslate"><span class="pre">libusb</span></code>. This has been tested with the
“WinUSB (v6.1.7600.16385)” driver and Zadig 2.7.</p>
<ul class="simple">
<li><p>Tested models: SLEH-00448</p></li>
<li><p>No firmware upload necessary</p></li>
</ul>
<p>Supported resolutions:</p>
<ul class="simple">
<li><p><strong>640x480 &#64; 60 Hz</strong> (default)</p></li>
<li><p>320x240 &#64; 187 Hz</p></li>
</ul>
</section>
<section id="ps4-camera">
<h2>PS4 Camera<a class="headerlink" href="#ps4-camera" title="Link to this heading"></a></h2>
<p>This camera is currently supported on Linux when using the V4L2 camera control
driver, and macOS when using the AVFoundation camera control driver.</p>
<p>You need to upload a firmware binary blob using the <code class="docutils literal notranslate"><span class="pre">psmove</span> <span class="pre">camera-firmware</span></code> command.</p>
<p>The camera needs a USB 3.0 port.</p>
<p>If you have a PSVR kit, you can order the <a class="reference external" href="https://camera-adaptor.support.playstation.com/">Camera Adaptor</a> (to convert
PS4 AUX to USB 3.0) from Sony for free. You only need to enter the serial
number of your PSVR kit during the ordering process, no need for a PS5.
If you only have the camera but no PSVR, you can look to buy the
adaptor online. The official Sony one is CFI-ZAA1.</p>
<p>The official PSVR camera adaptor for PS5 (CFI-ZAA1) will be detected
automatically. If you are using a homemade PS4 AUX-to-USB adapter, use
<code class="docutils literal notranslate"><span class="pre">psmove</span> <span class="pre">camera-firmware</span> <span class="pre">--force-ps4</span></code> to detect any OV580 in boot mode
as PS4 (otherwise it’s assumed that the camera is a PS5 camera, as there
is no way yet to distinguish the PS4 and PS5 cameras from the USB
descriptor in boot mode only, which is probably why the CFI-ZAA1 appears
as USB parent device during enumeration).</p>
<p>After the firmware upload the camera is supported using
the <code class="docutils literal notranslate"><span class="pre">uvcvideo</span></code> kernel driver in OpenCV/V4L2 (Linux)
and <code class="docutils literal notranslate"><span class="pre">UVCService</span></code> on OpenCV/AVFoundation (macOS).</p>
<ul class="simple">
<li><p>Tested models: CUH-ZEY2 (“round model v2”)</p></li>
<li><p>Tested firmware SHA-1: <code class="docutils literal notranslate"><span class="pre">fe86162309518a0ffe267075a2fcf728c5856b3e</span></code></p></li>
<li><p>Firmware search path: <code class="docutils literal notranslate"><span class="pre">/etc/psmoveapi/camera-firmware-ps4.bin</span></code>, <code class="docutils literal notranslate"><span class="pre">$HOME/.psmoveapi/camera-firmware-ps4.bin</span></code></p></li>
</ul>
<p>Supported resolutions:</p>
<ul class="simple">
<li><p><strong>1280x800 &#64; 60 Hz</strong> (default)</p></li>
<li><p>640x400 &#64; 120 Hz</p></li>
<li><p>320x192 &#64; 240 Hz</p></li>
</ul>
</section>
<section id="ps5-camera">
<h2>PS5 Camera<a class="headerlink" href="#ps5-camera" title="Link to this heading"></a></h2>
<p>This camera is currently supported on Linux when using the V4L2 camera control
driver, and macOS when using the AVFoundation camera control driver.</p>
<p>You need to upload a firmware binary blob using the <code class="docutils literal notranslate"><span class="pre">psmove</span> <span class="pre">camera-firmware</span></code> command.</p>
<p>The camera needs a USB 3.0 port.</p>
<p>After the firmware upload the camera is supported using
the <code class="docutils literal notranslate"><span class="pre">uvcvideo</span></code> kernel driver in OpenCV/V4L2 (Linux)
and <code class="docutils literal notranslate"><span class="pre">UVCService</span></code> on OpenCV/AVFoundation (macOS).</p>
<ul class="simple">
<li><p>Tested models: CFI-ZEY1</p></li>
<li><p>Tested firmware SHA-1: <code class="docutils literal notranslate"><span class="pre">0fa4da31a12b662a9a80abc8b84932770df8f7e1</span></code></p></li>
<li><p>Firmware search path: <code class="docutils literal notranslate"><span class="pre">/etc/psmoveapi/camera-firmware-ps5.bin</span></code>, <code class="docutils literal notranslate"><span class="pre">$HOME/.psmoveapi/camera-firmware-ps5.bin</span></code></p></li>
</ul>
<p>Supported resolutions:</p>
<ul class="simple">
<li><p>1920x1080 &#64; 30 Hz</p></li>
<li><p><strong>1280x800 &#64; 60 Hz</strong> (default)</p></li>
<li><p>960x520 &#64; 60 Hz</p></li>
<li><p>640x376 &#64; 120 Hz</p></li>
<li><p>448x256 &#64; 120 Hz</p></li>
<li><p>320x184 &#64; 240 Hz</p></li>
</ul>
</section>
</section>
<div class="clearer"></div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="Main">
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table of Contents</a></h3>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="build.html">Building from Source</a></li>
<li class="toctree-l1"><a class="reference internal" href="pairing.html">Pairing</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">Camera</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#ps3-camera">PS3 Camera</a></li>
<li class="toctree-l2"><a class="reference internal" href="#ps4-camera">PS4 Camera</a></li>
<li class="toctree-l2"><a class="reference internal" href="#ps5-camera">PS5 Camera</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="moved.html">Network (Move Daemon)</a></li>
<li class="toctree-l1"><a class="reference internal" href="config.html">Configuration</a></li>
<li class="toctree-l1"><a class="reference internal" href="navcon.html">Navigation Controller</a></li>
</ul>
<div>
<h4>Previous topic</h4>
<p class="topless"><a href="pairing.html"
title="previous chapter">Pairing the Controller to your PC</a></p>
</div>
<div>
<h4>Next topic</h4>
<p class="topless"><a href="moved.html"
title="next chapter">Networking (Move Daemon)</a></p>
</div>
<search id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
<input type="submit" value="Go" />
</form>
</div>
</search>
<script>document.getElementById('searchbox').style.display = "block"</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="Related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="moved.html" title="Networking (Move Daemon)"
>next</a> |</li>
<li class="right" >
<a href="pairing.html" title="Pairing the Controller to your PC"
>previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">PS Move API 4.0.12 documentation</a> &#187;</li>
<li class="nav-item nav-item-this"><a href="">Tracking and Camera</a></li>
</ul>
</div>
<div class="footer" role="contentinfo">
&#169; Copyright 2020, Thomas Perl.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 9.1.0.
</div>
</body>
</html>