Updated html docs for AGS support via TCP port 1977

Changed cmd-line switch from -printer-real to -use-real-printer

AppleWin/docs/History.txt

@@ -18,26 +18,27 @@ Restrictions/bugs:
 - During Mockingboard playback, Speaker emulation isn't precise
 
 
-1.16.0 - 17 Jan 2009 (beta)
+1.16.0 - 1 Feb 2009 (beta)
 ---------------------------
 Changes:
+. Support for Apple // Game Server via TCP (port 1977) : beta
 . For GPL reasons, switched the following modules:
-  - AY8910 (from MAME  to FUSE) : beta
-  - MC6821 (from MAME  to VICE) : beta
-  - Z80    (from Z80Em to VICE) : beta
+  - AY8910 (from MAME  to FUSE) : beta Mockingboard/Phasor
+  - MC6821 (from MAME  to VICE) : beta Mouse card
+  - Z80    (from Z80Em to VICE) : beta CP/M Softcard
 . Printer support:
   - Printer dump filename
   - Filter unprintable characters
   - Append to print-file
   - Terminate printing after n seconds of idle
   - Encoding conversion for Pravets
-  - Dump to printer (CAUTION! Enabled via command line switch: -printer-real)
+  - Dump to printer (CAUTION! Enabled via command line switch: -use-real-printer)
 . Added Pravets 8M
 
 Fixes:
+. BugID-014557: Fix for loading serial port from Registry (caused AppleWin to crash when booting Apple Pascal)
 . Some floating bus bugs (fixes the Bulgarian game: "Walking in the town" & Annunciator read)
 . FLASH rate (now 3Hz, was 6Hz)
-. BugID-014557: Fix for loading serial port from Registry (caused AppleWin to crash when booting Apple Pascal)
 . Fix for Willy Byte & MB support (strange 6522 behaviour!)
 
 

AppleWin/help/CommandLine.html

@@ -23,7 +23,7 @@
 		Use custom 2K ROM at [$F800..$FFFF]. &lt;rom-file&gt; must be 2048 bytes long<br><br>
 		-printscreen<br>
 		Enable the dialog box to display the last file saved to<br><br>
-		-printer-real<br>
+		-use-real-printer<br>
 		Enables Advanced configuration control to allow dumping to a real printer<br>
 		<P>&nbsp;</P>
 		<P style="FONT-WEIGHT: bold">Debug arguments:

AppleWin/help/cfg-advanced.html

@@ -35,10 +35,9 @@ this setting to select its location.<br>
 </strong><span style="font-weight: bold; font-style: italic;">Use
 with caution!</span> Enables dumping to a real printer. If
 disabled, the printout is stored only in printer.txt file in the AppleWin folder.
-This probably works properly (not tested) when using a printer
-compatible with the printer selected in the Apple II applications. In
-modern printers trying to print images will result in printing tens of
-pages with nonsense. Requires command line switch -printer-real.<br>
+It's recommended to use a printer compatible with the printer selected in the Apple II applications.
+With modern printers trying to print images will result in printing tens of
+pages of nonsense. Requires command line switch -use-real-printer.<br>
 </p>
 <p style="margin-left: 40px;"><strong>Encoding conversion for clones:<br>
 </strong>Characters are encoded from the character set used in
@@ -48,14 +47,14 @@ Enabling this could cause problems when printing images.
 <p style="margin-left: 40px;"><strong>Filter unprintable characters:<br>
 </strong>Some characters represent commands for the printer and
 shall not be printed. When saving them to the printer dump file they
-may appear as some strange symbols. I may want to disable filtering
-when dumping to printer.
+may appear as some strange symbols. (You will want to disable filtering
+when dumping to a real printer.)
 </p>
 <p style="margin-left: 40px;"><strong>Append to print-file:<br>
 </strong>When disabled previous the print file is replaced (unless it has a
 different name) by the newly created print file. Otherwise the newly
-printed data is added to the existing print file. I should better
-disable appending when dumping to printer.
+printed data is added to the existing print file. (You will want to
+disable appending when dumping to a real printer.)
 </p>
 <p style="margin-left: 40px;"><strong>Terminate printing after idle:<br>
 </strong>Whan printing is started a printer file is created and it is

AppleWin/help/cfg-config.html

@@ -55,14 +55,20 @@
 		<P>
 			<strong>Serial Port:<br>
 			</strong>This option will remap the emulated Apple's serial port to your PC's 
-			serial port. The Apple Super Serial Card is emulated in slot-2.<br>
+			serial port (or TCP port 1977). The Apple Super Serial Card (SSC) is emulated in slot-2.<br>
+            The TCP interface to the Apple SSC can be used by the <a href="http://sourceforge.net/projects/a2gameserver">Apple // Game Server</a>.
+            For details see the notes that comes with AGS:<br>
+            <li>Boot the Apple II to AppleSoft (ie. power on and hit Ctrl-Reset) and type IN#2.
+            </li>
+            <li>From a Windows DOS box, start AGS with "localhost 1977 apple2e". This will boot the emulated Apple II from AGS.</li>
+            <li>Nb. Only Enhanced Apple //e is working at the moment.
+            <br>
 			<STRONG>
 				<BR>
 				Ethernet Settings...:</STRONG>
 			<br>
 			This allows to choose which network interface card (NIC) you want to 
-			use&nbsp;with the Uthernet card.</P>
-		<P><STRONG>Monochrome Color:</STRONG><br>
+			use&nbsp;with the Uthernet card.<P><STRONG>Monochrome Color:</STRONG><br>
 			This is the color to use when you choose a monochrome video mode.<br>
 			<br>
 			<strong>Emulation Speed Control:</strong><br>
@@ -85,5 +91,6 @@
 			<li>
 				Expected average video game performance (in FPS)</li>
 		</ul>
+	</li>
 	</body>
 </html>

AppleWin/source/Applewin.cpp

@@ -727,11 +727,11 @@ int APIENTRY WinMain (HINSTANCE passinstance, HINSTANCE, LPSTR lpCmdLine, int)
 			if ((g_hCustomRomF8 == INVALID_HANDLE_VALUE) || (GetFileSize(g_hCustomRomF8, NULL) != 0x800))
 				g_bCustomRomF8Failed = true;
 		}
-		else if(strcmp(lpCmdLine, "-printscreen") == 0)		// turn on dispay of the last filename print screen was saved to
+		else if(strcmp(lpCmdLine, "-printscreen") == 0)		// Turn on display of the last filename print screen was saved to
 		{
 			g_bDisplayPrintScreenFileName = true;
 		}
-		else if(strcmp(lpCmdLine, "-printer-real") == 0)	// Enable control in Advanced config to allow dumping to a real printer
+		else if(strcmp(lpCmdLine, "-use-real-printer") == 0)	// Enable control in Advanced config to allow dumping to a real printer
 		{
 			g_bEnableDumpToRealPrinter = true;
 		}

AppleWin/source/Mockingboard.cpp

@@ -288,6 +288,10 @@ static void AY8910_Write(BYTE nDevice, BYTE nReg, BYTE nValue, BYTE nAYDevice)
 				break;
 
 			case AY_LATCH:		// 7: LATCH ADDRESS
+				// http://www.worldofspectrum.org/forums/showthread.php?t=23327
+				// Selecting an unused register number above 0x0f puts the AY into a state where
+				// any values written to the data/address bus are ignored, but can be read back
+				// within a few tens of thousands of cycles before they decay to zero.
 				if(pMB->sy6522.ORA <= 0x0F)
 					pMB->nAYCurrentRegister = pMB->sy6522.ORA & 0x0F;
 				// else Pro-Mockingboard (clone from HK)