ThinkWiki - User contributions [en]

Ethernet Controllers

2008-04-25T20:25:44Z

Unaimed: /* Intel Gigabit (10/100/1000) */

== Internal Ethernet controller ==

A variety of [[Ethernet]] controllers is integrated into almost all models starting with the introduction of the A, T and X series.

The Ethernet controller is located on either a MiniPCI card, Communications Daughter Card (CDC), or integrated on the systemboard.

=== 3COM Fast Ethernet (10/100) ===
MiniPCI cards featuring this chip:
*[[3Com 10/100 Ethernet Mini-PCI Adapter with 56K Modem]]

=== Intel Fast Ethernet (10/100) ===
CDC and MiniPCI cards featuring this chip:
*[[Ethernet Daughter Card (EDC)]]
*[[Intel 10/100 Ethernet Mini-PCI Adapter with 56K Modem]]
*[[Intel PRO/100 SP Mobile Combo Adapter]]
*[[Mini-PCI Ethernet card]]
*[[Xircom 10/100 EtherJet Mini PCI Adapter with 56K Modem]]

In addition, this chip is integrated into select systemboards of the following machines: 
'''Intel 82550GY'''
* {{R30}}
'''Intel 82558'''
* [[SelectaBase PC Card Enabler with Advanced EtherJet]]
* [[ThinkPad Port Replicator with Advanced EtherJet]]
'''Intel 82562ET'''
* {{R31}}, {{R32}}
* {{T30}}
* {{X30}}
'''Intel 82562EZ'''
* {{R40}}, {{R50e}}, {{R50}}, {{R51}}
* {{T40}}
* {{X31}}

Driver: [[e100]] (The 'e100' driver is the suggested driver, but '[[eepro100]]' should also work.)

=== Intel Gigabit (10/100/1000) ===
Chipset: Intel PRO/1000 MT Mobile Ethernet 
Driver: [[e1000]]

