Moving usage to wiki

Eric Helgeson 2021-06-13 10:12:44 -05:00
parent b131367883
commit a6a8d841e8

63
Usage.md Normal file

@ -0,0 +1,63 @@
## Usage
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 drives 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 - Set to 0 if unsure.
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:
* [SD Card Prep](https://youtu.be/WuXM1oGt8cE)
* [Create your own MacOS image](https://youtu.be/2O-2HR9pJlI)
### Examples
`HD10_512.hda` - Hard Disk at SCSI ID 1, LUN 0, sector size of 512.
`HD51_512 System 6.0.8L LC.hda` - Hard Disk at SCSI ID 5, LUN 1, 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. You can use an emulator such as (Basilisk II)[https://www.emaculation.com/doku.php/basiliskii_osx_setup] on your modern machine to get software from places like the [Macintosh Garden](https://macintoshgarden.com) to your vintage mac.
* Premade for RaSCSI work on BlueSCSI too - Rename the files based on the Usage instructions above. - http://macintoshgarden.org/apps/rascsi-68kmla-edition
### Blanks
These are blank, formatted drives. If you want to install an OS or software on an empty drive, use one of these.
* Preformatted HFS blank images in various sizes - https://github.com/erichelgeson/BlueSCSI/tree/main/docs/MacHD.zip
- Unzip and rename to use.
### 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 https://ss64.com/osx/dd.html[dd] 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`
* 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.
4. If you do not already have a tool to format SCSI drives, [download LIDO](https://macintoshgarden.org/apps/lido-756). 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.
5. After booting into your target machine with the working Mac OS disk image on your BlueSCSI from step 3, format the blank disk.