Manual:Interface/Ethernet: Difference between revisions

From MikroTik Wiki
Jump to navigation Jump to search
(20 intermediate revisions by 5 users not shown)
Line 14: Line 14:
==Properties==
==Properties==


<br />
<table class="styled_table">
<tr>
  <th width="40%">Property</th>
  <th >Description</th>
</tr>
<tr>
    <td><var><b>arp</b></var> (<em>disabled | enabled | proxy-arp | reply-only</em>; Default: <b>enabled</b>)</td>
    <td>Address Resolution Protocol mode</td>
</tr>
<tr>
    <td><var><b>auto-negotiation</b></var> (<em>yes | no</em>; Default: <b>yes</b>)</td>
    <td>When enabled, the interface "advertises" its maximum capabilities to achieve the best connection possible. <br /> <b>Note:</b> Auto-negotiation must be disabled on both ends, otherwise Ethernets may not work properly. <br /> <b>Note2:</b> Gigabit link cannot work with auto-negotiation disabled.</td>
</tr>
<tr>
    <td><var><b>bandwidth</b></var> (<em>integer/integer</em>; Default: <b>unlimited/unlimited</b>)</td>
    <td>Sets max rx/tx bandwidth that will be handled by an interface.</td>
</tr>
<tr>
    <td><var><b>cable-setting</b></var> (<em>default | short | standard</em>; Default: <b>default</b>)</td>
    <td>changes the cable length setting (only applicable to NS DP83815/6 cards)</td>
</tr>
<tr>
    <td><var><b>disable-running-check</b></var> (<em>yes | no</em>; Default: <b>yes</b>)</td>
    <td>Disable running check. If this value is set to 'no', the router automatically detects whether the NIC is connected with a device in the network or not.</td>
</tr>
<tr>
    <td><var><b>full-duplex</b></var> (<em>yes | no</em>; Default: <b>yes</b>)</td>
    <td>Defines whether the transmission of data appears in two directions simultaneously</td>
</tr>
<tr>
    <td><var><b>l2mtu</b></var> (<em>integer</em>; Default: <b></b>)</td>
    <td>Layer2 Maximum transmission unit. [[ Maximum_Transmission_Unit_on_RouterBoards | Read more>> ]]</td>
</tr>
<tr>
    <td><var><b>mac-address</b></var> (<em>MAC</em>; Default: <b></b>)</td>
    <td>Media Access Control number of an interface.</td>
</tr>
<tr>
    <td><var><b>master-port</b></var> (<em>name | none</em>; Default: <b>none</b>)</td>
    <td>Sets switch group master interface</td>
</tr>
<tr>
    <td><var><b>mdix-enable</b></var> (<em>yes | no</em>; Default: <b></b>)</td>
    <td>Whether the MDI/X auto crosscable correction feature is enabled for the port</td>
</tr>
<tr>
    <td><var><b>mtu</b></var> (<em>integer</em>; Default: <b>1500</b>)</td>
    <td>Layer3 Maximum transmission unit</td>
</tr>
<tr>
    <td><var><b>name</b></var> (<em>string</em>; Default: <b></b>)</td>
    <td>Name of an interface</td>
</tr>
<tr>
    <td><var><b>speed</b></var> (<em>10Mbps | 100Mbps | 1Gbps</em>; Default: <b>max available</b>)</td>
    <td>Sets the data transmission speed of the interface. By default, this value is the maximal data rate supported by the interface</td>
</tr>
<tr>
    <td><var><b>poe-out</b></var> (<em>auto-on | forced-on | off</em>; Default: <b>off</b>)</td>
    <td>Poe Out settings. [[M:PoE-Out | <code>Read more >></code>]]</td>
</tr>
</table>


