From 53b9277b6c00fbe168a9f72feb352cea4f3bd336 Mon Sep 17 00:00:00 2001
From: alfrix <alfredomonclus@gmail.com>
Date: Sat, 9 Mar 2024 16:03:16 -0300
Subject: [PATCH] docs: improve hdmi and rotation

---
 docs/Hardware/HDMI.md            | 20 ++++++++++++++------
 docs/Troubleshooting/Rotation.md | 20 +++++++++++++++++---
 2 files changed, 31 insertions(+), 9 deletions(-)

diff --git a/docs/Hardware/HDMI.md b/docs/Hardware/HDMI.md
index ed233223..9e977c29 100644
--- a/docs/Hardware/HDMI.md
+++ b/docs/Hardware/HDMI.md
@@ -21,12 +21,20 @@ more complex example:
 video=HDMI-A-1:1920x1080M@60,rotate=90,reflect_x
 ```
 
-| Device      | 	Display                                        |
-|-------------|-------------------------------------------------|
-| HDMI-A-1    | HDMI 1 (sometimes HDMI 0 on PCB)                |
-| HDMI-A-2    | HDMI 2 (sometimes HDMI 1 on PCB if starts at 0) |
-| DSI-1       | DSI or DPI                                      |
-| Composite-1 | Composite                                       |
+???+ "Find the identifier use xrandr"
+    on a terminal run:
+    ```sh
+    DISPLAY=:0 xrandr
+    ```
+
+    it will output something like:
+    ```
+    Screen 0: minimum 320 x 200, current 1024 x 600, maximum 8192 x 8192
+    HDMI-1 connected primary 1024x600+0+0 (normal left inverted right x axis y axis) 800mm x 450mm
+    ```
+    in this case the identifier is HDMI-1 and a simple cmdline arg would be something like:
+
+    `video=HDMI-1:1024x600@60`
 
 
 Valid mode specifiers:
diff --git a/docs/Troubleshooting/Rotation.md b/docs/Troubleshooting/Rotation.md
index 6f3978de..a78d431f 100644
--- a/docs/Troubleshooting/Rotation.md
+++ b/docs/Troubleshooting/Rotation.md
@@ -10,17 +10,29 @@ here are some examples:
 
 ???+ example "Universal xorg configuration"
 
+    Find the identifier use xrandr
+
+    ```sh
+    DISPLAY=:0 xrandr
+    ```
+
+    it will output something like:
+    ```
+    Screen 0: minimum 320 x 200, current 1024 x 600, maximum 8192 x 8192
+    HDMI-1 connected primary 1024x600+0+0 (normal left inverted right x axis y axis) 800mm x 450mm
+    ```
+
+    Take not that the screen is `HDMI-1` (it could be `HDMI-A-1` or many other names)
+
     Create /usr/share/X11/xorg.conf.d/90-monitor.conf
     ```bash
     sudo nano /usr/share/X11/xorg.conf.d/90-monitor.conf
     ```
-
     Paste this section modifying the options to suit your needs:
     ```kconfig
     Section "Monitor"
-        Identifier "HDMI-A-1"
+        Identifier "HDMI-1"
         # This identifier would be the same as the name of the connector printed by xrandr
-        # DISPLAY=:0 xrandr
         # for example  "DVI-I-1 connected primary" means that the identifier is "DVI-I-1"
         # another example "Unknown19-1 connected primary" some GPIO screens identify as Unknown19
 
@@ -37,6 +49,8 @@ here are some examples:
     sudo service KlipperScreen restart
     ```
 
+    you may have to adjust the [touch rotation](../Touch_issues/#touch-rotation-and-matrix)
+
 ??? example "Using Waveshare screen that is installed with LCD-show"
 
     ```bash