S2P-XInput-Lite-v0.1.0

S2P-XInput-Lite 的第一個公開版本。

本專案是一個輕量化的 Windows 控制器橋接工具，透過 ESP32-S3 與 Switch 2 Pro Controller 通訊，並在 Windows 上輸出為標準的 Xbox 360 / XInput 虛擬控制器。

此版本主要專注於 ESP32-S3 橋接 → XInput 輸出，並在 XInput 架構基礎上提供自訂控制、搖桿校正與 HD Rumble 2 震動轉換功能。

v0.1.0 主要功能

• 透過 ESP32-S3 USB CDC 橋接控制器
• 自動偵測相容的 ESP32-S3 裝置
• 輸出 Xbox 360 / XInput 虛擬控制器
• 自訂按鍵映射
• 自訂左右搖桿方向映射
• 類比搖桿校正
• 鍵盤按鍵映射
• XInput 震動轉換為 HD Rumble 2
• 可調整 LF / HF 震動頻率與強度
• 可調整 LF / HF 響應曲線
• LF → HF 與 HF → LF 震動補償
• 最大震動振幅限制
• 圖形化設定介面
• ViGEmBus 安裝狀態檢查
• 控制器 Pin 震動定位功能
• 連線成功後設定 Player 1 LED
• 內附 ESP32-S3 相容橋接韌體與刷寫工具
• 內含可攜式 Python 執行環境，無需另外安裝 Python

系統需求

• Windows x64
• 相容的 ESP32-S3 裝置
• Switch 2 Pro Controller
• ViGEmBus 1.22.0

如果尚未安裝 ViGEmBus，可以執行：

Install-ViGEmBus.bat

腳本會從官方來源下載並啟動 ViGEmBus 1.22.0 安裝程式。

使用方式

1. 安裝 ViGEmBus 1.22.0。
2. 將 ESP32-S3 連接至電腦。
3. 如有需要，先使用內附工具刷入相容的 ESP32-S3 橋接韌體。
4. 執行 S2P-XInput-Lite.exe。
5. 在圖形化介面中完成設定並啟動連線程式。
6. 按下控制器任意按鍵喚醒控制器並等待連線。

目前限制

此版本專注於 XInput 輸出，因此目前：

• 一次僅支援一支控制器
• 僅支援 Windows
• 不支援陀螺儀與加速度計動作輸入
• 不支援 Joy-Con 配對
• 不支援 PS5 控制器模擬
• 不支援音訊觸覺

如果需要更多控制器功能或更完整的實作，可以參考 TommyWabg 的 Switch2Connect 專案。

注意事項

這是第一個公開版本，部分功能仍可能需要進一步測試與調整。

S2P-XInput-Lite 是非官方社群專案，與 Nintendo、Microsoft、Espressif Systems 或其他第三方不存在官方隸屬、認可、贊助或合作關係。

本專案採用 GNU General Public License v3.0（GPL-3.0）授權。

第三方元件、上游來源與相關授權資訊請參閱 THIRD_PARTY_NOTICES.md。