ftp.nice.ch/pub/next/system/driver/video/TsengLabsET-4000.README

This is the README for TsengLabsET-4000.config.I.tar.gz [Download] [Browse] [Up]

I have produced a patch to the TsengLabs4000 driver to solve a bug setting
the dot-clock. For some reason, the 3.2 driver does not program the Tseng Labs
clock bit which allows access to the extended clocks, such as 65Mhz for
1024x768. I presume the original hardware tested must power up with the bit set
whereas my ET4000 card (Total Peripherals clone) doesn't. This patch may not
solve your ET4000 problems but if you have the developer version and can't get
your card running, it could be worth the effort.

To install the new driver:

1. Decompress the TsengLabsET4000.config.compressed file

2. Log in as root.

3. Rename /NextLibrary/Devices/TsengLabsET4000.config to
   OriginalTsengLabsET4000.config.

4. Copy your new TsengLabsET4000.config into /NextLibrary/Devices

5. Run Config.app, select Display and remove your Default VGA driver (blech)
   then add My Tseng Labs ET4000 from the list of drivers (the original is
   still called Tseng Labs ET4000 - be careful.

6. Save the new configuration, logout and restart the machine. If everything
   worked, you should see a MUCH better image. If not, you'll need to restart 
   with config=Default and BugNeXT about fixing their driver (not me!).

7. Caveat: When closing down the driver to 640x480 mode to tell you its safe
   to turn off the computer, the VGA programming seems to be done by code
   other than the ET4000 driver. Consequently, the extended dot-clock stays
   activated and this final message is smeared across the screen. I don't
   know if this is correct, but SoftPC seems to use the 640x480 code in the
   driver correctly, so I presume the solution for this problem is an update
   to the shutdown code. It's a small price to pay for 1024x768, IMHO :-).

The original posted patch follows:

The patch is pretty simple:

1. Copy the directory /NextDeveloper/Examples/DriverKit/TsengLabsET4000

2. Patch the file TsengLabsET4000/TsengLabsET4000_reloc.tproj/TsengLabsET4000.m
   (relative to the directory you copied to), in the 
TsengLabsET4000_1024x768x2x60hz_crtControllerRegisters[] array:

Old -
    {0x14,0x00}, {0x15,0x04}, {0x16,0x22}, {0x17,0xC3}, {0x18,0xFF},
    {0x33,0x00}, {0x35,0x00},
    {-1, 0}
New -
    {0x14,0x00}, {0x15,0x04}, {0x16,0x22}, {0x17,0xC3}, {0x18,0xFF},
    {0x33,0x00}, {0x34,0x02}, {0x35,0x00},
    {-1, 0}

(Should be line 68)

and in TsengLabsET4000_640x480_VGA_crtControllerRegisters[] array:
Old -
    {0x33,0x00},
    {-1, 0}
New -
    {0x33,0x00},
    {0x34,0x00},    // Disable the 65Mhz clock
    {-1, 0}

(Should be line 237)

3. Edit TsengLabsET4000/English.lproj/Localizable.strings (my apologies to our
   foreign language counterparts, your kilometres may vary :-) and change the
   names to be able to distinguish them from the original driver, say:
"TsengLabsET4000" = "My Tseng Labs ET4000";
"Long Name" = "My Tseng Labs ET4000-Based SuperVGA Video Adapter";

4. Double click TsengLabsET4000/PB.project to bring up Project Builder, click
   Builder and then click Build with the target set to bundle. This should
   recompile the driver and produce TsengLabsET4000.config.

5. Log in as root.

6. Rename /NextLibrary/Devices/TsengLabsET4000.config to
   OriginalTsengLabsET4000.config.

7. Copy your new TsengLabsET4000.config into /NextLibrary/Devices

8. Run Config.app, select Display and remove your Default VGA driver (blech)
   then add My Tseng Labs ET4000 from the list of drivers (the original is
   still called Tseng Labs ET4000 - be careful.

9. Save the new configuration, logout and restart the machine. If everything
   worked, you should see a MUCH better image. If not, you'll need to restart 
   with config=Default and BugNeXT about fixing their driver (not me!).

10. Caveat: When closing down the driver to 640x480 mode to tell you its safe
    to turn off the computer, the VGA programming seems to be done by code
    other than the ET4000 driver. Consequently, the extended dot-clock stays
    activated and this final message is smeared across the screen. I don't
    know if this is correct, but SoftPC seems to use the 640x480 code in the
    driver correctly, so I presume the solution for this problem is an update  
    to the shutdown code. It's a small price to pay for 1024x768, IMHO :-).

11. Email me if these instructions make no sense, and I'll see if I can help.

*--=----=----=----=----=----=---====---=----=----=----=----=----=----=--*
Leigh Smith               Home NeXTMail:leigh@psychokiller.dialix.oz.au
Dept of Computer Science  Home Phone:   +61-9-382-3071
University of             NeXTMail:     leigh@thylacine.cs.uwa.edu.au
Western Australia         Phone:        +61-9-380-1945,Fax:+61-9-380-1089
*--=----=----=----=----=----=---====---=----=----=----=----=----=----=--*

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