Skip to content

Add seated PSVR webcam LED 6DoF tracking - #1

Merged
Davidbkr03 merged 14 commits into
mainfrom
codex/psvr-headset-led-6dof
Jul 30, 2026
Merged

Add seated PSVR webcam LED 6DoF tracking#1
Davidbkr03 merged 14 commits into
mainfrom
codex/psvr-headset-led-6dof

Conversation

@Davidbkr03

@Davidbkr03 Davidbkr03 commented Jul 30, 2026

Copy link
Copy Markdown
Owner

Summary

  • add PSVR1 seven-LED webcam tracking through Windows Media Foundation
  • synchronize headset IMU timestamps and fuse low-latency orientation with delayed optical position
  • expose PSVR LED, webcam, calibration, and diagnostic controls in Config Tool
  • add deterministic solver, timing, fusion, capture, and camera-identity tests
  • add an independently branded, checksummed Win64 preview package and first-run SteamVR guide

Reason

PSMoveServiceEx does not track the PSVR headset's built-in LEDs. This
independent derivative adds a deliberately seated, single-webcam 6DoF path
while retaining protocol 0.9-alpha9.0.0 for the iVRy bridge.

Implementation

  • calibrated seven-point PSVR LED constellation with robust PnP solving
  • sensor-clock rollover handling and host-time mapping
  • delayed optical correction fused with headset IMU orientation
  • stable Media Foundation webcam identity and asynchronous frame timestamps
  • standalone project identity, attribution, third-party notices, and release packaging
  • PS3EYEDriver excluded from the distributed preview; generic webcams remain enabled
  • dynamic, replaceable libusb runtime with exact corresponding-source bundle

Testing performed

  • fresh Ubuntu 24.04 WSL CMake configure
  • built and passed all five deterministic tracking tests
  • native Windows run 30571759887
    compiled the service, Config Tool, client DLL, and all five tests with the
    pinned MSVC v142 toolset
  • the same exact-head run passed all five tests, executable help smoke,
    client-DLL loading, packaged documentation links, required notices,
    checksums, corresponding-source creation, and artifact upload
  • GitHub Actions workflow validated with actionlint and PowerShell AST parsing
  • JSON, Markdown local-link, modification-notice, and git diff --check validation

Documentation

  • standalone README and lineage/attribution notices
  • technical PSVR LED tracking design and validation checklist
  • user-focused SteamVR/iVRy first-run guide
  • reproducible Windows preview build and package-verification guide

Remaining risks

  • physical PSVR, webcam, iVRy, and SteamVR behavior cannot be validated until the first hardware test
  • real camera exposure, HSV thresholds, latency, and optical scale will need calibration/tuning
  • this remains a hardware-test preview until that feedback is incorporated

@Davidbkr03
Davidbkr03 marked this pull request as ready for review July 30, 2026 19:14
@Davidbkr03
Davidbkr03 merged commit ee5ea81 into main Jul 30, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant