<!DOCTYPE html>
<html lang="en" data-content_root="../../">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Broadcom RoboSwitch Ethernet switch driver — The Linux Kernel documentation</title>
<link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=fa44fd50" />
<link rel="stylesheet" type="text/css" href="../../_static/alabaster.css?v=3918102e" />
<script src="../../_static/documentation_options.js?v=5929fcd5"></script>
<script src="../../_static/doctools.js?v=9bcbadda"></script>
<script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
<link rel="index" title="Index" href="../../genindex.html" />
<link rel="search" title="Search" href="../../search.html" />
<link rel="next" title="Broadcom Starfighter 2 Ethernet switch driver" href="bcm_sf2.html" />
<link rel="prev" title="Architecture" href="dsa.html" />
<link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
</head><body>
<div class="document">
<div class="sphinxsidebar" role="navigation" aria-label="Main">
<div class="sphinxsidebarwrapper">
<p class="logo"><a href="../../index.html">
<img class="logo" src="../../_static/logo.svg" alt="Logo of The Linux Kernel"/>
</a></p>
<h1 class="logo"><a href="../../index.html">The Linux Kernel</a></h1>
<p class="blurb">6.18.50</p>
<search id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="../../search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
<input type="submit" value="Go" />
</form>
</div>
</search>
<script>document.getElementById('searchbox').style.display = "block"</script>
<p>
<h3 class="kernel-toc-contents">Contents</h3>
<input type="checkbox" class="kernel-toc-toggle" id = "kernel-toc-toggle" checked>
<label class="kernel-toc-title" for="kernel-toc-toggle"></label>
<div class="kerneltoc" id="kerneltoc">
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../process/development-process.html">Development process</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../process/submitting-patches.html">Submitting patches</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../process/code-of-conduct.html">Code of conduct</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../maintainer/index.html">Maintainer handbook</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../process/index.html">All development-process docs</a></li>
</ul>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../../core-api/index.html">Core API</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../driver-api/index.html">Driver APIs</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="../../subsystem-apis.html">Subsystems</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="../../subsystem-apis.html#core-subsystems">Core subsystems</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../subsystem-apis.html#human-interfaces">Human interfaces</a></li>
<li class="toctree-l2 current"><a class="reference internal" href="../../subsystem-apis.html#networking-interfaces">Networking interfaces</a><ul class="current">
<li class="toctree-l3 current"><a class="reference internal" href="../index.html">Networking</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../netlabel/index.html">NetLabel</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../infiniband/index.html">InfiniBand</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../isdn/index.html">ISDN</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../mhi/index.html">MHI</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../subsystem-apis.html#storage-interfaces">Storage interfaces</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../subsystem-apis.html#other-subsystems">Other subsystems</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../locking/index.html">Locking</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../process/license-rules.html">Licensing rules</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../doc-guide/index.html">Writing documentation</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../dev-tools/index.html">Development tools</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../dev-tools/testing-overview.html">Testing guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../kernel-hacking/index.html">Hacking guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../trace/index.html">Tracing</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../fault-injection/index.html">Fault injection</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../livepatch/index.html">Livepatching</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../rust/index.html">Rust</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../admin-guide/index.html">Administration</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../kbuild/index.html">Build system</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../admin-guide/reporting-issues.html">Reporting issues</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../tools/index.html">Userspace tools</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../userspace-api/index.html">Userspace API</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../firmware-guide/index.html">Firmware</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../devicetree/index.html">Firmware and Devicetree</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../arch/index.html">CPU architectures</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../staging/index.html">Unsorted documentation</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../translations/index.html">Translations</a></li>
</ul>
</div>
<script type="text/javascript"> <!--
var sbar = document.getElementsByClassName("sphinxsidebar")[0];
let currents = document.getElementsByClassName("current")
if (currents.length) {
sbar.scrollTop = currents[currents.length - 1].offsetTop;
}
--> </script>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../../_sources/networking/dsa/b53.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
</div>
</div>
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<section id="broadcom-roboswitch-ethernet-switch-driver">
<h1>Broadcom RoboSwitch Ethernet switch driver<a class="headerlink" href="#broadcom-roboswitch-ethernet-switch-driver" title="Link to this heading">¶</a></h1>
<p>The Broadcom RoboSwitch Ethernet switch family is used in quite a range of
xDSL router, cable modems and other multimedia devices.</p>
<p>The actual implementation supports the devices BCM5325E, BCM5365, BCM539x,
BCM53115 and BCM53125 as well as BCM63XX.</p>
<section id="implementation-details">
<h2>Implementation details<a class="headerlink" href="#implementation-details" title="Link to this heading">¶</a></h2>
<p>The driver is located in <code class="docutils literal notranslate"><span class="pre">drivers/net/dsa/b53/</span></code> and is implemented as a
DSA driver; see <code class="docutils literal notranslate"><span class="pre">Documentation/networking/dsa/dsa.rst</span></code> for details on the
subsystem and what it provides.</p>
<p>The switch is, if possible, configured to enable a Broadcom specific 4-bytes
switch tag which gets inserted by the switch for every packet forwarded to the
CPU interface, conversely, the CPU network interface should insert a similar
tag for packets entering the CPU port. The tag format is described in
<code class="docutils literal notranslate"><span class="pre">net/dsa/tag_brcm.c</span></code>.</p>
<p>The configuration of the device depends on whether or not tagging is
supported.</p>
<p>The interface names and example network configuration are used according the
configuration described in the <a class="reference internal" href="configuration.html#dsa-config-showcases"><span class="std std-ref">Configuration showcases</span></a>.</p>
<section id="configuration-with-tagging-support">
<h3>Configuration with tagging support<a class="headerlink" href="#configuration-with-tagging-support" title="Link to this heading">¶</a></h3>
<p>The tagging based configuration is desired. It is not specific to the b53
DSA driver and will work like all DSA drivers which supports tagging.</p>
<p>See <a class="reference internal" href="configuration.html#dsa-tagged-configuration"><span class="std std-ref">Configuration with tagging support</span></a>.</p>
</section>
<section id="configuration-without-tagging-support">
<h3>Configuration without tagging support<a class="headerlink" href="#configuration-without-tagging-support" title="Link to this heading">¶</a></h3>
<p>Older models (5325, 5365) support a different tag format that is not supported
yet. 539x and 531x5 require managed mode and some special handling, which is
also not yet supported. The tagging support is disabled in these cases and the
switch need a different configuration.</p>
<p>The configuration slightly differ from the <a class="reference internal" href="configuration.html#dsa-vlan-configuration"><span class="std std-ref">Configuration without tagging support</span></a>.</p>
<p>The b53 tags the CPU port in all VLANs, since otherwise any PVID untagged
VLAN programming would basically change the CPU port’s default PVID and make
it untagged, undesirable.</p>
<p>In difference to the configuration described in <a class="reference internal" href="configuration.html#dsa-vlan-configuration"><span class="std std-ref">Configuration without tagging support</span></a>
the default VLAN 1 has to be removed from the user interface configuration in
single port and gateway configuration, while there is no need to add an extra
VLAN configuration in the bridge showcase.</p>
<section id="single-port">
<h4>single port<a class="headerlink" href="#single-port" title="Link to this heading">¶</a></h4>
<p>The configuration can only be set up via VLAN tagging and bridge setup.
By default packages are tagged with vid 1:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># tag traffic on CPU port</span>
ip<span class="w"> </span>link<span class="w"> </span>add<span class="w"> </span>link<span class="w"> </span>eth0<span class="w"> </span>name<span class="w"> </span>eth0.1<span class="w"> </span><span class="nb">type</span><span class="w"> </span>vlan<span class="w"> </span>id<span class="w"> </span><span class="m">1</span>
ip<span class="w"> </span>link<span class="w"> </span>add<span class="w"> </span>link<span class="w"> </span>eth0<span class="w"> </span>name<span class="w"> </span>eth0.2<span class="w"> </span><span class="nb">type</span><span class="w"> </span>vlan<span class="w"> </span>id<span class="w"> </span><span class="m">2</span>
ip<span class="w"> </span>link<span class="w"> </span>add<span class="w"> </span>link<span class="w"> </span>eth0<span class="w"> </span>name<span class="w"> </span>eth0.3<span class="w"> </span><span class="nb">type</span><span class="w"> </span>vlan<span class="w"> </span>id<span class="w"> </span><span class="m">3</span>
<span class="c1"># The conduit interface needs to be brought up before the user ports.</span>
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>eth0<span class="w"> </span>up
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>eth0.1<span class="w"> </span>up
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>eth0.2<span class="w"> </span>up
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>eth0.3<span class="w"> </span>up
<span class="c1"># bring up the user interfaces</span>
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>wan<span class="w"> </span>up
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>lan1<span class="w"> </span>up
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>lan2<span class="w"> </span>up
<span class="c1"># create bridge</span>
ip<span class="w"> </span>link<span class="w"> </span>add<span class="w"> </span>name<span class="w"> </span>br0<span class="w"> </span><span class="nb">type</span><span class="w"> </span>bridge
<span class="c1"># activate VLAN filtering</span>
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>dev<span class="w"> </span>br0<span class="w"> </span><span class="nb">type</span><span class="w"> </span>bridge<span class="w"> </span>vlan_filtering<span class="w"> </span><span class="m">1</span>
<span class="c1"># add ports to bridges</span>
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>dev<span class="w"> </span>wan<span class="w"> </span>master<span class="w"> </span>br0
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>dev<span class="w"> </span>lan1<span class="w"> </span>master<span class="w"> </span>br0
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>dev<span class="w"> </span>lan2<span class="w"> </span>master<span class="w"> </span>br0
<span class="c1"># tag traffic on ports</span>
bridge<span class="w"> </span>vlan<span class="w"> </span>add<span class="w"> </span>dev<span class="w"> </span>lan1<span class="w"> </span>vid<span class="w"> </span><span class="m">2</span><span class="w"> </span>pvid<span class="w"> </span>untagged
bridge<span class="w"> </span>vlan<span class="w"> </span>del<span class="w"> </span>dev<span class="w"> </span>lan1<span class="w"> </span>vid<span class="w"> </span><span class="m">1</span>
bridge<span class="w"> </span>vlan<span class="w"> </span>add<span class="w"> </span>dev<span class="w"> </span>lan2<span class="w"> </span>vid<span class="w"> </span><span class="m">3</span><span class="w"> </span>pvid<span class="w"> </span>untagged
bridge<span class="w"> </span>vlan<span class="w"> </span>del<span class="w"> </span>dev<span class="w"> </span>lan2<span class="w"> </span>vid<span class="w"> </span><span class="m">1</span>
<span class="c1"># configure the VLANs</span>
ip<span class="w"> </span>addr<span class="w"> </span>add<span class="w"> </span><span class="m">192</span>.0.2.1/30<span class="w"> </span>dev<span class="w"> </span>eth0.1
ip<span class="w"> </span>addr<span class="w"> </span>add<span class="w"> </span><span class="m">192</span>.0.2.5/30<span class="w"> </span>dev<span class="w"> </span>eth0.2
ip<span class="w"> </span>addr<span class="w"> </span>add<span class="w"> </span><span class="m">192</span>.0.2.9/30<span class="w"> </span>dev<span class="w"> </span>eth0.3
<span class="c1"># bring up the bridge devices</span>
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>br0<span class="w"> </span>up
</pre></div>
</div>
</section>
<section id="bridge">
<h4>bridge<a class="headerlink" href="#bridge" title="Link to this heading">¶</a></h4>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># tag traffic on CPU port</span>
ip<span class="w"> </span>link<span class="w"> </span>add<span class="w"> </span>link<span class="w"> </span>eth0<span class="w"> </span>name<span class="w"> </span>eth0.1<span class="w"> </span><span class="nb">type</span><span class="w"> </span>vlan<span class="w"> </span>id<span class="w"> </span><span class="m">1</span>
<span class="c1"># The conduit interface needs to be brought up before the user ports.</span>
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>eth0<span class="w"> </span>up
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>eth0.1<span class="w"> </span>up
<span class="c1"># bring up the user interfaces</span>
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>wan<span class="w"> </span>up
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>lan1<span class="w"> </span>up
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>lan2<span class="w"> </span>up
<span class="c1"># create bridge</span>
ip<span class="w"> </span>link<span class="w"> </span>add<span class="w"> </span>name<span class="w"> </span>br0<span class="w"> </span><span class="nb">type</span><span class="w"> </span>bridge
<span class="c1"># activate VLAN filtering</span>
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>dev<span class="w"> </span>br0<span class="w"> </span><span class="nb">type</span><span class="w"> </span>bridge<span class="w"> </span>vlan_filtering<span class="w"> </span><span class="m">1</span>
<span class="c1"># add ports to bridge</span>
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>dev<span class="w"> </span>wan<span class="w"> </span>master<span class="w"> </span>br0
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>dev<span class="w"> </span>lan1<span class="w"> </span>master<span class="w"> </span>br0
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>dev<span class="w"> </span>lan2<span class="w"> </span>master<span class="w"> </span>br0
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>eth0.1<span class="w"> </span>master<span class="w"> </span>br0
<span class="c1"># configure the bridge</span>
ip<span class="w"> </span>addr<span class="w"> </span>add<span class="w"> </span><span class="m">192</span>.0.2.129/25<span class="w"> </span>dev<span class="w"> </span>br0
<span class="c1"># bring up the bridge</span>
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>dev<span class="w"> </span>br0<span class="w"> </span>up
</pre></div>
</div>
</section>
<section id="gateway">
<h4>gateway<a class="headerlink" href="#gateway" title="Link to this heading">¶</a></h4>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># tag traffic on CPU port</span>
ip<span class="w"> </span>link<span class="w"> </span>add<span class="w"> </span>link<span class="w"> </span>eth0<span class="w"> </span>name<span class="w"> </span>eth0.1<span class="w"> </span><span class="nb">type</span><span class="w"> </span>vlan<span class="w"> </span>id<span class="w"> </span><span class="m">1</span>
ip<span class="w"> </span>link<span class="w"> </span>add<span class="w"> </span>link<span class="w"> </span>eth0<span class="w"> </span>name<span class="w"> </span>eth0.2<span class="w"> </span><span class="nb">type</span><span class="w"> </span>vlan<span class="w"> </span>id<span class="w"> </span><span class="m">2</span>
<span class="c1"># The conduit interface needs to be brought up before the user ports.</span>
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>eth0<span class="w"> </span>up
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>eth0.1<span class="w"> </span>up
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>eth0.2<span class="w"> </span>up
<span class="c1"># bring up the user interfaces</span>
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>wan<span class="w"> </span>up
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>lan1<span class="w"> </span>up
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>lan2<span class="w"> </span>up
<span class="c1"># create bridge</span>
ip<span class="w"> </span>link<span class="w"> </span>add<span class="w"> </span>name<span class="w"> </span>br0<span class="w"> </span><span class="nb">type</span><span class="w"> </span>bridge
<span class="c1"># activate VLAN filtering</span>
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>dev<span class="w"> </span>br0<span class="w"> </span><span class="nb">type</span><span class="w"> </span>bridge<span class="w"> </span>vlan_filtering<span class="w"> </span><span class="m">1</span>
<span class="c1"># add ports to bridges</span>
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>dev<span class="w"> </span>wan<span class="w"> </span>master<span class="w"> </span>br0
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>eth0.1<span class="w"> </span>master<span class="w"> </span>br0
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>dev<span class="w"> </span>lan1<span class="w"> </span>master<span class="w"> </span>br0
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>dev<span class="w"> </span>lan2<span class="w"> </span>master<span class="w"> </span>br0
<span class="c1"># tag traffic on ports</span>
bridge<span class="w"> </span>vlan<span class="w"> </span>add<span class="w"> </span>dev<span class="w"> </span>wan<span class="w"> </span>vid<span class="w"> </span><span class="m">2</span><span class="w"> </span>pvid<span class="w"> </span>untagged
bridge<span class="w"> </span>vlan<span class="w"> </span>del<span class="w"> </span>dev<span class="w"> </span>wan<span class="w"> </span>vid<span class="w"> </span><span class="m">1</span>
<span class="c1"># configure the VLANs</span>
ip<span class="w"> </span>addr<span class="w"> </span>add<span class="w"> </span><span class="m">192</span>.0.2.1/30<span class="w"> </span>dev<span class="w"> </span>eth0.2
ip<span class="w"> </span>addr<span class="w"> </span>add<span class="w"> </span><span class="m">192</span>.0.2.129/25<span class="w"> </span>dev<span class="w"> </span>br0
<span class="c1"># bring up the bridge devices</span>
ip<span class="w"> </span>link<span class="w"> </span><span class="nb">set</span><span class="w"> </span>br0<span class="w"> </span>up
</pre></div>
</div>
</section>
</section>
</section>
</section>
</div>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="footer">
©The kernel development community.
|
Powered by <a href="https://www.sphinx-doc.org/">Sphinx 8.1.3</a>
& <a href="https://alabaster.readthedocs.io">Alabaster 0.7.16</a>
|
<a href="../../_sources/networking/dsa/b53.rst.txt"
rel="nofollow">Page source</a>
</div>
</body>
</html>