› o=o=o=o=o=› › ____________________________________› › TEXTPRO: MORE EXTENDED BANKS #9› By Frank Walters› ____________________________________› › › NOTE: In order to permit this text› file to be formatted and printed› with TextPRO, inverse characters› will be indicated by brackets: <=>› means inverse =, which is entered› from the keyboard by holding SELECT› when typing the = key. CONTROL› characters must be entered into the› editor by pressing [Esc] first.› [square] brackets indicate key or› key combinations without SELECT› pressed.› › This is a further discussion of› TextPRO v.5.20X (TPX) and use of› extended banks of memory. If your› computer has 128K of RAM or less,› then disregard this article as it› does not apply to your system.› › INTRODUCTION:› › Since my article "TEXTPRO: USING› EXTENDED BANKS" (#7) was written, I› have researched further and found› some additional information› concerning the bank identification› table used by BANKUTIL.ADN. The› purpose of this table is to identify› 16k banks of upper RAM to be used by› TextPRO as additional text buffers,› called "banks" in TextPRO› documention.› › BANKUTIL.ADN identifies up to 64› banks of RAM (16k each) using a› single byte used by PORTB address to› identify each 16k bank of memory.› These identification bytes vary› considerably, depending on which› type of memory upgrade you are› using. The 130XE compatible system› uses inverse to identify four› 16k banks of upper RAM that is the› standard in the 130XE. Ronnie Riche,› the author of TextPRO, included the› 130XE standard PORTB bank› identification bytes in› the main program. TPX 5.20 can only› support 1 Set of 8 banks at a time,› therefore it only has an 8-byte› table of PORTB ID bytes. The 130XE› 4-banks are repeated twice. A user› of an expanded memory Atari must› replace this table with the› appropriate ID bytes for whatever› upgrade system is installed.› › In BANKUTIL.ADN he also included the› same four ID bytes as the first 4 of› 64 total PORTB bytes. In order to› avoid conflicts, he simply repeated› the same four bytes sixteen times as› you can see if you load BANKUTIL.ADN› into the editor. The same table is› also within TOOLS.ADN as part of the› BANKUTIL portion of that Add-in.› When using BANKUTIL from either of› these Add-in modules, the ID bytes› are taken from the 64-byte table and› replace the 8-byte table within› TextPro itself.› › It is left up to the you, the user,› to edit this bank table and› substitute the correct bytes used to› identify the 16k banks of memory you› wish to use with your particular› memory upgrade system. Once you know› what bytes to substitute in this› table, simply change the bytes in› the table and save BANKUTIL to› disk.› › ATARI 130XE COMPATIBLE TABLES:› › Here is the information about PORTB› identification bytes, sent to me by› Lee Barnes of Wild Horse, Colorado.› He is very proficient at RAM› upgrades for Atari computers. He has› tested these with his Peterson 320XE› upgrade computer. Larry Black also› tested them with his similar› upgrade.› › For a 320K XE upgrade, here are the› ID bytes for 8 banks of 16k each,› allowing you to use 8 banks of Set› #1.:› › ATASCII:› › › Note: All ATASCII bytes are INVERSE,› entered in TextPRO editor with› SELECT pressed.› › MODIFYING TPX520.COM AND BANKUTIL:› › In order to use one Set of 8 Banks,› I would simply modify the existing› table in BANKUTIL by changing the› second set of to upper case› . Save BANKUTIL back to disk› with original filename. Then load› TPX into the editor using ,C to load› the whole file into two banks and› [CTRL_F] to find inverse .› Then use [CTRL_A] in TEXT mode to› change the second set to upper case› so it looks like this: .› Then save both banks of TPX to disk› using ,A append feature for the› second bank.› › ACTIVATING UPPER BANKS:› › Assume you have now modified TPX by› inserting the correct ID bytes for› the first 8 banks in your upgrade› system. To utilize your modified› table, insure that the modified› LISTBANK.ADN is the first section of› TEXTPRO.MAX. The original macro file› (TEXTPRO.MAX) should be at the END› of LISTBANK.ADN. Use CTRL_U to› insure the combined file does not› exceed 2000 bytes (the size of the› macro buffer).› › Next Load TextPro from DOS and› LISTBANK.ADN will automatically load› as part of TEXTPRO.MAX.› › Press [SELECT+CTRL_;]. The prompt:› "Use # of Banks (1-8): RETURN to› exit" will appear in the command› line at top of screen. Type "8" and› you should see (1,8) to the right of› the DOS type on the command line.› then press [SELECT+CTRL_B], reply› 'Y' to "Use Banked" and 'Y' to› "Clear Banks" prompts to insure all› 8 banks are cleared. You are ready› to now use Main bank and upper banks› numbered 1 to 8 by TextPRO. [CTRL_;]› should list all 8 banks (and also› Main if using LISTBANK.ADN dated› 7-3-94).› › CREATING A MACRO TO AUTO-CONFIGURE 8› BANKS:› › To automatically activate all 8› banks with TextPro each time you› load it, you can use a macro command› within TEXTPRO.MAX to to do this.› › 1. Load TEXTPRO.MAX in one bank. In› another clear bank, load or type the› following data:› › 64,189,251,56,144,38,129,Clear banks› [RETURN]› 130,Y,Y,20,50,20,49,38,189,130,Y,N,2› ,50,20,49[NO RETURN]› › 2. Below this table press RETURN to› skip a line and use [SHIFT_INSERT]› to insert 255 spaces in the editor.› › 3. Press the [Logo] key for Atascii› Mode.› 4. With cursor on line below the› table, press [SHIFT_TAB] and type› the first number (64) and press› RETURN. A '@' should appear in the› editor.› 5. Move cursor right to next empty› space and repeat step 4, typing next› data item (189), printing an inverse› <=>.› 6. Repeat step 5 until you reach the› text "Clear banks[RETURN]". Just› type the text and press [RETURN],› and then repeat step 5, except› typing the letters "Y" or "N"› instead of using [SHIFT_TAB] for› those items. The last character in› the macro is the number "1". Place› cursor in the next space and press› [SHIFT_DELETE] to remove all spaces› after the "1".› 7. Place cursor on the first byte of› the macro (@) and press [CTRL_D] and› [P] to delete the macro into the› paste buffer.› 8. Switch Banks to the one› containing TEXTPRO.MAX and place› cursor on any line below the end of› LISTBANK.ADN, in the top portion of› the macro segment. Be sure there is› no other macro defined for the [@]› key. i.e. @<=>. If there is, put the› new macro just above it and remove› the old one.› 9. Save the modified TEXTPRO.MAX to› your TextPro disk.› › USING THE 8-BANK MACRO:› › When you load TextPro, you will be› prompted "Clear Banks: Sure? (Y/N)"› Press "Y" the first time you load› TextPro to clear all banks. For› successive loads after exiting to› DOS you my reply "N" and your 8› Banks will be selected but the banks› will retain all previous data. Only› Main bank is automatically cleared› every time you load TextPro.› › USING A RAMDISK WITH 8-BANKS IN› TEXTPRO:› › Still assuming a 320K XE, using› 8-banks for TextPro still 128K of› unused RAM. If your DOS has a› configurable RAMdisk handler then› you can install the handler and› configure it to use the four 16K› unused banks as a RAMdisk. It› depends on the DOS how you must› configure it. Generally the TextPro› banks will be the highest numbered› banks in your upgrade but not› necessarily.› › TOP-DOS:› › Load the XL RAMdisk module and› configure as follows:› › Peterson 320XE or Claudy 320XL:› SIZE: 256K› Bit 5: Y› RAMDISK BANKS: 0,8› (130XE BANKS: 12,16)› › The XL module uses the format› (First,Next) to indicate banks. i.e.› (0,8) means RAMdisk uses First bank› 0 and up to bank 7, with 8 being› Next bank available for TextPro. The› standard 130XE banks are (12,16) and› the extra four banks for TextPRO are› banks (8,12). See TOP-DOS manual› under XL MODULE for v.1.5 Plus.› › MyDOS:› › You configure the RAMdisks from the› DOS menu. See MyDOS docs for how to› specify banks used but use above› TOP-DOS information as a guide. I› did not test this with MyDOS.› › SPARTADOS:› › The recommended RAMdisk handler for› memory upgrades is called PSIRD.COM,› a third party shareware program. It› comes with docs. Try it to configure› the PSIRD.COM using a batch file and› using banks 0,7 for RAMdisk. You› might have to experiment.› › ATARI DOS:› › I am not aware of a configurable› RAMdisk handler for ATARI DOS 2.5› but there may be one out there. You› can still use TextPro with 8 banks› but do not use RAMDISK.COM. Rename› it to RAMDISK, without the .COM so› it will not initialize upon bootup.› › OTHER UPGRADES:› › For upgrades other than the 320XE› and 320XL, I have some untested› PORTB ID bytes which I may include› in some future article. For now, it› is too complicated to inclued them› here.› ____________________________________› › Frank Walters› T.A.C.O. Bell BBS› 11/01/98› › o=o=o=o=o=›