Skip to content

Usage

Jump to bottom Edit New page
AiGeek edited this page May 11, 2023 · 33 revisions

Hard Disk image files are placed in the root directory of a ExFat or FAT32 formatted SD card . Use a premade or blank disk below. You can have up to 7 image files on one BlueSCSI.

Note: BlueSCSI images are compatible with the PiSCSI and Basilisk II emulator.

The naming convention is as follows (file name max 64 characters). Note you may use multiple images at a time with different SCSI ID's.

HDxy_512.hda, CDxy_2048.iso

Image Type (required):

HD - Hard Disk
CD - Optical
FD - Floppy
MO - Magneto Optical
RE - Removable
TP - Sequential Tape

Image SCSI ID - optional, if not provided defaults to 1. 0-7. Supports up to 7 devices at a time.

x

LUN(Logical Unit Number) - (Optional, defaults to 0, currently only supports 0)

y

Sector size. Optional - only set if you need to change. Defaults to 512 if unsure. 256, 512, 1024, 2048, 4096, & 8192 supported.

512

Examples

HD10_512.hda - Hard Disk at SCSI ID 1, LUN 0, sector size of 512.

HD6 - System 7 Quada 700.hda - CD at ID 6, LUN 0, and 512 sector size.

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.

CD3 Myst.iso - CD at ID 3.

Video Tutorials

If you'd like a video walk through of these steps here are a few:

Bad

HD99_712 foo bar fizz buzz buzz buzz foo bar fizz buzz bang.hda Over 64 chars and invalid SCSI/LUN/Block size

If no image files are found, the green LED on the Pico module 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 on your modern machine to transfer files & software from places like the Macintosh Garden to your vintage mac.

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 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

  1. If you do not already have a tool to format SCSI drives, download Apple HD SC Setup. NOTE: You can use an emulator such as Basilisk II to move files to the image to prepare your installation, but not to format.
  2. After booting into your target machine with the working Mac OS disk image on your BlueSCSI from step 3, format the blank disk.

Hard Disk Image Sets

  • Any hard disk images should be placed in root dir / of SD card or Dir2 ... Dir9 defined by [SCSI] Global config
  • Format the name of every image as HD#0-XXXX.IMG or HD#0-XXXX.HDA to secified hard disk type and SCSI ID # ( # = 0 - 7 and keep unique )

CD-ROM Image Sets

Fixed mode (not recommended) Good at quick setup for single image:

  • Single or multiple CD-ROM images could be placed in root dir / of SD card or Dir2 ... Dir9 defined by [SCSI] Global config
  • Format the name of every image as CD#0-XXXX.IMG or CD#0-XXXX.HDA to specified SCSI ID # ( # = 0 - 7 and keep unique )

Loop mode (recommended)
Multiple CD-ROM images can be cycled automatically when CD-ROM drive is ejected (dragged to trash), it should be defined in bluescsi.ini as below:

  • Define a SCSI ID # for CD-ROM drive in [SCSI#] ( # = 0 - 7 and keep unique, 3 is default for Macintosh CD-ROM drive)
  • Put all CD-ROM images into a IMAGEDIR such as /CDImages, the IMAGEDIR should not defined in [SCSI] Global config
  • Use TYPE = 2 to define all images as CD-ROM drive, no need to format the name of image anymore
  • Define IMG0 ... IMG9 for every CD-ROM image one by one as IMG# = IMAGEDIR/IMAGENAME

The sample of bluescsi.ini :

[SCSI]
ReinsertCDOnInquiry = 1

[SCSI3]
Type = 2
IMG0 = /CDImages/OS761S_CH691-1634A.iso
IMG1 = /CDImages/OS753S_CH006-0125.iso
IMG2 = /CDImages/SuperWingCommander.toast
IMG3 = /CDImages/Ultimate Doom.toast
IMG4 = /CDImages/StuffIt Deluxe 5.5 CD.toast
IMG5 = /CDImages/MacBench 5.0 CD.toast
IMG6 = /CDImages/MacBench 4.0 CD.toast

Add a custom footer

BlueSCSI Logo

Clone this wiki locally