X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=default.cfg;h=e34ba304315190b650413f5f2f1a384f530244cc;hb=HEAD;hp=552f4a839885f762372df60b4e1f8d53acd8d05e;hpb=3296b79e7507f152575c43158e3f840a4e909bf9;p=pistorm

diff --git a/default.cfg b/default.cfg
index 552f4a8..e34ba30 100644
--- a/default.cfg
+++ b/default.cfg
@@ -2,6 +2,9 @@
 cpu 68020
 # Map 512KB kickstart ROM to default offset.
 map type=rom address=0xF80000 size=0x80000 file=kick.rom ovl=0 id=kickstart
+# Comment out the line above and uncomment the line below to automatically copy the ROM contents to Pi RAM if the file isn't found
+#map type=rom address=0xF80000 size=0x80000 file=kick.rom ovl=0 id=kickstart autodump_mem
+
 # Want to map an extended ROM, such as CDTV or CD32?
 #map type=rom address=0xF00000 size=0x80000 file=cdtv.rom id=extended
 
@@ -10,6 +13,8 @@ map type=rom address=0xF80000 size=0x80000 file=kick.rom ovl=0 id=kickstart
 #map type=ram address=0x08000000 size=128M id=cpu_slot_ram
 # Map 128MB of Z3 Fast. Note that the address here is not actually used, as it gets auto-assigned by Kickstart itself.
 # Enabling Z3 fast requires at least Kickstart 2.0.
+# If for some reason you need more than 128MB, you can change the size=128M to a valid supported Z3 PIC size,
+# like 256M, 512M, 1024M, or add additional map lines.
 map type=ram address=0x10000000 size=128M id=z3_autoconf_fast
 # Max 8MB of Z2 Fast can be mapped due to addressing space limitations, but for instance 2+4MB can be chained to leave 2MB for something else.
 #map type=ram address=0x200000 size=8M id=z2_autoconf_fast
@@ -23,15 +28,20 @@ map type=ram address=0x10000000 size=128M id=z3_autoconf_fast
 # NOTE: Gayle emulation is currently non-functional. Do not enable this.
 #map type=register address=0xD80000 size=0x40000
 # Map RTC as a register range.
-map type=register address=0xDC0000 size=0x30000
+map type=register address=0xDC0000 size=0x10000
 # Number of instructions to run every main loop.
 loopcycles 300
 # Set the platform to Amiga to enable all the registers and stuff.
 platform amiga
-# Uncomment to let reads/writes through from/to the RTC memory range
+# Uncommenting the below this long comment DISABLES RTC emulation, letting reads/writes through to the RTC memory range.
+# There is no need to uncomment it unless you are either using a CDTV, you want to use a physical RTC source present
+# inside the computer, such as on a trapdoor memory expansion board, or if you have a physical A314 intalled, since the
+# A314 uses the RTC address range to communicate with the Amiga, and enabling RTC emulation # blocks this communication completely.
+# DO NOT UNCOMMENT THE LINE BELOW UNLESS YOU'VE READ AND UNDERSTOOD THE FIVE LINES ABOVE THIS ONE.
 #setvar enable_rtc_emulation 0
 # Uncomment to enable RTG
 #setvar rtg
+
 # Uncomment to enable CDTV mode (not working, requires Kickstart 1.3+CDTV extended ROM)
 #setvar cdtv
 # Uncomment this line to enable the PiSCSI interface
@@ -39,9 +49,21 @@ platform amiga
 # Use setvar piscsi0 through piscsi6 to add up to seven mapped drives to the interface.
 #setvar piscsi0 PI0.hdf
 #setvar piscsi1 PI1.hdf
+# A special disk that includes PiStorm drivers and utilities, comment out if not needed
+setvar piscsi6 platforms/amiga/pistorm.hdf
 # Uncomment this line to enable the (currently non-working) Pi-Net interface.
 #setvar pi-net
 
+# Uncomment and edit to set a custom config filename for the A314 emulation
+#setvar a314_conf ./a314/files_pi/a314d.conf
+# Uncomment to enable A314 emulation
+#setvar a314
+
+# Please take note:
+# At the time of writing this (22 Jun 2021), the mouse and keyboard forwarding (for Amiga only) is by no means perfect.
+# It works properly in Workbench, and in a number of games and applications, but it does not work for everything.
+# Do not rely on the mouse and keyboard forwarding as your only means of input for the host computer.
+
 # Forward keyboard events to host system, defaults to off unless toggle key is pressed, toggled off using F12.
 # Syntax: keyboard [grab key] [grab|nograb] [autoconnect|noautoconnect]
 #   "grab" steals the keyboard from the Pi so Amiga/etc. input is not sent to the Pi