device/pciexp: Add hot-plug capable helper function
[coreboot2.git] / Documentation / mainboard / starlabs / lite_adl.md
blob821c755de9fba3cf1e5b311bf16c3259d2cfaaf0
1 # StarBook Mk V
3 ## Specs
5 - CPU (full processor specs available at https://ark.intel.com)
6     - Intel N200 (Alder Lake)
7 - EC
8     - ITE IT5570E
9     - USB-C PD Charger
10     - Suspend / resume
11 - GPU
12     - IntelĀ® IrisĀ® Xe Graphics
13     - GOP driver is recommended, VBT is provided
14     - eDP 12.5-inch 2880x1920 or 2160x1440 LCD
15     - 2 x USB-C DisplayPort video
16 - Memory
17     - 16GB on-board
18 - Networking
19     - 9560 CNVi WiFi / Bluetooth
20 - Sound
21     - Realtek ALC269-VB6
22     - Internal speakers
23     - Internal microphone
24     - Combined headphone / microphone 3.5-mm jack
25     - HDMI audio
26     - USB-C DisplayPort audio
27 - Storage
28     - M.2 PCIe SSD
29     - RTS5129 MicroSD card reader
30 - USB
31     - 2 x 5MP CCD Camera
32     - 2 x USB 3.1 Gen 2 Type-C (right)
34 ## Building coreboot
36 Please follow the [Star Labs build instructions](common/building.md) to build coreboot, using `config.starlabs_starbook_adl` as config file.
38 ### Preliminaries
40 Prior to building coreboot the following files are required:
41 * Intel Flash Descriptor file (descriptor.bin)
42 * Intel Management Engine firmware (me.bin)
43 * ITE Embedded Controller firmware (ec.bin)
45 The files listed below are optional:
46 - Splash screen image in Windows 3.1 BMP format (Logo.bmp)
48 These files exist in the correct location in the StarLabsLtd/blobs repo on GitHub which is used in place of the standard 3rdparty/blobs repo.
50 ### Build
52 The following commands will build a working image:
54 ```bash
55 make distclean
56 make defconfig KBUILD_DEFCONFIG=configs/config.starlabs_byte_adl
57 make
58 ```
60 ## Flashing coreboot
62 ```{eval-rst}
63 +---------------------+------------+
64 | Type                | Value      |
65 +=====================+============+
66 | Socketed flash      | no         |
67 +---------------------+------------+
68 | Vendor              | Winbond    |
69 +---------------------+------------+
70 | Model               | W25Q256.V  |
71 +---------------------+------------+
72 | Size                | 32 MiB     |
73 +---------------------+------------+
74 | Package             | SOIC-8     |
75 +---------------------+------------+
76 | Internal flashing   | yes        |
77 +---------------------+------------+
78 | External flashing   | yes        |
79 +---------------------+------------+
80 ```
82 Please see [here](common/flashing.md) for instructions on how to flash with fwupd.