A single PlayStation Move Controller. More...

Inheritance diagram for psmv_device:

Collaboration diagram for psmv_device:

[legend]

Data Fields
struct xrt_device	base

struct os_hid_device *	hid

struct xrt_tracked_psmv *	ball

struct os_thread_helper	oth

struct {

int64_t resend_time

struct xrt_colour_rgb_u8 led

uint8_t rumble

}	wants
	What should be set.

struct {

struct xrt_colour_rgb_u8 led

uint8_t rumble

}	state
	What is currently set on the device.

struct {

union {

struct psmv_parsed_calibration_zcm1 zcm1

struct psmv_parsed_calibration_zcm2 zcm2

}

struct m_imu_pre_filter prefilter

}	calibration

struct {

struct os_mutex lock
	Lock for last and fusion. More...

struct psmv_parsed_input last
	Last sensor read. More...

uint64_t last_timestamp_ns
	Last time we got a package. More...

struct {

struct xrt_quat rot

struct xrt_vec3 rotvec

struct xrt_vec3 angvel

struct imu_fusion * fusion

struct {

struct xrt_vec3 accel

struct xrt_vec3 gyro

} variance

} fusion

};

struct {

struct xrt_vec3 accel
	Last adjusted accelerator value. More...

struct xrt_vec3 gyro
	Last adjusted gyro value. More...

}	read

uint16_t	pid

enum u_logging_level	log_level

struct {

bool control

bool calibration

bool last_frame

bool fusion

}	gui

Data Fields inherited from xrt_device
enum xrt_device_name	name
	Enum identifier of the device.

enum xrt_device_type	device_type

char	str [256]
	A string describing the device.

char	serial [256]
	A unique identifier. Persistent across configurations, if possible.

struct xrt_hmd_parts *	hmd
	Null if this device does not interface with the users head.

struct xrt_tracking_origin *	tracking_origin
	Always set, pointing to the tracking system for this device.

size_t	binding_profile_count
	Number of bindings in xrt_device::binding_profiles.

struct xrt_binding_profile *	binding_profiles

size_t	input_count
	Number of inputs.

struct xrt_input *	inputs
	Array of input structs.

size_t	output_count
	Number of outputs.

struct xrt_output *	outputs
	Array of output structs.

struct xrt_device_supported	supported
	What features/functions/things does this device supports?

xrt_result_t(*	update_inputs )(struct xrt_device *xdev)
	Update any attached inputs.

xrt_result_t(*	get_tracked_pose )(struct xrt_device xdev, enum xrt_input_name name, int64_t at_timestamp_ns, struct xrt_space_relation out_relation)
	Get relationship of a tracked device to the tracking origin space as the base space.

xrt_result_t(*	get_hand_tracking )(struct xrt_device xdev, enum xrt_input_name name, int64_t desired_timestamp_ns, struct xrt_hand_joint_set out_value, int64_t *out_timestamp_ns)
	Get relationship of hand joints to the tracking origin space as the base space.

xrt_result_t(*	get_face_tracking )(struct xrt_device xdev, enum xrt_input_name facial_expression_type, int64_t at_timestamp_ns, struct xrt_facial_expression_set out_value)
	Get the requested blend shape properties & weights for a face tracker.

xrt_result_t(*	get_face_calibration_state_android )(struct xrt_device xdev, bool out_face_is_calibrated)
	Gets the face tracking calibration state.

xrt_result_t(*	get_body_skeleton )(struct xrt_device xdev, enum xrt_input_name body_tracking_type, struct xrt_body_skeleton out_value)
	Get the body skeleton in T-pose, used to query the skeleton hierarchy, scale, proportions etc.

xrt_result_t(*	get_body_joints )(struct xrt_device xdev, enum xrt_input_name body_tracking_type, int64_t desired_timestamp_ns, struct xrt_body_joint_set out_value)
	Get the joint locations for a body tracker.

xrt_result_t(*	reset_body_tracking_calibration_meta )(struct xrt_device *xdev)
	XR_META_body_tracking_calibration - body tracking extension to reset the body tracking calibration.

xrt_result_t(*	set_body_tracking_calibration_override_meta )(struct xrt_device *xdev, float new_body_height)
	XR_META_body_tracking_calibration - body tracking extension to suggest a body tracking calibration override.

xrt_result_t(*	set_output )(struct xrt_device xdev, enum xrt_output_name name, const struct xrt_output_value value)
	Set a output value.

xrt_result_t(*	get_output_limits )(struct xrt_device xdev, struct xrt_output_limits limits)
	Gets limits of this devices outputs.

xrt_result_t(*	get_presence )(struct xrt_device xdev, bool presence)
	Get current presence status of the device.

