INSTALLATION INSTRUCTIONS FOR 3DxWare FOR Linux (x86_64) - V 1.5.

3 =============================================================================== To install the files for 3DxWare for Unix to the corresponding directories and to run the driver you need root privileges.

Make sure you fulfill the following prerequisites: Linux: kernel 2.6.8 and higher NOTES: With SuSE Linux 10.x the usbfs is not mounted by default. Please make sure you mount the usbfs to get support for the USB controller. To mount USBFS, please do (as root user): mount -t usbfs none /proc/bus/usb You should enter a line for usbfs in your /etc/fstab to have USBFS mounted at boot time. You might also find useful hints about USB on Linux here: http://www.linux-usb.org/USB-guide/c122.html http://www.linux-usb.org/USB-guide/x173.html In some cases some X11 fonts may not have been installed, which are used to draw on the device LCD. Please make sure you have installed the 75 and/or 100DPI fonts for X11. The packages are named for example: xorg-x11-fonts-75dpi-7.2-3.fc8, xorg-x11-fonts-100dpi-7.2-3.fc8 or xorg-x11-fonts-ISO8859-1-100dpi-7.2-8.fc11.noarch, xorg-x11-fonts-ISO8859-1-75dpi-7.2-8.fc11.noarch Packages names may vary depending on the distribution (and version) you are using! The files for the driver are provided with the following archive: Linux: 3dxware-linux-v1-5-3.x86_64.tar.gz

Please save the file 3dxware-linux-v1-5-3.x86_64.tar.gz into the /tmp directory and extract and run the script install-3dxunix.sh: tar xfz 3dxware-linux-v1-5-3.x86_64.tar.gz install-3dxunix.sh ./install-3dxunix.sh If you don't choose during installation the possibility to start the driver during login from the /etc/inittab please make sure the driver is started before you launch your application. For the USB devices start the driver with the following command: Linux:

Linux: /etc/3DxWare/daemon/3dxsrv -d usb

For the serial devices start the driver with: /etc/3DxWare/daemon -d /dev/<serialport> where <serialport> is the name of your serial port to which the device is attached. Example: /etc/3DxWare/daemon/3dxsrv -d /dev/ttyS0 For the start of the driver from the /etc/inittab the following line is added: 3dx:234:respawn:/etc/3DxWare/daemon/3dxsrv -d <port> </dev/null >/dev/null 2>&1 where <port> is the name of the port to which the device is attached.

Demos: After unpacking 3dxware-linux-v1-5-3.x86_64.tar you can find two demos: The cube demo: /tmp/xcube and a value demo: /tmp/xvalue Those are two simple demos that work with the setting "Any Application". You may copy the binaries to your favourite location for binaries. Udev-Scripts: After unpacking 3dxware-linux-v1-5-0.i386.tar you can find two scripts: Start script "udev_3DxSrvStart": /tmp/udev_3DxSrvStart Udev rule "85-3DX_SPP.rule" for SpacePilot PRO: /85-3DX_SPP.rule Put the rule file in "/etc/udev/rules.d/" and the start script into "/etc/3DxWare/daemon". These locations may vary depending on the distribution used and installation favours. Thus the rule file and the start scricpt may to be modified to refelct these indifidual environment. Known issues: - On Red Hat EL 5 the driver will not start from /etc/inittab if root logs in to :0 - the driver has to run with root privileges(or started from the inittab) Reason: Linux doesn't provide write access for standard users to USB devices in /proc/bus/usb - SuSE 10.1 does not have the required USBFS activated/mounted per default. Please get root permissions and mount the filesystem via: mount -t usbfs none /proc/bus/usb For permanent effect, edit the file /etc/fstab and change the line usbfs to usbfs /proc/bus/usb usbfs defaults 0 0 /proc/bus/usb usbfs noauto 0 0

You can find more informations on USBFS at the following pages: http://www.linux-usb.org/USB-guide/x173.html http://www.linux-usb.org/USB-guide/c122.html Supported devices: Space Pilot Pro Space Pilot Space Explorer (Serial, USB) Space Navigator for Notebooks Space Navigator