git.sesse.net Git - pistorm/blob - platforms/amiga/piscsi/readme.md

   1 # PiSCSI Interface/Device driver for Amiga
   2
   3 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.
   4
   5 This driver and interface is work in progress, do not use it in conjunction with any critical data that you need to survive.
   6
   7 # Instructions
   8
   9 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.
  10
  11 To enable the PiSCSI interface, uncomment the `setvar piscsi` line in default.cfg, or add it to the config file you're currently using.
  12
  13 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.
  14
  15 To get a hard drive image mounted when WB starts, you need a few things:
  16 * Copy pi-scsi.device from the `device_driver_amiga` folder to `SYS:Devs` on your Amiga.
  17   If you're super savvy, the driver is also available in "RAM" at the address `$80004400` because that's where the PiSCSI interface keeps the boot ROM, so you can technically just write it to a file on the Amiga from there.
  18 * Download giggledisk from http://www.geit.de/eng_giggledisk.html or https://aminet.net/package/disk/misc/giggledisk to make MountLists for attached devices.
  19   Place the giggledisk binary in `C:` or something so that it's available in the search path.
  20 * It might be a good idea to have fat95 installed on your Amiga, in case you want to use FAT32 images or other file systems that fat95 can handle: https://aminet.net/package/disk/misc/fat95
  21
  22 Now open a new CLI, and type something like:
  23 `giggledisk device=pi-scsi.device unit=0 to=RAM:PI0`
  24
  25 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.
  26
  27 You'll have to start up your favorite (or least hated) text editor and change the contents of the file a bit.
  28
  29 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.
  30
  31 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.
  32
  33 Thus, an edited line would look something like `FileSystem       = L:FastFileSystem`
  34
  35 If the MountList has several partitions listed in it, it must be split up into separate files for all partitions to be mounted.
  36
  37 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.
  38
  39 If you don't want it to be mounted automatically, simply use the `Mount` command from CLI.
  40
  41 # A big word of caution
  42
  43 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.
  44
  45 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.
  46