From 06f819b239a5f09523cabc6130b40e1694317d88 Mon Sep 17 00:00:00 2001 From: tomch Date: Sun, 1 Feb 2009 20:32:05 +0000 Subject: [PATCH] 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 | 13 +++++++------ AppleWin/help/CommandLine.html | 2 +- AppleWin/help/cfg-advanced.html | 15 +++++++-------- AppleWin/help/cfg-config.html | 13 ++++++++++--- AppleWin/source/Applewin.cpp | 4 ++-- AppleWin/source/Mockingboard.cpp | 4 ++++ 6 files changed, 31 insertions(+), 20 deletions(-) diff --git a/AppleWin/docs/History.txt b/AppleWin/docs/History.txt index 40f19eb8..ac5e459a 100644 --- a/AppleWin/docs/History.txt +++ b/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!) diff --git a/AppleWin/help/CommandLine.html b/AppleWin/help/CommandLine.html index 6a00bfbd..1254c84f 100644 --- a/AppleWin/help/CommandLine.html +++ b/AppleWin/help/CommandLine.html @@ -23,7 +23,7 @@ Use custom 2K ROM at [$F800..$FFFF]. <rom-file> must be 2048 bytes long

-printscreen
Enable the dialog box to display the last file saved to

- -printer-real
+ -use-real-printer
Enables Advanced configuration control to allow dumping to a real printer

 

Debug arguments: diff --git a/AppleWin/help/cfg-advanced.html b/AppleWin/help/cfg-advanced.html index 0b4ba9ac..185f69a1 100644 --- a/AppleWin/help/cfg-advanced.html +++ b/AppleWin/help/cfg-advanced.html @@ -35,10 +35,9 @@ this setting to select its location.
Use with caution! 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.
+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.

Encoding conversion for clones:
Characters are encoded from the character set used in @@ -48,14 +47,14 @@ Enabling this could cause problems when printing images.

Filter unprintable characters:
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.)

Append to print-file:
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.)

Terminate printing after idle:
Whan printing is started a printer file is created and it is diff --git a/AppleWin/help/cfg-config.html b/AppleWin/help/cfg-config.html index c98233f0..7fcfd238 100644 --- a/AppleWin/help/cfg-config.html +++ b/AppleWin/help/cfg-config.html @@ -55,14 +55,20 @@

Serial Port:
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.
+ serial port (or TCP port 1977). The Apple Super Serial Card (SSC) is emulated in slot-2.
+ The TCP interface to the Apple SSC can be used by the Apple // Game Server. + For details see the notes that comes with AGS:
+

  • Boot the Apple II to AppleSoft (ie. power on and hit Ctrl-Reset) and type IN#2. +
    • +
  • From a Windows DOS box, start AGS with "localhost 1977 apple2e". This will boot the emulated Apple II from AGS.
    • +
  • Nb. Only Enhanced Apple //e is working at the moment. +

    Ethernet Settings...:
    This allows to choose which network interface card (NIC) you want to - use with the Uthernet card.

    -

    Monochrome Color:
    + use with the Uthernet card.

    Monochrome Color:
    This is the color to use when you choose a monochrome video mode.

    Emulation Speed Control:
    @@ -85,5 +91,6 @@

  • Expected average video game performance (in FPS)
    • + diff --git a/AppleWin/source/Applewin.cpp b/AppleWin/source/Applewin.cpp index bdde1712..42dd62d3 100644 --- a/AppleWin/source/Applewin.cpp +++ b/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; } diff --git a/AppleWin/source/Mockingboard.cpp b/AppleWin/source/Mockingboard.cpp index a52848e1..e4bf4024 100644 --- a/AppleWin/source/Mockingboard.cpp +++ b/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)