304 lines
6.9 KiB
Plaintext
304 lines
6.9 KiB
Plaintext
THE INSPECTOR SOFTDOC
|
||
---------------------
|
||
BROUGHT TO YOU BY DR. ELECTRIC
|
||
|
||
**********
|
||
|
||
THIS SOFTDOC IS BASED ON THE SOFTWARE
|
||
VERSION OF THE INSPECTOR FOR THE
|
||
APPLE II+.
|
||
|
||
GENERAL DESCRIPTION
|
||
-------------------
|
||
|
||
THE INSPECTOR IS A SIMPLE TO USE
|
||
UTILITY WHICH ALLOWS YOU TO EXAMINE AND
|
||
EDIT DATA THAT IS EITHER IN THE APPLE'S
|
||
MEMORY OR ON 3.3 DISKS. ACCORDING TO
|
||
THE INSTRUCTIONS YOU CAN ALSO EDIT DATA
|
||
ON DISKS WITH A NON-STANDARD DOS, BUT
|
||
IN MOST SOFTWARE WITH NONSTANDARD
|
||
SECTOR SIZES THIS IS NOT POSSIBLE.
|
||
|
||
SYSTEM REQUIREMENTS
|
||
-------------------
|
||
|
||
APPLE II+
|
||
16K RAM CARD W/INTBASIC LOADED
|
||
1 DISK DRIVE
|
||
|
||
ACCESSING THE INSPECTOR
|
||
-----------------------
|
||
|
||
TO GET TO THE INSPECTOR, YOU MUST DO
|
||
THE FOLLOWING (AFTER IT'S LOADED):
|
||
|
||
1) CALL-151
|
||
2) TYPE 'C080' THEN C/R,
|
||
3) TYPE 'D800G' AND YOU'RE IN.
|
||
|
||
INSPECTOR DISK COMMANDS
|
||
-----------------------
|
||
|
||
<V> = DOS VERSION
|
||
|
||
SELECTS THE DOS VERSION TO MATCH THE
|
||
VERSION YOU ARE USING ON THE DISK.
|
||
YOU CAN TOGGLE BETWEEN 13 AND 16 SECTOR
|
||
DOS.
|
||
|
||
<P> = PERIPHERAL SLOT
|
||
|
||
SELECTS THE SLOT YOUR DISK CONTROLLER
|
||
IS IN.
|
||
|
||
<D> = DRIVE NUMBER
|
||
|
||
TOGGLES BETWEEN 1 AND 2.
|
||
|
||
<T> = TRACK
|
||
|
||
SELECTS TRACK # TO BE READ. PRESS 'T'
|
||
THEN NUMBER TO READ AND C/R.
|
||
|
||
<S> = SECTOR
|
||
|
||
SELECTS SECTOR # TO BE READ. PRESS 'S'
|
||
THEN NUMBER TO READ AND C/R.
|
||
|
||
NOTE: ALL TRACK, SECTOR AND BUFFER INFO
|
||
MUST BE ENTERED IN HEXADECIMAL.
|
||
|
||
<R> = READ
|
||
|
||
CAUSES PROGRAM TO READ SPECIFIED TRACK
|
||
AND SECTOR. ANY ERRORS ENCOUNTERED ARE
|
||
DISPLAYED IN THE UPPER RIGHT HAND PART
|
||
OF SCREEN.
|
||
|
||
<;> = SCAN FORWARD
|
||
|
||
CAUSES PROGRAM TO READ NEXT SECTOR.
|
||
|
||
<-> = SCAN BACKWARD
|
||
|
||
CAUSES PROGRAM TO READ PREVIOUS SECTOR.
|
||
|
||
<A> = ASCII/HEX DISPLAY
|
||
|
||
TOGGLES BETWEEN ASCII AND HEX DISPLAY.
|
||
|
||
<X> = E(X)CHANGE
|
||
|
||
EXCHANGES FLASHING AND INVERSE WITH
|
||
NORMAL ASCII CHARACTERS. AN ENTIRE
|
||
SCREEN OF FLASING '@'S GETS HARD TO
|
||
READ, SO THIS COMMANDS ACTS AS A GOOD
|
||
FILTER.
|
||
|
||
<E> = EDIT
|
||
|
||
SELECTS THE EDIT MODE SO CHANGE, INSERT
|
||
OR DELETE INFORMATION IN MEMORY FROM
|
||
EITHER THE HEX OR ASCII DISPLAY MODE.
|
||
|
||
FOR HEX NOTATION USE AS FOLLOWS:
|
||
|
||
1) TYPE 'E' TO GET INTO EDIT MODE.
|
||
2) TYPE THE # OF BYTE LOCATION YOU WANT
|
||
TO CHANGE.
|
||
3) TYPE <SPACE>. THE CONTENTS OF THAT
|
||
LOCATION WILL BE DISPLAYED.
|
||
4) TYPE IN THE NEW DATA.
|
||
5) HIT C/R.
|
||
6) TO KEEP EDITING SUCCESSIVE BYTES,
|
||
KEEP PRESSING <SPACE> INSTEAD OF
|
||
RETURN.
|
||
|
||
FOR ASCII NOTATION USE AS FOLLOWS:
|
||
|
||
1) TYPE 'E' TO GET INTO EDIT MODE.
|
||
2) TYPE BYTE LOCATION TO BE CHANGED.
|
||
3) TYPE 'L' IF YOU WANT TO INSERT LOWER
|
||
CASE OR TYPE 'N' IF YOU WANT TO
|
||
INSERT NEGATIVE ASCII (FLASHING) OR
|
||
THE SPACEBAR FOR NORMAL ASCII.
|
||
4) ENTER THE ASCII STRING INTO THE
|
||
DESIRED LOCATIONS.
|
||
5) RETURN TO EXIT EDIT MODE.
|
||
|
||
<CTRL-W> = WRITE
|
||
|
||
WRITES DATA IN BUFFER TO TRACK AND
|
||
SECTOR SPECIFIED.
|
||
|
||
<B> = BUFFER LOCATION
|
||
|
||
SELECTS STARTING DATA BUFFER LOCATION.
|
||
I.E. IF BUFFER IS SET TO $0800, THEN
|
||
DATA READ FROM DISK WILL BE STORED AT
|
||
$800-$8FF. TO SELECT BUFFER, DO THE
|
||
FOLLOWING:
|
||
|
||
1) PRESS 'B' TO SELECT BUFFER MODE.
|
||
2) SELECT BUFFER PAGE YOU WISH TO SEE.
|
||
3) HIT C/R AND DISPLAY WILL SHOW
|
||
CONTENTS OF THIS BUFFER. INSPECTOR
|
||
WILL NOW USE THIS ADDRESS TO READ
|
||
AND WRITE FROM.
|
||
|
||
NOTE:READING DATA INTO BUFFER $0000
|
||
WOULD HAVE UNPREDICTABLE RESULTS... SO
|
||
THE READ AND MAP COMMANDS ARE DISABLED
|
||
WHEN THIS BUFFER IS SELECTED.
|
||
|
||
<CTRL-I> = INCREMENT SECTOR & BUFFER
|
||
|
||
INCREMENTS SECTOR AND BUFFER AT THE
|
||
SAME TIME. GOOD FOR READING A LOT OF
|
||
SECTORS AT ONCE.
|
||
|
||
<M> = MAP
|
||
|
||
TRACK $11, SECTOR $00 WILL BE READ.
|
||
THIS CONTAINS THE VTOC (VOLUME TABLE OF
|
||
CONTENTS). A SECTOR MAP WILL THEN BE
|
||
DISPLAYED SHOWING ANY USED OR UNUSED
|
||
SECTORS ON THE DISK.
|
||
'-' UNUSED SECTOR
|
||
'#' USED SECTOR
|
||
|
||
<N> = NIBBLE READ
|
||
|
||
SELECTS NIBBLE READ MODE WHICH IS MADE
|
||
UP OF TWO FUNCTIONS:
|
||
1) GRAPHICS DISPLAY
|
||
2) NIBBLE DISPLAY MODE
|
||
TO ACCESS THIS FUNCTION, DO THE
|
||
FOLLOWING:
|
||
|
||
1) PRESS 'N' TO GET INTO NIBBLE MODE.
|
||
THE TRACK WILL BE READ AND IN A
|
||
SECOND YOU'LL SEE A GRAPHICS DISPLAY
|
||
OF THE TRACK NIBBLES. THIS MIGHT
|
||
LOOK CONFUSING AT FIRST, BUT SOON
|
||
YOU'LL BE ABLE TO TELL APART 13 AND
|
||
16 SECTOR DISKS. SELF-SYNC BYTES ARE
|
||
SHOWN AS HORIZONTAL WHITE LINES-
|
||
SINCE 13 SECTOR DISKS HAVE MORE SYNC
|
||
BYTES, THERE WILL BE MORE LINES.
|
||
2) HIT C/R, AND YOU'LL SEE A NIBBLE
|
||
DUMP. YOU CAN SCROLL BACKWARDS
|
||
BY HITTING SPACE TO STOP, THEN THE
|
||
LEFT ARROW KEY. PRESSING 'Q' WILL
|
||
TOGGLE BETWEEN FAST AND SLOW DISPLAY
|
||
SPEED. HIT C/R TO EXIT NIBBLE MODE.
|
||
|
||
<^> = READ NIBBLE FOR NEXT TRACK
|
||
|
||
SAME AS <N> BUT INCREMENTS SECTOR
|
||
FIRST.
|
||
|
||
MEMORY COMMANDS
|
||
---------------
|
||
|
||
<H> = HEX/ASCII DUMP
|
||
|
||
DISPLAYS THE HEX/ASCII INFORMATION THAT
|
||
IS IN MEMORY.
|
||
|
||
1) PRESS 'B' TO SELECT BUFFER MODE.
|
||
2) SELECT BUFFER TO VIEW.
|
||
3) PRESS 'H' FOR HEX/ASCII DUMP.
|
||
|
||
YOU CAN THEN PRESS ANY KEY TO
|
||
STOP/START SCROLLING, 'Q' TO TOGGLE
|
||
BETWEEN FAST AND SLOW SCROLLING, OR GO
|
||
BACKWARDS BY STOPPING THE DISPLAY THEN
|
||
LEFT ARROW. C/R TO EXIT THIS MODE.
|
||
|
||
<F> = FIND
|
||
|
||
SELECTS FIND ROUTINE. THIS COMMAND
|
||
ALLOWS YOU TO SEARCH ALL OF MEMORY FOR
|
||
EITHER A HEX OR ASCII STRING. TO USE:
|
||
|
||
1) PRESS 'B' FOR BUFFER MODE.
|
||
2) SET BUFFER TO $0000.
|
||
3) SELECT EITHER HEX OR ASCII DISPLAY
|
||
BY PRESSING 'A'.
|
||
SUPPOSE YOU WANT TO FIND THE STRING
|
||
'HELLO'.
|
||
4) PRESS 'E' FOR EDIT MODE.
|
||
5) ENTER LENGTH OF STRING IN BYTE $00.
|
||
IN THIS EXAMPLE, 5.
|
||
6) ENTER STRING TO SEARCH FOR STARTING
|
||
AT BYTE $01. IN THIS EXAMPLE,
|
||
'HELLO'.
|
||
7) TYPE 'F' TO START THE FIND ROUTINE.
|
||
|
||
ALL LOCATIONS WHERE 'HELLO' IS FOUND
|
||
WILL BE DISPLAYED. ANY KEY WILL STOP/
|
||
START LIST. MAX LENGTH OF STING IS 9
|
||
BYTES ASCII, $0F BYTES HEX.
|
||
|
||
WARNING: DO NOT CHANGE ANY BYTES IN
|
||
BUFFER $0000 ABOVE BYTE $0F. THE APPLE
|
||
USES THIS MEMORY FOR IT'S OWN POINTERS.
|
||
|
||
<L> = LOCATE
|
||
|
||
LOCATE IS VERY SIMILAR TO <F>, EXCEPT
|
||
IT IS USED FOR FINDING STRINGS ON DISK.
|
||
TO USE:
|
||
|
||
FOLLOW THE SAME PROCEDURE AS IN <F>,
|
||
BUT TYPE 'L' INSTEAD OF 'F'. A FLASHING
|
||
'L' WILL APPEAR TO THE RIGHT OF THE
|
||
DRIVE NUMBER. WHEN A SECTOR IS FOUND TO
|
||
CONTAIN THE STRING, THE APPLE WILL
|
||
BEEP. PRESSING 'L' WILL TOGGLE THE
|
||
LOCATE MODE ON AND OFF.
|
||
|
||
MISC. COMMANDS
|
||
--------------
|
||
|
||
<CTRL-Z> = USER COMMAND
|
||
|
||
THIS COMMAND IS INCLUDED SO THAT YOU
|
||
CAN UTILIZE YOUR OWN SUBROUTINES. WHEN
|
||
PRESSED, IT CAUSES A JUMP TO $0300. ANY
|
||
SUBROUTINE CAN BE LOCATED HERE, A
|
||
SCREENDUMP FOR INSTANCE. A SHORT
|
||
SCREENDUMP ROUTINE WILL BE SHOWN AT THE
|
||
END OF THIS SOFTDOC.
|
||
|
||
<CTRL-C> = RETURN TO BASIC
|
||
|
||
THIS RETURNS THE SYSTEM TO BASIC.
|
||
|
||
|
||
** SCREENPRINT ROUTINE **
|
||
|
||
ENTER THE FOLLOWING FROM THE MONITOR
|
||
AND SAVE TO DISK. LOAD BEFORE RUNNING
|
||
INSPECTOR.
|
||
|
||
300:A9 01 20 95 FE 20 8E FD
|
||
308:A9 FF 20 A8 FC A2 00 8A
|
||
310:20 C1 FB A5 28 85 10 A5
|
||
318:29 85 11 A0 00 B1 10 C9
|
||
320:A0 B0 04 69 40 D0 F8 20
|
||
328:3A 03 C8 C0 28 D0 EE 20
|
||
330:8E FD E8 E0 18 D0 D8 4C
|
||
338:93 FE 48 A9 00 85 24 A9
|
||
340:01 20 5B FB 68 4C ED FD
|
||
|
||
TYPING <CTRL-Z> WITH THIS ROUTINE IN
|
||
MEMORY WILL PRINT OUT SCREEN DATA TO
|
||
YOUR PRINTER.
|
||
|
||
=END=
|
||
|
||
|