forked from n6il/eou_ide
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.txt
164 lines (112 loc) · 5.68 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
+==============================+
| EOU for GlensideIDE/SuperIDE |
| MAME And XRoar Emulation |
| |
| Michael Furman (MikeyN6IL) |
| 17 Mar 2022 |
+==============================+
This is a DIY Pack for setting up EOU to work on a GlensideIDE, SuperIDE,
or in MAME or XRoar with an emulated GlensideIDE.
The makebootfileide.py script creates the following disk images in the
build/<CPU> directory. If you are using 6309 cpu every this document says
"68xxx" you substitute "63xxx" for the 6309 version:
68IDE.VHD -- This is a VHD disk image designed for use on IDE Drives.
You can use this disk on a real GlensideIDE or SuperIDE controller.
The VHD image will not work on XRoar or MAME.
68IDE.IDE -- This is a special IDE disk image for use with XRoar's
Glenside IDE emulation. This image will not work on real hardware
or MAME.
68IDE.dsk -- This is a boot disk which can boot Nitros9 from the VHD or
XRoar IDE disk images. This disk image should be used for MAME but
It is not required for XRoar. It is already installed on both the
VHD and IDE disk images.
What's on the VHD and IDE Disk images?
======================================
68IDE.VHD is a specially crafted disk image. It contains the following
partitions:
First Partition: Sectors 0-629: Contains the 68IDE.dsk with padding
for 512-byte sectors.
Second Partition: Sector 630+: Contains the 68SDC.VHD image from
EOU verbatim without any modifications.
68IDE.IDE is further specialized:
Header: 1024 byte header required for XRoar. Not seen by the CoCo
First Partition: Sectors 0-629: Contains the 68IDE.dsk with padding
for 512-byte sectors.
Second Partition: Sector 630+: Contains the 68SDC.VHD image from
EOU verbatim without any modifications.
How to use the disk images:
===========================
Downloading: Binary or source packages are available here:
https://github.com/n6il/eou_ide/releases
XRoar: Use the ide cartridge and attach the 68IDE.IDE image to hd0. Use
YADOS or HDB-DOS LBA ROM(hdblba.rom). See the start-ide.sh
script for a sample command line.
MAME: Use MAME v0.241 or later. Attach the IDE card and 68SDC.VHD to
hard3. Attach fdcv11 to the IDE Card's Slot and 68IDE.dsk to
flop1:
mame coco3 -ext ide -ext:ide:slot fdcv11 -flop1 68IDE.dsk -hard3 68SDC.VHD
If you want a second HDD add: -ext:ide:ata:1 hdd -hard4 test.vhd
SuperIDE: Burn the 68IDE.VHD image to a CF Card. Use YADOS or HDB-DOS
LBA ROM(hdblba.rom).
GlensideIDE: Image drive/Card with 68IDE.VHD. use YADOS or HDB-DOS
LBA ROM(hdblba.rom)
DIY Package Contents:
=====================
* README.txt -- this file
* boot_ide -- NitrOS-9 IDE Booter HwAddr: $FF50
* llide.dr -- SuperDriver IDE Driver with a small patch
* i0_ide.dd -- Descriptor for /I0 HwAddr: $FF50 Offset: $000276
* i1_ide.dd -- Descriptor for /I1 HwAddr: $FF50 Offset: $000276
* ddi0_ide.dd -- Descriptor for /DD HwAddr: $FF50 Offset: $000276
* header.ide -- XRoar IDE Header
* makebootfileide.py -- Python Script that creates the disk images
Script Usage:
=============
usage: makebootfileide.py [-h] [-c CPU] [-i EOUVHD] [-d DW] [-e EMULATOR]
EOU Ide Disk Creator
optional arguments:
-h, --help show this help message and exit
-c CPU, --cpu CPU CPU Type: ['6809', '6309']
-i EOUVHD, --vhd EOUVHD
Source EOU VHD File
-d DW, --dw DW Make Dw Image in addition to IDE image: ['becker',
'bitBanger', 'bbCoCo1', 'rs232', 'mmmpi']
-e EMULATOR, --emulator EMULATOR
Which Emulator to build for: ['xroar', 'mame']
Instructions for creating your own IDE Disk images:
===================================================
1. Download a copy of NitrOS-9 Ease Of Use
2. Note the path of either 68SDC.VHD or 63SDC.VHD
3. Run the script: python ./makebootfileide.py -c <CPU> -i <VHD> -e <emulator>
4. The disk images are created in a build/<CPU> directory: 68IDE.VHD, 68IDE.ide, and 68IDE.dsk
5. To use it: See usage instructions above.
6. If you want DriveWire support, add the -dbecker option. This will create a new build directory
build/<CPU>_becker
Examples:
XRoar 6809 with IDE
python ./makebootfileide -c 6809 -i ~/demo/eou/6809/68SDC.VHD -e xroar
python ./makebootfileide --cpu 6809 --vhd ~/demo/eou/6809/68SDC.VHD --emulator xroar
Output Dir: build/6809_ide_xroar
Floppy Image: None
VHD Image: 68IDE.VHD
MAME 6809 with IDE
python ./makebootfileide -c 6809 -i ~/demo/eou/6809/68SDC.VHD -e mame
python ./makebootfileide --cpu 6809 --vhd ~/demo/eou/6809/68SDC.VHD --emulator mame
Output Dir: build/6809_ide_mame
Floppy Image: 68IDE.dsk
VHD Image: 68SDC.VHD (Stock EOU Image)
XRoar 6809 with IDE and DriveWire
python ./makebootfileide -c 6809 -i ~/demo/eou/6809/68SDC.VHD -e xroar -d becker
python ./makebootfileide --cpu 6809 --vhd ~/demo/eou/6809/68SDC.VHD --emulator xroar --dw becker
Note: Command line above makes both DW and Non-Dw versions:
Output Dir: build/6809_ide_xroar
Output Dir: build/6809_ide_xroar_dw_becker
MAME 6809 with IDE and DriveWire
python ./makebootfileide -c 6809 -i ~/demo/eou/6809/68SDC.VHD -e mame -d becker
python ./makebootfileide --cpu 6809 --vhd ~/demo/eou/6809/68SDC.VHD --emulator mame --dw becker
Note: Command line above makes both DW and Non-Dw versions:
Output Dir: build/6809_ide_xroar
Output Dir: build/6809_ide_xroar_dw_becker
6309:
Same as above set -c 6309 or --cpu 6309
Use 63XXX instead of 68XXX for files and directories