The Linux Serial HOWTO

revised by David S.Lawyer bf347@lafn.org original by Greg Hankins

1. Introduction

• 1.1 Copyright
• 1.2 Related HOWTO's re: the Serial Port
• 1.3 Release Notes
• 1.4 New Versions Of This Document
• 1.5 Feedback
• 1.6 Disclaimer

2. Supported Serial Hardware

• 2.1 Standard PC Serial Boards
• 2.2 Plug And Play (PnP) Modems
• 2.3 Dumb Multiport Serial Boards (with 8250/16450/16550A UART's)
• 2.4 Intelligent Multiport Serial Boards
• 2.5 Unsupported Serial Hardware

3. What Are The Names Of The Serial Ports?

• 3.1 Devices: modem, mouse
• 3.2 The cua Device
• 3.3 Serial Port Devices and Numbers In /dev
• 3.4 Notes For Dumb Multiport Boards
• 3.5 Notes For Intelligent Multiport Boards

4. Interesting Programs You Should Know About

• 4.1 What is getty?
• 4.2 What is setserial?

5. How Do I Dial Out With My Modem?

• 5.1 Hardware Requirements
• 5.2 Talking To Your Modem
• 5.3 Dial Out Modem Configuration
• 5.4 Hardware Flow Control

6. How Do I Dial In And Out With My Modem Using getty_ps

• 6.1 Dial In And Out Modem Configuration
• 6.2 Installing getty_ps

7. uugetty

• 7.1 Setting up uugetty
• 7.2 Customizing uugetty

8. How Do I Set Up A Terminal Connected To My PC?

• 8.1 Hardware Requirements
• 8.2 Setting up getty (part of getty_ps)
• 8.3 Notes On Setting Up A PC As A Terminal

9. Can I Use More Than Two Serial Devices?

• 9.1 Choosing Serial Device Interrupts
• 9.2 Setting Serial Device Addresses

10. How Do I Set Up My Serial Ports For Higher Speeds? What Speed Should I Use With My Modem?

11. Communications Programs And Utilities

12. Serial Tips And Miscellany

• 12.1 kermit and zmodem
• 12.2 Setting Terminal Types Automagically
• 12.3 Color ls On Serial Connections
• 12.4 Printing To A Printer Connected To A Terminal
• 12.5 Can Linux Configure The Serial Devices Automagically?
• 12.6 Using A Serial Console
• 12.7 Higher Serial Throughput

13. One Step Further...

• 13.1 What Are Lock Files?
• 13.2 ``baud'' Vs. ``bps''
• 13.3 What Are UARTs? How Do They Affect Performance?

14. Troubleshooting

• 14.1 I Keep Getting ``line NNN of inittab invalid''
• 14.2 When I Try To Dial Out, It Says ``/dev/cuaN: Device or resource busy''
• 14.3 I Keep Getting ``Getty respawning too fast: disabled for 5 minutes''
• 14.4 Serial Devices Are Slow, Or Serial Devices Can Only Send In One Direction
• 14.5 My Modem Is Hosed After Someone Hangs Up, Or uugetty doesn't respawn
• 14.6 I Have My Terminal Connected To My PC, But After I Type In A Login Name, It Just Locks Up
• 14.7 At High Speeds, My Modem Looses Data
• 14.8 On Startup, Linux Doesn't Report The Serial Devices The Way I Have Them Configured
• 14.9 rz And/Or sz Don't Work When I Call My Linux Box On A Modem
• 14.10 My Screen Is Displaying Funny Looking Characters
• 14.11 getty Or uugetty Still Doesn't Work

15. Other Sources Of Information

16. Contributions