{{Mr-arg-table-h
|prop=Property
|desc=Description
}}
{{Mr-arg-table
|arg=arp
|type=disabled {{!}} enabled {{!}} proxy-arp {{!}} reply-only
|default=enabled
|desc=Address Resolution Protocol mode:
* <var>disabled</var> - the interface will not use ARP
* <var>enabled</var> - the interface will use ARP
* <var>proxy-arp</var> - the interface will use the ARP proxy feature
* <var>reply-only</var> - the interface will only reply to requests originated from matching IP address/MAC address combinations which are entered as static entries in the [[M:IP/ARP | ARP]] table. No dynamic entries will be automatically stored in the ARP table. Therefore for communications to be successful, a valid static entry must already exist.
}}
{{Mr-arg-table
|arg=auto-negotiation
|type=yes {{!}} no
|default=yes
|desc=When enabled, the interface "advertises" its maximum capabilities to achieve the best connection possible.
* '''Note1:''' Auto-negotiation should not be disabled on one end only, otherwise Ethernet Interfaces may not work properly.
* '''Note2:''' Gigabit link cannot work with auto-negotiation disabled.
}}
{{Mr-arg-table
|arg=bandwidth
|type=integer/integer
|default=unlimited/unlimited
|desc=Sets max rx/tx bandwidth in kbps that will be handled by an interface. TX limit is supported on all Atheros [[M:Switch_Chip_Features | switch-chip]] ports. RX limit is supported only on Atheros8327/QCA8337 switch-chip ports.
}}
{{Mr-arg-table
|arg=cable-setting
|type=default {{!}} short {{!}} standard
|default=default
|desc=Changes the cable length setting (only applicable to NS DP83815/6 cards)
}}
{{Mr-arg-table
|arg=comment
|type=string
|default=
|desc=Descriptive name of an item
}}
{{Mr-arg-table
|arg=disable-running-check
|type=yes {{!}} no
|default=yes
|desc=Disable running check. If this value is set to 'no', the router automatically detects whether the NIC is connected with a device in the network or not. Default value is 'yes' because older NICs do not support it. (only applicable to x86)
}}
{{Mr-arg-table
|arg=tx-flow-control
|type=on {{!}} off {{!}} auto
|default=off
|desc=When set to on, port will send pause frames when specific buffer usage thresholds is met. '''auto''' is the same as '''on''' except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises. Feature is supported on AR724x, AR9xxx, QCA9xxx CPU ports, all CCR ports and all Atheros switch chip ports.
}}
{{Mr-arg-table
|arg=rx-flow-control
|type=on {{!}} off {{!}} auto
|default=off
|desc=When set to on, port will process received pause frames and suspend transmission if required. '''auto''' is the same as '''on''' except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises. Feature is supported on AR724x, AR9xxx, QCA9xxx CPU ports, all CCR ports and all Atheros switch chip ports.
}}
{{Mr-arg-table
|arg=full-duplex
|type=yes {{!}} no
|default=yes
|desc=Defines whether the transmission of data appears in two directions simultaneously
}}
{{Mr-arg-table
|arg=l2mtu
|type=integer [0..65536]
|default=
|desc=Layer2 Maximum transmission unit. [[ Maximum_Transmission_Unit_on_RouterBoards | Read more>> ]]
}}
{{Mr-arg-table
|arg=mac-address
|type=MAC
|default=
|desc=Media Access Control number of an interface.
}}
{{Mr-arg-table
|arg=master-port
|type=name | none
|default=none
|desc=Outdated property, more details about this property can be found in the [[Manual:Master-port | Master-port]] page.
}}
{{Mr-arg-table
|arg=mdix-enable
|type=yes {{!}} no
|default=yes
|desc=Whether the MDI/X auto cross over cable correction feature is enabled for the port (Hardware specific, e.g. ether1 on RB500 can be set to yes/no. Fixed to 'yes' on other hardware.)
}}
{{Mr-arg-table
|arg=mtu
|type=integer [0..65536]
|default=1500
|desc=Layer3 Maximum transmission unit
}}
{{Mr-arg-table
|arg=name
|type=string
|default=
|desc=Name of an interface
}}
{{Mr-arg-table
|arg=orig-mac-address
|type=MAC
|default=
|desc=
}}
{{Mr-arg-table
|arg=poe-out
|type=auto-on {{!}} forced-on {{!}} off
|default=off
|desc=Poe Out settings. [[M:PoE-Out | <code>Read more >></code>]]
}}
{{Mr-arg-table
|arg=poe-priority
|type=
|default=
|desc=Poe Out settings. [[M:PoE-Out | <code>Read more >></code>]]
}}
{{Mr-arg-table
|arg=sfp-rate-select
|type=high {{!}} low
|default=high
|desc=
}}
{{Mr-arg-table-end
|arg=speed
|type=10Mbps {{!}} 10Gbps {{!}} 100Mbps {{!}} 1Gbps
|default=
|desc=Sets interface data transmission speed which takes effect only when <b>auto-negotiation</b> is disabled.
}}
===Read-only properties===


<h3>Read-only properties</h3>
<table class="styled_table">
<table class="styled_table">
<tr>
<tr>
Line 144: Line 234:
<tr>
<tr>
     <td><var><b>rx-overflow</b></var> (<em>integer</em>)</td>
     <td><var><b>rx-overflow</b></var> (<em>integer</em>)</td>
     <td></td>
     <td>Total count of received overflowed packets</td>
</tr>
</tr>
<tr>
<tr>
     <td><var><b>rx-pause</b></var> (<em>integer</em>)</td>
     <td><var><b>rx-pause</b></var> (<em>integer</em>)</td>
     <td>Amount of received pause frames</td>
     <td>Total count of received pause frames</td>
</tr>
</tr>
<tr>
<tr>
     <td><var><b>rx-runt</b></var> (<em>integer</em>)</td>
     <td><var><b>rx-runt</b></var> (<em>integer</em>)</td>
     <td>Amount of received frames shorter than the minimum 64 bytes
     <td>Total count of received frames shorter than the minimum 64 bytes
but with a valid CRC</td>
but with a valid CRC</td>
</tr>
</tr>
<tr>
<tr>
     <td><var><b>rx-too-long</b></var> (<em>integer</em>)</td>
     <td><var><b>rx-too-long</b></var> (<em>integer</em>)</td>
     <td></td>
     <td>Total count of received packets that were larger than the maximum packet size</td>
</tr>
</tr>


Line 171: Line 261:
<tr>
<tr>
     <td><var><b>tx-1024-1518</b></var> (<em>integer</em>)</td>
     <td><var><b>tx-1024-1518</b></var> (<em>integer</em>)</td>
     <td></td>
     <td>Total count of transmitted 1024 to 1518 byte packets</td>
</tr>
</tr>
<tr>
<tr>
     <td><var><b>tx-128-255</b></var> (<em>integer</em>)</td>
     <td><var><b>tx-128-255</b></var> (<em>integer</em>)</td>
     <td></td>
     <td>Total count of transmitted 128 to 255 byte packets</td>
</tr>
</tr>
<tr>
<tr>
     <td><var><b>tx-1519-max</b></var> (<em>integer</em>)</td>
     <td><var><b>tx-1519-max</b></var> (<em>integer</em>)</td>
     <td></td>
     <td>Total count of transmitted packets larger than 1519 bytes</td>
</tr>
</tr>
<tr>
<tr>
     <td><var><b>tx-256-511</b></var> (<em>integer</em>)</td>
     <td><var><b>tx-256-511</b></var> (<em>integer</em>)</td>
     <td></td>
     <td>Total count of transmitted 256 to 511 byte packets</td>
</tr>
</tr>
<tr>
<tr>
     <td><var><b>tx-512-1023</b></var> (<em>integer</em>)</td>
     <td><var><b>tx-512-1023</b></var> (<em>integer</em>)</td>
     <td></td>
     <td>Total count of transmitted 512 to 1023 byte packets</td>
</tr>
</tr>
<tr>
<tr>
     <td><var><b>tx-64</b></var> (<em>integer</em>)</td>
     <td><var><b>tx-64</b></var> (<em>integer</em>)</td>
     <td></td>
     <td>Total count of transmitted 64 byte packets</td>
</tr>
</tr>
<tr>
<tr>
     <td><var><b>tx-65-127</b></var> (<em>integer</em>)</td>
     <td><var><b>tx-65-127</b></var> (<em>integer</em>)</td>
     <td></td>
     <td>Total count of transmitted 65 to 127 byte packets</td>
</tr>
</tr>
<tr>
<tr>
     <td><var><b>tx-align-error</b></var> (<em>integer</em>)</td>
     <td><var><b>tx-align-error</b></var> (<em>integer</em>)</td>
     <td></td>
     <td>Total count of transmitted align error messages</td>
</tr>
</tr>
<tr>
<tr>
     <td><var><b>tx-broadcast</b></var> (<em>integer</em>)</td>
     <td><var><b>tx-broadcast</b></var> (<em>integer</em>)</td>
     <td></td>
     <td>Total count of transmitted broadcast packets</td>
</tr>
</tr>
<tr>
<tr>
     <td><var><b>tx-bytes</b></var> (<em>integer</em>)</td>
     <td><var><b>tx-bytes</b></var> (<em>integer</em>)</td>
     <td></td>
     <td>Total count of transmitted bytes</td>
</tr>
</tr>
<tr>
<tr>
     <td><var><b>tx-fcs-error</b></var> (<em>integer</em>)</td>
     <td><var><b>tx-fcs-error</b></var> (<em>integer</em>)</td>
     <td></td>
     <td>Total count of transmitted frames with incorrect checksum</td>
</tr>
</tr>
<tr>
<tr>
     <td><var><b>tx-fragment</b></var> (<em>integer</em>)</td>
     <td><var><b>tx-fragment</b></var> (<em>integer</em>)</td>
     <td></td>
     <td>Total count of transmitted fragmented frames</td>
</tr>
</tr>
<tr>
<tr>
     <td><var><b>tx-multicast</b></var> (<em>integer</em>)</td>
     <td><var><b>tx-multicast</b></var> (<em>integer</em>)</td>
     <td></td>
     <td>Total count of transmitted multicast packets</td>
