BW-DOS

Year
1994
Publisher
BeWeSoft
Type
DOS
Category
Disk operating system (command line, SpartaDOS-compatible)
Developer
Jiří Bernášek (BeWeSoft); versions 1.31+ by Holger Janz
Language
6502 machine language
Requirements
Atari 8-bit with 48K RAM (version 1.4+ runs in 16K, full function with 48K) and at least one disk drive
Blue Atari screen reading 'BW-DOS Ver. 1.30 (C) BEWESOFT 1995 (Jiri Bernasek) This is a FreeWare program!' above a D1: prompt

Overview

BW-DOS is a small, free disk operating system that does what SpartaDOS does in less memory. It uses the SpartaDOS file system, so BW-DOS and SpartaDOS disks can be used under either DOS, booting included. Most SpartaDOS commands and CIO extensions behave the same, so programs written for SpartaDOS generally run. It was written in the Czech Republic by Jiří Bernášek under the name BeWeSoft and released in 1994 as freeware. Its manual asks only that the master disk be passed on whole and unchanged and not sold.

Bernášek aimed it at two groups: people who wanted a capable command-line DOS that left as much memory free as possible, and SpartaDOS users who wanted a "junior version". He also fixed several SpartaDOS bugs on the way, especially with the XF551 drive. In 2020 Holger Janz picked up the sources and has continued development, and BW-DOS 1.5 (November 2024) is an active modern DOS.

Design

BW-DOS is split, like SpartaDOS, into a resident part and disk-based commands:

  • The resident part (a file with the .DOS extension) contains the Command Processor and the File Management System. In version 1.30 it sets MEMLO to $1EE4. The manual points out that other DOSes configured for five drives and five open files end up above $2000.
  • Internal commands run without touching user memory, so you can return to BASIC with your program intact.
  • External commands are small programs loaded from disk each time.
  • Resident commands stay in memory and add features. They can be removed again by running them with OFF, but only in reverse order of installation.

BW-DOS does not use the RAM under the XL/XE OS ROM, so it gets along with programs that need it, notably Turbo-BASIC XL. It supports drives 1, 2, 3, 4 and 8, up to 5 open files, disks of up to 16MB and single files of up to 8MB. A directory can hold up to 1,424 entries; SpartaDOS X reads such directories in full, but older SpartaDOS versions see only the first 126 entries. The manual recommends staying under about 100 per directory for speed.

Using the command line

Paths work as in SpartaDOS: > separates directories, a leading > starts at the main directory and each < goes up one level. A directory called DOS in the main directory is special: programs not found in the current directory are looked for there. That is the place for external commands. A typical listing looks like this:

D1:DIR
Volume:    TESTS
Directory: MAIN
DOS        <DIR>  11-06-94 16:01
TEST1  BAS  1231  11-06-94 16:32
 573 FREE SECTORS

DIRS gives a DOS 2-style listing in sectors instead. Other commands from the 1.30 manual:

Command Type Purpose
CWD, CREDIR, DELDIR internal change, create and delete directories
CHKDSK, CHVOL external disk information, change volume name
BOOT file external make a disk boot a given .DOS (or other) file
MENU external menu front end; also copies to and from Atari DOS 2 disks
RAMDISK n[E][F] resident RAM disk of up to 1MB on 130XE-compatible memory
XFSIO n resident XF551 high-speed I/O, about 2.5 times faster
KEYBUFF ON resident 32-key type-ahead buffer
AUTOCWD, DOSDRIVE n resident keep a working directory after RESET; look for commands on a set drive (such as a RAM disk)

Atari DOS 2-format disks (single, enhanced and double density) are handled only by the MENU program, which converts files in both directions. Remember that DOS 2 filenames cannot contain _.

Versions

  • 1.00 (16 June 1994) and 1.10 (14 July 1994), identical apart from its boot message, which credits BeWeSoft and ABBUC.
  • Update #1 (April 1995): new MENU, RAMDISK and DIRMAST, the MOVE command, and support for the ICD R-Time 8 and ARGS clock cartridges.
  • 1.30 / Update #2 (17 December 1995): better placement of directories on disk for faster access while staying fully compatible with SpartaDOS 2.x and later, new BACKUP, COPY and UNERASE, DOSDRIVE and NEWED, and a RAMBOX RAM-disk driver.
  • 1.31 (2020–21, Holger Janz): first developed as BW-DOS TC for The!Cart cartridge.
  • 1.4 (June 2023): needs only 16K. It always starts the command processor and uses CAR to enter a cartridge. Commands were renamed to MS-DOS style (CD, MD, RD, DEL, REN, LOCK, UNLOCK), and a MAN command shows manual pages.
  • 1.5 (6 November 2024): a command processor variant with no internal commands for the lowest MEMLO, new external versions of the common commands, recursive /R options for COPY, DEL and SORTDIR, a new ED text editor, and restored DOS 2 vectors so OSS's BUG/65 debugger works again.

Using it today

BW-DOS is a good default for Turbo-BASIC XL work, for machines without a SpartaDOS X cartridge, and for anyone who wants SpartaDOS-format hard-disk or ATR images without a commercial product. The source and current releases are on Holger Janz's GitHub repository (HolgerJanz/BW-DOS), and version 1.30 disk images are widely mirrored. If you upgrade from 1.30, note the renamed commands in 1.4 and later, and use MAN to look up any command.

Credits