erebion/coreboot
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
coreboot/Documentation/mainboard/starlabs/byte.md
Sean Rhodes e02dc13b87 mainboard/starlabs: move Byte under adl/ 
Move the Star Labs Byte (Mk II / Mk III) into the ADL grouping under
src/mainboard/starlabs/adl/.

Like StarBook Horizon, model differences live under
src/mainboard/starlabs/adl/variants/ using SKU-style variant directories
to share common configuration. Byte Mk II (ADL) and Byte Mk III (TWL)
share a single "y2" variant directory.

Update MAINBOARD_DIR and CMOS layout handling so binary blob paths and
NVRAM options continue to resolve correctly.

Update the documentation to reflect the new blobs path.

Note that BUILD_TIMELESS ROM hashes change since MAINBOARD_DIR is
embedded in the CBFS config file.

BUG=None
TEST=BUILD_TIMELESS=1 build STARLABS_BYTE_ADL
Change-Id: I4b6be115a4ab2316d5ca4cc8e656e3643518273e
Signed-off-by: Sean Rhodes <sean@starlabs.systems>
Reviewed-on: https://review.coreboot.org/c/coreboot/+/91255
Reviewed-by: Angel Pons <th3fanbus@gmail.com>
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
2026-03-02 08:48:58 +00:00

2.5 KiB
Raw Blame History

Byte Mk II

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 to build coreboot, using config.starlabs_byte_adl (Byte Mk II) or config.starlabs_byte_twl (Byte Mk III) 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)

coreboot expects these binaries under 3rdparty/blobs/mainboard/starlabs/adl/<variant>/, where <variant> matches CONFIG_VARIANT_DIR (default: y2).

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:

make distclean
make defconfig KBUILD_DEFCONFIG=configs/config.starlabs_byte_adl
# or
make defconfig KBUILD_DEFCONFIG=configs/config.starlabs_byte_twl
make

Flashing coreboot

+---------------------+------------+
| 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 for instructions on how to flash with fwupd.