</tr>
</tr>
<tr>
<tr>
     <td><var><b>tx-overflow</b></var> (<em>integer</em>)</td>
     <td><var><b>tx-overflow</b></var> (<em>integer</em>)</td>
     <td></td>
     <td>Total count of transmitted overflowed packets</td>
</tr>
</tr>
<tr>
<tr>
     <td><var><b>tx-pause</b></var> (<em>integer</em>)</td>
     <td><var><b>tx-pause</b></var> (<em>integer</em>)</td>
     <td></td>
     <td>Total count of transmitted pause frames</td>
</tr>
</tr>
<tr>
<tr>
     <td><var><b>tx-runt</b></var> (<em>integer</em>)</td>
     <td><var><b>tx-runt</b></var> (<em>integer</em>)</td>
     <td></td>
     <td>Total count of transmitted frames shorter than the minimum 64 bytes
but with a valid CRC</td>
</tr>
</tr>
<tr>
<tr>
     <td><var><b>tx-too-long</b></var> (<em>integer</em>)</td>
     <td><var><b>tx-too-long</b></var> (<em>integer</em>)</td>
     <td></td>
     <td>Total count of transmitted packets that were larger than the maximum packet size</td>
</tr>
</tr>


Line 266: Line 357:


{{Mr-arg-ro-table
{{Mr-arg-ro-table
|arg=reset-mac
|arg=reset-mac-address
|type=[id, name]
|type=[id, name]
|desc=Reset MAC address to manufacturers default.
|desc=Reset MAC address to manufacturers default.
Line 272: Line 363:


{{Mr-arg-ro-table-end
{{Mr-arg-ro-table-end
|arg=cable-pairs
|arg=cable-test
|type=string
|type=string
|desc=Shows detected problems with cable pairs. [[#Detect Cable Problems | <code>Read More >></code>]]
|desc=Shows detected problems with cable pairs. [[#Detect Cable Problems | <code>Read More >></code>]]
Line 293: Line 384:
|type=done {{!}} incomplete
|type=done {{!}} incomplete
|desc=Current auto negotiation status:
|desc=Current auto negotiation status:
* <var>done</var>-negotiation completed
* <var>done</var> - negotiation completed
* <var>incomplete</var>-negotiation failed or not yet completed
* <var>incomplete</var> - negotiation failed or not yet completed
}}
}}


Line 301: Line 392:
|type=short {{!}} standard
|type=short {{!}} standard
|desc=Default cable length setting (only applicable to NS DP83815/6 cards)
|desc=Default cable length setting (only applicable to NS DP83815/6 cards)
* <var>short</var>-support short cables  
* <var>short</var> - support short cables  
* <var>standard</var>-support standard cables  
* <var>standard</var> - support standard cables  
}}
}}


Line 321: Line 412:
|type=link-ok {{!}} no-link {{!}} unknown
|type=link-ok {{!}} no-link {{!}} unknown
|desc=Current link status of an interface
|desc=Current link status of an interface
* <var>link-ok</var>-the card is connected to the network
* <var>link-ok</var> - the card is connected to the network
* <var>no-link</var>-the card is not connected to the network
* <var>no-link</var> - the card is not connected to the network
* <var>unknown</var>-the connection is not recognized (if the card does not report connection status)  
* <var>unknown</var> - the connection is not recognized (if the card does not report connection status)  
}}
 
{{Mr-arg-ro-table
|arg=tx-flow-control
|type=
|desc=Whether TX flow control is used
}}
 
{{Mr-arg-ro-table
|arg=rx-flow-control
|type=
|desc=Whether RX flow control is used
}}
 
{{Mr-arg-ro-table
|arg=sfp-module-present
|type=yes {{!}} no
|desc=Whether SFP module is in cage
}}
 
{{Mr-arg-ro-table
|arg=sfp-rx-lose
|type=yes {{!}} no
|desc=
}}
 
{{Mr-arg-ro-table
|arg=sfp-tx-fault
|type=yes {{!}} no
|desc=
}}
 
{{Mr-arg-ro-table
|arg=sfp-connector-type
|type=string
|desc=
}}
 
{{Mr-arg-ro-table
|arg=sfp-link-length-copper
|type=string
|desc=Detected link length when copper SFP module is used
}}
 
{{Mr-arg-ro-table
|arg=sfp-vendor-name
|type=string
|desc=Vendor of the SFP module
}}
 
{{Mr-arg-ro-table
|arg=sfp-vendor-part-number
|type=string
|desc=SFP module part number
}}
 
{{Mr-arg-ro-table
|arg=sfp-vendor-revision
|type=string
|desc=SFP module revision number
}}
 
{{Mr-arg-ro-table
|arg=sfp-vendor-serial
|type=string
|desc=SFP module serial number
}}
 
{{Mr-arg-ro-table
|arg=sfp-manufacturing-date
|type=string
|desc=SFP module manufacturing date
}}
}}


