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.
- Serial Terminal For Mac
- Download Serial Connection Tool For Mac Catalina
- Serial App For Mac
- Download Serial Connection Tool For Macbook Pro
On Mac, open Terminal and type the following: ls /dev/tty. Each serial connection shows up in the /dev/ directory. It has a name that starts with tty. The command ls shows you a list of items in a directory. You can use. as a wildcard, to search for files that start with the same letters but end in something different. A basic tool for testing your serial port connection on your Mac is CoolTerm by Roger Meier: CoolTerm is a simple serial port terminal application (no terminal. They help us to connect our Android devices to tools like Odin, Sony Flash tool, and SuperOneClick. Below, we are sharing the links to USB drivers for most of the popular Android device manufacturers like Samsung, LG, Sony, Google, HTC, Motorola, Dell, etc. Serial Tools Serial Tools for OS X, includes a Terminal Emulator, a Protocol Analyzer, and a serial port monitor to watch for connections and removals of serial ports. Serial Tools is completely free, and available from the Mac App Store. Serial is a basic terminal emulator that can help you connect and control serial devices, such as servers, network equipment like routers or modems, PBX systems, and so on. The good news is that Serial comes with built-in support for most serial devices, so you do not have to manually install any driver.
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.
Serial Terminal For Mac
For completeness, here are some links to several of the sites I encountered, which should give you the basic idea of the problem:
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
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.
Download Serial Connection Tool For Mac Catalina
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.
Serial App For Mac
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:
Download Serial Connection Tool For Macbook Pro
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.
Changelog
- [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
