Buttons

Buttons work like the eject/inject of a CD-ROM drive and will work across any removable device type such as floppy, Zip, MO, tape, etc.

Note: Some hosts after eject is pressed will try to re-insert the disk. To disable this and only rely solely on button presses set ReinsertCDOnInquiry=false and ReinsertAfterEject=false in the bluescsi.ini file.

Buttons are assigned automatically to removable devices. For example if you have folder CD3 and FD4 button 1 will be assigned to CD3 and button 2 will be assigned to FD4. These will be logged to log.txt as well.

Customize

If you have more than two removable devices and you’d like to customize the eject order you can add this to your bluescsi.ini file:

; This is only required to customize the buttons, not normally needed.
[SCSI3] ; CD3
EjectButton=2 ; default would have been 1

; FD4 - no customization so will have no eject button assigned.

[SCSI6] ; A ZP6 folder for Zip Disks
EjectButton=1 ; FD4 will no longer have any eject button assigned.

Hardware Setup

BlueSCSI with a SW1/SW2

  • SW1 is assigned to button id 1.
  • SW2 is assigned to button id 2.

BlueSCSI with a qwiic connector

To disable i2c over the qwiic and use simple eject buttons add the following bluescsi.ini setting:

[SCSI]
DisableI2C=true ; disables i2c in favor of simple buttons

You may now use the I2C qwiic connection like SW1/SW2 above.

A button press is detected when the GPIO is pulled to ground (black wire).

BlueSCSI with no SW or I2C

TODO: Manual button setup. Requires soldering.

I2C Screen and controls

Any BlueSCSI with a qwiic connector.

Note: I2C controls will be released along side another project in the coming months.

This wiki has been updated 881 times by 87 people like you!
Click here to edit this page.
Generated 2025-10-27