SCSI2SD UserManual

From code/src wiki
Jump to navigationJump to search

Important Notes

Do not allow the underside of the SCSI2SD come into contact with any conductive surfaces. Doing so may result in damage to the SCSI2SD, damage to your computer's power supply, or fire.

Power

5V power can be supplied by a standard disk drive power connector, or via a micro-usb cable. It is safe to connect both sources of power simultaneuously.

Active Terminator

The terminator can be disabled by removing the 2 resistor packs. When re-inserting the resistor packs, be sure to align the printed dot on the resistors with the board markings.

Most SCSI host controllers provide the power required to run the terminators via the 50-pin cable. For those controllers that fail to provide termination power, the J3TERMPWR jumper may be closed to provide such power.

Providing termination power via J3 only works when powered via a standard disk drive power connector. A USB cable cannot provide sufficient current, and so the USB 5V line is not connected to J3.

Updating the firmware

  • Obtain the latest firmware file and bootloaderhost utility from codesrc.com. The firmware files have the extension ".cyacd".
  • Disconnect or turn off ALL sources of power from the SCSI2SD. Any connected SCSI host controller or devices must be turned off.
  • Run the bootloaderhost line utility . On Windows, be sure to run the utility from within a command prompt.
bootloaderhost SCSI2SD.cyacd

Root priviledges may be required on Linux.

sudo bootloaderhost SCSI2SD.cyacd
  • Connect the USB cable.

The SCSI2SD will enter the USB bootloader upon power-on. The bootloaderhost utility must send a command to the device within 2 seconds, or else the SCSI2SD will start normally.

  • bootloaderhost will report "Firmware update complete" when the firmware is updated. The new firmware is now running and active.

Setting the SCSI ID

The SCSI2SD is configured over the USB interface.

  • Obtain the scsi2sd-config utility from codesrc.com.
  • Execute permissions are required on Mac OSX and Linux
chmod a+x scsi2sd-config
  • Connect the SCSI2SD via the USB cable, and then run scsi2sd
scsi2sd --help

Root priviledges may be required on Linux.

sudo scsi2sd-config --help
  • Reset the device by removing all power cables to ensure the new settings take effect.

The available options are:

Usage: scsi2sd-config [options...]

--id={0-7}	SCSI device ID.

--parity	Check the SCSI parity signal, and reject data where
		the parity is bad.

--no-parity	Don't check the SCSI parity signal.
		This is required for SCSI host controllers that do not provide
		parity.

--attention	Respond with a Unit Attention status on device reset.
		Some systems will fail on this response, even though it is
		required by the SCSI-2 standard.

--no-attention	Disable Unit Attention responses.

--blocks={0-4294967295}
		Set a limit to the reported device size.
		Each block is 512 bytes. The maximum possible size is 2TB.
		The reported size will be the lower of this value and the SD
		card size. 0 disables the limit.

--apple		Set the vendor, product ID and revision fields to simulate an 
		apple-suppled disk. Provides support for the Apple Drive Setup
		utility.

--vendor={vendor}	Sets the reported device vendor. Up to 8 characters.

--prod-id={prod-id}	Sets the reported product ID. Up to 16 characters.

--rev={revision}	Sets the reported device revision. Up to 4 characters.


The current configuration settings are displayed if no options are supplied.

Setting the disk size

Some operating systems place limits on the size of the disks they can support. The SCSI2SD can be configured to pretend the SD card is smaller than it really is.

Some common limits:

  • Macintosh System 6 and 7: 2GB
  • Macintosh System 7.5: 4GB
  • Macintosh System 7.5.2: 2TB on computers that originally came with OS 7.5.2 or newer.


To limit the SCSI2SD to 2GB, run:

sudo scsi2sd-config --blocks=4194303

To convert from MB to blocks, multiple by 2048. Eg. 100MB = 100 x 2048 = 204800 blocks.