{{Mr-arg-ro-table-end
{{Mr-arg-ro-table-end
|arg=phy-regs
|arg=eeprom
|type=
|type=
|desc=List of Ethernet PHY registers
|desc=EEPROM of an SFP module
}}
}}


Example output of ethernet status:
Example output of ethernet status:
Line 343: Line 505:
</pre>
</pre>


Example output of an SFP status:
<pre>
[admin@MikroTik] /interface ethernet> monitor sfp1
                    name: sfp1
                  status: link-ok
        auto-negotiation: done
                    rate: 1Gbps
            full-duplex: yes
        tx-flow-control: no
        rx-flow-control: no
      sfp-module-present: yes
            sfp-rx-lose: no
            sfp-tx-fault: no
      sfp-connector-type: optical-pigtail
  sfp-link-length-copper: 1m
        sfp-vendor-name: OEM
  sfp-vendor-part-number: SFP-10G-CU1M
    sfp-vendor-revision: A0
      sfp-vendor-serial: E1309250082
  sfp-manufacturing-date: 13-10-10
                  eeprom: 0000: 03 04 21 00 00 00 00 00  04 00 00 00 67 00 00 >
                          0010: 00 00 01 00 4f 45 4d 20  20 20 20 20 20 20 20 >
                          0020: 20 20 20 20 00 00 40 20  53 46 50 2d 31 30 47 >
                          0030: 43 55 31 4d 20 20 20 20  41 30 20 20 00 00 00 >
                          0040: 00 00 00 00 45 31 33 30  39 32 35 30 30 38 32 >
                          0050: 20 20 20 20 31 33 31 30  31 30 20 20 00 00 00 >
</pre>


==Detect Cable Problems==
==Detect Cable Problems==


In RouterOS v5.21 and newer releases there is ability to detect cable problems.
In RouterOS v6rc4 and newer releases there is the ability to detect problems with connected cables.
Cable test can detect problems or measure the approximate cable length if the cable is unplugged on the other end and there is therefore, "no-link".
RouterOS will tell:
RouterOS will tell:


* which cable pair is damaged
* which cable pair is damaged
* at what length is the cable broken
* the distance to the problem
* how is the cable broken - shorted or torn
* how exactly the cable is broken - short-circuited or open-circuited
 
This also works if the other end is simply unplugged - in that case, simply the cable length will be shown.


This works on '''SXT-G''', '''RB711G''', '''RB2011''', '''RB750''' series and other devices with the same switch chips, and also the '''Cloud Core''' series devices.  
This also works if the other end is simply unplugged - in that case, the total cable length will be shown.  


Here is example output:
Here is example output:
<pre>
<pre>
[admin@CCR] > interface ethernet cable-test ether1
[admin@CCR] > interface ethernet cable-test ether2
         name: ether1
         name: ether2
       status: no-link
       status: no-link
   cable-pairs: open:4,open:4,open:4,open:4
   cable-pairs: open:4,open:4,open:4,open:4
</pre>
</pre>


In the above example, cable is not shorted but cut “open” at 4 meters length, all cable pairs equally at same location.
In the above example, cable is not shorted but “open” at 4 meters distance, all cable pairs equally faulty at the same distance from the switch chip.
 
Currently <code>cable-test</code> is implemented on the following devices:
* CCR series devices
* CRS1xx series devices
* CRS2xx series devices
* OmniTIK series devices
* RB450G series devices
* RB951 series devices
* RB2011 series devices
* RB4011 series devices
* RB750Gr2
* RB750UPr2
* RB751U-2HnD
* RB850Gx2
* RB931-2nD
* RB941-2nD
* RB952Ui-5ac2nD
* RB962UiGS-5HacT2HnT
* RB1100AHx2
* RB1100x4
* RBD52G-5HacD2HnD
* RBcAPGi-5acD2nD
* RBmAP2n
* RBmAP2nD
* RBwsAP-5Hac2nD
* RB3011UiAS-RM
* RBMetal 2SHPn
* RBDynaDishG-5HacD
* RBLDFG-5acD
* RBLHGG-5acD
 
{{ Note | Currently <code>cable-test</code> is not supported on Combo ports. }}


