Manual:Interface/Ethernet
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 |
| auto-negotiation (yes | no; Default: yes) | When enabled, the interface "advertises" its maximum capabilities to achieve the best connection possible. Note: Auto-negotiation must be disabled on both ends, otherwise Ethernets may not work properly. Note2: Gigabit link cannot work with auto-negotiation disabled. |
| bandwidth (integer/integer; Default: unlimited/unlimited) | Sets max rx/tx bandwidth that will be handled by an interface. |
| cable-setting (default | short | standard; Default: default) | changes the cable length setting (only applicable to NS DP83815/6 cards) |
| 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. By default value is 'yes' because older NICs does not support it. (only applicable to x86) |
| full-duplex (yes | no; Default: yes) | Defines whether the transmission of data appears in two directions simultaneously |
| l2mtu (integer; Default: ) | Layer2 Maximum transmission unit. Read more>> |
| mac-address (MAC; Default: ) | Media Access Control number of an interface. |
| master-port (name | none; Default: none) | Sets switch group master interface |
| mdix-enable (yes | no; Default: ) | Whether the MDI/X auto crosscable correction feature is enabled for the port |
| mtu (integer; Default: 1500) | Layer3 Maximum transmission unit |
| name (string; Default: ) | Name of an interface |
| speed (10Mbps | 100Mbps | 1Gbps; Default: max available) | Sets the data transmission speed of the interface. By default, this value is the maximal data rate supported by the interface |
| poe-out (auto-on | forced-on | off; Default: off) | Poe Out settings. Read more >> |
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) | |
| rx-pause (integer) | Amount of received pause frames |
| rx-runt (integer) | Amount of received frames shorter than the minimum 64 bytes but with a valid CRC |
| rx-too-long (integer) | |
| 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) | |
| tx-128-255 (integer) | |
| tx-1519-max (integer) | |
| tx-256-511 (integer) | |
| tx-512-1023 (integer) | |
| tx-64 (integer) | |
| tx-65-127 (integer) | |
| tx-align-error (integer) | |
| tx-broadcast (integer) | |
| tx-bytes (integer) | |
| tx-fcs-error (integer) | |
| tx-fragment (integer) | |
| tx-multicast (integer) | |
| tx-overflow (integer) | |
| tx-pause (integer) | |
| tx-runt (integer) | |
| tx-too-long (integer) |
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 ([id, name]) | Reset MAC address to manufacturers default. |
| cable-pairs (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:
|
| 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 |
| rate (10Mbps | 100Mbps | 1Gbps) | Actual data rate of the connection. |
| status (link-ok | no-link | unknown) | Current link status of an interface
|
| phy-regs () | List of Ethernet PHY registers |
Example output of ethernet status:
[admin@MikroTik] /interface ethernet> monitor ether1
status: link-ok
auto-negotiation: done
rate: 1Gbps
full-duplex: yes
Detect Cable Problems
In RouterOS v6rc4 and newer releases there is ability to see if there are any problems with connected cables. Cable test can detect problems or measure the cable length only if cable is unplugged on the other end and there is "no-link". RouterOS will tell:
- which cable pair is damaged
- at what length is the cable broken
- how is the cable broken - shorted or torn
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, SXT Lite, RB711G, RB2011, RB750 series and other devices with the same switch chips, and also the Cloud Core series devices.
Here is example output:
[admin@CCR] > interface ethernet cable-test ether1
name: ether1
status: no-link
cable-pairs: open:4,open:4,open:4,open:4
In the above example, cable is not shorted but cut “open” at 4 meters length, all cable pairs equally at same location.
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 to configure certain RouterBoard switch chip feature. 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 ]