xrt_result_t(*	begin_plane_detection_ext )(struct xrt_device xdev, const struct xrt_plane_detector_begin_info_ext begin_info, uint64_t plane_detection_id, uint64_t *out_plane_detection_id)
	Begin a plane detection request.

xrt_result_t(*	destroy_plane_detection_ext )(struct xrt_device *xdev, uint64_t plane_detection_id)
	Destroy internal resources associated with plane_detector_id.

xrt_result_t(*	get_plane_detection_state_ext )(struct xrt_device xdev, uint64_t plane_detection_id, enum xrt_plane_detector_state_ext out_state)
	Get the state of a plane detection request.

xrt_result_t(*	get_plane_detections_ext )(struct xrt_device xdev, uint64_t plane_detection_id, struct xrt_plane_detections_ext out_detections)
	Get results of a plane detection request.

xrt_result_t(*	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)
	Get the per-view pose in relation to the view space.

xrt_result_t(*	compute_distortion )(struct xrt_device xdev, uint32_t view, float u, float v, struct xrt_uv_triplet out_result)
	Compute the distortion at a single point.

xrt_result_t(*	get_visibility_mask )(struct xrt_device xdev, enum xrt_visibility_mask_type type, uint32_t view_index, struct xrt_visibility_mask *out_mask)
	Get the visibility mask for this device.

xrt_result_t(*	ref_space_usage )(struct xrt_device *xdev, enum xrt_reference_space_type type, enum xrt_input_name name, bool used)
	Called by the xrt_space_overseer when a reference space that is implemented by this device is first used, or when the last usage of the reference space stops.

bool(*	is_form_factor_available )(struct xrt_device *xdev, enum xrt_form_factor form_factor)
	Check if given form factor is available or not.

xrt_result_t(*	get_battery_status )(struct xrt_device xdev, bool out_present, bool out_charging, float out_charge)
	Get battery status information.

xrt_result_t(*	get_brightness )(struct xrt_device xdev, float out_brightness)
	Get the current display brightness.

xrt_result_t(*	set_brightness )(struct xrt_device *xdev, float brightness, bool relative)
	Set the display brightness.

xrt_result_t(*	get_compositor_info )(struct xrt_device xdev, const struct xrt_device_compositor_mode mode, struct xrt_device_compositor_info *out_info)
	Gets the compositor info for a device for the given mode.

xrt_result_t(*	begin_feature )(struct xrt_device *xdev, enum xrt_device_feature_type type)
	Enable the feature for this device.

xrt_result_t(*	end_feature )(struct xrt_device *xdev, enum xrt_device_feature_type type)
	Disable the feature for this device.

void(*	destroy )(struct xrt_device *xdev)
	Destroy device.

Additional Inherited Members
Static Public Member Functions inherited from xrt_device
static XRT_NONNULL_ALL xrt_result_t	xrt_device_update_inputs (struct xrt_device *xdev)
	Helper function for xrt_device::update_inputs.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_get_tracked_pose (struct xrt_device xdev, enum xrt_input_name name, int64_t at_timestamp_ns, struct xrt_space_relation out_relation)
	Helper function for xrt_device::get_tracked_pose.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_get_hand_tracking (struct xrt_device xdev, enum xrt_input_name name, int64_t desired_timestamp_ns, struct xrt_hand_joint_set out_value, int64_t *out_timestamp_ns)
	Helper function for xrt_device::get_hand_tracking.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_get_face_tracking (struct xrt_device xdev, enum xrt_input_name facial_expression_type, int64_t at_timestamp_ns, struct xrt_facial_expression_set out_value)
	Helper function for xrt_device::get_face_tracking.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_get_face_calibration_state_android (struct xrt_device xdev, bool out_face_is_calibrated)
	Helper function for xrt_device::get_face_calibration_state_android.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_get_body_skeleton (struct xrt_device xdev, enum xrt_input_name body_tracking_type, struct xrt_body_skeleton out_value)
	Helper function for xrt_device::get_body_skeleton.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_get_body_joints (struct xrt_device xdev, enum xrt_input_name body_tracking_type, int64_t desired_timestamp_ns, struct xrt_body_joint_set out_value)
	Helper function for xrt_device::get_body_joints.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_reset_body_tracking_calibration_meta (struct xrt_device *xdev)
	Helper function for xrt_device::reset_body_tracking_calibration_meta.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_set_body_tracking_calibration_override_meta (struct xrt_device *xdev, float new_body_height)
	Helper function for xrt_device::set_body_tracking_calibration_override_meta.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_set_output (struct xrt_device xdev, enum xrt_output_name name, const struct xrt_output_value value)
	Helper function for xrt_device::set_output.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_get_presence (struct xrt_device xdev, bool presence)
	Helper function for xrt_device::get_presence.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_begin_plane_detection_ext (struct xrt_device xdev, const struct xrt_plane_detector_begin_info_ext begin_info, uint64_t plane_detection_id, uint64_t *out_plane_detection_id)
	Helper function for xrt_device::begin_plane_detection_ext.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_destroy_plane_detection_ext (struct xrt_device *xdev, uint64_t plane_detection_id)
	Helper function for xrt_device::destroy_plane_detection_ext.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_get_plane_detection_state_ext (struct xrt_device xdev, uint64_t plane_detection_id, enum xrt_plane_detector_state_ext out_state)
	Helper function for xrt_device::get_plane_detections_ext.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_get_plane_detections_ext (struct xrt_device xdev, uint64_t plane_detection_id, struct xrt_plane_detections_ext out_detections)
	Helper function for xrt_device::get_plane_detections_ext.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_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)
	Helper function for xrt_device::get_view_poses.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_compute_distortion (struct xrt_device xdev, uint32_t view, float u, float v, struct xrt_uv_triplet out_result)
	Helper function for xrt_device::compute_distortion.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_get_visibility_mask (struct xrt_device xdev, enum xrt_visibility_mask_type type, uint32_t view_index, struct xrt_visibility_mask *out_mask)
	Helper function for xrt_device::get_visibility_mask.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_ref_space_usage (struct xrt_device *xdev, enum xrt_reference_space_type type, enum xrt_input_name name, bool used)
	Helper function for xrt_device::ref_space_usage.