==Stats==
==Stats==
Line 421: Line 641:
<p id="shbox"><b>Sub-menu:</b> <code>/interface ethernet switch</code></p>
<p id="shbox"><b>Sub-menu:</b> <code>/interface ethernet switch</code></p>


This submenu allows to configure certain RouterBoard switch chip feature. [[Switch_Chip_Features | Read more >>]].
This submenu allows configuration of certain RouterBoard switch chip features. [[Switch_Chip_Features | Read more >>]].


</div>
</div>

Revision as of 16:40, 7 March 2019

Version.png

Applies to RouterOS: v3, v4+

Summary

Sub-menu: /interface ethernet
Standards: IEEE 802.3


MikroTik RouterOS supports various types of Ethernet interfaces.

Properties

Property Description
arp (disabled | enabled | proxy-arp | reply-only; Default: enabled) Address Resolution Protocol mode:
  • disabled - the interface will not use ARP
  • enabled - the interface will use ARP
  • proxy-arp - the interface will use the ARP proxy feature
  • reply-only - the interface will only reply to requests originated from matching IP address/MAC address combinations which are entered as static entries in the ARP table. No dynamic entries will be automatically stored in the ARP table. Therefore for communications to be successful, a valid static entry must already exist.
auto-negotiation (yes | no; Default: yes) When enabled, the interface "advertises" its maximum capabilities to achieve the best connection possible.
  • Note1: Auto-negotiation should not be disabled on one end only, otherwise Ethernet Interfaces may not work properly.
  • Note2: Gigabit link cannot work with auto-negotiation disabled.
bandwidth (integer/integer; Default: unlimited/unlimited) Sets max rx/tx bandwidth in kbps that will be handled by an interface. TX limit is supported on all Atheros switch-chip ports. RX limit is supported only on Atheros8327/QCA8337 switch-chip ports.
cable-setting (default | short | standard; Default: default) Changes the cable length setting (only applicable to NS DP83815/6 cards)
comment (string; Default: ) Descriptive name of an item
disable-running-check (yes | no; Default: yes) Disable running check. If this value is set to 'no', the router automatically detects whether the NIC is connected with a device in the network or not. Default value is 'yes' because older NICs do not support it. (only applicable to x86)
tx-flow-control (on | off | auto; Default: off) When set to on, port will send pause frames when specific buffer usage thresholds is met. auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises. Feature is supported on AR724x, AR9xxx, QCA9xxx CPU ports, all CCR ports and all Atheros switch chip ports.
rx-flow-control (on | off | auto; Default: off) When set to on, port will process received pause frames and suspend transmission if required. auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises. Feature is supported on AR724x, AR9xxx, QCA9xxx CPU ports, all CCR ports and all Atheros switch chip ports.
full-duplex (yes | no; Default: yes) Defines whether the transmission of data appears in two directions simultaneously
l2mtu (integer [0..65536]; Default: ) Layer2 Maximum transmission unit. Read more>>
mac-address (MAC; Default: ) Media Access Control number of an interface.
master-port (name; Default: none) Outdated property, more details about this property can be found in the Master-port page.
mdix-enable (yes | no; Default: yes) Whether the MDI/X auto cross over cable correction feature is enabled for the port (Hardware specific, e.g. ether1 on RB500 can be set to yes/no. Fixed to 'yes' on other hardware.)
mtu (integer [0..65536]; Default: 1500) Layer3 Maximum transmission unit
name (string; Default: ) Name of an interface
orig-mac-address (MAC; Default: )
poe-out (auto-on | forced-on | off; Default: off) Poe Out settings. Read more >>
poe-priority (; Default: ) Poe Out settings. Read more >>
sfp-rate-select (high | low; Default: high)
speed (10Mbps | 10Gbps | 100Mbps | 1Gbps; Default: ) Sets interface data transmission speed which takes effect only when auto-negotiation is disabled.


Read-only properties

