Mimir/research/visual-spatial-map/mirrors/psmoveapi-camera-docs.html

194 lines
11 KiB
HTML
Raw Normal View History

<!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>