INSTALLATION INSTRUCTIONS FOR 3DxWare FOR AIX 5.2 ML04 (and higher) - V 1.0.1
=============================================================================

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



Make sure you fullfill the following pre-requisites:

	AIX 5:
		AIX 5.2 or higher is required.
		For AIX 52 you will need ML5200-07 or ML5200-04 and APAR IY78349 (can only be applied to ML04 or above)
		For AIX 53 you will need ML5300-03 or APAR IY78350
		The web site URL for IBM fixes is: http://www.ibm.com/servers/eserver/support/unixservers/aixfixes.html

		For USB device support you will need the following AIX filesets:
  		devices.pci.22106474
  		devices.pci.33103500
  		devices.pci.99172704
  		devices.pci.c1110358
  		devices.common.IBM.usb
  		devices.usbif.03000008
		The first four contain drivers for the four different USB host controllers that AIX supports.
		You only need the one that matches your hardware but having them all does no harm. "devices.common.IBM.usb"
		is the USB System Driver and "devices.usbif.03000008" contains the client driver for 3DConnexion devices.




The files for the driver are provided with the following archive:

	AIX 5:
		3DxWare-aix5-v1-0-1.tar.gz




Please save the file 3DxWare-aix5-v1-0-1.tar.gz into the /tmp directory
and run the script install-3dxunix.sh.

If you don't choose during installtion 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:

	AIX 5:
		/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/tty0


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-aix5-v1-0-1.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.