GeomagicTouch - Revision history

Mauferrari at 12:40, 16 April 2025

2025-04-16T12:40:43Z

H3ct0r at 15:55, 10 April 2025

2025-04-10T15:55:01Z

H3ct0r at 15:54, 10 April 2025

2025-04-10T15:54:06Z

H3ct0r: Created page with "# This wiki is a copy of https://github.com/jhu-cisst-external/3ds-touch-openhaptics # Introduction The goal of this repository is to facilitate the installation of the GeoM..."

2025-04-10T15:49:01Z

Created page with "# This wiki is a copy of https://github.com/jhu-cisst-external/3ds-touch-openhaptics # Introduction The goal of this repository is to facilitate the installation of the GeoM..."

New page

# This wiki is a copy of https://github.com/jhu-cisst-external/3ds-touch-openhaptics

# Introduction

The goal of this repository is to facilitate the installation of the GeoMagic/3DS Touch hapic device drivers (USB or Ethernet based) as well as the OpenHaptics SDK (education version) on Ubuntu. This was successfuly tested on Ubuntu 18.04 LTS 64 bits with the 2019 drivers. We've had mixed success on Ubuntu 22.04 with the 2022 drivers (see notes below). These scripts are provided to automate the installation process described in https://support.3dsystems.com/s/article/OpenHaptics-for-Linux-Developer-Edition-v34.

You will still need to configure your device following the instructions from: https://s3.amazonaws.com/dl.3dsystems.com/binaries/Sensable/Linux/Installation+Instructions.pdf, skip to step 7 if you installed the drivers using the scripts in this repository.

To install the drivers for older FireWire based devices (Phantom Omni), see https://github.com/jhu-cisst-external/phantom-omni-1394-drivers.

# Which drivers?

2019 drivers are working fine on Ubuntu 18.04 so no need to use the 2022 version. These drivers also work on Ubuntu 20.04 for the ethernet based Touch but hang for USB devices.

2022 drivers work on Ubuntu 20.04 with Ethernet and USB based Touch devices but we ran into issues when setting our own device name in `Touch_Setup`. This might be related to the path used to store the device configuration but we couldn't figure out any working configuration. So we were able to use `hdInitDevice(HD_DEFAULT_DEVICE)` but not `htInitDevice("custom_name")`.

# Instructions

The 4 scripts provided will perform most of the steps required to download/install OR un-install the files required for the Touch drivers as well as the OpenHaptics SDK.

The two install scripts should be executed without `sudo` though sudo privileges are required (you might be prompted for a password). This is so temporary files are not created with root id/gid. Once the install script is done, **you should log out and log back in**. This is so the `GTDD_HOME` environment variable is set correctly. Alternatively, you can also `source /etc/profile.d/3ds-touch-drivers.sh` manually to set the environment variable.

The two uninstall scripts need to be executed with `sudo`.

# Notes

The install is a bit different from the process described in the 3DS instructions:
* There is no need to use `chmod` in the `/dev` directory, just make sure your uid is added to the group with read/write permissions on the directory (commonly used groups are `plugdev`, `dialout` and `lp`)
* Environment variables are set in `/etc/profile.d` instead of `/etc/environment`

← Older revision		Revision as of 12:40, 16 April 2025
Line 31:		Line 31:
	* There is no need to use `chmod` in the `/dev` directory, just make sure your uid is added to the group with read/write permissions on the directory (commonly used groups are `plugdev`, `dialout` and `lp`)		* There is no need to use `chmod` in the `/dev` directory, just make sure your uid is added to the group with read/write permissions on the directory (commonly used groups are `plugdev`, `dialout` and `lp`)
	* Environment variables are set in `/etc/profile.d` instead of `/etc/environment`		* Environment variables are set in `/etc/profile.d` instead of `/etc/environment`
		+
		+
		+	== Dicas para Demo Geomatic Interface Haptica ==
		+	<pre>
		+	1. Ligar interface haptica na tomada
		+
		+	2. ligar adaptador ethernet-usb em uma das portas do notebook
		+
		+	3. Para calibrar e confirmar comunicação com o geomatic touch:
		+
		+	verlab@lenovo1:/opt/geomagic_touch_device_driver$ ./Geomagic_Touch_Diagnostic
		+
		+	4. Os arquivos de exemplos estão em:
		+	verlab@lenovo1:/opt/OpenHaptics/Developer/3.4-0/examples
		+	</pre>
		+	=== Exemplos Interessantes ===
		+	<pre>
		+	- Tocar numa esfera com superficie emborrachada
		+	verlab@lenovo1:/opt/OpenHaptics/Developer/3.4-0/examples/HD/graphics/SlidingContact$ ./SlidingContact
		+
		+
		+	- Atrair por pontos do espaço
		+	verlab@lenovo1:/opt/OpenHaptics/Developer/3.4-0/examples/HD/graphics/PointSnapping$ ./PointSnapping
		+
		+	- Mover e ficar pontos no espaço
		+	verlab@lenovo1:/opt/OpenHaptics/Developer/3.4-0/examples/HD/graphics/PointManipulation$ ./PointManipulation
		+
		+
		+	# Outras demos com texturas
		+	/opt/OpenHaptics/Developer/3.4-0/QuickHaptics/examples/
		+
		+	- Dentista, encontrar cavidade no dente
		+	verlab@lenovo1:/opt/OpenHaptics/Developer/3.4-0/QuickHaptics/examples/TeethCavityPick/TeethCavityPickGLUT$ ./TeethCavityPickGLUT
		+
		+	- Varias peças geometricas com interação. Diferentes texturas: grudando e relevo. É possível clicar e mover os objetos no espaço
		+
		+	verlab@lenovo1:/opt/OpenHaptics/Developer/3.4-0/QuickHaptics/examples/ComplexScene/ComplexSceneGLUT$ ./ComplexSceneGLUT
		+
		+	</pre>

@@ Line 1: / Line 1: @@
 # This wiki is a copy of https://github.com/jhu-cisst-external/3ds-touch-openhaptics
 # Driver 2019: https://www.dropbox.com/scl/fi/qa8l0x56za4k93kq6sk8q/TouchDriver2019_2_15_Linux.tar.xz?rlkey=iwie95m8nbgl0qlnjsx63qzj6&dl=0
 # Driver 2020: https://www.dropbox.com/scl/fi/ozmoyysh3hefdwm1dbgf5/TouchDriver2022_04_04.tgz?rlkey=dguu935jqpck0tlf0it6a2phl&dl=0

← Older revision		Revision as of 15:54, 10 April 2025
Line 1:		Line 1:
	# This wiki is a copy of https://github.com/jhu-cisst-external/3ds-touch-openhaptics		# This wiki is a copy of https://github.com/jhu-cisst-external/3ds-touch-openhaptics
		+	# Driver 2019: https://www.dropbox.com/scl/fi/qa8l0x56za4k93kq6sk8q/TouchDriver2019_2_15_Linux.tar.xz?rlkey=iwie95m8nbgl0qlnjsx63qzj6&dl=0
		+	# Driver 2020: https://www.dropbox.com/scl/fi/ozmoyysh3hefdwm1dbgf5/TouchDriver2022_04_04.tgz?rlkey=dguu935jqpck0tlf0it6a2phl&dl=0

	# Introduction		# Introduction