mb/apple: Add MacBook Pro 10,1 (A1398) supportmacbookpro10_1

MacBook Pro 15 (Mid 2012/Early 2013) with Ivy Bridge CPU
and Retina Display.

Not all RAM configurations are supported at the monent, see comment
in early_init.c.

Used autoported config as a template.

Change-Id: Ica03aba442493c0d369a3d360ad569ddc16954df
Signed-off-by: Evgeny Zinoviev <me@ch1p.io>

1 files changed, 118 insertions, 0 deletions

diff --git a/Documentation/mainboard/apple/macbookpro10_1.md b/Documentation/mainboard/apple/macbookpro10_1.md
new file mode 100644
index 0000000000..b27e887b85
--- /dev/null
+++ b/Documentation/mainboard/apple/macbookpro10_1.md
@@ -0,0 +1,118 @@
+# Apple MacBook Pro 10,1
+
+This page describes how to run coreboot on MacBook Pro 10,1, also known
+as 15'' Mid 2012/Early 2013 with Retina Display.
+
+```eval_rst
++-------------+-------------+
+| Model No.   | Motherboard |
++=============+=============+
+| A1398       | 820-3332    |
++-------------+-------------+
+```
+
+## RAM configuration
+
+This laptop comes with 15 different memory module configurations. Not all of
+them are supported at the moment. To determine which configuration you have in
+your MacBook Pro 10,1, you can use inteltool and
+[this script](https://github.com/gch1p/get_macbook_ramcfg). You need to run them
+on the target machine.
+
+First, build inteltool:
+```console
+$ cd util/inteltool
+$ make -j4
+```
+
+Download the script and make it executable. Then run:
+```console
+sudo ./inteltool -g | /path/to/get_macbook_ramcfg -m mbp101
+```
+
+You should get a name of RAM configuration installed in your MacBook. Use the
+table below to determine if it's supported.
+
+```eval_rst
++-------------------+-----------+
+| RAM configuration | Supported |
++===================+===========+
+| 4g_hynix_1600s    | No        |
++-------------------+-----------+
+| 1g_samsung_1600   | No        |
++-------------------+-----------+
+| 4g_samsung_1600s  | No        |
++-------------------+-----------+
+| 1g_hynix_1600     | No        |
++-------------------+-----------+
+| 4g_elpida_1600s   | No        |
++-------------------+-----------+
+| 2g_samsung_1600   | No        |
++-------------------+-----------+
+| 2g_samsung_1333   | No        |
++-------------------+-----------+
+| 2g_hynix_1600     | **Yes**   |
++-------------------+-----------+
+| 4g_samsung_1600   | No        |
++-------------------+-----------+
+| 4g_hynix_1600     | **Yes**   |
++-------------------+-----------+
+| 2g_elpida_1600s   | No        |
++-------------------+-----------+
+| 2g_elpida_1600    | No        |
++-------------------+-----------+
+| 4g_elpida_1600    | No        |
++-------------------+-----------+
+| 2g_samsung_1600s  | No        |
++-------------------+-----------+
+| 2g_hynix_1600s    | No        |
++-------------------+-----------+
+```
+
+If your RAM configuration is not supported, you can help supporting it. Run
+`sudo inteltool -m`, save output to a text file and send a message to coreboot
+[mailing list](/community/forums.html) specifying your memory configuration name
+with the text file attached.
+
+## Flashing instructions
+
+The board has one 8 MiB Macronix flash chip. To access the chip, you need to
+remove the back cover.
+
+![](mbp101_board.jpg)
+
+The flash layout of the OEM firmware is as follows:
+
+    00000000:00000fff fd
+    00190000:007fffff bios
+    00001000:0018ffff me
+
+## Working
+
+- Some memory configurations (see above)
+- libgfxinit
+- VGA ROM loading
+- Integrated GPU
+- Discrete GPU
+- SeaBIOS, GRUB, TianoCore
+- Linux 4.9, Linux 5.8
+- Wi-Fi
+- Both USB ports
+- Trackpad
+- me_cleaner
+- Integrated/Discrete graphics selection via nvramtool
+- Camera
+- Mic
+- SD card reader
+- Speaker
+- usbdebug (the usb port on the right side)
+- Backlight control via gmux (/sys/class/backlight/gmux_backlight),
+  works out of box on Ubuntu 20.04
+
+## Untested
+
+- Thunderbolt
+- FireWire
+
+## TODOs
+- Support other memory configurations