Merge branch 'dev'

Author: dirkwhoffmann

Documentation/HowTo/NullModemCable.md

@@ -0,0 +1,33 @@
+# Connecting Two Amigas
+
+vAmiga supports two emulator instances to be connected with a null modem cable, allowing the user to run multiplayer games. In this article we will walk through the necessary steps to connect two emulator instances running Battle Chess.
+
+First of all, launch vAmiga, open the configuration window and switch to the Peripherals tab. In this tab you can configure the serial interface:
+
+![Peripherals Tab](images/battlechess1.png "Peripherals Tab")
+
+Now open the serial port popup menu and select *Null Modem Cable* from the options list. This will connect one side of a null modem cable to the serial port of your virtual Amiga. Internally, the null modem cable is emulated using socket connections, which means that the connected Amigas must agree on a common port number to communicate. By default, vAmiga uses port  8080, but you can choose a different port if you like.
+
+![Peripherals Tab](images/battlechess2.png "Peripherals Tab")
+
+As you can see in the screenshot above, a small icon has appeared in the status bar. This indicates that the socket server has been activated and is waiting for another emulator instance to connect.
+
+Now launch another instance of vAmiga and connect the null modem cable the same way.
+
+![Peripherals Tab](images/battlechess3.png "Peripherals Tab")
+
+After the null modem cable has been selected in the second emulator instance, the status icon has changed its shape, indicating that the connection has been established. If the icon looks different on your computer, please check if both emulator instances are listening to the same socket port.
+
+Now it's time to load Battle Chess on both Amigas. The configuration of the null modem cable is quite simple in this game: The the *Settings* menu let's you select the player type for each side of the board. 
+
+This is how I configured the first emulator instance. The Amiga controls the blue army, the connected computer controls the red army.
+
+![Battle Chess Setup](images/battlechess4.png "Battle Chess Setup")
+
+The second emulator instance is configured the other way around. The Amiga controls the red soldiers, the connected computer controls the blue ones. After selecting *New Game* from the menu in either emulator instance, it's time to chill. Have fun with two vAmigas fighting each other.
+
+## Troubleshooting
+
+If everything works as expected, the socket connection should be established exactly as described above. If vAmiga refuses to connect, you can display some additional debug information in RetroShell. To do so, open RetroShell by pressing on the corresponding toolbar icon. Inside RetroShell, switch to the *Debugger* by pressing the *Shift + Return*. Now, type `server serial` as shown in the screenshot below. This command displays the current connection status and outputs some statistical information about the transferred data.
+
+![RetroShell](images/battlechess5.png "RetroShell")

Documentation/HowTo/images/battlechess1.png

@@ -161,7 +161,7 @@ class CoreComponent : public CoreObject, NoCopy, NoAssign {
      * inspection target via Amiga::setInspectionTarget().
      */
     void inspect() const;
-    virtual void _inspect() const { };
+    virtual void _inspect() const { }
 
     /* Base method for building the class specific getInfo() methods. When the
      * emulator is running, the result of the most recent inspection is

Documentation/HowTo/images/battlechess2.png

@@ -130,7 +130,6 @@ enum_long(OPT)
     // Paula audio
     OPT_SAMPLING_METHOD,
     OPT_FILTER_TYPE,
-    OPT_FILTER_ACTIVATION,
     OPT_AUDPAN,
     OPT_AUDVOL,
     OPT_AUDVOLL,
@@ -250,7 +249,6 @@ struct OptionEnum : util::Reflection<OptionEnum, Option>
 
             case OPT_SAMPLING_METHOD:       return "SAMPLING_METHOD";
             case OPT_FILTER_TYPE:           return "FILTER_TYPE";
-            case OPT_FILTER_ACTIVATION:     return "FILTER_ACTIVATION";
             case OPT_AUDPAN:                return "AUDPAN";
             case OPT_AUDVOL:                return "AUDVOL";
             case OPT_AUDVOLL:               return "AUDVOLL";

Documentation/HowTo/images/battlechess3.png

@@ -121,8 +121,7 @@ Defaults::Defaults()
     setFallback(OPT_AUTOFIRE_BULLETS, -3);
     setFallback(OPT_AUTOFIRE_DELAY, 125);
     setFallback(OPT_SAMPLING_METHOD, SMP_NONE);
-    setFallback(OPT_FILTER_TYPE, FILTER_BUTTERWORTH);
-    setFallback(OPT_FILTER_ACTIVATION, FILTER_AUTO_ENABLE);
+    setFallback(OPT_FILTER_TYPE, FILTER_A500);
     setFallback(OPT_AUDPAN, { 0, 3 }, 50);
     setFallback(OPT_AUDPAN, { 1, 2 }, 350);
     setFallback(OPT_AUDVOL, { 0, 1, 2, 3 }, 100);

Documentation/HowTo/images/battlechess4.png

@@ -444,6 +444,9 @@ Agnus::executeUntil(Cycle cycle) {
             if (isDue<SLOT_MSE2>(cycle)) {
                 controlPort2.mouse.serviceMouseEvent <SLOT_MSE2> ();
             }
+            if (isDue<SLOT_RSH>(cycle)) {
+                retroShell.serviceEvent();
+            }
             if (isDue<SLOT_KEY>(cycle)) {
                 keyboard.serviceKeyEvent();
             }
@@ -662,7 +665,6 @@ Agnus::eofHandler()
     copper.eofHandler();
     controlPort1.joystick.eofHandler();
     controlPort2.joystick.eofHandler();
-    retroShell.eofHandler();
 
     // Update statistics
     updateStats();