]> git.sesse.net Git - pistorm/blobdiff - platforms/amiga/piscsi/readme.md
[WIP] Pile of stuff
[pistorm] / platforms / amiga / piscsi / readme.md
index 8fec0970924da9e94c29663fbbec2e42b82d88b1..0e49121cad9a887a39e0c569889f2e52df8d8b57 100644 (file)
@@ -1,12 +1,15 @@
 # PiSCSI Interface/Device driver for Amiga
 
 Intended to be used as a high performance replacement for scsi.device, can currently be used for mounting raw RDB disk images (RDSK) for use in Workbench.
+
 This driver and interface is work in progress, do not use it in conjunction with any critical data that you need to survive.
 
 # Instructions
 
 In a perfect world, the PiSCSI boot ROM would automatically detect drives/partitions and add them as boot nodes to be available during early startup, but this is not yet possible.
+
 To enable the PiSCSI interface, uncomment the `setvar piscsi` line in default.cfg, or add it to the config file you're currently using.
+
 Add disk images to the PiSCSI interface by uncommenting the `piscsi0` and `piscsi1` lines and editing them to point at the disk image(s) you want to use. `piscsi0` through `piscsi6` are available for a total of seven mapped drives.
 
 To get a hard drive image mounted when WB starts, you need a few things:
@@ -18,17 +21,26 @@ To get a hard drive image mounted when WB starts, you need a few things:
 
 Now open a new CLI, and type something like:
 `giggledisk device=pi-scsi.device unit=0 to=RAM:PI0`
+
 This will create a MountList file called `PI0` on the RAM disk, which contains almost all the information needed to mount the drive and its partitions in Workbench.
+
 You'll have to start up your favorite (or least hated) text editor and change the contents of the file a bit.
+
 Above the `FileSystem` line, you'll notice a drive identifier. This line might say something along the lines of `DH0` or `PDH0`, etc, and it must be removed, otherwise the file can't be parsed.
+
 The `FileSystem` line will usually be empty, so you have to fill this out yourself. For instance, you can set it to something like `L:FastFileSystem` to use the standard file system for the drive, or `L:fat95` in case the image is in a format that fat95 can handle.
+
 Thus, an edited line would look something like `FileSystem       = L:FastFileSystem`
+
 If the MountList has several partitions listed in it, it must be split up into separate files for all partitions to be mounted.
+
 Once you've edited a MountList file, simply copy/move it to `SYS:Devs:DOSDrivers`, and the drive will be mounted automatically the next time you boot into Workbench.
+
 If you don't want it to be mounted automatically, simply use the `Mount` command from CLI.
 
 # A big word of caution
 
 While the PiSCSI interface can be used to mount physical drives that are available as block device nodes on the Pi, you should not do this unless you are absolutely sure what you're doing.
+
 Directly mounting a block device connected to the Pi may corrupt or destroy the data on the device, depending on what you or the file system drivers do with this disk on the Amiga side.