文档教程【免费下载链接】pikvmOpen and inexpensive DIY IP-KVM based on Raspberry Pi项目地址https://gitcode.com/gh_mirrors/pi/pikvm点击查看免费下载如果你购买了 Ezcoo 出品的USB 3.0 版多端口 KVM 交换机并希望配合 PiKVM 使用那么必须将 KVMD 升级到 2.65 或更高版本并在配置中额外添加一个protocol: 2选项。本文以 PiKVM 官方发布公告为基础完整说明升级方法、/etc/kvmd/override.yaml配置细节、两种协议版本的差异以及 ezCoo 驱动在 KVMD 中的底层工作方式帮助你在一台 PiKVM 上通过 ezCoo 交换机远程控制多台主机。为什么需要这次更新Ezcoo 悄悄改写了管理协议Ezcoo 的受管 KVM 交换机如 EZ-SW41HA-KVMU3L / U3P侧面带有一个 Micro USB 管理口插入 Raspberry Pi 后通常以/dev/ttyUSB0串口设备呈现。KVMD 通过该串口向交换机发送文本命令如切换输入源、读取当前输入状态从而把交换机伪装成一个 GPIO 设备进而在 PiKVM 的 Web 界面中渲染出通道切换按钮和指示灯。问题在于USB 3.0 版 Ezcoo 交换机更换了管理协议。官方发布公告明确指出Ezcoo 出于某种原因改变了协议格式参见 docs/blog/posts/2021/2021-05-09/index.md。KVMD 2.65 为此新增了对新协议协议 2的支持因此旧版 KVMD 无法正确驱动 USB 3.0 版 Ezcoo 交换机升级到 KVMD 2.65 后还需要在配置中为 ezcoo 驱动显式声明protocol: 2驱动才会按新协议发送命令。顺带说明2.59 与 2.65 之间缺失的若干版本号据发布公告是用于筹备即将到来的H.264 视频支持与本次 Ezcoo 修复无关。第一步将 PiKVM OS 升级到 KVMD 2.65在 root 用户下依次执行以下命令完成系统更新PiKVM OS 基于 Arch Linux ARM使用 pacman 管理软件包rw pacman -Syu reboot其中rw将只读文件系统切换为可写允许安装新软件包pacman -Syu同步软件仓库并全量升级会顺带将 KVMD 升级到 2.65reboot重启使新内核与 kvmd 服务生效。升级完成后 KVMD 即具备协议 2 的解析能力。如果系统中尚未安装pikvm-update这类辅助脚本可参考 docs/_update_os.md 中介绍的传统升级路径。建议在拥有设备物理访问权限时执行升级PiKVM 不会变砖但极端情况下可能需要重新刷写存储卡。第二步在 override.yaml 中声明protocol: 2KVMD 的可配置项统一写入/etc/kvmd/override.yaml。若要让 KVMD 在 GPIO 菜单中渲染出 ezCoo 的 4 个输入通道含当前输入指示灯与切换按钮可按如下配置完整范例来自 docs/ezcoo.mdkvmd: gpio: drivers: ez: type: ezcoo protocol: 2 # USB 3.0 版必填 device: /dev/ttyUSB0 # ezCoo 管理口在 Pi 上对应的串口设备 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]关键点解读protocol: 2声明使用新版管理协议仅 USB 3.0 版 Ezcoo 需要。若你手中的是旧的 USB 2.0 版已停产 EOL则必须删除这一行否则驱动会按错误的协议解析交换机应答。device: /dev/ttyUSB0假设交换机管理口出现在该设备节点。不同硬件环境可能不同需要先确认。scheme中的pin: 0..3对应 Ezcoo 的 4 个 HDMI 输入通道mode: input的通道以圆点指示灯渲染当前激活输入mode: output的通道渲染为切换按钮。switch: false关闭开关保持模式让输出通道表现为一次性的按下即切换按钮而非可保持状态的开关。view.table决定 Web 界面 GPIO 下拉菜单中的展示布局#Input X是表格标签可自由改名例如改为主机名改名后重启 kvmd 生效。关于缩进与文件系统的注意事项override.yaml使用 YAML 语法缩进必须严格统一为空格而非 Tab且每级缩进对应 4 个空格kvmd: # 0 空格 gpio: # 4 空格 drivers: # 8 空格 ez: # 12 空格该提醒主要针对旧版镜像较新镜像的 KVMD 已对配置解析更宽容但保持规范缩进仍是最稳妥的做法。第三步重启服务并验证修改完成后按顺序执行ro # 重新切回只读文件系统保护 SD 卡 systemctl restart kvmd随后进入 PiKVM 的 Web KVM 界面点击GPIO菜单应能看到 4 个输入项其中当前激活的输入带绿色圆点指示点击其他输入即可切换目标主机。若发现键盘/鼠标没有输出可在 SSH 或 Web 终端中检查串口设备是否存在ls -la /dev/tty* | grep USB如果无任何输出多半是 USB 线材只支持供电而不传输数据——大量充电线存在此问题请更换为确定支持数据传输的线缆。USB 2.0 旧版EOL的配置差异如果你使用老的USB 2.0 版Ezcoo 交换机配置与上文几乎一致但必须移除protocol: 2kvmd: gpio: drivers: ez: type: ezcoo device: /dev/ttyUSB0也就是说protocol: 2是 KVMD 2.65 为适配 USB 3.0 版新增的协议选择开关缺省行为对应旧版协议 1。底层原理ezcoo驱动如何把串口交换机伪装成 GPIO在 KVMD 的 GPIO 架构中ezcoo是一个特殊的伪驱动参见 docs/gpio.md 的 Hardware modules and pseudo-drivers 一节它并不读写树莓派的物理 GPIO 引脚而是通过串口向 Ezcoo 交换机发送文本命令来模拟 GPIO 行为——mode: input的通道对应读取当前输入状态用于绘制指示灯mode: output的通道对应切换到某个输入用于渲染按钮。因此 GPIO 配置中的三层结构在此场景下语义为配置层作用drivers声明一个名为ez的 ezcoo 驱动实例绑定串口设备与协议版本scheme把驱动的 4 个伪引脚映射为 4 个输入指示灯 4 个切换按钮view定义这些控件在 Web UI GPIO 下拉菜单中的排列方式KVMD 2.65 引入协议 2 后驱动发送的命令格式与应答解析都切换到新规范。官方在 docs/ezcoo.md 中附有协议 1 的系统 HELP 输出全文开发参考对比可见两个协议的差异集中在命令前缀与状态查询格式上协议 2 主要对应 USB 3.0 版本硬件。硬件连接与兼容性前提Ezcoo 交换机属于PiKVM 多端口交换机方案需要USB 主机口来连接管理串口因此并非所有 PiKVM 变体都支持详见 docs/_multiport_usb.md✅ 支持PiKVM V3、V4 Plus以及基于Raspberry Pi 2 / 3 / 4的 DIY 设备❌ 不支持PiKVM V4 Mini无 USB 主机口、单主机设备、基于Raspberry Pi Zero 2 W的 DIY 设备同样缺少 USB 主机口。典型接线方式图片来源docs/wiring_examples/ezcoo_wiring.jpg完整接线说明见 docs/wiring_examples.md将树莓派 OTG 口的 USB-C 线连接到 Ezcoo 交换机前面板的 USB 3 口或背板的 USB 1 口。注意如果接的是键盘口USB 2鼠标将无法工作将 Ezcoo 的 HDMI 输出接入 PiKVM 的 CSI-2→HDMI 采集也有用户报告 USB HDMI 采集棒可用用 USB-A 转 Micro USB 线把树莓派与 Ezcoo 侧面管理口相连按交换机说明书将各主机HDMI USB接入 Ezcoo 对应端口SSH 登录 PiKVM确认出现类似/dev/ttyUSB0的设备后再开始配置。另外需注意PiKVM 底层对已上电并连接显示器的主机视频线接入 CSI2-HDMI 编码器存在限制这一限制在使用 Ezcoo 交换机时同样适用。若 PiKVM 中看不到视频可尝试先关闭所有主机将其直接连到 Ezcoo 后再上电。常见排障视频异常在 Ezcoo 输出口外接显示器测试重新插拔线缆更换线缆逐一排除。切换异常SSH 或 Web 终端执行ls -la /dev/ttyUSB*确认管理口存在若没有输出换一条真正支持数据传输的 USB 线。鼠标缺失确认 OTG 线接在 Ezcoo 的 USB 3 口而不是键盘口USB 2。指示灯不更新 / 按钮无反应确认protocol: 2与你的交换机版本匹配——USB 3.0 版必须带protocol: 2USB 2.0 旧版必须不带。小结KVMD 2.65 的 Ezcoo 修复本质上是为USB 3.0 版交换机的新管理协议提供了驱动支持。对使用者而言关键动作只有两个pacman -Syu升级系统以及在override.yaml的 ezcoo 驱动配置中加入protocol: 2。配合 GPIO 的scheme/view配置即可在 PiKVM 网页端获得完整的四路输入切换面板让一台 PiKVM 从容管理多台主机。更完整的配置范例与协议参考可继续阅读 docs/ezcoo.md 与 docs/gpio.md。赞分享文档教程【免费下载链接】pikvmOpen and inexpensive DIY IP-KVM based on Raspberry Pi项目地址https://gitcode.com/gh_mirrors/pi/pikvm点击查看免费下载相关推荐PiKVM与ezCoo多端口KVM切换器的集成指南PiKVM与ezCoo多端口KVM切换器的集成指南 前言 PiKVM作为一个开源的KVM over IP解决方案可以通过网络远程管理服务器和设备。在实际生产环文档教程OpenClaw llama-cpp 插件参考托管与外部 llama.cpp 服务器、默认 GGUF 模型与本地嵌入OpenClaw llama cpp 插件参考托管与外部 llama.cpp 服务器、默认 GGUF 模型与本地嵌入 本文围绕 llama cpp 插件参考文文档教程Lima 容器化实战在虚拟机中运行 containerd、Docker、Podman 与 KubernetesLima 容器化实战在虚拟机中运行 containerd、Docker、Podman 与 Kubernetes Lima 是一个专注于运行 Linux 虚拟机文档教程上一篇图解仓颉编程函数教程从定义、参数到返回值的完整讲解下一篇5分钟搞定抖音无水印视频批量下载完全指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 PiKVM KVMD 2.65 更新指南：为 Ezcoo USB 3.0 多端口 KVM 交换机启用 `protocol: 2` 管理协议
文档教程【免费下载链接】pikvmOpen and inexpensive DIY IP-KVM based on Raspberry Pi项目地址https://gitcode.com/gh_mirrors/pi/pikvm点击查看免费下载如果你购买了 Ezcoo 出品的USB 3.0 版多端口 KVM 交换机并希望配合 PiKVM 使用那么必须将 KVMD 升级到 2.65 或更高版本并在配置中额外添加一个protocol: 2选项。本文以 PiKVM 官方发布公告为基础完整说明升级方法、/etc/kvmd/override.yaml配置细节、两种协议版本的差异以及 ezCoo 驱动在 KVMD 中的底层工作方式帮助你在一台 PiKVM 上通过 ezCoo 交换机远程控制多台主机。为什么需要这次更新Ezcoo 悄悄改写了管理协议Ezcoo 的受管 KVM 交换机如 EZ-SW41HA-KVMU3L / U3P侧面带有一个 Micro USB 管理口插入 Raspberry Pi 后通常以/dev/ttyUSB0串口设备呈现。KVMD 通过该串口向交换机发送文本命令如切换输入源、读取当前输入状态从而把交换机伪装成一个 GPIO 设备进而在 PiKVM 的 Web 界面中渲染出通道切换按钮和指示灯。问题在于USB 3.0 版 Ezcoo 交换机更换了管理协议。官方发布公告明确指出Ezcoo 出于某种原因改变了协议格式参见 docs/blog/posts/2021/2021-05-09/index.md。KVMD 2.65 为此新增了对新协议协议 2的支持因此旧版 KVMD 无法正确驱动 USB 3.0 版 Ezcoo 交换机升级到 KVMD 2.65 后还需要在配置中为 ezcoo 驱动显式声明protocol: 2驱动才会按新协议发送命令。顺带说明2.59 与 2.65 之间缺失的若干版本号据发布公告是用于筹备即将到来的H.264 视频支持与本次 Ezcoo 修复无关。第一步将 PiKVM OS 升级到 KVMD 2.65在 root 用户下依次执行以下命令完成系统更新PiKVM OS 基于 Arch Linux ARM使用 pacman 管理软件包rw pacman -Syu reboot其中rw将只读文件系统切换为可写允许安装新软件包pacman -Syu同步软件仓库并全量升级会顺带将 KVMD 升级到 2.65reboot重启使新内核与 kvmd 服务生效。升级完成后 KVMD 即具备协议 2 的解析能力。如果系统中尚未安装pikvm-update这类辅助脚本可参考 docs/_update_os.md 中介绍的传统升级路径。建议在拥有设备物理访问权限时执行升级PiKVM 不会变砖但极端情况下可能需要重新刷写存储卡。第二步在 override.yaml 中声明protocol: 2KVMD 的可配置项统一写入/etc/kvmd/override.yaml。若要让 KVMD 在 GPIO 菜单中渲染出 ezCoo 的 4 个输入通道含当前输入指示灯与切换按钮可按如下配置完整范例来自 docs/ezcoo.mdkvmd: gpio: drivers: ez: type: ezcoo protocol: 2 # USB 3.0 版必填 device: /dev/ttyUSB0 # ezCoo 管理口在 Pi 上对应的串口设备 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]关键点解读protocol: 2声明使用新版管理协议仅 USB 3.0 版 Ezcoo 需要。若你手中的是旧的 USB 2.0 版已停产 EOL则必须删除这一行否则驱动会按错误的协议解析交换机应答。device: /dev/ttyUSB0假设交换机管理口出现在该设备节点。不同硬件环境可能不同需要先确认。scheme中的pin: 0..3对应 Ezcoo 的 4 个 HDMI 输入通道mode: input的通道以圆点指示灯渲染当前激活输入mode: output的通道渲染为切换按钮。switch: false关闭开关保持模式让输出通道表现为一次性的按下即切换按钮而非可保持状态的开关。view.table决定 Web 界面 GPIO 下拉菜单中的展示布局#Input X是表格标签可自由改名例如改为主机名改名后重启 kvmd 生效。关于缩进与文件系统的注意事项override.yaml使用 YAML 语法缩进必须严格统一为空格而非 Tab且每级缩进对应 4 个空格kvmd: # 0 空格 gpio: # 4 空格 drivers: # 8 空格 ez: # 12 空格该提醒主要针对旧版镜像较新镜像的 KVMD 已对配置解析更宽容但保持规范缩进仍是最稳妥的做法。第三步重启服务并验证修改完成后按顺序执行ro # 重新切回只读文件系统保护 SD 卡 systemctl restart kvmd随后进入 PiKVM 的 Web KVM 界面点击GPIO菜单应能看到 4 个输入项其中当前激活的输入带绿色圆点指示点击其他输入即可切换目标主机。若发现键盘/鼠标没有输出可在 SSH 或 Web 终端中检查串口设备是否存在ls -la /dev/tty* | grep USB如果无任何输出多半是 USB 线材只支持供电而不传输数据——大量充电线存在此问题请更换为确定支持数据传输的线缆。USB 2.0 旧版EOL的配置差异如果你使用老的USB 2.0 版Ezcoo 交换机配置与上文几乎一致但必须移除protocol: 2kvmd: gpio: drivers: ez: type: ezcoo device: /dev/ttyUSB0也就是说protocol: 2是 KVMD 2.65 为适配 USB 3.0 版新增的协议选择开关缺省行为对应旧版协议 1。底层原理ezcoo驱动如何把串口交换机伪装成 GPIO在 KVMD 的 GPIO 架构中ezcoo是一个特殊的伪驱动参见 docs/gpio.md 的 Hardware modules and pseudo-drivers 一节它并不读写树莓派的物理 GPIO 引脚而是通过串口向 Ezcoo 交换机发送文本命令来模拟 GPIO 行为——mode: input的通道对应读取当前输入状态用于绘制指示灯mode: output的通道对应切换到某个输入用于渲染按钮。因此 GPIO 配置中的三层结构在此场景下语义为配置层作用drivers声明一个名为ez的 ezcoo 驱动实例绑定串口设备与协议版本scheme把驱动的 4 个伪引脚映射为 4 个输入指示灯 4 个切换按钮view定义这些控件在 Web UI GPIO 下拉菜单中的排列方式KVMD 2.65 引入协议 2 后驱动发送的命令格式与应答解析都切换到新规范。官方在 docs/ezcoo.md 中附有协议 1 的系统 HELP 输出全文开发参考对比可见两个协议的差异集中在命令前缀与状态查询格式上协议 2 主要对应 USB 3.0 版本硬件。硬件连接与兼容性前提Ezcoo 交换机属于PiKVM 多端口交换机方案需要USB 主机口来连接管理串口因此并非所有 PiKVM 变体都支持详见 docs/_multiport_usb.md✅ 支持PiKVM V3、V4 Plus以及基于Raspberry Pi 2 / 3 / 4的 DIY 设备❌ 不支持PiKVM V4 Mini无 USB 主机口、单主机设备、基于Raspberry Pi Zero 2 W的 DIY 设备同样缺少 USB 主机口。典型接线方式图片来源docs/wiring_examples/ezcoo_wiring.jpg完整接线说明见 docs/wiring_examples.md将树莓派 OTG 口的 USB-C 线连接到 Ezcoo 交换机前面板的 USB 3 口或背板的 USB 1 口。注意如果接的是键盘口USB 2鼠标将无法工作将 Ezcoo 的 HDMI 输出接入 PiKVM 的 CSI-2→HDMI 采集也有用户报告 USB HDMI 采集棒可用用 USB-A 转 Micro USB 线把树莓派与 Ezcoo 侧面管理口相连按交换机说明书将各主机HDMI USB接入 Ezcoo 对应端口SSH 登录 PiKVM确认出现类似/dev/ttyUSB0的设备后再开始配置。另外需注意PiKVM 底层对已上电并连接显示器的主机视频线接入 CSI2-HDMI 编码器存在限制这一限制在使用 Ezcoo 交换机时同样适用。若 PiKVM 中看不到视频可尝试先关闭所有主机将其直接连到 Ezcoo 后再上电。常见排障视频异常在 Ezcoo 输出口外接显示器测试重新插拔线缆更换线缆逐一排除。切换异常SSH 或 Web 终端执行ls -la /dev/ttyUSB*确认管理口存在若没有输出换一条真正支持数据传输的 USB 线。鼠标缺失确认 OTG 线接在 Ezcoo 的 USB 3 口而不是键盘口USB 2。指示灯不更新 / 按钮无反应确认protocol: 2与你的交换机版本匹配——USB 3.0 版必须带protocol: 2USB 2.0 旧版必须不带。小结KVMD 2.65 的 Ezcoo 修复本质上是为USB 3.0 版交换机的新管理协议提供了驱动支持。对使用者而言关键动作只有两个pacman -Syu升级系统以及在override.yaml的 ezcoo 驱动配置中加入protocol: 2。配合 GPIO 的scheme/view配置即可在 PiKVM 网页端获得完整的四路输入切换面板让一台 PiKVM 从容管理多台主机。更完整的配置范例与协议参考可继续阅读 docs/ezcoo.md 与 docs/gpio.md。赞分享文档教程【免费下载链接】pikvmOpen and inexpensive DIY IP-KVM based on Raspberry Pi项目地址https://gitcode.com/gh_mirrors/pi/pikvm点击查看免费下载相关推荐PiKVM与ezCoo多端口KVM切换器的集成指南PiKVM与ezCoo多端口KVM切换器的集成指南 前言 PiKVM作为一个开源的KVM over IP解决方案可以通过网络远程管理服务器和设备。在实际生产环文档教程OpenClaw llama-cpp 插件参考托管与外部 llama.cpp 服务器、默认 GGUF 模型与本地嵌入OpenClaw llama cpp 插件参考托管与外部 llama.cpp 服务器、默认 GGUF 模型与本地嵌入 本文围绕 llama cpp 插件参考文文档教程Lima 容器化实战在虚拟机中运行 containerd、Docker、Podman 与 KubernetesLima 容器化实战在虚拟机中运行 containerd、Docker、Podman 与 Kubernetes Lima 是一个专注于运行 Linux 虚拟机文档教程上一篇图解仓颉编程函数教程从定义、参数到返回值的完整讲解下一篇5分钟搞定抖音无水印视频批量下载完全指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考