annotate level1/modules/rbdesc.asm @ 3130:e0614e08fa5e

l1 boot modules: Expand documentation and clean up code Tidy up white-space and indentation. Expand documentation to show C flag is important on return from HWRead. Expand documentation to show how/why/when filler is needed at end of file. Delete dead code in some places. No functional changes.
author Neal Crook <foofoobedoo@gmail.com>
date Sun, 04 Dec 2016 21:01:42 +0000
parents e881994bfe30
children 4674aed99721
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2590
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
1 ********************************************************************
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
2 * rbdesc - Device Descriptor Template
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
3 *
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
4 * $Id$
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
5 *
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
6 * Edt/Rev YYYY/MM/DD Modified by
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
7 * Comment
2937
e881994bfe30 rbdesc/superdesc: Raise default SAS from $8 to $10
Gene Heskett <gheskett@wdtv.com>
parents: 2858
diff changeset
8 * 1/1 2013-12/10 Gene heskett
e881994bfe30 rbdesc/superdesc: Raise default SAS from $8 to $10
Gene Heskett <gheskett@wdtv.com>
parents: 2858
diff changeset
9 * Raised default SAS to $10, shortens FD.SEG
e881994bfe30 rbdesc/superdesc: Raise default SAS from $8 to $10
Gene Heskett <gheskett@wdtv.com>
parents: 2858
diff changeset
10 * usage for longer files
2590
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
11 * ------------------------------------------------------------------
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
12
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
13 nam rbdesc
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
14 ttl Device Descriptor Template
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
15
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
16 * Disassembled 98/08/23 17:09:41 by Disasm v1.6 (C) 1988 by RML
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
17
2798
b70d93f8d7ce Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors.
drencor-xeen
parents: 2590
diff changeset
18 ifp1
2590
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
19 use defsfile
2798
b70d93f8d7ce Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors.
drencor-xeen
parents: 2590
diff changeset
20 endc
2590
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
21
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
22 tylg set Devic+Objct
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
23 atrv set ReEnt+rev
2937
e881994bfe30 rbdesc/superdesc: Raise default SAS from $8 to $10
Gene Heskett <gheskett@wdtv.com>
parents: 2858
diff changeset
24 rev set $01
2590
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
25
2858
632187a1083e Spell DNum consistently
Tormod Volden <debian.tormod@gmail.com>
parents: 2798
diff changeset
26 IFNDEF DNum
2590
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
27 DNum set 0
2798
b70d93f8d7ce Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors.
drencor-xeen
parents: 2590
diff changeset
28 ENDC
2590
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
29 IFNE D35
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
30 Type set TYP.CCF+TYP.3
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
31 ELSE
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
32 Type set TYP.CCF+TYP.5
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
33 ENDC
2798
b70d93f8d7ce Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors.
drencor-xeen
parents: 2590
diff changeset
34 IFNDEF Density
2590
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
35 Density set DNS.MFM
2798
b70d93f8d7ce Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors.
drencor-xeen
parents: 2590
diff changeset
36 ENDC
b70d93f8d7ce Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors.
drencor-xeen
parents: 2590
diff changeset
37 IFNDEF Step
2590
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
38 Step set STP.6ms
2798
b70d93f8d7ce Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors.
drencor-xeen
parents: 2590
diff changeset
39 ENDC
b70d93f8d7ce Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors.
drencor-xeen
parents: 2590
diff changeset
40 IFNDEF Cyls
2590
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
41 Cyls set 35
2798
b70d93f8d7ce Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors.
drencor-xeen
parents: 2590
diff changeset
42 ENDC
b70d93f8d7ce Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors.
drencor-xeen
parents: 2590
diff changeset
43 IFNDEF Sides
2590
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
44 Sides set 1
2798
b70d93f8d7ce Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors.
drencor-xeen
parents: 2590
diff changeset
45 ENDC
2590
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
46 Verify set 1
2798
b70d93f8d7ce Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors.
drencor-xeen
parents: 2590
diff changeset
47 IFNDEF SectTrk
2590
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
48 SectTrk set 18
2798
b70d93f8d7ce Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors.
drencor-xeen
parents: 2590
diff changeset
49 ENDC
b70d93f8d7ce Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors.
drencor-xeen
parents: 2590
diff changeset
50 IFNDEF SectTrk0
2590
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
51 SectTrk0 set 18
2798
b70d93f8d7ce Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors.
drencor-xeen
parents: 2590
diff changeset
52 ENDC
b70d93f8d7ce Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors.
drencor-xeen
parents: 2590
diff changeset
53 IFNDEF Interlv
2590
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
54 Interlv set 3
2798
b70d93f8d7ce Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors.
drencor-xeen
parents: 2590
diff changeset
55 ENDC
b70d93f8d7ce Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors.
drencor-xeen
parents: 2590
diff changeset
56 IFNDEF SAS
2937
e881994bfe30 rbdesc/superdesc: Raise default SAS from $8 to $10
Gene Heskett <gheskett@wdtv.com>
parents: 2858
diff changeset
57 SAS set 10
2798
b70d93f8d7ce Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors.
drencor-xeen
parents: 2590
diff changeset
58 ENDC
2590
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
59
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
60 mod eom,name,tylg,atrv,mgrnam,drvnam
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
61
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
62 fcb DIR.!SHARE.!PEXEC.!PWRIT.!PREAD.!EXEC.!UPDAT. mode byte
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
63 fcb HW.Page extended controller address
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
64 fdb $FF40 physical controller address
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
65 fcb initsize-*-1 initalization table size
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
66 fcb DT.RBF device type:0=scf,1=rbf,2=pipe,3=scf
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
67 fcb DNum drive number
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
68 fcb Step step rate
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
69 fcb Type drive device type
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
70 fcb Density media density:0=single,1=double
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
71 fdb Cyls number of cylinders (tracks)
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
72 fcb Sides number of sides
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
73 fcb Verify verify disk writes:0=on
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
74 fdb SectTrk # of sectors per track
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
75 fdb SectTrk0 # of sectors per track (track 0)
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
76 fcb Interlv sector interleave factor
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
77 fcb SAS minimum size of sector allocation
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
78 initsize equ *
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
79
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
80 IFNE DD
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
81 name fcs /DD/
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
82 ELSE
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
83 name fcs /RTST/
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
84 fcb '0+DNum+$80
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
85 ENDC
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
86 mgrnam fcs /RBF/
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
87 drvnam fcs /rbtest/
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
88
2798
b70d93f8d7ce Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors.
drencor-xeen
parents: 2590
diff changeset
89 emod
2590
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
90 eom equ *
2798
b70d93f8d7ce Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors.
drencor-xeen
parents: 2590
diff changeset
91 end
2590
17d43fd29ee2 Integration of SuperDriver
boisy
parents:
diff changeset
92