bluescsi.ini

The bluescsi.ini file is for setting advanced configuration.

If your system requires specific settings you can find notes on the Compatibility page.

NOTE: Most users will NOT need to create this file, and should not unless you have a reason to.

.ini file generator

You can find a bluescsi.ini file generator at https://ini.bluescsi.com

Options

Sections

Global Section

• Configuration under the [SCSI] header is applied to all drives and global configuration.

Per Device

• eg: [SCSI3] settings are only applied to ID 3.

Settings

System

global

Select a system preset to apply default settings Known systems: "Generic", "MacPlus", "MegaSTE", "X68000"

System="MacPlus"

Debug

global

Enable or disable Debug logs, 0 off (default) or 1 on.

DebugLogMask

global

Filter the debug log to only ID's that match the mask, represented as an int. Debug must be on for this to have an effect.

Debug=1 ; Debug must be on
DebugLogMask=9 ; Will log only SCSI ID 0 and 3 as b`1001` == `9`

SelectionDelay

global

Millisecond delay after selection, 255 = automatic (default), 0 = no delay

Quirks

global or device

0: Standard, 1: Apple (Default), 2: OMTI, 4: Xebec, 8: VMS, 16: X68000

Prefer a System preset profile instead if provided for Generic/Apple/X68000.

Dir

global

Optionally look for image files in subdirectory

Dir1...Dir9

global or device

Multiple directories can be specified Dir1...Dir9, eg

Dir2="/CDs"

IMG0...IMG9

device

Specify multiple files to back a particular drive. eg: multiple ISO's for switching between them on eject.

[SCSI3]
Type=2 # CD
IMG0=System 7.6.iso
IMG1=SuperWingCommander.toast
IMG2=Ultimate Doom.toast

EnableUnitAttention

global

Post UNIT_ATTENTION status on power-on or SD card hotplug, default off, 1 to enable.

EnableSCSI2

global

Enable SCSI2, default on

Sends seek reply in 10ns vs 10ms.

EnableSelLatch

global

For Philips P2000C and other devices that release SEL signal before BSY, default off, 1 to enable.

EnableParity

global

Enable parity checks on platforms that support it, default on, 0 to disable.

MapLunsToIDs

global

For Philips P2000C or MegaSTE to simulate multiple LUNs on one SCSI ID, default off, 1 to enable.

Requires at least one disk on ID: 0

MaxSyncSpeed

global

Set to 5 or 10 default to enable synchronous SCSI mode, 0 to disable

SCSI Vendor Information

global or device

Can be set per device:

Vendor = "QUANTUM"
Product = "FIREBALL1"
Version = "1.0"
Serial = "0123456789ABCDEF"

SectorsPerTrack

device

How many sectors per track the disk has, default 63.

HeadsPerCylinder

device

How many HeadsPerCylinder the disk has, default 255.

BlockSize

device

Set the blocksize for the drive. Defaults to 2048 for CD's and 512 for everything else. Normally not required.

RightAlignStrings

device

Right-align SCSI vendor / product strings, defaults on if Quirks=1 (Apple), otherwise off.

PrefetchBytes

device

Maximum number of bytes to prefetch after a read request, 0 to disable. Default 8192

ReinsertCDOnInquiry

global or device Reinsert any ejected CD-ROM image on Inquiry command, 1 to enable, default off.

ROM settings

For more ROM Drive details see ROM Drive .

DisableROMDrive

global

Disable the ROM drive if it has been loaded to flash, default enabled. 1 to disable.

ROMDriveSCSIID

global

Override ROM drive's SCSI ID, default 2.

InitiatorMode

global

Puts the BlueSCSI into initiator mode instead of Target mode for cloning drives. See Initiator-Mode for more details on its usage.

InitiatorParity

global

Disables parity when in Initiator mode. Useful for very old drives that do not support Parity.

SDIO

The following should only be used if directed to when troubleshooting issues.

[SDIO]

AddClockDelay

Adds a clock cycle delay to the SDIO communications. 1 or 2 are valid.

Less common

DisableConfigHook

global

Config Hooks can be provided to do some custom logic during device configuration. Currently the only one is run when Quirks is Apple to give the user guidance. You can skip these by setting your Quirks to Generic or completely skip them with DisableConfigHook.

Type

device

Use file name conventions instead of type. See Usage.

0: Fixed, 1: Removable, 2: Optical, 3: Floppy, 4: Mag-optical, 5: Tape

TypeModifier

device

Affects only INQUIRY response.

The device-type modifier field was defined in SCSI-1 to permit vendor- specific qualification codes of the device type. This field is retained for compatibility with SCSI-1. Targets that do not support this field should return a value of zero.

https://www.staff.uni-mainz.de/tacke/scsi/SCSI2-08.html

Raw

device

Raw sector range from SD card can be passed through

Format is RAW:first_sector:last_sector where sector numbers can be decimal or hex. If end sector is beyond end of SD card, it will be adjusted automatically.

See also RAW Mode

Only useful for migrating a SD card from SCSI2SD v5/6.

[SCSI4]
IMG0 = RAW:0x00000000:0xFFFFFFFF # Whole SD card