This chip is integrated into select systemboards of the following machines: 
'''Intel 82540EP'''
* {{R50}}, {{R50p}}, {{R51}}
* {{T40}}, {{T40p}}, {{T41}}, {{T41p}}, {{T42}}, {{T42p}}
* {{X31}}, {{X32}}
'''Intel 82541GI'''
* {{R51}}
* {{X40}}
'''Intel 82573L''' (PCI-Express)
* {{T60}}, {{T60p}}
* {{X60}}, {{X60s}}
'''Intel 82566MM''' (PCI-Express) (w/ [[Intel Active Management Technology (AMT)]])
* {{T61}}, {{T61p}}, {{X61}}, {{X61s}}, {{X61_Tablet}}
Note: DO NOT(!!!) use the "irqpoll" boot parameter. This causes the network card to lose it's irq, and makes any stability of the network connection impossible.
Note: There is a [[Problem with e1000: Open issue with latency|known issue]] with the e1000, t60/t60p and the 2.6.17 kernel. It is unconfirmed if this issue effects other configurations. 
Note: This chip supports Auto-MDIX, meaning you will never need a crossover ethernet cable. 
Note: The first signs of explicit support for this chip in 2.6 kernels is with 2.6.12-rc2. 
Note: Red Hat Enterprise Linux 3.0 (2.4 kernel based) begins 82573L support with Update 7. 
Note: Some users report issues: [[Problem_with_e1000:_EEPROM_Checksum_Is_Not_Valid]] 
Note: Some users have reported [http://forum.thinkpads.com/viewtopic.php?p=201279&sid=787564d7cf9de5d7d76b0cb312a98c61 latency problems] with e1000 driver. It seems, that [http://agenda.clustermonkey.net/index.php/Tuning_Intel_e1000_NICs switching off Interupt Throttle Rate (ITR)] helps. 
Note: [http://support.intel.com/support/network/sb/CS-009209.htm Additional configuration options from Intel] 
Note: Another possibility is to use "RxIntDelay=5".

For Gentoo users - compile e1000 as a kernel module and add 'options e1000 InterruptThrottleRate=0,0' to /etc/modules.d/e1000

I had serious performance problems on Ubuntu Edgy (ca. 400 kb/s File transfer rate).
I compiled version e1000-7.3.20 from http://sourceforge.net/projects/e1000/ and this solved my problem.
All other hints above did not improve the file transfer performance (they did improve the ping latency) for me.

=== Broadcom Fast Ethernet (10/100) ===
Driver: [[tg3]] or [[bcm5700]]

This chip is integrated into select systemboards of the following machines: 
'''Broadcom BCM5901'''
* {{G40}}, {{G41}}
* {{R40e}}
'''Broadcom BCM5751F'''
* {{R51e}}

=== Broadcom Gigabit (10/100/1000) ===
Driver: [[tg3]] or [[bcm5700]]

This chip is integrated into select systemboards of the following machines:

'''Broadcom BCM5752M'''
* {{Z61e}}

'''Broadcom BCM5751M'''
* {{R52}}, {{R60}}
* {{G41}}
* {{T43}}, {{T43p}}
* {{X41}}, {{X41T}}
* {{Z60m}}, {{Z60t}}
* {{Z61m}}, {{Z61p}}

Note: There are some problems with the driver since kernel 2.6.17 (at least on a Z61p, Z61m). After an ifdown && ifup it doesn't work anymore. A possible workaround is to build the tg3-driver as a module and reload it when this problem occours. (Adding ''pre-up modprobe tg3'' and ''post-down rmmod tg3'' to the corresponding section in /etc/network/interfaces works fine.) Rebooting the machine would also be possible.
This is fixed in kernel 2.6.19-rc5.

The T43 with a stock Linux 2.6.18.1 kernel does not have any problems.

[[Category:Components]]

Ethernet Controllers

2008-04-25T20:24:18Z

Unaimed:

== Internal Ethernet controller ==

A variety of [[Ethernet]] controllers is integrated into almost all models starting with the introduction of the A, T and X series.

The Ethernet controller is located on either a MiniPCI card, Communications Daughter Card (CDC), or integrated on the systemboard.

=== 3COM Fast Ethernet (10/100) ===
MiniPCI cards featuring this chip:
*[[3Com 10/100 Ethernet Mini-PCI Adapter with 56K Modem]]

=== Intel Fast Ethernet (10/100) ===
CDC and MiniPCI cards featuring this chip:
*[[Ethernet Daughter Card (EDC)]]
*[[Intel 10/100 Ethernet Mini-PCI Adapter with 56K Modem]]
*[[Intel PRO/100 SP Mobile Combo Adapter]]
*[[Mini-PCI Ethernet card]]
*[[Xircom 10/100 EtherJet Mini PCI Adapter with 56K Modem]]

In addition, this chip is integrated into select systemboards of the following machines: 
'''Intel 82550GY'''
* {{R30}}
'''Intel 82558'''
* [[SelectaBase PC Card Enabler with Advanced EtherJet]]
* [[ThinkPad Port Replicator with Advanced EtherJet]]
'''Intel 82562ET'''
* {{R31}}, {{R32}}
* {{T30}}
* {{X30}}
'''Intel 82562EZ'''
* {{R40}}, {{R50e}}, {{R50}}, {{R51}}
* {{T40}}
* {{X31}}

Driver: [[e100]] (The 'e100' driver is the suggested driver, but '[[eepro100]]' should also work.)

=== Intel Gigabit (10/100/1000) ===
Chipset: Intel PRO/1000 MT Mobile Ethernet 
Driver: [[e1000]]

This chip is integrated into select systemboards of the following machines: 
'''Intel 82540EP'''
* {{R50}}, {{R50p}}, {{R51}}
* {{T40}}, {{T40p}}, {{T41}}, {{T41p}}, {{T42}}, {{T42p}}
* {{X31}}, {{X32}}
'''Intel 82541GI'''
* {{R51}}, {{X40}}
'''Intel 82573L''' (PCI-Express)
* {{T60}}, {{T60p}}
* {{X60}}, {{X60s}}
'''Intel 82566MM''' (PCI-Express) (w/ [[Intel Active Management Technology (AMT)]])
* {{T61}}, {{T61p}}, {{X61}}, {{X61s}}, {{X61_Tablet}}
Note: DO NOT(!!!) use the "irqpoll" boot parameter. This causes the network card to lose it's irq, and makes any stability of the network connection impossible.
Note: There is a [[Problem with e1000: Open issue with latency|known issue]] with the e1000, t60/t60p and the 2.6.17 kernel. It is unconfirmed if this issue effects other configurations. 
Note: This chip supports Auto-MDIX, meaning you will never need a crossover ethernet cable. 
Note: The first signs of explicit support for this chip in 2.6 kernels is with 2.6.12-rc2. 
Note: Red Hat Enterprise Linux 3.0 (2.4 kernel based) begins 82573L support with Update 7. 
Note: Some users report issues: [[Problem_with_e1000:_EEPROM_Checksum_Is_Not_Valid]] 
Note: Some users have reported [http://forum.thinkpads.com/viewtopic.php?p=201279&sid=787564d7cf9de5d7d76b0cb312a98c61 latency problems] with e1000 driver. It seems, that [http://agenda.clustermonkey.net/index.php/Tuning_Intel_e1000_NICs switching off Interupt Throttle Rate (ITR)] helps. 
Note: [http://support.intel.com/support/network/sb/CS-009209.htm Additional configuration options from Intel] 
Note: Another possibility is to use "RxIntDelay=5".

For Gentoo users - compile e1000 as a kernel module and add 'options e1000 InterruptThrottleRate=0,0' to /etc/modules.d/e1000

I had serious performance problems on Ubuntu Edgy (ca. 400 kb/s File transfer rate).
I compiled version e1000-7.3.20 from http://sourceforge.net/projects/e1000/ and this solved my problem.
All other hints above did not improve the file transfer performance (they did improve the ping latency) for me.

=== Broadcom Fast Ethernet (10/100) ===
Driver: [[tg3]] or [[bcm5700]]

This chip is integrated into select systemboards of the following machines: 
'''Broadcom BCM5901'''
* {{G40}}, {{G41}}
* {{R40e}}
'''Broadcom BCM5751F'''
* {{R51e}}

=== Broadcom Gigabit (10/100/1000) ===
Driver: [[tg3]] or [[bcm5700]]

This chip is integrated into select systemboards of the following machines:

'''Broadcom BCM5752M'''
* {{Z61e}}

'''Broadcom BCM5751M'''
* {{R52}}, {{R60}}
* {{G41}}
* {{T43}}, {{T43p}}
* {{X41}}, {{X41T}}
* {{Z60m}}, {{Z60t}}
* {{Z61m}}, {{Z61p}}

Note: There are some problems with the driver since kernel 2.6.17 (at least on a Z61p, Z61m). After an ifdown && ifup it doesn't work anymore. A possible workaround is to build the tg3-driver as a module and reload it when this problem occours. (Adding ''pre-up modprobe tg3'' and ''post-down rmmod tg3'' to the corresponding section in /etc/network/interfaces works fine.) Rebooting the machine would also be possible.
This is fixed in kernel 2.6.19-rc5.

The T43 with a stock Linux 2.6.18.1 kernel does not have any problems.

[[Category:Components]]

How to make ACPI work

2008-04-25T20:19:35Z

Unaimed: /* Kernel configuration */

==General==
First, simply try using the power management features of Linux on your computer. Tell Linux to suspend (System > Preferences > Power Management in Gnome). Try closing the lid. ACPI may already work.

===Update BIOS===
ACPI requires a relatively new BIOS version. In particular, if you get the message,
ACPI: Could not use ECDT
during startup, you probably need a [[BIOS Upgrade]]. For example, a BIOS upgrade from version 1.02 to 1.10 was all that was needed for ACPI to start working on an A31 2652 running Red Hat Enterprise Linux 5 (CentOS 5).

===Kernel configuration===
Many Kernel 2.6 distributions like Red Hat Enterprise Linux 5 (Centos 5) have ACPI built in and ready to go. If not, you must enable ACPI support in your kernel.

To do this open your kernel config and enable ACPI Power Management:
:{{kernelconf|CONFIG_PM|<*>|Power Management support|Power management options|||}}
:{{kernelconf|CONFIG_ACPI|<*>|ACPI Support|Power management options|||}}

You'd most likely want to enable the following ACPI options:
:{{kernelconf|CONFIG_SUSPEND|<*>|Suspend to RAM and standby|Power management options|||}}
:{{kernelconf|CONFIG_ACPI_AC|<*>|AC Adapter|ACPI|Power management options||}}
:{{kernelconf|CONFIG_ACPI_BATTERY|<*>|Battery|ACPI|Power management options||}}
:{{kernelconf|CONFIG_ACPI_BUTTON|<*>|Button|ACPI|Power management options||}}
:{{kernelconf|CONFIG_ACPI_FAN|<*>|Fan|ACPI|Power management options||}}
:{{kernelconf|CONFIG_ACPI_PROCESSOR|<*>|Processor|ACPI|Power management options||}}
:{{kernelconf|CONFIG_ACPI_THERMAL|<*>|Thermal Zone|ACPI|Power management options||}}

If you prefer editing your {{path|.config}} file directly, you should set at least the following variables:
CONFIG_PM=y
CONFIG_ACPI=y
CONFIG_ACPI_AC=y
CONFIG_ACPI_BATTERY=y
CONFIG_ACPI_BUTTON=y
CONFIG_ACPI_FAN=y
CONFIG_ACPI_PROCESSOR=y
CONFIG_ACPI_THERMAL=y
CONFIG_ACPI_BLACKLIRG_YEAR=0
CONFIG_ACPI_EC=y
CONFIG_ACPI_POWER=y
CONFIG_ACPI_SYSTEM=y

Then recompile your kernel.

{{HINT| ACPI SLEEP States option did only show up for me after patching [[Software Suspend 2]] into the kernel. With a vanilla 2.6.17 kernel, one must enable CONFIG_SMP and CONFIG_HOTPLUG_CPU for the option to appear, cf. [http://bugs.debian.org/383059 Debian bug #383059] .
(This should be fixed in 2.6.23, there are new CONFIG_SUSPEND and CONFIG_HIBERNATION config options)}}

===Kernel boot parameters===
Many ThinkPads have been hit by a recent (kernel 2.6.16) change to ACPI4Linux that changed the default means of accessing the ACPI Embedded Controller as a way to shake out underlying bugs in the EC access code. If your ThinkPad fails to resume properly (a blinking Sleep light on resume that doesn't go away, or a hang when trying to suspend/standby a second time), adding {{bootparm|ec_intr|0}} to your kernel command line may help.

===IBM specific ACPI driver===
Unfortunately, special drivers for ACPI on ThinkPads were not included with kernels prior 2.6.10. So you'll have to compile one yourself or get it as precompiled module for your kernel.

You have the choice between [[thinkpad-acpi]] and [[ibm-acpi]], with the latter being the recommended one.

If you use a post-2.6.10 kernel and you want to use [[ibm-acpi]], it is recommended to look on its projects page for a possibly newer version.

{{HINT|Generally it is a good idea to read the README included with the driver.}}

===ACPI daemon===
Also you'll need to install [[acpid]], if it isn't present on your system. [[acpid]] is a daemon that handles the ACPI events generated by the system. Read [[How to configure acpid]].

==Screen blanking (Standby)==
Make sure you have
Option "DPMS"
in the Monitor section of your {{path|/etc/X11/XF86Config}} or {{path|/etc/X11/xorg.conf}}.

Running {{cmduser|xset +dpms}} and then {{cmduser|xset dpms force off}} will turn off the backlight on a laptop screen. 

Note that this may not work in combination with {{cmduser|echo -n "mem" > /sys/power/state}} because switching to console causes the backlight to come back on before sleeping.

==Suspend to RAM (Sleep)==
ACPI Sleep/suspend-to-ram with recent 2.6.x kernels usually works fine. Have a look at the [[How to configure acpid|acpid configuration HOWTO]]. It includes a specific example for going to sleep on lid close.

For Troubleshooting, look at the [[Problems with ACPI suspend-to-ram|Problems with ACPI suspend-to-ram page]].

==Suspend to disk (Hibernate)==
There are two drivers for this available:
* [[swsusp]], which is in the kernel and
* [[Software Suspend 2]] which is more feature rich, but not yet in the kernel, so you have to patch it in yourself.

Both are reported to work fine as long as you use open-source graphic drivers. A comparison of the features can be found on [http://softwaresuspend.berlios.de/features.html this page].

Just in case you are in doubt...yes, it is safe in both cases to use the same swap partition as active swap and as suspend partition.

See the according drivers page for instructions.

==ThinkPads on which it is recommended to use ACPI==
*ThinkPad {{770X}}, {{770Z}}
*ThinkPad {{A20m}}, {{A20p}}, {{A20m}}, {{A20p}}, {{A21e}}, {{A21m}}, {{A21p}}, {{A22e}}, {{A22m}}, {{A22p}}, {{A30}}, {{A30p}}, {{A31}}, {{A31p}}
*ThinkPad {{G40}}, {{G41}}
*ThinkPad {{R30}}, {{R31}}, {{R32}}, {{R40}}, {{R40e}}, {{R50}}, {{R50e}}, {{R50p}}, {{R51}}, {{R52}}, {{R60}}
*ThinkPad {{T22}}, {{T23}}, {{T30}}, {{T40}}, {{T40p}}, {{T41}}, {{T41p}}, {{T42}}, {{T42p}}, {{T43}}, {{T43p}}
*ThinkPad {{X20}}, {{X21}}, {{X22}}, {{X23}}, {{X24}}, {{X30}}, {{X31}}, {{X32}}, {{X40}}, {{X41}}, {{X41T}}
*ThinkPad {{Z60t}}, {{Z60m}}, {{Z61m}}
*ThinkPad {{X60s}}
*ThinkPad {{TransNote}}
*ThinkPad {{T20}} and {{T21}} have old ACPI implementations, but there have been some reports of using ACPI successfully on these models with Ubuntu and Mandriva in particular. Check the related pages about installing Linux on these models for details.

How to make ACPI work

2008-04-25T20:05:55Z

Unaimed: /* Kernel configuration */

==General==
First, simply try using the power management features of Linux on your computer. Tell Linux to suspend (System > Preferences > Power Management in Gnome). Try closing the lid. ACPI may already work.

===Update BIOS===
ACPI requires a relatively new BIOS version. In particular, if you get the message,
ACPI: Could not use ECDT
during startup, you probably need a [[BIOS Upgrade]]. For example, a BIOS upgrade from version 1.02 to 1.10 was all that was needed for ACPI to start working on an A31 2652 running Red Hat Enterprise Linux 5 (CentOS 5).

===Kernel configuration===
Many Kernel 2.6 distributions like Red Hat Enterprise Linux 5 (Centos 5) have ACPI built in and ready to go. If not, you must enable ACPI support in your kernel.

To do this open your kernel config and enable ACPI Power Management:
:{{kernelconf|CONFIG_PM|<*>|Power Management support|Power management options|||}}
:{{kernelconf|CONFIG_ACPI|<*>|ACPI|Power management options|||}}

You'd most likely want to enable the following ACPI options:
:{{kernelconf|CONFIG_ACPI_SLEEP|<*>|Sleep States|ACPI|Power management options||}}
:{{kernelconf|CONFIG_ACPI_AC|<*>|AC Adapter|ACPI|Power management options||}}
:{{kernelconf|CONFIG_ACPI_BATTERY|<*>|Battery|ACPI|Power management options||}}
:{{kernelconf|CONFIG_ACPI_FAN|<*>|Fan|ACPI|Power management options||}}
:{{kernelconf|CONFIG_ACPI_PROCESSOR|<*>|Processor|ACPI|Power management options||}}
:{{kernelconf|CONFIG_ACPI_THERMAL|<*>|Thermal Zone|ACPI|Power management options||}}

If you prefer editing your {{path|.config}} file directly, you should set at least the following variables:
CONFIG_PM=y
CONFIG_ACPI_BOOT=y
CONFIG_ACPI_INTERPRETER=y
CONFIG_ACPI_SLEEP=y
CONFIG_ACPI_SLEEP_PROC_FS=y
CONFIG_ACPI_AC=y
CONFIG_ACPI_BATTERY=y
CONFIG_ACPI_BUTTON=y
CONFIG_ACPI_FAN=y
CONFIG_ACPI_PROCESSOR=y
CONFIG_ACPI_THERMAL=y
CONFIG_ACPI_BUS=y
CONFIG_ACPI_EC=y
CONFIG_ACPI_POWER=y
CONFIG_ACPI_PCI=y
CONFIG_ACPI_SYSTEM=y

Then recompile your kernel.

{{HINT| ACPI SLEEP States option did only show up for me after patching [[Software Suspend 2]] into the kernel. With a vanilla 2.6.17 kernel, one must enable CONFIG_SMP and CONFIG_HOTPLUG_CPU for the option to appear, cf. [http://bugs.debian.org/383059 Debian bug #383059] .}}

===Kernel boot parameters===
Many ThinkPads have been hit by a recent (kernel 2.6.16) change to ACPI4Linux that changed the default means of accessing the ACPI Embedded Controller as a way to shake out underlying bugs in the EC access code. If your ThinkPad fails to resume properly (a blinking Sleep light on resume that doesn't go away, or a hang when trying to suspend/standby a second time), adding {{bootparm|ec_intr|0}} to your kernel command line may help.

===IBM specific ACPI driver===
Unfortunately, special drivers for ACPI on ThinkPads were not included with kernels prior 2.6.10. So you'll have to compile one yourself or get it as precompiled module for your kernel.

You have the choice between [[thinkpad-acpi]] and [[ibm-acpi]], with the latter being the recommended one.

If you use a post-2.6.10 kernel and you want to use [[ibm-acpi]], it is recommended to look on its projects page for a possibly newer version.

{{HINT|Generally it is a good idea to read the README included with the driver.}}

===ACPI daemon===
Also you'll need to install [[acpid]], if it isn't present on your system. [[acpid]] is a daemon that handles the ACPI events generated by the system. Read [[How to configure acpid]].

==Screen blanking (Standby)==
Make sure you have
Option "DPMS"
in the Monitor section of your {{path|/etc/X11/XF86Config}} or {{path|/etc/X11/xorg.conf}}.

Running {{cmduser|xset +dpms}} and then {{cmduser|xset dpms force off}} will turn off the backlight on a laptop screen. 

Note that this may not work in combination with {{cmduser|echo -n "mem" > /sys/power/state}} because switching to console causes the backlight to come back on before sleeping.

==Suspend to RAM (Sleep)==
ACPI Sleep/suspend-to-ram with recent 2.6.x kernels usually works fine. Have a look at the [[How to configure acpid|acpid configuration HOWTO]]. It includes a specific example for going to sleep on lid close.

For Troubleshooting, look at the [[Problems with ACPI suspend-to-ram|Problems with ACPI suspend-to-ram page]].

==Suspend to disk (Hibernate)==
There are two drivers for this available:
* [[swsusp]], which is in the kernel and
* [[Software Suspend 2]] which is more feature rich, but not yet in the kernel, so you have to patch it in yourself.

Both are reported to work fine as long as you use open-source graphic drivers. A comparison of the features can be found on [http://softwaresuspend.berlios.de/features.html this page].

Just in case you are in doubt...yes, it is safe in both cases to use the same swap partition as active swap and as suspend partition.

See the according drivers page for instructions.

==ThinkPads on which it is recommended to use ACPI==
*ThinkPad {{770X}}, {{770Z}}
*ThinkPad {{A20m}}, {{A20p}}, {{A20m}}, {{A20p}}, {{A21e}}, {{A21m}}, {{A21p}}, {{A22e}}, {{A22m}}, {{A22p}}, {{A30}}, {{A30p}}, {{A31}}, {{A31p}}
*ThinkPad {{G40}}, {{G41}}
*ThinkPad {{R30}}, {{R31}}, {{R32}}, {{R40}}, {{R40e}}, {{R50}}, {{R50e}}, {{R50p}}, {{R51}}, {{R52}}, {{R60}}
*ThinkPad {{T22}}, {{T23}}, {{T30}}, {{T40}}, {{T40p}}, {{T41}}, {{T41p}}, {{T42}}, {{T42p}}, {{T43}}, {{T43p}}
*ThinkPad {{X20}}, {{X21}}, {{X22}}, {{X23}}, {{X24}}, {{X30}}, {{X31}}, {{X32}}, {{X40}}, {{X41}}, {{X41T}}
*ThinkPad {{Z60t}}, {{Z60m}}, {{Z61m}}
*ThinkPad {{X60s}}
*ThinkPad {{TransNote}}
*ThinkPad {{T20}} and {{T21}} have old ACPI implementations, but there have been some reports of using ACPI successfully on these models with Ubuntu and Mandriva in particular. Check the related pages about installing Linux on these models for details.