Macintosh-HW
/
RASCSI
mirror of https://github.com/akuker/RASCSI.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Updated Rules for adding new device types (markdown)

Daniel Markstedt 2022-03-25 09:01:35 -07:00
parent 309256521c
commit 411394ce92
1 changed files with 12 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
Rules-for-adding-new-device-types.md

@ -10,4 +10,15 @@ Steps for adding a new device type:
6. Update the manpages.
Devices shall be subclasses of PrimaryDevice or ModeSenseDevice. Only devices backed by image files shall be subclasses of the Disk class.
See the implementations of the Host Services (SCHS) and the SCSI Printer (SCLP for a device implementations with low complexity.
See the implementations of the Host Services (SCHS) and the SCSI Printer (SCLP) for a device implementations with low complexity.
## Clients
The Python based clients has class methods in the Common package for detecting device types that the backend supports, which are then exposed appropriately in the various front ends. See the RaCtlCmds class for details.
At the time of writing, the code detects three types of devices:
* Disk -- Any device that takes an image file as argument
* Removable -- Any device which can have image files inserted and ejected (overlap with the above)
* Peripheral -- Any device that does not match the above.
For most scenarios, the Python clients should not require any modification when new device types are added. However, testing the integration before releasing a stable version is strongly recommended.