aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorArsalan H. Awan <Arsalan_Awan@mentor.com>2021-10-26 20:55:38 +0500
committerArsalan H. Awan <Arsalan_Awan@mentor.com>2021-10-26 20:55:38 +0500
commit8956245aeb5d724fbe02362d5507f9b12ce4bc63 (patch)
treeaf3cd62efa24eefbd9ec1bb6caac02e8b93c0757
parentff37efe307110bca6b16f595f99056f9ad7deb18 (diff)
downloadmeta-amd-8956245aeb5d724fbe02362d5507f9b12ce4bc63.tar.gz
meta-amd-8956245aeb5d724fbe02362d5507f9b12ce4bc63.tar.bz2
meta-amd-8956245aeb5d724fbe02362d5507f9b12ce4bc63.zip
docs/CUSTOMIZE.md: add console customizations & limitations on vermeer
Signed-off-by: Arsalan H. Awan <Arsalan_Awan@mentor.com>
-rw-r--r--CUSTOMIZE.md26
1 files changed, 26 insertions, 0 deletions
diff --git a/CUSTOMIZE.md b/CUSTOMIZE.md
index 71eeffc9..76156f27 100644
--- a/CUSTOMIZE.md
+++ b/CUSTOMIZE.md
@@ -55,6 +55,32 @@ EXTRA_IMAGE_FEATURES_append = " tools-profile"
RT_KERNEL_AMD = "yes"
```
+Furthermore, the `vermeer` platform does not have an on-board RS232
+serial port. Therefore, the graphical console is enabled on this
+machine by default and the user is required to interact with the
+machine using a display device plugged into a dGPU connected via the
+PCIe slot.
+
+In case the user does not have a dGPU, and wants to interact with the
+machine over the RS232 serial interface, the user needs to have an
+`LPC to UART Adapter` module plugged into the LPC header on the
+motherboard.
+
+Using a serial cable connected between the host machine's RS232 port
+and this module, the user will be able to interact with the machine
+using the serial interface, but will still not be able to install the
+OS to a harddrive using the serial interface. For that, the graphical
+console has to be disabled. In order to achieve that, add the
+following to the `local.conf` and rebuild an image.
+
+```sh
+MACHINE_FEATURES_remove = "screen-console"
+```
+
+The resulting image will have no graphical console support and will
+only have the serial console support. After this, the user will also
+be able to install the OS to a harddrive using the serial interface.
+
---
#### What's next