summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorHarley Travis <harleytravis123@outlook.com>2026-06-27 16:17:38 -0500
committerHarley Travis <harleytravis123@outlook.com>2026-06-27 16:17:38 -0500
commite93bd517bd404fac79afba1f0c4df94e4db2a6ef (patch)
tree3b83695e8f77f031be85296fe7367e1e08d90188
parent17d4ab1c68db80cd57354680c8753cba1883311c (diff)
downloadtempleos-floppy-driver-e93bd517bd404fac79afba1f0c4df94e4db2a6ef.tar.gz
Update readme
I updated the readme to add more information about using the driver once installed.
-rw-r--r--ReadMe.TXT28
1 files changed, 25 insertions, 3 deletions
diff --git a/ReadMe.TXT b/ReadMe.TXT
index 9a7b774..14eb7b1 100644
--- a/ReadMe.TXT
+++ b/ReadMe.TXT
@@ -17,10 +17,11 @@ installing the driver, but do not do the Adam patches yet! Since I have not yet
implemented any sort of patch-like utility, you will have to do the patches
manually. Luckily, all of the needed modifications can be done by commenting out
the sections of code mentioned and/or #including the patch files.
-3. Recompile the kernel with BootHDIns().
+3. Recompile the kernel with BootHDIns() and reboot (or run BootRAM()).
4. Only when the kernel has been patched and recompiled can you do the Adam
-patches, at which point you can run BootHDIns() again if you want to mount your
-floppy drive(s) on startup.
+patches. at which point you can reboot or run BootRAM(). You can also run
+BootHDIns() again if you want to mount your floppy drive(s) on startup (it works;
+I checked).
Your system will have been patched to unmask IRQ6 and update the IDT to point it
to an appropriate stub.
@@ -29,6 +30,27 @@ The low-level functions of the driver will also be made available for your use,
but using the BlkRead() and BlkWrite() functions is preferred if you wish to do
low-level reading and writing.
+With the patches installed as shipped, drives W-Z (which normally are assigned
+to CD/DVD drives) will be assigned to floppy drives. Mount() does exactly what
+it says it does!
+
+Currently, only the RedSea file system is supported. You can format floppies with
+the Fmt() function. A full format will take considerably longer than a quick
+format; on my system, using 1.44 Meg disks, it took just over 80 seconds! A
+quick format, on the other hand, took about 5 seconds.
+
+As long at the initialization process works, you can do whatever you want with
+your floppy drive(s). If you don't have a disk inserted, or the disk does not
+match what you configured TempleOS to expect, it will show up as "NULL." If the
+disk is the correct type, but doesn't have a valid RedSea boot sector on it, it
+will show up as "UNKNOWN."
+
+Make sure to run DskChg() whenever you swap disks; it will recheck the file
+system and clear the read cache. Shut down any time you want, except during
+disk reads or writes (as is per usual, just make sure the drive light is off).
+Do not worry if the drive is not on track 0; your BIOS should recalibrate the
+drive during the Power-On Self-Test.
+
--A note about DMA--
If things went to plan, I would have use PIO to do data transfers to and from
the disk. However, they didn't, and my dev system would freeze when attempting