From 1439d00b570066c05d4b8dcac4511bdef04f27a8 Mon Sep 17 00:00:00 2001
From: beeanyew <beeanyew@gmail.com>
Date: Sun, 31 Jan 2021 13:16:37 +0100
Subject: [PATCH] Add PiSCSI readme with a brief setup tutorial for now

---
 default.cfg                                   |   7 ++++
 .../device_driver_amiga/2nd.scsi.device       | Bin 2900 -> 2892 bytes
 .../piscsi/device_driver_amiga/pi-scsi.device | Bin 2900 -> 2892 bytes
 .../piscsi/device_driver_amiga/piscsi-amiga.c |   2 +-
 .../piscsi/device_driver_amiga/scsi.device    | Bin 2916 -> 2888 bytes
 platforms/amiga/piscsi/piscsi.c               |   3 ++
 platforms/amiga/piscsi/readme.md              |  34 ++++++++++++++++++
 7 files changed, 45 insertions(+), 1 deletion(-)
 create mode 100644 platforms/amiga/piscsi/readme.md

diff --git a/default.cfg b/default.cfg
index fe75e7a..5160d84 100644
--- a/default.cfg
+++ b/default.cfg
@@ -33,6 +33,13 @@ platform amiga
 #setvar rtg
 # Uncomment to enable CDTV mode (not working, requires Kickstart 1.3+CDTV extended ROM)
 #setvar cdtv
+# Uncomment this line to enabled the PiSCSI interface
+#setvar piscsi
+# Use setvar piscsi0 through piscsi6 to add up to seven mapped drives to the interface.
+#setvar piscsi0 PI0.hdf
+#setvar piscsi1 PI1.hdf
+# Uncomment this line to enable the (currently non-working) Pi-Net interface.
+#setvar pi-net
 
 # Forward mouse events to host system, defaults to off unless toggle key is pressed on the Pi.
 # Syntax is mouse [device] [toggle key]
diff --git a/platforms/amiga/piscsi/device_driver_amiga/2nd.scsi.device b/platforms/amiga/piscsi/device_driver_amiga/2nd.scsi.device
index 090a972c4ade3ebbc646e05ee63ee37ff8671151..3454d1b7b835edabe9d097baf56b45c14a63f257 100644
GIT binary patch
delta 153
zcmca2c1CQ1IPZ4`1_mAm2IiLx42<6=s^~I4+8E@=#HCczz`($wkjucac@xu3R?#~^
zWz6v);Fy$ORO0Cm<T^}Vz~RoAG5H0DKI50k5}fLcFD5&1N;BS>9K%_~#Pn<O4WN+1
wBraviXF%O7K)s>GsYNcSWzISI#i>9crbm-)xU?CACTDP|v%UbEIECu~06@DenE(I)

delta 184
zcmX>jc13K0IPXse1_mAm2IiLx42(Y~s^~Jl+8E@=B&3kbz+wD{fw6&sK|!eoNV05R
z#dMQZ^a)Tob36z*Cgm5Ec=`jm9+PKqxHA?^e!!v6_-C>Jr@HJ1pek0Nnv}$nL=cWI
zO3lenE(VG+us@j`!db<{%ryA|r#hp?<R6^MlJ9`xEI{R<#i>Ousb$VN`NgR~A*NT8
WO}Mlfqb4VCsj~u&1X|R?bpQa_Ks5dU

diff --git a/platforms/amiga/piscsi/device_driver_amiga/pi-scsi.device b/platforms/amiga/piscsi/device_driver_amiga/pi-scsi.device
index 4d44af8f254bfabd466f620e053ce2ebdf2f0dda..fdf0587836fdf1d2ae741272f37c8d8408a9f200 100644
GIT binary patch
delta 153
zcmca2c1CQ1IPZ4`1_mAm2IiLx42<6=s^~I4+8E@=#HCczz`($wkjucac@xu3R?#~^
zWz6v);Fy$ORO0Cm<T^}Vz~RoAG5H0DKI50k5}fLcFD5&1N;BS>9K%_~#Pn<O4WN+1
wBraviXF%O7K)s>GsYNcSWzISI#i>9crbm-)xU?CACTDP|v%UbEIECu~06@DenE(I)

