Sub-menu:/interface ethernet
Standards:IEEE 802.3
Summary
MikroTik RouterOS supports various types of Ethernet interfaces - ranging from 10Mbps to 10Gbps Ethernet over copper twisted pair, 1Gbps and 10Gbps SFP/SFP+ interfaces and 40Gbps QSFP interface. Certain RouterBoard devices are equipped with a combo interface that simultaneously contains two interface types (e.g. 1Gbps Ethernet over twisted pair and SFP interface) allowing to select the most suitable option or creating a physical link failover. Through RouterOS, it is possible to control different Ethernet related properties like link speed, auto-negotiation, duplex mode, etc, monitor a transceiver diagnostic information and see a wide range of Ethernet related statistics.
Properties
| Property | Description |
|---|---|
| advertise(10M-full | 10M-half | 100M-full | 100M-half | 1000M-full | 1000M-half | 2500M-full | 5000M-full | 10000M-full; Default: ) | Advertised speed and duplex modes for Ethernet interfaces over twisted pair, only applies whenauto-negotiationis enabled. Advertising higher speeds than the actual interface supported speed will have no effect, multiple options are allowed. |
| arp(disabled | enabled | local-proxy-arp | proxy-arp | reply-only; Default:enabled) | Address Resolution Protocol mode:
|
| auto-negotiation(yes | no; Default:yes) | When enabled, the interface "advertises" its maximum capabilities to achieve the best connection possible.
|
| 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 Atherosswitch-chipports. 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) |
| combo-mode(auto | copper | sfp; Default:auto) | Whenauto模式被选中时,端口that was first connected will establish the link. In case this link fails, the other port will try to establish a new link. If both ports are connected at the same time (e.g. after reboot), the priority will be the SFP/SFP+ port. Whensfpmode is selected, the interface will only work through SFP/SFP+ cage. Whencoppermode is selected, the interface will only work through RJ45 Ethernet port. |
| 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, the port will generate pause frames to the upstream device to temporarily stop the packet transmission. Pause frames are only generated when some routers output interface is congested and packets cannot be transmitted anymore.autois the same asonexcept when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises. |
| rx-flow-control(on | off | auto; Default:off) | When set to on, the port will process received pause frames and suspend transmission if required.autois the same asonexcept when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises. |
| full-duplex(yes | no; Default:yes) | Defines whether the transmission of data appears in two directions simultaneously, only applies whenauto-negotiationis disabled. |
| 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 theMaster-portpage. |
| 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(read-only: MAC; Default: ) | 原始媒体访问控制数据的数量ce. |
| poe-out(auto-on | forced-on | off; Default:off) | Poe Out settings.Read more >> |
| poe-priority(integer [0..99]; Default: ) | Poe Out settings.Read more >> |
| sfp-shutdown-temperature(integer; Default:95|80) | The temperature in Celsius at which the interface will be temporarily turned off due to too high detected SFP module temperature (introduced v6.48). The default value for SFP/SFP+/SFP28 interfaces is 95, and for QSFP+/QSFP28 interfaces 80 (introduced v7.6). |
| speed(10Mbps | 10Gbps | 100Mbps | 1Gbps; Default: ) | Sets interface data transmission speed which takes effect only whenauto-negotiationis 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" |
| slave(yes | no) | Whether interface is configured as a slave of another interface (for exampleBonding) |
| switch(integer) | ID to which switch chip interface belongs to. |
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
To print out a current link rate, duplex mode, and other Ethernet related properties or to see detailed diagnostics information for transceivers, use/interface ethernet monitorcommand. The provided information can differ for different interface types (e.g. Ethernet over twisted pair or SFP interface) or for different transceivers (e.g. SFP and QSFP).
Properties
| Property | Description |
|---|---|
| advertising(10M-full | 10M-half | 100M-full | 100M-half | 1000M-full | 1000M-half | 2500M-full | 5000M-full | 10000M-full) | Advertised speeds and duplex modes for Ethernet interfaces over twisted pair, only applies whenauto-negotiationis enabled |
| auto-negotiation(disabled | done | failed | incomplete) | Current auto negotiation status:
|
| default-cable-settings(short | standard) | Default cable length setting (only applicable to NS DP83815/6 cards)
|
| full-duplex(yes | no) | Whether transmission of data occurs in two directions simultaneously |
| link-partner-advertising(10M-full | 10M-half | 100M-full | 100M-half | 1000M-full | 1000M-half | 2500M-full | 5000M-full | 10000M-full) | Link partner advertised speeds and duplex modes for Ethernet interfaces over twisted pair, only applies whenauto-negotiationis enabled |
| rate(10Mbps | 100Mbps | 1Gbps | 2.5Gbps | 5Gbps | 10Gbps | 40Gbps |) | Actual data rate of the connection. |
| status(link-ok | no-link | unknown) | Current link status of an interface
|
| tx-flow-control(yes | no) | Whether TX flow control is used |
| rx-flow-control(yes | no) | Whether RX flow control is used |
| combo-state(copper | sfp) | Used combo-mode for combo interfaces |
| sfp-module-present(yes | no) | 收发器是否在笼子里 |
| sfp-rx-lose(yes | no) | Whether a receiver signal is lost |
| sfp-tx-fault(yes | no) | Whether a transceiver transmitter is in fault state |
| sfp-type(SFP-or-SFP+ | DWDM-SFP | QSFP+) | Used transceiver type |
| sfp-connector-type(SC | LC | optical-pigtail | copper-pigtail | multifiber-parallel-optic-1x12 | no-separable-connector | RJ45) | Used transceiver connector type |
| sfp-link-length-9um(m) | Transceiver supported link length for single mode 9/125um fiber |
| sfp-link-length-50um(m) | Transceiver supported link length for multi mode 50/125um fiber (OM2) |
| sfp-link-length-62um(m) | Transceiver supported link length for multi mode 62.5/125um fiber (OM1) |
| sfp-link-length-copper(m) | Supported link length of copper transceiver |
| sfp-vendor-name(string) | Transceiver manufacturer |
| sfp-vendor-part-number(string) | Transceiver part number |
| sfp-vendor-revision(string) | Transceiver revision number |
| sfp-vendor-serial(string) | Transceiver serial number |
| sfp-manufacturing-date(date) | Transceiver manufacturing date |
| sfp-wavelength(nm) | Transceiver transmitter optical signal wavelength |
| sfp-temperature(C) | Transceiver temperature |
| sfp-supply-voltage(V) | Transceiver supply voltage |
| sfp-tx-bias-current(mA) | Transceiver Tx bias current |
| sfp-tx-power(dBm) | Transceiver transmitted optical power |
| sfp-rx-power(dBm) | Transceiver received optical power |
| eeprom-checksum(good | bad) | Whether EEPROM checksum is correct |
| eeprom(hex dump) | Raw EEPROM of the transceiver |
Example output of an Ethernet status:
[admin@MikroTik] > /interface ethernet monitor ether1 name: ether1 status: link-ok auto-negotiation: done rate: 1Gbps full-duplex: yes tx-flow-control: no rx-flow-control: no advertising: 10M-half,10M-full,100M-half,100M-full,1000M-half,1000M-full link-partner-advertising: 10M-half,10M-full,100M-half,100M-full,1000M-full
Example output of an SFP status:
[admin@MikroTik] > /interface ethernet monitor sfp-sfpplus24 name: sfp-sfpplus24 status: link-ok auto-negotiation: done rate: 10Gbps full-duplex: yes tx-flow-control: no rx-flow-control: no advertising: link-partner-advertising: sfp-module-present: yes sfp-rx-loss: no sfp-tx-fault: no sfp-type: SFP-or-SFP+ sfp-connector-type: LC sfp-link-length-50um: 80m sfp-link-length-62um: 30m sfp-vendor-name: Mikrotik sfp-vendor-part-number: S+85DLC03D sfp-vendor-revision: A sfp-vendor-serial: STST85S84700155 sfp-manufacturing-date: 18-12-07 sfp-wavelength: 850nm sfp-temperature: 33C sfp-supply-voltage: 3.251V sfp-tx-bias-current: 6mA sfp-tx-power: -2.843dBm sfp-rx-power: -1.203dBm eeprom-checksum: good eeprom: 0000: 03 04 07 10 00 00 00 20 40 0c c0 06 67 00 00 00 ....... @...g... 0010: 08 03 00 1e 4d 69 6b 72 6f 74 69 6b 20 20 20 20 ....Mikr otik 0020: 20 20 20 20 00 00 00 00 53 2b 38 35 44 4c 43 30 .... S+85DLC0 0030: 33 44 20 20 20 20 20 20 41 20 20 20 03 52 00 45 3D A .R.E 0040: 00 1a 00 00 53 54 53 54 38 35 53 38 34 37 30 30 ....STST 85S84700 0050: 31 35 35 20 31 38 31 32 30 37 20 20 68 f0 05 b6 155 1812 07 h... 0060: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ........ ........ 0070: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ........ ........ 0080: 64 00 d8 00 5f 00 dd 00 8c a0 6d 60 88 b8 71 48 d..._... ..m`..qH 0090: 1d 4c 00 fa 17 70 01 f4 31 2d 04 ea 27 10 06 30 .L...p.. 1-..'..0 00a0: 31 2d 01 3c 27 10 01 8e 00 00 00 00 00 00 00 00 1-.<'... ........ 00b0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ........ ........ 00c0: 00 00 00 00 3f 80 00 00 00 00 00 00 01 00 00 00 ....?... ........ 00d0: 01 00 00 00 01 00 00 00 01 00 00 00 00 00 00 26 ........ .......& 00e0: 21 8a 7f 00 0c cd 14 4c 1d 9c 00 00 00 00 00 00 !......L ........ 00f0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ........ ........
Detect Cable Problems
A 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 show:
- 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 an 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, the cable is not shorted but “open” at 4 meters distance, all cable pairs are equally faulty at the same distance from the switch chip.
Currentlycable-testis 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
Currentlycable-testis not supported on Combo ports.
Stats
Using/interface ethernet print statscommand, it is possible to see a wide range of Ethernet-related statistics. The list of statistics can differ between RouterBoard devices due to different Ethernet drivers. The list below contains all available counters across all RouterBoard devices. Most of the Ethernet statistics can be remotely monitored usingSNMPand MIKROTIK-MIB.
| Property | Description |
|---|---|
| driver-rx-byte(integer) | Total count of received bytes on device CPU |
| driver-rx-packet(integer) | Total count of received packets on device CPU |
| driver-tx-byte(integer) | tr的总数量ansmitted bytes by device CPU |
| driver-tx-packet(integer) | tr的总数量ansmitted packets by device CPU |
| rx-64(integer) | Total count of received 64 byte frames |
| rx-65-127(integer) | Total count of received 65 to 127 byte frames |
| rx-128-255(integer) | 收到的总数量128 - 255 byte frames |
| rx-256-511(integer) | Total count of received 256 to 511 byte frames |
| rx-512-1023(integer) | Total count of received 512 to 1023 byte frames |
| rx-1024-1518(integer) | Total count of received 1024 to 1518 byte frames |
| rx-1519-max(integer) | Total count of received frames larger than 1519 bytes |
| rx-align-error(integer) | Total count of received align error events - packets where bits are not aligned along octet boundaries |
| rx-broadcast(integer) | Total count of received broadcast frames |
| rx-bytes(integer) | Total count of received bytes |
| rx-carrier-error(integer) | Total count of received frames with carrier sense error |
| rx-code-error(integer) | Total count of received frames with code error |
| rx-control(integer) | Total count of received control or pause frames |
| rx-error-events(integer) | Total count of received frames with the active error event |
| rx-fcs-error(integer) | Total count of received frames with incorrect checksum |
| rx-fragment(integer) | Total count of received fragmented frames (not related to IP fragmentation) |
| rx-ip-header-checksum-error(integer) | Total count of received frames with IP header checksum error |
| rx-jabber(integer) | Total count of received jabbed packets - a packet that is transmitted longer than the maximum packet length |
| rx-length-error(integer) | Total count of received frames with frame length error |
| rx-multicast(integer) | Total count of received multicast frames |
| rx-overflow(integer) | Total count of received overflowed frames can be caused when device resources are insufficient to receive a certain frame |
| rx-pause(integer) | Total count of received pause frames |
| rx-runt(integer) | Total count of received frames shorter than the minimum 64 bytes, is usually caused by collisions |
| rx-tcp-checksum-error(integer) | Total count of received frames with TCP header checksum error |
| rx-too-long(integer) | Total count of received frames that were larger than the maximum supported frame size by the network device, see themax-l2mtuproperty |
| rx-too-short(integer) | Total count of the received frame shorter than the minimum 64 bytes |
| rx-udp-checksum-error(integer) | Total count of received frames with UDP header checksum error |
| rx-unicast(integer) | Total count of received unicast frames |
| rx-unknown-op(integer) | Total count of received frames with unknown Ethernet protocol |
| tx-64(integer) | tr的总数量ansmitted 64 byte frames |
| tx-65-127(integer) | tr的总数量ansmitted 65 to 127 byte frames |
| tx-128-255(integer) | tr的总数量ansmitted 128 to 255 byte frames |
| tx-256-511(integer) | tr的总数量ansmitted 256 to 511 byte frames |
| tx-512-1023(integer) | tr的总数量ansmitted 512 to 1023 byte frames |
| tx-1024-1518(integer) | tr的总数量ansmitted 1024 to 1518 byte frames |
| tx-1519-max(integer) | tr的总数量ansmitted frames larger than 1519 bytes |
| tx-align-error(integer) | tr的总数量ansmitted align error events - packets where bits are not aligned along octet boundaries |
| tx-broadcast(integer) | tr的总数量ansmitted broadcast frames |
| tx-bytes(integer) | tr的总数量ansmitted bytes |
| tx-collision(integer) | tr的总数量ansmitted frames that made collisions |
| tx-control(integer) | tr的总数量ansmitted control or pause frames |
| tx-deferred(integer) | tr的总数量ansmitted frames that were delayed on its first transmit attempt due to already busy medium |
| tx-drop(integer) | tr的总数量ansmitted frames that were dropped due to the already full output queue |
| tx-excessive-collision(integer) | tr的总数量ansmitted frames that already made multiple collisions and never got successfully transmitted |
| tx-excessive-deferred(integer) | tr的总数量ansmitted frames that were deferred for an excessive period of time due to an already busy medium |
| tx-fcs-error(integer) | tr的总数量ansmitted frames with incorrect checksum |
| tx-fragment(integer) | tr的总数量ansmitted fragmented frames (not related to IP fragmentation) |
| tx-carrier-sense-error(integer) | tr的总数量ansmitted frames with carrier sense error |
| tx-late-collision(integer) | tr的总数量ansmitted frames that made collision after being already halfway transmitted |
| tx-multicast(integer) | tr的总数量ansmitted multicast frames |
| tx-multiple-collision(integer) | tr的总数量ansmitted frames that made more than one collision and subsequently transmitted successfully |
| tx-overflow(integer) | tr的总数量ansmitted overflowed frames |
| tx-pause(integer) | 总菌数的传输暂停帧 |
| tx-all-queue-drop-byte(integer) | tr的总数量ansmitted bytes dropped by all output queues |
| tx-all-queue-drop-packet(integer) | tr的总数量ansmitted packets dropped by all output queues |
| tx-queueX-byte(integer) | tr的总数量ansmitted bytes on a certain queue, theXshould be replaced with a queue number |
| tx-queueX-packet(integer) | tr的总数量ansmitted frames on a certain queue, theXshould be replaced with a queue number |
| tx-runt(integer) | tr的总数量ansmitted frames shorter than the minimum 64 bytes, is usually caused by collisions |
| tx-too-short(integer) | tr的总数量ansmitted frames shorter than the minimum 64 bytes |
| tx-rx-64(integer) | tr的总数量ansmitted and received 64 byte frames |
| tx-rx-64-127(integer) | tr的总数量ansmitted and received 64 to 127 byte frames |
| tx-rx-128-255(integer) | tr的总数量ansmitted and received 128 to 255 byte frames |
| tx-rx-256-511(integer) | tr的总数量ansmitted and received 256 to 511 byte frames |
| tx-rx-512-1023(integer) | tr的总数量ansmitted and received 512 to 1023 byte frames |
| tx-rx-1024-max(integer) | tr的总数量ansmitted and received frames larger than 1024 bytes |
| tx-single-collision(integer) | tr的总数量ansmitted frames that made only a single collision and subsequently transmitted successfully |
| tx-too-long(integer) | tr的总数量ansmitted packets that were larger than the maximum packet size |
| tx-underrun(integer) | tr的总数量ansmitted underrun packets |
| tx-unicast(integer) | tr的总数量ansmitted unicast frames |
For example, the output of Ethernet stats on the hAP ac2 device:
[admin@MikroTik] > /interface ethernet print stats name: ether1 ether2 ether3 ether4 ether5 driver-rx-byte: 182 334 805 898 0 5 836 927 820 24 895 692 0 driver-rx-packet: 4 449 562 546 0 4 320 155 362 259 449 0 driver-tx-byte: 15 881 099 971 0 70 502 669 211 60 498 056 53 driver-tx-packet: 52 724 428 0 54 231 229 106 498 1 rx-bytes: 178 663 398 808 0 5 983 590 739 1 358 140 795 0 rx-too-short: 0 0 0 0 0 rx-64: 12 749 144 0 362 459 125 917 0 rx-65-127: 9 612 406 0 20 366 513 292 189 0 rx-128-255: 6 259 883 0 1 672 588 261 013 0 rx-256-511: 2 950 578 0 211 380 278 147 0 rx-512-1023: 3 992 258 0 185 666 163 241 0 rx-1024-1518: 119 034 611 0 2 796 559 696 254 0 rx-1519-max: 0 0 0 0 0 rx-too-long: 0 0 0 0 0 rx-broadcast: 12 025 189 0 1 006 377 64 178 0 rx-pause: 0 0 0 0 0 rx-multicast: 4 687 869 0 36 188 220 136 0 rx-fcs-error: 0 0 0 0 0 rx-align-error: 0 0 0 0 0 rx-fragment: 0 0 0 0 0 rx-overflow: 0 0 0 0 0 tx-bytes: 16 098 535 973 0 72 066 425 886 225 001 772 0 tx-64: 1 063 375 0 924 855 37 877 0 tx-65-127: 26 924 514 0 2 442 200 959 209 0 tx-128-255: 14 588 113 0 924 746 295 961 0 tx-256-511: 1 323 733 0 1 036 515 33 252 0 tx-512-1023: 1 287 464 0 2 281 554 3 625 0 tx-1024-1518: 7 537 154 0 48 212 304 64 659 0 tx-1519-max: 0 0 0 0 0 tx-too-long: 0 0 0 0 0 tx-broadcast: 590 0 145 800 823 038 0 tx-pause: 0 0 0 0 0 tx-multicast: 0 0 1 039 243 41 716 0 tx-underrun: 0 0 0 0 0 tx-collision: 0 0 0 0 0 tx-excessive-collision: 0 0 0 0 0 tx-multiple-collision: 0 0 0 0 0 tx-single-collision: 0 0 0 0 0 tx-excessive-deferred: 0 0 0 0 0 tx-deferred: 0 0 0 0 0 tx-late-collision: 0 0 0 0 0
Overview
Content Tools