docs(nanokvm-go): add resolution and EDID settings guide

docs/hardware/en/kvm/NanoKVM_Go/resolution.md

@@ -0,0 +1,133 @@
+---
+title: Resolution and EDID Settings
+keywords: NanoKVM Go, resolution, EDID, Windows, macOS, display, scaling
+update:
+  - date: 2026-07-31
+    version: v0.1
+    author: Liang Ziyue
+    content:
+      - Add NanoKVM Go resolution and EDID settings guide
+---
+
+## Introduction
+
+NanoKVM Go provides EDID information to the target device. After the target device reads the EDID, it outputs video according to the display modes declared by that EDID. Therefore, the maximum resolution available on the target device usually depends on the EDID currently selected on NanoKVM Go.
+
+The resolution shown in the operating system display settings does not always represent the actual video output resolution. Some options may be scaled display modes. If you want NanoKVM Go to receive a specific real output resolution, select a resolution and refresh rate combination that exists in the EDID instead of only changing the scaled display size.
+
+## EDID and Resolution
+
+EDID tells the target device which resolutions, refresh rates, and display parameters the current "monitor" supports. NanoKVM Go is recognized by the target device as a monitor, and the target device generates available display modes based on the EDID provided by NanoKVM Go.
+
+For example, if NanoKVM Go is using the `1920x1080 60Hz` EDID, the target device usually will not output a real resolution higher than the range declared by that EDID. To use higher resolutions such as `2560x1440 60Hz`, `3440x1440 60Hz`, or `3840x2160 30Hz`, switch NanoKVM Go to the corresponding EDID first.
+
+The table below lists the recommended real output modes for each EDID. Only the resolution and refresh rate combinations listed in this table are recommended as target real output modes for NanoKVM Go. Other resolutions or refresh rates shown by the operating system but not listed in the table should be treated as scaled modes, compatibility modes, modes beyond the device specifications, or modes derived by the system.
+
+| Resolution | Aspect ratio | 1920×1080@60Hz EDID | 2560×1440@60Hz EDID | 3440×1440@60Hz EDID | 3840×2160@30Hz EDID |
+| --- | --- | --- | --- | --- | --- |
+| 3840×2160 | 16:9 | × | × | × | 30 Hz |
+| 3440×1440 | 43:18 (~21:9) | × | × | 30 / 60 Hz | 60 Hz |
+| 2560×1440 | 16:9 | × | 30 / 60 Hz | 30 / 60 Hz | 30 / 60 Hz |
+| 1920×1200 | 16:10 | × | 60 Hz | 60 Hz | 60 Hz |
+| 1920×1080 | 16:9 | 30 / 50 / 60 Hz | 30 / 60 Hz | 30 / 60 Hz | 30 / 50 / 60 Hz |
+| 1600×900 | 16:9 | 60 Hz | 60 Hz | 60 Hz | 60 Hz |
+| 1280×1024 | 5:4 | 60 Hz | 60 Hz | 60 Hz | 60 Hz |
+| 1280×960 | 4:3 | 60 Hz | 60 Hz | 60 Hz | 60 Hz |
+| 1280×720 | 16:9 | 30 / 50 / 60 Hz | 60 Hz | 60 Hz | 30 / 50 / 60 Hz |
+| 1024×768 | 4:3 | 60 Hz | 60 Hz | 60 Hz | 60 Hz |
+| 800×600 | 4:3 | 60 Hz | 60 Hz | 60 Hz | 60 Hz |
+| 640×480 | 4:3 | 60 Hz | 60 Hz | 60 Hz | 60 Hz |
+
+> Connect PD power before changing EDID. If PD power is not connected, NanoKVM Go may need to be restarted manually after switching EDID.
+>
+> After changing EDID, the target device may briefly go black, re-detect the display, or rearrange windows. This is normal.
+
+## Select EDID on NanoKVM Go
+
+1. Open the NanoKVM Go web control page.
+2. Click the image settings entry in the top floating toolbar.
+3. Select the EDID that matches the target resolution.
+
+![NanoKVM Go EDID options](./../../../assets/NanoKVM/go/resolution/nanokvm-go-edid-list-en.webp)
+
+4. Wait for the target device to re-detect the display.
+5. Select the target output resolution again in the target device operating system.
+
+## Set the Real Output Resolution on Windows
+
+On Windows, if you change the resolution directly from `Settings` > `System` > `Display`, the system may use a scaled display mode. In that case, the image received by NanoKVM Go may not be the real output resolution you expected.
+
+To set the real output resolution, select it from the valid mode list, and confirm that the selected resolution and refresh rate combination exists in the EDID table above:
+
+1. Open Windows `Settings`.
+2. Go to `System` > `Display`.
+
+![Windows display settings](./../../../assets/NanoKVM/go/resolution/windows-display-settings-en.webp)
+
+3. Click `Advanced display`.
+
+![Windows advanced display](./../../../assets/NanoKVM/go/resolution/windows-advanced-display-en.webp)
+
+4. If multiple displays are connected, select `NanoKVM-Go` on the Advanced display page first.
+5. Click `Display adapter properties` for the current display.
+
+![Windows display adapter properties](./../../../assets/NanoKVM/go/resolution/windows-display-adapter-properties-en.webp)
+
+6. In the dialog, click `List All Modes`.
+
+![Windows List All Modes](./../../../assets/NanoKVM/go/resolution/windows-list-all-modes-en.webp)
+
+7. Select a target resolution and refresh rate listed in the table above.
+
+![Windows valid modes list](./../../../assets/NanoKVM/go/resolution/windows-valid-modes-en.webp)
+
+8. Confirm and apply the setting.
+
+For example, if you need a real `1920 x 1080 60Hz` output, select the corresponding `1920 x 1080, 60 Hertz` mode from `List All Modes`.
+
+## Set the Real Output Resolution on macOS
+
+On macOS, the display settings may show both regular resolutions and resolutions marked as "low resolution".
+
++ Options without "low resolution" are usually HiDPI or scaled display modes;
++ Options with "low resolution" usually indicate real output modes without HiDPI scaling.
+
+However, selecting "low resolution" does not always guarantee that the final output is the target native mode. You also need to confirm that the refresh rate for that resolution exists in the EDID table above. If the refresh rate does not match, macOS may still use a scaled mode or another compatibility output mode.
+
+1. Open macOS `System Settings`.
+2. Go to `Displays`.
+3. Select `NanoKVM-Go` from the display list.
+
+![macOS NanoKVM-Go display](./../../../assets/NanoKVM/go/resolution/macos-display-nanokvm-go-en.webp)
+
+4. Turn on `Show all resolutions`.
+
+![macOS Show all resolutions](./../../../assets/NanoKVM/go/resolution/macos-show-all-resolutions-en.webp)
+
+5. Find the target resolution in the resolution list.
+6. Select the target mode marked as "low resolution", and make sure its resolution and refresh rate combination is listed in the table above.
+7. After confirming that the image is displayed correctly, return to NanoKVM Go and check the current image resolution.
+
+For example, if you want the target Mac to output a real `1920 x 1080 60Hz` signal, select `1920 x 1080 (low resolution)` and confirm that the refresh rate is `60Hz`. If you only select the regular scaled `1920 x 1080` option, or if you select a refresh rate that is not declared by the EDID, the result may still be a scaled image.
+
+## FAQ
+
+### Why does the image look scaled after I select a resolution?
+
+The operating system may have selected a scaled display mode instead of a real output mode. Enter the valid mode list for the current system and select a resolution and refresh rate combination listed in the table above.
+
+On Windows, use `List All Modes` to select both the resolution and refresh rate. On macOS, select the corresponding resolution marked as "low resolution", and confirm that the refresh rate is also listed in the table.
+
+### Why is the resolution I want not shown?
+
+Check whether the current EDID selected on NanoKVM Go supports that resolution and refresh rate combination. If the EDID does not declare the corresponding display mode, the target device usually will not show that option, or it may only provide a scaled display mode.
+
+After switching EDID, wait for the system to re-detect the display. If the target resolution still does not appear, try reconnecting the NanoKVM Go data cable or restarting the target device.
+
+### Why does the screen briefly go black after changing EDID?
+
+After EDID is changed, the target device re-detects the display and negotiates the output mode again. A brief black screen during this process is normal.
+
+### Is a higher resolution always better?
+
+Not always. Higher resolutions increase the load for video encoding, network transmission, and browser rendering. For BIOS settings, system installation, or remote maintenance, choose a stable and clear resolution with lower latency.

