HDB-DOS User Manual © 2003 Boisy G
Total Page:16
File Type:pdf, Size:1020Kb
HDB-DOS 1.1 User Manual Manual Revision 1.2 - May 9, 2002 Cloud-9 Cloud-9 Cloud-9 3749 County Road 30 Delano, MN 55328 Cloud-9 3749 County Road 30 Telephone 763.972.3261 Delano, MN 55328 www.cloud9tech.com Telephone 763.972.3261 www.cloud9tech.com 56 HDB-DOS © 2003 Boisy G. Pitre Licensed to Cloud-9 All Rights Reserved All portions of this software are copyright and are the proprietary and trade secret information of Boisy G. Pitre and/or his licensor. Use, reproduction or publication of any portion of this material without the prior written authorization of Boisy G. Pitre is strictly prohibited. HDB-DOS User Manual © 2003 Boisy G. Pitre All Rights Reserved Reproduction or use of any portion of this manual, without express written permission from Boisy G. Pitre and/or his licensor, is prohibited. While reasonable efforts have been made in the preparation of this manual to assure its accuracy, neither Boisy G. Pitre nor his licensor assume liability resulting from any errors in or omissions from this manual, or from the use of the information contained herein. 2 55 Table Of Contents HDB-DOS 1.1 .......................................................................1 User Manual .....................................................................1 1. Congratulations! ...........................................................5 Features............................................................................6 Fixes And Additions ..........................................................6 2. Choosing A Hard Drive.................................................7 Sector Sizes......................................................................7 Virtual Floppy Disks ..........................................................7 Putting It Together ............................................................8 3. Using the HDB-DOS Wizard.......................................10 4. EPROM Installation ....................................................11 5. Hard Drive Setup ........................................................14 6. Special Features.........................................................18 Auto Execution Feature ..................................................18 FLEXIKEY - Last Line Recall & Edit................................19 7. Commands Reference................................................22 8. Detailed Command Summary.....................................24 COMMAND: BACKUP ....................................................24 SYNTAX and USAGE:................................................24 COMMAND: COPY.........................................................25 SYNTAX and USAGE:................................................25 COMMAND: DIR.............................................................27 SYNTAX and USAGE:................................................27 COMMAND: DOS ...........................................................28 SYNTAX and USAGE:................................................28 COMMAND: DRIVE........................................................30 SYNTAX and USAGE:................................................30 COMMAND: DSKINI.......................................................32 SYNTAX and USAGE:................................................32 COMMAND: RENAME....................................................34 SYNTAX and USAGE:................................................34 COMMAND: RUN, RUNM ..............................................36 9. Technical Information .................................................38 $D930 (DISKIO) - Universal Hard Disk I/O Routine........38 54 3 $D932 (SETUP) - Setup a CDB in RAM starting at VCMD ........................................................................................39 $D934 (BEEP) - Used to generate a "BEEP" tone..........39 $D936 (DSKCON) - DSKCON Re-entry point..............39 $D938 (OS9HI) - OS-9 sector offset, HI BYTE. ..............39 $D939 (OS9LO) - OS-9 sector offset, LO WORD...........39 $D93B (PORTHI) – Port Address, HI BYTE. ..................40 $D93C (PORTLO) – Port Address, LO BYTE.................40 $D93D (TIMOUT) – Timeout Value. ...............................40 $D93E (DEFID) – Default SCSI/IDE ID...........................40 RAM Variables................................................................40 10. HDB-DOS Utilities ....................................................43 WIZARD.BAS .................................................................43 LINK.BAS........................................................................43 DSK2DSK.BAS...............................................................43 FINDFILE.BAS................................................................44 ERRMSG.BIN, ERRMSG.SRC.......................................44 RAMDISK.BIN, RAMDISK.ASM .....................................44 TWPATCH.BAS, TWPATCH.BIN, TWPATCH.ASM.......44 FIX 128.BAS ...................................................................44 FMTALL.BAS..................................................................44 11. OS-9 and HDB-DOS ................................................45 HDB-DOS Offset Feature ...............................................45 Example......................................................................46 “No Floppy” OS-9 Boot ...................................................47 12. SCSI Notes ..............................................................49 Supported SCSI Controllers............................................49 13. IDE Notes.................................................................50 Supported IDE Interfaces................................................50 ATA-2 vs. ATAPI.............................................................51 C/H/S vs. LBA Mode.......................................................51 14. Support.....................................................................52 4 53 14. Support 1. Congratulations! At Cloud-9, we take pride in offering products that will be Thank you for purchasing HDB-DOS, another one of the fine easy to configure and use. Although our products are products offered by Cloud-9. This product was designed to engineered with quality and care, we cannot guarantee that be used with the Radio Shack TRS-80 Color Computers 1, you won’t run into problems. 2, and the Tandy Color Computer 3. If you have a problem or question, please contact us via the HDB-DOS (Hard Disk BASIC Disk Operating System) Internet at [email protected]. You can also visit our started out in 1986 as RGB-DOS, a ground-breaking product website at http://www.cloud9tech.com for up-to-date of Roger Krupski and RGB COMPUTER SYSTEMS. It was information on your product. paired with the fine SCSI controller from Ken-Ton Electronics, and versions were also available for other hard drive controllers. With the introduction of the TC^3 SCSI controller from Cloud-9, renewed interest in RGB-DOS began to appear. In 2002, Boisy Pitre acquired all rights to the product from Ken- Ton and now licenses the product exclusively to Cloud-9 as HDB-DOS. HDB-DOS is reliable and easy to learn, but you have to KNOW HOW TO USE IT if you expect maximum performance. We suggest that some time be spent reading the User Manual before attempting to use HDB-DOS with your hard drive system. Over the years, several people have spent long hours at the keyboard writing the software and the User Manual, so please spend a few minutes and read the manual first. It will save you time, money and frustration. HDB-DOS contains the best ideas of many CoCo enthusiasts. Countless ideas were given and countless 52 5 suggestions made. Some ideas were great, and became ATA-2 vs. ATAPI part of HDB-DOS. Most ideas were rejected for technical HDB-DOS supports ATA-2 compliant devices only. ATAPI reasons. Although we feel HDB-DOS is a fine product, we devices such as CD-ROMs and ZIP drives will not work with never consider it "finished". There is always something that HDB-DOS. can be improved. If you have an idea, comment or suggestion, please pass it along to us. C/H/S vs. LBA Mode Features HDB-DOS supports both LBA (Logical Block Address) mode and C/H/S (Cylinder/Head/Sector) mode. Both are standard • Allows access to modern SCSI and IDE hard drives methods of accessing data on IDE drives. under BASIC. • Can address up to 8 SCSI devices or 2 IDE devices. C/H/S mode is widely used in IDE hard drives of many sizes • Up to 256 “virtual floppy” disks can be accessed. and models; therefore, it offers the most compatibility. While • Works flawlessly with Cloud-9’s TC^3 SCSI Controller using C/H/S mode does add some overhead when and SuperIDE Interface. processing each read/write, it insures the greatest • Also supports Disto and Ken-Ton SCSI controllers, compatibility with a wide range of IDE drives. and the Glenside IDE interface. Unlike C/H/S mode, the LBA mode is a more direct approach Fixes And Additions to accessing a hard drive’s sectors, and requires very little overhead, but is usually supported on drives of larger (> Version 1.1 of HDB-DOS includes the following fixes and 2GB) capacity or CompactFlash. additions: Depending upon your hard drive setup, you should select Cloud-9’s SuperIDE controller is now supported. either the C/H/S or LBA mode when configuring HDB-DOS. LBA mode support for IDE drives has been added. LBA mode is recommended since it is faster; however, if you Several bugs, which affected compatibility with have older or smaller IDE drives, C/H/S is probably the only certain SCSI and IDE drives, have been fixed. mode that will work. The