mb/starlabs/labtop: Add LabTop Mk IV

Tested using MrChromeBox's `uefipayload_202107` branch: * Windows 10 * Ubuntu 20.04 * MX Linux 19.4 * Manjaro 21 No known issues. https://starlabs.systems/pages/labtop-mk-iv-specification Signed-off-by: Sean Rhodes <sean@starlabs.systems> Change-Id: Idbaa907dc38dc521961806132f21b7a90324ec9c Reviewed-on: https://review.coreboot.org/c/coreboot/+/58428 Reviewed-by: Angel Pons <th3fanbus@gmail.com> Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
2021-10-18 21:07:20 +01:00
parent 37afe1c10c
commit e96ade6981
19 changed files with 1236 additions and 6 deletions
--- a/Documentation/mainboard/starlabs/labtop_cml.md
+++ b/Documentation/mainboard/starlabs/labtop_cml.md
@@ -0,0 +1,87 @@
+# Star LabTop Mk IV
+
+## Specs
+
+- CPU (full processor specs available at https://ark.intel.com)
+    - Intel i7-10710U (Comet Lake)
+    - Intel i3-10110U (Comet Lake)
+- EC
+    - ITE IT8987E
+    - Backlit Keyboard, with standard PS/2 keycodes and SCI hotkeys
+    - Battery
+    - Charger, using AC adapter or USB-C PD
+    - Suspend / resume
+- GPU
+    - Intel UHD Graphics 620
+    - GOP driver is recommended, VBT is provided
+    - eDP 13-inch 1920x1080 LCD
+    - HDMI video
+    - USB-C DisplayPort video
+- Memory
+    - 16GB on-board *1
+- Networking
+    - AX201 CNVi WiFi / Bluetooth soldered to PCBA
+- Sound
+    - Realtek ALC256
+    - Internal speakers
+    - Internal microphone
+    - Combined headphone / microphone 3.5-mm jack
+    - HDMI audio
+    - USB-C DisplayPort audio
+- Storage
+    - M.2 PCIe SSD
+    - RTS5129 MicroSD card reader
+- USB
+    - 1280x720 CCD camera
+    - USB 3.1 Gen 2 Type-C (left)
+    - USB 3.1 Gen 2 Type-A (left)
+    - USB 3.1 Gen 1 Type-A (right)
+
+[^1] The Comet Lake PCB supports multiple memory variations that are based on hardware configuration resistors see `src/mainboard/starlabs/labtop/variants/cml/romstage.c`
+
+## Building coreboot
+
+### Preliminaries
+
+Prior to building coreboot the following files are required:
+* Intel Flash Descriptor file (descriptor.bin)
+* Intel Management Engine firmware (me.bin)
+* ITE Embedded Controller firmware (ec.bin)
+
+The files listed below are optional:
+- Splash screen image in Windows 3.1 BMP format (Logo.bmp)
+
+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.
+
+### Build
+
+The following commands will build a working image:
+
+```bash
+make distclean
+make defconfig KBUILD_DEFCONFIG=configs/config.starlabs_labtop_cml
+make
+```
+
+## Flashing coreboot
+
+```eval_rst
+---------------------+------------+
+| Type                | Value      |
+=====================+============+
+| Socketed flash      | no         |
+---------------------+------------+
+| Vendor              | Winbond    |
+---------------------+------------+
+| Model               | 25Q128JVSQ |
+---------------------+------------+
+| Size                | 16 MiB     |
+---------------------+------------+
+| Package             | SOIC-8     |
+---------------------+------------+
+| Internal flashing   | yes        |
+---------------------+------------+
+| External flashing   | yes        |
+---------------------+------------+
+
+Please see [here](../common/flashing.md) for instructions on how to flash with fwupd.