Annotation of wikisrc/laptops.mdwn, revision 1.31

1.2       reed        1: This page lists and links to pages about laptops, notebooks,
1.20      nia         2: and portable computers that work well with NetBSD, are of interest
                      3: to developers, and are standardized or easy to find.
1.1       reed        4: 
1.31    ! nia         5: This page references lots of different device drivers. All of them
        !             6: are built-in to GENERIC kernels and you don't need to load them.
        !             7: 
1.1       reed        8: [[!toc ]]
                      9: 
1.3       reed       10: ---
                     11: 
1.20      nia        12: # Generic laptop support
1.3       reed       13: 
1.20      nia        14: ## Graphics
1.3       reed       15: 
1.20      nia        16: NetBSD 9.0 supports Intel integrated graphics up to Kaby Lake,
                     17: Nvidia graphics up to Maxwell, and AMD graphics up to GCNv1.
1.3       reed       18: 
1.20      nia        19: Anything newer than this will work, but will use `llvmpipe`
                     20: instead of hardware acceleration for OpenGL.
1.9       reed       21: 
1.21      nia        22: The support includes connecting external monitors over HDMI,
                     23: DisplayPort, and DisplayPort over USB-C.
                     24: 
                     25: For the Intel driver, there may be slight graphical corruptions
                     26: when using X11 without a compositor. Xfce/MATE include their own
                     27: compositors, but lightweight window managers can benefit from
                     28: having `picom` running.
                     29: 
1.20      nia        30: ## CPU frequency adjustment
1.9       reed       31: 
1.20      nia        32: On most ACPI and some non-ACPI laptops, the `sysutils/estd` package
                     33: can be used to automatically adjust the CPU frequency depending on
                     34: system load, and potentially prolong battery life. This modifies the
                     35: `frequency` variables exposed by
                     36: [[!template id=man name="sysctl" section="8"]].
1.9       reed       37: 
1.20      nia        38: ## Suspend
1.13      ryoon      39: 
1.20      nia        40: On ACPI systems, suspend-to-RAM is supported through
                     41: `sysctl hw.acpi.sleep.state=3`.  This can be triggered through various
                     42: events (such as lid close) with
                     43: [[!template id=man name="powerd" section="8"]].
1.13      ryoon      44: 
1.20      nia        45: Suspend on NetBSD currently seems to work best on Thinkpads.
1.13      ryoon      46: 
1.20      nia        47: ## Input
1.13      ryoon      48: 
1.20      nia        49: Many x86 laptops use Synaptics touchpads over an emulated PS/2 interface,
                     50: which is supported through [[!template id=man name="pms" section="4"]],
1.21      nia        51: with various adjustable Synaptics-specific sysctl variables.
1.9       reed       52: 
1.20      nia        53: ## WiFi
1.1       reed       54: 
1.20      nia        55: Many x86 laptops with Intel processors will have WiFi cards supported
                     56: by the
                     57: [[!template id=man name="iwm" section="4"]] driver, or 
                     58: [[!template id=man name="iwn" section="4"]] for older models.
                     59: Atheros 11n miniPCIe cards are supported by the
                     60: [[!template id=man name="athn" section="4"]] driver.
1.1       reed       61: 
1.20      nia        62: See the
                     63: [[!template id=man name="afterboot" section="8"]] man page for details
1.24      nia        64: on connecting to WiFi networks.
1.1       reed       65: 
1.21      nia        66: USB 11n WiFi adapters such as
1.20      nia        67: [[!template id=man name="urtwn" section="4"]] and
                     68: [[!template id=man name="run" section="4"]] can also be used,
                     69: and most/all generic USB ethernet adapters are also well supported.
                     70: For a fairly complete list, see 
                     71: [[!template id=man name="usb" section="4"]].
1.3       reed       72: 
1.21      nia        73: Unfortunately, WiFi hardware is not particularly standardized compared
                     74: to most other aspects of modern laptops.
                     75: 
1.20      nia        76: ## Audio
1.11      reed       77: 
1.21      nia        78: Essentially all modern x86 laptops use the 
1.20      nia        79: [[!template id=man name="hdaudio" section="4"]] driver.
1.11      reed       80: 
1.20      nia        81: In the case that switching between speakers and the headphone port
                     82: is not handled automatically by the hardware, the `dacsel`
                     83: [[!template id=man name="mixerctl" section="1"]] variable can be
                     84: modified.