delta 184
zcmX>jc13K0IPXse1_mAm2IiLx42(Y~s^~Jl+8E@=B&3kbz+wD{fw6&sK|!eoNV05R
z#dMQZ^a)Tob36z*Cgm5Ec=`jm9+PKqxHA?^e!!v6_-C>Jr@HJ1pek0Nnv}$nL=cWI
zO3lenE(VG+us@j`!db<{%ryA|r#hp?<R6^MlJ9`xEI{R<#i>Ousb$VN`NgR~A*NT8
WO}Mlfqb4VCsj~u&1X|R?bpQa_Ks5dU

diff --git a/platforms/amiga/piscsi/device_driver_amiga/piscsi-amiga.c b/platforms/amiga/piscsi/device_driver_amiga/piscsi-amiga.c
index 8bfc0fb..6b387be 100644
--- a/platforms/amiga/piscsi/device_driver_amiga/piscsi-amiga.c
+++ b/platforms/amiga/piscsi/device_driver_amiga/piscsi-amiga.c
@@ -153,7 +153,7 @@ uint32_t __UserDevOpen(struct IOExtTD *iotd, uint32_t num, uint32_t flags) {
     struct Node* node = (struct Node*)iotd;
     int io_err = IOERR_OPENFAIL;
 
-    WRITESHORT(PISCSI_CMD_DEBUGME, 1);
+    //WRITESHORT(PISCSI_CMD_DEBUGME, 1);
 
     int unit_num = 0;
     WRITELONG(PISCSI_CMD_DRVNUM, num);
diff --git a/platforms/amiga/piscsi/device_driver_amiga/scsi.device b/platforms/amiga/piscsi/device_driver_amiga/scsi.device
index c99a27cc448295fe866c2e6349da8193904b6295..d14887766f40ac30efd28929980a22ad4e843176 100644
GIT binary patch
delta 157
zcmaDNc0z1|IPW(G1_mAm2IiLx42<6<s^~J_+Zg1<#HCczz`($wkjua^c^y;IW)bFc
zR?!<krOfdl;Fy$ORO0Cm<l0PLz~RoAGWi9EKI4bU5}fLcPbNEXN;BS=9K%_~#Pn_Q
z4WN+BBraviM?l>yK)s>GsYNcSWzISI#i>9crhAiZxU?DlCRcE&vpxZvxP<Ef0I~lq
AEdT%j

delta 211
zcmX>h_C#!gIPXse1_mAm2IiLx42(Y~s^~I4+Zg1<B&3kbz+wD{fw6&sK|!eoNU}^`
z#+1b5)G#@YSz@ysb0Vwg6QEA!co1+*$}cMM^apZ1CQspTXDpa}heMz7&tx7>b=eO<
zRjfcYDTyVCARJ$mnv<Vg3>0Nxe=<3Mvx<qCY4RCPbw-WJUpSQ|UjfBgfXYLQQ;S?u
s%bauai&KF@OwT48aA^xhftc~RiJ5so29Wt?atxO`E6@s{#T{G+04wA=L;wH)

diff --git a/platforms/amiga/piscsi/piscsi.c b/platforms/amiga/piscsi/piscsi.c
index 0e28b67..f24fddf 100644
--- a/platforms/amiga/piscsi/piscsi.c
+++ b/platforms/amiga/piscsi/piscsi.c
@@ -10,6 +10,9 @@
 #include "../../../config_file/config_file.h"
 #include "../../../gpio/gpio.h"
 
+// Comment this line to restore debug output:
+#define printf(...)
+
 struct piscsi_dev devs[8];
 uint8_t piscsi_cur_drive = 0;
 uint32_t piscsi_u32[4];
diff --git a/platforms/amiga/piscsi/readme.md b/platforms/amiga/piscsi/readme.md
new file mode 100644
index 0000000..8fec097
--- /dev/null
+++ b/platforms/amiga/piscsi/readme.md
@@ -0,0 +1,34 @@
+# 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:
+* Copy pi-scsi.device from the `device_driver_amiga` folder to `SYS:Devs` on your Amiga.
+  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.
+* Download giggledisk from http://www.geit.de/eng_giggledisk.html or https://aminet.net/package/disk/misc/giggledisk to make MountLists for attached devices.
+  Place the giggledisk binary in `C:` or something so that it's available in the search path.
+* 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
+
+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.
+
-- 
2.39.2