196 lines
8.1 KiB
Plaintext
196 lines
8.1 KiB
Plaintext
Patching QTERM for your system.
|
||
|
||
The first thing to do is to back QTERM up, and then invoke DDT, SID, ZSID,
|
||
or whatever your local patch utility is, in the following way:
|
||
|
||
A>DDT QTERM.COM
|
||
|
||
DDT (etc.) will read in QTERM, and then prompt. The following is a list of
|
||
patch areas where QTERM should be changed to reflect your system. Some of
|
||
these are mandatory (i.e. QTERM won't work without them), whereas others
|
||
can be changed to null subroutines or empty data without preventing QTERM
|
||
from working, it just won't have all the features available.
|
||
|
||
|
||
1. Modem input status: 0110 - 011F
|
||
|
||
QTERM calls here to check RDR: status. Return with the zero flag set if
|
||
no character is available, or with the zero flag clear if a char is
|
||
available. Generally this can be an input from the usart / sio / dart
|
||
status port followed by an 'and'.
|
||
|
||
2. Read modem character: 0120 - 012F
|
||
|
||
This gets a character from the RDR: port once the input status has decided
|
||
it's there. Return the character in the a register. Generally this can be
|
||
an input from the usart / sio / dart data port.
|
||
|
||
3. Modem output status: 0130 - 013F
|
||
|
||
Check if the PUN: port can accept another character. Return with the zero
|
||
flag set if the PUN: port can't receive a character, or with the zero flag
|
||
clear if the PUN: port is ready. Generally this can be an input from the
|
||
usart / sio / dart status port followed by an 'and'.
|
||
|
||
4. Write modem character: 0140 - 014F
|
||
|
||
Send the character in the a register to the PUN: port. This will only be
|
||
called after the output status routine has returned a non-zero status.
|
||
Generally this can be an output to the usart / sio / dart data port.
|
||
|
||
These first four patches are all necessary for QTERM to work. The next few
|
||
are not necessary, but they will be useful.
|
||
|
||
5. Start break: 0150 - 015F
|
||
End break: 0160 - 016F
|
||
|
||
The start break subroutine at 0150 should initiate a break condition on
|
||
the modem output line, and 0160 should clear the break condition. If these
|
||
are to be omitted, then just put return (C9) instructions at 0150 and 0160.
|
||
|
||
6. Drop DTR: 0170 - 017F
|
||
Restore DTR: 0180 - 018F
|
||
|
||
The drop DTR subroutine causes DTR to be made inactive, and restore DTR
|
||
returns DTR to an active state. If these are to be omitted, then just put
|
||
return (C9) instructions at 0170 and 0180.
|
||
|
||
7. Baud rate setting: 0190 - 019F
|
||
Baud rate table: 01A0 - 01AF
|
||
|
||
These two patch areas work together to allow QTERM to change the baud rate
|
||
of the modem port. The baud rate table holds pairs of bytes for setting the
|
||
baud rate to eight different values: 38400, 19200, 9600, 4800, 2400, 1200,
|
||
600 and 300, in that order. In these pairs, the first byte will be passed
|
||
to the subroutine at 0190, and the second byte is used to enable that baud
|
||
rate: an 0FFH in the second byte enables the rate, and a zero disables.
|
||
So if your system only went up to 9600, (using a value of 1 to get 9600)
|
||
the first six bytes in the table would be:
|
||
|
||
00 00 no value for 38400: disable by the 00
|
||
00 00 no value for 19200: disable by the 00
|
||
01 FF 01 is the value for 9600: enable by the FF
|
||
|
||
In all cases of enabled baud rates, the subroutine at 0190 gets the
|
||
appropriate value in the a register and should use it to set the baud rate.
|
||
If this is to be omitted, then just put a return (C9) instruction at 0190,
|
||
and fill the table from 01A0 to 01AF with 00's.
|
||
|
||
8. Communication mode setting: 01B0 - 01BF
|
||
Communication mode table: 01C0 - 01CB
|
||
|
||
These two patch areas work together to allow QTERM to change the
|
||
communications format of the modem port. The mode table holds bytes for
|
||
setting 12 different formats, selecting number of data bits (7 or 8)
|
||
parity (odd, even, or none) and number of stop bits (1 or 2). In order
|
||
the 12 values are for 7n1, 8n1, 7n2, 8n2, 7e1, 8e1, 7e2, 8e2, 7o1, 8o1,
|
||
7o2, and 8o2. The subroutine at 01A0 gets one of these values in the a
|
||
register and should use it to set the communications mode. If this is to
|
||
be omitted, then just put a return (C9) instruction at 01A0.
|
||
|
||
9. Processor speed: 01CE
|
||
|
||
This is the speed in Mhz that your Z80 runs at: 4, 6 or whatever. For
|
||
a 2.5Mhz cpu, use 2.
|
||
|
||
10. Escape character: 01CF
|
||
|
||
All special functions of QTERM are activated by the use of escape sequences.
|
||
At 01CF is the byte used for the escape character (the default is ^\). Any
|
||
byte can be used, but a little used value is best selected, also using a
|
||
printable character (' ' thru '~') may have undesirable results. Note that to
|
||
transmit the escape value itself, just type it twice.
|
||
|
||
These previous two are necessary.
|
||
|
||
11. Signon message: 01D0 - 01EF
|
||
|
||
This must be a string that identifies your system / terminal. It must be
|
||
present, and is printed when QTERM first starts. As with the previous
|
||
strings it must be terminated by a zero byte.
|
||
|
||
12. Clear screen: 01F0 - 01FF
|
||
|
||
This must be a string that clears the terminal screen, and leaves the
|
||
cursor in the top left hand corner.
|
||
|
||
13. Moveto: 0200 - 022E
|
||
|
||
QTERM requires the ability to move the cursor around the screen. It calls
|
||
this subroutine with the required coordinates in hl: where h is the row,
|
||
and l the column to move to. The top left hand corner of the screen is 0,0;
|
||
and the bottom right corner is 23,79. This subroutine will have to do
|
||
terminal output: at 0109H is a routine that prints a character in the c
|
||
register, and at 010CH is a routine to print a decimal number in hl (mainly
|
||
for the use of vt100 and vt220 compatibles). Note that the above two
|
||
subroutines will destroy all registers, and that this subroutine can also
|
||
destroy all registers.
|
||
|
||
14. Teminal capability bit map: 022F
|
||
|
||
This byte contains one bit set for each of the following terminal
|
||
capabilities:
|
||
|
||
bit 0: (01H) bright (end highlight)
|
||
bit 1: (02H) dim (start highlight)
|
||
bit 2: (04H) delete line
|
||
bit 3: (08H) insert line
|
||
bit 4: (10H) delete character
|
||
bit 5: (20H) insert character
|
||
bit 6: (40H) clear to end of line
|
||
bit 7: (80H) clear to end of screen
|
||
|
||
15. Terminal capability strings: 0230H - 026FH
|
||
|
||
In this area are eight strings, each of which can be at most eight characters
|
||
long. They are the strings to be printed to perform the terminal capabilities
|
||
mentioned above. Each one of them should be terminated by a zero byte. Hence
|
||
at 0230H is the string for dim (start highlight), at 0238H is the string for
|
||
bright (end highlight), etc.; with 0268H being the string for clear to end of
|
||
screen. Programs that use these will check the terminal capability bitmap at
|
||
022FH before using them, to determine if they are available.
|
||
|
||
16. Patch area: 0270H - 02FFH
|
||
|
||
Since the area provided for the above patches is limited, it may be necessary
|
||
to use more space. The block of memory from 0270H to 02FFH is set aside for
|
||
custom patches, this can be used if the individual spaces are not big enough.
|
||
|
||
|
||
Once all the patches have been made, exit the patch program (usually by
|
||
typing ^C), and finish up by saving a new copy of QTERM:
|
||
|
||
A>SAVE 45 QTERMNEW.COM
|
||
|
||
In addition, the patch area only can be saved as follows:
|
||
|
||
A>SAVE 2 QTERMPAT.XXX
|
||
|
||
Which will create a 1/2K file containing all the patches needed to make this
|
||
particular version of QTERM work. By doing this, when a new release of QTERM
|
||
needs to be patched, all that is necessary is to read in the new unpatched
|
||
version with DDT or whatever, then overlay the patch area. This is typically
|
||
done by typing:
|
||
|
||
IQTERMPAT.XXX
|
||
|
||
to DDT, SID, ZSID etc. to set up the command line to read QTERMPAT.XXX, then
|
||
follow this with a:
|
||
|
||
R
|
||
|
||
to read it. This should overlay the saved patch area on the new version,
|
||
hence doing all the patches at once. Then exit DDT with ^C, and do the
|
||
first save shown above to save the new working version.
|
||
|
||
|
||
NOTE: this "overlaying" of patches will NOT work with versions 2.8 and
|
||
earlier, however from 3.0 onwards the patch area is guaranteed not to
|
||
change. To aid in patching from earlier versions, the main changes are:
|
||
1. modification of the baud rate table (expansion from the 4 byte table
|
||
with 300 1200 2400 & 9600 only) to the 16 byte table that covers up
|
||
to 38400, with selective rate enable;
|
||
2. moving the processor speed and escape values;
|
||
3. addition of the terminal capability patch area;
|
||
4. addition of the patch area at 0270 to 02FF;
|
||
|