Pavel Sayekat has uploaded this change for review. ( https://review.coreboot.org/c/coreboot/+/35011 )
Change subject: Doc/mb/asus: Add H110M-E/M.2 Documentation ......................................................................
Doc/mb/asus: Add H110M-E/M.2 Documentation
Followed and adapted from the ASRock H110M-DVS Documentation
Signed-off-by: Pavel Sayekat pavelsayekat@gmail.com Change-Id: I6c5aad50b513935eab70b502df1d95fb3413fa6b --- A Documentation/mainboard/asus/h110m-e_m2.md 1 file changed, 136 insertions(+), 0 deletions(-)
git pull ssh://review.coreboot.org:29418/coreboot refs/changes/11/35011/1
diff --git a/Documentation/mainboard/asus/h110m-e_m2.md b/Documentation/mainboard/asus/h110m-e_m2.md new file mode 100644 index 0000000..134dca8 --- /dev/null +++ b/Documentation/mainboard/asus/h110m-e_m2.md @@ -0,0 +1,136 @@ +# ASUS H110M-E/M.2 + +This page describes how to run coreboot on the [ASUS H110M-E/M.2]. + +## Required proprietary blobs + +Mainboard is based on Intel Skylake/Kaby Lake processor and H110 Chipset. +Intel company provides [Firmware Support Package (2.0)](../../soc/intel/fsp/index.md) +(intel FSP 2.0) to initialize this generation silicon. Please see this +[document](../../soc/intel/code_development_model/code_development_model.md). + +FSP Information: + +```eval_rst ++-----------------------------+-------------------+-------------------+ +| FSP Project Name | Directory | Specification | ++-----------------------------+-------------------+-------------------+ +| 7th Generation Intel® Core™ | KabylakeFspBinPkg | 2.0 | +| processors and chipsets | | | +| (formerly Kaby Lake) | | | ++-----------------------------+-------------------+-------------------+ +``` + +## Building coreboot + +The following steps set the default parameters for this board to build a +fully working image: + +```bash +make distclean +touch .config +./util/scripts/config --enable VENDOR_ASUS +./util/scripts/config --enable BOARD_ASUS_H110M_E_M2 +./util/scripts/config --enable CONFIG_ADD_FSP_BINARIES +./util/scripts/config --enable CONFIG_FSP_USE_REPO +./util/scripts/config --set-str REALTEK_8168_MACADDRESS "xx:xx:xx:xx:xx:xx" +make olddefconfig +``` + +However, it is strongly advised to use `make menuconfig` afterwards +(or instead), so that you can see all of the settings. + +Use the following command to disable the serial console if debugging +output is not required: + +```bash +./util/scripts/config --disable CONSOLE_SERIAL +``` + +However, a more flexible method is to change the console log level from +within an OS using `util/nvramtool`, or with the `nvramcui` payload. + +Now, run `make` to build the coreboot image. + +## Flashing coreboot + +### Internal programming + +The main SPI flash can be accessed using [flashrom]. By default, only +the BIOS region of the flash is writable. If you wish to change any +other region, such as the Management Engine or firmware descriptor, then +an external programmer is required (unless you find a clever way around +the flash protection). More information about this [here](../../flash_tutorial/index.md). + +### External programming + +The flash chip is a 16 MiB socketed DIP-8 chip. Specifically, it's a +GIgaDevice GD25B128CPIG, whose datasheet can be found [here][GD25B128CPIG]. +The chip is located to the bottom right-hand side of the board. For +a precise location, refer to section 1.3 (Motherboard Layout) of the +[H110M-E/M.2 manual], where the chip is labelled "128Mb BIOS". Take note of +the chip's orientation, remove it from its socket, and flash it with +an external programmer. For reference, the notch in the chip should be +facing towards the bottom of the board. + +## Known issues + +- The VGA port doesn't work. Discrete graphic card is used as primary + device for display output (if CONFIG_ONBOARD_VGA_IS_PRIMARY is not + set). Dynamic switching between iGPU and PEG is not yet supported. + +- SuperIO GPIO pin is used to reset Realtek chip. However, since the + Logical Device 7 (GPIO7, GPIO8) is not initialized, the network + chip is in a reset state all the time. + +## Untested + +- parallel port +- PS/2 keyboard +- PS/2 mouse +- EHCI debug +- TPM +- infrared module +- chassis intrusion header +- chassis speaker header + +## Working + +- integrated graphics init with libgfxinit (see [Known issues](#known-issues)) +- PCIe x1 +- PEG x16 Gen3 +- SATA +- USB +- serial port +- onboard audio +- using `me_cleaner` +- using `flashrom` + +## TODO + +- NCT5539D GPIOs +- onboard network (see [Known issues](#known-issues)) +- S3 suspend/resume +- Wake-on-LAN +- hardware monitor + +## Technology + +```eval_rst ++------------------+--------------------------------------------------+ +| CPU | Intel Skylake/Kaby Lake (LGA1151) | ++------------------+--------------------------------------------------+ +| PCH | Intel Sunrise Point H110 | ++------------------+--------------------------------------------------+ +| Super I/O | Nuvoton NCT5539D | ++------------------+--------------------------------------------------+ +| EC | None | ++------------------+--------------------------------------------------+ +| Coprocessor | Intel Management Engine | ++------------------+--------------------------------------------------+ +``` + +[ASUS H110M-E/M.2]: https://www.asus.com/Motherboards/H110M-E-M-2/overview/ +[GD25B128CPIG]: https://www.gigadevice.com/datasheet/gd25b127d/ [The closest match found] +[flashrom]: https://flashrom.org/Flashrom +[ASUS H110M-E/M.2 manual]: https://dlcdnets.asus.com/pub/ASUS/mb/LGA1151/H110M-E_M2/E11622_H110M-E_M2_U...
Pavel Sayekat has abandoned this change. ( https://review.coreboot.org/c/coreboot/+/35011 )
Change subject: Doc/mb/asus: Add H110M-E/M.2 Documentation ......................................................................
Abandoned
Pavlushka has restored this change. ( https://review.coreboot.org/c/coreboot/+/35011 )
Change subject: Doc/mb/asus: Add H110M-E/M.2 Documentation ......................................................................
Restored
Pavlushka has uploaded a new patch set (#2). ( https://review.coreboot.org/c/coreboot/+/35011 )
Change subject: Doc/mb/asus: Add H110M-E/M.2 Documentation. ......................................................................
Doc/mb/asus: Add H110M-E/M.2 Documentation.
Followed and adapted from the ASRock H110M-DVS Documentation.
Signed-off-by: Pavel Sayekat pavelsayekat@gmail.com Change-Id: I6c5aad50b513935eab70b502df1d95fb3413fa6b --- A Documentation/mainboard/asus/h110m-e_m2.md 1 file changed, 136 insertions(+), 0 deletions(-)
git pull ssh://review.coreboot.org:29418/coreboot refs/changes/11/35011/2
Paul Menzel has posted comments on this change. ( https://review.coreboot.org/c/coreboot/+/35011 )
Change subject: Doc/mb/asus: Add H110M-E/M.2 Documentation. ......................................................................
Patch Set 2:
(2 comments)
https://review.coreboot.org/c/coreboot/+/35011/2/Documentation/mainboard/asu... File Documentation/mainboard/asus/h110m-e_m2.md:
https://review.coreboot.org/c/coreboot/+/35011/2/Documentation/mainboard/asu... PS2, Line 48: ``` I’d indent small code blocks with four spaces.
https://review.coreboot.org/c/coreboot/+/35011/2/Documentation/mainboard/asu... PS2, Line 113: - S3 suspend/resume Is that still untested/not-working?
Hello build bot (Jenkins),
I'd like you to reexamine a change. Please visit
https://review.coreboot.org/c/coreboot/+/35011
to look at the new patch set (#3).
Change subject: Doc/mb/asus: Add H110M-E/M.2 Documentation. ......................................................................
Doc/mb/asus: Add H110M-E/M.2 Documentation.
Followed and adapted from the ASRock H110M-DVS Documentation.
Signed-off-by: Pavel Sayekat pavelsayekat@gmail.com Change-Id: I6c5aad50b513935eab70b502df1d95fb3413fa6b --- A Documentation/mainboard/asus/h110m-e_m2.jpg A Documentation/mainboard/asus/h110m-e_m2.md M Documentation/mainboard/index.md 3 files changed, 130 insertions(+), 0 deletions(-)
git pull ssh://review.coreboot.org:29418/coreboot refs/changes/11/35011/3
Hello build bot (Jenkins),
I'd like you to reexamine a change. Please visit
https://review.coreboot.org/c/coreboot/+/35011
to look at the new patch set (#4).
Change subject: Doc/mb/asus: Add H110M-E/M.2 Documentation. ......................................................................
Doc/mb/asus: Add H110M-E/M.2 Documentation.
Followed and adopted from the ASRock H110M-DVS Documentation.
Signed-off-by: Pavel Sayekat pavelsayekat@gmail.com Change-Id: I6c5aad50b513935eab70b502df1d95fb3413fa6b --- A Documentation/mainboard/asus/h110m-e_m2.jpg A Documentation/mainboard/asus/h110m-e_m2.md M Documentation/mainboard/index.md 3 files changed, 130 insertions(+), 0 deletions(-)
git pull ssh://review.coreboot.org:29418/coreboot refs/changes/11/35011/4
Pavlushka has posted comments on this change. ( https://review.coreboot.org/c/coreboot/+/35011 )
Change subject: Doc/mb/asus: Add H110M-E/M.2 Documentation. ......................................................................
Patch Set 4:
(2 comments)
https://review.coreboot.org/c/coreboot/+/35011/2/Documentation/mainboard/asu... File Documentation/mainboard/asus/h110m-e_m2.md:
https://review.coreboot.org/c/coreboot/+/35011/2/Documentation/mainboard/asu... PS2, Line 48: ```
I’d indent small code blocks with four spaces.
Done
https://review.coreboot.org/c/coreboot/+/35011/2/Documentation/mainboard/asu... PS2, Line 113: - S3 suspend/resume
Is that still untested/not-working?
Done
Hello build bot (Jenkins),
I'd like you to reexamine a change. Please visit
https://review.coreboot.org/c/coreboot/+/35011
to look at the new patch set (#5).
Change subject: Doc/mb/asus: Add H110M-E/M.2 Documentation. ......................................................................
Doc/mb/asus: Add H110M-E/M.2 Documentation.
Followed and adopted from the ASRock H110M-DVS Documentation.
Signed-off-by: Pavel Sayekat pavelsayekat@gmail.com Change-Id: I6c5aad50b513935eab70b502df1d95fb3413fa6b --- A Documentation/mainboard/asus/h110m-e_m2.jpg A Documentation/mainboard/asus/h110m-e_m2.md M Documentation/mainboard/index.md 3 files changed, 130 insertions(+), 0 deletions(-)
git pull ssh://review.coreboot.org:29418/coreboot refs/changes/11/35011/5
Angel Pons has posted comments on this change. ( https://review.coreboot.org/c/coreboot/+/35011 )
Change subject: Doc/mb/asus: Add H110M-E/M.2 Documentation. ......................................................................
Patch Set 5:
(2 comments)
https://review.coreboot.org/c/coreboot/+/35011/5//COMMIT_MSG Commit Message:
https://review.coreboot.org/c/coreboot/+/35011/5//COMMIT_MSG@7 PS5, Line 7: . No trailing period
https://review.coreboot.org/c/coreboot/+/35011/5/Documentation/mainboard/asu... File Documentation/mainboard/asus/h110m-e_m2.md:
https://review.coreboot.org/c/coreboot/+/35011/5/Documentation/mainboard/asu... PS5, Line 19: double space
Hello build bot (Jenkins), Maxim Polyakov, Paul Menzel, Angel Pons,
I'd like you to reexamine a change. Please visit
https://review.coreboot.org/c/coreboot/+/35011
to look at the new patch set (#6).
Change subject: Doc/mb/asus: Add H110M-E/M.2 Documentation ......................................................................
Doc/mb/asus: Add H110M-E/M.2 Documentation
Followed and adopted from the ASRock H110M-DVS Documentation.
Signed-off-by: Pavel Sayekat pavelsayekat@gmail.com Change-Id: I6c5aad50b513935eab70b502df1d95fb3413fa6b --- A Documentation/mainboard/asus/h110m-e_m2.jpg A Documentation/mainboard/asus/h110m-e_m2.md M Documentation/mainboard/index.md 3 files changed, 130 insertions(+), 0 deletions(-)
git pull ssh://review.coreboot.org:29418/coreboot refs/changes/11/35011/6
Pavlushka has posted comments on this change. ( https://review.coreboot.org/c/coreboot/+/35011 )
Change subject: Doc/mb/asus: Add H110M-E/M.2 Documentation ......................................................................
Patch Set 6:
(2 comments)
https://review.coreboot.org/c/coreboot/+/35011/5//COMMIT_MSG Commit Message:
https://review.coreboot.org/c/coreboot/+/35011/5//COMMIT_MSG@7 PS5, Line 7: .
No trailing period
Done
https://review.coreboot.org/c/coreboot/+/35011/5/Documentation/mainboard/asu... File Documentation/mainboard/asus/h110m-e_m2.md:
https://review.coreboot.org/c/coreboot/+/35011/5/Documentation/mainboard/asu... PS5, Line 19:
double space
Done
Stefan Reinauer has abandoned this change. ( https://review.coreboot.org/c/coreboot/+/35011?usp=email )
Change subject: Doc/mb/asus: Add H110M-E/M.2 Documentation ......................................................................
Abandoned
-
Angel Pons (Code Review) -
Paul Menzel (Code Review)
-
Pavel Sayekat (Code Review)
-
Pavlushka (Code Review)
-
Stefan Reinauer (Code Review)