Documentation/mainboard/starlabs/starbook_adl.md

   1 # StarBook Mk V
   2
   3 ## Specs
   4
   5 - CPU (full processor specs available at https://ark.intel.com)
   6     - Intel i7-1260P (Alder Lake)
   7     - Intel i3-1220P (Alder Lake)
   8     - Intel i3-1315U (Raptor Lake)
   9     - Intel i7-1360P (Raptor Lake)
  10 - EC
  11     - ITE IT5570E
  12     - Backlit keyboard, with standard PS/2 keycodes and SCI hotkeys
  13     - Battery
  14     - Charger, using AC adapter or USB-C PD
  15     - Suspend / resume
  16 - GPU
  17     - Intel® Iris® Xe Graphics
  18     - GOP driver is recommended, VBT is provided
  19     - eDP 14-inch 1920x1080 LCD
  20     - HDMI video
  21     - USB-C DisplayPort video
  22 - Memory
  23     - 2 x DDR4 SODIMM
  24 - Networking
  25     - AX210 2230 WiFi / Bluetooth
  26 - Sound
  27     - Realtek ALC269-VB6
  28     - Internal speakers
  29     - Internal microphone
  30     - Combined headphone / microphone 3.5-mm jack
  31     - HDMI audio
  32     - USB-C DisplayPort audio
  33 - Storage
  34     - M.2 PCIe SSD
  35     - RTS5129 MicroSD card reader
  36 - USB
  37     - 1920x1080 CCD camera
  38     - USB 3.1 Gen 2 (left) (Alder Lake)
  39     - Thunderbolt 4.0 (left) (Raptor Lake)
  40     - USB 3.1 Gen 2 Type-A (left)
  41     - USB 3.1 Gen 1 Type-A (right)
  42     - USB 2.0 Type-A (right)
  43
  44 ## Building coreboot
  45
  46 Please follow the [Star Labs build instructions](common/building.md) to build coreboot, using `config.starlabs_starbook_adl` as config file.
  47
  48 ### Preliminaries
  49
  50 Prior to building coreboot the following files are required:
  51 * Intel Flash Descriptor file (descriptor.bin)
  52 * Intel Management Engine firmware (me.bin)
  53 * ITE Embedded Controller firmware (ec.bin)
  54
  55 The files listed below are optional:
  56 - Splash screen image in Windows 3.1 BMP format (Logo.bmp)
  57
  58 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.
  59
  60 ### Build
  61
  62 The following commands will build a working image:
  63
  64
  65 Alder Lake:
  66 ```bash
  67 make distclean
  68 make defconfig KBUILD_DEFCONFIG=configs/config.starlabs_starbook_adl
  69 make
  70 ```
  71
  72 Raptor Lake:
  73 ```bash
  74 make distclean
  75 make defconfig KBUILD_DEFCONFIG=configs/config.starlabs_starbook_rpl
  76 make
  77 ```
  78
  79 ## Flashing coreboot
  80
  81 ```{eval-rst}
  82 +---------------------+------------+
  83 | Type                | Value      |
  84 +=====================+============+
  85 | Socketed flash      | no         |
  86 +---------------------+------------+
  87 | Vendor              | Winbond    |
  88 +---------------------+------------+
  89 | Model               | W25Q256.V  |
  90 +---------------------+------------+
  91 | Size                | 32 MiB     |
  92 +---------------------+------------+
  93 | Package             | SOIC-8     |
  94 +---------------------+------------+
  95 | Internal flashing   | yes        |
  96 +---------------------+------------+
  97 | External flashing   | yes        |
  98 +---------------------+------------+
  99 ```
 100
 101 Please see [here](common/flashing.md) for instructions on how to flash with fwupd.