Merge pull request #14 from chrizzo-hb/main

Section about setting up controls

docs/configure/controls.de.md

@@ -0,0 +1,28 @@
+# :material-controller: Controller
+
+!!! info "Je nachdem, welches Gerät und welche KNULLI-Version du benutzt, kann es notwendig sein, nach der Installtion zunächst deinen Controller einzurichten, bevor du losspielen kannst."
+
+Obwohl KNULLI eigentlich für Handheld-Geräte entwickelt wurde, unterstützt es zusätzlich viele verschiedene Arten von USB- und Bluetooth-Controllern. Bevor du einen Controller an deinem KNULLI-Gerät verwenden kannst, kann es allerdings nötig sein, die Tasten des Controllers ihren jeweiligen Funktionen zuzuordnen.
+
+!!! danger "Verwechsel die Einrichtung des Controllers nicht mit der Anpassung der Tastenbelegung für einzelne *Spiele* oder *Emulation-Cores*! In diesem Abschnitt geht es um die *generelle* Einrichtung der *Hardware*. Wenn du die Tastenbelegung für einzelne *Spiele*, emulierte Konsolen oder die dafür eingesetzten *Emulation-Cores* anpassen möchtest, schau bitte in die Anleitung für den jeweiligen *Core* (z.B. [Retroarch](./retroarch/controls))."
+
+## Controller einrichten
+
+Um einen Controller einzurichten, musst du alle Buttons und Richtungseingaben ihren jeweiligen Funktionen zuordnen. Drücke dazu zunächst auf ++"Start"++ um das Hauptmenü zu öffnen, gehe zu *Controller & Bluetooth Settings* und wähle dort *Controller Mapping*. Folge jetzt einfach den Anweisungen auf dem Bildschirm. Du wirst zunächst aufgefordert, einen beliebigen Knopf auf dem Controller, den du einrichten möchtest, gedrückt zu halten. Anschließend wirst du Schritt für Schritt durch die Einrichtung geführt. Drücke einfach immer den Button, der am besten zu dem Button passt, der gerade auf dem Bildschirm angezeigt wird.
+
+Falls du mal danebendrückst, mach dir keine Sorgen: Du kannst jederzeit in das Menü zurückkehren und die Einrichtung erneut versuchen.
+
+## Bluetooth-Controller verbinden
+
+Um einen Bluetooth-Controller mit deinem KNULLI-Gerät zu verbinden, musst du zunächst sicherstellen, dass sowohl das Gerät als auch der Controller Bluetooth unterstützen. Wenn beide Geräte Bluetooth unterstützen, kannst du auf ++"Start"++ drücken, um das Hauptmenü zu öffnen und *Controller & Bluetooth Settings* auszuwählen. Hier kannst du bei *Enable Bluetooth* zunächst Bluetooth einschalten, falls es nicht schon eingeschaltet ist.
+
+Anschließend kannst du entweder versuchen, den Controller automatisch zu erkennen, in dem du *Pair Bluetooth Pads Automatically* auswählst, oder *Pair A Bluetooth Device Manually* auswählen, um den Controller aus einer Liste in der Nähe befindlicher Bluetooth-Geräte auszuwählen. Falls dein Controller in der Liste nicht angezeigt wird, oder das Bluetooth-Pairing fehlschlägt, schau in das Handbuch deines Controllers und such nach der Anleitung für Bluetooth-Verbindungen.
+
+Wenn der Bluetooth-Controller verbunden ist, solltest du überprüfen, ob du den  [Controller einrichten](#controller-einrichten) musst.
+
+!!! info "KNULLI unterstützt auch Bluetooth-Kopfhörer und -Lautsprecher."
+
+
+## Bluetooth-Controller vergessen
+
+Wenn du einen Bluetooth-Controller entfernen bzw. "vergessen" möchtest, drück auf ++"Start"++ um ins Hauptmenü zu gelangen, geh zu *Controller & Bluetooth Settings*, öffne *Forget A Bluetooth Device*, wähle dort den entsprechenden Controller aus und entferne ihn.

docs/configure/controls.md

@@ -0,0 +1,28 @@
+# :material-controller: Controls
+
+!!! info "Depending on your device and your version of KNULLI, it might be required to map the built-in controls of your device before you can start playing."
+
+Even though it was designed for handheld devices, KNULLI still supports various types of USB and Bluetooth controllers. However, before a controller can be used with your KNULLI device, it might be necessary to map its buttons and directional controls to the corresponding game inputs.
+
+!!! danger "Do not confuse controller setup with* game-* or *core-specific* button remapping! This section is about the *global* controller setup to make the *hardware* work. If you want to remap the controls for a specific *game* or *emulation core*, follow the guide for the respective core (e.g. [Retroarch](./retroarch/controls))."
+
+## Controller mapping
+
+To map the buttons and directional inputs of a controller, press the ++"Start"++ button to bring up the main menu, find *Controller & Bluetooth Settings* and select *Controller Mapping*. On-screen instructions will ask you to hold a button on the controller you want to map. Once the controller was detected, you will be guided through the process: Simply press the button on your controller which corresponds best to the button/function displayed on screen.
+
+If you press a wrong button, don't worry: You will always be able to return to this menu and remap the controller again.
+
+## Connect a Bluetooth controller
+
+To use a Bluetooth controller with your KNULLI device, you first need to make sure that both your device and your controller support Bluetooth. If so, press ++"Start"++ to bring up the main menu and go to *Controller & Bluetooth Settings*. Here, you will be able to *Enable Bluetooth* if it is not enabled, yet.
+
+Once Bluetooth is enabled, either try to *Pair Bluetooth Pads Automatically* or select *Pair A Bluetooth Device Manually* and find your controller in a list of available Bluetooth devices in your vicinity. If your controller does not show up or pairing does not work as expected, check the manual of your controller for pairing instructions.
+
+Once the Bluetooth controller is paired and connected, you may want to proceed with [Controller mapping](#controller-mapping).
+
+!!! info "KNULLI also supports Bluetooth headphones or speakers."
+
+
+## Forget a Bluetooth controller
+
+If you want to remove or "forget" a paired Bluetooth controller, press the ++"Start"++ button to bring up the main menu, head to *Controller & Bluetooth Settings*, open *Forget A Bluetooth Device*, find the device and remove it.

docs/play/install.de.md

@@ -35,6 +35,7 @@ Um KNULLI installieren zu können, musst du als erstes ein passendes Image für
 ## Nächste Schritte
 
 * [Netzwerk konfigurieren](../../configure/networking)
+* [Controller konfigurieren](../../configure/controls)
 * [Spiele hinzufügen](../../play/add-games)
 * [Scrapen](../../play/scraping)
 * [Themes installieren und konfigurieren](../../configure/themes)

docs/play/install.md

@@ -35,6 +35,7 @@ KNULLI is installed by downloading an image for your device, flashing it to an S
 ## Next Steps
 
 * [Set up Networking](../../configure/networking)
+* [Set up Controls](../../configure/controls)
 * [Add Games](../../play/add-games)
 * [Scraping](../../play/scraping)
 * [Themes](../../configure/themes)

mkdocs.yml

@@ -125,7 +125,7 @@ plugins:
             Add Games: Spiele hinzufügen
             Scraping: Scraping
             Achievements: Achievements
-            Controls: Steuerung
+            Controls: Controller
             Configure: Konfiguration
             Networking: Netzwerkverbindungen
             Unbranded: Ohne Marke
@@ -169,10 +169,10 @@ nav:
       - Add Games: play/add-games.md
       - Scraping: play/scraping.md
       - Achievements: play/retro-achievements.md
-      - Controls: play/controls.md
       - Netplay: play/netplay.md
     - Configure:
       - Networking: configure/networking.md
+      - Controls: configure/controls.md
       - SSH: configure/ssh.md
       - Retroarch:
         - Controls: configure/retroarch/controls.md