Manual:Interface/Ethernet: Difference between revisions
Jump to navigation
Jump to search
| Line 271: | Line 271: | ||
'''Properties:''' | '''Properties:''' | ||
{{Mr-arg-table-h | |||
|prop=Property | |||
|desc=Description | |||
}} | |||
{{Mr-arg-ro-table | |||
|arg=auto-negotiation | |||
|type=done {{!}} incomplete | |||
|desc=Current auto negotiation status: | |||
* <var>done</var>-negotiation completed | |||
* <var>incomplete</var>-negotiation failed or not yet completed | |||
}} | |||
</table> | {{Mr-arg-ro-table | ||
|arg=default-cable-settings | |||
|type=short {{!}} standard | |||
|desc=Default cable length setting (only applicable to NS DP83815/6 cards) | |||
* <var>short</var>-support short cables | |||
* <var>standard</var>-support standard cables | |||
}} | |||
{{Mr-arg-ro-table | |||
|arg=full-duplex | |||
|type=yes {{!}} no | |||
|desc=Whether transmission of data occurs in two directions simultaneously | |||
}} | |||
{{Mr-arg-ro-table | |||
|arg=rate | |||
|type=10Mbps {{!}} 100Mbps {{!}} 1Gbps | |||
|desc=Actual data rate of the connection. | |||
}} | |||
{{Mr-arg-ro-table | |||
|arg=status | |||
|type=link-ok {{!}} no-link {{!}} unknown | |||
|desc=Current link status of an interface | |||
* <var>link-ok</var>-the card is 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) | |||
}} | |||
{{Mr-arg-ro-table | |||
|arg=phy-regs | |||
|type= | |||
|desc=List of Ethernet PHY registers | |||
}} | |||
{{Mr-arg-ro-table-end | |||
|arg=cable-pairs | |||
|type=string | |||
|desc=Shows detected problems with cable pairs. [[#Detect Cable Problems | <code>Read More >></code>]] | |||
}} | |||
Revision as of 10:12, 14 November 2012
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. |
| 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. |
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 |
| cable-pairs (string) | Shows detected problems with cable pairs. Read More >> |
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 v5.21 and newer releases there is ability to detect cable problems. 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, 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 monitor ether5
status: no-link
auto-negotiation: done
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 ]