device/pciexp: Add hot-plug capable helper function
[coreboot2.git] / Documentation / mainboard / asus / p2b-ls.md
blobc1bb1c4bd9d2eccb77f390f29ebf0c9bc1980eb0
1 # ASUS P2B-LS
3 This page describes how to run coreboot on the ASUS P2B-LS mainboard.
5 ## Variants
7 - P2B-LS
8 - P2B-L (Same circuit board with SCSI components omitted)
9 - P2B-S (Same circuit board with ethernet components omitted)
11 ## Flashing coreboot
13 ```{eval-rst}
14 +---------------------+---------------------------+
15 | Type                | Value                     |
16 +=====================+===========================+
17 | Model               | SST 39SF020A (or similar) |
18 +---------------------+---------------------------+
19 | Protocol            | Parallel                  |
20 +---------------------+---------------------------+
21 | Size                | 256 KiB                   |
22 +---------------------+---------------------------+
23 | Package             | DIP-32                    |
24 +---------------------+---------------------------+
25 | Socketed            | yes                       |
26 +---------------------+---------------------------+
27 | Write protection    | no                        |
28 +---------------------+---------------------------+
29 | Dual BIOS feature   | no                        |
30 +---------------------+---------------------------+
31 | Internal flashing   | yes                       |
32 +---------------------+---------------------------+
33 ```
35 [flashrom] works out of the box since 0.9.2.
36 Because of deficiency in vendor firmware, user needs to override the laptop
37 warning as prompted. Once coreboot is in place there will be no further issue.
39 ### CPU microcode considerations
41 By default, this board includes microcode updates for 5 families of Intel CPUs
42 because of the wide variety of CPUs the board supports, directly or with an
43 adapter. These take up a third of the total flash space leaving only 20kB free
44 in the final cbfs image. It may be necessary to build a custom microcode update
45 file by manually concatenating files in 3rdparty/intel-microcode/intel-ucode
46 for only CPU models that the board will actually be run with.
48 ## Working
50 - Slot 1 and Socket 370 CPUs and their L1/L2 caches
51 - PS/2 keyboard with SeaBIOS (See [Known issues])
52 - IDE hard drives
53 - Ethernet (-LS, -L; Intel 82558)
54 - SCSI (-LS, -S; Adaptec AIC7890)
55 - USB
56 - ISA add-on cards
57 - PCI add-on cards
58 - AGP graphics card
59 - Floppy
60 - Serial ports 1 and 2
61 - Reboot
62 - Soft off
64 ## Known issues
66 - PS/2 keyboard may not be usable until Linux has completely booted.
67   With SeaBIOS as payload, setting keyboard initialization timeout to
68   500ms may fix the issue.
70 - i440BX does not support 256Mbit RAM modules. If installed, coreboot
71   will attempt to initialize them at half their capacity anyway
72   whereas vendor firmware will not boot at all.
74 - ECC memory can be used, but ECC support is still pending.
76 - Termination is enabled for all SCSI ports (if equipped). Support to
77   disable termination is pending. Note that the SCSI-68 port is
78   always terminated, even with vendor firmware.
80 ## Untested
82 - Parallel port
83 - EDO memory
84 - Infrared
85 - PC speaker
87 ## Not working
89 - S3 suspend to RAM
91 ## Technology
93 ```{eval-rst}
94 +------------------+--------------------------------------------------+
95 | Northbridge      | Intel I440BX                                     |
96 +------------------+--------------------------------------------------+
97 | Southbridge      | i82371eb                                         |
98 +------------------+--------------------------------------------------+
99 | CPU              | P6 family for Slot 1 and Socket 370              |
100 |                  | (all models from model_63x to model_6bx)         |
101 +------------------+--------------------------------------------------+
102 | Super I/O        | winbond/w83977tf                                 |
103 +------------------+--------------------------------------------------+
106 ## Extra resources
108 [flashrom]: https://flashrom.org/Flashrom