mirrors
/
linux-stable
mirror of https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
1
0
Fork 0
Code Issues Releases Wiki Activity

Documentation: Reformat Oxford Semiconductor PCIe (Tornado) 950 

Reformat Oxford Semiconductor PCIe (Tornado) 950 description in terms of
reStructuredText markup, fixing warnings with `make htmldocs'.  While at
it remove typos: s/the the/the/ and s/the/then/ in lines changed anyway.

Signed-off-by: Maciej W. Rozycki <macro@orcam.me.uk>
Link: https://lore.kernel.org/r/alpine.DEB.2.21.2205131721110.10656@angie.orcam.me.uk
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
This commit is contained in:
Maciej W. Rozycki 2022-05-13 23:42:08 +01:00 committed by Greg Kroah-Hartman
parent 7b0364eacb
commit 421bdf5385
1 changed files with 72 additions and 70 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

126
Documentation/misc-devices/oxsemi-tornado.rst
View File

@ -24,15 +24,15 @@ used for the divisor to obtain the requested baud rates by software that
is unaware of the extra clock controls available. is unaware of the extra clock controls available.
The oversampling rate is programmed with the TCR register and the clock The oversampling rate is programmed with the TCR register and the clock
prescaler is programmed with the CPR/CPR2 register pair[1][2][3][4]. prescaler is programmed with the CPR/CPR2 register pair [OX200]_ [OX952]_
To switch away from the default value of 33.875 for the prescaler the [OX954]_ [OX958]_. To switch away from the default value of 33.875 for
the enhanced mode has to be explicitly enabled though, by setting bit 4 the prescaler the enhanced mode has to be explicitly enabled though, by
of the EFR. In that mode setting bit 7 in the MCR enables the prescaler setting bit 4 of the EFR. In that mode setting bit 7 in the MCR enables
or otherwise it is bypassed as if the value of 1 was used. Additionally the prescaler or otherwise it is bypassed as if the value of 1 was used.
writing any value to CPR clears CPR2 for compatibility with old software Additionally writing any value to CPR clears CPR2 for compatibility with
written for older conventional PCI Oxford Semiconductor devices that do old software written for older conventional PCI Oxford Semiconductor
not have the extra prescaler's 9th bit in CPR2, so the CPR/CPR2 register devices that do not have the extra prescaler's 9th bit in CPR2, so the
pair has to be programmed in the right order. CPR/CPR2 register pair has to be programmed in the right order.
By using these parameters rates from 15625000bps down to 1bps can be By using these parameters rates from 15625000bps down to 1bps can be
obtained, with either exact or highly-accurate actual bit rates for obtained, with either exact or highly-accurate actual bit rates for
@ -43,48 +43,50 @@ Here are the figures for the standard and some non-standard baud rates
the requested rate (r), the actual rate yielded (a) and its deviation the requested rate (r), the actual rate yielded (a) and its deviation
from the requested rate (d), and the values of the oversampling rate from the requested rate (d), and the values of the oversampling rate
(tcr), the clock prescaler (cpr) and the divisor (div) produced by the (tcr), the clock prescaler (cpr) and the divisor (div) produced by the
new `get_divisor' handler: new ``get_divisor`` handler:
r: 15625000, a: 15625000.00, d: 0.0000%, tcr: 4, cpr: 1.000, div: 1 ::
r: 12500000, a: 12500000.00, d: 0.0000%, tcr: 5, cpr: 1.000, div: 1
r: 10416666, a: 10416666.67, d: 0.0000%, tcr: 6, cpr: 1.000, div: 1 r: 15625000, a: 15625000.00, d: 0.0000%, tcr: 4, cpr: 1.000, div: 1
r: 8928571, a: 8928571.43, d: 0.0000%, tcr: 7, cpr: 1.000, div: 1 r: 12500000, a: 12500000.00, d: 0.0000%, tcr: 5, cpr: 1.000, div: 1
r: 7812500, a: 7812500.00, d: 0.0000%, tcr: 8, cpr: 1.000, div: 1 r: 10416666, a: 10416666.67, d: 0.0000%, tcr: 6, cpr: 1.000, div: 1
r: 4000000, a: 4000000.00, d: 0.0000%, tcr: 5, cpr: 3.125, div: 1 r: 8928571, a: 8928571.43, d: 0.0000%, tcr: 7, cpr: 1.000, div: 1
r: 3686400, a: 3676470.59, d: -0.2694%, tcr: 8, cpr: 2.125, div: 1 r: 7812500, a: 7812500.00, d: 0.0000%, tcr: 8, cpr: 1.000, div: 1
r: 3500000, a: 3496503.50, d: -0.0999%, tcr: 13, cpr: 1.375, div: 1 r: 4000000, a: 4000000.00, d: 0.0000%, tcr: 5, cpr: 3.125, div: 1
r: 3000000, a: 2976190.48, d: -0.7937%, tcr: 14, cpr: 1.500, div: 1 r: 3686400, a: 3676470.59, d: -0.2694%, tcr: 8, cpr: 2.125, div: 1
r: 2500000, a: 2500000.00, d: 0.0000%, tcr: 10, cpr: 2.500, div: 1 r: 3500000, a: 3496503.50, d: -0.0999%, tcr: 13, cpr: 1.375, div: 1
r: 2000000, a: 2000000.00, d: 0.0000%, tcr: 10, cpr: 3.125, div: 1 r: 3000000, a: 2976190.48, d: -0.7937%, tcr: 14, cpr: 1.500, div: 1
r: 1843200, a: 1838235.29, d: -0.2694%, tcr: 16, cpr: 2.125, div: 1 r: 2500000, a: 2500000.00, d: 0.0000%, tcr: 10, cpr: 2.500, div: 1
r: 1500000, a: 1492537.31, d: -0.4975%, tcr: 5, cpr: 8.375, div: 1 r: 2000000, a: 2000000.00, d: 0.0000%, tcr: 10, cpr: 3.125, div: 1
r: 1152000, a: 1152073.73, d: 0.0064%, tcr: 14, cpr: 3.875, div: 1 r: 1843200, a: 1838235.29, d: -0.2694%, tcr: 16, cpr: 2.125, div: 1
r: 921600, a: 919117.65, d: -0.2694%, tcr: 16, cpr: 2.125, div: 2 r: 1500000, a: 1492537.31, d: -0.4975%, tcr: 5, cpr: 8.375, div: 1
r: 576000, a: 576036.87, d: 0.0064%, tcr: 14, cpr: 3.875, div: 2 r: 1152000, a: 1152073.73, d: 0.0064%, tcr: 14, cpr: 3.875, div: 1
r: 460800, a: 460829.49, d: 0.0064%, tcr: 7, cpr: 3.875, div: 5 r: 921600, a: 919117.65, d: -0.2694%, tcr: 16, cpr: 2.125, div: 2
r: 230400, a: 230414.75, d: 0.0064%, tcr: 14, cpr: 3.875, div: 5 r: 576000, a: 576036.87, d: 0.0064%, tcr: 14, cpr: 3.875, div: 2
r: 115200, a: 115207.37, d: 0.0064%, tcr: 14, cpr: 1.250, div: 31 r: 460800, a: 460829.49, d: 0.0064%, tcr: 7, cpr: 3.875, div: 5
r: 57600, a: 57603.69, d: 0.0064%, tcr: 8, cpr: 3.875, div: 35 r: 230400, a: 230414.75, d: 0.0064%, tcr: 14, cpr: 3.875, div: 5
r: 38400, a: 38402.46, d: 0.0064%, tcr: 14, cpr: 3.875, div: 30 r: 115200, a: 115207.37, d: 0.0064%, tcr: 14, cpr: 1.250, div: 31
r: 19200, a: 19201.23, d: 0.0064%, tcr: 8, cpr: 3.875, div: 105 r: 57600, a: 57603.69, d: 0.0064%, tcr: 8, cpr: 3.875, div: 35
r: 9600, a: 9600.06, d: 0.0006%, tcr: 9, cpr: 1.125, div: 643 r: 38400, a: 38402.46, d: 0.0064%, tcr: 14, cpr: 3.875, div: 30
r: 4800, a: 4799.98, d: -0.0004%, tcr: 7, cpr: 2.875, div: 647 r: 19200, a: 19201.23, d: 0.0064%, tcr: 8, cpr: 3.875, div: 105
r: 2400, a: 2400.02, d: 0.0008%, tcr: 9, cpr: 2.250, div: 1286 r: 9600, a: 9600.06, d: 0.0006%, tcr: 9, cpr: 1.125, div: 643
r: 1200, a: 1200.00, d: 0.0000%, tcr: 14, cpr: 2.875, div: 1294 r: 4800, a: 4799.98, d: -0.0004%, tcr: 7, cpr: 2.875, div: 647
r: 300, a: 300.00, d: 0.0000%, tcr: 11, cpr: 2.625, div: 7215 r: 2400, a: 2400.02, d: 0.0008%, tcr: 9, cpr: 2.250, div: 1286
r: 200, a: 200.00, d: 0.0000%, tcr: 16, cpr: 1.250, div: 15625 r: 1200, a: 1200.00, d: 0.0000%, tcr: 14, cpr: 2.875, div: 1294
r: 150, a: 150.00, d: 0.0000%, tcr: 13, cpr: 2.250, div: 14245 r: 300, a: 300.00, d: 0.0000%, tcr: 11, cpr: 2.625, div: 7215
r: 134, a: 134.00, d: 0.0000%, tcr: 11, cpr: 2.625, div: 16153 r: 200, a: 200.00, d: 0.0000%, tcr: 16, cpr: 1.250, div: 15625
r: 110, a: 110.00, d: 0.0000%, tcr: 12, cpr: 1.000, div: 47348 r: 150, a: 150.00, d: 0.0000%, tcr: 13, cpr: 2.250, div: 14245
r: 75, a: 75.00, d: 0.0000%, tcr: 4, cpr: 5.875, div: 35461 r: 134, a: 134.00, d: 0.0000%, tcr: 11, cpr: 2.625, div: 16153
r: 50, a: 50.00, d: 0.0000%, tcr: 16, cpr: 1.250, div: 62500 r: 110, a: 110.00, d: 0.0000%, tcr: 12, cpr: 1.000, div: 47348
r: 25, a: 25.00, d: 0.0000%, tcr: 16, cpr: 2.500, div: 62500 r: 75, a: 75.00, d: 0.0000%, tcr: 4, cpr: 5.875, div: 35461
r: 4, a: 4.00, d: 0.0000%, tcr: 16, cpr: 20.000, div: 48828 r: 50, a: 50.00, d: 0.0000%, tcr: 16, cpr: 1.250, div: 62500
r: 2, a: 2.00, d: 0.0000%, tcr: 16, cpr: 40.000, div: 48828 r: 25, a: 25.00, d: 0.0000%, tcr: 16, cpr: 2.500, div: 62500
r: 1, a: 1.00, d: 0.0000%, tcr: 16, cpr: 63.875, div: 61154 r: 4, a: 4.00, d: 0.0000%, tcr: 16, cpr: 20.000, div: 48828
r: 2, a: 2.00, d: 0.0000%, tcr: 16, cpr: 40.000, div: 48828
r: 1, a: 1.00, d: 0.0000%, tcr: 16, cpr: 63.875, div: 61154
With the baud base set to 15625000 and the unsigned 16-bit UART_DIV_MAX With the baud base set to 15625000 and the unsigned 16-bit UART_DIV_MAX
limitation imposed by `serial8250_get_baud_rate' standard baud rates limitation imposed by ``serial8250_get_baud_rate`` standard baud rates
below 300bps become unavailable in the regular way, e.g. the rate of below 300bps become unavailable in the regular way, e.g. the rate of
200bps requires the baud base to be divided by 78125 and that is beyond 200bps requires the baud base to be divided by 78125 and that is beyond
the unsigned 16-bit range. The historic spd_cust feature can still be the unsigned 16-bit range. The historic spd_cust feature can still be
@ -92,15 +94,17 @@ used by encoding the values for, the prescaler, the oversampling rate
and the clock divisor (DLM/DLL) as follows to obtain such rates if so and the clock divisor (DLM/DLL) as follows to obtain such rates if so
required: required:
31 29 28 20 19 16 15 0 ::
+-----+-----------------+-------+-------------------------------+
|0 0 0| CPR2:CPR | TCR | DLM:DLL |
+-----+-----------------+-------+-------------------------------+
Use a value such encoded for the `custom_divisor' field along with the 31 29 28 20 19 16 15 0
ASYNC_SPD_CUST flag set in the `flags' field in `struct serial_struct' +-----+-----------------+-------+-------------------------------+
|0 0 0| CPR2:CPR | TCR | DLM:DLL |
+-----+-----------------+-------+-------------------------------+
Use a value such encoded for the ``custom_divisor`` field along with the
ASYNC_SPD_CUST flag set in the ``flags`` field in ``struct serial_struct``
passed with the TIOCSSERIAL ioctl(2), such as with the setserial(8) passed with the TIOCSSERIAL ioctl(2), such as with the setserial(8)
utility and its `divisor' and `spd_cust' parameters, and the select utility and its ``divisor`` and ``spd_cust`` parameters, and then select
the baud rate of 38400bps. Note that the value of 0 in TCR sets the the baud rate of 38400bps. Note that the value of 0 in TCR sets the
oversampling rate to 16 and prescaler values below 1 in CPR2/CPR are oversampling rate to 16 and prescaler values below 1 in CPR2/CPR are
clamped by the driver to 1. clamped by the driver to 1.
@ -111,19 +115,17 @@ the oversampling rate and the clock divisor of 62.500, 16 and 1250
respectively. These parameters will set the baud rate for the serial respectively. These parameters will set the baud rate for the serial
port to 62500000 / 62.500 / 1250 / 16 = 50bps. port to 62500000 / 62.500 / 1250 / 16 = 50bps.
References: Maciej W. Rozycki <macro@orcam.me.uk>
[1] "OXPCIe200 PCI Express Multi-Port Bridge", Oxford Semiconductor, .. [OX200] "OXPCIe200 PCI Express Multi-Port Bridge", Oxford Semiconductor,
Inc., DS-0045, 10 Nov 2008, Section "950 Mode", pp. 64-65 Inc., DS-0045, 10 Nov 2008, Section "950 Mode", pp. 64-65
[2] "OXPCIe952 PCI Express Bridge to Dual Serial & Parallel Port", .. [OX952] "OXPCIe952 PCI Express Bridge to Dual Serial & Parallel Port",
Oxford Semiconductor, Inc., DS-0046, Mar 06 08, Section "950 Mode", Oxford Semiconductor, Inc., DS-0046, Mar 06 08, Section "950 Mode",
p. 20 p. 20
[3] "OXPCIe954 PCI Express Bridge to Quad Serial Port", Oxford .. [OX954] "OXPCIe954 PCI Express Bridge to Quad Serial Port", Oxford
Semiconductor, Inc., DS-0047, Feb 08, Section "950 Mode", p. 20 Semiconductor, Inc., DS-0047, Feb 08, Section "950 Mode", p. 20
[4] "OXPCIe958 PCI Express Bridge to Octal Serial Port", Oxford .. [OX958] "OXPCIe958 PCI Express Bridge to Octal Serial Port", Oxford
Semiconductor, Inc., DS-0048, Feb 08, Section "950 Mode", p. 20 Semiconductor, Inc., DS-0048, Feb 08, Section "950 Mode", p. 20
Maciej W. Rozycki <macro@orcam.me.uk>