Mini-KVM

Openterface MiniKVM 鍵盤與鼠標無法工作問題根因分析

Openterface Team Product Updates

過去一個月裏，一些用户報告了 Openterface MiniKVM 的間歇性問題，最常見的是鍵盤和鼠標不穩定。我們在此公開透明地説明發生了什麼、如何定位到根因、以及我們已採取和將繼續採取的補救措施。

第一批量產：穩定且反饋良好

在眾籌期間，我們生產了第一批 4,000 台 Openterface MiniKVM 單元。 該批次通過了我們的完整內部 QA 流程，總體質量良好。僅有少量問題被報告，大多數用户對穩定性和可用性都表示滿意。

這讓我們對硬件設計和生產流程充滿信心。

第二批次：相同設計、相同工廠、“相同”零件

第一批售罄後，我們又在相同工廠並從相同供應商處採購零件，生產了第二批 500 台 Openterface MiniKVM。

其中一個關鍵元件是來自 WCH 的 CH213K 理想二極管。 在 Openterface MiniKVM 裏，這個元件用於保護並隔離主機側與目標側的 USB 電源路徑，以防止反向電流和非預期的電源注入。

在第二批中，CH213K 的絲印標記發生了變化：

  • 第一批：“13K”
  • 第二批：“3k10”

因為零件編號、供應商與公開規格並未改變，我們最初將其視為常規的批次或標記更新，並未把它當作風險因素。

CH213K_Compare.png

QA 結果：易被忽略的微妙信號

我們按第一批相同的 QA 程序進行了測試。總體不良率略有上升，但仍在我們認為可接受的範圍內。沒有單一的故障模式顯著突出，結果也未指向特定元件或設計問題。事後看來，這種微小的退化其實是早期信號，但我們沒有深入調查。

用户報告觸發深入排查

上個月開始，我們收到越來越多用户報告描述鍵盤與鼠標失靈的問題。一個顯著特徵是問題依賴於諸如：

  • 主機電腦型號
  • 目標電腦型號
  • 使用的 USB 線纜

這種可變性提示一個電源路徑的邊緣情況，而非固件或 USB 協議問題。因此我們系統性地比較了兩次生產之間的所有變化。

通過此過程，我們確定了帶“3k10”絲印的 CH213K 理想二極管是受影響單元的共同因素。

根因：低概率、依賴環境的電源不穩定

通過電壓測量與對比測試，我們觀察到如下行為：

  • 使用舊款 “13K” 理想二極管的單元：
    • 在所有測試的主機、目標和線纜組合中，內部 USB 電壓保持穩定。
  • 使用新版 “3k10” 標記的單元：
    • 大多數情況下，內部電壓仍然穩定，設備正常工作。
    • 但基於用户報告與後續測試，約有一小部分（大約 ~5%）單元在特定的主機與 USB 線組合下會出現內部電壓不穩定。

該行為不具確定性，不會在所有設置中復現，這解釋了為何常規 QA 難以復現。但按我們規模來看，這樣的發生率已足夠嚴重，需要立刻調查。

由於 CH213K 處於 USB 電源路徑上，若該處出現電壓不穩定，會向下遊傳播並影響 USB HID 行為，導致鍵盤或鼠標間歇失效。

雖然兩者都標為 CH213K，但實測在不同 USB 電源條件下的真實表現顯示出標記或內部製程差異導致的行為差異。

CH213K_InternalVoltage

驗證：通過增加輸出電容恢復穩定性

為驗證假設，我們引入了有針對性的硬件修改：

  • 在 CH213K 理想二極管的輸出端增加 10 µF 電容。

加入該電容後，我們在之前出現問題的組合裏恢復了內部電壓穩定性。鍵盤與鼠標行為迴歸正常，證明問題與電源穩定性相關，而非固件或 USB 協議邏輯引起。

fixed_test

此外，我們開發了基於 ESP32 的快速 QA 驗證工具，用於測量 MiniKVM 單元的 Vpp（峯峯值電壓紋波），無需示波器即可操作。這讓 QA 工程師能在生產與複檢時快速且一致地檢查電源質量，即便在實驗室以外的環境也能篩查那些功能測試難以捕獲的邊緣情況。

ESP32_QA_Tool

我們對受影響用户的處理措施

在技術調查與修復並行進行時，我們優先減少用户影響並提升支持效率：

  1. 跨平台自檢工具 我們開發了適用於 macOS、Windows 與 Linux 的自檢工具，幫助用户快速判斷鍵盤或鼠標不穩是否與本次問題相關，並讓他們能直接將結果回報給我們。 對於確認受影響的案例，我們會立即寄出替換機，無需通過耗時的分銷商側核查流程。
  2. 暫停出貨並主動硬件修復 在確認問題後，我們暫時停止了現有庫存的出貨。現發貨的新批庫存已包含 電容修復，確保後續與未來的銷售不會受到此類低概率但真實問題的影響。
  3. 實時技術支持以加速解決 對於難以自查的用户，我們提供實時通話支持，一同排查並驗證，避免冗長的郵件往返，從而更快識別與解決問題。

我們的收穫

這次事件強化了幾項重要經驗：

  1. 即便零件編號未變，電源路徑元件在不同批次或內部版本間可能仍有細微行為差異。
  2. QA 不良率的小幅上升可能是更深層問題的早期信號。
  3. 現實世界的 USB 電源環境差異極大，受控測試難以完全覆蓋。
  4. 當問題發生時，及時的人對人支持在用户體驗上與技術修復同等重要。

我們的承諾

我們對沒有更早發現該問題承擔全部責任。透明度對我們很重要，用户應得到清晰且誠懇的技術説明。

接下來我們將：

  • 更新硬件設計以提升 USB 電源路徑的穩定裕量。
  • 加強對電源路徑元件的驗證與表徵，即便零件編號未變也要重新確認行為。
  • 使用基於 ESP32 的快速 QA 工具，讓 QA 工程師無需示波器即可測量 Vpp，使電源穩定性檢測更快速、可重複並能擴展至生產線。
  • 精細化 QA 門限與測試覆蓋，提升對低概率、依賴環境問題的捕捉能力。

如果您懷疑您的設備可能受影響或希望針對您的具體環境諮詢，請通過 [email protected] 聯繫我們——我們會盡力支持並補救。

感謝您的耐心、反饋與對 Openterface MiniKVM 的信任。

此致，

Openterface Team | TechxArtisan