Property Description
running (yes | no) Whether interface is running. Note that some interface does not have running check and they are always reported as "running"
rx-1024-1518 (integer) Total count of received 1024 to 1518 byte packets
rx-128-255 (integer) Total count of received 128 to 255 byte packets
rx-1519-max (integer) Total count of received packets larger than 1519 bytes
rx-256-511 (integer) Total count of received 256 to 511 byte packets
rx-512-1023 (integer) Total count of received 512 to 1023 byte packets
rx-64 (integer) Total count of received 64 byte packets
rx-65-127 (integer) Total count of received 65 to 127 byte packets
rx-align-error (integer) Total count of received align error messages
rx-broadcast (integer) Total count of received broadcast packets
rx-bytes (integer) Total count of received bytes
rx-fcs-error (integer) Total count of received frames with incorrect checksum
rx-fragment (integer) Total count of received fragmented frames
rx-multicast (integer) Total count of received multicast packets
rx-overflow (integer) Total count of received overflowed packets
rx-pause (integer) Total count of received pause frames
rx-runt (integer) Total count of received frames shorter than the minimum 64 bytes but with a valid CRC
rx-too-long (integer) Total count of received packets that were larger than the maximum packet size
slave (yes | no) Whether interface is configured as a slave of another interface (for example Bonding)
switch (integer) ID to which switch chip interface belongs to.
tx-1024-1518 (integer) Total count of transmitted 1024 to 1518 byte packets
tx-128-255 (integer) Total count of transmitted 128 to 255 byte packets
tx-1519-max (integer) Total count of transmitted packets larger than 1519 bytes
tx-256-511 (integer) Total count of transmitted 256 to 511 byte packets
tx-512-1023 (integer) Total count of transmitted 512 to 1023 byte packets
tx-64 (integer) Total count of transmitted 64 byte packets
tx-65-127 (integer) Total count of transmitted 65 to 127 byte packets
tx-align-error (integer) Total count of transmitted align error messages
tx-broadcast (integer) Total count of transmitted broadcast packets
tx-bytes (integer) Total count of transmitted bytes
tx-fcs-error (integer) Total count of transmitted frames with incorrect checksum
tx-fragment (integer) Total count of transmitted fragmented frames
tx-multicast (integer) Total count of transmitted multicast packets
tx-overflow (integer) Total count of transmitted overflowed packets
tx-pause (integer) Total count of transmitted pause frames
tx-runt (integer) Total count of transmitted frames shorter than the minimum 64 bytes but with a valid CRC
tx-too-long (integer) Total count of transmitted packets that were larger than the maximum packet size

Menu specific commands

Property Description
blink ([id, name]) Blink Ethernet leds
monitor ([id, name]) Monitor ethernet status. Read more>>
reset-counters ([id, name]) Reset stats counters. Read more>>
reset-mac-address ([id, name]) Reset MAC address to manufacturers default.
cable-test (string) Shows detected problems with cable pairs. Read More >>

Monitor

/interface ethernet monitor command prints out current link, rate and duplex status of an interface.


Properties:

Property Description
auto-negotiation (done | incomplete) Current auto negotiation status:
  • done - negotiation completed
  • incomplete - negotiation failed or not yet completed
default-cable-settings (short | standard) Default cable length setting (only applicable to NS DP83815/6 cards)
  • short - support short cables
  • standard - support standard cables
full-duplex (yes | no) Whether transmission of data occurs in two directions simultaneously
rate (10Mbps | 100Mbps | 1Gbps) Actual data rate of the connection.
status (link-ok | no-link | unknown) Current link status of an interface
  • link-ok - the card is connected to the network
  • no-link - the card is not connected to the network
  • unknown - the connection is not recognized (if the card does not report connection status)
tx-flow-control () Whether TX flow control is used
rx-flow-control () Whether RX flow control is used
sfp-module-present (yes | no) Whether SFP module is in cage
sfp-rx-lose (yes | no)
sfp-tx-fault (yes | no)
sfp-connector-type (string)
sfp-link-length-copper (string) Detected link length when copper SFP module is used
sfp-vendor-name (string) Vendor of the SFP module
sfp-vendor-part-number (string) SFP module part number
sfp-vendor-revision (string) SFP module revision number
sfp-vendor-serial (string) SFP module serial number
sfp-manufacturing-date (string) SFP module manufacturing date
eeprom () EEPROM of an SFP module

Example output of ethernet status:

[admin@MikroTik] /interface ethernet> monitor ether1
            status: link-ok
  auto-negotiation: done
              rate: 1Gbps
       full-duplex: yes

Example output of an SFP status:

[admin@MikroTik] /interface ethernet> monitor sfp1
                    name: sfp1
                  status: link-ok
        auto-negotiation: done
                    rate: 1Gbps
             full-duplex: yes
         tx-flow-control: no
         rx-flow-control: no
      sfp-module-present: yes
             sfp-rx-lose: no
            sfp-tx-fault: no
      sfp-connector-type: optical-pigtail
  sfp-link-length-copper: 1m
         sfp-vendor-name: OEM
  sfp-vendor-part-number: SFP-10G-CU1M
     sfp-vendor-revision: A0
       sfp-vendor-serial: E1309250082
  sfp-manufacturing-date: 13-10-10
                  eeprom: 0000: 03 04 21 00 00 00 00 00  04 00 00 00 67 00 00 >
                          0010: 00 00 01 00 4f 45 4d 20  20 20 20 20 20 20 20 >
                          0020: 20 20 20 20 00 00 40 20  53 46 50 2d 31 30 47 >
                          0030: 43 55 31 4d 20 20 20 20  41 30 20 20 00 00 00 >
                          0040: 00 00 00 00 45 31 33 30  39 32 35 30 30 38 32 >
                          0050: 20 20 20 20 31 33 31 30  31 30 20 20 00 00 00 >

