From owner-svn-doc-head@FreeBSD.ORG Wed May 7 15:22:52 2014 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 8A21AC45; Wed, 7 May 2014 15:22:52 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 769A76D7; Wed, 7 May 2014 15:22:52 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s47FMqox034401; Wed, 7 May 2014 15:22:52 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s47FMqdV034400; Wed, 7 May 2014 15:22:52 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201405071522.s47FMqdV034400@svn.freebsd.org> From: Dru Lavigne Date: Wed, 7 May 2014 15:22:52 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44784 - head/en_US.ISO8859-1/books/handbook/serialcomms X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 07 May 2014 15:22:52 -0000 Author: dru Date: Wed May 7 15:22:51 2014 New Revision: 44784 URL: http://svnweb.freebsd.org/changeset/doc/44784 Log: Editorial review of Serial Terminology and Hardware. Move signal name table into this section. Add xml ids to the tables in this section. More commits to come. Sponsored by: iXsystems Modified: head/en_US.ISO8859-1/books/handbook/serialcomms/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/serialcomms/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/serialcomms/chapter.xml Wed May 7 14:02:29 2014 (r44783) +++ head/en_US.ISO8859-1/books/handbook/serialcomms/chapter.xml Wed May 7 15:22:51 2014 (r44784) @@ -88,28 +88,28 @@ Data Communications EquipmentDCE (DTE) is the other endpoint in a - serial communication. Typically, it is a modem. + serial communication. Typically, it is a modem or serial + terminal. - RS-232 + RS-232 The original standard which defined hardware serial communications. It has since been renamed to - TIA-232RS-232C - cables. + TIA-232. - When talking about communications data rates, this section - does not use the term baud. Baud refers to the - number of electrical state transitions that may be made in a + When referring to communication data rates, this section + does not use the term baud. Baud refers to the + number of electrical state transitions made in a period of time, while bps is the - correct term to use. + correct term to use. - To connect a modem or serial terminal to a &os; system, a + To connect a serial terminal to a &os; system, a serial port on the computer and the proper cable to connect to the serial device are needed. Users who are already familiar with serial hardware and cabling can safely skip this @@ -120,30 +120,98 @@ There are several different kinds of serial cables. The two most common types are null-modem cables and standard - RS-232 cables. The documentation for the hardware should + RS-232 cables. The documentation for the hardware should describe the type of cable required. + These two types of cables differ in how the wires are + connected to the connector. Each wire represents a signal, + with the defined signals summarized in . A standard serial + cable passes all of the RS-232C signals + straight through. For example, the Transmitted Data pin on + one end of the cable goes to the Transmitted + Data pin on the other end. This is the type of + cable used to connect a modem to the &os; system, and is also + appropriate for some terminals. + + A null-modem cable + switches the Transmitted Data pin of the + connector on one end with the Received + Data pin on the other end. The connector can be + either a DB-25 or a + DB-9. + + A null-modem cable can be constructed + using the pin connections summarized in , , and . While the standard + calls for a straight-through pin 1 to pin 1 + Protective Ground line, it is often + omitted. Some terminals work using only pins 2, 3, and 7, + while others require different configurations. When in doubt, + refer to the documentation for the hardware. + null-modem cable - A null-modem cable passes some signals, such as - Signal Ground, straight through, but switches - other signals. For example, the Transmitted - Data pin on one end goes to the Received - Data pin on the other end. - - A null-modem cable can be constructed for use with - terminals. The following table shows the RS-232C signal names and - the pin numbers on a DB-25 connector. While the standard - calls for a straight-through pin 1 to pin 1 - Protective Ground line, it is often - omitted. Some terminals work using only pins 2, 3, and 7, - while others require different configurations than the - examples shown below. + + <acronym>RS-232C</acronym> Signal Names -
+ + + + Acronyms + Names + + + + + + RD + Received Data + + + + TD + Transmitted Data + + + + DTR + Data Terminal Ready + + + + DSR + Data Set Ready + + + + DCD + Data Carrier Detect + + + + SG + Signal Ground + + + + RTS + Request to Send + + + + CTS + Clear to Send + + + +
+ + DB-25 to DB-25 Null-Modem Cable @@ -151,7 +219,7 @@ Signal Pin # - + Pin # Signal @@ -233,9 +301,7 @@
- The next two tables show two other common schemes. - - +
DB-9 to DB-9 Null-Modem Cable @@ -243,7 +309,7 @@ Signal Pin # - + Pin # Signal @@ -325,7 +391,7 @@
- +
DB-9 to DB-25 Null-Modem Cable @@ -333,7 +399,7 @@ Signal Pin # - + Pin # Signal @@ -422,34 +488,17 @@ to the other single pin. - The above designs seem to be the most popular. In - another variation, SG connects to SG, TD connects to RD, RTS - and CTS connect to DCD, DTR connects to DSR, and - vice-versa. - - RS-232C cables - - A standard serial cable passes all of the RS-232C signals - straight through. The Transmitted Data pin on - one end of the cable goes to the Transmitted - Data pin on the other end. This is the type of - cable used to connect a modem to the &os; system, and is also - appropriate for some terminals. - Serial ports are the devices through which data is transferred between the &os; host computer and the terminal. - This section describes the kinds of ports that exist and how - they are addressed in &os;. - - Several kinds of serial ports exist. Before purchasing or + Several kinds of serial ports exist. Before purchasing or constructing a cable, make sure it will fit the ports on the terminal and on the &os; system. - Most terminals have DB-25 ports. Personal computers may - have DB-25 or DB-9 ports. A multiport serial card may have - RJ-12 or RJ-45 ports. - - See the documentation that accompanied the hardware for + Most terminals have DB-25 ports. Personal computers may + have DB-25 or DB-9 + ports. A multiport serial card may have + RJ-12 or RJ-45/ ports. + See the documentation that accompanied the hardware for specifications on the kind of port or visually verify the type of port. @@ -462,28 +511,29 @@ Call-in ports are named /dev/ttyuN where N is the port number, - starting from zero. Generally, the call-in port is used + starting from zero. If a terminal is connected to the + first serial port (COM1), use + /dev/ttyu0 to refer to the terminal. + If the terminal is on the second serial port + (COM2), use + /dev/ttyu1, and so forth. Generally, the call-in port is used for terminals. Call-in ports require that the serial line - assert the Data Carrier Detect (DCD) + assert the Data Carrier Detect signal to work correctly. Call-out ports are named - /dev/cuauN. + /dev/cuauN + on &os; versions 10.x and higher and + /dev/cuadN + on &os; versions 9.x and lower. Call-out ports are usually not used for terminals, but are used for modems. The call-out port can be used if the - serial cable or the terminal does not support the carrier - detect signal. + serial cable or the terminal does not support the Data Carrier Detect + signal. - - If a terminal is connected to the first serial port - (COM1), use - /dev/ttyu0 to refer to the terminal. If - the terminal is on the second serial port - (COM2), use - /dev/ttyu1, and so forth. @@ -1066,64 +1116,7 @@ ttyu5 "/usr/libexec/getty std.19200" modem When using an external modem, a proper cable is needed. A - standard RS-232C serial cable should suffice as long as all of - the normal signals are wired: - -
- Signal Names - - - - - Acronyms - Names - - - - - - RD - Received Data - - - - TD - Transmitted Data - - - - DTR - Data Terminal Ready - - - - DSR - Data Set Ready - - - - DCD - Data Carrier Detect (RS-232's Received Line - Signal Detector) - - - - SG - Signal Ground - - - - RTS - Request to Send - - - - CTS - Clear to Send - - - -
+ standard RS-232C serial cable should suffice. &os; needs the RTS and CTS signals for flow control at speeds