bluescsi.ini
The bluescsi.ini file is for setting advanced configuration.
Important
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 applies to all drives and global system settings.
Settings under [SCSI0] through [SCSI7] headers apply only to that specific SCSI ID.
Section: [SCSI]
Enable detailed logging for troubleshooting SCSI communication issues.
Enables verbose debug logging to help diagnose problems with SCSI communication and device operations. Debug logs are written to the log file on the SD card. Warning: This significantly reduces performance and should only be enabled when troubleshooting issues.
Default: disabled
Section: [SCSI]
Filter out repetitive BUSY and FREE status messages from debug logs.
When debug logging is enabled, this setting suppresses the frequent BUSY and FREE status messages to make logs more readable. Only enable this when you need to focus on other SCSI messages without the clutter of routine status updates.
Default: disabled
Section: [SCSI]
Choose which SCSI device IDs to include in debug logs (as a bitmask).
Filters debug output to only show messages for specific SCSI IDs. Each bit represents one ID (0-7). For example, value 9 (binary 1001) logs only IDs 0 and 3. Value 255 (binary 11111111) logs all devices. This is useful when troubleshooting a specific device without cluttering logs with activity from others.
Default: 255 (all devices)
Section: [SCSI]
Specify a subdirectory on the SD card where image files are located.
Look for disk image files in a specific subdirectory instead of the root of the SD card. This helps organize multiple images. For example, setting Dir="/Games" tells BlueSCSI to find images in the Games folder. Use forward slashes for paths.
Default: /
Section: [SCSI]
Disable I2C communication for external displays or sensors.
Disables the I2C interface used for optional external displays and sensors. This can resolve conflicts if you're experiencing issues with I2C peripherals. Most users will not need to change this setting.
Default: disabled
Section: [SCSI]
Prevent the built-in ROM drive image from appearing as a device.
Hides the optional ROM drive that can be flashed into BlueSCSI's memory. The ROM drive is a small disk image stored directly on the device, useful for boot disks or utilities. Disable this if you don't need the ROM drive or want to free up a SCSI ID.
Default: disabled
Section: [SCSI]
Turn off the status LED indicator.
Disables the LED that shows BlueSCSI activity. Useful if the LED brightness is distracting. Most users should leave this enabled for visual feedback of device activity.
Default: disabled
Section: [SCSI]
Enable audio playback for CD-ROM images with audio tracks.
Allows BlueSCSI to play audio tracks from CD-ROM images through the audio output. This is needed for mixed-mode CDs that contain both data and audio, or audio CDs. Requires compatible hardware with audio output capabilities.
Default: enabled
Section: [SCSI]
Enable parity checking to detect data transmission errors on the SCSI bus.
Parity checking adds an extra bit to each byte transmitted on the SCSI bus to detect errors. Modern systems should keep this enabled for data integrity. Some very old systems or devices may not support parity and require it to be disabled. If you experience communication errors with older hardware, try disabling this.
Default: enabled
Section: [SCSI]
Enable SCSI-2 features for faster performance and better compatibility with modern systems.
Activates SCSI-2 protocol features, including faster seek times and improved command support. SCSI-2 changes seek command timing from 10ms to 10ns for better performance. Keep enabled for modern systems. Disable only if you have a very old SCSI-1 system that has compatibility issues.
Default: enabled
Section: [SCSI]
Support systems that release the SEL signal early during device selection.
Some older systems like the Philips P2000C release the SEL (selection) signal before asserting BSY (busy), which violates standard SCSI timing. Enable this for compatibility with such systems. Most users should leave this disabled.
Default: disabled
Section: [SCSI]
Enable BlueSCSI Toolbox features for file sharing and utilities.
Activates the BlueSCSI Toolbox, which provides advanced features like file sharing between the host computer and SD card, configuration tools, and diagnostic utilities. The Toolbox appears as a special device that compatible software can access. Required for shared folder functionality on Macintosh systems.
Default: enabled
Section: [SCSI]
Make the SD card appear as a USB drive when connected to a computer.
When enabled and BlueSCSI is connected via USB to a computer, the SD card appears as a removable USB drive. This allows easy file transfer and management of disk images. Warning: Make sure the vintage computer is powered off before connecting USB, as simultaneous access can corrupt the SD card.
Default: disabled
Section: [SCSI]
Notify the host system when media is changed or BlueSCSI is powered on.
When enabled, BlueSCSI reports a UNIT_ATTENTION status to inform the host that media may have changed due to power-on, reset, or SD card insertion. Some systems handle this gracefully, others may show errors. Enable this for proper hot-swap support on compatible systems.
Default: disabled
Section: [SCSI]
Set a delay in milliseconds after BlueSCSI initialization completes.
Adds a pause after BlueSCSI finishes initializing but before it starts responding to SCSI commands. Some systems need time to stabilize before SCSI devices become active. Increase this if your system doesn't detect BlueSCSI reliably on startup. Each unit is 1 millisecond.
Default: 0
Section: [SCSI]
Set a delay in milliseconds before BlueSCSI initialization starts.
Adds a pause when BlueSCSI powers on before it begins initializing. This can help with systems that need the SCSI bus to be quiet during their own startup. Increase this if your system fails to boot or shows erratic behavior during power-on. Each unit is 1 millisecond.
Default: 0
Section: [SCSI]
Set the SCSI ID that BlueSCSI uses when in Initiator Mode.
When BlueSCSI is in Initiator Mode (for cloning or copying drives), this sets which SCSI ID it uses to communicate with target devices. Typically SCSI initiators use ID 7, which is the highest priority. Only relevant when InitiatorMode is enabled.
Default: 7
Section: [SCSI]
Control how BlueSCSI names cloned disk images in Initiator Mode.
Determines the file naming behavior when cloning drives in Initiator Mode. Options: 0 = overwrite existing, 1 = increment filename if exists (default), 2 = always create new numbered file. Incremental numbering prevents accidentally overwriting previous clones.
Default: 1 (increment if exists)
Options:
-
0- Overwrite: Replace existing image file -
1- Increment: Add number to filename if exists -
2- Always New: Always create numbered file
Section: [SCSI]
Use USB Mass Storage instead of SD card for storing cloned images.
In Initiator Mode, write cloned disk images to a USB-connected mass storage device instead of the SD card. Useful when the SD card doesn't have enough space for large clones. Requires a USB drive connected to compatible BlueSCSI hardware.
Default: disabled
Section: [SCSI]
Disable read-ahead optimization when writing to USB storage in Initiator Mode.
Turns off prefetching when using USB mass storage in Initiator Mode. Prefetching improves performance by reading ahead, but may cause issues with some USB devices. Disable if you experience corruption or errors when cloning to USB.
Default: disabled
Section: [SCSI]
Set delay in milliseconds before accessing USB storage in Initiator Mode.
How long to wait after detecting a USB device before using it for cloning operations. Some USB drives need time to initialize fully. Increase this value if USB drives aren't being detected properly in Initiator Mode.
Default: 1000
Section: [SCSI]
Prevent modifications to USB storage when in Initiator Mode.
Mount the USB drive as read-only in Initiator Mode. This prevents accidental writes or corruption of data on the USB device. Useful if you're using the USB drive for reference images but want to protect it from changes.
Default: disabled
Section: [SCSI]
Set how often (in milliseconds) to check USB drive status during cloning.
How frequently BlueSCSI checks the USB drive status during cloning operations. Lower values provide more responsive error detection but may reduce performance slightly. Default is 5000ms (5 seconds).
Default: 5000
Section: [SCSI]
Set maximum retry attempts for failed SCSI commands in Initiator Mode.
How many times BlueSCSI will retry a failed SCSI command when cloning a drive. Higher values provide better reliability with marginal drives but slow down cloning when errors occur. Set lower if you want to fail fast on bad drives.
Default: 5
Section: [SCSI]
Enable Initiator Mode to clone or copy SCSI drives to image files.
Switches BlueSCSI from Target Mode (acting as a drive) to Initiator Mode (acting as a SCSI controller). In this mode, you can connect real SCSI drives to BlueSCSI and clone them to disk image files on the SD card. This is useful for backing up or archiving physical SCSI drives. See documentation for detailed instructions.
Default: disabled
Section: [SCSI]
Enable parity checking when cloning drives in Initiator Mode.
Controls whether parity checking is used during Initiator Mode operations. Some very old drives don't support parity and will fail to respond if it's enabled. Disable this if you're cloning vintage drives that have issues with parity.
Default: enabled
Section: [SCSI]
Use 10-byte READ commands instead of 6-byte when cloning in Initiator Mode.
Controls which SCSI READ command format is used during cloning. The 10-byte READ(10) command supports larger transfers and is preferred by modern drives, while the 6-byte READ(6) is more compatible with very old drives. Enable this for SCSI-2 and newer drives.
Default: disabled
Section: [SCSI]
Reverse the status LED polarity for custom hardware configurations.
Flips the LED control signal, useful for custom BlueSCSI builds or modifications where the LED is wired with opposite polarity. If your LED is on when it should be off and vice versa, enable this setting.
Default: disabled
Section: [SCSI]
Simulate multiple LUNs (Logical Unit Numbers) on a single SCSI ID.
Maps LUN numbers to different SCSI IDs, allowing multiple devices to appear under one ID. Required for Philips P2000C and Atari MegaSTE systems. Requires at least one device on ID 0. Most systems don't need this and should leave it disabled.
Default: disabled
Section: [SCSI]
Set the maximum SCSI synchronous transfer speed (0=async, 5=5MHz, 10=10MHz).
Controls the maximum speed for synchronous SCSI transfers. Set to 10 for 10MHz (fastest), 5 for 5MHz (more compatible), or 0 to disable synchronous mode entirely (slowest, most compatible). If you experience data corruption or errors, try lowering this value or setting to 0 for asynchronous mode.
Default: 10
Options:
-
0- Asynchronous: Slowest, maximum compatibility -
5- 5 MHz: Medium speed, good compatibility -
10- 10 MHz: Fastest speed
Section: [SCSI]
Set the maximum audio volume limit for CD playback.
Sets an upper limit on the audio output volume for CD audio. This prevents the volume from being set too high by software. Useful if the audio output is too loud even at low settings. Value range is 0-255.
Default: 255
Section: [SCSI]
Select the physical layer mode for SCSI signal handling (advanced).
Controls low-level SCSI bus signal handling. Different modes optimize for different cable lengths, termination, or compatibility requirements. Only change this if you're experiencing signal integrity issues or have been advised to for troubleshooting. Most users should leave this at default.
Default: 0 (auto)
Section: [SCSI]
Enable compatibility workarounds for specific vintage computer systems.
Activates compatibility modes for systems with non-standard SCSI implementations. Values: 0=Standard, 1=Apple (default), 2=OMTI, 4=Xebec, 8=VMS, 16=X68000. Multiple quirks can be combined by adding values. Instead of setting this manually, consider using the System preset which configures quirks and other settings automatically.
Default: 1 (Apple)
Options:
-
0- Standard: Generic SCSI, no quirks -
1- Apple: Apple Macintosh compatibility -
2- OMTI: OMTI controller compatibility -
4- Xebec: Xebec controller compatibility -
8- VMS: DEC VMS compatibility -
16- X68000: Sharp X68000 compatibility
Section: [SCSI]
Override which SCSI ID the ROM drive appears on.
By default, the ROM drive (if loaded) uses an available SCSI ID automatically. Set this to force it to a specific ID from 0-7, or -1 for automatic assignment. The ROM drive is a small image stored in BlueSCSI's flash memory, useful for boot disks.
Default: -1 (automatic)
Section: [SCSI]
Add a delay (in microseconds) after device selection to help with timing issues.
Adds a pause after the host selects a SCSI device before responding. Value 255 enables automatic delay adjustment (recommended). Set to 0 for no delay, or a specific microsecond value if you're experiencing selection issues. Only change this if directed to during troubleshooting.
Default: 255 (automatic)
Section: [SCSI]
Select a performance profile optimized for your BlueSCSI hardware variant.
Applies a set of timing parameters optimized for different hardware versions or performance levels. Options depend on your BlueSCSI model. Using the correct speed grade ensures maximum performance while maintaining stability. Leave unset to use hardware defaults.
Default: not set
Section: [SCSI]
Apply a system preset profile with optimized settings for specific vintage computers.
Select a predefined configuration that sets multiple parameters at once for a specific vintage computer system. Available presets: Generic, MacPlus, MegaSTE, X68000. This is the easiest way to configure BlueSCSI for maximum compatibility with your system, as it applies quirks, timing, and other settings automatically.
Default: not set
Options:
-
Generic- Generic: Standard SCSI compatibility -
MacPlus- Mac Plus: Apple Macintosh Plus and similar -
MegaSTE- Atari MegaSTE: Atari MegaSTE system -
X68000- X68000: Sharp X68000 computer
Section: [SCSI]
Set the SD card directory that appears as a shared folder to the host system.
Specifies which folder on the SD card is accessible through the BlueSCSI Toolbox shared folder feature. On Macintosh systems with compatible software, this folder appears as a network share, allowing easy file transfer. Default is '/shared'.
Default: /shared
Section: [SCSI]
Make individual image files accessible when USB Mass Storage is enabled.
When EnableUSBMassStorage is on, this setting controls whether disk image files (.hda, .iso, etc.) appear as separate files/partitions, or if only the raw SD card is accessible. Enable to easily manage individual images via USB.
Default: disabled
Section: [SCSI]
Set delay (in milliseconds) before activating USB Mass Storage mode.
How long BlueSCSI waits after USB connection before enabling mass storage access. This gives the system time to complete SCSI operations and safely unmount drives. Increase if you experience file system corruption when connecting USB.
Default: 5000
Section: [SCSI]
Use FAT filesystem allocation units for size calculations instead of raw file size.
When reading disk images from a FAT-formatted SD card, use the FAT allocation size instead of the actual file size. This can help with images that aren't perfectly sized multiples of the sector size. Most users should leave this at default.
Default: disabled
Section: [SCSI]
Set the MAC address for DaynaPORT network emulation (format: AA:BB:CC:DD:EE:FF).
When using BlueSCSI's DaynaPORT Ethernet emulation, this sets the MAC address that the emulated network adapter uses. Format is six hex pairs separated by colons. If not set, a default address is used. Only relevant if you're using the network emulation feature.
Default: not set
Section: [SCSI]
Set the Wi-Fi password for DaynaPORT network emulation.
The password for connecting to the Wi-Fi network when using BlueSCSI's network emulation feature. This allows vintage computers to access network resources through BlueSCSI's Wi-Fi connection. Only relevant on hardware with Wi-Fi capability.
Default: not set
Section: [SCSI]
Set the Wi-Fi network name (SSID) for DaynaPORT network emulation.
The Wi-Fi network to connect to when using BlueSCSI's DaynaPORT Ethernet emulation. This feature allows vintage computers without network cards to access network resources through BlueSCSI. Only available on hardware with Wi-Fi capability.
Default: not set
These settings are specified in device-specific sections [SCSI0] - [SCSI7].
Section: [SCSI0-7] (per-device only)
Set the sector size for this device. Most drives use 512 bytes, while CD-ROMs use 2048 bytes.
Override the default block size for a device. BlueSCSI automatically sets this to 512 bytes for hard drives and 2048 bytes for CD-ROMs. Only change this if you have a specific need, such as emulating certain tape devices or drives with non-standard sector sizes.
Default: 512 for hard drives, 2048 for CD-ROMs
Section: [SCSI0-7] (per-device only)
Set the audio playback volume for CD audio (0-255). Higher values increase volume.
Controls the volume level for CD audio playback when using BlueSCSI's CD-ROM emulation with audio tracks. The value range is 0-255, where 0 is silent and 255 is maximum volume. This only affects audio CDs, not data disks.
Default: 255
Section: [SCSI0-7] (per-device only)
Apply a device preset profile with predefined settings for specific hardware.
Select a device-specific preset that configures multiple settings at once to emulate a particular real SCSI device. Available presets include configurations for specific hard drive models. This is useful for compatibility with systems that expect particular device characteristics.
Default: not set
Section: [SCSI0-7] (per-device only)
Skip validation checks for Macintosh disk images.
Disables BlueSCSI's built-in validation that checks if Macintosh disk images have the correct structure. This can help with non-standard or corrupted images, but may cause issues if the image is actually invalid. Only enable if you're certain your image is correct but BlueSCSI won't mount it.
Default: disabled
Section: [SCSI0-7] (per-device only)
Set how fast the LED blinks when media is ejected (in milliseconds).
Controls the blink speed of the status LED when removable media (like a CD-ROM) is ejected. Lower values make it blink faster, higher values slower. This provides visual feedback that media needs to be reinserted.
Default: 500
Section: [SCSI0-7] (per-device only)
Set how many times the LED blinks to indicate media ejection.
Determines how many times the LED flashes when media is ejected. This visual indicator helps users know that the device is waiting for media to be reinserted. Set to 0 for continuous blinking.
Default: 3
Section: [SCSI0-7] (per-device only)
Assign a physical button to eject removable media for this device.
Maps a physical button on compatible BlueSCSI hardware to eject and cycle through multiple images for this device. When pressed, it ejects the current image and loads the next one (if multiple images are configured with Img0, Img1, etc.). Use value 0 to disable, 1 for button 1, 2 for button 2.
Default: 0 (disabled)
Section: [SCSI0-7] (per-device only)
Set the number of read/write heads in the emulated disk geometry.
Defines the drive geometry parameter for heads per cylinder. This is part of the CHS (Cylinder/Head/Sector) addressing used by older systems. Modern systems ignore this, but some older BIOSes or operating systems require specific geometry values. Default is 255, which works for most systems.
Default: 255
Section: [SCSI0-7] (per-device only)
Specify the first disk image file for this device (for multi-image switching).
When you want multiple disk images available for a single device (like swapping CDs or floppies), use Img0, Img1, Img2, etc. to specify each image file. The device starts with Img0, and you can cycle through images using the eject button or eject commands. Useful for multi-disc games or software.
Default: not set
Section: [SCSI0-7] (per-device only)
Specify a subdirectory for this device's image files.
Override the global Dir setting for a specific device. This allows different SCSI IDs to use images from different folders. For example, you might keep CD images in one folder and hard drive images in another. Use forward slashes for the path.
Default: not set
Section: [SCSI0-7] (per-device only)
Use the image filename as the device name instead of configured names.
When enabled, BlueSCSI uses the disk image filename as the device name reported to the host system, instead of the Vendor/Product strings from the configuration. This can make it easier to identify which image is mounted on which device.
Default: disabled
Section: [SCSI0-7] (per-device only)
Set how many bytes to read ahead after a disk read request (0 to disable).
BlueSCSI can prefetch (read ahead) data from the SD card after a read request, anticipating the next read. This improves performance for sequential reads but may waste time if the host reads randomly. Default is 8192 bytes (8KB). Set to 0 to disable prefetching if you experience issues.
Default: 8192
Section: [SCSI0-7] (per-device only)
Set the product name string that the device reports to the host system.
The product identifier that appears in SCSI device listings. This is a 16-character string that identifies the specific model of drive. You can set this to match a real drive model for better compatibility with software that expects specific hardware.
Default: not set
Section: [SCSI0-7] (per-device only)
Automatically reload media after it's ejected by the host system.
When the host ejects a removable disk (like a CD), automatically reinsert it after a moment. Useful for systems that eject media during shutdown but expect it to be present on next boot. If you're using multiple images with Img0/Img1, this cycles to the next image.
Default: disabled
Section: [SCSI0-7] (per-device only)
Reload ejected CD-ROM media when the host queries the device.
Some systems issue INQUIRY commands to check device status. When enabled, any ejected CD-ROM is automatically reinserted when an INQUIRY is received. This helps with systems that expect media to always be present or have trouble with the ejected state.
Default: disabled
Section: [SCSI0-7] (per-device only)
Align SCSI vendor and product strings to the right instead of left.
Some Apple systems expect device identification strings to be right-aligned (padded with spaces on the left) instead of the standard left-alignment. Automatically enabled when Quirks is set to Apple. Only change this if you're using custom quirks settings.
Default: disabled
Section: [SCSI0-7] (per-device only)
Set the starting sector on the SD card for raw sector passthrough.
When using RAW mode to directly access SD card sectors, this sets the first sector to expose. Useful for migrating from SCSI2SD or accessing specific SD card regions. Most users will never need this setting. See RAW mode documentation for details.
Default: 0
Section: [SCSI0-7] (per-device only)
Set the ending sector on the SD card for raw sector passthrough.
When using RAW mode, this sets the last sector to expose. Use with SectorSDBegin to define a sector range. If set beyond the SD card size, it will be automatically adjusted. Most users will never need this setting.
Default: End of SD card
Section: [SCSI0-7] (per-device only)
Set the number of sectors per track in the emulated disk geometry.
Part of the CHS (Cylinder/Head/Sector) disk geometry. Modern systems ignore this, but older BIOSes and operating systems may require specific values. Default is 63, which works with most systems. Only change if you have specific compatibility requirements.
Default: 63
Section: [SCSI0-7] (per-device only)
Set the serial number string that the device reports.
The device serial number, typically a 16-character string. Some software uses this to identify specific drives or for licensing. You can set this to match a real drive's serial number if needed for software compatibility.
Default: not set
Section: [SCSI0-7] (per-device only)
Start with removable media in the ejected state instead of loaded.
When enabled, the device starts with no media loaded, appearing as an empty drive. Useful for CD-ROM or removable drives where you want the host to detect media insertion events. Use with EjectButton or ReinsertAfterEject to load images.
Default: disabled
Section: [SCSI0-7] (per-device only)
Set the device type (0=Hard Drive, 1=Removable, 2=CD-ROM, 3=Floppy, 4=Magneto-Optical, 5=Tape).
Override the device type that BlueSCSI reports to the host. Normally determined automatically from the filename, but you can force a specific type. Values: 0=Fixed Disk, 1=Removable Disk, 2=CD-ROM, 3=Floppy, 4=Magneto-Optical, 5=Tape. Different types support different SCSI commands and behaviors.
Default: Auto-detected from filename
Options:
-
0- Hard Drive: Fixed disk device -
1- Removable: Removable disk (Zip, SyQuest, etc) -
2- CD-ROM: Optical disc drive -
3- Floppy: Floppy disk drive -
4- Magneto-Optical: MO drive -
5- Tape: Tape drive
Section: [SCSI0-7] (per-device only)
Set the device type modifier field for SCSI-1 compatibility (usually leave at 0).
A legacy SCSI-1 field that allows vendor-specific qualification of the device type. This field appears in the INQUIRY response. Most modern systems ignore this. Only change if you have specific compatibility requirements with very old SCSI-1 systems or software.
Default: 0
Section: [SCSI0-7] (per-device only)
Set the vendor/manufacturer name string that the device reports.
The 8-character vendor identifier that appears in SCSI device listings. Common values include 'QUANTUM', 'SEAGATE', 'BLUESCSI', etc. You can set this to match a real drive manufacturer for better compatibility with software that expects specific brands.
Default: not set
Section: [SCSI0-7] (per-device only)
Enable vendor-specific SCSI command extensions for compatibility.
Activates special vendor-specific SCSI commands that some software expects. Different values enable different vendor extensions. Only change this if you're using software that requires specific vendor commands or have been directed to during troubleshooting.
Default: 0
Section: [SCSI0-7] (per-device only)
Set the firmware version string that the device reports.
The 4-character revision level string shown in device information. Typically something like '1.0' or '2.0'. Some software may check this for compatibility. You can set it to match a real drive's firmware version if needed.
Default: not set
Section: [custom_timings]
Advanced: Timing offset value for boot synchronization (platform-specific).
Low-level timing parameter for RP2040-based BlueSCSI hardware. This adjusts the boot timing offset for SCSI signal synchronization. Only modify if you're experiencing timing issues and have been directed to adjust this value. Incorrect settings may cause instability.
Section: [custom_timings]
Advanced: Timing synchronization value for boot sequence (platform-specific).
Low-level timing parameter for RP2040-based BlueSCSI hardware. Controls the synchronization value during boot sequence. This is a platform-specific advanced setting that should only be modified during troubleshooting or when using custom timing configurations.
Section: [custom_timings]
Advanced: SD card clock divider for 1MHz operation (platform-specific).
Clock divider value for SD card interface running at 1MHz. This is a low-level hardware parameter for RP2040-based BlueSCSI. Only modify when creating custom timing profiles or troubleshooting SD card communication issues.
Section: [custom_timings]
Advanced: PIO clock divider for SD card or audio (platform-specific).
Programmable I/O clock divider for SD card interface or audio output on RP2040-based hardware. This controls the timing of PIO state machines. Only modify when creating custom timing profiles or if directed during troubleshooting.
Section: [custom_timings]
Advanced: Enable clocking for audio output (platform-specific).
Controls whether the PIO clock is used for audio output on RP2040-based hardware. This affects CD audio playback timing. Only modify when troubleshooting audio issues or creating custom hardware configurations.
Section: [custom_timings]
Advanced: System clock frequency in Hz (platform-specific).
The main system clock frequency for RP2040-based BlueSCSI hardware. Adjusting this changes the overall system performance and timing. Increasing can improve speed but may cause instability. Only modify when creating custom speed grades or overclocking. Incorrect values can prevent booting.
Section: [custom_timings]
Advanced: SCSI clock period in picoseconds (platform-specific).
The period of one clock cycle for SCSI operations in picoseconds. This fundamental timing parameter affects all SCSI communication. Only modify when creating custom timing profiles for specific hardware or troubleshooting signal integrity issues.
Section: [custom_timings]
Advanced: SD card timing delay parameter 0 (platform-specific).
First SD card interface timing delay parameter for RP2040 hardware. These delays compensate for signal propagation and hardware variations. Only adjust when troubleshooting SD card reliability issues or creating custom timing profiles.
Section: [custom_timings]
Advanced: SCSI bus timing delay 0 in clock cycles (platform-specific).
First SCSI timing delay parameter measured in clock cycles, used for precise bus timing at different speeds (5MHz, 10MHz, 20MHz). Adjusts signal assertion timing. Only modify when creating custom speed grades or resolving timing issues.
Section: [custom_timings]
Advanced: SD card timing delay parameter 1 (platform-specific).
Second SD card interface timing delay parameter for RP2040 hardware. Works with delay0 to fine-tune SD card communication timing. Only adjust when troubleshooting SD card reliability issues or creating custom timing profiles.
Section: [custom_timings]
Advanced: SCSI bus timing delay 1 in clock cycles (platform-specific).
Second SCSI timing delay parameter measured in clock cycles for different synchronous speeds. Adjusts signal negation timing. Part of the low-level SCSI timing configuration. Only modify when creating custom speed grades.
Section: [custom_timings]
Disable custom timing configuration file entirely.
When enabled in a custom timings file, prevents the entire timing configuration from being loaded. Useful for temporarily disabling custom timings without deleting the file. BlueSCSI will use default hardware timings instead.
Section: [custom_timings]
Base the custom timing configuration on an existing speed grade preset.
Inherit settings from a built-in speed grade as a starting point for custom timing configuration. Only the parameters you explicitly override will differ from the base grade. Set to 'Default' or the name of a specific speed grade.
Section: [custom_timings]
Advanced: Maximum synchronous transfer speed for timing mode (platform-specific).
Sets the maximum synchronous SCSI speed that this timing configuration supports (in MHz). Used when defining custom timing for different SCSI bus speeds (5MHz, 10MHz, 20MHz). Must be coordinated with delay parameters.
Section: [custom_timings]
Advanced: PLL post-divider 1 value (platform-specific).
First post-divider for the Phase-Locked Loop that generates system clocks on RP2040 hardware. Part of the clock generation configuration. Only modify when creating custom clock speeds or overclocking. Incorrect values prevent booting.
Section: [custom_timings]
Advanced: PLL post-divider 2 value (platform-specific).
Second post-divider for the Phase-Locked Loop on RP2040 hardware. Works with pd1 to derive the final system clock from the VCO frequency. Only modify when creating custom clock configurations. Incorrect values prevent booting.
Section: [custom_timings]
Advanced: SCSI read operation delay in clock cycles (platform-specific).
Additional timing delay specifically for SCSI read operations, measured in clock cycles. This compensates for different timing requirements of read vs. write operations. Only modify when fine-tuning read performance or stability.
Section: [custom_timings]
Advanced: SCSI read period adjustment in clock cycles (platform-specific).
Adjusts the total period of SCSI read operations in clock cycles. Used to fine-tune read timing for optimal performance and reliability. Part of advanced timing configuration for different SCSI speeds.
Section: [custom_timings]
Advanced: PLL reference clock divider (platform-specific).
Reference clock divider for the Phase-Locked Loop on RP2040 hardware. Divides the input crystal frequency before feeding it to the PLL. Part of the clock generation configuration. Only modify when creating custom clock speeds.
Section: [custom_timings]
Advanced: SCSI REQ signal delay in clock cycles (platform-specific).
Delay for asserting the SCSI REQ (request) signal in clock cycles. This controls the timing of data handshaking on the SCSI bus. Part of the fundamental SCSI timing configuration. Only modify when troubleshooting timing issues.
Section: [custom_timings]
Advanced: SCSI transfer period adjustment in clock cycles (platform-specific).
Adjusts the total period of SCSI data transfers in clock cycles. Used to compensate for timing variations at different speeds. Part of the advanced timing configuration for synchronous SCSI modes (5/10/20 MHz).
Section: [custom_timings]
Advanced: PLL VCO frequency in Hz (platform-specific).
The Voltage-Controlled Oscillator frequency for the PLL on RP2040 hardware. This is divided down to create the system clock. Must be within valid range (400MHz-1600MHz typical). Only modify when creating custom clock configurations. Incorrect values prevent booting.
