summaryrefslogtreecommitdiff
path: root/freebsd/rtl_bsd_drv_v197.00/Readme.txt
blob: 6332a56482ffff79bfa5bdc050268735a65e1303 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
=================================================================================
=  Realtek 8169S/8169SB/8169SC/8168B/8168C/8168CP/8168D/8168DP/8168E/8168F      =
=  8168FB/8168G/818GU/8168H/8168EP/8411/8168FP                                  =
=  8101E/8102E/8103E/8401/8105E/8106E/8402                                      =
=  8125 Driver                                                                  =
=  for FreeBSD v4.x/5.x/6.x/7.x/8.x/9.x/10.x/11.x//12.x/13.x                    =
=================================================================================

This driver is modified by Realtek Semiconductor corp. and it has been tested OK
on FreeBSD v5.4, FreeBSD v6.4, FreeBSD v7.3, FreeBSD v8.0, and FreeBSD v9.0. To
update the driver, you may use method 1. If method 1 failed, you must use method 2
which is more complex.

Method 1:
	1.Copy if_re.ko in "modules" directory to "/modules" directory and overwrite
	  the existing file.
	2.Modify the file "/boot/defaults/loader.conf" and set "if_re_load" in "Network
	  drivers" section to "Yes"
	3.Reboot.

Method 2:
	Because the FreeBSD kernel has default drivers to support RTL8139C and RTL8169S. To use the RTL8139C+, RTL8169SB, RTL8169SC, RTL8168B, and RTL8101E, you need to update your NIC driver by recompiling your FreeBSD kernel.

	The main steps you have to do:(FreeBSDSrcDir means the directory of FreeBSD source code
	and it may be "/usr/src/sys")

		1. keep the orginal driver source code:
			# cd /usr/src/sys/dev/re
			# cp if_re.c if_re.c.org

			# cd /usr/src/sys/modules
			# cp Makefile Makefile.org

			# cd /usr/src/sys/modules/re
			# cp Makefile Makefile.org

			# cd /usr/src/sys/i386/conf/
			# cp GENERIC GENERIC.org

		2. recompile your kernel (you must install your FreeBSD source code first !!)
			# vim /usr/src/sys/i386/conf/GENERIC and delete re
			# vim /usr/src/sys/modules/Makefile and delete re
			# cd /usr/src/sys/i386/conf
			# /usr/sbin/config GENERIC

			(for FreeBSD 5.x/6.x/7.x/8.x/9.x)
			# cd ../compile/GENERIC
			(for FreeBSD 4.x)
			# cd ../../compile/GENERIC

			# make clean
			# make depend
			# make
			# make install
			# reboot

		3. update the driver source code:
		    Copy the driver source code( if_re.c and if_rereg.h) into /usr/src/sys/dev/re
		    Copy the Makefile into /usr/src/sys/modules/re

		4. build the driver:
			# cd /usr/src/sys/modules/re
			# make clean
			# make

		5. install the driver
			(for FreeBSD 12 or later)
			# cd /usr/obj/usr/src/<arch>.<arch>/sys/modules
			# kldload ./if_re.ko
			(for FreeBSD 11 or earlier)
			# cd /usr/src/sys/modules/re

			# kldload ./if_re.ko

		6. configurate the static IP address
			# ifconfig re0 xxx.xxx.xxx.xxx

		7. configurate the IP address by DHCP
			# /sbin/dhclient re0

The user can use the following command to change link speed and duplexmode.
	1. For auto negotiation,
		#ifconfig re<device_num> media autoselect

	2. For 1000Mbps full-duplex,
		#ifconfig re<device_num> media 1000baseTX mediaopt full-duplex

	3. For 100Mbps full-duplex,
		#ifconfig re<device_num> media 100baseTX mediaopt full-duplex

	4. For 100Mbps half-duplex,
		#ifconfig re<device_num> media 100baseTX -mediaopt full-duplex

	5. For 10Mbps full-duplex,
		#ifconfig re<device_num> media 10baseT/UTP mediaopt full-duplex

	6. For 10Mbps half-duplex,
		#ifconfig re<device_num> media 10baseT/UTP -mediaopt full-duplex