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 RaSCSI/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.
PI_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 PI_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.
PI_SHUTD shuts down the Pi or PiSCSI by using the host services. Note that PI_SHUTD terminates immediately, but the Pi takes some time to shut down. After using PI_SHUTD it is not possible anymore to access the devices emulated by PiSCSI.
With PI_PRINT files can be printed via PiSCSI. Usually you create an icon for PI_PRINT on the desktop, onto which you drop the file to be printed. As an alternative you can launch PI_PRINT manually and enter the filename.
PI_PRINT has only been tested with the PiSCSI SCSI printer, but might also work with other SCSI printers compatible with the SCSI-2 specification.
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.