Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info
titleNotes

The first number followed by M or G (e.g. 10M, 100M, 1G) represent the data transmission rates.

The symbols after "base" indicate the interface types. The T stands for twisted pair followed by duplex mode (either half or full). The SR-LR is shorthand for "short-range" and "long-range" optical modules, it also includes all other variants like LRM, ER, ZR, etc. These link modes should be used with optical modules. The CR stands for twinaxial copper and should be used with direct attach cable (DAC). For 1Gbps DAC the 1G-baseT-fullbaseX link mode is appropriate.

The last digit represent the number of lines, with "CR2" meaning two lines and "CR4" indicating four lines.

The CCR2004-1G-2XS-PCIe device does not support fec91 on SFP28 interfaces.

...

Code Block
languageros
/interface ethernet
set [ find default-name=qsfp28-1-1 ] advertise=50G-baseCR2
set [ find default-name=qsfp28-1-3 ] advertise=25G-baseCR
set [ find default-name=qsfp28-1-4 ] advertise=25G-baseCR

Properties

Sub-menu: /interface ethernet

This section describes the Ethernet interface configuration options.

In the situation when a warning message appears in the log records after connecting the DAC cable or optical module, as example:

Code Block
languageros
10:20:47 interface,warning sfp-sfpplus1 module auto-initialization failed, try forced-mode

This may indicate that the connected cable or module has a corrupted or bad EEPROM checksum, which causes the automatic connection configuration to fail. This functionality was introduced in RouterOS version 7.12 and may affect some links that worked in the past by mistake with wrongly assumed module/cable attributes, which could lead to various problems related to link connection and device functionality.

In such cases, you can attempt to set the link mode manually, and this might help establish a working link. The following forced port setting examples are provided:

  • For DAC cables and connection speeds of 1G/10G/25G:
Code Block
languageros
/interface ethernet
set [ find default-name=sfp-sfpplus1 ] auto-negotiation=no speed=1G-baseT-full
set [ find default-name=sfp-sfpplus1 ] auto-negotiation=no speed=10G-baseCR
set [ find default-name=sfp-sfpplus1 ] auto-negotiation=no speed=25G-baseCR
Info

Note: When selecting the interface speed setting, pay attention to what rates your DAC cable supports (check cable specification data)

  • For optical modules and connection speeds of 1G/10G/25G:
Code Block
languageros
/interface ethernet
set [ find default-name=sfp-sfpplus1 ] auto-negotiation=no speed=1G-baseX
set [ find default-name=sfp-sfpplus1 ] auto-negotiation=no speed=10G-baseSR-LR
set [ find default-name=sfp-sfpplus1 ] auto-negotiation=no speed=25G-baseSR-LR
Info

Note: When selecting the interface speed setting, pay attention to what rates your optical module supports (check module specification data)

Properties

Sub-menu: /interface ethernet

This section describes the Ethernet interface configuration options.

PropertyDescription

advertise(since RouterOS v7.12: 

PropertyDescription

advertise(since RouterOS v7.12: 10M-baseT-half | 10M-baseT-full| 100M-baseT-half | 100M-baseT-full | 1G-baseT-half | 1G-baseT-full | 1G-baseX | 2.5G-baseT | 2.5G-baseX | 5G-baseT | 10G-baseT | 10G-baseSR-LR | 10G-baseCR | 40G-baseSR4-LR4 | 40G-baseCR4 | 25G-baseSR-LR | 25G-baseCR | 50G-baseSR2-LR2 | 50G-baseCR2 | 100G-baseSR4-LR4 | 100G-baseCR4; Default: )

(older RouterOS: 10M-full | 10M-half | 100M-full | 100M-half | 1000M-full | 1000M-half | 2500M-full | 5000M-full | 10000M-full; Default: )

Advertised link modes, only applies when auto-negotiation is enabled. Advertising higher speeds than the actual interface supported speed can result in undefined behavior. Multiple options are allowed.
arp (disabled | enabled | local-proxy-arp | proxy-arp | reply-only; Default: enabled)Address Resolution Protocol mode:
  • disabled - the interface will not use ARP
  • enabled - the interface will use ARP
  • local-proxy-arp - the router performs proxy ARP on the interface and sends replies to the same interface
  • proxy-arp - the router performs proxy ARP on the interface and sends replies to other interfaces
  • 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.
arp-timeout (auto | integer; Default: auto)How long the ARP record is kept in the ARP table after no packets are received from IP. Value auto equals to the value of arp-timeout in IP/Settings, default is 30s.
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 Ethernet and NBASE-T Ethernet links 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)
combo-mode (auto | copper | sfp; Default: auto)When auto mode is selected, the port that was first connected will establish the link. In case this link fails, the other port will try to establish a new link. In case of a reboot, any of the two ports can be running, it depends on which port will successfully establish the link first. When sfp mode is selected, the interface will only work through SFP/SFP+ cage. When copper mode 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. (relevant only applicable to CHR and x86)
fec-mode (auto | fec74 | fec91 | off; Default: auto)

Changes Forward Error Correction (FEC) mode for SFP28, QSFP+ and QSFP28 interfaces. Same mode should be used on both link ends, otherwise FEC mismatch could result in non-working link or even false link-ups. 

It is recommended to enable FEC, particularly when creating link between CRS3xx, CRS5xx series switches. Some optical modules might rely on FEC functionality in MACs.

  • auto - same as off
  • fec74 - enables IEEE 802.3 clause 74 FEC (aka FC-FEC), can be used with 25Gbps, 40Gbps and 50Gbps link modes
  • fec91 - enables IEEE 802.3 clause 91 FEC (aka RS-FEC), can be used with 25Gbps, 50Gbps and 100Gbps link modes
  • off - disabled FEC.
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. auto is the same as on except 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. auto is the same as on except 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 when auto-negotiation is disabled. Since RouterOS v7.12, the setting is replaced with new speed link modes.
l2mtu (integer [0..65536]; Default: )Layer2 Maximum transmission unit. Read more.
mac-address (MAC; Default: )Media Access Control number of an interface.
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: )Original Media Access Control number of an interface.
passthrough-interface (interface; Default: )Sets an interface in passthrough mode on CCR2004-1G-2XS-PCIe device. By default, the PCIe interface will show up as four virtual Ethernet interfaces. Two interfaces in passthrough mode to the 25G SFP28 cages. The remaining two virtual Ethernet-PCIe interfaces are bridged with the Gigabit Ethernet port for management access.
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: 9580)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).
sfp-rate-select (high | low; Default: high)Allows to control rate select pin for SFP ports.

speed (since RouterOS v7.12: 10M-baseT-half | 10M-baseT-full| 100M-baseT-half | 100M-baseT-full | 1G-baseT-half | 1G-baseT-full | 1G-baseX | 2.5G-baseT | 2.5G-baseX | 5G-baseT | 10G-baseT | 10G-baseSR-LR | 10G-baseCR | 40G-baseSR4-LR4 | 40G-baseCR4 | 25G-baseSR-LR | 25G-baseCR | 50G-baseSR2-LR2 | 50G-baseCR2 | 100G-baseSR4-LR4 | 100G-baseCR4; Default: )

(older RouterOS: 10Mbps | 10Gbps | 100Mbps | 1Gbps | 2.5Gbps | 5Gbps | 25Gbps | 40Gbps | 100Gbps; Default: )

Sets interface data transmission speed which takes effect only when auto-negotiation is disabled. Setting higher speeds than the actual interface supported speed can result in undefined behavior. Single option is allowed.

...