summaryrefslogtreecommitdiff
path: root/Documentation/mainboard/starlabs
diff options
context:
space:
mode:
authorSean Rhodes <sean@starlabs.systems>2021-10-22 14:33:27 +0100
committerMartin L Roth <gaumless@tutanota.com>2022-05-28 14:19:31 +0000
commitab5b7b3eadcf386a1c08d9dcd1e9b85b0cb7a7d1 (patch)
tree6ea8472c7b056aabce50e27c855a30cac78f7844 /Documentation/mainboard/starlabs
parent0b3789f3762356431d6567ba51a44c2a927bdce9 (diff)
mb/starlabs/labtop: Add LabTop Mk III
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-iii-specification Signed-off-by: Sean Rhodes <sean@starlabs.systems> Change-Id: Ia52566e06f50c0abcfb657044538db8e92564c36 Reviewed-on: https://review.coreboot.org/c/coreboot/+/58538 Tested-by: build bot (Jenkins) <no-reply@coreboot.org> Reviewed-by: Angel Pons <th3fanbus@gmail.com> Reviewed-by: Ben McMillen <ben@starlabs.systems>
Diffstat (limited to 'Documentation/mainboard/starlabs')
-rw-r--r--Documentation/mainboard/starlabs/labtop_kbl.md83
1 files changed, 83 insertions, 0 deletions
diff --git a/Documentation/mainboard/starlabs/labtop_kbl.md b/Documentation/mainboard/starlabs/labtop_kbl.md
new file mode 100644
index 0000000000..35ff5e3592
--- /dev/null
+++ b/Documentation/mainboard/starlabs/labtop_kbl.md
@@ -0,0 +1,83 @@
+# Star LabTop Mk III
+
+## Specs
+
+- CPU (full processor specs available at https://ark.intel.com)
+ - Intel i7-8550u (Kaby Lake Refresh)
+- 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
+ - 8GB on-board
+- Networking
+ - 8265 PCIe 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)
+
+## Building coreboot
+
+### Preliminaries
+
+Prior to building coreboot the following files are required:
+* Intel Flash Descriptor file (descriptor.bin)
+* Intel Management Engine firmware (me.bin)
+
+The 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_kbl
+make
+```
+
+## Flashing coreboot
+
+```eval_rst
++---------------------+------------+
+| Type | Value |
++=====================+============+
+| Socketed flash | no |
++---------------------+------------+
+| Vendor | Gigadevice |
++---------------------+------------+
+| Model | 25Q128JVSQ |
++---------------------+------------+
+| Size | 8 MiB |
++---------------------+------------+
+| Package | SOIC-8 |
++---------------------+------------+
+| Internal flashing | yes |
++---------------------+------------+
+| External flashing | yes |
++---------------------+------------+
+
+Please see [here](../common/flashing.md) for instructions on how to flash with fwupd.