SCSI2SD UserManual: Difference between revisions

From code/src wiki
Jump to navigationJump to search
mNo edit summary
mNo edit summary
Line 18: Line 18:


== Updating the firmware ==
== Updating the firmware ==
* Obtain the latest firmware file and bootloaderhost utility from [http://www.codesrc.com/files/scsi2sd codesrc.com].  The firmware files have the extension ".cyacd".
* Obtain the latest firmware file and scsi2sd-util utility from [http://www.codesrc.com/files/scsi2sd codesrc.com].
* Disconnect or turn off ALL sources of power from the SCSI2SD. Any connected SCSI host controller or devices must be turned off.
* 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.
* Run the scsi2sd-util line utility.
bootloaderhost SCSI2SD.cyacd


Execute permissions are required on Mac OSX and Linux  
Execute permissions are required on Mac OSX and Linux  


  sudo chmod a+x bootloaderhost
  sudo chmod a+x scsi2sd-util
sudo bootloaderhost SCSI2SD.cyacd


* Select "Upgrade Firmware" from the scsi2sd-util File menu, and select the firmware file. Click OK.
* Connect the USB cable.
* 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 ==
== Setting the SCSI ID ==
The SCSI2SD is configured over the USB interface.
The SCSI2SD is configured over the USB interface.


* Obtain the scsi2sd-config utility from [http://www.codesrc.com/files/scsi2sd codesrc.com].
* Obtain the scsi2sd-util utility from [http://www.codesrc.com/files/scsi2sd codesrc.com].
* Execute permissions are required on Mac OSX and Linux
* Execute permissions are required on Mac OSX and Linux
  chmod a+x scsi2sd-config
  chmod a+x scsi2sd-util


* Connect the SCSI2SD via the USB cable, and then run scsi2sd
* Connect the SCSI2SD via the USB cable, and then run scsi2sd-util
scsi2sd --help


Root priviledges may be required on Linux.
Root priviledges may be required on Linux.
  sudo scsi2sd-config --help
  sudo scsi2sd-util
 
* Reset the device by removing all power cables to ensure the new settings take effect.
 
The available options are:
 
<pre>
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.
</pre>
 
 
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.

Revision as of 12:01, 8 January 2015

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.

Hot Swap

Requires firmware version 4.0 or above.

See Hot Swap for details on modifying old SCSI2SD boards to support hot swap.

Updating the firmware

  • Obtain the latest firmware file and scsi2sd-util utility from codesrc.com.
  • Disconnect or turn off ALL sources of power from the SCSI2SD. Any connected SCSI host controller or devices must be turned off.
  • Run the scsi2sd-util line utility.

Execute permissions are required on Mac OSX and Linux 

sudo chmod a+x scsi2sd-util
  • Select "Upgrade Firmware" from the scsi2sd-util File menu, and select the firmware file. Click OK.
  • Connect the USB cable.

Setting the SCSI ID

The SCSI2SD is configured over the USB interface.

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

Root priviledges may be required on Linux. 

sudo scsi2sd-util
Retrieved from "https://www.codesrc.com/mediawiki/index.php?title=SCSI2SD_UserManual&oldid=312"