|author||Arsalan H. Awan <Arsalan_Awan@mentor.com>||2021-10-26 20:55:38 +0500|
|committer||Arsalan H. Awan <Arsalan_Awan@mentor.com>||2021-10-26 20:55:38 +0500|
docs/CUSTOMIZE.md: add console customizations & limitations on vermeer
Signed-off-by: Arsalan H. Awan <Arsalan_Awan@mentor.com>
1 files changed, 26 insertions, 0 deletions
diff --git a/CUSTOMIZE.md b/CUSTOMIZE.md
index 71eeffc9..76156f27 100644
@@ -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
+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
+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.
+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