
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">



<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
<title>Ethernet Extension – Tinkerforge</title>

<!--<link type="text/css" rel="stylesheet" href="http://www.tinkerforge.com/static/base_tf.css" />-->
<link type="text/css" rel="stylesheet" href="http://www.tinkerforge.com/static/jquery.lightbox-0.5.css" />
<meta name="keywords" content="Tinkerforge, Open Source Hardware, Bricks, Bricklets, USB Controllable, USB Sensing, USB Controlling" />
<meta name="description" content="Easy-to-use open source hardware. Control motors and sense the environment over USB, Ethernet or Wi-Fi/WLAN with C/C++, C#, Delphi/Lazarus, Java, JavaScript, LabVIEW, Mathematica, MATLAB/Octave, Perl, PHP, Python, Ruby, Shell, Visual Basic .NET or directly over TCP/IP." />
<meta name="copyright" content="Tinkerforge GmbH" />
<!--<script type="text/javascript">document.write('<style>.noscript { display: none; }</style>');</script>-->


    
    <link rel="stylesheet" href="../../_static/documentation_tf.css" type="text/css" />
    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
    
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    '../../',
        VERSION:     '1.0',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
      };
    </script>
    <script type="text/javascript" src="../../_static/jquery.js"></script>
    <script type="text/javascript" src="../../_static/underscore.js"></script>
    <script type="text/javascript" src="../../_static/doctools.js"></script>
    <link rel="top" title="Tinkerforge" href="../../index.html" />
    <link rel="up" title="Master Extensions" href="Master_Extensions.html" />
    <link rel="next" title="RS485 Extension" href="RS485_Extension.html" />
    <link rel="prev" title="Chibi Extension" href="Chibi_Extension.html" />

<script type="text/javascript" src="http://www.tinkerforge.com/static/jquery.lightbox-0.5.js"></script>
<script type="text/javascript">$(function() { $('#gallery a').lightBox(); });</script>
<script type="text/javascript">$(function() { $(".sphinxsidebarwrapper").filter(function() { return $.trim($(this).text()).length == 0; }).parent().hide(); });</script>


  </head>
  <body>
<div id="wrapper">
	<div id="tfcontent">
		<div class="boxContent3">


<div class="toctree">
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../../Getting_Started.html">Getting Started</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../../Primer.html">Primer</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../Tutorials.html">Tutorials</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../FAQ.html">FAQ</a></li>
</ul>
</li>
<li class="toctree-l1 current"><a class="reference internal" href="../../Hardware.html">Hardware</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="../Bricks/Bricks.html">Bricks</a></li>
<li class="toctree-l2"><a class="reference internal" href="../Bricklets/Bricklets.html">Bricklets</a></li>
<li class="toctree-l2 current"><a class="reference internal" href="Master_Extensions.html">Master Extensions</a><ul class="current">
<li class="toctree-l3"><a class="reference internal" href="Chibi_Extension.html">Chibi Extension</a></li>
<li class="toctree-l3 current"><a class="current reference internal" href="">Ethernet Extension</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#features">Features</a></li>
<li class="toctree-l4"><a class="reference internal" href="#description">Description</a></li>
<li class="toctree-l4"><a class="reference internal" href="#technical-specifications">Technical Specifications</a></li>
<li class="toctree-l4"><a class="reference internal" href="#resources">Resources</a><ul>
<li class="toctree-l5"><a class="reference internal" href="#ethernet-configuration">Ethernet Configuration</a><ul>
<li class="toctree-l6"><a class="reference internal" href="#websockets">WebSockets</a></li>
<li class="toctree-l6"><a class="reference internal" href="#authentication">Authentication</a></li>
</ul>
</li>
<li class="toctree-l5"><a class="reference internal" href="#poe-power-supply">PoE Power Supply</a></li>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal" href="#programming-interface">Programming Interface</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="RS485_Extension.html">RS485 Extension</a></li>
<li class="toctree-l3"><a class="reference internal" href="WIFI_Extension.html">WIFI Extension</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../Power_Supplies/Power_Supplies.html">Power Supplies</a></li>
<li class="toctree-l2"><a class="reference internal" href="../Accessories/Accessories.html">Accessories</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../Timeline.html">Timeline</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../Software.html">Software</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../../Software/Brickd.html">Brick Daemon (brickd)</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../Software/Brickv.html">Brick Viewer (brickv)</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../Software/API_Bindings.html">API Bindings</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../Software/Firmwares_And_Plugins.html">Firmwares and Plugins</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../Software/Device_Identifier.html">Device Identifier</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../Source_Code.html">Source Code and Bug Tracking</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../Programming_Interface.html">Programming Interface</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../Kits.html">Starter Kits</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../../Kits/WeatherStation/WeatherStation.html">Weather Station</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../Kits/HardwareHacking/HardwareHacking.html">Hardware Hacking</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../Kits/ServerRoomMonitoring/ServerRoomMonitoring.html">Server Room Monitoring</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../Kits/Blinkenlights/Blinkenlights.html">Blinkenlights</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../Kits/InternetOfThings/InternetOfThings.html">Internet of Things</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../Kits/CameraSlider/CameraSlider.html">Camera Slider</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../Embedded.html">Embedded Boards</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../../Embedded/Raspberry_Pi.html">Raspberry Pi</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../Specifications.html">Specifications</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../../Technical_Data.html">Technical Data</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../Low_Level_Protocols/TCPIP.html">TCP/IP Protocol</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../Low_Level_Protocols/Modbus.html">Modbus Protocol</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../Low_Level_Protocols/Wireshark_Dissector.html">Wireshark Dissector</a></li>
</ul>
</li>
</ul>

