# Framework Laptop 12 Intel Core Series 3 (Dahlia)

## Support Status

This port is currently not officially supported by Framework. It is a
proof of concept for internal evaluation of the technical feasability of
coreboot at Framework.

All mainboards sold to customers ship with BootGuard enabled. While it is
possible for end users to build the image with publicly available source
and binaries, flashing will not result in a bootable system.

## Specs

- CPU (full processor specs available at <https://ark.intel.com>)
    - Intel Core Series 3 (Wildcat Lake)
- EC
    - Nuvoton NPCX 993 with Chrome EC firmware
    - Backlit keyboard, with standard PS/2 keycodes and I2C HID hotkeys
    - 50Wh Battery
    - Suspend / resume (S0ix, not S3)
- GPU
    - Intel® Iris® Xe Graphics
    - GOP driver is recommended, VBT is provided
    - HDMI/USB-C DisplayPort video
- Memory
    - 1x SODIMM slot for up to 64GB DDR5-5600
- Networking
    - BE213 M.2 2230 CNVio3 WiFi / Bluetooth
    - Or compatible with PCIe Gen2 x1 WiFi / Bluetooth
- Storage
    - M.2 2230 PCIe Gen4 x4 SSD
- Sound
    - Realtek ALC285 HDA Codec
    - Internal speakers
    - Internal microphone
    - Combined headphone / microphone 3.5-mm jack
    - USB-C DisplayPort/HDMI audio
- Built-in devices
    - I2C HID PTP Touchpad
    - I2C HID Touchscreen
    - I2C HID Mediakeys
    - Intel fTPM
    - Intel RAPL power reporting
    - USB Camera
    - USB Fingerprint reader
    - eSPI PS2 Keyboard
    - eSPI PS2 emulated mouse/touchpad (if OS has no I2C driver)
- 4 Type-C Ports
    - All
        - USB-PD 3.2
        - 100W USB PD 3.0 Charging
    - Back Left and Right
        - Thunderbolt 4 (40G)
        - USB3 Gen2x2
        - DisplayPort 2.1 Alt-Mode (HBR3 + DSC)
    - Front Left and Right
        - USB3 Gen2x1

### Build

The following commands will build a working image:

```bash
make distclean # Note: this will remove your current config, if it exists.
touch .config
./util/scripts/config --enable VENDOR_FRAMEWORK
./util/scripts/config --enable BOARD_FRAMEWORK_DAHLIA

make olddefconfig
make -j$(nproc)
```

If you don’t plan on using coreboot’s serial console to collect logs, you might
want to disable it at this point (./util/scripts/config --disable CONSOLE_SERIAL).
It should reduce the boot time by several seconds.

## Flashing coreboot

```{eval-rst}
+---------------------+------------+
| Type                | Value      |
+=====================+============+
| Socketed flash      | no         |
+---------------------+------------+
| Vendor              | Winbond    |
+---------------------+------------+
| Model               | W25Q256JV  |
+---------------------+------------+
| Size                | 32 MiB     |
+---------------------+------------+
| Package             | WSON-8     |
+---------------------+------------+
| Internal flashing   | yes        |
+---------------------+------------+
| External flashing   | yes        |
+---------------------+------------+
```

Flashing example with BusPirate 5 connected to socketed ROM:

```
flashrom --ifd -i bios --noverify-all -w build/coreboot.rom --progress -p buspirate_spi:dev=/dev/ttyACM1,serialspeed=115200
```

## Serial Console

Serial console is available through JECDB header (unpopulated on MP) or Type-C CCD UART on the front right port.

See [FrameworkDebugger](https://github.com/frameworkComputer/FrameworkDebugger) for details.