···436436 TO_ENUM("hand-tracking-unobstructed-right", ROLE_HAND_UNOBSTRUCTED_RIGHT)
437437 TO_ENUM("hand-tracking-conforming-left", ROLE_HAND_CONFORMING_LEFT)
438438 TO_ENUM("hand-tracking-conforming-right", ROLE_HAND_CONFORMING_RIGHT)
439439+ //! *DEPRECATED** following roles name are deprecated, to be removed in the next major version
440440+ TO_ENUM("hand-tracking-left", ROLE_HAND_UNOBSTRUCTED_LEFT)
441441+ TO_ENUM("hand-tracking-right", ROLE_HAND_UNOBSTRUCTED_RIGHT)
439442 {
440443 PE("Invalid role name (%s)", role_name);
441444 return MND_ERROR_INVALID_VALUE;
+16-4
src/xrt/targets/libmonado/monado.h
···2525//! Major version of the API.
2626#define MND_API_VERSION_MAJOR 1
2727//! Minor version of the API.
2828-#define MND_API_VERSION_MINOR 4
2828+#define MND_API_VERSION_MINOR 5
2929//! Patch version of the API.
3030#define MND_API_VERSION_PATCH 0
3131···359359/*!
360360 * Get the device index associated for a given role name.
361361 *
362362+ *
362363 * @param root The libmonado state.
363363- * @param role_name Name of the role, one-of: "head", "left", "right",
364364- * "gamepad", "eyes", "hand-tracking-left", and,
365365- * "hand-tracking-right":
364364+ * @param role_name Name of the role. Possible values are:
365365+ * - "head"
366366+ * - "left"
367367+ * - "right"
368368+ * - "gamepad"
369369+ * - "eyes"
370370+ * - "hand-tracking-unobstructed-[left|right]"
371371+ * - "hand-tracking-conforming-[left|right]"
372372+ *
373373+ * **DEPRECATED**: The role names "hand-tracking-[left|right]"
374374+ * are deprecated as of v1.5. They now map to
375375+ * "hand-tracking-unobstructed-[left|right]" and are
376376+ * scheduled for removal in v2.0.
377377+ *
366378 * @param[out] out_index Pointer to value to populate with the device index
367379 * associated with given role name, -1 if not role is set.
368380 *
+1-1
src/xrt/targets/libmonado/monado.py
···210210 def get_device_roles(self):
211211 role_map = dict()
212212 device_int_id_ptr = self.ffi.new("int32_t *")
213213- for role_name in ["head", "left", "right", "gamepad", "eyes", "hand-tracking-left", "hand-tracking-right"]:
213213+ for role_name in ["head", "left", "right", "gamepad", "eyes", "hand-tracking-unobstructed-left", "hand-tracking-unobstructed-right", "hand-tracking-conforming-left", "hand-tracking-conforming-right"]:
214214 crole_name = role_name.encode('utf-8')
215215 ret = self.lib.mnd_root_get_device_from_role(self.root, crole_name, device_int_id_ptr)
216216 if ret != 0: