PiKVM与ezCoo多端口KVM切换器的集成指南

PiKVM与ezCoo多端口KVM切换器的集成指南

pikvm Open and inexpensive DIY IP-KVM based on Raspberry Pi 项目地址: https://gitcode.com/gh_mirrors/pi/pikvm

前言

PiKVM作为一个开源的KVM over IP解决方案，可以通过网络远程管理服务器和设备。在实际生产环境中，我们经常需要管理多台主机，这时就需要借助KVM切换器来实现多主机切换。本文将详细介绍如何将ezCoo多端口KVM切换器与PiKVM集成，实现通过单一PiKVM设备管理多台主机的功能。

硬件准备

兼容设备

本文测试使用以下ezCoo切换器型号：

• EZ-SW41HA-KVMU3L（USB 3.0版本）
• EZ-SW41HA-KVMU3P（USB 3.0版本）
• 旧版USB 2.0型号（已停产）

连接线材需求

1. 标准HDMI线（用于视频传输）
2. USB线（根据版本选择）：
   • USB 3.0版本：USB-A to USB-A线
   • USB 2.0版本：USB-A to USB-B线
3. 额外的USB-A to Micro USB线（用于管理端口连接）

硬件连接指南

基础连接步骤

1. PiKVM与ezCoo连接：

   • 将PiKVM的OTG接口（通过USB-C分线器）连接到ezCoo的USB 3端口（前面板）或USB 1端口（后面板）
   • 注意：如果连接到键盘端口（USB 2），鼠标功能将无法使用

2. 视频连接：

   • 将ezCoo的HDMI输出连接到PiKVM的CSI-2转HDMI输入接口
   • 替代方案：也可以使用USB HDMI采集卡

3. 管理端口连接：

   • 使用USB-A to Micro USB线将PiKVM连接到ezCoo侧面的管理端口

4. 主机连接：

   • 按照ezCoo说明书将各主机连接到切换器的对应端口

连接注意事项

• 视频信号限制：当主机已连接显示器并开机时，直接连接到PiKVM的CSI-2 HDMI编码器可能会遇到视频信号问题。建议先连接所有主机到ezCoo，然后再开机。
• 管理端口识别：连接后，在PiKVM中应出现/dev/ttyUSB0设备。可通过SSH执行ls /dev/ttyUSB*命令验证。

软件配置

GPIO控制界面配置

要为PiKVM网页界面添加KVM切换控制按钮，需修改配置文件：

1. 启用SD卡读写模式：rw

2. 编辑配置文件：nano /etc/kvmd/override.yaml

3. 添加以下内容（假设KVM切换器设备为/dev/ttyUSB0）：

kvmd:
    gpio:
        drivers:
            ez:
                type: ezcoo
                protocol: 2
                device: /dev/ttyUSB0
        scheme:
            ch0_led:
                driver: ez
                pin: 0
                mode: input
            ch1_led:
                driver: ez
                pin: 1
                mode: input
            ch2_led:
                driver: ez
                pin: 2
                mode: input
            ch3_led:
                driver: ez
                pin: 3
                mode: input
            ch0_button:
                driver: ez
                pin: 0
                mode: output
                switch: false
            ch1_button:
                driver: ez
                pin: 1
                mode: output
                switch: false
            ch2_button:
                driver: ez
                pin: 2
                mode: output
                switch: false
            ch3_button:
                driver: ez
                pin: 3
                mode: output
                switch: false
        view:
            table:
                - ["#Input 1", ch0_led, ch0_button]
                - ["#Input 2", ch1_led, ch1_button]
                - ["#Input 3", ch2_led, ch2_button]
                - ["#Input 4", ch3_led, ch3_button]

4. 配置文件说明：

   • protocol: 2：指定使用协议版本2（USB 3.0型号）
   • 输入名称（如"#Input 1"）可自定义修改
   • 缩进必须使用空格（每级4个空格）

5. 恢复SD卡只读模式：ro

6. 重启kvmd服务：systemctl restart kvmd

USB 2.0版本特殊配置

对于旧版USB 2.0设备，需移除protocol: 2参数：

kvmd:
    gpio:
        drivers:
            ez:
                type: ezcoo
                device: /dev/ttyUSB0

使用指南

界面操作

1. 登录PiKVM网页界面
2. 进入KVM视图
3. 点击"GPIO"菜单按钮
4. 界面将显示4个输入通道：
   • 绿色圆圈表示当前选中的通道
   • 点击其他通道按钮切换主机

常见问题排查

视频问题：

1. 先将ezCoo输出连接到独立显示器测试
2. 重新插拔所有视频线缆
3. 尝试更换HDMI线

切换问题：

1. 通过SSH或网页终端登录PiKVM
2. 执行命令：ls -la /dev/ttyUSB*
   • 应有输出显示，若无输出则尝试更换管理线缆
3. 检查键盘鼠标功能：
   • 确认OTG线连接的是USB 3端口而非键盘端口

技术细节

协议版本差异

ezCoo切换器支持两种控制协议：

• 协议1：用于USB 2.0版本设备
• 协议2：用于USB 3.0版本设备

主要命令包括：

• 系统状态查询（EZSTA）
• 输入输出路由设置（EZS OUTx VS INy）
• EDID配置（EZS INx EDID y）
• 系统地址设置（EZS ADDR xx）

音频支持

目前音频功能尚未测试，可能无法正常工作。

总结

通过本文的配置，PiKVM可以完美控制ezCoo多端口KVM切换器，实现通过单一界面管理多台主机的功能。这种方案特别适合数据中心、实验室等需要集中管理多台设备的场景。配置过程中如遇到问题，建议按照排查步骤逐步检查硬件连接和软件配置。

pikvm Open and inexpensive DIY IP-KVM based on Raspberry Pi 项目地址: https://gitcode.com/gh_mirrors/pi/pikvm