Source code dump for easier access. This work is not my own.

Linux device driver for Realtek Ethernet controllers

This is the Linux device driver released for RealTek RTL8125 2.5Gigabit Ethernet controllers with PCI-Express interface.

Requirements

- Kernel source tree (supported Linux kernel 2.6.x and 2.4.x)
- For linux kernel 2.4.x, this driver supports 2.4.20 and latter.
- Compiler/binutils for kernel compilation

Quick install with proper kernel settings

Unpack the tarball :
	# tar vjxf r8125-8.aaa.bb.tar.bz2

Change to the directory:
	# cd r8125-8.aaa.bb

If you are running the target kernel, then you should be able to do :

	# ./autorun.sh	(as root or with sudo)

You can check whether the driver is loaded by using following commands.

	# lsmod | grep r8125
	# ifconfig -a

If there is a device name, ethX, shown on the monitor, the linux
driver is loaded. Then, you can use the following command to activate
the ethX.

	# ifconfig ethX up

	,where X=0,1,2,...

Set the network related information

1. Set manually
	a. Set the IP address of your machine.

		# ifconfig ethX "the IP address of your machine"

	b. Set the IP address of DNS.

	   Insert the following configuration in /etc/resolv.conf.

		nameserver "the IP address of DNS"

	c. Set the IP address of gateway.

		# route add default gw "the IP address of gateway"

2. Set by doing configurations in /etc/sysconfig/network-scripts
   /ifcfg-ethX for Redhat and Fedora, or /etc/sysconfig/network
   /ifcfg-ethX for SuSE. There are two examples to set network
   configurations.

	a. Fixed IP address:
		DEVICE=eth0
		BOOTPROTO=static
		ONBOOT=yes
		TYPE=ethernet
		NETMASK=255.255.255.0
		IPADDR=192.168.1.1
		GATEWAY=192.168.1.254
		BROADCAST=192.168.1.255

	b. DHCP:
		DEVICE=eth0
		BOOTPROTO=dhcp
		ONBOOT=yes

Modify the MAC address

There are two ways to modify the MAC address of the NIC.
1. Use ifconfig:

	# ifconfig ethX hw ether YY:YY:YY:YY:YY:YY

   ,where X is the device number assigned by Linux kernel, and
	  YY:YY:YY:YY:YY:YY is the MAC address assigned by the user.

2. Use ip:

	# ip link set ethX address YY:YY:YY:YY:YY:YY

   ,where X is the device number assigned by Linux kernel, and
	  YY:YY:YY:YY:YY:YY is the MAC address assigned by the user.

Force Link Status

1. Force the link status when insert the driver.

   If the user is in the path ~/r8125, the link status can be forced
   to one of the 5 modes as following command.

	# insmod ./src/r8125.ko speed=SPEED_MODE duplex=DUPLEX_MODE autoneg=NWAY_OPTION

	,where
		SPEED_MODE	= 1000	for 1000Mbps
				= 100	for 100Mbps
				= 10	for 10Mbps
		DUPLEX_MODE	= 0	for half-duplex
				= 1	for full-duplex
		NWAY_OPTION	= 0	for auto-negotiation off (true force)
				= 1	for auto-negotiation on (nway force)
	For example:

		# insmod ./src/r8125.ko speed=100 duplex=0 autoneg=1

	will force PHY to operate in 100Mpbs Half-duplex(nway force).

2. Force the link status by using ethtool.
	a. Insert the driver first.
	b. Make sure that ethtool exists in /sbin.
	c. Force the link status as the following command.

		# ethtool -s ethX speed SPEED_MODE duplex DUPLEX_MODE autoneg NWAY_OPTION

		,where
			SPEED_MODE	= 1000	for 1000Mbps
					= 100	for 100Mbps
					= 10	for 10Mbps
			DUPLEX_MODE	= half	for half-duplex
					= full	for full-duplex
			NWAY_OPTION	= off	for auto-negotiation off (true force)
					= on	for auto-negotiation on (nway force)

	For example:

		# ethtool -s eth0 speed 100 duplex full autoneg on

	will force PHY to operate in 100Mpbs Full-duplex(nway force).

Jumbo Frame

Transmitting Jumbo Frames, whose packet size is bigger than 1500 bytes, please change mtu by the following command.

# ifconfig ethX mtu MTU

, where X=0,1,2,..., and MTU is configured by user.

RTL8125 supports Jumbo Frame size up to 9 kBytes.