╔F YOU ARE GOOD AT KEEPING TRACK OF YOUR DATA, PROGRAMS, ETC. THIS 1750 ╥┴═ ─ISK CAN BE AN INVALUABLE TOOL. ╞REQUENTLY USED PROGRAMS AND UTILITIES CAN BE ╙╘┴╙╚ED IN THE EXPANSION MODULE AND ╚I-RES SCREENS CAN BE ALMOST INSTANTANEOUSLY SWAPPED TO CREATE ANIMATION SEQUENCES. ┴ND DATA CAN BE TEMPORARILY STORED AND RETRIEVED IF A NUMBER OF PROGRAMS ARE TO SHARE IT.
╔T IS IMPORTANT TO NOTE THAT SENSITIVE DATA SHOULD ALWAYS BE STORED ON THE DISK SINCE ANY LOSS OF POWER WILL CLEAR THE EXPANSION ╥┴═ AS WELL AS THE MEMORY IN THE 128. ╚OWEVER, A RESET OR ╥UN STOP/╥ESTORE WILL USUALLY LEAVE EVERYTHING IN TACK.
╘HE ┬┴╙╔├ COMMANDS ╙╘┴╙╚ AND ╞┼╘├╚ PROVIDE AN EASY WAY TO HANDLE INFORMATION GOING TO AND FROM THE EXPANSION MODULE.
╙╘┴╙╚ #BYTES,INTSA,EXPSA,EXPB
╞┼╘├╚ #BYTES,INTSA,EXPSA,EXPB
╫HERE: #BYTES = TOTAL NUMBER OF BYTES TO BE TRANSFERRED, INTSA = STARTING ADDRESS OF THE ├128, EXPSA = STARTING ADDRESS OF THE EXPANSION MODULE, EXPB = EXPANSION RAM BANK (0-1 FOR 1700 AND 0-7 FOR 1750).
╔N MACHINE LANGUAGE IT IS NEARLY AS EASY:
╠─┴ #$01 ;SET THE ├128 BASE ADDRESS
╙╘┴ $─╞02 ;LO BYTE
╠─┴ #$1├ ;START OF ┬┴╙╔├ IN THIS EXAMPLE
╙╘┴ $─╞01 ;HI BYTE
;
╠─┴ #$00 ;SET EXPANSION ╥┴═ ADDRESS
╙╘┴ $─╞04 ;LO BYTE
╠─┴ #$00
╙╘┴ $─╞05 ;HI BYTE
╠─┴ #$00
╙╘┴ $─╞06 ;BANK (0-N)
;
╠─┴ #$00 ;# OF BYTES
╙╘┴ $─╞07 ;LO BYTE
╠─┴ #$20 ;8192 BYTES IN THIS EXAMPLE
╙╘┴ $─╞08 ;HI BYTE
;
╠─╪ #$00 ;├128 BANK
╠─┘ #$80 ;─═┴ COMMAND #$80 = ╙╘┴╙╚
; #$81 = ╞┼╘├╚
; #$83 = ╙╫┴╨
; #$84 = ╓┼╥╔╞┘
╩╙╥ $╞╞50 ;EXECUTE ─═┴ COMMAND
╥╘╙ ;RETURN TO YOU PROGRAM
╘HE ├128 MUST BE RUNNING IN 1═HZ WHEN THESE COMMANDS ARE EXECUTED. ╘HE DATA TRANSFER IS INCREDIBLY FAST AND THE LOSS OF TIME IS NEGLIGIBLE.
╘HE ┼XPANSION ╥┴═ PROGRAM IS A USEFUL UTILITY THAT WAS DESIGNED TO HELP MANAGE THE MEMORY IN THE EXPANSION MODULE. ╔T WORKS IN BOTH THE 40 AND 80 COLUMN MODES. ┬┴╙╔├ AND BINARY PROGRAMS CAN BE ╙╘┴╙╚ED AND ╞┼╘├╚ED FROM MAIN MEMORY WITH A FEW SIMPLE KEY STROKES AND PROGRAM FILES ON A DISK CAN BE QUICKLY TRANSFERRED FOR USE LATER DURING YOUR SESSION. (COMMERCIAL PROGRAMS EXCLUDED)
╘O INSTALL THE PROGRAM, TYPE ╥╒╬ "┼╪╨╥┴═.╔╬╘". ╘HIS SETS UP A SMALL MACHINE LANGUAGE PROGRAM AND ┬╠╧┴─'S THE MAIN PROGRAM.
┴FTER THE PROGRAM IS INSTALLED, THE ╞4 KEY (OR ╙┘╙3560) CAN BE USED TO RUN IT AT ANY TIME. ╘HIS CALLS A SMALL PROGRAM AT $0─┼0 WHICH SAVES THE CURRENT MEMORY CONFIGURATION, SWITCHES OUT THE ┬┴╙╔├ INTERPRETER AND RUNS THE MAIN PROGRAM, RESTORING THE CONFIGURATION AT THE TIME OF EXIT. ╘HIS KEY ASSIGNMENT WILL BE LOST IF A SYSTEM RESET IS PERFORMED. ╚OWEVER, THE MAIN PROGRAM WILL REMAIN UNHARMED WHICH RESIDES UNDER THE ├128 ═╧╬╔╘╧╥ AT $┬000. ╔N THE EVENT OF A RESET ╥╒╬ "┼╪╨╥┴═.╔╬╔╘" WILL INSURE ALL THE POINTERS ARE SET PROPERLY AND REASSIGN THE ╞4 KEY.
╫HEN YOU CALL THIS PROGRAM, A MENU WILL BE DISPLAYED IN A WINDOW (THE CONTENTS UNDER THE WINDOW WILL BE RESTORED WHEN YOU EXIT THE PROGRAM). ┘OU CAN CHOOSE EITHER ─╔╙╦ > ┼╪╨, ┼╪╨»>»╚╧╙╘, OR ╚╧╙╘ > ┼╪╨ BY USING THE CURSOR KEYS AND PRESSING ╥┼╘╒╥╬ TO MAKE YOUR SELECTION. ╨RESSING THE ┼╙├ KEY AT ANY TIME WILL ABORT THE CURRENT WINDOW.
─╔╙╦ > ┼╪╨: ╘HIS OPTION WILL INDIVIDUALLY LIST ALL THE ╨╥╟ FILES ON THE DISK AND WAIT FOR A '┘' OR '╬' RESPONSE. '┘' WILL STORE THAT FILE IN THE EXPANSION MODULE AFTER THE ENTIRE LIST OF FILES HAS BEEN MARKED OR THE ╥┼╘╒╥╬ KEY IS PRESSED. ╙┼╤ AND ╥┼╠ FILES ARE NOT INCLUDED BECAUSE OF THEIR SENSITIVITY. ┘OU CAN ╙╘┴╙╚ THEM AFTER THEY HAVE BEEN BROUGHT INTO MAIN MEMORY. ┴ DIRECTORY OF ALL ╙╘┴╙╚ED FILES IS CONTINUALLY UPDATED IN MEMORY. ╬OTE THAT FILES ARE BROUGHT THROUGH THE ┬┴╙╔├ TEXT AREA SO BE SURE THAT NO PROGRAM OR DATA IS IN THERE OR IT WILL BE LOST.
┼╪╨ > ╚╧╙╘: ┴ DIRECTORY OF ALL THE FILES IN THE EXPANSION MODULE WILL BE DISPLAYED. ╙ELECT THE FILE YOU WANT TO ╞┼╘├╚ WITH THE CURSOR KEYS AND PRESS ╥┼╘╒╥╬ TO BRING THE FILE INTO MAIN MEMORY. ┬┴╙╔├ FILES WILL BE RETURNED TO THE LOCATION THEY WERE SAVED FROM. ┬INARY FILES WILL BE LOADED INTO THEIR RESPECTIVE LOCATIONS IN BANK 0. ╘HE DIRECTORY IS LIMITED TO ABOUT THIRTY NAMES.
╚╧╙╘ > ┼╪╨: ╙ELECT EITHER ┬┴╙╔├ OR ┬╔╬┴╥┘ AS THE FILE TYPE TO BE ╙╘┴╙╚ED AND PRESS ╥┼╘╒╥╬. ┼NTER THE FILE NAME AND PRESS ╥┼╘╒╥╬. ╘HE PROGRAM WILL NOT CHECK FOR DUPLICATE NAMES SO YOU MAY HAVE MORE THAN ONE FILE WITH THE SAME NAME. ╘HE PROGRAM WILL IMMEDIATELY RETURN TO THE MAIN MENU WHEN THE ┬┴╙╔├ FILE IS STORED. ╔F THE CHOICE WAS BINARY THEN YOU WILL BE ASKED FOR THE BANK IN WHICH YOUR PROGRAM OR DATA IS STORED AS WELL AS THE STARTING AND ENDING HEX ADDRESSES.
╘O EXIT PRESS THE ┼╙├ KEY. ╥EMEMBER TO GUARD AGAINST THE LOSS OF ANY FILES BY SAVING ANYTHING OF IMPORTANCE TO DISK.
╨ROGRAMS THAT WERE WRITTEN TO ACCESS DATA OR LOAD ANOTHER PROGRAM FROM THE DISK WILL NOT SEARCH THE EXPANSION ╥┴═ MODULE EVEN IF YOU STORED THE DATA THERE.
┴NY COMMENTS ARE WELCOME. ╞EEL FREE TO MODIFY THIS PROGRAM TO ENHANCE IT'S CAPABILITIES. ╨ERHAPS IN A FEW MONTHS WE CAN HAVE A SUPER PROGRAM.
├ONTACT ME ON ╤-╠INK (╩OSEPH╬4) OR ON ╟┼NIE (╩┬╠╒┼)
