[!IMPORTANT] If you are looking for BlueSCSI v2 documentation please go here: https://github.com/BlueSCSI/BlueSCSI-v2/wiki

New Settings File

From v1.1-20230708, BlueSCSI now uses the file bluescsi.ini located on the root of the SD card to configure all custom settings.

You should normally not have to use these unless you have a system that requires some special handling as noted below.

File Format

The bluescsi.ini file uses standard INI file syntax, and a complete example might look something like this:

; Main section for global settings
[SCSI]
; Enables "Mega STE" mode
MapLunsToIDs=1

; Other sections are scoped to the SCSI ID you want to change
[SCSI0]
; Forces a particular device type, 0 = HDD, 2 = CDROM
type=2
; Overrides the standard SCSI vendor name, max 8 characters
vendor=MATSHITA
; Overrides the standard SCSI product name, max 16 characters
product=CD-ROM CR-8004
; Overrides the standard SCSI revision number, max 4 characters
revision=1.1f

[SCSI2]
type=0
vendor=BLUESCSI
product=F1
revision=1.1

Older Versions

Older releases of BlueSCSI used a few different files at the root of the SD card for custom settings

SCSI Vendor config scsi-config.txt

By default the BlueSCSI is detected as a QUANTUM BLUESCSI F1 1.0 - which is great for Vintage Mac computers.

If you wish to override this you can place a text file on the root of the SD Card named scsi-config.txt with three lines each ending with a new line:

• The first line is the vendor and must be exactly 8 characters. (add spaces if not)
• The second line is the product and must be exactly 16 characters. (add spaces if not)
• The third line is the version and must be exactly 4 characters. (add spaces if not)

Example (· == blank space):

SEAGATE·
ST410800N·······
1.0·

This file works on releases v1.1-20220626 through v1.1-20221203

Mega STE Mode MSTE_MODE

If you have an Atari Mega STE, place a file in the root of your SD card named MSTE_MODE. This will map SCSI IDs to LUNs as required for this devices (and possibly others).

The Mega STE internal SCSI/ACSI adapter only supports devices on SCSI ID 0 which limits the usefulness of BlueSCSI in this situation. MSTE_MODE enables the SCSI IDs to be remapped as LUNs for SCSI ID 0 so you can use multiple devices with the internal adapter. This is well supported and tested against HDDRIVER written by Uwe Seimet. Other ACSI/SCSI drivers were not tested at this time but it is expected that any driver supporting multiple LUNs will also support this new feature.

This file only works on release v1.1-20221203