diff --git a/LaunchAPPL/Client/LaunchAPPL.cfg.example b/LaunchAPPL/LaunchAPPL.cfg.example similarity index 76% rename from LaunchAPPL/Client/LaunchAPPL.cfg.example rename to LaunchAPPL/LaunchAPPL.cfg.example index 4da1ff0d01..a34401bc3b 100644 --- a/LaunchAPPL/Client/LaunchAPPL.cfg.example +++ b/LaunchAPPL/LaunchAPPL.cfg.example @@ -18,6 +18,23 @@ # emulator = carbon +# ########### A real Mac connected via a serial cable + + # Prerequisited: + # - A Mac with a modem port, and any classic Mac system software + # - The LaunchAPPLServer application + # (`Retro68-build/build-target/LaunchAPPL/Server/`) running on that Mac + # - A computer with a serial port (or USB serial adapter) running Retro68 + # - A Mac-To-PC null modem cable + # (https://allpinouts.org/pinouts/cables/serial/macintosh-to-pc-null-modem/) + + # if you change the speed, make sure to choose the matching speed from the + # menu in the server application + +# emulator = serial +# serial-port = /dev/ttyUSB0 +# serial-baud = 19200 + # ########### Mini vMac (old 68K Macs) @@ -48,7 +65,7 @@ # And finally, autoquit: # autoquit-image = ./autoquit-1.1.1.dsk -# ########### Executor (68K only) +# ########### Executor # No ROM files needed - an opensource reimplementation of classic Mac OS. diff --git a/README.md b/README.md index 476045c7a5..4afd4a8cfb 100644 --- a/README.md +++ b/README.md @@ -332,6 +332,8 @@ Currently, LaunchAPPL supports the following methods for launching Mac applicati * carbon - launch as a Carbon app on PowerPC Macs and via Rosetta on Intel Macs up to Snow Leopard (10.6) * minivmac - launch using the Mini vMac emulator * executor - launch using Executor +* ssh - Invoke the `LaunchAPPL` tool remotely via ssh +* serial - Connect to a real Mac running the `LaunchAPPLServer` application via a null modem cable If you're running on a Mac that's old enough to use the `classic` or `carbon` backends, they will work out of the box, just launch an application as follows