View source for VT100

[[Image:VT100_1.jpg||center]]<br/>

== What is this all about? ==

When the Model 100 was released, it was offered with another product called the Disk Video Interface, which provided dual 5.25 floppy drives and ability to support an 80x25 CRT.  It was well integrated with M100 OS, with several command s that extended BASIC's ability to control the CRT.

The Model 100 lends itself well to an attached terminal acting as a video adapter, and it turns out that a project provided by Geoff Graham of Perth Australia comes very close to fitting the need.
 
http://geoffg.net/terminal.html

This project (plus some minor extensions), combined with some disassembly and reconstruction work on Disk Basic, has yielded a very nice external VGA video solution for Model 100!

Get in touch with me at Twospruces at --the google mail service.

== How to order MVT100 ==

MVT100 is a minor redesign of the original VT100 board.  I offer this as a kit.  The major difference is (1) the upgraded firmware for Model 100 support and (2) I have included an RS-232 connector to simplify interconnection with the Model 100.

<big> How to order  ---></big>[[Ordering Information]]

== Acknowledgements ==

I would like to acknowledge and thank those that have contributed to the project:

'''Ken Pettit''' - for VirtualT, and the core disassembly of Disk Basic

'''Philip Avery''' - for efforts with CP/M and attached Video using the VT100 Adapter

'''Geoff Graham''' - for the original VT100 Terminal Project


== Supported Models ==
*  TRS-80 Model 100, Tandy 102


== Mini How-To ==

Here is a quick summary of how to get this working:

   1.  You need a Geoff VT100 Terminal.  Get one of these, and get my latest firwmware below.
   2.  Flash upgrade my firmware onto it following Geoff's instructions.
       PS - it sorta works stock so you can play around with it, without the firmware update.  
       It just isn't "right".
   3.  Connect a VGA monitor to the VT100 Terminal.  
   4.  Power up the MVT100 Video Adapter with USB or otherwise.
   5.  Configure the MVT100 Video Adapter as follows
       -  57600 baud if using the BCR TTL SERIAL HACK or
       -  19200 8N1 if using normal RS-232.  Don't forget to invert the data (MVT100 config)
   6.  Connect M100 to MVT100 Video Adapter.  If using RS-232, this is fairly straightforward.  
       If using the BCR TTL SERIAL HACK, you need to make a cable
       This is the hardest part.  "Stock" VT100 adapter uses a 4 pin header to connect serial data.
       My board design has a native RS-232.  
       In any case; you gotta sort out how to connect these up.
   7.  Load and install the VT100 Driver into the M100.
   You should be ready to go!  Enter BASIC, type SCREEN 1 (for RS-232) or SCREEN 2 (for BCR/CASSETTE)
   SCREEN 0 returns you to normal screen.  From BASIC, F8 returns to MENU which is always LCD, and from
   there TEXT and TELCOM also use 80x24.


For some fun, you can try the original STARTREK.BAS on the M100!

[[Media:TREK.zip|TREK.BA and TREK.DO]]

    make sure you CLEAR 1000 for variable space
    Also, load the .BA.  The .DO is so large it can't be converted in M100 memory.
    You could load the .DO version using TS-DOS using LOAD"0:TREK.DO"
    Make sure you are in 80 column mode on CRT!

== MVT100 Hardware ==
There are several sources for the original VT100 Adapter, and modified variants.  I have developed a PCB version (MVT100) that is, I think, most convenient for Model T users as it has a native DE-9 connector for serial data connection.

[[Image:MVT100_assembled.jpg||center]]<br/>

Contact me to obtain a kit for MVT100, my variant of the VT100 Adapter, including the controller pre-programmed with the revised firmware.

Other sources are available.  See
http://geoffg.net/terminal.html
and
https://www.tindie.com/products/petrohi/geoffs-vt100-terminal-kit/

Note that these boards need a custom cable to connect with the M100.


    This solution makes good use of the "BCR TTL SERIAL HACK". 
    Why? Because the serial port can be kept for file I/O while driving the
    monitor with direct TTL serial data at 57600.

    CP/M on the Model 100 also leverages this output mechanism for video.

    Please see  <big>[[BCR TTL SERIAL HACK]]</big>  for more information.


=== MVT100 PCB ===

[[Image:MVT100_primary.png||center]]<br/>

[[Image:MVT100_secondary.png||center]]<br/>

=== MVT100 Schematic ===

[[Image:MVT100_V2.png||center]]<br/>

=== Original Geoff VT100 Terminal Schematic ===
...please see http://geoffg.net/terminal.html

== The Software ==

The solution requires some software.  Generally, you require
1.  VT100 Driver software:  stand alone equivalent of "Disk Basic" tailored for the VT100 Adapter
2.  A patched version of the firmware for the VT100 Adapter, needed to enable certain M100 specific functions.

=== VT100 Driver ===

The following table has links to the current VT100 Driver software and source code.


<table border="1">
<tr><td>Model</td><td>Description</td><td>File</td><td>Revision</td></tr>

<tr><td>M100/T102</td><td>VT100 Driver</td><td>[[Media:VT100_b22.zip|VT100 Driver]]</td><td>22</td></tr>
<tr><td>M100/T102</td><td>VT100 Driver</td><td>[[Media:VT100.zip|VT100 Driver]]</td><td>19</td></tr>
<tr><td>M100/T102</td><td>VT100 Driver Source</td><td>[[Media:VT100source.zip|VT100 Driver Source Code]]</td><td>19</td></tr>
<tr><td>support files</td><td>VT100 Driver Source</td><td>[[Media:Files you need.zip|Supporting Source Code]]</td><td>circa 2015</td></tr>
</table>



