mirror of
https://github.com/erichelgeson/BlueSCSI.git
synced 2024-06-17 22:29:29 +00:00
Moving usage to wiki
parent
b131367883
commit
a6a8d841e8
63
Usage.md
Normal file
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.
|
Loading…
Reference in New Issue
Block a user