Perceive

Turning your Apple IIc into a Dumb Terminal

I recently purchased an Apple IIc, and decided it would be fun to use it as a dumb terminal on my Mac. There are only a few references out there, and none of them have complete/accurate information anymore it seems, so I thought I would write up the steps that I did that work.

This works with a Mac running macOS Monterey.

First you'll need to purchase a couple of items:

  1. 5DIN to DB9 cable. I purchased this one: Apple IIc, Laser 128 null modem. If you purchase one that is not a null modem, you'll need to buy an adapter.
    1. DB9 to USB Adapter: There are a ton of these out there, but I bought this: Tera Grand - Premium USB 2.0 to RS232 Serial DB9 Adapter. I suggest buying one with the FTDI chipset, as it has built-in support in macOS and you won't need additional drivers. It is also the most common.
      1. If you have a newer (i.e 2019 or newer) you may also need a USB-A to USB-C adapter, as you probably only have USB-C ports.

        Now for the fun part.

        On Your Mac

        Plug in the USB to DB9 converter, and connect the able to it and the Apple IIc.

        Next you need to spawn an instance of getty, which is used for displaying the login prompt. To do this, you'll need to create our own launch daemon

        To do so, create a new file named /Library/LaunchDaemons/serialconsole.plist, with the following contents:

        <?xml version="1.0" encoding="UTF-8"?>
        <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
        <plist version="1.0">
        <dict>
        	<key>Label</key>
        	<string>serialconsole</string>
        	<key>ProgramArguments</key>
        	<array>
        		<string>/usr/libexec/getty</string>
        		<string>std.2400</string>
        		<string>tty.usbserial-FTCD99Q4</string>
        	</array>
        	<key>KeepAlive</key>
        	<true/>
        </dict>
        </plist>
        

        Note the first getty parameter, 'std.2400', should be changed to match the baud rate that you choose.

        The second parameter is the port to connect to. On my machine, the converter shows up as "tty.usbserial-FTCD99Q4". You can find yours in the /dev directory, and will likely start with tty.usbserial. ls /dev/tty-usbserial* will likely return yours.

        Now register the daemon:

        launchctl load -F /Library/LaunchDaemons/serialconsole.plist
        

        You'll also need to start and stop it before and after use:

        launchctl start serialconsole
        launchctl stop serialconsole
        

        If you want to remove the daemon for some reason:

        launchctl unload -F /Library/LaunchDaemons/serialconsole.plist
        

        On Your Apple IIc

        On the Apple side of things, you'll want to download the MODEM MGR terminal emulator. There are three disk, Installation, Program, and Utility. You'll at least need the first two. The MODEM MGR Docs are useful too.

        Getting the software working on your Apple IIc is an exercise left up to you, dear reader. I have a Floppy EMU which emulates a floppy, and lets you load programs from an SD card making it very easy.

        Once you have your disks ready, load up the first one. Configure the video driver (40 or 80 column), choose the non-smart modem and set the port speed. I chose 2400 to make it a bit more old-school so the terminal updates slower. lastly, set the parity, bits and stop bits to N, 8 and 1 respectively. Save the changes.

        Now you'll boot from the program disk in the future, ESC Shift-? will bring up the menu. Once you launch it, press ESC : V, and hit enter and you should get a login prompt!

        Thanks to the following posts: