Home » Personal collection » Acorn ADFS disks » Electron_User_Group » EUG_31.ADF » F/+HINT2
F/+HINT2
This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.
Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.
| Tape/disk: | Home » Personal collection » Acorn ADFS disks » Electron_User_Group » EUG_31.ADF |
| Filename: | F/+HINT2 |
| Read OK: | ✔ |
| File size: | 166F bytes |
| Load address: | 2B204556 |
| Exec address: | 544E4948 |
File contents
&EB (235)
Return presence of Speech Processor.
X = &FF if Speech Processor present
X = &00 if Speech Processor not present
&F1 (241)
Read/Write *FX1 value.
&F5 (245)
Read/Write *FX5 value.
&F6 (246)
Read/Write *FX6 value.
THESE THREE CALLS OPERATE AS DESCRIBED IN THE USER GUIDE ON PAGE 438.
&FC (252)
Reads ID of current language, a number from 0 to 15 which indicates which
socket the presently selected language ROM is in. The sockets are numbered
from right to left starting at 15. On board sockets are 15, 14, 13, 12; and
the remainder can be installed offboard. This call may not be meaningful
from a Second Processor, since there may not necessarily be a current
language in this case.
&FD (253)
Returns a number indicating what sort of reset last occurred:
0 = Soft Break
1 = Power-on Break
2 = CTRL Break
&FE (254)
Read/Write available RAM in BBC microcomputer (even when called from Second
Processor).
128 = 32K
64 = 16K
&FF (255)
Read/Write start up option byte. This allows the keyboard link value to be
read: it may be written to, but the value will be reset to the actual wired
value on any reset other than a soft-reset. The links are configured as
follows:
1 2 3 4 5 6 7 8
X X D D B M M M
2 1 3 2 1
D2, D1 : Disc configuration bits (see Disc Manual).
B : Auto-boot select (Auto-boot when fitted).
M3, M2, M1 : Screen mode on hard reset (0-7)
X : Unused.
-----------------------------------------------------------------------------
Connecting Joysticks To The BBC Micro
-----------------------------------------------------------------------------
On the rear panel of the BBC Micro an Analogue port is provided for
customers who wish to interface various peripherals to their machines, the
most common of which are Joysticks or Games Paddles.
The circuit diagram shows a view of the 15 way 'D' type connector seen from
the outside of the machine, along with the connections for the four
potentiometers and two fire buttons needed to configure a pair of joysticks.
The potentiometers shown in the diagram should be of approximately 10k in
value and the fire buttons are simple switches which are open when at rest.
The actual construction of the joystick itself is entirely at the users
discretion but it is recommended that they are self centering.
To enable the use of the joysticks a full understanding of the "ADVAL"
command is necessary, this is detailed on page 202 of the User Guide. There
are also four OSBYTE calls that are used whilst reading from the ADC, these
are OSBYTES &80, &BC, &BD and &BE (page 418 BBC User Guide). Only the first
of these calls is documented in the User Guide, the other three enable you
to read the ADC channel NO., read the maximum ADC channel No, and read the
ADC conversion type, either 12 or 8 bits respectively.
-----------------------------------------------------------------------------
Advanced Disc Filing System User Guide - Addendum
-----------------------------------------------------------------------------
Please note the following changes to the Advanced Disc Filing System (ADFS)
User Guide:
Chapter 9 - The Filing System Utilities
The ADFS Utilities Disc supplied is an enhanced version of the disc
described in chapter 9. The number of utilities has been increased and the
disc incorporates a menu for ease of selection.
The utilities are each described in detail of the disc by means of a 'Help'
facility and are summarised below.
*AFORM - formats a floppy disc in ADFS format.
*BACKUP - copies all the contents of one disc onto another.
CATALL - a BASIC program which produces a listing of the contents of all the
directories on a disc in a similar form to that given by the *CAT command.
COPYFILES - a BASIC program used to copy files from one filing system to
another.
DIRCOPY - a BASIC program which copies the entire contents of a specified
ADFS source directory, and all its sub-directories, to a specified
destination directory.
EXALL - similar to CATALL, but displays information similar to that given by
the *EX and *INFO commands. A BASIC program.
HARDERROR - this BASIC program enables permanent floppy disc errors to be
ignored by the ADFS, thus avoiding the "Disc Error" message which would be
generated when the bad track is accessed.
RECOVER - this BASIC program enables a file, or part of a file, which has
been deleted accidentally using the *DELETE command, to be recovered.
*VERIFY - verifies a disc by checking each sector to determine if it is
readable.
To use the Utilities disc, insert it into the drive (the top drive on dual
drives) and, whilst holding down SHIFT and A, press and release BREAK. The
Utilities Menu will appear as follows:
Utilities Menu
f0 - Aform
f1 - Backup
f2 - Catall
f3 - Copyfiles
f4 - Dircopy
f5 - Exall
f6 - Harderror
f7 - Recover
f8 - Verify
f9 - End
Press:-
Function keys to run Utilities
Shift-function keys for help
where End will stop the menu program and return you to BASIC.
When using the Help facility (SHIFT + <function key>), use SHIFT to scroll
to the end of the text.
To use individual programs, without recourse to the menu, insert the disc
into a drive and select the drive using a *DIR or *MOUNT instruction. Type
*LIB. LIBRARY to set the library. For machine-code programs, simply type:
*<filename> RETURN
as indicated above. For BASIC programs, type:
CH. "$ UTILITIES.<filename>" RETURN
00000000 0d 0d 26 45 42 20 20 28 32 33 35 29 0d 52 65 74 |..&EB (235).Ret| 00000010 75 72 6e 20 70 72 65 73 65 6e 63 65 20 6f 66 20 |urn presence of | 00000020 53 70 65 65 63 68 20 50 72 6f 63 65 73 73 6f 72 |Speech Processor| 00000030 2e 0d 0d 20 20 20 20 20 20 20 20 58 20 3d 20 26 |... X = &| 00000040 46 46 20 69 66 20 53 70 65 65 63 68 20 50 72 6f |FF if Speech Pro| 00000050 63 65 73 73 6f 72 20 70 72 65 73 65 6e 74 0d 20 |cessor present. | 00000060 20 20 20 20 20 20 20 58 20 3d 20 26 30 30 20 69 | X = &00 i| 00000070 66 20 53 70 65 65 63 68 20 50 72 6f 63 65 73 73 |f Speech Process| 00000080 6f 72 20 6e 6f 74 20 70 72 65 73 65 6e 74 0d 0d |or not present..| 00000090 0d 26 46 31 20 20 28 32 34 31 29 0d 52 65 61 64 |.&F1 (241).Read| 000000a0 2f 57 72 69 74 65 20 2a 46 58 31 20 76 61 6c 75 |/Write *FX1 valu| 000000b0 65 2e 0d 0d 0d 26 46 35 20 20 28 32 34 35 29 0d |e....&F5 (245).| 000000c0 52 65 61 64 2f 57 72 69 74 65 20 2a 46 58 35 20 |Read/Write *FX5 | 000000d0 76 61 6c 75 65 2e 0d 0d 0d 0d 0d 26 46 36 20 20 |value......&F6 | 000000e0 28 32 34 36 29 0d 52 65 61 64 2f 57 72 69 74 65 |(246).Read/Write| 000000f0 20 2a 46 58 36 20 76 61 6c 75 65 2e 0d 0d 54 48 | *FX6 value...TH| 00000100 45 53 45 20 54 48 52 45 45 20 43 41 4c 4c 53 20 |ESE THREE CALLS | 00000110 4f 50 45 52 41 54 45 20 41 53 20 44 45 53 43 52 |OPERATE AS DESCR| 00000120 49 42 45 44 20 49 4e 20 54 48 45 20 55 53 45 52 |IBED IN THE USER| 00000130 20 47 55 49 44 45 20 4f 4e 20 50 41 47 45 20 34 | GUIDE ON PAGE 4| 00000140 33 38 2e 0d 0d 0d 26 46 43 20 20 28 32 35 32 29 |38....&FC (252)| 00000150 0d 52 65 61 64 73 20 49 44 20 6f 66 20 63 75 72 |.Reads ID of cur| 00000160 72 65 6e 74 20 6c 61 6e 67 75 61 67 65 2c 20 61 |rent language, a| 00000170 20 6e 75 6d 62 65 72 20 66 72 6f 6d 20 30 20 74 | number from 0 t| 00000180 6f 20 31 35 20 77 68 69 63 68 20 69 6e 64 69 63 |o 15 which indic| 00000190 61 74 65 73 20 77 68 69 63 68 0d 73 6f 63 6b 65 |ates which.socke| 000001a0 74 20 74 68 65 20 70 72 65 73 65 6e 74 6c 79 20 |t the presently | 000001b0 73 65 6c 65 63 74 65 64 20 6c 61 6e 67 75 61 67 |selected languag| 000001c0 65 20 52 4f 4d 20 69 73 20 69 6e 2e 20 54 68 65 |e ROM is in. The| 000001d0 20 73 6f 63 6b 65 74 73 20 61 72 65 20 6e 75 6d | sockets are num| 000001e0 62 65 72 65 64 0d 66 72 6f 6d 20 72 69 67 68 74 |bered.from right| 000001f0 20 74 6f 20 6c 65 66 74 20 73 74 61 72 74 69 6e | to left startin| 00000200 67 20 61 74 20 31 35 2e 20 4f 6e 20 62 6f 61 72 |g at 15. On boar| 00000210 64 20 73 6f 63 6b 65 74 73 20 61 72 65 20 31 35 |d sockets are 15| 00000220 2c 20 31 34 2c 20 31 33 2c 20 31 32 3b 20 61 6e |, 14, 13, 12; an| 00000230 64 0d 74 68 65 20 72 65 6d 61 69 6e 64 65 72 20 |d.the remainder | 00000240 63 61 6e 20 62 65 20 69 6e 73 74 61 6c 6c 65 64 |can be installed| 00000250 20 6f 66 66 62 6f 61 72 64 2e 20 54 68 69 73 20 | offboard. This | 00000260 63 61 6c 6c 20 6d 61 79 20 6e 6f 74 20 62 65 20 |call may not be | 00000270 6d 65 61 6e 69 6e 67 66 75 6c 0d 66 72 6f 6d 20 |meaningful.from | 00000280 61 20 53 65 63 6f 6e 64 20 50 72 6f 63 65 73 73 |a Second Process| 00000290 6f 72 2c 20 73 69 6e 63 65 20 74 68 65 72 65 20 |or, since there | 000002a0 6d 61 79 20 6e 6f 74 20 6e 65 63 65 73 73 61 72 |may not necessar| 000002b0 69 6c 79 20 62 65 20 61 20 63 75 72 72 65 6e 74 |ily be a current| 000002c0 0d 6c 61 6e 67 75 61 67 65 20 69 6e 20 74 68 69 |.language in thi| 000002d0 73 20 63 61 73 65 2e 0d 0d 0d 26 46 44 20 20 28 |s case....&FD (| 000002e0 32 35 33 29 0d 52 65 74 75 72 6e 73 20 61 20 6e |253).Returns a n| 000002f0 75 6d 62 65 72 20 69 6e 64 69 63 61 74 69 6e 67 |umber indicating| 00000300 20 77 68 61 74 20 73 6f 72 74 20 6f 66 20 72 65 | what sort of re| 00000310 73 65 74 20 6c 61 73 74 20 6f 63 63 75 72 72 65 |set last occurre| 00000320 64 3a 0d 0d 20 20 20 20 20 20 20 20 30 20 3d 20 |d:.. 0 = | 00000330 53 6f 66 74 20 42 72 65 61 6b 0d 20 20 20 20 20 |Soft Break. | 00000340 20 20 20 31 20 3d 20 50 6f 77 65 72 2d 6f 6e 20 | 1 = Power-on | 00000350 42 72 65 61 6b 0d 20 20 20 20 20 20 20 20 32 20 |Break. 2 | 00000360 3d 20 43 54 52 4c 20 42 72 65 61 6b 0d 0d 0d 26 |= CTRL Break...&| 00000370 46 45 20 20 28 32 35 34 29 0d 52 65 61 64 2f 57 |FE (254).Read/W| 00000380 72 69 74 65 20 61 76 61 69 6c 61 62 6c 65 20 52 |rite available R| 00000390 41 4d 20 69 6e 20 42 42 43 20 6d 69 63 72 6f 63 |AM in BBC microc| 000003a0 6f 6d 70 75 74 65 72 20 28 65 76 65 6e 20 77 68 |omputer (even wh| 000003b0 65 6e 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 53 |en called from S| 000003c0 65 63 6f 6e 64 0d 50 72 6f 63 65 73 73 6f 72 29 |econd.Processor)| 000003d0 2e 0d 0d 20 20 20 20 20 20 20 20 31 32 38 20 3d |... 128 =| 000003e0 20 33 32 4b 0d 20 20 20 20 20 20 20 20 20 20 36 | 32K. 6| 000003f0 34 20 3d 20 31 36 4b 0d 0d 0d 26 46 46 20 20 28 |4 = 16K...&FF (| 00000400 32 35 35 29 0d 52 65 61 64 2f 57 72 69 74 65 20 |255).Read/Write | 00000410 73 74 61 72 74 20 75 70 20 6f 70 74 69 6f 6e 20 |start up option | 00000420 62 79 74 65 2e 20 54 68 69 73 20 61 6c 6c 6f 77 |byte. This allow| 00000430 73 20 74 68 65 20 6b 65 79 62 6f 61 72 64 20 6c |s the keyboard l| 00000440 69 6e 6b 20 76 61 6c 75 65 20 74 6f 20 62 65 0d |ink value to be.| 00000450 72 65 61 64 3a 20 20 69 74 20 6d 61 79 20 62 65 |read: it may be| 00000460 20 77 72 69 74 74 65 6e 20 74 6f 2c 20 62 75 74 | written to, but| 00000470 20 74 68 65 20 76 61 6c 75 65 20 77 69 6c 6c 20 | the value will | 00000480 62 65 20 72 65 73 65 74 20 74 6f 20 74 68 65 20 |be reset to the | 00000490 61 63 74 75 61 6c 20 77 69 72 65 64 0d 76 61 6c |actual wired.val| 000004a0 75 65 20 6f 6e 20 61 6e 79 20 72 65 73 65 74 20 |ue on any reset | 000004b0 6f 74 68 65 72 20 74 68 61 6e 20 61 20 73 6f 66 |other than a sof| 000004c0 74 2d 72 65 73 65 74 2e 20 54 68 65 20 6c 69 6e |t-reset. The lin| 000004d0 6b 73 20 61 72 65 20 63 6f 6e 66 69 67 75 72 65 |ks are configure| 000004e0 64 20 61 73 0d 66 6f 6c 6c 6f 77 73 3a 0d 0d 20 |d as.follows:.. | 000004f0 20 20 20 20 20 20 20 31 20 20 20 20 20 20 32 20 | 1 2 | 00000500 20 20 20 20 20 33 20 20 20 20 20 20 20 34 20 20 | 3 4 | 00000510 20 20 20 20 20 35 20 20 20 20 20 20 36 20 20 20 | 5 6 | 00000520 20 20 20 37 20 20 20 20 20 20 38 0d 20 20 20 20 | 7 8. | 00000530 20 20 20 20 58 20 20 20 20 20 20 58 20 20 20 20 | X X | 00000540 20 20 44 20 20 20 20 20 20 20 44 20 20 20 20 20 | D D | 00000550 20 20 42 20 20 20 20 20 20 4d 20 20 20 20 20 20 | B M | 00000560 4d 20 20 20 20 20 20 4d 0d 20 20 20 20 20 20 20 |M M. | 00000570 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00000580 32 20 20 20 20 20 20 20 31 20 20 20 20 20 20 20 |2 1 | 00000590 20 20 20 20 20 20 20 33 20 20 20 20 20 20 32 20 | 3 2 | 000005a0 20 20 20 20 20 31 0d 20 20 20 20 20 20 20 20 0d | 1. .| 000005b0 44 32 2c 20 44 31 20 3a 20 44 69 73 63 20 63 6f |D2, D1 : Disc co| 000005c0 6e 66 69 67 75 72 61 74 69 6f 6e 20 62 69 74 73 |nfiguration bits| 000005d0 20 28 73 65 65 20 44 69 73 63 20 4d 61 6e 75 61 | (see Disc Manua| 000005e0 6c 29 2e 0d 42 20 3a 20 41 75 74 6f 2d 62 6f 6f |l)..B : Auto-boo| 000005f0 74 20 73 65 6c 65 63 74 20 28 41 75 74 6f 2d 62 |t select (Auto-b| 00000600 6f 6f 74 20 77 68 65 6e 20 66 69 74 74 65 64 29 |oot when fitted)| 00000610 2e 0d 4d 33 2c 20 4d 32 2c 20 4d 31 20 3a 20 53 |..M3, M2, M1 : S| 00000620 63 72 65 65 6e 20 6d 6f 64 65 20 6f 6e 20 68 61 |creen mode on ha| 00000630 72 64 20 72 65 73 65 74 20 28 30 2d 37 29 0d 58 |rd reset (0-7).X| 00000640 20 3a 20 55 6e 75 73 65 64 2e 0d 0d 0d 2d 2d 2d | : Unused....---| 00000650 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000690 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 43 6f 6e 6e 65 |----------.Conne| 000006a0 63 74 69 6e 67 20 4a 6f 79 73 74 69 63 6b 73 20 |cting Joysticks | 000006b0 54 6f 20 54 68 65 20 42 42 43 20 4d 69 63 72 6f |To The BBC Micro| 000006c0 0d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |.---------------| 000006d0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000700 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0d |--------------..| 00000710 4f 6e 20 74 68 65 20 72 65 61 72 20 70 61 6e 65 |On the rear pane| 00000720 6c 20 6f 66 20 74 68 65 20 42 42 43 20 4d 69 63 |l of the BBC Mic| 00000730 72 6f 20 61 6e 20 41 6e 61 6c 6f 67 75 65 20 70 |ro an Analogue p| 00000740 6f 72 74 20 69 73 20 70 72 6f 76 69 64 65 64 20 |ort is provided | 00000750 66 6f 72 0d 63 75 73 74 6f 6d 65 72 73 20 77 68 |for.customers wh| 00000760 6f 20 77 69 73 68 20 74 6f 20 69 6e 74 65 72 66 |o wish to interf| 00000770 61 63 65 20 76 61 72 69 6f 75 73 20 70 65 72 69 |ace various peri| 00000780 70 68 65 72 61 6c 73 20 74 6f 20 74 68 65 69 72 |pherals to their| 00000790 20 6d 61 63 68 69 6e 65 73 2c 20 74 68 65 0d 6d | machines, the.m| 000007a0 6f 73 74 20 63 6f 6d 6d 6f 6e 20 6f 66 20 77 68 |ost common of wh| 000007b0 69 63 68 20 61 72 65 20 4a 6f 79 73 74 69 63 6b |ich are Joystick| 000007c0 73 20 6f 72 20 47 61 6d 65 73 20 50 61 64 64 6c |s or Games Paddl| 000007d0 65 73 2e 0d 0d 54 68 65 20 63 69 72 63 75 69 74 |es...The circuit| 000007e0 20 64 69 61 67 72 61 6d 20 73 68 6f 77 73 20 61 | diagram shows a| 000007f0 20 76 69 65 77 20 6f 66 20 74 68 65 20 31 35 20 | view of the 15 | 00000800 77 61 79 20 27 44 27 20 74 79 70 65 20 63 6f 6e |way 'D' type con| 00000810 6e 65 63 74 6f 72 20 73 65 65 6e 20 66 72 6f 6d |nector seen from| 00000820 0d 74 68 65 20 6f 75 74 73 69 64 65 20 6f 66 20 |.the outside of | 00000830 74 68 65 20 6d 61 63 68 69 6e 65 2c 20 61 6c 6f |the machine, alo| 00000840 6e 67 20 77 69 74 68 20 74 68 65 20 63 6f 6e 6e |ng with the conn| 00000850 65 63 74 69 6f 6e 73 20 66 6f 72 20 74 68 65 20 |ections for the | 00000860 66 6f 75 72 0d 70 6f 74 65 6e 74 69 6f 6d 65 74 |four.potentiomet| 00000870 65 72 73 20 61 6e 64 20 74 77 6f 20 66 69 72 65 |ers and two fire| 00000880 20 62 75 74 74 6f 6e 73 20 6e 65 65 64 65 64 20 | buttons needed | 00000890 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 61 20 70 |to configure a p| 000008a0 61 69 72 20 6f 66 20 6a 6f 79 73 74 69 63 6b 73 |air of joysticks| 000008b0 2e 0d 0d 54 68 65 20 70 6f 74 65 6e 74 69 6f 6d |...The potentiom| 000008c0 65 74 65 72 73 20 73 68 6f 77 6e 20 69 6e 20 74 |eters shown in t| 000008d0 68 65 20 64 69 61 67 72 61 6d 20 73 68 6f 75 6c |he diagram shoul| 000008e0 64 20 62 65 20 6f 66 20 61 70 70 72 6f 78 69 6d |d be of approxim| 000008f0 61 74 65 6c 79 20 31 30 6b 20 69 6e 0d 76 61 6c |ately 10k in.val| 00000900 75 65 20 61 6e 64 20 74 68 65 20 66 69 72 65 20 |ue and the fire | 00000910 62 75 74 74 6f 6e 73 20 61 72 65 20 73 69 6d 70 |buttons are simp| 00000920 6c 65 20 73 77 69 74 63 68 65 73 20 77 68 69 63 |le switches whic| 00000930 68 20 61 72 65 20 6f 70 65 6e 20 77 68 65 6e 20 |h are open when | 00000940 61 74 20 72 65 73 74 2e 0d 54 68 65 20 61 63 74 |at rest..The act| 00000950 75 61 6c 20 63 6f 6e 73 74 72 75 63 74 69 6f 6e |ual construction| 00000960 20 6f 66 20 74 68 65 20 6a 6f 79 73 74 69 63 6b | of the joystick| 00000970 20 69 74 73 65 6c 66 20 69 73 20 65 6e 74 69 72 | itself is entir| 00000980 65 6c 79 20 61 74 20 74 68 65 20 75 73 65 72 73 |ely at the users| 00000990 0d 64 69 73 63 72 65 74 69 6f 6e 20 62 75 74 20 |.discretion but | 000009a0 69 74 20 69 73 20 72 65 63 6f 6d 6d 65 6e 64 65 |it is recommende| 000009b0 64 20 74 68 61 74 20 74 68 65 79 20 61 72 65 20 |d that they are | 000009c0 73 65 6c 66 20 63 65 6e 74 65 72 69 6e 67 2e 0d |self centering..| 000009d0 0d 54 6f 20 65 6e 61 62 6c 65 20 74 68 65 20 75 |.To enable the u| 000009e0 73 65 20 6f 66 20 74 68 65 20 6a 6f 79 73 74 69 |se of the joysti| 000009f0 63 6b 73 20 61 20 66 75 6c 6c 20 75 6e 64 65 72 |cks a full under| 00000a00 73 74 61 6e 64 69 6e 67 20 6f 66 20 74 68 65 20 |standing of the | 00000a10 22 41 44 56 41 4c 22 0d 63 6f 6d 6d 61 6e 64 20 |"ADVAL".command | 00000a20 69 73 20 6e 65 63 65 73 73 61 72 79 2c 20 74 68 |is necessary, th| 00000a30 69 73 20 69 73 20 64 65 74 61 69 6c 65 64 20 6f |is is detailed o| 00000a40 6e 20 70 61 67 65 20 32 30 32 20 6f 66 20 74 68 |n page 202 of th| 00000a50 65 20 55 73 65 72 20 47 75 69 64 65 2e 20 54 68 |e User Guide. Th| 00000a60 65 72 65 0d 61 72 65 20 61 6c 73 6f 20 66 6f 75 |ere.are also fou| 00000a70 72 20 4f 53 42 59 54 45 20 63 61 6c 6c 73 20 74 |r OSBYTE calls t| 00000a80 68 61 74 20 61 72 65 20 75 73 65 64 20 77 68 69 |hat are used whi| 00000a90 6c 73 74 20 72 65 61 64 69 6e 67 20 66 72 6f 6d |lst reading from| 00000aa0 20 74 68 65 20 41 44 43 2c 20 74 68 65 73 65 0d | the ADC, these.| 00000ab0 61 72 65 20 4f 53 42 59 54 45 53 20 26 38 30 2c |are OSBYTES &80,| 00000ac0 20 26 42 43 2c 20 26 42 44 20 61 6e 64 20 26 42 | &BC, &BD and &B| 00000ad0 45 20 28 70 61 67 65 20 34 31 38 20 42 42 43 20 |E (page 418 BBC | 00000ae0 55 73 65 72 20 47 75 69 64 65 29 2e 20 4f 6e 6c |User Guide). Onl| 00000af0 79 20 74 68 65 20 66 69 72 73 74 0d 6f 66 20 74 |y the first.of t| 00000b00 68 65 73 65 20 63 61 6c 6c 73 20 69 73 20 64 6f |hese calls is do| 00000b10 63 75 6d 65 6e 74 65 64 20 69 6e 20 74 68 65 20 |cumented in the | 00000b20 55 73 65 72 20 47 75 69 64 65 2c 20 74 68 65 20 |User Guide, the | 00000b30 6f 74 68 65 72 20 74 68 72 65 65 20 65 6e 61 62 |other three enab| 00000b40 6c 65 20 79 6f 75 0d 74 6f 20 72 65 61 64 20 74 |le you.to read t| 00000b50 68 65 20 41 44 43 20 63 68 61 6e 6e 65 6c 20 4e |he ADC channel N| 00000b60 4f 2e 2c 20 72 65 61 64 20 74 68 65 20 6d 61 78 |O., read the max| 00000b70 69 6d 75 6d 20 41 44 43 20 63 68 61 6e 6e 65 6c |imum ADC channel| 00000b80 20 4e 6f 2c 20 61 6e 64 20 72 65 61 64 20 74 68 | No, and read th| 00000b90 65 0d 41 44 43 20 63 6f 6e 76 65 72 73 69 6f 6e |e.ADC conversion| 00000ba0 20 74 79 70 65 2c 20 65 69 74 68 65 72 20 31 32 | type, either 12| 00000bb0 20 6f 72 20 38 20 62 69 74 73 20 72 65 73 70 65 | or 8 bits respe| 00000bc0 63 74 69 76 65 6c 79 2e 0d 0d 0d 2d 2d 2d 2d 2d |ctively....-----| 00000bd0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000c10 2d 2d 2d 2d 2d 2d 2d 2d 0d 41 64 76 61 6e 63 65 |--------.Advance| 00000c20 64 20 44 69 73 63 20 46 69 6c 69 6e 67 20 53 79 |d Disc Filing Sy| 00000c30 73 74 65 6d 20 55 73 65 72 20 47 75 69 64 65 20 |stem User Guide | 00000c40 2d 20 41 64 64 65 6e 64 75 6d 0d 2d 2d 2d 2d 2d |- Addendum.-----| 00000c50 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000c90 2d 2d 2d 2d 2d 2d 2d 2d 0d 0d 50 6c 65 61 73 65 |--------..Please| 00000ca0 20 6e 6f 74 65 20 74 68 65 20 66 6f 6c 6c 6f 77 | note the follow| 00000cb0 69 6e 67 20 63 68 61 6e 67 65 73 20 74 6f 20 74 |ing changes to t| 00000cc0 68 65 20 41 64 76 61 6e 63 65 64 20 44 69 73 63 |he Advanced Disc| 00000cd0 20 46 69 6c 69 6e 67 20 53 79 73 74 65 6d 20 28 | Filing System (| 00000ce0 41 44 46 53 29 0d 55 73 65 72 20 47 75 69 64 65 |ADFS).User Guide| 00000cf0 3a 0d 0d 43 68 61 70 74 65 72 20 39 20 2d 20 54 |:..Chapter 9 - T| 00000d00 68 65 20 46 69 6c 69 6e 67 20 53 79 73 74 65 6d |he Filing System| 00000d10 20 55 74 69 6c 69 74 69 65 73 0d 0d 54 68 65 20 | Utilities..The | 00000d20 41 44 46 53 20 55 74 69 6c 69 74 69 65 73 20 44 |ADFS Utilities D| 00000d30 69 73 63 20 73 75 70 70 6c 69 65 64 20 69 73 20 |isc supplied is | 00000d40 61 6e 20 65 6e 68 61 6e 63 65 64 20 76 65 72 73 |an enhanced vers| 00000d50 69 6f 6e 20 6f 66 20 74 68 65 20 64 69 73 63 0d |ion of the disc.| 00000d60 64 65 73 63 72 69 62 65 64 20 69 6e 20 63 68 61 |described in cha| 00000d70 70 74 65 72 20 39 2e 20 54 68 65 20 6e 75 6d 62 |pter 9. The numb| 00000d80 65 72 20 6f 66 20 75 74 69 6c 69 74 69 65 73 20 |er of utilities | 00000d90 68 61 73 20 62 65 65 6e 20 69 6e 63 72 65 61 73 |has been increas| 00000da0 65 64 20 61 6e 64 20 74 68 65 0d 64 69 73 63 20 |ed and the.disc | 00000db0 69 6e 63 6f 72 70 6f 72 61 74 65 73 20 61 20 6d |incorporates a m| 00000dc0 65 6e 75 20 66 6f 72 20 65 61 73 65 20 6f 66 20 |enu for ease of | 00000dd0 73 65 6c 65 63 74 69 6f 6e 2e 0d 0d 54 68 65 20 |selection...The | 00000de0 75 74 69 6c 69 74 69 65 73 20 61 72 65 20 65 61 |utilities are ea| 00000df0 63 68 20 64 65 73 63 72 69 62 65 64 20 69 6e 20 |ch described in | 00000e00 64 65 74 61 69 6c 20 6f 66 20 74 68 65 20 64 69 |detail of the di| 00000e10 73 63 20 62 79 20 6d 65 61 6e 73 20 6f 66 20 61 |sc by means of a| 00000e20 20 27 48 65 6c 70 27 0d 66 61 63 69 6c 69 74 79 | 'Help'.facility| 00000e30 20 61 6e 64 20 61 72 65 20 73 75 6d 6d 61 72 69 | and are summari| 00000e40 73 65 64 20 62 65 6c 6f 77 2e 0d 0d 2a 41 46 4f |sed below...*AFO| 00000e50 52 4d 20 2d 20 66 6f 72 6d 61 74 73 20 61 20 66 |RM - formats a f| 00000e60 6c 6f 70 70 79 20 64 69 73 63 20 69 6e 20 41 44 |loppy disc in AD| 00000e70 46 53 20 66 6f 72 6d 61 74 2e 0d 0d 2a 42 41 43 |FS format...*BAC| 00000e80 4b 55 50 20 2d 20 63 6f 70 69 65 73 20 61 6c 6c |KUP - copies all| 00000e90 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 | the contents of| 00000ea0 20 6f 6e 65 20 64 69 73 63 20 6f 6e 74 6f 20 61 | one disc onto a| 00000eb0 6e 6f 74 68 65 72 2e 0d 0d 43 41 54 41 4c 4c 20 |nother...CATALL | 00000ec0 2d 20 61 20 42 41 53 49 43 20 70 72 6f 67 72 61 |- a BASIC progra| 00000ed0 6d 20 77 68 69 63 68 20 70 72 6f 64 75 63 65 73 |m which produces| 00000ee0 20 61 20 6c 69 73 74 69 6e 67 20 6f 66 20 74 68 | a listing of th| 00000ef0 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 61 6c |e contents of al| 00000f00 6c 20 74 68 65 0d 64 69 72 65 63 74 6f 72 69 65 |l the.directorie| 00000f10 73 20 6f 6e 20 61 20 64 69 73 63 20 69 6e 20 61 |s on a disc in a| 00000f20 20 73 69 6d 69 6c 61 72 20 66 6f 72 6d 20 74 6f | similar form to| 00000f30 20 74 68 61 74 20 67 69 76 65 6e 20 62 79 20 74 | that given by t| 00000f40 68 65 20 2a 43 41 54 20 63 6f 6d 6d 61 6e 64 2e |he *CAT command.| 00000f50 0d 0d 43 4f 50 59 46 49 4c 45 53 20 2d 20 61 20 |..COPYFILES - a | 00000f60 42 41 53 49 43 20 20 70 72 6f 67 72 61 6d 20 75 |BASIC program u| 00000f70 73 65 64 20 74 6f 20 63 6f 70 79 20 66 69 6c 65 |sed to copy file| 00000f80 73 20 66 72 6f 6d 20 6f 6e 65 20 66 69 6c 69 6e |s from one filin| 00000f90 67 20 73 79 73 74 65 6d 20 74 6f 0d 61 6e 6f 74 |g system to.anot| 00000fa0 68 65 72 2e 0d 0d 44 49 52 43 4f 50 59 20 2d 20 |her...DIRCOPY - | 00000fb0 61 20 42 41 53 49 43 20 70 72 6f 67 72 61 6d 20 |a BASIC program | 00000fc0 77 68 69 63 68 20 63 6f 70 69 65 73 20 74 68 65 |which copies the| 00000fd0 20 65 6e 74 69 72 65 20 63 6f 6e 74 65 6e 74 73 | entire contents| 00000fe0 20 6f 66 20 61 20 73 70 65 63 69 66 69 65 64 0d | of a specified.| 00000ff0 41 44 46 53 20 73 6f 75 72 63 65 20 64 69 72 65 |ADFS source dire| 00001000 63 74 6f 72 79 2c 20 61 6e 64 20 61 6c 6c 20 69 |ctory, and all i| 00001010 74 73 20 73 75 62 2d 64 69 72 65 63 74 6f 72 69 |ts sub-directori| 00001020 65 73 2c 20 74 6f 20 61 20 73 70 65 63 69 66 69 |es, to a specifi| 00001030 65 64 0d 64 65 73 74 69 6e 61 74 69 6f 6e 20 64 |ed.destination d| 00001040 69 72 65 63 74 6f 72 79 2e 0d 0d 45 58 41 4c 4c |irectory...EXALL| 00001050 20 2d 20 73 69 6d 69 6c 61 72 20 74 6f 20 43 41 | - similar to CA| 00001060 54 41 4c 4c 2c 20 62 75 74 20 64 69 73 70 6c 61 |TALL, but displa| 00001070 79 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 73 |ys information s| 00001080 69 6d 69 6c 61 72 20 74 6f 20 74 68 61 74 20 67 |imilar to that g| 00001090 69 76 65 6e 20 62 79 0d 74 68 65 20 2a 45 58 20 |iven by.the *EX | 000010a0 61 6e 64 20 2a 49 4e 46 4f 20 63 6f 6d 6d 61 6e |and *INFO comman| 000010b0 64 73 2e 20 41 20 42 41 53 49 43 20 70 72 6f 67 |ds. A BASIC prog| 000010c0 72 61 6d 2e 0d 0d 48 41 52 44 45 52 52 4f 52 20 |ram...HARDERROR | 000010d0 2d 20 74 68 69 73 20 42 41 53 49 43 20 70 72 6f |- this BASIC pro| 000010e0 67 72 61 6d 20 65 6e 61 62 6c 65 73 20 70 65 72 |gram enables per| 000010f0 6d 61 6e 65 6e 74 20 66 6c 6f 70 70 79 20 64 69 |manent floppy di| 00001100 73 63 20 65 72 72 6f 72 73 20 74 6f 20 62 65 0d |sc errors to be.| 00001110 69 67 6e 6f 72 65 64 20 62 79 20 74 68 65 20 41 |ignored by the A| 00001120 44 46 53 2c 20 74 68 75 73 20 61 76 6f 69 64 69 |DFS, thus avoidi| 00001130 6e 67 20 74 68 65 20 22 44 69 73 63 20 45 72 72 |ng the "Disc Err| 00001140 6f 72 22 20 6d 65 73 73 61 67 65 20 77 68 69 63 |or" message whic| 00001150 68 20 77 6f 75 6c 64 20 62 65 0d 67 65 6e 65 72 |h would be.gener| 00001160 61 74 65 64 20 77 68 65 6e 20 74 68 65 20 62 61 |ated when the ba| 00001170 64 20 74 72 61 63 6b 20 69 73 20 61 63 63 65 73 |d track is acces| 00001180 73 65 64 2e 0d 0d 52 45 43 4f 56 45 52 20 2d 20 |sed...RECOVER - | 00001190 74 68 69 73 20 42 41 53 49 43 20 70 72 6f 67 72 |this BASIC progr| 000011a0 61 6d 20 65 6e 61 62 6c 65 73 20 61 20 66 69 6c |am enables a fil| 000011b0 65 2c 20 6f 72 20 70 61 72 74 20 6f 66 20 61 20 |e, or part of a | 000011c0 66 69 6c 65 2c 20 77 68 69 63 68 20 68 61 73 0d |file, which has.| 000011d0 62 65 65 6e 20 64 65 6c 65 74 65 64 20 61 63 63 |been deleted acc| 000011e0 69 64 65 6e 74 61 6c 6c 79 20 75 73 69 6e 67 20 |identally using | 000011f0 74 68 65 20 2a 44 45 4c 45 54 45 20 63 6f 6d 6d |the *DELETE comm| 00001200 61 6e 64 2c 20 74 6f 20 62 65 20 72 65 63 6f 76 |and, to be recov| 00001210 65 72 65 64 2e 0d 0d 2a 56 45 52 49 46 59 20 2d |ered...*VERIFY -| 00001220 20 76 65 72 69 66 69 65 73 20 61 20 64 69 73 63 | verifies a disc| 00001230 20 62 79 20 63 68 65 63 6b 69 6e 67 20 65 61 63 | by checking eac| 00001240 68 20 73 65 63 74 6f 72 20 74 6f 20 64 65 74 65 |h sector to dete| 00001250 72 6d 69 6e 65 20 69 66 20 69 74 20 69 73 0d 72 |rmine if it is.r| 00001260 65 61 64 61 62 6c 65 2e 0d 0d 0d 54 6f 20 75 73 |eadable....To us| 00001270 65 20 74 68 65 20 55 74 69 6c 69 74 69 65 73 20 |e the Utilities | 00001280 64 69 73 63 2c 20 69 6e 73 65 72 74 20 69 74 20 |disc, insert it | 00001290 69 6e 74 6f 20 74 68 65 20 64 72 69 76 65 20 28 |into the drive (| 000012a0 74 68 65 20 74 6f 70 20 64 72 69 76 65 20 6f 6e |the top drive on| 000012b0 20 64 75 61 6c 0d 64 72 69 76 65 73 29 20 61 6e | dual.drives) an| 000012c0 64 2c 20 77 68 69 6c 73 74 20 68 6f 6c 64 69 6e |d, whilst holdin| 000012d0 67 20 64 6f 77 6e 20 53 48 49 46 54 20 61 6e 64 |g down SHIFT and| 000012e0 20 41 2c 20 70 72 65 73 73 20 61 6e 64 20 72 65 | A, press and re| 000012f0 6c 65 61 73 65 20 42 52 45 41 4b 2e 20 54 68 65 |lease BREAK. The| 00001300 0d 55 74 69 6c 69 74 69 65 73 20 4d 65 6e 75 20 |.Utilities Menu | 00001310 77 69 6c 6c 20 61 70 70 65 61 72 20 61 73 20 66 |will appear as f| 00001320 6f 6c 6c 6f 77 73 3a 0d 0d 20 20 20 20 20 20 20 |ollows:.. | 00001330 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00001340 20 55 74 69 6c 69 74 69 65 73 20 4d 65 6e 75 0d | Utilities Menu.| 00001350 20 20 20 20 20 20 20 20 66 30 20 2d 20 41 66 6f | f0 - Afo| 00001360 72 6d 0d 20 20 20 20 20 20 20 20 66 31 20 2d 20 |rm. f1 - | 00001370 42 61 63 6b 75 70 0d 20 20 20 20 20 20 20 20 66 |Backup. f| 00001380 32 20 2d 20 43 61 74 61 6c 6c 0d 20 20 20 20 20 |2 - Catall. | 00001390 20 20 20 66 33 20 2d 20 43 6f 70 79 66 69 6c 65 | f3 - Copyfile| 000013a0 73 0d 20 20 20 20 20 20 20 20 66 34 20 2d 20 44 |s. f4 - D| 000013b0 69 72 63 6f 70 79 0d 20 20 20 20 20 20 20 20 66 |ircopy. f| 000013c0 35 20 2d 20 45 78 61 6c 6c 0d 20 20 20 20 20 20 |5 - Exall. | 000013d0 20 20 66 36 20 2d 20 48 61 72 64 65 72 72 6f 72 | f6 - Harderror| 000013e0 0d 20 20 20 20 20 20 20 20 66 37 20 2d 20 52 65 |. f7 - Re| 000013f0 63 6f 76 65 72 0d 20 20 20 20 20 20 20 20 66 38 |cover. f8| 00001400 20 2d 20 56 65 72 69 66 79 0d 20 20 20 20 20 20 | - Verify. | 00001410 20 20 66 39 20 2d 20 45 6e 64 0d 0d 50 72 65 73 | f9 - End..Pres| 00001420 73 3a 2d 0d 20 20 20 20 20 20 20 20 46 75 6e 63 |s:-. Func| 00001430 74 69 6f 6e 20 6b 65 79 73 20 74 6f 20 72 75 6e |tion keys to run| 00001440 20 55 74 69 6c 69 74 69 65 73 0d 20 20 20 20 20 | Utilities. | 00001450 20 20 20 53 68 69 66 74 2d 66 75 6e 63 74 69 6f | Shift-functio| 00001460 6e 20 6b 65 79 73 20 66 6f 72 20 68 65 6c 70 0d |n keys for help.| 00001470 77 68 65 72 65 20 45 6e 64 20 77 69 6c 6c 20 73 |where End will s| 00001480 74 6f 70 20 74 68 65 20 6d 65 6e 75 20 70 72 6f |top the menu pro| 00001490 67 72 61 6d 20 61 6e 64 20 72 65 74 75 72 6e 20 |gram and return | 000014a0 79 6f 75 20 74 6f 20 42 41 53 49 43 2e 0d 0d 57 |you to BASIC...W| 000014b0 68 65 6e 20 75 73 69 6e 67 20 74 68 65 20 48 65 |hen using the He| 000014c0 6c 70 20 66 61 63 69 6c 69 74 79 20 28 53 48 49 |lp facility (SHI| 000014d0 46 54 20 2b 20 3c 66 75 6e 63 74 69 6f 6e 20 6b |FT + <function k| 000014e0 65 79 3e 29 2c 20 75 73 65 20 53 48 49 46 54 20 |ey>), use SHIFT | 000014f0 74 6f 20 73 63 72 6f 6c 6c 0d 74 6f 20 74 68 65 |to scroll.to the| 00001500 20 65 6e 64 20 6f 66 20 74 68 65 20 74 65 78 74 | end of the text| 00001510 2e 20 20 0d 0d 54 6f 20 75 73 65 20 69 6e 64 69 |. ..To use indi| 00001520 76 69 64 75 61 6c 20 70 72 6f 67 72 61 6d 73 2c |vidual programs,| 00001530 20 77 69 74 68 6f 75 74 20 72 65 63 6f 75 72 73 | without recours| 00001540 65 20 74 6f 20 74 68 65 20 6d 65 6e 75 2c 20 69 |e to the menu, i| 00001550 6e 73 65 72 74 20 74 68 65 20 64 69 73 63 0d 69 |nsert the disc.i| 00001560 6e 74 6f 20 61 20 64 72 69 76 65 20 61 6e 64 20 |nto a drive and | 00001570 73 65 6c 65 63 74 20 74 68 65 20 64 72 69 76 65 |select the drive| 00001580 20 75 73 69 6e 67 20 61 20 2a 44 49 52 20 6f 72 | using a *DIR or| 00001590 20 2a 4d 4f 55 4e 54 20 69 6e 73 74 72 75 63 74 | *MOUNT instruct| 000015a0 69 6f 6e 2e 20 54 79 70 65 0d 2a 4c 49 42 2e 20 |ion. Type.*LIB. | 000015b0 4c 49 42 52 41 52 59 20 74 6f 20 73 65 74 20 74 |LIBRARY to set t| 000015c0 68 65 20 6c 69 62 72 61 72 79 2e 20 46 6f 72 20 |he library. For | 000015d0 6d 61 63 68 69 6e 65 2d 63 6f 64 65 20 70 72 6f |machine-code pro| 000015e0 67 72 61 6d 73 2c 20 73 69 6d 70 6c 79 20 74 79 |grams, simply ty| 000015f0 70 65 3a 0d 0d 20 20 20 20 20 20 20 20 2a 3c 66 |pe:.. *<f| 00001600 69 6c 65 6e 61 6d 65 3e 20 52 45 54 55 52 4e 0d |ilename> RETURN.| 00001610 0d 61 73 20 69 6e 64 69 63 61 74 65 64 20 61 62 |.as indicated ab| 00001620 6f 76 65 2e 20 46 6f 72 20 42 41 53 49 43 20 70 |ove. For BASIC p| 00001630 72 6f 67 72 61 6d 73 2c 20 74 79 70 65 3a 0d 0d |rograms, type:..| 00001640 20 20 20 20 20 20 20 20 43 48 2e 20 22 24 20 55 | CH. "$ U| 00001650 54 49 4c 49 54 49 45 53 2e 3c 66 69 6c 65 6e 61 |TILITIES.<filena| 00001660 6d 65 3e 22 20 20 52 45 54 55 52 4e 0d 0d 0d |me>" RETURN...| 0000166f
F/+HINT2.m0
F/+HINT2.m1
F/+HINT2.m2
F/+HINT2.m4
F/+HINT2.m5
.