From c8db80d854123ad1e1d10aedf883dda28427e091 Mon Sep 17 00:00:00 2001 From: Eric Helgeson Date: Sun, 8 May 2022 20:03:11 -0500 Subject: [PATCH] Move page to avoid hotlink --- Using-BlueSCSI.md | 67 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 Using-BlueSCSI.md diff --git a/Using-BlueSCSI.md b/Using-BlueSCSI.md new file mode 100644 index 0000000..9ceb866 --- /dev/null +++ b/Using-BlueSCSI.md @@ -0,0 +1,67 @@ +Hard Disk image files are placed in the root directory of a `ExFat` or `FAT32` formatted SD card. [`ExFat` is much faster](https://twitter.com/theory_retro/status/1376571371694723076). Use a premade or blank disk below. + +Note: BlueSCSI images are compatible with the [RaSCSI](https://rascsi.com) and Basilisk II emulator. + +The naming convention is as follows (file name max 32 characters). Note you may mount multiple images at a time to different SCSI ID's. + +`HDxy_512.hda` +``` +HD - Hard Disk +x - SCSI ID to attach to. 0-7 (though 7 on a Macintosh is the System) +y - LUN ID - Always set to 0. +512 - Sector size. Set to 512 if unsure. 256, 512, & 1024 supported. +``` + +### Video Tutorials + +If you'd like a video walk through of these steps here are a few: + +* [Getting your BlueSCSI working on your classic Mac is WAY easier than you think (Rons Computer Videos)](https://www.youtube.com/watch?v=szXAcwyee9g) +* [Tutorial - SD Card Prep BlueSCSI (GeekyBit)](https://youtu.be/WuXM1oGt8cE) +* [Tutorial - Blank Image BlueSCSI (GeekyBit)](https://youtu.be/2O-2HR9pJlI) + + +### Examples + +`HD10_512.hda` - Hard Disk at SCSI ID 1, LUN 0, sector size of 512. + +`HD50_512 System 6.0.8L LC.hda` - Hard Disk at SCSI ID 5, LUN 0, sector size of 512. Text between block size and .hda is ignored. + +#### Bad + +`HD99_712 foo bar fizz buzz bang.hda` Over 32 chars and invalid SCSI/LUN/Block size + +If no image files are found PC13 will pulse on and off. Check the LOG.txt on the root of the SD card for any errors. + +### Premade Images + +Premade images are handy to just drop onto your SD card and go. Use [one of these methods](https://github.com/erichelgeson/BlueSCSI/wiki/Transferring-files-(Mac)) on your modern machine to transfer files & software from places like the [Macintosh Garden](https://macintoshgarden.org) to your vintage mac. + +* A collection of blanks and premade images - https://mega.nz/folder/8hA3AQCJ#pWUq92L70yDXlogy9lk5Dg + +* Premade for RaSCSI work on BlueSCSI too - Rename the files based on the Usage instructions above. - http://macintoshgarden.org/apps/rascsi-68kmla-edition + +* A nice image that works with the Mac Plus with 1000 apps/games - https://archive.org/details/macpack-20210619 + +* Create your own custom disk images with [Disk Jockey](https://bluescsi.onegeekarmy.eu/diskjockey/) + +### Custom Disk Images (Advanced) + +This technique is useful when you would like a disk image larger than the pre-built images in the previous section. + +The following instructions demonstrates the process using [dd](https://ss64.com/osx/dd.html) on a modern Mac: + +1. Open terminal. +2. The following command will create a blank disk image. You can modify the command to suit your use. + * `dd if=/dev/zero of=example.hda bs=1m count=500` + * NOTE: On Linux systems, if you receive the error `dd: invalid number: '1m'`, you need to capitalize the 'm'. + * Example: `dd if=/dev/zero of=example.hda bs=1M count=500` + * The `count` field defines the number of megabytes (`bs=1m`) the total disk image should be. + * The output file from the command is "example.hda". This can be changed in the `of=example.hda` field. +3. Place the new blank disk image in the root directory of your SD card. + +#### Format HFS for Macs + +4. If you do not already have a tool to format SCSI drives, [download Apple HD SC Setup](https://macintoshgarden.org/apps/apple-hd-sc-setup-753-patch). +NOTE: You can use an emulator such as [Basilisk II](https://www.emaculation.com/doku.php/basiliskii_osx_setup) to move files to the image to prepare your installation, but not to format. +5. After booting into your target machine with the working Mac OS disk image on your BlueSCSI from step 3, format the blank disk. \ No newline at end of file