PublicInstallation.rtf

This is PublicInstallation.rtf in view mode; [Download] [Up]

WacomTablet (version 3.36i)
24th April 1996

THIS SOFTWARE IS PROVIDED BY CAMBRIDGE ANIMATION SYSTEMS LTD AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL CAMBRIDGE ANIMATION SYSTEMS LTD OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Now that's out of the way we can get on with the driver.

Systems Supported

This driver is designed to work only with NEXTSTEP 3.3 for Intel processors. I believe there are other drivers for NEXTSTEP 3.2.

If you do have any problems with the driver then feel free to e-mail tablet_support@cam-ani.co.uk. We cannot guarentee to help but we will try. Please do NOT contact Wacom about any problems with this driver. They did not write it, wont support it and will send you back to us.

These notes are lifted from those supplied to customers of CAS (non technical) so they may appear a little patronising...

Tablets Supported

The following Wacom tablets are currently supported (although not all tested)

SD010L, SD110L,SD510,SD210,SD310L,SD310E, SD320, SD420,SD013A,SD113A,
UD series (ArtPad etc), PL100V, MS200X, KT series

If yours isn't on the list, let us know and we'll see what we can do.

New Features

Support has been added for pressure mode. There are options in the instance table of the driver for setting pressure mode as default and the pressure threshold (between 0 and 255). Note, when pressure mode is on, the side switch is disabled.

Support has been added for multi-headed displays. There are four different modes that are supported. "Widescreen" scales the coordinates so the entire tablet surface is mapped to cover the entire screen. "Letterbox" fits the screen onto the tablet keeping x/y scales the same. "Screen0" and "Screen1" set the tablet to be mapped to the relavent screen. If you have more than two screens let me know.... In letterbox mode, the screen may be aligned to use either the "Top", "Middle" or "Bottom" section of the tablet. This allows you to hang your keyboard over the top/bottom of the tablet.

There is now a command line utility to change tablet parameters without having to reboot. This doesn't work properly when changing screen<-> tablet mappings so use with care.

Installation

In addition to these notes, you should have a driver named WacomTablet.config. This should be Wacom Tablet Driver (3.36i). You may also need the Mux.config driver or NeXTs latest serial drivers if following configuration 1. This is available via ftp from ftp.cs.orst.edu

The following configuration options assume you have a reasonably standard configuration and are not using any third party serial drivers (other than the Mux driver).

The driver requires a physical serial port to itself either by using one of the existing serial ports controlled by the SerialPorts driver or buying a new serial card just for the tablet.

There are two alternative configurations depending on the number of serial devices you wish to attach to your machine. The standard serial devices are tablet, modem and serial mouse. The second configuration using a second serial card will allow you to use four devices at once.

Configuration 1

If you only need to use two serial devices, usually a modem and a tablet, then this configuration is probably the best.

Warning: If you get the following configuration wrong, you can leave your machine
in a state where it will not boot (however with help it is recoverable...). Read
all the following notes thoroughly before attempting the upgrade.

Stage1: Removing the existing driver
If you are upgrading rather than installing a new tablet then you will need to
remove the old driver cleanly.

1. Run the Configure.app application.
A panel will appear showing your system configuration.
2. If you already have a tablet driver installed, it will appear under the
Pointing Device entry.
3. If so, select the mouse icon, select the Wacom Tablet driver and click on Remove.
The tablet driver should disappear from the list
4. Click on Done
You should now see the system summary again. This time the Wacom driver
should not be present in the Pointing Device list.
5. Click on Save and for good measure quit Configure.

Stage 2: Replacing the Serial Ports driver
Because the serial ports driver expects to have two ports, you need to replace it
with the Mux driver which is happy with one.

