mb/system76/oryp5: Add System76 Oryx Pro 5

Tested with TianoCore payload (UefiPayloadPkg).

Working:

- PS/2 keyboard, touchpad
- Both DIMM slots
- Both NVMe ports
- SATA port
- All USB ports
- Webcam
- Ethernet
- Integrated graphics
- Internal microphone
- S3 suspend/resume
- Flashing with flashrom
- Booting to Ubuntu Linux and Windows

Not working:

- Discrete/Hybrid graphics
- Internal speakers

These two require new drivers to work correctly, which will be added and
enabled later.

Change-Id: Iae6e530dcd52df3642cdfe74b65bfff5aa0dd402
Signed-off-by: Tim Crawford <tcrawford@system76.com>
Signed-off-by: Jeremy Soller <jeremy@system76.com>
Reviewed-on: https://review.coreboot.org/c/coreboot/+/47892
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
Reviewed-by: Angel Pons <th3fanbus@gmail.com>

2 files changed, 72 insertions, 0 deletions

diff --git a/Documentation/mainboard/index.md b/Documentation/mainboard/index.md
index b55876016aa4..3260f7348407 100644
--- a/Documentation/mainboard/index.md
+++ b/Documentation/mainboard/index.md
@@ -176,6 +176,7 @@ The boards in this section are not real mainboards, but emulators.
 ## System76
 
 - [Lemur Pro](system76/lemp9.md)
+- [Oryx Pro 5](system76/oryp5.md)
 
 ## Texas Instruments
 
diff --git a/Documentation/mainboard/system76/oryp5.md b/Documentation/mainboard/system76/oryp5.md
new file mode 100644
index 000000000000..662581cf1851
--- /dev/null
+++ b/Documentation/mainboard/system76/oryp5.md
@@ -0,0 +1,71 @@
+# System76 Oryx Pro 5 (oryp5)
+
+## Specs
+
+- CPU
+  - Intel Core i7-8750H
+  - Intel Core i7-9750H
+- EC
+  - ITE8587E running https://github.com/system76/ec
+- Graphics
+  - Intel UHD Graphics 630
+  - NVIDIA GeForce RTX 2080/2070/2060
+  - eDP 16.1" or 17.3" 1920x1080 @ 144 Hz LCD
+  - HDMI, Mini DisplayPort 1.3, and DisplayPort 1.3 over USB-C
+- Memory
+  - Channel 0: 8-GB/16-GB/32-GB DDR4 SO-DIMM
+  - Channel 1: 8-GB/16-GB/32-GB DDR4 SO-DIMM
+- Networking
+  - Gigabit Ethernet
+  - Intel Dual Band Wireless-AC 9560 Wireless LAN (802.11ac) + Bluetooth
+- Power
+  - 180W (19.5V, 9.23A) AC adapter
+  - 62Wh 4-cell battery
+- Sound
+  - Realtek ALC1220 codec
+  - TAS5825MRHBR smart AMP
+  - Internal speakers and microphone
+  - Combined headphone and microphone 3.5mm jack
+  - Combined microphone and S/PDIF 3.5mm jack
+  - HDMI, Mini DisplayPort, USB-C DP audio
+- Storage
+  - M.2 PCIe/SATA SSD1
+  - M.2 PCIe/SATA SSD2
+  - 2.5" SATA HDD/SSD
+  - RTS5250 SD card reader
+- USB
+  - 2x USB 3.1 Gen2 Type-C
+  - 2x USB 3.1 Gen1 Type-A
+
+## Building coreboot
+
+```bash
+make distclean
+make defconfig KBUILD_DEFCONFIG=configs/config.system76_oryp5
+make
+```
+
+## Flashing coreboot
+
+```eval_rst
++---------------------+---------------------+
+| Type                | Value               |
++=====================+=====================+
+| Socketed flash      | no                  |
++---------------------+---------------------+
+| Vendor              | GigaDevice          |
++---------------------+---------------------+
+| Model               | GD25Q127C/GD25Q128C |
++---------------------+---------------------+
+| Size                | 16 MiB              |
++---------------------+---------------------+
+| Package             | SOIC-8              |
++---------------------+---------------------+
+| Internal flashing   | yes                 |
++---------------------+---------------------+
+| External flashing   | yes                 |
++---------------------+---------------------+
+```
+
+External flashing via ISP requires removing the board from the chassis.
+The IC is located under the touchpad.