docs/hardware/en/sidebar.yaml

@@ -550,6 +550,8 @@ items:
             file: kvm/NanoKVM_Go/quick_start.md
         -   label: User Guide
             file: kvm/NanoKVM_Go/user_guide.md
+        -   label: Resolution and EDID Settings
+            file: kvm/NanoKVM_Go/resolution.md
         -   label: MCP
             file: kvm/NanoKVM_Go/mcp.md
         -   label: Update Application

docs/hardware/zh/kvm/NanoKVM_Go/resolution.md

@@ -0,0 +1,134 @@
+---
+title: 分辨率与 EDID 设置
+keywords: NanoKVM Go, 分辨率, EDID, Windows, macOS, 显示器, 缩放
+update:
+  - date: 2026-07-31
+    version: v0.1
+    author: Liang Ziyue
+    content:
+      - 新增 NanoKVM Go 分辨率与 EDID 设置说明
+---
+
+## 简介
+
+NanoKVM Go 会向被控设备提供一组 EDID 信息。被控设备读取 EDID 后，会根据 EDID 中声明的显示模式输出画面。因此，被控设备可以选择的最大分辨率，通常取决于 NanoKVM Go 当前使用的 EDID 设置。
+
+需要注意的是，操作系统设置页面中看到的分辨率，不一定都代表真实的视频输出分辨率。有些选项可能是系统缩放后的显示效果。若希望 NanoKVM Go 获取到指定的真实输出分辨率，需要同时选择 EDID 中存在的分辨率和刷新率组合，而不是只调整缩放显示效果。
+
+## EDID 与分辨率的关系
+
+EDID 用于告诉被控设备当前“显示器”支持哪些分辨率、刷新率和显示参数。NanoKVM Go 会被被控设备识别为一台显示器，被控设备会根据 NanoKVM Go 提供的 EDID 生成可选的显示模式。
+
+例如，如果 NanoKVM Go 当前使用的是 `1920x1080 60Hz` EDID，被控设备通常不会输出超过该 EDID 声明范围的真实分辨率。如果切换到 `2560x1440 60Hz`、`3440x1440 60Hz` 或 `3840x2160 30Hz` EDID，被控设备才可能显示对应的更高分辨率选项。
+
+下表列出了不同 EDID 下建议选择的真实输出模式。只有表格中列出的分辨率和刷新率组合，才建议作为 NanoKVM Go 的目标真实输出模式。操作系统中出现但没有列在表格中的其他分辨率或刷新率，都应按系统缩放、兼容模式、超出设备规格或额外推导出的显示效果理解。
+
+| 分辨率 | 宽高比 | 1920×1080@60Hz EDID | 2560×1440@60Hz EDID | 3440×1440@60Hz EDID | 3840×2160@30Hz EDID |
+| --- | --- | --- | --- | --- | --- |
+| 3840×2160 | 16:9 | × | × | × | 30 Hz |
+| 3440×1440 | 43:18（约 21:9） | × | × | 30 / 60 Hz | 60 Hz |
+| 2560×1440 | 16:9 | × | 30 / 60 Hz | 30 / 60 Hz | 30 / 60 Hz |
+| 1920×1200 | 16:10 | × | 60 Hz | 60 Hz | 60 Hz |
+| 1920×1080 | 16:9 | 30 / 50 / 60 Hz | 30 / 60 Hz | 30 / 60 Hz | 30 / 50 / 60 Hz |
+| 1600×900 | 16:9 | 60 Hz | 60 Hz | 60 Hz | 60 Hz |
+| 1280×1024 | 5:4 | 60 Hz | 60 Hz | 60 Hz | 60 Hz |
+| 1280×960 | 4:3 | 60 Hz | 60 Hz | 60 Hz | 60 Hz |
+| 1280×720 | 16:9 | 30 / 50 / 60 Hz | 60 Hz | 60 Hz | 30 / 50 / 60 Hz |
+| 1024×768 | 4:3 | 60 Hz | 60 Hz | 60 Hz | 60 Hz |
+| 800×600 | 4:3 | 60 Hz | 60 Hz | 60 Hz | 60 Hz |
+| 640×480 | 4:3 | 60 Hz | 60 Hz | 60 Hz | 60 Hz |
+
+> 修改 EDID 前请先插入 PD 电源。如果不接通 PD 电源，切换 EDID 后可能需要手动重启才能正常使用。
+>
+> 修改 EDID 后，被控设备可能会短暂黑屏、重新识别显示器或重新排列窗口。这是正常现象。
+
+## 在 NanoKVM Go 中选择 EDID
+
+1. 打开 NanoKVM Go Web 控制页面。
+2. 点击顶部悬浮栏中的屏幕标志。
+3. 在 EDID 选项中选择目标分辨率对应的 EDID。
+
+![NanoKVM Go EDID 选项](./../../../assets/NanoKVM/go/resolution/nanokvm-go-edid-list-zh.webp)
+
+4. 等待被控设备重新识别显示器。
+5. 在被控设备系统中重新选择目标输出分辨率。
+
+
+## Windows 设置真实输出分辨率
+
+在 Windows 中，如果直接通过 `设置` > `系统` > `屏幕` 中的显示器分辨率修改分辨率，系统有时会使用缩放后的显示效果。此时 NanoKVM Go 获取到的画面，可能不是用户期望的真实输出分辨率。
+
+如果需要设置真实输出分辨率，建议从有效模式列表中选择，并确认所选的分辨率和刷新率组合存在于上面的 EDID 表格中：
+
+1. 打开 Windows `设置`。
+2. 进入 `系统` > `屏幕`。
+
+![Windows 显示设置](./../../../assets/NanoKVM/go/resolution/windows-display-settings-zh.webp)
+
+3. 点击 `高级显示器设置`。
+
+![Windows 高级显示器设置](./../../../assets/NanoKVM/go/resolution/windows-advanced-display-zh.webp)
+
+4. 如果连接了多个显示器，请先在高级显示页面中选择 `NanoKVM-Go`。
+5. 点击当前显示器的 `显示器适配器属性`。
+
+![Windows 显示器适配器属性入口](./../../../assets/NanoKVM/go/resolution/windows-display-adapter-properties-zh.webp)
+
+6. 在弹出的窗口中点击 `列出所有模式`。
+
+![Windows 列出所有模式](./../../../assets/NanoKVM/go/resolution/windows-list-all-modes-zh.webp)
+
+7. 在有效模式列表中选择表格中列出的目标分辨率和刷新率。
+
+![Windows 有效模式列表](./../../../assets/NanoKVM/go/resolution/windows-valid-modes-zh.webp)
+
+8. 点击确认并应用设置。
+
+
+## macOS 设置真实输出分辨率
+
+在 macOS 中，显示设置里可能同时出现普通分辨率和带有“低分辨率”标记的分辨率。
+
++ 不带“低分辨率”的选项通常是 HiDPI 或缩放显示效果；
++ 带有“低分辨率”的选项通常表示未经过 HiDPI 缩放的实际输出模式。
+
+不过，选择“低分辨率”并不一定代表最终就是目标原生模式。还需要确认该分辨率对应的刷新率也存在于上面的 EDID 表格中。如果刷新率不匹配，macOS 仍然可能使用缩放模式或其他兼容输出模式。
+
+1. 打开 macOS `系统设置`。
+2. 进入 `显示器`。
+3. 在显示器列表中选择 `NanoKVM-Go`。
+
+![macOS 选择 NanoKVM-Go 显示器](./../../../assets/NanoKVM/go/resolution/macos-display-nanokvm-go-zh.webp)
+
+4. 打开 `显示所有分辨率` 的开关。
+
+![macOS 显示所有分辨率](./../../../assets/NanoKVM/go/resolution/macos-show-all-resolutions-zh.webp)
+
+5. 在分辨率列表中找到目标分辨率。
+6. 选择带有“低分辨率”标记，并且分辨率和刷新率组合存在于上表中的目标模式。
+7. 确认画面正常显示后，返回 NanoKVM Go 查看当前画面分辨率。
+
+例如，如果希望被控 Mac 实际输出 `1920 x 1080 60Hz`，请优先选择 `1920 x 1080（低分辨率）`，并确认刷新率为 `60Hz`。如果只选择普通的 `1920 x 1080` 缩放显示选项，或者选择了 EDID 中没有列出的刷新率，就可能得到缩放后的画面。
+
+
+## 常见问题
+
+### 为什么设置了某个分辨率，但 NanoKVM Go 显示的画面像是缩放后的？
+
+可能是操作系统选择了缩放显示效果，而不是实际输出模式。请根据当前系统进入有效模式列表，并选择表格中列出的分辨率和刷新率组合。
+
+在 Windows 中，建议使用 `列出所有模式` 选择分辨率和刷新率。在 macOS 中，建议选择带有“低分辨率”标记的对应分辨率，并确认刷新率也在表格中。
+
+### 为什么系统中看不到我想要的分辨率？
+
+请检查 NanoKVM Go 当前使用的 EDID 是否支持该分辨率和刷新率组合。如果 EDID 中没有声明对应的显示模式，被控设备通常不会显示该选项，或者只提供缩放后的显示效果。
+
+切换 EDID 后，请等待系统重新识别显示器。如果仍然看不到目标分辨率，可以尝试重新插拔 NanoKVM Go 的数据线，或重启被控设备。
+
+### 修改 EDID 后为什么会短暂黑屏？
+
+修改 EDID 后，被控设备会重新识别显示器，并重新协商输出模式。这个过程中可能会短暂黑屏，属于正常现象。
+
+### 分辨率越高越好吗？
+
+不一定。更高分辨率会增加画面编码、网络传输和浏览器显示压力。如果只是进行 BIOS 设置、系统安装或远程维护，建议优先选择稳定、清晰且延迟较低的分辨率。

docs/hardware/zh/sidebar.yaml

@@ -551,6 +551,8 @@ items:
             file: kvm/NanoKVM_Go/quick_start.md
         -   label: 用户指南
             file: kvm/NanoKVM_Go/user_guide.md
+        -   label: 分辨率与 EDID 设置
+            file: kvm/NanoKVM_Go/resolution.md
         -   label: MCP 功能
             file: kvm/NanoKVM_Go/mcp.md
         -   label: 更新应用