summaryrefslogtreecommitdiffstats
path: root/Documentation/mainboard
diff options
context:
space:
mode:
authorBen-StarLabs <ben@starlabs.systems>2022-07-12 12:43:27 +0100
committerFelix Held <felix-coreboot@felixheld.de>2022-12-17 01:20:26 +0000
commitb2db3659a9b1d7b0a7d9e9ca228aa64bcf297922 (patch)
tree099c1cdbb4c1c2b2f690eccd9b0217453aa2c1fe /Documentation/mainboard
parent1c3da3f236c0aac1957a93882674a1f80d279f65 (diff)
downloadcoreboot-b2db3659a9b1d7b0a7d9e9ca228aa64bcf297922.tar.gz
coreboot-b2db3659a9b1d7b0a7d9e9ca228aa64bcf297922.tar.bz2
coreboot-b2db3659a9b1d7b0a7d9e9ca228aa64bcf297922.zip
mb/starlabs/starbook: Add Alder Lake StarBook Mk VI variant
Tested using `edk2` from `github.com/starlabsltd/edk2/tree/uefipayload_202209`: * Windows 10 * Ubuntu 20.04 * MX Linux 19.4 * Manjaro 21 No known issues. https://starlabs.systems/pages/starbook-specification Signed-off-by: Ben-StarLabs <ben@starlabs.systems> Change-Id: Idc0c265a88b19cf9e89cc8ab3e8db9abd8cf8409 Reviewed-on: https://review.coreboot.org/c/coreboot/+/65785 Reviewed-by: Angel Pons <th3fanbus@gmail.com> Tested-by: build bot (Jenkins) <no-reply@coreboot.org> Reviewed-by: Tim Wawrzynczak <inforichland@gmail.com>
Diffstat (limited to 'Documentation/mainboard')
-rw-r--r--Documentation/mainboard/index.md1
-rw-r--r--Documentation/mainboard/starlabs/starbook_adl.md86
2 files changed, 87 insertions, 0 deletions
diff --git a/Documentation/mainboard/index.md b/Documentation/mainboard/index.md
index 2e314e6b2d09..134166f2e09f 100644
--- a/Documentation/mainboard/index.md
+++ b/Documentation/mainboard/index.md
@@ -185,6 +185,7 @@ The boards in this section are not real mainboards, but emulators.
- [StarLite Mk III](starlabs/lite_glk.md)
- [StarLite Mk IV](starlabs/lite_glkr.md)
- [StarBook Mk V](starlabs/starbook_tgl.md)
+- [StarBook Mk VI](starlabs/starbook_adl.md)
- [Flashing devices](starlabs/common/flashing.md)
## Supermicro
diff --git a/Documentation/mainboard/starlabs/starbook_adl.md b/Documentation/mainboard/starlabs/starbook_adl.md
new file mode 100644
index 000000000000..8e1a7c2309cf
--- /dev/null
+++ b/Documentation/mainboard/starlabs/starbook_adl.md
@@ -0,0 +1,86 @@
+# StarBook Mk V
+
+## Specs
+
+- CPU (full processor specs available at https://ark.intel.com)
+ - Intel i7-1260P (Alder Lake)
+ - Intel i3-1220P (Alder Lake)
+- EC
+ - ITE IT5570E
+ - Backlit keyboard, with standard PS/2 keycodes and SCI hotkeys
+ - Battery
+ - Charger, using AC adapter or USB-C PD
+ - Suspend / resume
+- GPU
+ - IntelĀ® IrisĀ® Xe Graphics
+ - GOP driver is recommended, VBT is provided
+ - eDP 14-inch 1920x1080 LCD
+ - HDMI video
+ - USB-C DisplayPort video
+- Memory
+ - 2 x DDR4 SODIMM
+- Networking
+ - AX210 2230 WiFi / Bluetooth
+- Sound
+ - Realtek ALC269-VB6
+ - 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
+ - 1920x1080 CCD camera
+ - USB 3.1 Gen 2 (left)
+ - USB 3.1 Gen 2 Type-A (left)
+ - USB 3.1 Gen 1 Type-A (right)
+ - USB 2.0 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)
+* 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_starbook_adl
+make
+```
+
+## Flashing coreboot
+
+```eval_rst
++---------------------+------------+
+| Type | Value |
++=====================+============+
+| Socketed flash | no |
++---------------------+------------+
+| Vendor | Winbond |
++---------------------+------------+
+| Model | W25Q256.V |
++---------------------+------------+
+| Size | 32 MiB |
++---------------------+------------+
+| Package | SOIC-8 |
++---------------------+------------+
+| Internal flashing | yes |
++---------------------+------------+
+| External flashing | yes |
++---------------------+------------+
+
+Please see [here](../common/flashing.md) for instructions on how to flash with fwupd.