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.
You can find a bluescsi.ini file generator at https://ini.bluescsi.com
- Configuration under the
[SCSI]header is applied to all drives and global configuration.
- eg:
[SCSI3]settings are only applied to ID 3.
global
Select a system preset to apply default settings Known systems: "Generic", "MacPlus", "MegaSTE", "X68000"
System="MacPlus"global
Enable or disable Debug logs, 0 off (default) or 1 on.
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`global
Millisecond delay after selection, 255 = automatic (default), 0 = no delay
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.
global
Optionally look for image files in subdirectory
global or device
Multiple directories can be specified Dir1...Dir9, eg
Dir2="/CDs"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.toastglobal
Post UNIT_ATTENTION status on power-on or SD card hotplug, default off, 1 to enable.
global
Enable SCSI2, default on
Sends seek reply in 10ns vs 10ms.
global
For Philips P2000C and other devices that release SEL signal before BSY, default off, 1 to enable.
global
Enable parity checks on platforms that support it, default on, 0 to disable.
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
global
Set to 5 or 10 default to enable synchronous SCSI mode, 0 to disable
global or device
Can be set per device:
Vendor = "QUANTUM"
Product = "FIREBALL1"
Version = "1.0"
Serial = "0123456789ABCDEF"device
How many sectors per track the disk has, default 63.
device
How many HeadsPerCylinder the disk has, default 255.
device
Set the blocksize for the drive. Defaults to 2048 for CD's and 512 for everything else. Normally not required.
device
Right-align SCSI vendor / product strings, defaults on if Quirks=1 (Apple), otherwise off.
device
Maximum number of bytes to prefetch after a read request, 0 to disable. Default 8192
global or device
Reinsert any ejected CD-ROM image on Inquiry command, 1 to enable, default off.
For more ROM Drive details see ROM Drive .
global
Disable the ROM drive if it has been loaded to flash, default enabled. 1 to disable.
global
Override ROM drive's SCSI ID, default 2.
global
Puts the BlueSCSI into initiator mode instead of Target mode for cloning drives. See Initiator-Mode for more details on its usage.
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.
device
Use file name conventions instead of type. See Usage.
0: Fixed, 1: Removable, 2: Optical, 3: Floppy, 4: Mag-optical, 5: Tape
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
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