‹ projects

reverb-m1

Native wired VR on Apple silicon: Reverb G1 display bring-up and stereo demo
git clone https://umhau.org/code/reverb-m1.git
Log | Files | Refs

DEPENDENCIES.md (2101B)

      1 # Dependencies
      2 
      3 ## Installed by us
      4 - Python venv (scratch, analysis only, not needed at runtime): `pyimg4` (decompress kernelcache), `capstone`, `numpy`
      5   (disassembly / xref search). Recreate: `python3 -m venv venv && venv/bin/pip install pyimg4 capstone numpy`.
      6 
      7 ## System configuration changes
      8 - Boot-arg `amfi_get_out_of_my_way=1` (recovery helper prerequisite; SIP disabled for this configuration).
      9 - APPLIED 2026-10-20, confirmed working: boot-arg `hdcp-fuse-mask=0` (disables HDCP so the headset stops blanking). See SETUP.md.
     10   Apply: `sudo nvram boot-args="amfi_get_out_of_my_way=1 hdcp-fuse-mask=0"` + reboot.
     11   Revert: `sudo nvram boot-args="amfi_get_out_of_my_way=1"` + reboot.
     12 
     13 ## Pre-existing, relied upon
     14 - macOS 15.6.1, Apple M1 MacBook Air; Xcode Command Line Tools (Swift 6.1.2). No full Xcode, so Metal
     15   shaders are compiled at runtime from source.
     16 
     17 ## Drivers
     18 - None. Headset HID devices are driven from user space via IOKit (IOHIDManager).
     19 
     20 ## Third-party code and provenance
     21 - **Monado** (https://gitlab.freedesktop.org/monado/monado), Boost Software License 1.0, full text in
     22   `LICENSES/BSL-1.0.txt`. Used for:
     23   - HP Reverb G1 HID protocol (wake sequence, IMU report layout, config-store read sequence): adapted from
     24     `src/xrt/drivers/wmr/wmr_hmd.c` (Copyright 2018 Philipp Zabel; 2020-2021 N Madsen; 2020-2023 Collabora, Ltd.)
     25     and `wmr_protocol.h`. Notices retained in `Sources/VRWorkstation/HMD.swift` (vr0).
     26   - Factory calibration decoding + Polynomial-3K lens distortion: ported in `Sources/VRWorkstation/Calibration.swift` (offline checks: `Tests/CalibrationChecks.swift`) from
     27     `wmr_config.c/.h`, `wmr_config_key.h` (Copyright 2021 Jan Schmidt; key derived with
     28     https://github.com/pH5/wmr-config) and `src/xrt/auxiliary/util/u_distortion_mesh.c`
     29     (Copyright 2019-2021 Collabora, Ltd.). Notices retained in the file header.
     30 - **Linux tipd driver** (drivers/usb/typec/tipd, GPL-2.0): consulted for TI/Apple CD321x register and command
     31   semantics only; no code copied.
     32 - **Wintch/reverb-g2** docs: consulted for headset behaviour notes; no code copied.