r_interface.h

Go to the documentation of this file.

// Copyright 2020-2023, Collabora, Ltd.
// Copyright 2026, NVIDIA CORPORATION.
// SPDX-License-Identifier: BSL-1.0
/*!
 * @file
 * @brief  Interface to remote driver.
 * @author Jakob Bornecrantz <jakob@collabora.com>
 * @ingroup drv_remote
 */
 
#pragma once
 
// winsock2.h must be included before windows.h, or the winsock interface will be
// defined instead of the winsock2 interface.
// Given that some of the Monado headers could include windows.h, winsock2 is to be
// included before anything else.
// As a consequence, this header must also be the first included in the file using
// it.
#include "xrt/xrt_config_os.h"
#ifdef XRT_OS_WINDOWS
#include <winsock2.h> // For SOCKET
#endif
 
#include "xrt/xrt_defines.h"
#include "util/u_logging.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
 
struct xrt_system_devices;
struct xrt_space_overseer;
struct xrt_session_event_sink;
 
/*!
 * @defgroup drv_remote Remote debugging driver
 * @ingroup drv
 *
 * @brief Driver for creating remote debugging devices.
 */
 
/*!
 * @dir drivers/remote
 *
 * @brief @ref drv_remote files.
 */
 
#ifdef XRT_OS_WINDOWS
/*!
 * The type for a socket descriptor
 *
 * On Windows, this is a SOCKET.
 */
typedef SOCKET r_socket_t;
#else
/*!
 * The type for a socket descriptor
 *
 * On non-Windows, this is a file descriptor.
 */
typedef int r_socket_t;
#endif
 
/*!
 * Header value to be set in the packet.
 *
 * @ingroup drv_remote
 */
#define R_HEADER_VALUE (*(uint64_t *)"mndrmt3\0")
 
/*!
 * Data per controller.
 */
struct r_remote_controller_data
{
        struct xrt_pose pose;
        struct xrt_vec3 linear_velocity;
        struct xrt_vec3 angular_velocity;
 
        float hand_curl[5];
 
        struct xrt_vec1 trigger_value;
        struct xrt_vec1 squeeze_value;
        struct xrt_vec1 squeeze_force;
        struct xrt_vec2 thumbstick;
        struct xrt_vec1 trackpad_force;
        struct xrt_vec2 trackpad;
 
        bool hand_tracking_active;
        bool active;
 
        bool system_click;
        bool system_touch;
        bool a_click;
        bool a_touch;
        bool b_click;
        bool b_touch;
        bool trigger_click;
        bool trigger_touch;
        bool thumbstick_click;
        bool thumbstick_touch;
        bool trackpad_touch;
        bool _pad0;
        bool _pad1;
        bool _pad2;
        // active(2) + bools(11) + pad(3) = 16
};
 
struct r_head_data
{
        struct
        {
                //! The field of view values of this view.
                struct xrt_fov fov;
 
                //! The pose of this view relative to @ref r_head_data::center.
                struct xrt_pose pose;
 
                //! Padded to fov(16) + pose(16 + 12) + 4 = 48
                uint32_t _pad;
        } views[2];
 
        //! The center of the head, in OpenXR terms the view space.
        struct xrt_pose center;
 
        //! Is the per view data valid and should be used?
        bool per_view_data_valid;
 
        //! pose(16 + 12) bool(1) + pad(3) = 32.
        bool _pad0, _pad1, _pad2;
};
 
/*!
 * Remote data sent from the debugger to the hub.
 *
 * @ingroup drv_remote
 */
struct r_remote_data
{
        uint64_t header;
 
        struct r_head_data head;
 
        struct r_remote_controller_data left, right;
};
 
/*!
 * Shared connection.
 *
 * @ingroup drv_remote
 */
struct r_remote_connection
{
        //! Logging level to be used.
        enum u_logging_level log_level;
 
        //! Socket.
        r_socket_t fd;
};
 
/*!
 * Creates the remote system devices.
 *
 * @ingroup drv_remote
 */
xrt_result_t
r_create_devices(uint16_t port, uint32_t view_count, struct xrt_system_devices **out_xsysd);
 
/*!
 * Initializes and connects the connection.
 *
 * @ingroup drv_remote
 */
r_socket_t
r_remote_connection_init(struct r_remote_connection *rc, const char *addr, uint16_t port);
 
int
r_remote_connection_read_one(struct r_remote_connection *rc, struct r_remote_data *data);
 
int
r_remote_connection_write_one(struct r_remote_connection *rc, const struct r_remote_data *data);
 
 
#ifdef __cplusplus
}
#endif