I²C Wii Nunchuk Adapter Dokumentation

Version 1.1.0

Übersicht

Der I²C Wii Nunchuk Adapter macht es besonders einfach, deinen Nintendo-Wii-Controller (oder Klone) mit deinem Arduino, ESP32, Raspberry Pi usw. über I²C zu verbinden.

Ein Wii Nunchuk bietet einen Joystick (X/Y), zwei Knöpfe (C & Z) sowie einen 10-Bit-Beschleunigungssensor (X, Y, Z).

Spezifikationen

Nunchuk-Anschluss	1× Wii Nunchuk Port (Goldkontakte & passgenau mit 2 mm PCB-Dicke)
I²C-Schnittstellen	1× GROVE/STEMMA, 2× 5 Durchkontaktierte Löcher (2.54 mm)
I²C-Pullups	Integrierte 4.7 kΩ Pullup-Widerstände
Spannungsversorgung	3 – 5V (5V-kompatibel durch integrierten Spannungsregler & Pegelanpassung)
3.3V Ausgangsstrom (max.)	~600 mA
Status-LED	Grüne VDD-Status-LED
Abmessungen	25 × 20 × 9 mm

Pinout & Verdrahtung

Verbinde den Adapter über den GROVE/STEMMA-Anschluss oder die seitlichen Pinheader mit deinem Mikrocontroller:

Adapter Pin	Mikrocontroller	Beschreibung
GND	GND	Masse / Ground
VIN	3.3V / 5V	Spannungseingang
SDA	SDA	I²C Datenleitung
SCL	SCL	I²C Taktleitung
3.3	NC	3.3V Ausgang (nur Regler-Ausgang, unbenutzt lassen)

Hinweis: Dank integrierter 4.7 kΩ Pullup-Widerstände und 5V-Kompatibilität sind keine zusätzlichen Level-Shifter oder Bauteile erforderlich.

Funktionsweise

Die I²C-Adresse des Wii Nunchuks lautet:

0x52

Um dem Nunchuk Daten zu entlocken, muss eine Initialisierungs-Sequenz gesendet werden. Entweder für den verschlüsselten Modus (default):

START, 0x40, 0x00, STOP

oder (für die meisten Klones empfohlen) ohne Verschlüsselung:

START, 0xF0, 0x55, STOP, START, 0xFB, 0x00, STOP

Die 6 Datenbytes können danach periodisch ab Register 0x00 abgefragt werden:

START, 0x00, STOP, READ 6 bytes

Aufbau der Nunchuk-Register

Arduino Testcode

Die oben beschriebene Funktionsweise lässt sich z.B. folgendermaßen als Arduino-Code abbilden:

📄 I²C Wii Nunchuk Test-Script (.INO)

Lade diesen Testcode auf deinen Mikrocontroller (z.B. Arduino, ESP32) und öffne den Seriellen Monitor bei 115200 Baud.

Du solltest nun live die Sensordaten des Wii Nunchuks sehen. Zum Beispiel:

Hinweis: Dieser Code erlaubt Hot-Swapping (automatisches Re-Init beim Anstöpseln).

Troubleshooting & Hinweise

Nunchuk Klone: Einige Drittanbieter-Klone erfordern, dass DISABLE_NUNCHUK_ENCRYPTION auf true gesetzt ist. Originale Nintendo Nunchuks funktionieren in der Regel in beiden Modi.
VDD LED leuchtet nicht: Überprüfe die Verbindung an VIN und GND sowie die Stromversorgung deines Mikrocontrollers (mindestens 3V).
Keine Daten: Stelle sicher, dass SDA und SCL nicht vertauscht wurden und die Goldkontakte sauber sind.