xref: /illumos-gate/usr/src/uts/common/io/bge/bge.conf (revision 628e3cbed6489fa1db545d8524a06cd6535af456)
1#
2# CDDL HEADER START
3#
4# The contents of this file are subject to the terms of the
5# Common Development and Distribution License (the "License").
6# You may not use this file except in compliance with the License.
7#
8# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9# or http://www.opensolaris.org/os/licensing.
10# See the License for the specific language governing permissions
11# and limitations under the License.
12#
13# When distributing Covered Code, include this CDDL HEADER in each
14# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15# If applicable, add the following below this CDDL HEADER, with the
16# fields enclosed by brackets "[]" replaced with your own identifying
17# information: Portions Copyright [yyyy] [name of copyright owner]
18#
19# CDDL HEADER END
20#
21#########################################################################
22#
23# Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
24# Use is subject to license terms.
25#
26#ident	"%Z%%M%	%I%	%E% SMI"
27#
28# Driver.conf file for the BGE driver, for
29# Broadcom 579x Gigabit Ethernet devices
30#
31# All the properties below can be set globally (i.e. for all instances
32# of BGE), or on a per-instance basis.  See driver.conf(4) for details
33# of the syntax of global and per-instance properties.
34#
35# Properties specified in this file take effect when the driver is first
36# loaded, typically just after system boot.  Changes to the file will
37# therefore not take effect until the next reboot, but will be permanent
38# thereafter.
39#
40# Some of the driver's parameters can also be changed using ndd(1m).
41# Changes made with ndd apply only to a specific instance (e.g. bge1).
42# They take effect immediately, but are lost if the driver is unloaded.
43#
44#########################################################################
45#
46# The autonegotiation feature can be controlled by the boolean properties
47# listed below.
48#
49# Firstly, 'adv_autoneg_cap' controls whether autonegotiation is enabled.
50#
51# If autonegotiation is turned OFF ("forced mode"), the remaining 'adv_*'
52# speed/duplex properties force selection of a specific mode, namely,
53# the first mode found to be enabled, in highest-to-lowest speed order
54# (thus, if adv_1000fdx_cap=1, all other values will be ignored; to force
55# 10/hdx mode, *all* the faster modes must be explicitly disabled).
56#
57# BEWARE - it's very easy to end up with a non-working link using forced
58# mode.  There's NO validation that the link partner actually supports
59# the mode that this device has been forced into.  In some cases, this
60# will prevent the link coming up; in others, the link status will show
61# 'up' (electrical connection made) but data transfer will not work at
62# all, or will work poorly (low throughput, high collision rates, etc).
63#
64# Note that many switches *require* autonegotiation in order to operate
65# at 1000Mbps or in full-duplex mode or with flow control.  In other words,
66# the only combinations that are likely to work with autonegotiation off
67# are 100Mbps/half-duplex and 10Mbps/half-duplex, unless the peer has also
68# been manually forced to some other (matching) combination.
69#
70# With autonegotiation ON (the default and preferred mode), the 'adv_*'
71# properties control which capabilities are advertised to the partner.
72# The default is to advertise all the capabilities that the hardware
73# supports; thus, the properties below serve only to limit the advertised
74# capabilities to restricted subset -- it is not possible to advertise a
75# capability that the hardware does not support.
76#
77# The autonegotiation process will then automagically select the fastest
78# speed/duplex mode and greatest degree of flow control supported by both
79# partners.
80#
81# If the local device is set to autonegotiate, but the link partner can't
82# or doesn't autonegotiate, the correct speed will be determined anyway,
83# and HALF-DUPLEX mode will be selected, as mandated by the IEEE802.3
84# standard.  This will yield the correct result if the partner is in fact
85# incapable of autonegotiating: it must be a half-duplex device, because
86# the only devices that don't support autonegotation are half-duplex (the
87# standard says that all full-duplex-capable devices must also support
88# autonegotiation).
89#
90# However, this choice will NOT be correct if the peer is actually capable
91# of autonegotiation and full-duplex operation, and has been manually set
92# to "forced full-duplex without autonegotiation" (a mode not recommended
93# by the IEEE standard).  The link will appear to work, but the duplex
94# mismatch will result in packet loss and spurious "late collisions".  In
95# such cases, the preferred solution is to enable autonegotiation by the
96# peer.  Failing that, autonegotiation by the BGE device can be disabled,
97# and forced mode used to match the peer's forced settings as above.
98#
99# adv_autoneg_cap	= 1;
100# adv_1000fdx_cap	= 1;
101# adv_1000hdx_cap	= 1;
102# adv_100T4_cap		= 0;
103# adv_100fdx_cap	= 1;
104# adv_100hdx_cap	= 1;
105# adv_10fdx_cap		= 1;
106# adv_10hdx_cap		= 1;
107# adv_asym_pause_cap	= 0;
108# adv_pause_cap		= 0;
109#
110# All of these parameters can can also be queried and modified at run-time
111# by use of the ndd(1m) command.
112#
113#########################################################################
114#
115# OBP's device driver exports methods to set the link speed explicity,
116# which then pass the information to the Solaris driver through the
117# 'transfer-speed' property.  It therefore SHOULDN'T be set here, but
118# is documented for completeness.  If the 'transfer-speed' property is
119# set to 10, 100, or 1000, the link will be set to the selected speed,
120# and autonegotiation ENABLED but restricted to the specified speed.
121# The correct duplex setting will be determined by autonegotiation.
122#
123# This property, if set, overrides and alters the settings of the adv_*
124# parameters corresponding to the properties above.
125#
126# transfer-speed	= 1000;
127#
128#########################################################################
129#
130# As a third alternative, the following two properties can be set to
131# force the link speed/duplex setting instead.  Doing so will override
132# and alter the settings of the adv_* parameters corresponding to the
133# properties above, and take precedence over all other means of setting
134# the speed/duplex at boot time.
135#
136# Autonegotiation will be DISABLED if EITHER of these properties is set,
137# therefore BOTH properties should be set explicity if either one is.
138# 'speed' may be set to 10, 100 or 1000, while 'full-duplex' may be 0 or 1.
139#
140# See the warning above about the potential for misconfiguration when
141# autonegotiation is disabled.  Defining these properties could leave your
142# system configured so that the network will not work at all after reboot,
143# requiring manual intervention and further reboots to recover!
144#
145# speed			= 100;
146# full-duplex		= 0;
147#
148#########################################################################
149#
150# The property below represents the list of subsystem vendor/device pairs
151# with which driver operation is supported.  This list will be updated and
152# extended as new subsystems are validated ...
153#
154bge-known-subsystems	= 0x108e1647,
155			  0x108e1648,
156			  0x108e16a7,
157			  0x108e16a8,
158			  0x17c20010,
159			  0x17341013,
160			  0x101402a6,
161			  0x10f12885,
162			  0x17c20020,
163			  0x10b71006,
164			  0x10280109,
165			  0x1028865d,
166			  0x0e11005a,
167			  0x0e1100cb,
168			  0x103c12bc;
169#########################################################################
170#
171# The properties below represents the number of receive and send ring used.
172# For BCM5705, BCM5782, etc, there are only 1 receive ring and 1 send ring.
173# Otherwise, there can be up to 16 receive rings and 4 send rings.
174#
175bge-rx-rings		= 1;
176bge-tx-rings		= 1;
177
178