set ethernet

Purpose

Configures, adjusts, and displays Ethernet communications options.

Required permissions

For Digi products with two or more users, permissions must be set to set permissions s-ethernet=read to display Ethernet communications options, and set permissions s‑ethernet=rw to display and configure Ethernet communications options. See set permissions for details on setting user permissions for commands.

Syntax

Configure Ethernet communications options

set ethernet [interface=interface name]
  [speed={auto|10|100}] 
  [duplex={auto|half|full}]
  [mdimode={auto|mdi|mdix}]

Display Ethernet communications options

set ethernet

Options

interface=interface name

The name of the Ethernet network interface being configured, such as eth0, eth0_1, and so on.

speed={auto|10|100}

Configures the Ethernet speed the Digi device will use on the Ethernet network. Specify an appropriate setting for your Ethernet network, which can be one of the following:

auto

The device senses the Ethernet speed of the network and adjusts automatically.

10

The device operates at 10 megabits per second (Mbps) only.

100

The device operates at 100 Mbps only.

The default is auto.

If one side of the Ethernet connection is using auto (negotiating), the other side can set the Ethernet speed to whatever value is desired. Or, if the other side is set for 100 Mbps, this side must use 100 Mbps.

duplex={auto|half|full}

The mode the Digi device uses to communicate on the Ethernet network. Specify one of the following:

half

The device communicates in half-duplex mode.

full

The device communicates in full-duplex mode.

auto

The device senses the mode used on the network and adjusts automatically.

The default is half.

If one side of the Ethernet connection is using auto, the other side can set the duplex value to whatever is desired. If one side uses a fixed value (for example, half-duplex), the other side has to use the same.

mdimode={auto|mdi|mdix}

The connection mode for the Ethernet cable.

auto

Enables Auto-MDIX mode, where the required cable connection type (straight through or crossover) is automatically detected. The connection is configured appropriately without the need for crossover cables to interconnect switches or connecting PCs peer-to-peer. When it is enabled, either type of cable can be used and the interface automatically corrects any incorrect cabling. For this automatic detection to operate correctly, the speed and duplex options must both be set to auto.

mdi

The connection is wired as a Media Dependent Interface (MDI), the standard wiring for end stations.

mdix

The connection is wired as a Media Dependent Interface with Crossover (MDIX), the standard wiring for hubs and switches.

Examples

Configure 100 Mbps Ethernet speed

#> set ethernet speed=100

See also