1.11      reed       85: 
1.22      nia        86: ## Sensors
                     87: 
                     88: Regardless of whether the system is ACPI, NetBSD will
                     89: expose all sensors (e.g. for temperature and battery)
                     90: via [[!template id=man name="envstat" section="8"]].
                     91: 
1.11      reed       92: ---
                     93: 
1.20      nia        94: # IBM / Lenovo
1.9       reed       95: 
1.20      nia        96: The [[!template id=man name="thinkpad" section="4"]] driver provides
                     97: support for various Thinkpad-specific sensors and function keys.
1.6       jruoho     98: 
1.21      nia        99: A number of NetBSD developers use Thinkpads to hack on NetBSD
                    100: and for everyday usage.
                    101: 
1.9       reed      102: ## ThinkPad T22
                    103: 
                    104: Works perfect (sound, display, all devices, infrared port not tested).
                    105: 
1.6       jruoho    106: ## ThinkPad X60s
                    107: 
1.15      sevan     108: Everything works.
1.6       jruoho    109: 
1.9       reed      110: ## ThinkPad X41
                    111: 
                    112: Works fine (sound, display, all devices, bluetooth, modem not tested).
                    113: 
1.6       jruoho    114: ## ThinkPad X61s
                    115: 
                    116: Everything works. Requires `PCI_BUS_FIXUP` and `PCI_ADDR_FIXUP` [[!template
                    117: id=man name="options" section="4"]].
                    118: 
1.17      nia       119: ## Thinkpad X220
                    120: 
                    121: * Video acceleration works, but when using `xf86-video-intel` (the default),
                    122:   it's advisable to set `Option "AccelMethod"  "uxa"` in `xorg.conf`.
1.19      nia       123: * Ethernet is supported through the [[!template id=man name="wm" section="4"]] driver.
                    124: * WiFi is supported through the [[!template id=man name="iwn" section="4"]] driver.
1.17      nia       125: * Suspend and resume work.
                    126: 
1.19      nia       127: ## Thinkpad X230
                    128: 
1.28      nia       129: * Accelerated graphics.
1.19      nia       130: * Ethernet is supported through the [[!template id=man name="wm" section="4"]] driver.
                    131: * WiFi is supported through the [[!template id=man name="iwn" section="4"]] driver.
                    132: 
1.16      nia       133: ## Thinkpad X250
                    134: 
1.28      nia       135: * Accelerated graphics.
                    136: * Connecting externals displays works with the miniDP and VGA ports.
1.19      nia       137: * SD card reader is supported through the [[!template id=man name="rtsx" section="4"]] driver.
                    138: * Ethernet is supported through the [[!template id=man name="wm" section="4"]] driver.
                    139: * WiFi is supported through the [[!template id=man name="iwm" section="4"]] driver.
1.27      nia       140: * Extra trackpoint buttons: run at least 9.0_STABLE for fixes to the Synaptics driver.
                    141: * Brightness buttons do not work in 9.0 by default. You can bind them to
1.16      nia       142:   xrandr in your window manager.
1.19      nia       143: * Webcam will depend on upcoming xhci isochronous pipe support.
                    144: * To record from the internal mic, set `mixerctl -w record.source=ADC02`
1.27      nia       145: * Some spam from [[!template id=man name="hdaudio" section="4"]] on some 
                    146:   reboots, the chip doesn't seem to reset properly. Disappears and boots
                    147:   normally after a few seconds.
                    148:   [[!template id=pr number=51734]]
1.23      nia       149: * Suspend and resume work.
1.16      nia       150: 
1.19      nia       151: ## Thinkpad X260
                    152: 
1.28      nia       153: * Accelerated graphics.
1.19      nia       154: * SD card reader is supported through the [[!template id=man name="rtsx" section="4"]] driver.
                    155: * Ethernet is supported through the [[!template id=man name="wm" section="4"]] driver.
                    156: * WiFi is supported through the [[!template id=man name="iwm" section="4"]] driver.