static XRT_NONNULL_ALL bool	xrt_device_is_form_factor_available (struct xrt_device *xdev, enum xrt_form_factor form_factor)
	Helper function for xrt_device::is_form_factor_available.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_get_battery_status (struct xrt_device xdev, bool out_present, bool out_charging, float out_charge)
	Helper function for xrt_device::get_battery_status.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_get_brightness (struct xrt_device xdev, float out_brightness)
	Helper function for xrt_device::get_brightness.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_set_brightness (struct xrt_device *xdev, float brightness, bool relative)
	Helper function for xrt_device::set_brightness.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_get_compositor_info (struct xrt_device xdev, const struct xrt_device_compositor_mode mode, struct xrt_device_compositor_info *out_info)
	Helper function for xrt_device::get_compositor_info.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_begin_feature (struct xrt_device *xdev, enum xrt_device_feature_type type)
	Helper function for xrt_device::begin_feature.

static XRT_NONNULL_ALL xrt_result_t	xrt_device_end_feature (struct xrt_device *xdev, enum xrt_device_feature_type type)
	Helper function for xrt_device::end_feature.

static XRT_NONNULL_ALL void	xrt_device_destroy (struct xrt_device **xdev_ptr)
	Helper function for xrt_device::destroy.

static xrt_result_t	ipc_client_xdev_get_plane_detection_state_ext (struct xrt_device xdev, uint64_t plane_detection_id, enum xrt_plane_detector_state_ext out_state)
	Helper function for xrt_device::get_plane_detection_state_ext.

static xrt_result_t	ipc_client_xdev_get_plane_detections_ext (struct xrt_device xdev, uint64_t plane_detection_id, struct xrt_plane_detections_ext out_detections)
	Helper function for xrt_device::get_plane_detections_ext.

Related Symbols inherited from xrt_device
void	u_distortion_mesh_fill_in_compute (struct xrt_device *xdev)
	Given a xrt_device generates meshes by calling xdev->compute_distortion(), populates `xdev->hmd_parts.distortion.mesh` & `xdev->hmd_parts.distortion.models`.

void	u_distortion_mesh_fill_in_none (struct xrt_device *xdev)
	Given a xrt_device generates a no distortion mesh, populates `xdev->hmd_parts.distortion.mesh` & `xdev->hmd_parts.distortion.models`.

void	u_distortion_mesh_set_none (struct xrt_device *xdev)
	Given a xrt_device generates a no distortion mesh, also sets `xdev->compute_distortion()` and populates `xdev->hmd_parts.distortion.mesh` & `xdev->hmd_parts.distortion.models`.

Detailed Description

A single PlayStation Move Controller.

A note about coordinate system. If you stand the controller in front of you so that the ball is pointing upward, buttons towards you. Then think of the ball as a head that is looking away from you. The buttons then are is it's back, the trigger the front.

Translated to axis that means the ball is on the Y+ axis, the buttons on the Z+ axis, the trigger on the Z- axis, the USB port on the Y- axis, the start button on the X+ axis, select button on the X- axis.