device/pciexp: Add hot-plug capable helper function
[coreboot2.git] / Documentation / mainboard / starlabs / byte_adl.md
blob11bed26f4963d39dd078ae1c063bc8bed7ac9ca9
1 # Byte Mk II
3 ## Specs
5 - CPU (full processor specs available at https://ark.intel.com)
6     - Intel N200 (Alder Lake)
7 - EC
8     - ITE IT5570E
9     - Charger, using AC adapter or USB-C PD
10     - Suspend / resume
11 - GPU
12     - IntelĀ® IrisĀ® Xe Graphics
13     - GOP driver is recommended, VBT is provided
14     - HDMI video
15     - DisplayPort video
16     - USB-C DisplayPort video
17 - Memory
18     - 1 x DDR4 SODIMM
19 - Networking
20     - 9560 2230 WiFi / Bluetooth
21     - Realtek RLT8111 1Gbps
22     - Realtek RLT8125B 2.5Gbps
23 - Sound
24     - SoundWire SN6140
25     - Combined headphone / microphone 3.5-mm jack
26     - HDMI audio
27     - USB-C DisplayPort audio
28 - Storage
29     - M.2 PCIe SSD
30 - USB
31     - 2 x USB 3.1 Gen 2 Type-A (front)
32     - 1 x USB 3.1 Gen 2 Type-C (front)
33     - 2 x USB 3.1 Gen 2 Type-A (back)
35 ## Building coreboot
37 Please follow the [Star Labs build instructions](common/building.md) to build coreboot, using `config.starlabs_byte_adl` as config file.
39 ### Preliminaries
41 Prior to building coreboot the following files are required:
42 * Intel Flash Descriptor file (descriptor.bin)
43 * Intel Management Engine firmware (me.bin)
44 * ITE Embedded Controller firmware (ec.bin)
46 The files listed below are optional:
47 - Splash screen image in Windows 3.1 BMP format (Logo.bmp)
49 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.
51 ### Build
53 The following commands will build a working image:
55 ```bash
56 make distclean
57 make defconfig KBUILD_DEFCONFIG=configs/config.starlabs_byte_adl
58 make
59 ```
61 ## Flashing coreboot
63 ```{eval-rst}
64 +---------------------+------------+
65 | Type                | Value      |
66 +=====================+============+
67 | Socketed flash      | no         |
68 +---------------------+------------+
69 | Vendor              | Winbond    |
70 +---------------------+------------+
71 | Model               | W25Q256.V  |
72 +---------------------+------------+
73 | Size                | 32 MiB     |
74 +---------------------+------------+
75 | Package             | SOIC-8     |
76 +---------------------+------------+
77 | Internal flashing   | yes        |
78 +---------------------+------------+
79 | External flashing   | yes        |
80 +---------------------+------------+
81 ```
83 Please see [here](common/flashing.md) for instructions on how to flash with fwupd.