Skip to content

S2P-XInput-Lite-v0.3.0

Pre-release
Pre-release

Choose a tag to compare

View all tags
@duoduo-88 duoduo-88 released this 15 Jul 20:13
v0.3.0
fb57dac
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

[English] | [繁體中文]

English

Update Summary

  • Added automatic ESP32-S3 detection with Windows native BLE fallback.
  • Improved ESP32 status heartbeat, disconnect handling, BLE notification retry, and throughput detection.
  • Added live connection, battery-level, ESP32, and ViGEmBus status.
  • Added per-controller stick, gyro, accelerometer, and magnetometer calibration.
  • Improved stick processing with time-based smoothing, stabilization, deadzones, smooth curves, and round-to-square output shape.
  • Expanded button and stick mapping with keyboard combinations, Windows/media keys, mouse buttons, wheel input, and reset buttons.
  • Improved HD Rumble 2 conversion and added game, WASAPI audio, and mixed vibration modes.
  • Added gyro mapping to an Xbox stick or mouse, including aim, tilt/steering, recentering, and stability controls.
  • Added Traditional Chinese/English switching for the GUI, tooltips, dialogs, calibration, and connection consoles.
  • Improved 1080p scrolling, 4K DPI scaling, configuration safety, firmware flashing, and shutdown cleanup.

Quick Start

  1. Install ViGEmBus with Install-ViGEmBus.bat if required.
  2. For native Bluetooth, do not pair the controller through Windows Bluetooth settings. The application handles the Bluetooth connection directly. For ESP32 mode, connect a compatible ESP32-S3 flashed with the required firmware.
  3. Run S2P-XInput-Lite.exe.
  4. Select the language with the 中 / En button.
  5. Adjust mappings and settings, then select Save.
  6. Select Restart and press any controller button to wake it.

The program checks for ESP32 first and automatically uses native Bluetooth when ESP32 is unavailable.

Calibration

  • Sticks: close the active connection, select Calibrate, choose ESP32 or native Bluetooth, and follow the prompts.
  • Motion sensors: connect the controller first, then use Sensor Cal on the gyro page and follow every stage carefully.
  • Calibration data is stored separately for each controller.

Vibration and Gyro

  • Vibration source can be Game, Audio, or Mix. Audio capture uses the Windows default output through WASAPI.
  • Set both LF and HF strength to 0.00 to disable vibration.
  • Gyro mapping is off by default. Select an activation method, output target, and activation button before use.
  • Save changed settings and restart the connection program before testing.

Important Notes

  • Windows 10/11 only; one controller at a time.
  • ViGEmBus is required for Xbox 360/XInput output.
  • Keep the connection console open while using the controller.
  • A different controller should be paired and calibrated separately.
  • Hold SYNC when pairing a controller with a different ESP32 or host.
  • After flashing firmware, reset or reconnect the ESP32-S3 and restart the application.
  • Perform gyro calibration on a stable surface. Perform accelerometer and magnetometer calibration away from magnets, speakers, large metal objects, and powered equipment.
  • XInput cannot expose raw motion sensor data; motion is mapped to a stick or mouse.
  • Settings and calibration data are stored in config.ini. Keep a backup before replacing or redistributing a configured build.

繁體中文

更新摘要

  • 新增 ESP32-S3 自動偵測，找不到時自動改用 Windows 原生藍牙。
  • 改善 ESP32 心跳狀態、斷線處理、BLE 通知重試及傳輸能力偵測。
  • 新增即時連線、電量等級、ESP32 與 ViGEmBus 狀態。
  • 新增每支手把獨立的搖桿、陀螺儀、加速度計及磁力計校正。
  • 改善搖桿處理，加入時間式平滑、防抖、死區、平滑曲線及圓形至方形輸出。
  • 擴充按鍵與搖桿映射，支援鍵盤組合、Windows／媒體鍵、滑鼠按鍵、滾輪及個別還原。
  • 改善 HD Rumble 2 轉換，新增遊戲、WASAPI 音訊及混合震動模式。
  • 新增陀螺儀映射至 Xbox 搖桿或滑鼠，包含瞄準、傾斜方向盤、回中及穩定控制。
  • GUI、問號提示、對話框、校正與連線主控台皆支援繁中／英文切換。
  • 改善 1080p 捲動、4K DPI、設定檔安全寫入、韌體刷寫及關閉清理。

快速操作

  1. 尚未安裝時，執行 Install-ViGEmBus.bat 安裝 ViGEmBus。
  2. 使用原生藍牙時，不要透過 Windows 藍牙設定配對手把，程式會直接處理藍牙連線；使用 ESP32 模式時，請接上已刷入相容韌體的 ESP32-S3。
  3. 執行 S2P-XInput-Lite.exe。
  4. 使用 中 / En 按鈕選擇語言。
  5. 調整映射與設定後按 儲存設定。
  6. 按 重新啟動連接程式，再按手把任意按鍵喚醒。

程式會優先偵測 ESP32；ESP32 不可用時會自動改用原生藍牙。

校正

  • **搖桿：**先關閉連線程式，按 校正搖桿，選擇 ESP32 或原生藍牙，再依提示操作。
  • **動作感測器：**先連上手把，再到陀螺儀頁面按 感測器校正，完整完成各階段。
  • 每支手把的校正資料會分開儲存。

震動與陀螺儀

  • 震動來源可選 遊戲、音訊 或 混合；音訊模式透過 WASAPI 擷取 Windows 預設輸出。
  • 將 LF 與 HF 強度都設為 0.00 即可關閉震動。
  • 陀螺儀映射預設關閉；使用前需選擇啟動方式、輸出目標及啟動按鍵。
  • 修改後請先儲存，再重新啟動連線程式測試。

注意事項

  • 僅支援 Windows 10/11，一次連接一支手把。
  • Xbox 360／XInput 輸出必須安裝 ViGEmBus。
  • 使用手把期間請保持連線主控台開啟。
  • 更換手把後應分別重新配對及校正。
  • 手把要切換到另一個 ESP32 或主機時，請按住 SYNC 重新配對。
  • 刷完韌體後，請重設或重新插拔 ESP32-S3，並重新開啟程式。
  • 陀螺儀校正時需將手把平放；加速度計及磁力計校正應遠離磁鐵、喇叭、大型金屬與通電設備。
  • XInput 無法輸出原始動作感測器資料，陀螺儀只能映射至搖桿或滑鼠。
  • 設定與校正資料位於 config.ini；替換或發佈已設定的版本前建議先備份。
Assets 4
Loading