Tracking and Camera

This page contains information about the camera integration, especially as it relates to tracking and the different variants for different OSes.

PS3 Camera

This camera is always supported on Linux, and supported on macOS and Windows when using the PS3EYEDriver camera control driver.

On Linux, the kernel includes built-in support for the camera using the ov534 driver, so the V4L2 camera control driver also support the PS3 Eye.

The camera needs a USB 2.0 port.

On Windows, you need to install Zadig (WinUSB driver) for the “USBCamera-B4.09.24.1” (or similar) device so that the PS3EYEDriver can access the camera using libusb. This has been tested with the “WinUSB (v6.1.7600.16385)” driver and Zadig 2.7.

  • Tested models: SLEH-00448
  • No firmware upload necessary

Supported resolutions:

  • 640x480 @ 60 Hz (default)
  • 320x240 @ 187 Hz

PS4 Camera

This camera is currently supported on Linux when using the V4L2 camera control driver, and macOS when using the AVFoundation camera control driver.

You need to upload a firmware binary blob using the psmove camera-firmware command.

The camera needs a USB 3.0 port.

If you have a PSVR kit, you can order the Camera Adaptor (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.

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 psmove camera-firmware --force-ps4 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).

After the firmware upload the camera is supported using the uvcvideo kernel driver in OpenCV/V4L2 (Linux) and UVCService on OpenCV/AVFoundation (macOS).

  • Tested models: CUH-ZEY2 (“round model v2”)
  • Tested firmware SHA-1: fe86162309518a0ffe267075a2fcf728c5856b3e
  • Firmware search path: /etc/psmoveapi/camera-firmware-ps4.bin, $HOME/.psmoveapi/camera-firmware-ps4.bin

Supported resolutions:

  • 1280x800 @ 60 Hz (default)
  • 640x400 @ 120 Hz
  • 320x192 @ 240 Hz

PS5 Camera

This camera is currently supported on Linux when using the V4L2 camera control driver, and macOS when using the AVFoundation camera control driver.

You need to upload a firmware binary blob using the psmove camera-firmware command.

The camera needs a USB 3.0 port.

After the firmware upload the camera is supported using the uvcvideo kernel driver in OpenCV/V4L2 (Linux) and UVCService on OpenCV/AVFoundation (macOS).

  • Tested models: CFI-ZEY1
  • Tested firmware SHA-1: 0fa4da31a12b662a9a80abc8b84932770df8f7e1
  • Firmware search path: /etc/psmoveapi/camera-firmware-ps5.bin, $HOME/.psmoveapi/camera-firmware-ps5.bin

Supported resolutions:

  • 1920x1080 @ 30 Hz
  • 1280x800 @ 60 Hz (default)
  • 960x520 @ 60 Hz
  • 640x376 @ 120 Hz
  • 448x256 @ 120 Hz
  • 320x184 @ 240 Hz