device/pciexp: Add hot-plug capable helper function
[coreboot2.git] / Documentation / mainboard / starlabs / starfighter_rpl.md
blobd386fb3d51dfbb0e469a90a8ed6f97130aa07d4a
1 # StarFighter Mk I
3 ## Specs
5 - CPU (full processor specs available at https://ark.intel.com)
6     - Intel i3-1315U (Raptor Lake)
7     - Intel i7-13700H (Raptor Lake)
8     - Intel i9-13900H (Raptor Lake)
9 - EC
10     - ITE IT5570E
11     - Backlit keyboard, with standard PS/2 keycodes and SCI hotkeys
12     - Battery
13     - USB-C PD Charger
14     - Suspend / resume
15 - GPU
16     - IntelĀ® IrisĀ® Xe Graphics
17     - GOP driver is recommended, VBT is provided
18     - eDP 16-inch 3840x2400 or 2560x1600 LCD
19     - HDMI video
20     - USB-C DisplayPort video
21 - Memory
22     - 16, 32 or 64GB LPDDR5 on-board memory
23 - Networking
24     - AX210 2230 WiFi / Bluetooth
25 - Sound
26     - Realtek ALC256
27     - Internal speakers
28     - Removable microphone
29     - Combined headphone / microphone 3.5-mm jack
30     - HDMI audio
31     - USB-C DisplayPort audio
32 - Storage
33     - 2 xM.2 PCIe SSD
34     - RTS5129 MicroSD card reader
35 - USB
36     - 1920x1080 removable CCD camera
37     - 2 x Thunderbolt 4.0 (left) (Raptor Lake)
38     - USB 3.1 Gen 2 Type-A (left)
39     - USB 3.1 Gen 2 Type-A (right)
40     - USB 3.1 Gen 1 Type-A (right)
42 ## Building coreboot
44 Please follow the [Star Labs build instructions](common/building.md) to build coreboot, using `config.starlabs_starfighter_rpl` as config file.
46 ### Preliminaries
48 Prior to building coreboot the following files are required:
49 * Intel Flash Descriptor file (descriptor.bin)
50 * Intel Management Engine firmware (me.bin)
51 * ITE Embedded Controller firmware (ec.bin)
53 The files listed below are optional:
54 - Splash screen image in Windows 3.1 BMP format (Logo.bmp)
56 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.
58 ### Build
60 The following commands will build a working image:
63 ```bash
64 make distclean
65 make defconfig KBUILD_DEFCONFIG=configs/config.starlabs_starfighter_rpl
66 make
67 ```
69 ## Flashing coreboot
71 ```{eval-rst}
72 +---------------------+------------+
73 | Type                | Value      |
74 +=====================+============+
75 | Socketed flash      | no         |
76 +---------------------+------------+
77 | Vendor              | Winbond    |
78 +---------------------+------------+
79 | Model               | W25Q256.V  |
80 +---------------------+------------+
81 | Size                | 32 MiB     |
82 +---------------------+------------+
83 | Package             | SOIC-8     |
84 +---------------------+------------+
85 | Internal flashing   | yes        |
86 +---------------------+------------+
87 | External flashing   | yes        |
88 +---------------------+------------+
89 ```
91 Please see [here](common/flashing.md) for instructions on how to flash with fwupd.