Add Meson build files.

[pistorm] / default.cfg

diff --git a/default.cfg b/default.cfg
index b8f46a263dbc164dcb4433f455e8d7fe3a61f7dd..e34ba304315190b650413f5f2f1a384f530244cc 100644 (file)
--- 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
@@ -28,7 +33,11 @@ map type=register address=0xDC0000 size=0x10000
 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
@@ -46,10 +55,15 @@ setvar piscsi6 platforms/amiga/pistorm.hdf
 #setvar pi-net
 
 # Uncomment and edit to set a custom config filename for the A314 emulation
-#setvar a314_conf /etc/opt/a314/a314d.conf
+#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