Installation:

   NOTE: installation of the driver resets the DATE and TIME on your laptop.

   1. load VT100.CO into your Model 100.
   2. Enter BASIC, and issue command
   CLEAR 0, 60000
   3. Return to MENU, cursor over to VT100.CO and hit ENTER.

   The VT100 Driver code is now installed.  You can delete VT100.CO; the code is installed in uppper RAM.
   
I recommend downloading the Disk Video Interface User Guide to learn about how the DVI commands work.
The VT-100 driver is essentially replicates the functionality, with a few differences:

   SCREEN command:
   Format of command is SCREEN X,Y
   X = 0, -> LCD
   X = 1, -> CRT attached to RS-232 port, 19200 8N1
   X = 2, -> CRT attached to "the BCR/Cassette port hack", Serial TTL at 57600 bps

   WIDTH command:  not functional. CRT is pinned at 80x24.

   Also, support for printing the CRT contents to Printer is not implemented.

=== VT100 Driver compatibility with other M100 software ===

VT100 Driver ties into the M100 hooks table including the CHGET hook, which is used by REX.  As a result it is tightly integrated with M100 OS but it is not compatible as it currently stands with other software that also uses these resources.

Hooks that are used by the VT100 Driver are as follows:

    44H		CRT PUT -  called at 14FA in M100			
    40H		CRT OPEN  -  called at 14F8 in M100						
    08H		RST 4 -- Print A to SCREEN - called at 4317 in M100, starting at RST4 / 4B44		
    04H		CHGET - called at 12D4 (CHGET routine - wait for keyboard input)			
    3CH		Initialize LCD/DVI - called from level 3 character print			
    3EH		SCREEN - called from 1E50
    00H		CLEAR
    02H		MAXRAM


Here's some examples of incompatible programs:

   Any option ROM that uses hooks may be incompatible
   REX - not currently supported
   TS-DOS: incompatible with SCREEN 1 or 2.  Seems to work with SCREEN 0.  Not really tested.

=== MVT100 Terminal Firmware Update ===

I based the Model 100 variant of the firmware on Version 1.3 as posted by Geoff at his site.
I have two files here:  (1) the firmware itself, ready to load into an existing VT100 and (2) the modified project.  The modified firmware is compatible with both the original Geoff VT100 terminal as well as my board of course.

I followed Geoff's guidance for tools etc. needed to build the firmware.

I recommend that anyone looking to reflash an existing VT100 Adapter, please follow the instructions at Geoff's site.
You do not need a programmer; you need to connection via USB to a Windows PC and run the Micrchip Bootloader application.



'''December 23, 2020 Release  V1.3.2_SA Build 22'''
   Changes:
   1) modified scrollup/down to work better with TEXT

<table border="1">
<tr><td>What is it</td><td>Description</td><td>File</td><td>Revision</td></tr>
<tr><td>MVT100 Adapter Firmware</td><td>Modified V1.3 firmware / M100 support </td><td>[[Media:MVT100_FW_V132SA.zip|MVT100 Firmware]]</td><td>23</td></tr>
</table>




'''Original Release  V1.3.1_SA:'''

<table border="1">
<tr><td>What is it</td><td>Description</td><td>File</td><td>Revision</td></tr>
<tr><td>MVT100 Adapter Firmware</td><td>Modified V1.3 firmware / M100 support </td><td>[[Media:VT100_FW.zip|MVT100 Firmware]]</td><td>19</td></tr>
<tr><td>MVT100 Adapter Project</td><td>Modified V1.3 Project files/ M100 support </td><td>[[Media:VT100_project.zip|MVT100 Terminal Project]]</td><td>19</td></tr>
</table>



For convenience, I post here two items:

Instructions for upgrading the firmware of the VT100 Terminal via USB
    [[Media:Instructions.zip|Upgrade Instructions]]


The PC utility from Microchip for connecting to and flashing the controller chip
    [[Media:utility.zip|Upgrade Utility]]

=== Comments about VT100 Terminal support for Model 100 ===

VT100 character set is only set up for ASCII 127 and lower.  The extended character set of the Model 100 is not supported.  If someone feels motivated, what is needed is a new Fonts.h file that contains a new character set.
VT100 uses a 6x12 pattern while M100 uses 5x8.  So some surgery needed there.


The Model 100 uses ESCape codes to manage the CRT. Those are published in the DVI manual.
Many of the codes could be mapped to the codes supported by VT100.  
6 codes however were not available in VT100, so that's why new firmware was needed.


    ; escape code mappings
    ;				ModelT		extended	Stock VT100
    ;                            ------          --------        -----------
    ;	double ESC trap		X		eliminated in VT100 driver.
    ;	home			0BH				[H
    ; 	cls			0CH				[2J + [H
    ; 	lock line 8		T		[T
    ;	unlock line 8		U		[U
    ;	lock scroll		V		[V
    ;	unlock scroll		W		[W
    ; 	turn on cursor		P				[?25h
    ; 	turn off cursor		Q				[?25l
    ;	delete line@cursor	M		[M		
    ;	insert blank line	L		[L
    ; 	erase to EOL		K				[K
    ; 	set reverse char	p				[7m
    ; 	reset reverse char	q				[0m
    ;	cursor up		A				[A
    ;	cursor down		B				[B
    ;	cursor right		C				[C
    ;	cursor left		D				[D
    ;	erase to end of page	J				[J
    ;	set cursor location	Y,c,r				[<v>;<h>f
    ; 	cls			E				[2J + [H			
    ;	cls		 	j				[2J + [H			
    ;	erase current line	I				[2K
    ;	vertical tab		H				[H


Other notes:
   I changed the cursor to be a block rather than a line.




[[Category:Model T Video]]