utopia.4 (130857) | utopia.4 (131530) |
---|---|
1.\" Copyright (c) 2003 2.\" Fraunhofer Institute for Open Communication Systems (FhG Fokus). 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright --- 11 unchanged lines hidden (view full) --- 20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24.\" SUCH DAMAGE. 25.\" 26.\" Author: Hartmut Brandt <harti@freebsd.org> 27.\" | 1.\" Copyright (c) 2003 2.\" Fraunhofer Institute for Open Communication Systems (FhG Fokus). 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright --- 11 unchanged lines hidden (view full) --- 20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24.\" SUCH DAMAGE. 25.\" 26.\" Author: Hartmut Brandt <harti@freebsd.org> 27.\" |
28.\" $FreeBSD: head/share/man/man4/utopia.4 130857 2004-06-21 17:42:49Z mpp $ | 28.\" $FreeBSD: head/share/man/man4/utopia.4 131530 2004-07-03 18:29:24Z ru $ |
29.Dd May 8, 2003 30.Dt UTOPIA 4 31.Os FreeBSD 32.Sh NAME 33.Nm utopia 34.Nd Driver module for ATM PHY chips 35.Sh SYNOPSIS 36.Cd device utopia --- 23 unchanged lines hidden (view full) --- 60.It Cm phy_loopback 61allows to put the interface in one of several loopback modes. 62Not all modes and all combinations of modes are supported on all chips. 63The possible modes are: 64.Bl -tag -width XXX 65.It Dv UTP_LOOP_NONE (0x00) 66No loopback, normal operation. 67.It Dv UTP_LOOP_TIME (0x01) | 29.Dd May 8, 2003 30.Dt UTOPIA 4 31.Os FreeBSD 32.Sh NAME 33.Nm utopia 34.Nd Driver module for ATM PHY chips 35.Sh SYNOPSIS 36.Cd device utopia --- 23 unchanged lines hidden (view full) --- 60.It Cm phy_loopback 61allows to put the interface in one of several loopback modes. 62Not all modes and all combinations of modes are supported on all chips. 63The possible modes are: 64.Bl -tag -width XXX 65.It Dv UTP_LOOP_NONE (0x00) 66No loopback, normal operation. 67.It Dv UTP_LOOP_TIME (0x01) |
68Timing source loopback. When this is set the transmitter's clock is | 68Timing source loopback. 69When this is set the transmitter's clock is |
69derived from the receiver's clock. 70.It Dv UTP_LOOP_DIAG (0x02) | 70derived from the receiver's clock. 71.It Dv UTP_LOOP_DIAG (0x02) |
71Diagnostic loopback. In this mode the receiver's input is connected to the 72transmitter's output. The receiver gets back everything that is sent. The | 72Diagnostic loopback. 73In this mode the receiver's input is connected to the 74transmitter's output. 75The receiver gets back everything that is sent. 76The |
73transmitter operates normally. 74.It Dv UTP_LOOP_LINE (0x04) | 77transmitter operates normally. 78.It Dv UTP_LOOP_LINE (0x04) |
75Serial line loopback. This connects the line receiver to the line transmitter. 76The chip transmits all cells back that it receives. The receiver operates | 79Serial line loopback. 80This connects the line receiver to the line transmitter. 81The chip transmits all cells back that it receives. 82The receiver operates |
77normally. 78.It Dv UTP_LOOP_PARAL (0x08) | 83normally. 84.It Dv UTP_LOOP_PARAL (0x08) |
79Parallel diagnostic loopback. This feeds back all transmitted cells into the 80receiver between the parallel/serial converters. The transmitter | 85Parallel diagnostic loopback. 86This feeds back all transmitted cells into the 87receiver between the parallel/serial converters. 88The transmitter |
81operates normally. 82.It Dv UTP_LOOP_TWIST (0x10) | 89operates normally. 90.It Dv UTP_LOOP_TWIST (0x10) |
83Twisted pair diagnostic loopback. Connects the high speed receive data to the 84high speed transmit data. All received data is sent back. The receiver | 91Twisted pair diagnostic loopback. 92Connects the high speed receive data to the 93high speed transmit data. 94All received data is sent back. 95The receiver |
85operates normally. 86.It Dv UTP_LOOP_PATH (0x20) | 96operates normally. 97.It Dv UTP_LOOP_PATH (0x20) |
87Diagnostic path loopback. This connects the receiver input to the transmitter 88output just between the path overhead processor and the byte mux. The | 98Diagnostic path loopback. 99This connects the receiver input to the transmitter 100output just between the path overhead processor and the byte mux. 101The |
89transmitter operates normally. 90.El 91.It Cm phy_type | 102transmitter operates normally. 103.El 104.It Cm phy_type |
92This is the detected type of the phy chip. Currently the following chips are | 105This is the detected type of the phy chip. 106Currently the following chips are |
93supported: 94.Bl -tag -width XXX 95.It Dv UTP_TYPE_UNKNOWN (0) 96The module could not determine the type of the PHY chip. 97.It Dv UTP_TYPE_SUNI_LITE (1) 98PMC-5346 (S/Uni-Lite) 99.It Dv UTP_TYPE_SUNI_ULTRA (2) 100PMC-5350 (S/Uni-Ultra) 101.It Dv UTP_TYPE_SUNI_622 (3) 102PMC-5355 (S/Uni-622) 103.It Dv UTP_TYPE_IDT77105 (4) 104IDT77105 (25.6MBit UTP interface) 105.It Dv UTP_TYPE_IDT77155 (5) 106IDT77155 (155MBit interface) 107.El 108.It Cm phy_name 109This is a string describing the type of the PHY chip. 110.It Cm phy_stats | 107supported: 108.Bl -tag -width XXX 109.It Dv UTP_TYPE_UNKNOWN (0) 110The module could not determine the type of the PHY chip. 111.It Dv UTP_TYPE_SUNI_LITE (1) 112PMC-5346 (S/Uni-Lite) 113.It Dv UTP_TYPE_SUNI_ULTRA (2) 114PMC-5350 (S/Uni-Ultra) 115.It Dv UTP_TYPE_SUNI_622 (3) 116PMC-5355 (S/Uni-622) 117.It Dv UTP_TYPE_IDT77105 (4) 118IDT77105 (25.6MBit UTP interface) 119.It Dv UTP_TYPE_IDT77155 (5) 120IDT77155 (155MBit interface) 121.El 122.It Cm phy_name 123This is a string describing the type of the PHY chip. 124.It Cm phy_stats |
111Physical and some ATM layer statistics. These are the statistics usually 112provided by the chip. The data is a returned in the following structure: | 125Physical and some ATM layer statistics. 126These are the statistics usually 127provided by the chip. 128The data is a returned in the following structure: |
113.Bd -literal 114struct utopia_stats1 { 115 uint32_t version; /* version of this struct */ 116 uint32_t fill; 117 uint64_t rx_sbip; /* rx section BIP errors */ 118 uint64_t rx_lbip; /* rx line BIP errors */ 119 uint64_t rx_lfebe; /* rx line far end block errors */ 120 uint64_t rx_pbip; /* rx path BIP errors */ 121 uint64_t rx_pfebe; /* rx path far end block errors */ 122 uint64_t rx_cells; /* received cells */ 123 uint64_t rx_corr; /* correctable cell errors */ 124 uint64_t rx_uncorr; /* uncorrectable cell errors */ 125 uint64_t rx_symerr; /* symbol errors */ 126 uint64_t tx_cells; /* transmitted cells */ 127}; 128.Ed 129.Pp | 129.Bd -literal 130struct utopia_stats1 { 131 uint32_t version; /* version of this struct */ 132 uint32_t fill; 133 uint64_t rx_sbip; /* rx section BIP errors */ 134 uint64_t rx_lbip; /* rx line BIP errors */ 135 uint64_t rx_lfebe; /* rx line far end block errors */ 136 uint64_t rx_pbip; /* rx path BIP errors */ 137 uint64_t rx_pfebe; /* rx path far end block errors */ 138 uint64_t rx_cells; /* received cells */ 139 uint64_t rx_corr; /* correctable cell errors */ 140 uint64_t rx_uncorr; /* uncorrectable cell errors */ 141 uint64_t rx_symerr; /* symbol errors */ 142 uint64_t tx_cells; /* transmitted cells */ 143}; 144.Ed 145.Pp |
130The current version is 1. The statistics are updated from the chip once 131a second. On overflow the counters wrap to zero. Note that not all counters 132are meaningful for all PHY chips. The statistics are cleared by writing an | 146The current version is 1. 147The statistics are updated from the chip once 148a second. 149On overflow the counters wrap to zero. 150Note that not all counters 151are meaningful for all PHY chips. 152The statistics are cleared by writing an |
133arbitrary new value (the value is ignored). 134.El 135.Pp 136The 137.Nm 138module also interfaces with the ifmedia system. 139The module reports the current state of the carrier and will issue a 140warning message when the carrier state changes. 141While the physical media itself cannot be changed, several media options can: 142.Bl -tag -width XXX 143.It Cm SDH 144If the PHY is a Sonet/SDH chip this flag switches the interface into SDH mode. 145If this option is not set (the default) the interface is in Sonet mode. 146.It Cm noscramb 147If the PHY is a Sonet/SDH chip disable scrambling. 148This may be useful for debugging purposes. 149.It Cm unassigned 150Normally the interface emits idle cells when there are no other cells to | 153arbitrary new value (the value is ignored). 154.El 155.Pp 156The 157.Nm 158module also interfaces with the ifmedia system. 159The module reports the current state of the carrier and will issue a 160warning message when the carrier state changes. 161While the physical media itself cannot be changed, several media options can: 162.Bl -tag -width XXX 163.It Cm SDH 164If the PHY is a Sonet/SDH chip this flag switches the interface into SDH mode. 165If this option is not set (the default) the interface is in Sonet mode. 166.It Cm noscramb 167If the PHY is a Sonet/SDH chip disable scrambling. 168This may be useful for debugging purposes. 169.It Cm unassigned 170Normally the interface emits idle cells when there are no other cells to |
151transmit. This changes the default cell type to unassigned cells. This | 171transmit. 172This changes the default cell type to unassigned cells. 173This |
152may be needed for interworking with public networks. 153.El 154.Sh SEE ALSO 155.Xr en 4 , 156.Xr fatm 4 , 157.Xr hatm 4 , 158.Xr patm 4 , 159.Xr utopia 9 160.Sh AUTHOR 161.An Harti Brandt Aq harti@freebsd.org . | 174may be needed for interworking with public networks. 175.El 176.Sh SEE ALSO 177.Xr en 4 , 178.Xr fatm 4 , 179.Xr hatm 4 , 180.Xr patm 4 , 181.Xr utopia 9 182.Sh AUTHOR 183.An Harti Brandt Aq harti@freebsd.org . |