summaryrefslogtreecommitdiff
path: root/Documentation/mainboard/starlabs
diff options
context:
space:
mode:
authorSean Rhodes <sean@starlabs.systems>2024-02-22 20:07:54 +0000
committerFelix Held <felix-coreboot@felixheld.de>2024-09-06 13:54:14 +0000
commit30394db47564a231f775fa9c06796f4b18ee1203 (patch)
tree6d18ea76574b6c3519493754cba5a59fd627b27c /Documentation/mainboard/starlabs
parent216d8e19658881bce23014fc682185665c6e83e6 (diff)
mb/starlabs/byte_adl: Add Alder Lake N Byte Mk II
Tested using `edk2` from `github.com/starlabsltd/edk2/tree/uefipayload_vs`: * Windows 11 * Ubuntu 22.04 * Manjaro 22 No known issues. https://starlabs.systems/pages/byte-specification Signed-off-by: Sean Rhodes <sean@starlabs.systems> Change-Id: Idff2d883a8c29f0fee9d633708aac92061a45132 Reviewed-on: https://review.coreboot.org/c/coreboot/+/80705 Tested-by: build bot (Jenkins) <no-reply@coreboot.org> Reviewed-by: Matt DeVillier <matt.devillier@gmail.com>
Diffstat (limited to 'Documentation/mainboard/starlabs')
-rw-r--r--Documentation/mainboard/starlabs/byte_adl.md83
1 files changed, 83 insertions, 0 deletions
diff --git a/Documentation/mainboard/starlabs/byte_adl.md b/Documentation/mainboard/starlabs/byte_adl.md
new file mode 100644
index 0000000000..d357a5a6be
--- /dev/null
+++ b/Documentation/mainboard/starlabs/byte_adl.md
@@ -0,0 +1,83 @@
+# StarBook Mk V
+
+## Specs
+
+- CPU (full processor specs available at https://ark.intel.com)
+ - Intel N200 (Alder Lake)
+- EC
+ - ITE IT5570E
+ - Charger, using AC adapter or USB-C PD
+ - Suspend / resume
+- GPU
+ - IntelĀ® IrisĀ® Xe Graphics
+ - GOP driver is recommended, VBT is provided
+ - HDMI video
+ - DisplayPort video
+ - USB-C DisplayPort video
+- Memory
+ - 1 x DDR4 SODIMM
+- Networking
+ - 9560 2230 WiFi / Bluetooth
+ - Realtek RLT8111 1Gbps
+ - Realtek RLT8125B 2.5Gbps
+- Sound
+ - SoundWire SN6140
+ - Combined headphone / microphone 3.5-mm jack
+ - HDMI audio
+ - USB-C DisplayPort audio
+- Storage
+ - M.2 PCIe SSD
+- USB
+ - 2 x USB 3.1 Gen 2 Type-A (front)
+ - 1 x USB 3.1 Gen 2 Type-C (front)
+ - 2 x USB 3.1 Gen 2 Type-A (back)
+
+## Building coreboot
+
+Please follow the [Star Labs build instructions](common/building.md) to build coreboot, using `config.starlabs_starbook_adl` as config file.
+
+### 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_byte_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.