1.27      nia       157: * Extra trackpoint buttons: run at least 9.0_STABLE for fixes to the Synaptics driver.
1.28      nia       158: * Webcam will depend on upcoming xhci isochronous pipe support.
1.23      nia       159: * Suspend and resume work.
1.19      nia       160: 
1.20      nia       161: ---
1.14      ryoon     162: 
1.27      nia       163: # Asus
                    164: 
                    165: Eee PCs were previously very popular hardware, so they're widely available
                    166: cheaply, tend to work quite well, and what works is documented.
                    167: 
                    168: ## EeePC 701
                    169: 
                    170: [[!table data="""
                    171: GPU | WiFi | SD card reader | Ethernet | Audio | Webcam | Suspend/Resume
                    172: Supported | Supported | Supported | Supported | Supported | Supported | Supported
                    173: """]]
                    174: 
                    175: ## EeePC 900
                    176: 
                    177: [[!table data="""
                    178: GPU | WiFi | SD card reader | Ethernet | Audio | Webcam | Suspend/Resume
                    179: Supported | Supported | Supported | Supported | Supported | Supported | Supported
                    180: """]]
                    181: 
1.29      nia       182: ## EeePC 901
1.27      nia       183: 
                    184: [[!table data="""
                    185: GPU | WiFi | SD card reader | Ethernet | Audio | Webcam | Suspend/Resume
                    186: Supported | Supported | Supported | Supported | Supported | Supported | Supported
                    187: """]]
                    188: 
                    189: ## EeePC 1000HA
                    190: 
                    191: [[!table data="""
                    192: GPU | WiFi | SD card reader | Ethernet | Audio | Webcam | Suspend/Resume
                    193: Supported | Supported | Supported | Supported | Supported | Supported | Supported
                    194: """]]
                    195: 
                    196: ---
                    197: 
1.20      nia       198: # PINE64
1.14      ryoon     199: 
1.21      nia       200: A number of NetBSD developers use Pinebooks to hack on NetBSD
                    201: and for everyday usage.
                    202: 
                    203: Pinebook and Pinebook Pro do not use ACPI, so certain aspects are
                    204: different compared to x86 laptops.
                    205: 
1.20      nia       206: ## Pinebook (Allwinner A64)
1.14      ryoon     207: 
1.28      nia       208: * Support for the display and HDMI output is provided through the Allwinner Display Engine driver.
                    209:   This provides kernel modesetting and a full-resolution video framebuffer, however,
1.30      nia       210:   the 3D acceleration features of the GPU are not yet accessible - Mesa llvmpipe is used instead.
1.28      nia       211: * The CPU frequency can be adjusted automatically with `estd` or with `sysctl machdep.cpufreq.*`.
1.20      nia       212: * [[!template id=man name="uvideo" section="4"]] webcam works.
                    213: * External WiFI adapters can be used. Support for the internal WiFi - after WiFi system rework?
1.1       reed      214: 
1.26      nia       215: ## Pinebook Pro (Rockchip RK3399)
1.3       reed      216: 
1.28      nia       217: * Support for the display output is provided through the Rockchip DRM driver.
                    218:   This provides kernel modesetting and a full-resolution video framebuffer, however,
1.30      nia       219:   the 3D acceleration features of the GPU are not yet accessible - Mesa llvmpipe is used instead.
1.28      nia       220:   Currently, you can't connect external displays through USB-C.
                    221: * The CPU frequency can be adjusted automatically with `estd` or with `sysctl machdep.cpufreq.*`.
1.20      nia       222: * [[!template id=man name="uvideo" section="4"]] webcam works.
1.28      nia       223: * External WiFI adapters can be used. Support for the internal WiFi - after WiFi system rework?
                    224:   Internal Broadcom WiFi is supported via the [[!template id=man name="bwfm" section="4"]] driver in -current.
                    225:   However, external adapters may still be more stable.
1.20      nia       226: * The display backlight can be adjusted with `sysctl`.
1.26      nia       227: 
                    228: ### Pinebook Pro CPU affinity
                    229: 
                    230: After setting `security.models.extensions.user_set_cpu_affinity=1` in `/etc/sysctl.conf`,
                    231: you can run an intensive command on only the "big" CPUs:
                    232: 
                    233: `$ schedctl -A 4,5 make package`

CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb