The PiSCSI software (formerly RaSCSI) does not only emulate mass storage devices, but also printers and services like a realtime clock. The PiSCSI client tools facilitate using these features with the Atari or MagiCMac/MagiCPC. They require PiSCSI release 22.05 or newer, a SCSI Driver like it is integrated in HDDRIVER, or the SCSI Driver for MagiCMac/MagiCPC.
The tools expect that PiSCSI was configured with host services and/or a SCSI printer device, e.g. with
>piscsi -id 6:0 printer -id 6:1 services
In this example the SCSI printer allocates SCSI ID 6, LUN 0. The host services allocate SCSI ID 6, LUN 1. All client tools automatically find the respective device. Instead of the command line you can also use the PiSCSI web interface or the PiSCSI Control app to configure PiSCSI as desired.
RA_RTC uses the host services in order to retrieve date and time from PiSCSI and set it on the Atari. Daylight saving time settings are applied automatically. This means that there is also a benefit for Ataris with a clock. Usually RA_RTC is located in the AUTO folder.
The realtime clock is a useful add-on for all who are using PiSCSI anyway. If the host services are configured as an additional LUN for an existing device they do not even need a SCSI ID of their own.
RA_SHUTD shuts down the Pi or PiSCSI by using the host services. Note that RA_SHUTD terminates immediately, but the Pi takes some time to shut down. After using RA_SHUTD it is not possible anymore to access the devices emulated by PiSCSI.
With RA_PRINT files can be printed via PiSCSI. Usually you create an icon for RA_PRINT on the desktop, onto which you drop the file to be printed. As an alternative you can launch RA_PRINT manually and enter the filename.
The archive with the PiSCSI client tools contains the binaries and a README file with further information. The sources for all tools are available on GitHub.