</div>
<div class="breadcrumbs">
<a href="../../Hardware.html">Hardware</a> / <a href="./Master_Extensions.html">Master Extensions</a> / Ethernet Extension
</div>



<div id="shoplink_img">
	<a href="../../../shop/master-extensions/ethernet-master-extension.html"><img alt="Shop" width="32" height="40" src="../../_images/Misc/cart-icon.png" /></a>
</div>
<div id="shoplink_a">
	<a href="../../../shop/master-extensions/ethernet-master-extension.html">In Shop</a>
</div>



    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body">
            
  <div class="section" id="ethernet-extension">
<span id="id1"></span><h1>Ethernet Extension<a class="headerlink" href="#ethernet-extension" title="Permalink to this headline">¶</a></h1>
{% from "macros.html" import tfdocstart, tfdocimg, tfdocend %}
{{
    tfdocstart("Extensions/extension_ethernet_tilted_350.jpg",
               "Extensions/extension_ethernet_tilted_600.jpg",
               "Ethernet Extension")
}}
{{
    tfdocimg("Extensions/extension_ethernet_cable_100.jpg",
             "Extensions/extension_ethernet_cable_600.jpg",
             "Ethernet Extension with Ethernet cable")
}}
{{
    tfdocimg("Extensions/extension_ethernet_side_100.jpg",
             "Extensions/extension_ethernet_side_600.jpg",
             "Ethernet Extension side view")
}}
{{
    tfdocimg("Extensions/extension_ethernet_bottom_100.jpg",
             "Extensions/extension_ethernet_bottom_600.jpg",
             "Ethernet Extension bottom")
}}
{{
    tfdocimg("Extensions/extension_ethernet_top_100.jpg",
             "Extensions/extension_ethernet_top_600.jpg",
             "Ethernet Extension top")
}}
{{ tfdocend() }}<div class="section" id="features">
<h2>Features<a class="headerlink" href="#features" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Communicate directly with Bricks/Bricklets without Brickd</li>
<li>Supports 10/100 Mbit/s Ethernet (1000 Mbit/s compatible)</li>
<li>Integrated PoE Power Supply (PD Class 0 for IEEE 802.3af)</li>
</ul>
<blockquote>
<div><ul class="simple">
<li>Can power a Stack via Ethernet Cable</li>
</ul>
</div></blockquote>
</div>
<div class="section" id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
<p>With this Ethernet Extension you can control
<a class="reference internal" href="../../Primer.html#primer-bricks">Bricks</a> and
<a class="reference internal" href="../../Primer.html#primer-bricklets">Bricklets</a> and integrate them into a
<a class="reference external" href="https://de.wikipedia.org/wiki/Local_Area_Network">LAN</a>.
10BaseT/100BaseTX Ethernet is supported and the module is 1000BaseTX
compatible. The Extension is available in two variants:
The PoE variant features a integrated
<a class="reference external" href="https://en.wikipedia.org/wiki/Power_over_Ethernet">PoE</a>
power supply. It allows to power the connected modules over industry standard
IEEE 802.3af, such that a PoE injector as well as PoE
switches can be used to power <a class="reference internal" href="../../Primer.html#primer-stack">stacks</a>.
Additionally a variant without PoE is available.</p>
<p>Since the device itself handles TCP/IP packages generated by the API, it is
possible to connect directly from your controlling device
(mobile phone, tablet, (embedded) PC). A <a class="reference internal" href="../../Software/Brickd.html#brickd">Brick Daemon</a> is not
necessary.</p>
<p>To use the Ethernet Extension a <a class="reference internal" href="../Bricks/Master_Brick.html#master-brick">Master Brick</a> or
<a class="reference internal" href="../Bricks/RED_Brick.html#red-brick">RED Brick</a> is mandatory.
If you want to use other Bricks, you can build a stack and plug them also on top
of the Master Brick or RED Brick. If you want to use Bricklets you can attach them to the
Bricks in the stack. From the programming perspective
this is completely transparent, i.e. all Bricks and Bricklets can
be used exactly the same way as if they were connected to your controlling device via USB.</p>
<p>You need a Master Brick with firmware version 2.1.0 or newer to use this
extension.</p>
<p>The following combinations with other Extensions in a stack are possible
(regardless of order):</p>
<ul class="simple">
<li>Ethernet / RS485 Master</li>
</ul>
</div>
<div class="section" id="technical-specifications">
<h2>Technical Specifications<a class="headerlink" href="#technical-specifications" title="Permalink to this headline">¶</a></h2>
<table border="1" class="docutils">
<colgroup>
<col width="35%" />
<col width="65%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Property</th>
<th class="head">Value</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>Current Consumption</td>
<td>100mA (average), 175mA (maximum)</td>
</tr>
<tr class="row-odd"><td>PoE 5V Power Supply</td>
<td>&gt; 1A</td>
</tr>
<tr class="row-even"><td>&nbsp;</td>
<td>&nbsp;</td>
</tr>
<tr class="row-odd"><td>Ethernet Support</td>
<td>10BaseT/100BaseTX, 1000BaseTX compatible</td>
</tr>
<tr class="row-even"><td>Maximum Concurrent Connections</td>
<td>7</td>
</tr>
<tr class="row-odd"><td>&nbsp;</td>
<td>&nbsp;</td>
</tr>
<tr class="row-even"><td>Dimensions (W x D x H)</td>
<td>40 x 40 x 16mm (1.57 x 1.57 x 0.63&quot;)</td>
</tr>
<tr class="row-odd"><td>Weight</td>
<td>22g</td>
</tr>
</tbody>
</table>
</div>
<div class="section" id="resources">
<h2>Resources<a class="headerlink" href="#resources" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>W5200 Datasheet (<a class="reference external" href="https://github.com/Tinkerforge/ethernet-extension/raw/master/datasheets/W5200.pdf">Download</a>)</li>
<li>Schematic (<a class="reference external" href="https://github.com/Tinkerforge/ethernet-extension/raw/master/hardware/ethernet-extension-schematic.pdf">Download</a>)</li>
<li>Outline and drilling plan (<a class="reference external" href="../../_images/Dimensions/ethernet_extension_dimensions.png">Download</a>)</li>
<li>Source code and design files (<a class="reference external" href="https://github.com/Tinkerforge/ethernet-extension">Download</a>)</li>
</ul>
<div class="section" id="ethernet-configuration">
<span id="id2"></span><h3>Ethernet Configuration<a class="headerlink" href="#ethernet-configuration" title="Permalink to this headline">¶</a></h3>
<p>The Ethernet Extension can be configured in two different modes:
DHCP or static IP. If you use a static IP you have to enter
<strong>IP</strong>, <strong>Subnet Mask</strong> and <strong>Gateway</strong>.</p>
<p>The MAC address of the Ethernet Extension is not fixed in hardware, it will be
allocated by Tinkerforge. If it is lost in the EEPROM it can be found on the
sticker of the Ethernet Extension.</p>
<p>After configuring the Ethernet Extension you have to press the button
&quot;Save Ethernet Configuration&quot; and restart the Master Brick.</p>
<a class="reference external image-reference" href="../../_images/Extensions/extension_ethernet_brickv.jpg"><img alt="Ethernet Extension Configuration" class="align-center" src="../../_images/extension_ethernet_brickv.jpg" style="width: 728.0px; height: 615.0px;" /></a>
<div class="section" id="websockets">
<span id="ethernet-configuration-websockets"></span><h4>WebSockets<a class="headerlink" href="#websockets" title="Permalink to this headline">¶</a></h4>
<p>The Ethernet Extension supports <a class="reference external" href="http://en.wikipedia.org/wiki/WebSocket">WebSockets</a> since Master Brick firmware
version 2.2.0. The &quot;Max Connections&quot; option allows to freely divide the seven
Sockets of the Ethernet Extension between plain and WebSockets connections.</p>
<p>WebSockets are used by the browser version of the <a class="reference internal" href="../../Software/API_Bindings_JavaScript.html#api-bindings-javascript">JavaScript bindings</a> to control Bricks and Bricklets.</p>
</div>
<div class="section" id="authentication">
<span id="ethernet-configuration-authentication"></span><h4>Authentication<a class="headerlink" href="#authentication" title="Permalink to this headline">¶</a></h4>
<p>The Ethernet Extension supports authentication since Master Brick firmware
version 2.2.0. Authentication is disabled by default. Tick the &quot;Use
Authentication&quot; check box and choose an authentication secret to enable it.
This secret can be 64 ASCII characters long. After saving the configuration
and restarting the Master Brick authentication is enabled.</p>
<p>Now every TCP/IP connection to the Ethernet Extension has to prove to the
Master Brick that it knows the authentication secret before normal communication
can occur. See the <a class="reference internal" href="../../Tutorials/Tutorial_Authentication/Tutorial.html#tutorial-authentication">authentication tutorial</a>
for more information.</p>
</div>
</div>
<div class="section" id="poe-power-supply">
<h3>PoE Power Supply<a class="headerlink" href="#poe-power-supply" title="Permalink to this headline">¶</a></h3>
<p>PoE injectors can be used to power Bricks and Bricklets over Ethernet.
The Ethernet Extension will power the complete stack.
Activated PoE will be signaled by a green LED on the Ethernet Extension.</p>
<p>Servos and (stepper-) motors connected to DC-, Servo- or Stepper Bricks can not
be powered by PoE since the PoE voltage typically is too high.</p>
<p>The Ethernet Extension can be used together with a Step-Down Power Supply.</p>
</div>
</div>
<div class="section" id="programming-interface">
<h2>Programming Interface<a class="headerlink" href="#programming-interface" title="Permalink to this headline">¶</a></h2>
<p>See <a class="reference internal" href="../Bricks/Master_Brick.html#master-brick-programming-interface">Master Brick Documentation</a>.</p>
</div>
</div>


          </div>
        </div>
      </div>
      <div class="clearer"></div>
    </div>
		<div id="tf_license">
			<a rel="license" href="http://creativecommons.org/licenses/by-sa/3.0/">
				<img alt="Creative Commons Licence" width="88" height="31" style="border-width:0" src="/static/images/cc_license_logo.png" />
			</a>
			The content of this page is licensed under
			<a rel="license" href="http://creativecommons.org/licenses/by-sa/3.0/">Creative Commons Attribution 3.0 Unported License</a>.
		</div>
		</div>
	</div>
</div>

  </body>
</html>