Connecting to the serial console on Mac and Linux uses essentially the same process. Neither operating system needs drivers installed. On MacOSX, Terminal comes installed. On Linux, there are a variety such as gnome-terminal (called Terminal) or Konsole on KDE. I often have to do router configuration via a console port, so I use a Keyspan Serial Adapter to get access. Two problems then present themselves: ZTerm is a horrible Mac OS X app. It hasn't been updated in five years or so, and isn't a Universal Binary. The anatomy of a Console message: a timestamp, the process or app, and the message itself. Occasionally, you will also see a small paperclip icon on the far right end of a log message. This indicates that the message shown is only a smaller part of a more extensive report, and clicking the icon will open the full text in your text editor.
One of two things is generally meant by this, either using a Mac as the interface to a serial device (accomplished by running a terminal emulator program on the Mac), or using another machine to connect to the Mac over serial and accessing the shell provided by the Mac. This page is dedicated to the latter.
I first tried googling around, and I encountered a few references to this issue on various Mac forums. Many were quite old, and it appears that the process has gotten more difficult with more recent versions of OS X (at least Snow Leopard 10.5+). People have generally had more success with the Xserve OS X server versions. I was working with 10.6, non-server edition. The technique described here has been reported to work at least as recently as 10.10.4.
For completeness, here are some links to several of the sites I encountered, which should give you the basic idea of the problem:
Most WiFi channel analyzer and SSID scanner apps can detect which channel a WiFi network operates on and plot all nearby networks on a graph to make it obvious which channels are used the least. Some WiFi channel analyzer and WiFi channel scanner apps, however, are far more reliable than others, and some also come with unique features that make. Here we are overviewing 5 best WiFi analyzer apps highlighting their pros and cons: NetSpot – WiFi analyzer app for macOS offers the most visual and convenient heat maps and more. WiFi Scanner – WiFi analyzer app for Mac that also detects access points and clients in. Download WiFi Explorer Lite for macOS 10.13 or later and enjoy it on your Mac. WiFi Explorer Lite is a wireless network discovery tool that can help you identify channel conflicts and basic configuration problems that may be affecting the connectivity or performance of your home or office Wi-Fi network. The Best WiFi Channel Scanners for macOS. Here are some other WiFi channel scanners that you can run on your macOS system. NetSpot is a full-featured WiFi tool that runs on the Mac and Windows platforms. You can conduct surveys on your own and nearby wireless networks in order to ascertain the channels that are overloaded. Wifi channel app mac computer.
Getting a serial port
The first step is to get an RS232 serial port on your Mac, which hasn't been built-in for a long, long time. You probably want a USB to serial converter, of which there are a variety. Given variability in driver quality and compatibility, you may want to try a few models and driver implementation. For instance, two common chips include the FTDI series (official driver here) and the Prolific PL2303 chipset (open source driver here, closed source driver here). Of the two, I found the open source PL2303 driver to be slow and observed occasional data corruption (I did not try the closed source driver but heard worse things). I have found FTDI devices to perform more consistently.
Mac OS X 10.9 and below
Serial Console Mac App Windows 10
These versions do not come with drivers for any USB to serial converter of which I am aware. You will need to install a third-party driver, e.g. from one of the above links.Mac OS X 10.10 and above
Starting with 10.10, a driver for at least FTDI-based converters now ships with the OS. Drivers for other converters may also be present, but I have not used them.
If you are lucky enough to have a converter identifying itself using one of the common FTDI USB product IDs, then the serial device will simply appear. If not, you will have to alter the expected device ID in the driver configuration. If you encounter strange issues of any kind with the built-in driver, try the official FTDI driver as well. Supposedly, the driver priority of the built-in driver is set so that installing the official driver will override it without causing any conflicts, however I have not conclusively verified this. For an example of how to alter the device ID or disable the built-in driver (follow just step 1), see this blog post. For official documentation on manipulating the FTDI driver or uninstalling it, see FTDI Application Note 134.
In the process of doing this myself, I learned a bit about the kernel extension (of which these drivers are each an instance) system in OS X. The basic idea is that each has a [drivername].kext directory somewhere under /System/Library/Extensions or /Library/Extensions, which if removed or renamed to not end with .kext (e.g. by switching .kext with .disabled) will prevent the driver from being loaded in the future. For an immediate load or unload, run kextload [path to .kext directory] or kextunload [path to .kext directory] as root. To see the list of currently installed extensions, run kextstat (e.g. | grep -i ftdi). After re-enabling a driver, the driver may not reload even after the next reboot because a separate cache of kernel extensions is kept to speed up enumeration on boot. This can be manipulated directly by the kextcache program, or more easily by simply running touch /System/Library/Extensions (which updates its timestamp to the current time) so that the cache is rebuilt on next boot.
Testing your serial port
If you have this working, a new device file should show up in /dev. Run ls /dev/tty.* to see what yours is showing up as. The next step is to test the serial port using some sort of terminal emulation program. I used goSerial, which happened to be the first one I found. It worked fine for my purposes, but better ones may exist.
Getting a getty running
In the Unix world, getty is the program that presents a login prompt. In earlier versions of Mac OS, one could add the appropriate line to /etc/ttys and have a prompt appear on a serial port. It appears that as of 10.6 (and possibly somewhat earlier), this is no longer possible.
Instead, I found that creating a script to spawn the getty that is run by launchd does the trick. Note that running the getty on the command line appears to fail because the login_tty syscall can only be invoked by the init process (which on Mac OS is launchd). I therefore created a file called serialconsole.plist (name it as you wish) in /Library/LaunchDaemons/ containing the following:
Note that first bit sets the daemon name, the second bit sets the program arguments (one 'string' per argument), and the last bit (keepalive) instructs launchd to restart the daemon when it exits (eg, the user logs out of the console). The first program argument is the getty program to execute, the second is the relevant line in /etc/gettytab that defines the desired serial port configuration (in this case the typical 115200 baud, 8 data bits, no parity, 1 stop bit; '8N1'), and the third argument to getty must be the name of the serial port device in /dev, which for the two devices I had were one of the two listed. As noted later, the 'cu.' version of the serial port rather than the 'tty.' version may need to be used. Initially, this was reported in only some cases but seems to be the norm as of 10.10
Using the program launchctl, you can manually reload these configuration files and restart daemons. Here are some self-explanatory commands you might use, of which only the first two should be necessary to start the getty manually after creating the configuration file above.
Of course, rebooting should also work if you're lazy. Note that in my case, the usb serial device appears in /dev
As of 10.10, launchctl load and launchctl unload are considered legacy (but still supported for now), and a new scheme should be used. Supposedly the following is the preferred sequence:
However, in my case these did not seem to be sufficient, whereas launchctl load did the trick. Let me know what seems to work for you.
Automatic login
For my application, I wanted a shell prompt to be immediately presented, without asking for username or password or displaying the login messages (last time logged in, new mail, etc.). To accomplish this, I needed to add the following entry to /etc/gettytab:
as well as change the std.115200 to custom.115200 in the serialconsole.plist file. Note that this changes the login banner message to just a carriage return and newline, automatically logs in as user <username>, and spawns the login program /usr/bin/quietlogin.sh, which is a script I wrote (that wraps the default /usr/bin/login) containing the following:
The reason this additional script was required was due to stupidity on the part of the login program that I observed. First, it seems to ignore the presence of a .hushlogin in the user's home directory requesting that no welcome messages be printed. Further, the -f argument passed to login must be first on the command line (before a '-q' which forces quite mode). (See the login man page for some of idea of what I'm talking about.) The above script performs this necessary munging.
Hiccups
Things not working? I'm not a mac user myself, so I can't offer too much help with debugging. Serial stuff in Mac OS appears to be of little interest to Apple, so things may change and break with each new version. If you learn something new during your own tinkering, let me know and I'll post it here. My email address may be derived from the URL of this document.
If you're using the 'tty' device and it's not working, definitely try the 'cu' device (replacing tty.<device name> with cu.<devicename>, thus using the 'cu' call-out device instead of 'tty' terminal device). This was first reported when using somewhat unusual hardware as a Hackintosh, but more recent reports suggest this is now the norm. Perhaps it depends on the usb-to-serial driver used? I'm seeking input on this, so send me email with datapoints.
Other thoughts
One reader suggested the possibility of using serial port emulation on a bluetooth connection as an alternative to USB-to-serial dongles. I would be curious to hear reports from anyone attempting this, particularly on behavior prior to bluetooth peering, during radio hiccups, and after reconnects (assuming the idea works at all). Before going too far down this road, do remember you can run IP over bluetooth and just use proper networking if your application permits.
Responseware app for mac os. Open the app.
Changelog
Serial Console For Windows 10
- [2015-08-09] Updated for 10.10
- [2014-09-04] Example launchctl commands, confirmation still works on 10.9.4, and additional note on 'cu' device reported by an anonymous reader
- [2014-01-05] Confirmation still works on 10.9.1 and bluetooth alternative suggestion by Alex Kudlov
- [2013-01-08] Fixed missing '<username>' after the al= in automatic login section
- [2012-01-22] Added info on 'cu' device instead of 'tty' reported by David Roach
- [2011-08-10] Fixed several since-broken links (damn you apple)
- [2010-03-20] Initial version
Last modified 8/9/2015