mirror of
https://github.com/akuker/RASCSI.git
synced 2024-08-22 11:29:04 +00:00
* #7 Re-merge scsimon functionality with latest master. The old scsimon branch was waaaaay too out of date * #7 Re-merge scsimon functionality with latest master. The old scsimon branch was waaaaay too out of date * Added libspdlog-dev as a required package * Cleanup from master re-base * Updated to use GCC version 8, to match the raspberry pi Co-authored-by: akuker <akuker@gmail.com>
63 lines
2.5 KiB
Groff
63 lines
2.5 KiB
Groff
.TH rascsi 1
|
|
.SH NAME
|
|
rascsi \- Emulates SCSI devices using the Raspberry Pi GPIO pins
|
|
.SH SYNOPSIS
|
|
.B rascsi
|
|
[\fB\-IDn\fR \fIfile\fR]
|
|
[\fB\-HDn\fR \fIfile\fR]...
|
|
.SH DESCRIPTION
|
|
.B rascsi
|
|
Emulates SCSI devices using the Raspberry Pi GPIO pins.
|
|
.PP
|
|
In the arguments to RaSCSI, one or more SCSI (-IDn) or SASI (-HDn) devices can be specified.
|
|
The number (n) after the ID or HD idnetifier specifies the ID number for that device.
|
|
For SCSI: The ID is limited from 0-7. However, typically SCSI ID 7 is reserved for the "initiator" (the host computer).Note that SASI is considered rare and only used on very early Sharp X68000 computers.
|
|
.PP
|
|
RaSCSI will determin the type of device based upon the file extension of the FILE argument.
|
|
hdf: SASI Hard Disk image (XM6 SASI HD image - typically only used with X68000)
|
|
hds: SCSI Hard Disk image (XM6 SCSI HD image - typically only used with X68000)
|
|
hdn: SCSI Hard Disk image (NEC GENUINE)
|
|
hdi: SCSI Hard Disk image (Anex86 HD image)
|
|
nhd: SCSI Hard Disk image (T98Next HD image)
|
|
hda: SCSI Hard Disk image (APPLE GENUINE - typically used with Mac SCSI emulation)
|
|
mos: SCSI Magneto-optical image (XM6 SCSI MO image - typically only used with X68000)
|
|
iso: SCSI CD-ROM image (ISO 9660 image)
|
|
|
|
For example, if you want to specify an Apple-compatible HD image on ID 0, you can use the following command:
|
|
sudo rascsi -ID0 /path/to/drive/hdimage.hda
|
|
|
|
Once RaSCSI starts, it will open a socket (port 6868) to allow external management commands.
|
|
If another process is using port 6868, RaSCSI will terminate, since it is likely another instance of RaSCSI.
|
|
Once RaSCSI has initialized, the rasctl utility can be used to send commands.
|
|
|
|
To quit RaSCSI, press Control + C. If it is running in the background, you can kill it using an INT signal.
|
|
|
|
.SH OPTIONS
|
|
.TP
|
|
.BR \-ID\fIn " " \fIFILE
|
|
n is the SCSI ID number (0-7)
|
|
.IP
|
|
FILE is the name of the image file to attach to that ID.
|
|
.TP
|
|
.BR \-HD\fIn " " \fIFILE
|
|
n is the SASI ID number (0-15)
|
|
.IP
|
|
FILE is the name of the image file to attach to that ID.
|
|
.IP
|
|
Note: SASI usage is rare, and is typically limited to early Sharp X68000 systems.
|
|
|
|
.SH EXAMPLES
|
|
Launch RaSCSI with no emulated drives attached:
|
|
rascsi
|
|
|
|
Launch RaSCSI with an Apple hard drive image as ID0 and a CD-ROM as ID 2
|
|
rascsi -ID0 /path/to/harddrive.hda -ID2 /path/to/cdimage.iso
|
|
|
|
To create an empty, 100MB HD image, use the following command:
|
|
dd if=/dev/zero of=/path/to/newimage.hda bs=512 count=204800
|
|
|
|
.SH SEE ALSO
|
|
rasctl(1), scsimon(1)
|
|
|
|
Full documentation is available at: <https://www.github.com/akuker/RASCSI/wiki/>
|