1. Double-click on the Mux.config file.
This will run Configure and attempt to install the driver. It will tell you if it is
successful.
2. Select the Other (rightmost) icon on the configure panel
You will see a list of devices.
3. Click on Add
A panel will appear containing a list of drivers.
4. Select the driver named Multi-Channel Serial Driver (v1.7) and click on Add. If
you cannot see the driver, make sure the Show All Installed Drivers option is
selected.
A panel will appear telling you there are conflicts. This is normal as both the Mux
driver and the SerialPorts driver are trying to control the serial ports.
5. Select the driver named On-Board SerialPorts and click remove
The conflicts panel should now be empty.
6. Click on Done
You should now see the system summary again.
7. Click on Save and for good measure quit Configure.

Stage 3: Installing the new Tablet driver
This procedure installs the new tablet driver so the tablet will work.

1. Double-click on the WacomTablet.config file.
This will run Configure and attempt to install the driver. It will tell you if it is
successful.
2. Select the mouse icon on the configure panel to take you to the Pointing Device
panel
You will see a device for the type of mouse you are using
3. Click on Add
A panel will appear containing a list of drivers.
4. Select the driver named Wacom Tablet (v3.36i) and click on Add.
The panel should now show both the mouse and the tablet drivers. You should
not get any device conficts at this point. If you do then something is wrong.
5. Click on Done
You should now see the system summary again.The Pointing Device entry
should contain one mouse and one Wacom Tablet entry.
6. Click on Save and quit Configure.
7. Plug the tablet into serial port 2 and switch it on.
8. Reboot your machine.

Configuration 2

If you wish to use three or more serial devices then the following configuration is needed. You will need to install an extra serial port card. This procedure is not described here in detail. The ports will need to be configured as COM3 and if needed COM4. You will need to know the irq and port addresses for each port and they should not clash with any existing irqs or ports (if you don't understand this then someone else will need to do the installation). The card should be installed before any of the following configuration is undertaken.

Stage 1: Removing the existing driver
If you are upgrading rather than installing a new tablet then you will need to
remove the old driver cleanly.

1. log in as root
2. Run the Configure.app application.
A panel will appear showing your system configuration.
3. If you already have a tablet driver installed, it will appear under the
Pointing Device entry.
4. If so, select the mouse icon, select the Wacom Tablet driver and click on Remove.
The tablet driver should disappear from the list
5. Click on Done
You should now see the system summary again. This time the Wacom driver
should not be present in the Pointing Device list.
6. Click on Save and for good measure quit Configure.

Stage 2: Installing the new Tablet driver
This procedure installs the new tablet driver so the tablet will work.
1. Double-click on the WacomTablet.config file.
This will run Configure and attempt to install the driver. It will tell you if it is
successful.
2. Select the mouse icon on the configure panel to take you to the Pointing Device
panel
You will see a device for the type of mouse you are using
3. Click on Add
A panel will appear containing a list of drivers.
4. Select the driver named Wacom Tablet (v3.36i) and click on Add.
The panel should now show both the mouse and the tablet drivers. You will also
get a panel telling you that there are device conflicts. This is because by default
the driver expects to use serial port 2.
5. Select the driver named Wacom Tablet (v3.36i).
You should see information on the irq and port used by the tablet driver.
6. Change the irq and port to match those of the port you wish to install the tablet on.
The conflicts should go away. If they do not, then the irq or port that is conflicting
will have to be changed on the card.
7. Click on Done
You should now see the system summary again.The Pointing Device entry
should contain one mouse and one Wacom Tablet entry.
8. Click on Save and quit Configure.
9. Plug the tablet into the serial port you have selected and switch it on.
10. Reboot your machine.

Troubleshooting

If you can't get the tablet to work then you can add the following entry to the Instance0.table in the driver config. You'll need to be root to do this:

"Debug" = "Messages";

This will turn on extra messages during driver config in /usr/adm/messages when you reboot. Most of them are pretty useless but may give an indication of the problem. If you're still stuck, email me all the lines beginning +++ WacomTablet and I'll see what I can do.

These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.