3Dconnexion input devices/ru

Установка драйвера

Linux

FreeCAD поддерживает драйверы из проекта Spacenav. Это проект, направленный на создание драйвера с открытым исходным кодом, совместимого с фирменными драйверами от 3Dconnexion.

Установка из репозитория

Ubuntu

sudo apt-get install spacenavd

Обратите внимание, однако, что версия 0.6, доступная на Ubuntu 20.04 (и, вероятно, более старые версии), похоже, не работает. Тогда вам придется скомпилировать spacenavd из исходного кода, как описано ниже.

Fedora

sudo yum install spacenavd

Debian

apt-get install spacenavd libspnav-dev

Spacenav нуждается в следующих разрешениях:

cp ~/.Xauthority /root/

Перезапустите spnavd и FreeCAD

/usr/bin/spnavd_ctl x11 stop
/usr/bin/spnavd_ctl x11 start

openSUSE

sudo zypper install spacenavd

Компиляция Spacenav из исходников

Это рекомендуется делать, если ваш дистрибутив предоставляет устаревшую версию.

• Скачайте следующие файлы:
  • spacenavd (последнюю версию)
  • libspnav (возьмите последнюю версию libspnav)
  • spnavcfg (возьмите последнюю версию libspnav)
• Распакуйте архивы в папку в домашнем каталоге.
• Войдите в каталог spacenavd-x.x и выполните следующие команды:

./configure
make

• Если всё прошло успешно, выполните следующие команды от имени root (или с префиксом sudo).

make install
./setup_init
/etc/init.d/spacenavd start

• Это установит daemon spacenav, настроит его на автоматическую загрузку при загрузке системы и запустит daemon без необходимости перезагрузки.
• Теперь пришло время проверить, правильно ли обнаружено ваше устройство. Не подключая устройство к сети, выполните следующую команду, и только потом подключите его.

tail -n100 -f /var/log/spnavd.log

• Если вывод выглядит похожим образом, можно продолжать.

Device detection, parsing /proc/bus/input/devices
trying alternative detection, querying /dev/input/eventX device names...
  trying "/dev/input/event1" ... Power Button
  trying "/dev/input/event2" ... 3Dconnexion SpaceNavigator
using device: /dev/input/event2
device name: 3Dconnexion SpaceNavigator

• Теперь войдите в каталог libspnav-x.x.x и запустите следующие команды:

./configure
make

• Если make вывалится со следующей ошибкой: ...

fatal error: gtk/gtk.h: No such file or directory

• ... то Вам надо установить libgtkmm-2.4-dev. Под Ubuntu это делается так:

sudo apt-get install libgtkmm-2.4-dev

• Когда make завершится успешно, запустите следующую команду как root (или через sudo.)

make install

• Гляньте в каталог libspnav-x.x.x/examples/. Если Вы хотите протестировать Ваше устройство, скомпилируйте и запустите любой из двух примеров.

• Следуйте той же схеме для компиляции и установки spnavcfg. Обязательно запустите spnavcfg как root, или установки не будут сохранены!

Запуск spacenavd как службы systemd при загрузке

Если вы хотите запустить spacenavd при загрузке с помощью systemd, выполните следующие действия:

• Перейдите в каталог, в который вы клонировали репозиторий spacenavd (в корень репозитория)
• «sudo cp contrib/systemd/spacenavd.service /usr/lib/systemd/system/spacenavd-local.service».
• «sudo systemctl enable spacenavd-local.service»
• «sudo systemctl start spacenavd-local.service», если вы хотите запустить его сразу.

Это необходимо только при установке из исходного кода.

Перезапуск spacenavd

Если иногда SpaceNavigator перестаёт работать, полезно перезапустить драйвер. Чтобы перезапустить его, перейдите в терминал и выполните:

sudo xhost +
sudo /etc/init.d/spacenavd restart

После этого перезапустите FreeCAD. В некоторых дистрибутивах это необходимо при каждой загрузке.

Известные проблемы

A user reported on the forum they saw the following:

 Spacenav daemon 0.6
 failed to open config file /etc/spnavrc: No such file or directory. using defaults.
 adding device.
 device name: 3Dconnexion SpacePilot
 using device: /dev/input/event5
 No protocol specified
 failed to open X11 display ":0.0" 

The workaround that worked for them:

sudo cp ~/.Xauthority /root/
sudo spnavd_ctl x11 start
sudo systemctl restart spacenavd

3Dconnexion input devices are supported on macOS, provided FreeCAD is built and used on a system with the 3Dconnexion drivers installed. You may need 3DxWare 10.7.2 or greater for macOS 12 Monterey.

As of version 0.13, 3D mouse is supported under Windows. You need to have 3Dconnexion drivers installed. In FreeCAD version 1.0 a new integration with 3Dconnexion devices has been introduced. If compiled with that integration, only recent hardware is supported: to support older devices users will need to self-compile with the FREECAD_3DCONNEXION_SUPPORT cMake variable set to "Raw Input". Windows users should be aware that 3Dconnexion's driver (not the code in FreeCAD) contains a telemetry package that communicates information about your installed software back to 3Dconnexion.

Known Issues

• In FreeCAD version 1.0 and later changing settings in the 3DX config window may not have the expected results (issue). To fix this:
  1. Stop the driver (by running Stop 3DxWare).
  2. Go to ..<user>\AppData\Roaming\3Dconnexion\3DxWare\Cfg and delete the FreeCAD.xml file.
  3. Start the driver (by running Start 3DxWare).
  4. Run FreeCAD and check if you can change the Spaceball Motion settings.

1.0 and above: The 3Dconnexion manipulator can be set up in its driver app (3DxWare software).

0.21 and below: If a Spaceball is detected the following tabs in the Customize dialog can be used to change settings:

In this tab you have ability to set up some of general space mouse settings. They include:

• Global Sensitivity - Slider with ability to set global sensitivity
• Dominant - if you enable dominant mode, only axes with highest move will be considered
• Flip YZ - This option enables you to flip Y and Z axes on 3D mouse
• Enable Translations - easy way to enable/disable translations
• Enable Rotations - easy way to enable/disable rotations
• Calibrate - enables you to calibrate space navigator. It is pressed while space navigator is not moved.
• Set To Default - removes all settings and sets them to default.

Кроме этого, для каждой оси есть возможность установить:

• Enabled - разрешить/запретить оси
• Reverse - реверсировать движение по осям
• Sensitivity - слайдер с возможностью установить чувствительность

When you open this tab for the first time, it will be empty and unavailable. To activate it, you must press one of your space mouse buttons. After you do, list of buttons will appear on the left side, and list of commands will be available on the right side.

Для назначения некоторых команд кнопке выделите кнопку слева и её команду справа. Для стирания команды с кнопки нажмите "Clear".

Troubleshooting

Check if your FreeCAD installation links to the spacenav library. The best way to check this is by running FreeCAD from the command line terminal FreeCAD --log-file /tmp/freecad.log and close it immediately again. Then open the file /tmp/freecad.log and search for the messages:

Connected to spacenav daemon

or

Couldn't connect to spacenav daemon. Please ignore if you don't have a spacemouse.

If none of them appears then your FreeCAD build doesn't link to the spacenav library. If the former message appears then it basically works. The latter message means there is probably a problem with the spacenav daemon.

Related

• Forum thread spacenav on Windows
• Forum thread Space navigator axis confusion