diff --git a/Doc/RomWBW Applications.pdf b/Doc/RomWBW Applications.pdf index a22fa2ac..e79fa5dc 100644 Binary files a/Doc/RomWBW Applications.pdf and b/Doc/RomWBW Applications.pdf differ diff --git a/Doc/RomWBW Disk Catalog.pdf b/Doc/RomWBW Disk Catalog.pdf index c2004592..f1a917a6 100644 Binary files a/Doc/RomWBW Disk Catalog.pdf and b/Doc/RomWBW Disk Catalog.pdf differ diff --git a/Doc/RomWBW Errata.pdf b/Doc/RomWBW Errata.pdf index 6a38648d..c8481cbf 100644 Binary files a/Doc/RomWBW Errata.pdf and b/Doc/RomWBW Errata.pdf differ diff --git a/Doc/RomWBW ROM Applications.pdf b/Doc/RomWBW ROM Applications.pdf index 3899e881..275f4c4f 100644 Binary files a/Doc/RomWBW ROM Applications.pdf and b/Doc/RomWBW ROM Applications.pdf differ diff --git a/Doc/RomWBW System Guide.pdf b/Doc/RomWBW System Guide.pdf index fe16f64d..c12c6186 100644 Binary files a/Doc/RomWBW System Guide.pdf and b/Doc/RomWBW System Guide.pdf differ diff --git a/Doc/RomWBW User Guide.pdf b/Doc/RomWBW User Guide.pdf index 52ff1475..d4530754 100644 Binary files a/Doc/RomWBW User Guide.pdf and b/Doc/RomWBW User Guide.pdf differ diff --git a/ReadMe.md b/ReadMe.md index 027985a6..61984164 100644 --- a/ReadMe.md +++ b/ReadMe.md @@ -3,7 +3,7 @@ **RomWBW ReadMe** \ Version 3.5 \ Wayne Warthen ([wwarthen@gmail.com](mailto:wwarthen@gmail.com)) \ -13 Feb 2024 +16 Feb 2024 # Overview diff --git a/ReadMe.txt b/ReadMe.txt index 42ead9d7..23bd32b9 100644 --- a/ReadMe.txt +++ b/ReadMe.txt @@ -1,6 +1,6 @@ RomWBW ReadMe Wayne Warthen (wwarthen@gmail.com) -13 Feb 2024 +16 Feb 2024 diff --git a/Source/Doc/UserGuide.md b/Source/Doc/UserGuide.md index 5cb876f8..231a7154 100644 --- a/Source/Doc/UserGuide.md +++ b/Source/Doc/UserGuide.md @@ -2674,34 +2674,95 @@ containing the Fuzix image at the RomWBW Loader prompt. To create a Fuzix disk image: * Locate and download the Fuzix disk image for your system from - . + . For each platform, you will typically + find two image files. An emulator image (`emu-xxx.img`) and a + disk image (`disk.img`). You want the disk image file. -* Remove the 1KB header from the image file. The Fuzix disk images - are built to run under an emulator that requires a 1KB prefix. You - must remove this prefix before writing the image to your physical - disk media. Unix dd is the easiest way to do this: - - `dd bs=1024 skip=1 if=sc126-0.3.ide of=sc126-0.3.trimmed` - -* Write the trimmed image to your disk media. This can also be - done with dd or with Win32DiskImager under Windows. +* Write the disk image file to your physical media (CF Card, SD Card, + etc.) starting at the beginning of the media (first sector). Do + not combine the Fuzix image with the RomWBW disk images -- they are + entirely separate. To boot into Fuzix: +* Insert your Fuzix disk media. + * Power-up or reset your system. RomWBW should load normally and bring you to the RomWBW Boot Loader prompt. -* Change your baud rate to 38,400. This can be done from the - RomWBW Boot Loader prompt with the following command: +* Depending on the platform, Fuzix may be built to run at a different + baud rate that the default RomWBW baud rate. If so, it is best to + change your RomWBW baud rate prior to initiating the Fuzix startup. + You can do this at the loader prompt with a command like this: `I 0 38400` - You will also need to change your terminal baud rate at this time. + Replace 38400 with the desired baud rate for Fuzix. You will be + prompted to change your terminal's baud rate at this time. + +* At the RomWBW Boot Loader prompt, enter the disk unit number of + the Fuzix media. Fuzix should load and you will see device + discovery/information messages that vary depending on your + platform. This is a typical example: + + ``` + RCBus [RCZ180_nat_wbw] Boot Loader + FP Switches = 0x00 + + Boot [H=Help]: 2 + + Booting Disk Unit 2, Slice 0, Sector 0x00000000... + + Volume "Fuzix 126 Loader" [0xF200-0xF400, entry @ 0xF200]... + FUZIX version 0.4 + Copyright (c) 1988-2002 by H.F.Bower, D.Braun, S.Nitschke, H.Peraza + Copyright (c) 1997-2001 by Arcady Schekochikhin, Adriano C. R. da Cunha + Copyright (c) 2013-2015 Will Sowerbutts + Copyright (c) 2014-2023 Alan Cox + Devboot + 512kB total RAM, 448kB available to processes (15 processes max) + Enabling interrupts ... ok. + 0000 : CF Card - OK + 0001 : - absent + hda: hda1 hda2 (swap) + bootdev: + ``` * At the `bootdev:` prompt, enter `hda1`. Fuzix should load and - you will be prompted for a date/time. + you will be prompted for a date/time. Here is a typical example: + + ``` + bootdev: hda1 + Mounting root fs (root_dev=1, ro): OK + Starting /init + init version 0.9.1 + Checking root file system. + Current date is Fri 2023-08-18 + Enter new date: + Current time is 13:30:24 + Enter new time: + + ^ ^ + n n Fuzix 0.4 + >@< + Welcome to Fuzix + m m + + login: + ``` + +* At the `login:` prompt, enter `root`. No password is required. You + should then get a Fuzix `#` command prompt. + + ``` + login: root + + Welcome to FUZIX. + # + ``` -* At the `login:` prompt, enter `root`. No password is required. +You may now use Fuzix as desired. The general operation and use of +Fuzix is outside of the scope of this document. # Custom Applications