home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-Update.iso / CDROM / Contents / READMEs / Peanuts-3 / i486 / video / TsengLabsET-4000.README
Encoding:
Text File  |  1996-11-09  |  4.6 KB  |  109 lines
  1. I have produced a patch to the TsengLabs4000 driver to solve a bug setting
  2. the dot-clock. For some reason, the 3.2 driver does not program the Tseng Labs
  3. clock bit which allows access to the extended clocks, such as 65Mhz for
  4. 1024x768. I presume the original hardware tested must power up with the bit set
  5. whereas my ET4000 card (Total Peripherals clone) doesn't. This patch may not
  6. solve your ET4000 problems but if you have the developer version and can't get
  7. your card running, it could be worth the effort.
  8.  
  9. To install the new driver:
  10.  
  11. 1. Decompress the TsengLabsET4000.config.compressed file
  12.  
  13. 2. Log in as root.
  14.  
  15. 3. Rename /NextLibrary/Devices/TsengLabsET4000.config to
  16.    OriginalTsengLabsET4000.config.
  17.  
  18. 4. Copy your new TsengLabsET4000.config into /NextLibrary/Devices
  19.  
  20. 5. Run Config.app, select Display and remove your Default VGA driver (blech)
  21.    then add My Tseng Labs ET4000 from the list of drivers (the original is
  22.    still called Tseng Labs ET4000 - be careful.
  23.  
  24. 6. Save the new configuration, logout and restart the machine. If everything
  25.    worked, you should see a MUCH better image. If not, you'll need to restart 
  26.    with config=Default and BugNeXT about fixing their driver (not me!).
  27.  
  28. 7. Caveat: When closing down the driver to 640x480 mode to tell you its safe
  29.    to turn off the computer, the VGA programming seems to be done by code
  30.    other than the ET4000 driver. Consequently, the extended dot-clock stays
  31.    activated and this final message is smeared across the screen. I don't
  32.    know if this is correct, but SoftPC seems to use the 640x480 code in the
  33.    driver correctly, so I presume the solution for this problem is an update
  34.    to the shutdown code. It's a small price to pay for 1024x768, IMHO :-).
  35.  
  36. The original posted patch follows:
  37.  
  38. The patch is pretty simple:
  39.  
  40. 1. Copy the directory /NextDeveloper/Examples/DriverKit/TsengLabsET4000
  41.  
  42. 2. Patch the file TsengLabsET4000/TsengLabsET4000_reloc.tproj/TsengLabsET4000.m
  43.    (relative to the directory you copied to), in the 
  44. TsengLabsET4000_1024x768x2x60hz_crtControllerRegisters[] array:
  45.  
  46. Old -
  47.     {0x14,0x00}, {0x15,0x04}, {0x16,0x22}, {0x17,0xC3}, {0x18,0xFF},
  48.     {0x33,0x00}, {0x35,0x00},
  49.     {-1, 0}
  50. New -
  51.     {0x14,0x00}, {0x15,0x04}, {0x16,0x22}, {0x17,0xC3}, {0x18,0xFF},
  52.     {0x33,0x00}, {0x34,0x02}, {0x35,0x00},
  53.     {-1, 0}
  54.  
  55. (Should be line 68)
  56.  
  57. and in TsengLabsET4000_640x480_VGA_crtControllerRegisters[] array:
  58. Old -
  59.     {0x33,0x00},
  60.     {-1, 0}
  61. New -
  62.     {0x33,0x00},
  63.     {0x34,0x00},    // Disable the 65Mhz clock
  64.     {-1, 0}
  65.  
  66. (Should be line 237)
  67.  
  68. 3. Edit TsengLabsET4000/English.lproj/Localizable.strings (my apologies to our
  69.    foreign language counterparts, your kilometres may vary :-) and change the
  70.    names to be able to distinguish them from the original driver, say:
  71. "TsengLabsET4000" = "My Tseng Labs ET4000";
  72. "Long Name" = "My Tseng Labs ET4000-Based SuperVGA Video Adapter";
  73.  
  74. 4. Double click TsengLabsET4000/PB.project to bring up Project Builder, click
  75.    Builder and then click Build with the target set to bundle. This should
  76.    recompile the driver and produce TsengLabsET4000.config.
  77.  
  78. 5. Log in as root.
  79.  
  80. 6. Rename /NextLibrary/Devices/TsengLabsET4000.config to
  81.    OriginalTsengLabsET4000.config.
  82.  
  83. 7. Copy your new TsengLabsET4000.config into /NextLibrary/Devices
  84.  
  85. 8. Run Config.app, select Display and remove your Default VGA driver (blech)
  86.    then add My Tseng Labs ET4000 from the list of drivers (the original is
  87.    still called Tseng Labs ET4000 - be careful.
  88.  
  89. 9. Save the new configuration, logout and restart the machine. If everything
  90.    worked, you should see a MUCH better image. If not, you'll need to restart 
  91.    with config=Default and BugNeXT about fixing their driver (not me!).
  92.  
  93. 10. Caveat: When closing down the driver to 640x480 mode to tell you its safe
  94.     to turn off the computer, the VGA programming seems to be done by code
  95.     other than the ET4000 driver. Consequently, the extended dot-clock stays
  96.     activated and this final message is smeared across the screen. I don't
  97.     know if this is correct, but SoftPC seems to use the 640x480 code in the
  98.     driver correctly, so I presume the solution for this problem is an update  
  99.     to the shutdown code. It's a small price to pay for 1024x768, IMHO :-).
  100.  
  101. 11. Email me if these instructions make no sense, and I'll see if I can help.
  102.  
  103. *--=----=----=----=----=----=---====---=----=----=----=----=----=----=--*
  104. Leigh Smith               Home NeXTMail:leigh@psychokiller.dialix.oz.au
  105. Dept of Computer Science  Home Phone:   +61-9-382-3071
  106. University of             NeXTMail:     leigh@thylacine.cs.uwa.edu.au
  107. Western Australia         Phone:        +61-9-380-1945,Fax:+61-9-380-1089
  108. *--=----=----=----=----=----=---====---=----=----=----=----=----=----=--*
  109.