Skip to content

wevsty/KVM-over-USB

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

KVM over USB

Code style: black usb_kvm_client_release

一个简单的KVM USB方案

Documentation English Version: https://github.com/wevsty/KVM-over-USB/blob/main/README_en-us.md

简介

当服务器因为各种因素失去网络连接时想恢复工作是很困难的事,尽管有IPMI一类的技术可以帮助我们解决问题,但往往这类设备是昂贵的。 对于家庭用户来说,本方案能帮助你使用其他PC/笔记本电脑通过USB连接快速的管理/维护服务器。

硬件

对于大部分用户来说,要求用户自己制造PCB是困难的。 一个非盈利项目如果要委托制造商生产显然也是困难的。 所以本项目推荐使用市面上已有的产品进行组合。

硬件清单

  1. 视频采集卡:可以使用MS2109或MS2130等芯片的视频采集卡,市场售价约为30到100元人民币。
  2. CH340转CH9329的USB连接线: CH340是一个常见的USB转串口芯片,通过串口接入CH9329,最终将CH9329连接到被控制的设备即可。

备注1:在购物平台上有成品的线,可直接购买,市场售价约20元人民币。

备注2:如有特殊需要,也可以自行购入使用其他芯片的USB转串口连接线(比如:FT232)然后购买带有串行接口的CH9329模块使用。

  1. HDMI连接线。
  2. 如设备没有足够多的USB接口,建议搭配一个USB HUB使用。

连接原理图

image

硬件实物图

image

软件

项目软件客户端基于 KVM-Card-Mini-PySide6 的源码进行了改动以及重构,适配了 CH9329 作为键盘鼠标输入使用。

客户端编译

假定您已经安装好 git、python、poetry 后您可以执行如下命令进行编译。

git clone https://github.com/wevsty/KVM-over-USB.git
cd client
poetry shell
poetry install
./compiler.ps1

客户端下载

请访问 releases 页面下载已编译好的客户端。

注意:目前客户端(控制端)仅提供 Windows 支持。

https://github.com/wevsty/KVM-over-USB/releases

使用方法

  1. 如果您使用的USB转串口芯片为 CH340 ,您可能需要首先安装 CH340 的驱动程序。

CH340 驱动程序下载地址: https://www.wch.cn/downloads/CH341SER_EXE.html

安装成功后可通过设备管理器查看串口端口号。

image

备注:端口号可能为随机非固定。

  1. 执行 usb_kvm_client

视频连接: 选择设备菜单 -> 视频设备 -> 选择正确的视频采集卡 -> 确定。

image

控制器连接:

大部分情况下,默认配置会自动选择串口。但若您的设备上拥有多个串口,您可能需要手动选择串口名称。

选择设备菜单 -> 控制器设置 -> 选择正确的串口 -> 确定。

image

演示

演示控制ASUS BIOS

image

FAQ

Q: 为什么被控制端为 Linux 的时候鼠标不工作?

A: 部分操作系统不支持鼠标使用绝对坐标模式,请尝试切换至相对坐标模式进行操作。

Q: 如何发送 Ctrl + Alt + Delete 组合键?

A: 由于 Windows 机制的原因很难拦截此类组合键。如需向被控制端发送这些组合键,请使用键盘菜单中的快捷键功能。

Q: 使用软件时出现卡键情况怎么办?

A: 请使用软件设备菜单中的重载或者重置功能,大部分情况下均可恢复正常。 如使用后依然存在类似于卡键的故障建议重启被控制端的操作系统。

感谢

Jackadminx/KVM-Card-Mini

ElluIFX/KVM-Card-Mini-PySide6

binnehot/KVM-over-USB

Packages

No packages published

Languages

  • Python 98.9%
  • PowerShell 1.1%