Merge pull request #30 from chrizzo-hb/main

Warnings about mixing up face buttons and dpad, instructions on formatting with Windows, supported Wi-Fi dongles

Author: chrizzo-hb

docs/_inc/images/play/formatting/001-formatting-after-flashing-not-yet-expanded.png

@@ -1,28 +1,35 @@
 # :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."
+!!! info "Tastenbelegung nach der Installation einrichten"
+    Je nachdem, welches Gerät und welche KNULLI-Version du benutzt, kann es notwendig sein, nach der Installation 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))."
+!!! danger "Hardware-Setup nicht mit der Tastebelegung für Spiele verwechseln!"
+    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
+!!! danger "Face-Buttons werden anhand der "Himmelsrichtung" identifiziert!"
+    KNULLI unterstützt verschiedene Handhelds und Controller von verschiedenen Herstellern. Abhängig davon, welches Gerät du gerade benutzt, kann die Beschriftung der "Face-Buttons" sich voneinander unterscheiden. Deshalb identifiziert KNULLI diese Tasten nicht anhand ihrer Beschriftung, sondern anhand ihrer "Himmelsrichtung".
+    
+    Beispielsweise ist der **nördliche** der vier Face-Buttons (:material-gamepad-circle-up:) auf dem SNES-Controller und auf den meisten Anbernic-Geräten mit ++"X"++ beschriftet. Die gleiche Taste ist auf dem Xbox-Controller mit ++"Y"++ beschriftet, auf dem PlayStation-Controller mit ++"△"++.
 
-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.
+    Achte darauf, dass du die **Face-Buttons** (:material-gamepad-circle-up: :material-gamepad-circle-right: :material-gamepad-circle-down: :material-gamepad-circle-left:) **nicht** mit den **Steuerkreuz-Richtungen** (:material-gamepad-up: :material-gamepad-right: :material-gamepad-down: :material-gamepad-left:) verwechselst! Im Abschnitt [Hotkey-Shortcuts](../../play/hotkey-shortcuts) findest du weitere Informationen bzgl. der Face-Buttons.
 
-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 verbindenn
+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..
 
-## Bluetooth-Controller vergessen
+!!! info "Andere Blueooth-Geräte"
+    KNULLI unterstützt auch Bluetooth-Kopfhörer und -Lautsprecher."
+## Bluetooth-Controller vergessenn
 
 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/_inc/images/play/formatting/002-formatting-delete-volume.png

@@ -1,17 +1,26 @@
 # :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."
+!!! info "Map controls after installation"
+    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))."
+!!! danger "Do not confuse hardware setup with button mapping for games/systems!"
+    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.
 
+!!! danger "Face buttons are indicated by direction!"
+    KNULLI supports several different handhelds and controllers from different brands. Depending on your device, labels on the face buttons might differ. Therefore, KNULLI names face buttons not by their label but by their direction.
+    
+    For example, out of the four face buttons, the **north** button (:material-gamepad-circle-up:) is labeled ++"X"++ on the standard SNES controllers and on most Anbernic devices. The same button is labeled ++"Y"++ on Xbox controllers and ++"△"++ on PlayStation controllers.
+    
+    Make sure that you do **not** confuse the directional **face buttons** (:material-gamepad-circle-up: :material-gamepad-circle-right: :material-gamepad-circle-down: :material-gamepad-circle-left:) with the **D-pad** directions (:material-gamepad-up: :material-gamepad-right: :material-gamepad-down: :material-gamepad-left:)! You will find more information about face buttons in the [Hotkey shortcuts](../../play/hotkey-shortcuts) section.
+
 ## 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.
@@ -20,7 +29,8 @@ Once Bluetooth is enabled, either try to *Pair Bluetooth Pads Automatically* or
 
 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."
+!!! info "Other Bluetooth devices"
+    KNULLI also supports Bluetooth headphones or speakers.
 
 
 ## Forget a Bluetooth controller

docs/_inc/images/play/formatting/003-formatting-create-volume.png

@@ -2,7 +2,19 @@
 
 Viele Geräte, die von KNULLI unterstützt werden, sind in der Lage, sich mit dem Internet oder anderen lokalen Netzwerken zu verbinden. In den meisten Fällen geschieht dies über den eingebauten W-LAN-Adapter. Allerdings unterstützt KNULLI auch Netzwerkverbindungen über USB-Dongles.
 
-## W-LAN
+## Unterstützte Netzwerkadapter
+
+Einige von KNULLI unterstützte Geräte (z.B. Anbernic RG35XX Plus/H/SP, TrimUI Smart Pro) verfügen bereits über einen eingebauten Netzwerkadapter, den KNULLI vollständig unterstützt. Wenn dein Gerät einen eingebauten Netzwerkadapter hat, kannst du diesen Abschnitt überspringen und direkt dein [W-LAN einrichten](#w-lan-einrichten).
+
+Falls dein Gerät keinen eingebauten Netzwerkadapter hat (z.B. Anbernic RG35XX 2024, Anbernic RG28XX), gibt es trotzdem eine Möglichkeit, um dein Gerät mit deinem W-LAN zu verbinden. KNULLI unterstützt nahezu alle USB-W-LAN-Dongles, die einen Chipsatz *RTL8192cu* oder *RTL8188eu/us* verwenden. Die KNULLI-Community empfiehlt insbesondere den **TP-Link TL-WN725N** Netzwekadapter.
+
+Um deinen Netzwerkadapter in Betrieb zu nehmen
+
+* steck zunächst den Netzwerkadapter in einen passenden USB-Port deines KNULLI-Geräts.
+* drück ++"Start"++ und öffne *System Settings*. Von dort gelangst du zum Untermenü *Services*, wo du `ENABLE_WIFI` aktivieren kannst, **nachdem** du den USB-W-LAN-Dongle eingesteckt hast.
+* folge den Anweisungen im Abschnitt [W-LAN einrichten](#w-lan-einrichten).
+
+## W-LAN einrichten
 
 !!! danger "WPA3-Probleme"
 

docs/_inc/images/play/formatting/004-formatting-create-volume-max-size.png

@@ -2,7 +2,19 @@
 
 Many devices which are supported by KNULLI are capable of connecting to the internet as well as local networks. In most cases, this is achieved by a built-in Wi-Fi adapter. However, KNULLI also supports network connection via USB dongles.
 
-## Wi-Fi
+## Supported network adapters
+
+Some KNULLI-supported devices (e.g., Anbernic RG35XX Plus/H/SP, TrimUI Smart Pro) already come with a built-in network adapter that is completely supported by KNULLI. If your device comes with a built-in Wi-Fi adapter, you can skip ahead to [setting up Wi-Fi](#setting-up-wi-fi).
+
+However, even devices without a built-in network adapter (e.g., Anbernic RG35XX 2024, Anbernic RG28XX) can be connected to your Wi-Fi. KNULLI supports external USB Wi-Fi dongles which are based on the *RTL8192cu* or *RTL8188eu/us* chipsets. More specifically, the KNULLI community strongly recommends the **TP-Link TL-WN725N** network adapter.
+
+To activate your USB network adapter
+
+* plug the network adapter into an appropriate USB port of your KNULLI device.
+* press the ++"Start"++ button and head to *System Settings*. There you will find *Services* where you need to turn on `ENABLE_WIFI` **after** you plugged the network adapter into your device.
+* follow the instructions for [setting up Wi-Fi](#setting-up-wi-fi).
+
+## Setting up Wi-Fi
 
 !!! danger "WPA3 issues"
 

docs/_inc/images/play/formatting/005-formatting-create-volume-assign-drive-letter.png

@@ -10,20 +10,75 @@
 * Stelle sicher, dass du den **richtigen Speicher** auswählst, insbeosndere wenn du eine **zweite SD-Karte verwendest**!
 * **Vermeide** nach Möglichkeit, direkt von deinem Windows/macOS/Linux-Computer zu formatieren und benutze **stattdessen** den **integrierten KNULLI-Formatierer**!
 
-## Verfügbare Dateisysteme
+## Der integrierte Formatierer
+
+!!! danger "Probleme mit dem integrierten Formatierer"
+    Einige Nutzer sind bei der Verwendung des integrierten Formatierers des KNULLI-Builds 05/30 auf Probleme gestoßen. Die Probleme **wurden mittlerweile behoben**. Falls einen KNULLI-build 05/30 verwendest und Probleme mit dem eingebauten Formatierer hast, musst du möglicherweise stattdessen auf das [formatieren mit Windows](#formatieren-mit-windows) zurückgreifen.
+
+### Verfügbare Dateisysteme
 
 Der integrierte KNULLI-Fomatierer bietet dir **drei** verschiedene Dateisysteme an. Allerdings werden nur **zwei** davon derzeit tatsächlich von KNULLI unterstützt:
 
 * **:material-check: ext4** ist ein Linux-Dateisystem, auf das **nicht** via Windows/macOS **zugegriffen** werden kann. Allerdings unterstützt ext4 **große Swap-Dateien** sowie **symbolische Links**. Dementsprechend können die meisten PortMaster-Spiele **ohne Einschränkungen** auf ext4-formatierten Speichermedien gespielt werden.
 * **:material-check: exFAT** ist ein Windows/macOS-kompatibles Dateisystem, das von den meisten CFWs, Smartphones etc. verwendet wird. Leider unterstützt exFAT weder **große Swap-Dateien** noch **symbolische Links**. Viele PortMaster-Spiele können daher **nicht** oder **nur stark eingeschränkt** auf exFAT-formatierten Speichermedien gespielt werden.
 * **:material-cancel: BTRFS** ist ein Dateisystem, das derzeit **NICHT VON KNULLI UNTERSTÜTZT WIRD**.
 
-## Formatieren
+### Formatieren
 
 Der integrierte KNULLI-Formatierer kann verwendet werden, um sowohl den internen Datenspeicher der primären SD-Karte (**internal**) als auch die optionale zweite SD-Karte (**external**) zu formatieren.
 
 Um deine Speichermedien mit dem Dateisystem deiner Wahl zu formatieren, solltest du das KNULLI-Hauptmenü öffnen, in dem du ++"Start"++ drückst. Dort wählst du zunächst *System Settings*, dann *Frontend Developer Options* und schließlich *Format a Disk*. Stelle sicher, dass du das richtige Speichermedium (*Device to Format*) und Dateisystem (*File System*) ausgewählt hast, bevor du mit *Format Now* die Formatierung auslöst. Die eigentliche Formatierung findet dann während des nächsten Bootvorganges statt, du solltest dein Gerät also neustarten, um die Formatierung abzuschließen.
 
 !!! info "Nach dem Formatieren"
 
-    Nach dem Formatieren legt KNULLI für dich automatisch einen [`/userdata`-Ordner](../game-storage) an.
+    Nach dem Formatieren richtet KNULLI für dich automatisch einen [`/userdata`-Ordner](../game-storage) an.
+
+## Formatieren mit Windows
+
+Formatieren mit Windows ist nur dann möglich, wenn du deine SD-Karte mit **exFAT** formatieren willst. Wie an vielen Stellen in diesem Wiki erklärt, ermöglicht exFAT zwar direkten Zugang zur SD-Karte via Windows, allerdings wird es dadurch unmöglich, die meisten [PortMaster](../../../systems/portmaster)-Spiele zu spielen.
+
+Wenn du deine SD-Karte aus Windows heraus formatieren möchtest, empfehlen wir dir dringend, die Windows-**Datenträgerverwaltung** zu nutzen. In der Datenträgerverwaltung ist es einfacher, die **korrekte Partition** zu identifizieren. Du findest die Datenträgerverwaltung, in dem du das *Startmenü* öffnest und `datenträgerverwaltung` eintippst. Das Tool nennt sich im Startmenü *"Festplattenpartitionen erstellen und formatieren"*.
+
+<table>
+	<tr>
+		<td width="50%">
+			<img src="/_inc/images/play/formatting/001-formatting-after-flashing-not-yet-expanded.png">
+			<p><strong>Schritt 1: </strong>Stelle sicher, dass deine Partitionen korrekt initialisiert und erweitert wurden, bevor du irgendetwas formatierst. Der Screenshot zeigt eine SD-Karte, deren Share-Partition <strong>noch nicht</strong> auf ihre volle Größe expandiert wurde. Du erkennst das u.A. an den großen Menge an nicht zugeordnetem Speicher. Um sicherzustellen, dass die Partition einmal korrekt initialisiert wurde, solltet du dein KNULLI-Gerät einmal von der SD-Karte booten, bevor du weitermachst.</p>
+		</td>
+		<td width="50%">
+			<img src="/_inc/images/play/formatting/002-formatting-delete-volume.png">
+	    	<p><strong>Schritt 2: </strong>Nachdem deine SD-Karte initialisiert wurde, identifiziere die größte, jetzt vollständig expandierte Partition, klick sie mit der rechten Maustaste an und wähle <em>Volume löschen...</em>.</p>
+		</td>
+	</tr>
+	<tr>
+		<td>
+			<img src="/_inc/images/play/formatting/003-formatting-create-volume.png">
+			<p><strong>Schritt 3: </strong>Klick den neuen, nicht zugeordneten Speicher mit der rechten Maustaste an und wähle <em>Neues einfaches Volume...</em>.</p>
+		</td>
+		<td>
+			<img src="/_inc/images/play/formatting/004-formatting-create-volume-max-size.png">
+			<p><strong>Schritt 4: </strong>Stelle sicher, dass du den maximalen Speicherplatz für dein neues Volume verwendest.</p>
+		</td>
+	</tr>
+	<tr>
+		<td>
+			<img src="/_inc/images/play/formatting/005-formatting-create-volume-assign-drive-letter.png">
+			<p><strong>Schritt 5: </strong>Weise deinem neuen Volume einen Laufwerksbuchstaben zu. (Du kannst einen beliebigen Laufwerksbuchstaben auswählen, wir empfehlen, einfach den Buchstaben zu nutzen, denn Windows automatisch vorschlägt.)</p>
+		</td>
+		<td>
+			<img src="/_inc/images/play/formatting/006-formatting-create-volume-format-to-exfat.png">
+			<p><strong>Schritt 6: </strong>Stelle sicher, dass du das Laufwerk mit dem Dateisystem <strong>exFAT</strong>, Zuordnungseinheit <strong>Standard</strong>, und Volumebezeichnung <code>share</code> formatierst.</p>
+		</td>
+	</tr>
+	<tr>
+		<td>
+			<img src="/_inc/images/play/formatting/007-formatting-formatted-to-exfat.png">
+			<p><strong>Schritt 7: </strong>Überprüfe, dass du jetzt eine <em>share</em>-Partition hast, die mit exFAT formatiert ist.</p>
+		</td>
+		<td></td>
+	</tr>
+</table>
+
+!!! info "Nach dem Formatieren"
+
+    Nach dem Formatieren solltest du die SD-Karte in dein Gerät stecken und KNULLI starten. Während des Bootvorgangs richtet KNULLI für dich automatisch einen [`/userdata`-Ordner](../game-storage) an.