diff options
Diffstat (limited to 'documentation/content/en/articles/serial-uart')
| -rw-r--r-- | documentation/content/en/articles/serial-uart/_index.adoc | 16 | ||||
| -rw-r--r-- | documentation/content/en/articles/serial-uart/_index.po | 57 |
2 files changed, 37 insertions, 36 deletions
diff --git a/documentation/content/en/articles/serial-uart/_index.adoc b/documentation/content/en/articles/serial-uart/_index.adoc index 3852251b85..e953644b93 100644 --- a/documentation/content/en/articles/serial-uart/_index.adoc +++ b/documentation/content/en/articles/serial-uart/_index.adoc @@ -445,7 +445,7 @@ Modems operating at 28,800 and higher speeds have variable Symbol rates, but the === The IBM Personal Computer UART -Starting with the original IBM Personal Computer, IBM selected the National Semiconductor INS8250 UART for use in the IBM PC Parallel/Serial Adapter. +Starting with the original IBM Personal Computer, IBM selected the National Semiconductor INS8250 UART for use in the IBM PC Parallel/Serial Adapter. Subsequent generations of compatible computers from IBM and other vendors continued to use the INS8250 or improved versions of the National Semiconductor UART family. ==== National Semiconductor UART Family Tree @@ -815,7 +815,7 @@ Bit 0 -> Delta Clear To Send (DCTS). Set to "1" if the -CTS line has changed sta === Beyond the 16550A UART -Although National Semiconductor has not offered any components compatible with the 16550 that provide additional features, various other vendors have. +Although National Semiconductor has not offered any components compatible with the 16550 that provide additional features, various other vendors have. Some of these components are described below. It should be understood that to effectively utilize these improvements, drivers may have to be provided by the chip vendor since most of the popular operating systems do not support features beyond those provided by the 16550. @@ -839,7 +839,7 @@ This leaves the designer free to components that may have better performance cha [[sio]] == Configuring the [.filename]#sio# driver -The [.filename]#sio# driver provides support for NS8250-, NS16450-, NS16550 and NS16550A-based EIA RS-232C (CCITT V.24) communications interfaces. +The [.filename]#sio# driver provides support for NS8250-, NS16450-, NS16550 and NS16550A-based EIA RS-232C (CCITT V.24) communications interfaces. Several multiport cards are supported as well. See the man:sio[4] manual page for detailed technical documentation. @@ -878,12 +878,12 @@ One important note - the actual UART chips for the Boca 16 are in the connector So if you have it unplugged, probes of those ports will fail. I have never tested booting with the box unplugged and plugging it back in, and I suggest you do not either. -If you do not already have a custom kernel configuration file set up, refer to extref:{handbook}[Kernel Configuration, kernelconfig] chapter of the FreeBSD Handbook for general procedures. +If you do not already have a custom kernel configuration file set up, refer to extref:{handbook}kernelconfig[Kernel Configuration, kernelconfig] chapter of the FreeBSD Handbook for general procedures. The following are the specifics for the Boca 16 board and assume you are using the kernel name MYKERNEL and editing with vi. [.procedure] ==== -. Add the line +. Add the line + [.programlisting] .... @@ -905,7 +905,7 @@ device sio16 at isa? port 0x178 flags 0x1005 irq 3 + The flags entry _must_ be changed from this example unless you are using the exact same sio assignments. Flags are set according to 0x``__MYY__`` where _M_ indicates the minor number of the master port (the last port on a Boca 16) and _YY_ indicates if FIFO is enabled or disabled(enabled), IRQ sharing is used(yes) and if there is an AST/4 compatible IRQ control register(no). -In this example, +In this example, + [.programlisting] .... @@ -953,7 +953,7 @@ sio16 at 0x178-0x17f irq 3 flags 0x1005 on isa sio16: type 16550A (multiport master) .... + -If the messages go by too fast to see, +If the messages go by too fast to see, + [source,shell] .... @@ -976,7 +976,7 @@ If you do need to create the [.filename]#/dev# entries, run the following as `ro .... + If you do not want or need call-out devices for some reason, you can dispense with making the [.filename]#cua*# devices. -. If you want a quick and sloppy way to make sure the devices are working, you can simply plug a modem into each port and (as root) +. If you want a quick and sloppy way to make sure the devices are working, you can simply plug a modem into each port and (as root) + [source,shell] .... diff --git a/documentation/content/en/articles/serial-uart/_index.po b/documentation/content/en/articles/serial-uart/_index.po index 62713aaccd..a806ddaa05 100644 --- a/documentation/content/en/articles/serial-uart/_index.po +++ b/documentation/content/en/articles/serial-uart/_index.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2022-02-01 10:28-0300\n" +"POT-Creation-Date: 2025-11-08 16:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -280,8 +280,8 @@ msgstr "" #: documentation/content/en/articles/serial-uart/_index.adoc:134 msgid "" "In RS232-C, a value of `1` is called a `Mark` and a value of `0` is called a " -"`Space`. When a communication line is idle, the line is said to be \"Marking" -"\", or transmitting continuous `1` values." +"`Space`. When a communication line is idle, the line is said to be " +"\"Marking\", or transmitting continuous `1` values." msgstr "" #. type: Plain text @@ -1697,12 +1697,12 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/serial-uart/_index.adoc:563 msgid "" -"In internal modems, the modem designer will frequently emulate the " -"8250A/16450 with the modem microprocessor, and the emulated UART will " -"frequently have a hidden buffer consisting of several hundred bytes. Due to " -"the size of the buffer, these emulations can be as reliable as a 16550A in " -"their ability to handle high speed data. However, most operating systems " -"will still report that the UART is only a 8250A or 16450, and may not make " +"In internal modems, the modem designer will frequently emulate the 8250A/" +"16450 with the modem microprocessor, and the emulated UART will frequently " +"have a hidden buffer consisting of several hundred bytes. Due to the size " +"of the buffer, these emulations can be as reliable as a 16550A in their " +"ability to handle high speed data. However, most operating systems will " +"still report that the UART is only a 8250A or 16450, and may not make " "effective use of the extra buffering present in the emulated UART unless " "special drivers are used." msgstr "" @@ -1993,10 +1993,11 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/serial-uart/_index.adoc:665 msgid "" -"[.filename]#COM1# is located from 0x3f8 to 0x3ff and normally uses IRQ 4. [." -"filename]#COM2# is located from 0x2f8 to 0x2ff and normally uses IRQ 3. [." -"filename]#COM3# is located from 0x3e8 to 0x3ef and has no standardized IRQ. " -"[.filename]#COM4# is located from 0x2e8 to 0x2ef and has no standardized IRQ." +"[.filename]#COM1# is located from 0x3f8 to 0x3ff and normally uses IRQ 4. " +"[.filename]#COM2# is located from 0x2f8 to 0x2ff and normally uses IRQ 3. " +"[.filename]#COM3# is located from 0x3e8 to 0x3ef and has no standardized " +"IRQ. [.filename]#COM4# is located from 0x2e8 to 0x2ef and has no " +"standardized IRQ." msgstr "" #. type: Plain text @@ -2459,10 +2460,10 @@ msgstr "" #: documentation/content/en/articles/serial-uart/_index.adoc:883 msgid "" "If you do not already have a custom kernel configuration file set up, refer " -"to extref:{handbook}[Kernel Configuration, kernelconfig] chapter of the " -"FreeBSD Handbook for general procedures. The following are the specifics " -"for the Boca 16 board and assume you are using the kernel name MYKERNEL and " -"editing with vi." +"to extref:{handbook}kernelconfig[Kernel Configuration, kernelconfig] chapter " +"of the FreeBSD Handbook for general procedures. The following are the " +"specifics for the Boca 16 board and assume you are using the kernel name " +"MYKERNEL and editing with vi." msgstr "" #. type: delimited block = 4 @@ -2665,8 +2666,8 @@ msgstr "" #. type: delimited block = 4 #: documentation/content/en/articles/serial-uart/_index.adoc:991 msgid "" -"_Contributed by Helge Oldach_ mailto:hmo@sep.hamburg.com[hmo@sep.hamburg." -"com], September 1999" +"_Contributed by Helge Oldach_ " +"mailto:hmo@sep.hamburg.com[hmo@sep.hamburg.com], September 1999" msgstr "" #. type: delimited block = 4 @@ -2680,9 +2681,9 @@ msgstr "" #: documentation/content/en/articles/serial-uart/_index.adoc:997 msgid "" "Usually the only option to support these kind of boards is to use a distinct " -"IRQ for each port. For example, if your CPU board has an on-board [." -"filename]#COM1# port (aka [.filename]#sio0#-I/O address 0x3F8 and IRQ 4) and " -"you have an extension board with two UARTs, you will commonly need to " +"IRQ for each port. For example, if your CPU board has an on-board " +"[.filename]#COM1# port (aka [.filename]#sio0#-I/O address 0x3F8 and IRQ 4) " +"and you have an extension board with two UARTs, you will commonly need to " "configure them as [.filename]#COM2# (aka [.filename]#sio1#-I/O address 0x2F8 " "and IRQ 3), and the third port (aka [.filename]#sio2#) as I/O 0x3E8 and IRQ " "5. Obviously this is a waste of IRQ resources, as it should be basically " @@ -2734,9 +2735,9 @@ msgstr "" msgid "" "You need to decouple the IRQ drivers for the two UARTs, so that the IRQ line " "of the board only goes up if (and only if) one of the UARTs asserts a IRQ, " -"and stays low otherwise. The solution was proposed by Joerg Wunsch mailto:" -"j@ida.interface-business.de[j@ida.interface-business.de]: To solder up a " -"wired-or consisting of two diodes (Germanium or Schottky-types strongly " +"and stays low otherwise. The solution was proposed by Joerg Wunsch " +"mailto:j@ida.interface-business.de[j@ida.interface-business.de]: To solder " +"up a wired-or consisting of two diodes (Germanium or Schottky-types strongly " "preferred) and a 1 kOhm resistor. Here is the schematic, starting from the " "4 by 3 jumper field above:" msgstr "" @@ -3025,9 +3026,9 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/serial-uart/_index.adoc:1165 msgid "" -"After rebooting with the new kernel, you need to make the device nodes in [." -"filename]#/dev#. The [.filename]#MAKEDEV# script will take care of this for " -"you. Count how many total ports you have and type:" +"After rebooting with the new kernel, you need to make the device nodes in " +"[.filename]#/dev#. The [.filename]#MAKEDEV# script will take care of this " +"for you. Count how many total ports you have and type:" msgstr "" #. type: delimited block . 4 |