Detect Cable Problems

In RouterOS v6rc4 and newer releases there is the ability to detect problems with connected cables. Cable test can detect problems or measure the approximate cable length if the cable is unplugged on the other end and there is therefore, "no-link". RouterOS will tell:

  • which cable pair is damaged
  • the distance to the problem
  • how exactly the cable is broken - short-circuited or open-circuited

This also works if the other end is simply unplugged - in that case, the total cable length will be shown.

Here is example output:

[admin@CCR] > interface ethernet cable-test ether2
         name: ether2
       status: no-link
  cable-pairs: open:4,open:4,open:4,open:4

In the above example, cable is not shorted but “open” at 4 meters distance, all cable pairs equally faulty at the same distance from the switch chip.

Currently cable-test is implemented on the following devices:

  • CCR series devices
  • CRS1xx series devices
  • CRS2xx series devices
  • OmniTIK series devices
  • RB450G series devices
  • RB951 series devices
  • RB2011 series devices
  • RB4011 series devices
  • RB750Gr2
  • RB750UPr2
  • RB751U-2HnD
  • RB850Gx2
  • RB931-2nD
  • RB941-2nD
  • RB952Ui-5ac2nD
  • RB962UiGS-5HacT2HnT
  • RB1100AHx2
  • RB1100x4
  • RBD52G-5HacD2HnD
  • RBcAPGi-5acD2nD
  • RBmAP2n
  • RBmAP2nD
  • RBwsAP-5Hac2nD
  • RB3011UiAS-RM
  • RBMetal 2SHPn
  • RBDynaDishG-5HacD
  • RBLDFG-5acD
  • RBLHGG-5acD
Icon-note.png

Note: Currently cable-test is not supported on Combo ports.


Stats

RouterOS v3.22 introduces a new command:

/interface ethernet print stats

This command will display all kinds of other statistics if the interface is supporting them (currently only RB450G ether2-ether5, RB750 ether2-ether5, RB750G ether1-ether5 and also RB1100 ether1-ether10). Complete list of properties can be found in section above

For example, output of ethernet stats on RB450G:

[admin@MikroTik] /interface ethernet> print stats 
                      name: ether1-gateway ether2-local ether3-local ether4-local ether5-local
              rx-broadcast:                22           31           3666         11          
                  rx-pause:                0            0            0            0           
              rx-multicast:                4            7            1423         5           
              rx-fcs-error:                0            0            2            0           
            rx-align-error:                0            0            0            0           
                   rx-runt:                0            0            0            0           
               rx-fragment:                0            0            1            0           
                     rx-64:                0            0            0            0           
                 rx-65-127:                8            14           21598        10          
                rx-128-255:                0            0            0            0           
                rx-256-511:                18           24           2245         6           
               rx-512-1023:                28926        7649         371938       24476       
              rx-1024-1518:                0            0            0            0           
               rx-1519-max:                0            0            0            0           
               rx-too-long:                0            0            0            0           
               rx-overflow:                0            0            0            0           
                  rx-bytes:                15337844     4063737      199738064    12975401    
              tx-broadcast:                13           13           1496         8           
                  tx-pause:                0            0            0            0           
              tx-multicast:                13           13           1496         8           
               tx-underrun:                0            0            0            0           
                     tx-64:                0            0            0            0           
                 tx-65-127:                26           26           2992         16          
                tx-128-255:                0            0            0            0           
                tx-256-511:                0            0            0            0           
               tx-512-1023:                0            0            0            0           
              tx-1024-1518:                0            0            0            0           
               tx-1519-max:                0            0            0            0
               tx-too-long:                0            0            0            0
              tx-collision:                0            0            0            0
    tx-excessive-collision:                0            0            0            0
     tx-multiple-collision:                0            0            0            0
       tx-single-collision:                0            0            0            0
     tx-excessive-deferred:                0            0            0            0
               tx-deferred:                0            0            0            0
         tx-late-collision:                0            0            0            0
                  tx-bytes:                2561         2561         294712       1576

Switch

Sub-menu: /interface ethernet switch

This submenu allows configuration of certain RouterBoard switch chip features. Read more >>.

PoE out

PoE out settings are only available on RouterBOARD devices that have this hardware feature present.

See more here: PoE-Out

[ Top | Back to Content ]