bluescsi.ini - BlueSCSI/BlueSCSI-v2 GitHub Wiki
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.
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