rift_sensor_interface.h

Go to the documentation of this file.

// Copyright 2025-2026, Beyley Cardellio
// SPDX-License-Identifier: BSL-1.0
/*!
 * @file
 * @brief  Interface to Oculus Rift sensor probing/initialization
 * @author Beyley Cardellio <ep1cm1n10n123@gmail.com>
 * @ingroup drv_rift_sensor
 */
 
#pragma once
 
#include "rift/rift_interface.h"
 
#include "tracking/t_camera_models.h"
 
 
#define RIFT_SENSOR_CLOCK_FREQ (40000000)
// @todo Remove when clang-format is updated in CI
// clang-format off
#define RIFT_SENSOR_CLOCK_TO_NS(x) ((timepoint_ns)(x) * 1000 / 40)
// clang-format on
#define RIFT_SENSOR_WIDTH 1280
#define RIFT_SENSOR_HEIGHT 960
#define RIFT_SENSOR_FRAME_SIZE (RIFT_SENSOR_WIDTH * RIFT_SENSOR_HEIGHT)
 
struct rift_sensor;
struct rift_sensor_context;
 
int
rift_sensor_context_create(struct rift_sensor_context **out_context, struct xrt_frame_context *xfctx);
 
int
rift_sensor_enable_exposure_sync(struct rift_sensor_context *context, struct rift_sensor *sensor, uint8_t radio_id[5]);
 
int
rift_sensor_context_start(struct rift_sensor_context *context);
 
ssize_t
rift_sensor_context_get_sensors(struct rift_sensor_context *context, struct rift_sensor ***out_sensors);
 
struct xrt_fs *
rift_sensor_get_frame_server(struct rift_sensor *sensor);
 
enum rift_variant
rift_sensor_get_variant(struct rift_sensor *sensor);
 
void
rift_sensor_get_calibration(struct rift_sensor *sensor, struct t_camera_calibration *out_calibration);
 
void
rift_sensor_setup_frame_timestamp_callback(struct rift_sensor *sensor, struct rift_hmd *hmd);