Driver for the Oculus Rift. More...
#include "os/os_time.h"#include "xrt/xrt_defines.h"#include "xrt/xrt_device.h"#include "xrt/xrt_results.h"#include "xrt/xrt_compiler.h"#include "math/m_relation_history.h"#include "math/m_clock_tracking.h"#include "math/m_api.h"#include "math/m_vec2.h"#include "math/m_vec3.h"#include "math/m_mathinclude.h"#include "tracking/t_dead_reckoning.h"#include "util/u_debug.h"#include "util/u_device.h"#include "util/u_distortion_mesh.h"#include "util/u_logging.h"#include "util/u_misc.h"#include "util/u_time.h"#include "util/u_var.h"#include "util/u_visibility_mask.h"#include "util/u_trace_marker.h"#include "util/u_linux.h"#include "util/u_truncate_printf.h"#include <stdio.h>#include <assert.h>#include "rift_distortion.h"#include "rift_internal.h"#include "rift_usb.h"#include "rift_radio.h"
Macros | |
| #define | PARSE_MICROMETER_TRIPLET(out, values) |
Functions | |
| static int | rift_sensor_thread_tick (struct rift_hmd *hmd) |
| static void * | rift_sensor_thread (void *ptr) |
| static int | rift_usb_thread_radio_tick (struct rift_hmd *hmd) |
| static void * | rift_radio_thread (void *ptr) |
| static int | rift_read_led_model (struct rift_hmd *hmd) |
| static void | get_raw_pose (struct rift_hmd *hmd, timepoint_ns when_ns, struct xrt_space_relation *out_relation) |
| static void | rift_hmd_destroy (struct xrt_device *xdev) |
| static xrt_result_t | rift_hmd_get_tracked_pose (struct xrt_device *xdev, enum xrt_input_name name, int64_t at_timestamp_ns, struct xrt_space_relation *out_relation) |
| static xrt_result_t | rift_hmd_get_view_poses (struct xrt_device *xdev, const struct xrt_vec3 *default_eye_relation, int64_t at_timestamp_ns, enum xrt_view_type view_type, uint32_t view_count, struct xrt_space_relation *out_head_relation, struct xrt_fov *out_fovs, struct xrt_pose *out_poses) |
| static xrt_result_t | rift_hmd_get_visibility_mask (struct xrt_device *xdev, enum xrt_visibility_mask_type type, uint32_t view_index, struct xrt_visibility_mask **out_mask) |
| static xrt_result_t | rift_hmd_get_presence (struct xrt_device *xdev, bool *out_presence) |
| static void | rift_hmd_constellation_tracking_source_get_tracked_pose (struct t_constellation_tracker_tracking_source *tracking_source, timepoint_ns when_ns, struct xrt_space_relation *out_relation) |
| void | rift_hmd_constellation_device_push_constellation_tracker_sample (struct t_constellation_tracker_device *connection, struct t_constellation_tracker_sample *sample) |
| int | rift_devices_create (struct os_hid_device *hmd_dev, struct os_hid_device *radio_dev, enum rift_variant variant, const char *serial_number, struct xrt_frame_context *xfctx, struct rift_hmd **out_hmd, struct xrt_device **out_xdevs) |
| Creates Rift HMD and related devices. | |
| bool | rift_get_radio_id (struct rift_hmd *hmd, uint8_t out_radio_id[5]) |
| bool | rift_hmd_frame_timestamp_callback (void *user_data, timepoint_ns *timestamp, uint32_t pts) |
| int | rift_add_to_constellation_tracker (struct rift_hmd *hmd, struct t_constellation_tracker *tracker) |
| struct t_timing_event_source * | rift_hmd_get_timing_event_source (struct rift_hmd *hmd) |
| Gets the HMD's timing event source. | |
Detailed Description
Driver for the Oculus Rift.
Based largely on simulated_hmd.c, with reference to the DK1/DK2 firmware and OpenHMD's rift driver.
Macro Definition Documentation
◆ PARSE_MICROMETER_TRIPLET
| #define PARSE_MICROMETER_TRIPLET | ( | out, | |
| values | |||
| ) |
Function Documentation
◆ rift_devices_create()
| int rift_devices_create | ( | struct os_hid_device * | hmd_dev, |
| struct os_hid_device * | radio_dev, | ||
| enum rift_variant | variant, | ||
| const char * | serial_number, | ||
| struct xrt_frame_context * | xfctx, | ||
| struct rift_hmd ** | out_hmd, | ||
| struct xrt_device ** | out_xdevs | ||
| ) |
Creates Rift HMD and related devices.
- Parameters
-
hmd_dev The HID device for the HMD. radio_dev The HID device for the radio, if present (CV1 only). variant The Rift variant (DK2 or CV1). serial_number The serial number of the device. xfctx The frame context to use for the timing source functions. This is optional if you do not plan to use the Rift as a timing source. out_hmd Output pointer for the created rift_hmd struct. out_xdevs Output array for the created xrt_device pointers. The array must have space for at least 4 devices (HMD, left touch, right touch, remote).
- Returns
- The number of devices created, or a negative value on error.
References xrt_hmd_parts::blend_modes, xrt_device::compute_distortion, xrt_device::destroy, rift_hmd::device_mutex, xrt_view::display, xrt_hmd_parts::distortion, xrt_hmd_parts::fov, xrt_device::get_presence, xrt_device::get_tracked_pose, xrt_device::get_view_poses, xrt_device::get_visibility_mask, xrt_device::hmd, xrt_device::inputs, rift_hmd::last_remote_exposure_time_ns, m_clock_windowed_skew_tracker_alloc(), m_ff_f64_alloc(), m_ff_vec3_f32_alloc(), xrt_hmd_parts::models, xrt_device::name, xrt_hmd_parts::nominal_frame_interval_ns, os_nanosleep(), xrt_hmd_parts::preferred, t_constellation_tracker_device::push_constellation_tracker_sample, rift_hmd::radio_state, xrt_view::rot, xrt_hmd_parts::screens, xrt_device::serial, xrt_device::str, xrt_device::supported, time_s_to_ns(), u_device_noop_update_inputs(), u_distortion_mesh_fill_in_compute(), u_truncate_snprintf(), u_var_add_root(), xrt_device::update_inputs, xrt_view::viewport, xrt_hmd_parts::views, and XRT_INPUT_GENERIC_HEAD_POSE.
◆ rift_hmd_get_timing_event_source()
| struct t_timing_event_source * rift_hmd_get_timing_event_source | ( | struct rift_hmd * | hmd | ) |
Gets the HMD's timing event source.
- Parameters
-
hmd The rift_hmd to get the timing event source from.
- Returns
- The timing event source for the HMD, or NULL if the timing source is not initialized.
