[PS3] DS3 Input & Report Inspector: Il Tool Definitivo per il Tuo DualShock 3

Hai un controller PS3 (DualShock 3/SIXAXIS) e vuoi analizzarne ogni segnale, calibrare gli stick, gestire il Bluetooth o persino modificare la memoria flash? Con DS3 Input & Report Inspector, hai il controllo totale sul tuo gamepad!

Scritto in Python e con un’interfaccia intuitiva, questo tool è perfetto per smanettoni, sviluppatori e appassionati che vogliono spingere al limite il proprio controller.

Perché l’applicazione è più grande del previsto?

L’applicazione è distribuita tramite PyInstaller, che include un runtime Python completo e tutte le dipendenze necessarie in un singolo eseguibile. Questo aumenta le dimensioni del file, ma garantisce che l’app funzioni senza richiedere l’installazione manuale di Python o librerie aggiuntive.

Perché alcuni antivirus segnalano l’eseguibile come virus?

Alcuni antivirus potrebbero erroneamente identificare gli eseguibili generati da PyInstaller come potenzialmente dannosi. Si tratta di un falso positivo noto. Se sei preoccupato, puoi:

• Eseguire il codice sorgente direttamente con Python (una volta disponibile).

• Generare tu stesso l’eseguibile usando PyInstaller.

• Scansionare il file con più motori antivirus per verificare che non ci siano minacce reali.

Posso eseguirlo senza scaricare l’eseguibile grande?

Sì, una volta che il codice sorgente sarà pubblicato, potrai eseguirlo direttamente con Python.

Funzionalità Principali

Visualizzazione Input in Tempo Reale

• Stati dei pulsanti digitali (D-Pad, pulsanti frontali, grilletti, pressione stick, tasto PS).

• Posizione degli stick analogici visualizzata su pad 2D.

• Valori di pressione sensibile dei pulsanti con barre di progressione.

• Dati dei sensori di movimento (accelerometro, giroscopio) con valori grezzi e calibrati (m/s², °/s).

Controllo Output

• Accensione/spegnimento LED (Player 1-4).

• Controllo della vibrazione (durata e intensità per entrambi i motori).

Gestione Feature Report HID

• Lettura e visualizzazione dei report comuni:

  • 0x01: Tipo controller, firmware, punti medi degli stick, deadzone/gain.

  • 0xF2: Indirizzo MAC Bluetooth, numero di serie, revisione PCB.

  • 0xEF: Dati di calibrazione dei sensori di movimento (bias/gain accelerometro, offset giroscopio).

• Possibilità di inviare manualmente report GET/SET con payload personalizzati (usare con cautela!).

Descrittore Report HID

• Visualizzazione del descrittore HID grezzo del dispositivo.

Gestione Bluetooth (Report 0xF5)

• Visualizzazione dell’indirizzo MAC Bluetooth attualmente associato al controller.

• Impostazione di un nuovo indirizzo MAC per l’accoppiamento.

Utility Memoria Flash (Report 0xF1)

• Dump completo delle banche flash A e B (512 byte totali) su file .bin.

• Scrittura di dati flash da file .bin al controller (ESTREMA CAUTELA!).

• Visualizzazione esadecimale diretta delle banche flash nell’interfaccia.

• Test di scrittura e lettura delle pagine di memoria.

Calibrazione Stick (Report 0xF1, Banca A, Offset 0x0020)

• Visualizzazione dei 16 byte di dati di calibrazione.

• Modifica dei singoli byte e scrittura delle modifiche nel controller.

Comandi Controller

• Riavvio del controller.

• Abilitazione/disabilitazione dello streaming degli input (richiede pressione del tasto PS per attivarlo).

Diagnostica & UI

• Frequenza di polling USB.

• Indicatore di stato della connessione.

• Opzione di log dettagliato dei report di input.

• Tentativi automatici di riconnessione.

Requisiti

• Backend libusb:

  • Windows: WinUSB, libusb-win32 o libusbK (configurabile con Zadig).

Installazione (Windows)

1. Configurazione driver con Zadig:

   • Scarica Zadig.

   • Collega il controller DS3 via USB.

   • Apri Zadig → Options → List All Devices.

   • Seleziona “PLAYSTATION(R)3 Controller” (USB ID: 054C:0268).

   • Scegli WinUSB (consigliato) o libusb-win32.

   • Clicca “Replace Driver”.

⚠ Attenzione: Questa operazione renderà il controller incompatibile con i driver standard finché non verrà ripristinato il driver originale.

Utilizzo

1. Collega il controller DS3 via USB.

2. Assicurati che il driver corretto sia installato (vedi Installazione).

3. Avvia DS3 Input & Report Inspector.exe.

4. Premi il tasto PS per avviare lo streaming degli input.

Avvertenze Importanti

• Scrittura nella memoria flash: Operazioni di scrittura errate possono danneggiare permanentemente il controller. Esegui sempre un backup prima di modificare i dati.

• Driver su Windows: L’uso di WinUSB/libusb tramite Zadig disabilita la compatibilità con tool come SCP Toolkit o DsHidMini finché il driver originale non viene ripristinato.

Altri progetti

🎮 DriftGuard Steam
📱 DriftGuard Android
🎮 DualSense Edge Calibration Tool

🔗 Repository GitHub

Questo strumento è pensato per utenti avanzati, sviluppatori e appassionati che vogliono esplorare a fondo il funzionamento del DualShock 3. Usalo con cautela e divertiti! 🚀