diff --git a/docs/hardware/en/kvm/NanoKVM_Pro/extended.md b/docs/hardware/en/kvm/NanoKVM_Pro/extended.md index 39fa91afa8..0fca3086d9 100644 --- a/docs/hardware/en/kvm/NanoKVM_Pro/extended.md +++ b/docs/hardware/en/kvm/NanoKVM_Pro/extended.md @@ -190,6 +190,18 @@ The NCM function allows the NanoKVM to simulate a USB network card, enabling use - **ATX/Desk**: From the web interface, go to `Settings` → `Device` → enable `Virtual Network` - **Desk**: From the screen, tap `Settings` → `USB` → enable `NCM` +### USB Host / Device Switching + +To manually switch the USB role, run the following commands in the web terminal or via SSH: + +```shell +# Switch to Device mode +echo device > /sys/class/usb_role/8000000.dwc3-role-switch/role + +# Switch to Host mode +echo host > /sys/class/usb_role/8000000.dwc3-role-switch/role +``` + ### USB Secondary Display > **Supported only on NanoKVM-Desk** @@ -498,6 +510,27 @@ Version 1.2.0 comes with six built-in EDIDs. Below is the list of supported reso 5. **File write failure** Ensure `C:\Users\Public\` is writable, or modify the script to use another writable directory. +## How to Force a Specific Resolution + +To force a specific input resolution, you must set all three parameters: `FPS`, `width`, and `height`. The setting will not take effect if any one is missing. + +Temporary (lost after reboot): + +```shell +echo 60 > /sys/module/lt6911_manage/parameters/force_fps +echo 1920 > /sys/module/lt6911_manage/parameters/force_width +echo 1080 > /sys/module/lt6911_manage/parameters/force_height +``` + +Persistent (kept after reboot): + +```shell +echo 60 > /boot/force_fps +echo 1920 > /boot/force_width +echo 1080 > /boot/force_height +reboot +``` + ## How to Modify USB Information Versions `1.2.0` and above support customizing USB information. The method is as follows: diff --git a/docs/hardware/zh/kvm/NanoKVM_Pro/extended.md b/docs/hardware/zh/kvm/NanoKVM_Pro/extended.md index 4ba18aad7b..8492f46db2 100644 --- a/docs/hardware/zh/kvm/NanoKVM_Pro/extended.md +++ b/docs/hardware/zh/kvm/NanoKVM_Pro/extended.md @@ -171,6 +171,18 @@ NCM 功能可通过 USB 模拟网卡,方便用户直接通过 USB 登录 NanoK - **ATX/Desk**:从网页端进入 `设置` → `设备` → 开启 `虚拟网卡` - **Desk**:从屏幕中点击 `Settings` → `USB` 进入 USB 配置页面,开启 `NCM` +### USB Host / Device 切换 + +如需手动切换 USB 角色,可在网页终端或 SSH 中执行以下命令: + +```shell +# 切换为 Device 模式 +echo device > /sys/class/usb_role/8000000.dwc3-role-switch/role + +# 切换为 Host 模式 +echo host > /sys/class/usb_role/8000000.dwc3-role-switch/role +``` + ## 更新 NanoKVM Pro 会不定时推送新版本的应用,包含新功能和bug修复,您可以在`设置`->`检查更新`中更新应用版本。 @@ -396,6 +408,27 @@ cat /kvmcomm/edid/e18.bin > /proc/lt6911_info/edid 4. **EDID 属性不存在**:某些显示器或远程会话下可能无 EDID,建议直接在本机物理显示器上操作。 5. **文件写入失败**:确保 `C:\Users\Public\` 可写,或修改为其他可写路径。 +## 如何强制指定分辨率 + +如需强制指定输入分辨率,需要同时设置 `FPS`、`宽度`、`高度` 三项参数,缺一不可。 + +临时生效(重启后失效): + +```shell +echo 60 > /sys/module/lt6911_manage/parameters/force_fps +echo 1920 > /sys/module/lt6911_manage/parameters/force_width +echo 1080 > /sys/module/lt6911_manage/parameters/force_height +``` + +永久生效(重启后保留): + +```shell +echo 60 > /boot/force_fps +echo 1920 > /boot/force_width +echo 1080 > /boot/force_height +reboot +``` + ## 如何修改USB信息 `1.2.0`版本以上支持自定义USB信息,方式如下: