Atmosphère: Unterschied zwischen den Versionen

K
(136 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 8: Zeile 8:
| Bildbreite = 125px
| Bildbreite = 125px
| Website = https://github.com/Atmosphere-NX/Atmosphere
| Website = https://github.com/Atmosphere-NX/Atmosphere
}}[[Datei:Atmosphere Systemversion.jpg|mini|<nowiki>Atmosphère Version in den Systemeinstellungen: Aktuelle Firmware|Atmosphère-Version|NAND-Typ (S = SysMMC)</nowiki>]]
}}[[Datei:Atmosphere Systemversion.jpg|mini|<nowiki>Atmosphère-Version in den Systemeinstellungen: Aktuelle Firmware|Atmosphère-Version|NAND-Typ (S = SysMMC)</nowiki>]]
'''Atmosphère''' ist eine freie '''Custom Firmware''' für die [[Nintendo Switch]]. Entwickelt wird sie hauptsächlich von SciresM. Sie ist unter einer freien Lizenz verfügbar und wird aktiv weiterentwickelt.
'''Atmosphère''' ist eine freie '''Custom Firmware''' für die [[Nintendo Switch]]. Entwickelt wird sie hauptsächlich von SciresM. Sie ist unter einer freien Lizenz verfügbar und wird aktiv weiterentwickelt.


== Geschichte ==
== Geschichte ==
{{Stub|Typ=Abschnitt}}
Im März 2018 gab SciresM bekannt, dass die Custom Firmware "Atmosphère" im Sommer 2018 für alle zu dem Zeitpunkt erhältlichen Switch-Modelle und -Firmware-Versionen erscheinen soll.<ref>[https://wiidatabase.de/switch-atmosphere-cfw-soll-im-sommer-fuer-alle-switch-firmware-erscheinen/ Switch: Atmosphère CFW soll im Sommer für alle Switch-Firmware-Versionen erscheinen]</ref> Die erste öffentliche Version erschien mit etwas Verzögerung im Oktober 2018 als v0.7.<ref>[https://wiidatabase.de/atmosphere-v0-7-erschienen/ Atmosphère v0.7 erschienen]</ref>
Im März 2018 gab SciresM bekannt, dass die Custom Firmware "Atmosphère" im Sommer 2018 für alle zu dem Zeitpunkt erhältlichen Switch-Modelle und -Firmware-Versionen erscheinen soll.<ref>[https://wiidatabase.de/switch-atmosphere-cfw-soll-im-sommer-fuer-alle-switch-firmware-erscheinen/ Switch: Atmosphère CFW soll im Sommer für alle Switch-Firmware-Versionen erscheinen]</ref> Die erste öffentliche Version erschien mit etwas Verzögerung im Oktober 2018 als v0.7.<ref>[https://wiidatabase.de/atmosphere-v0-7-erschienen/ Atmosphère v0.7 erschienen]</ref>


Atmosphère v0.8.5 fügte Cheat-Support hinzu.<ref>[https://wiidatabase.de/atmosphere-v0-8-5-mit-cheat-support/ Atmosphère v0.8.5 mit Cheat-Support]</ref> Seit v0.9.0 wird ein EmuMMC unterstützt.<ref>[https://wiidatabase.de/atmosphere-v0-9-0-mit-experimentellem-emunand/ Atmosphère v0.9.0 mit experimentellem EmuNAND]</ref>.
Atmosphère v0.8.5 fügte Cheat-Support hinzu.<ref>[https://wiidatabase.de/atmosphere-v0-8-5-mit-cheat-support/ Atmosphère v0.8.5 mit Cheat-Support]</ref> Seit v0.9.0 wird ein [[#EmuMMC|EmuMMC]] unterstützt.<ref>[https://wiidatabase.de/atmosphere-v0-9-0-mit-experimentellem-emunand/ Atmosphère v0.9.0 mit experimentellem EmuNAND]</ref>.
 
Seit der v0.17.0 wird [[Mariko]] offiziell unterstützt.<ref>[https://wiidatabase.de/atmosphere-v0-17-0-unterstuetzt-mariko Atmosphère v0.17.0 unterstützt Mariko]</ref>
 
Eine Vorabversion der 1.0.0 erschien am 07. September 2021.<ref>[https://wiidatabase.de/atmosphere-v1-0-0-pre-release/ Atmosphère v1.0.0 (Pre-Release)]</ref> Die finale 1.0.0 erschien am 09. September 2021.


== Komponenten ==
== Komponenten ==
Atmosphère zielt darauf ab, fast alle System-Komponenten der Switch zu reimplementieren und dabei zu erweitern. Sie heißen dabei:
Atmosphère zielt darauf ab, alle System-Komponenten der Switch zu reimplementieren und dabei zu erweitern.
* '''Fusée''': Bootloader, verifiziert und startet Exosphère und Package2 (Kernel/FIRM-Systemmodule) und patcht diese, falls nötig.
 
** '''Sept''': Payload zur Schlüsselableitung auf allen Firmware-Versionen >= [[Nintendo-Switch-Firmware 7.0.0#Technische Informationen|7.0.0]]. Ein Teil von sept ist signiert/verschlüsselt, weshalb es ohne Keys nicht möglich ist, sept selbstständig zu bauen.
=== Hauptkomponenten ===
* '''Exoshpère''': TrustZone mit eigenem Secure Monitor.
* {{Anker|Fusee}}'''Fusée''': Bootloader, verifiziert und startet Exosphère und Package2 (Kernel/FIRM-Systemmodule) und patcht diese, falls nötig.
* '''Exosphère''': TrustZone mit eigenem Secure Monitor.
* '''Thermosphère''': EmuMMC, lädt den MMC von der SD-Karte um so eine getrennte Umgebung für bspw. Homebrew zu schaffen.
* '''Thermosphère''': EmuMMC, lädt den MMC von der SD-Karte um so eine getrennte Umgebung für bspw. Homebrew zu schaffen.
* '''Stratosphère''': Eigene Systemmodule mit neuen Features und zur Erweiterung bestehender.
* {{Anker|Stratosphere}}'''Stratosphère''': Eigene Systemmodule mit neuen Features und zur Erweiterung bestehender.
** '''ams_mitm''': Neues Systemmodul zum on-the-fly Patchen von Dateien und Titeln.
*** '''bpc_mitm''': Ermöglicht das [[#Reboot-Payload|Neustarten in einen Payload]] (bspw. wieder Atmosphère) und das vollständige Herunterfahren, wenn AutoRCM aktiviert ist (siehe [[AutoRCM#Herunterfahren]]). Überschreibt den [https://switchbrew.org/wiki/PCV_services#bpc bpc PCV-Service] von Nintendo.
*** '''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/modules/fs_mitm.md fs_mitm]''': Kann Dateien von Titeln mit denen auf der SD-Karte ersetzen, auch bekannt als "'''LayeredFS'''".
*** {{Anker|hid_mitm}}'''hid_mitm''': Mit der [[Nintendo-Switch-Firmware 9.0.0|Firmware 9.0.0]] wurden die HID-Komponenten für Controller so sehr geändert, dass libnx (die Bibliothek zum Bauen von Switch-Homebrews) keine Controller-Eingaben mehr erkennt. Dieses Problem wurde zwar in neueren libnx-Versionen behoben, allerdings müssen Homebrews mit der neuen libnx-Version neu gebaut werden. Da nicht jede Homebrew sofort aktualisiert wird/werden kann, wurde als Übergang ein temporäres Modul eingeführt, welches das Problem behebt.<ref>[https://github.com/Atmosphere-NX/Atmosphere/releases/tag/0.9.4 Atmosphère v0.9.4]</ref> Da es somit nicht mehr möglich ist, das HID-Modul selbst zu überschreiben, wird dieser Workaround in Zukunft entfernt. Mit Atmosphère v0.10.2 wurde es per Standard deaktiviert.<ref>[https://github.com/Atmosphere-NX/Atmosphere/releases/tag/0.10.2 Atmosphère v0.10.2]</ref> Siehe auch [[#enable_deprecated_hid_mitm|enable_deprecated_hid_mitm]].
*** '''ns_mitm''': Ermöglicht die Verwendung von Web-Applets im Homebrew Menu, wenn eine Anwendung überschrieben wird, da diese erst prüfen, ob es HTML-Inhalte in der Anwendung gibt.
*** '''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/modules/set_mitm.md set_mitm]''': Verändert die Anzeige der Systemversion ([https://switchbrew.org/wiki/Settings_services#GetFirmwareVersion GetFirmwareVersion]) ([[:Datei:Atmosphere Systemversion.jpg|siehe Bild]]) und liest weitere Einstellungen aus einer INI-Datei. Dabei wird der [https://switchbrew.org/wiki/Settings_services System-Settings-Service] abgefangen.
** '''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/modules/boot.md boot]''': Reimplementierung von Nintendos "[https://switchbrew.org/wiki/Boot boot]"; initialisiert die Hardware und startet das System.
** '''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/modules/boot.md boot2]''': Reimplementierung von Nintendos "[https://switchbrew.org/wiki/Boot2 boot2]"; lädt weitere Prozesse.
** '''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/modules/creport.md creport]''': Generiert Absturzberichte auf der SD-Karte und verhindert das Senden dieser an Nintendo
** '''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/cheats.md dmnt]''': Cheat-Code-Support, inklusive Kompatibilität zu [[SX OS|Gateshark]]. "dmnt" steht dabei für "Debug Monitor".
** '''eclct.stub''': Deaktiviert weitere [https://switchbrew.org/wiki/System_Settings#eclct Telemetrie-Dienste] von Nintendo.
** '''[[#fatal|fatal]]''': Reimplementiert Nintendos [https://switchbrew.org/wiki/Fatal_services fatal] und zeigt einen umfangreichen Fehlerbildschirm bei einem fatalen (deshalb der Name) Absturz an. Auch kann die Konsole mit den Lautstärketasten direkt neu gestartet werden.
** '''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/modules/loader.md loader]''': Reimplementiert Nintendos "[https://switchbrew.org/wiki/Loader_services loader]" und ermöglicht das Ersetzen von Dateien im ExeFS, das Patchen von NSOs, sowie [[#Button Overrides|Button Overrides]] (bspw.: "R" gedrückt halten, während ein Spiel startet, startet das Homebrew Menu mit vollem RAM-Zugriff).
** '''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/modules/pm.md pm]''': Reimplementierung von Nintendos "[https://switchbrew.org/wiki/Process_Manager_services Process Manager]", gibt u.a. mehr Speicher für Systemmodule frei.
** '''ro''': Reimplementierung von Nintendos [https://switchbrew.org/wiki/RO_services RO-Services].
** '''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/modules/sm.md sm]''': Reimplementierung von Nintendos "[https://switchbrew.org/wiki/Services_API Service Manager]". Dieser ist für Entwickler interessant, da so u.a. ein eigener MitM-Service registriert werden kann. Patcht per Standard auch "smhax"<ref>[https://switchbrew.org/wiki/Switch_System_Flaws#FIRM-package_System_Modules Switch System Flaws#FIRM-package System Modules] unter "Service access control bypass"</ref><ref>[https://wiidatabase.de/switch-firmware-3-0-1-fixt-grossen-bug-update-nicht-empfohlen/ Switch-Firmware 3.0.1 fixt "großen Bug" – Update nicht empfohlen]</ref> auf der Firmware < [[Nintendo-Switch-Firmware 3.0.1|3.0.1]].
** '''spl''': Reimplementierung von Nintendos "[https://switchbrew.org/wiki/SPL_services Secure Platform Services]".
* '''Mesosphère''': Reimplementierung von Nintendos Kernel.
* '''Mesosphère''': Reimplementierung von Nintendos Kernel.
* '''Troposphère''': HorizonOS-Patches für Applikationen. Dies ist noch nicht in Atmosphère implementiert.<ref>https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/components/troposphere.md</ref>
* '''Troposphère''': HorizonOS-Patches für Applikationen. Dies ist noch nicht in Atmosphère implementiert.<ref>https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/components/troposphere.md</ref>
==== Systemmodule ====
{| class="wikitable" border="1" width="100%"
|-
! Name
! Beschreibung
! Reimplementiert
! Erweiterungen/Änderungen
|-
| '''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/components/modules/ams_mitm.md ams_mitm]'''
| Neues Systemmodul zum on-the-fly Patchen von Dateien und Titeln
|
|
|-
| '''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/components/modules/boot.md boot]'''
| Initialisiert die Hardware und startet das System.
| [https://switchbrew.org/wiki/Boot boot]
| Atmosphère zeigt seinen eigenen schwarz/weißen Bootscreen und Akku-Icons an.
|-
| {{Anker|boot2}}'''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/components/modules/boot2.md boot2]'''
| Lädt alle weiteren Module nach dem Start.
| [https://switchbrew.org/wiki/Boot2 boot2]
| Mithilfe von [[#Flags|Flags]] lassen sich eigene Systemmodule direkt nach dem Start ausführen.
|-
| {{Anker|creport}}'''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/components/modules/creport.md creport]'''
| Dient der Verwaltung von Absturzberichten.
| [https://switchbrew.org/wiki/Creport creport]
| Generiert Absturzberichte auf der SD-Karte und verhindert das Senden dieser an Nintendo. Außerdem wird bei einem Absturz ein Screenshot erstellt (nur auf >= 10.0.0).
|-
| '''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/components/modules/dmnt.md dmnt]'''
| Stellt einen Debug-Monitor zur Verfügung. "dmnt" steht für "Debug Monitor".
| [https://switchbrew.org/wiki/Debug_Monitor_services dmnt]
| Cheat-Code-Support, inklusive Kompatibilität zu [[SX OS|Gateshark]].
|-
| {{Anker|eclct_stub}}'''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/components/modules/eclct.stub.md eclct.stub]'''
| Sammelt Fehlerberichte.
| [https://switchbrew.org/wiki/System_Settings#eclct eclct]
| Diese Reimplementation ist ein Stub und verhindert das Senden weiterer Telemetrie-Daten an Nintendo.
|-
| [[#erpt|erpt]]
| Verwaltet Fehlerberichte.
| [https://switchbrew.org/wiki/Error_Report_services erpt]
| Verhindert das Anlegen von berichten im MMC und leitet diese stattdessen auf die SD-Karte weiter.
|-
| [[#fatal|fatal]]
| Verwaltet Absturzberichte.
| [https://switchbrew.org/wiki/Fatal_services fatal]
| Zeigt einen umfangreichen Fehlerbildschirm bei einem fatalen (deshalb der Name) Absturz an. Auch kann die Konsole mit den Lautstärketasten direkt neu gestartet werden.
|-
| [[#htc|htc]]
| Host-Ziel-Verbindung bspw. zum Remote-Zugriff auf die SD-Karte.
| [https://switchbrew.org/wiki/TMA_services htc]
|
|-
| {{Anker|jpegdec}}'''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/components/modules/jpegdec.md jpegdec]'''
| Dient der Dekodierung von JPEGs in Verbindung mit den [https://switchbrew.org/wiki/Capture_services Capture-Services]
| [https://switchbrew.org/wiki/Jpegdec_services jpegdec]
| Erlaubt zwei Sessions anstatt einer, damit Homebrews JPEGs per Software parallel zum OS dekodieren können.
|-
| '''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/components/modules/loader.md loader]'''
| Erstellt Prozesse von ausführbaren NSOs und kontrolliert ihre Zugriffe
| [https://switchbrew.org/wiki/Loader_services loader]
| Ermöglicht das [[#ExeFS|Ersetzen von Dateien im ExeFS]], das [[#NSO-Patches|Patchen von NSOs]], sowie [[#Overrides|Button Overrides]] (bspw.: "R" gedrückt halten, während ein Spiel startet, startet das Homebrew Menu mit vollem RAM-Zugriff).
|-
| lm
| Stellt Logging-Dienste für einige Anwendungen und Spiele bereit.
| [https://switchbrew.org/wiki/Log_services lm]
| Logging auf die SD-Karte. Der LogManager ist aufgrund des erhöhten Speicherbedarfs standardmäßig deaktiviert, kann aber [[#enable_log_manager|aktiviert werden]].
|-
| '''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/components/modules/ncm.md ncm]'''
| Dient der Verwaltung von Inhalten (bspw. NAND-Speicherständen). "ncm" steht für "Nintendo Content Manager".
| [https://switchbrew.org/wiki/NCM_services ncm]
|
|-
| {{Anker|pgl}}[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/components/modules/pgl.md pgl]
| Startet Programme; nur ab [[Nintendo-Switch-Firmware 10.0.0|10.0.0]] vorhanden. "pgl" steht für "Program Launcher".
| [https://switchbrew.org/wiki/PGL_services pgl]
| Atmosphères Reimplementation ist ebenfalls nur ab 10.0.0 verfügbar und wurde (noch) nicht zurückportiert.
|-
| [https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/components/modules/pm.md pm]
| Verwaltet Ressourcenlimits und überwacht laufende Prozesse. "pm" steht für "Process Manager".
| [https://switchbrew.org/wiki/Process_Manager_services pm]
| Der APPLET Speicher-Pool wurde um 24 MiB gesenkt und gibt diesem somit dem SYSTEM-Pool zurück. Damit lassen sich mehr Custom-Systemmodule ausführen.
|-
| {{Anker|ro}}'''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/components/modules/ro.md ro]'''
| Lädt dynamische Bibliotheken und wurde mit der [[Nintendo-Switch-Firmware 3.0.0|Firmware 3.0.0]] eingeführt.
| [https://switchbrew.org/wiki/RO_services ro]
| Portiert die Funktionalitäten auf < 3.0.0 zurück, bei denen noch "loader" zuständig war. Ermöglicht außerdem [[#NRO-Patches|NRO-Patches]].
|-
| '''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/components/modules/sm.md sm]'''
| Verwaltet Dienste. "sm" steht für "Service Manager".
| [https://switchbrew.org/wiki/Services_API sm]
| Dieser ist für Entwickler interessant, da so u.a. ein eigener MitM-Service registriert werden kann. Patcht standardmäßig auch "smhax"<ref>[https://switchbrew.org/wiki/Switch_System_Flaws#FIRM-package_System_Modules Switch System Flaws#FIRM-package System Modules] unter "Service access control bypass"</ref><ref>[https://wiidatabase.de/switch-firmware-3-0-1-fixt-grossen-bug-update-nicht-empfohlen/ Switch-Firmware 3.0.1 fixt "großen Bug" – Update nicht empfohlen]</ref> auf der Firmware < [[Nintendo-Switch-Firmware 3.0.1|3.0.1]].
|-
| '''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/components/modules/spl.md spl]'''
| Ist u.a. für kryptographische Operationen notwendig. "spl" steht für "Secure Platform".
| [https://switchbrew.org/wiki/SPL_services spl]
|}
===== ams_mitm =====
Das Systemmodul '''ams_mitm''' fügt einige neue Funktionen hinzu, die in mehrere Teile aufgegliedert sind.
{| class="wikitable" border="1" width="100%"
|-
! Name
! Beschreibung
|-
| '''bpc_mitm'''
| Ermöglicht das [[#Reboot-Payload|Neustarten in einen Payload]] (bspw. wieder Atmosphère) und das vollständige Herunterfahren, wenn AutoRCM aktiviert ist (siehe [[AutoRCM#Herunterfahren]]). Überschreibt den [https://switchbrew.org/wiki/PCV_services#bpc bpc PCV-Service] von Nintendo.
|-
| '''dns_mitm'''
| Manipuliert DNS-Abfragen und kann frei konfiguriert werden (siehe [[#dns_mitm]]).
|-
| '''fs_mitm'''
| Kann Dateien von Titeln mit denen auf der SD-Karte ersetzen, auch bekannt als "'''LayeredFS'''".
|-
| '''ns_mitm'''
| Ermöglicht die Verwendung von Web-Applets im Homebrew Menu, wenn eine Anwendung überschrieben wird, da diese erst prüfen, ob es HTML-Inhalte in der Anwendung gibt.
|-
| '''set_mitm'''
| Verändert die Anzeige der Systemversion ([https://switchbrew.org/wiki/Settings_services#GetFirmwareVersion GetFirmwareVersion]) ([[:Datei:Atmosphere Systemversion.jpg|siehe Bild]]) und liest weitere Einstellungen aus einer INI-Datei. Dabei wird der [https://switchbrew.org/wiki/Settings_services System-Settings-Service] abgefangen.
|-
|}


=== Ordnerstruktur ===
=== Ordnerstruktur ===
Die Inhalte in ''(kursiven Klammern)'' dienen der Erklärung
Die Inhalte in ''(kursiven Klammern)'' dienen der Erklärung
{{Pre|SD-Karte
{{Pre|SD-Karte
&#124;  fusee-primary.bin ''(Payload, der an die Switch gesendet werden muss, um den Bootprozess einzuleiten)''
&#124;  fusee.bin ''(Payload, der an die Switch gesendet werden muss, um den Bootprozess einzuleiten, separater Download)''
&#124;  hbmenu.nro  ''(Homebrew Menu)''
&#124;  hbmenu.nro  ''(Homebrew Menu)''
&#124;
&#124;
+---atmosphere
+---atmosphere
&#124;  &#124;  fusee-mtc.bin
&#124;  &#124;  fusee-secondary.bin ''(Signierter/verschlüsselter Fusée-Teil)''
&#124;  &#124;  hbl.nsp ''(Homebrew Loader, der das Homebrew Menü lädt)''
&#124;  &#124;  hbl.nsp ''(Homebrew Loader, der das Homebrew Menü lädt)''
&#124;  &#124;  reboot_payload.bin ''([[#Reboot-Payload|Reboot-Payload]], Kopie von fusee-primary, wird bei einem Neustart ausgeführt)
&#124;  &#124;  package3 ''(Signierter/verschlüsselter Fusée-Teil)''
&#124;  &#124;  reboot_payload.bin ''([[#Reboot-Payload|Reboot-Payload]], Kopie von fusee.bin, wird bei einem Neustart ausgeführt)
&#124;  &#124;  stratosphere.romfs ''([[#Systemmodule|Atmosphères Systemmodule]], waren früher im "contents"-Ordner)
&#124;  &#124;
&#124;  &#124;
&#124;  +---config ''(Konfigurationsdateien)''
&#124;  +---config ''(Konfigurationsdateien)''
&#124;  &#124;      BCT.ini  ''(Einstellungen für Exosphère, Stratosphère und fusee-primary)''
&#124;  &#124;
&#124;  &#124;
&#124;  +---config_templates ''(Konfigurationstemplates, müssen in "config" kopiert werden)'''
&#124;  +---config_templates ''(Konfigurationstemplates)''
&#124;  &#124;      override_config.ini ''([[#Button Overrides|Button-Overrides]])''
&#124;  &#124;      exosphere.ini  ''([[#exosphere.ini|Einstellungen für Exosphère]])''
&#124;  &#124;      override_config.ini ''([[#Overrides|Overrides]])''
&#124;  &#124;      stratosphere.ini  ''([[#stratosphere.ini|Einstellungen für Stratosphère und fusee-primary]])''
&#124;  &#124;      system_settings.ini ''([[#System Settings|Atmosphère-Einstellungen]])''
&#124;  &#124;      system_settings.ini ''([[#System Settings|Atmosphère-Einstellungen]])''
&#124;  &#124;
&#124;  &#124;
&#124;  +---contents ''(Ordner für fs_mitm, ersetzt Inhalte in Anwendungen/Modulen, Ordnerinhalte nachfolgend gekürzt)''
&#124;  +---flags ''([[#Flags|Flags]])''
&#124;  &#124;  +---0100000000000008 ''(boot2)''
&#124;  &#124;  &#124;
&#124;  &#124;  +---010000000000000D ''(dmnt)''
&#124;  &#124;  &#124;
&#124;  &#124;  +---0100000000000032 ''(eclct.stub)''
&#124;  &#124;  &#124;
&#124;  &#124;  +---0100000000000034 ''([[#fatal|fatal]])''
&#124;  &#124;  &#124;
&#124;  &#124;  +---0100000000000036 ''(creport)''
&#124;  &#124;  &#124;
&#124;  &#124;  \---0100000000000037 ''(ro)''
&#124;  &#124;
&#124;  &#124;
&#124;  +---fatal_errors ''(Fehlerreports von fatal)''
&#124;  +---fatal_errors ''(Fehlerreports von fusee-primary)''
&#124;  +---hbl_html ''(Zum Starten von Web-Applets)''
&#124;  +---hbl_html ''(Zum Starten von Web-Applets)''
&#124;  &#124;
&#124;  &#124;
&#124;  \---kip_patches ''([[#KIP-Patches|KIP-Patches]])''
&#124;  \---kip_patches ''([[#KIP-Patches|KIP-Patches]], nicht mehr unterstützt)''
&#124;
+---sept ''(sept)''
&#124;
&#124;
\---switch ''(Ordner für Homebrews)''
\---switch ''(Ordner für Homebrews)''
        daybreak.nro ([[#Daybreak|Daybreak]]-Applikation zur Installation von System-Updates)
         reboot_to_payload.nro ''(Startet /atmosphere/reboot_payload.bin)''
         reboot_to_payload.nro ''(Startet /atmosphere/reboot_payload.bin)''
}}
}}


== Installation ==
== Installation ==
Um Atmosphère zu "installieren" muss lediglich die Release-ZIP auf die SD-Karte entpackt werden. Für die meisten Nutzer werden auch noch die [https://wiidatabase.de/switch-downloads/hacks/signatur-patches/ Signatur-Patches] empfohlen. Die ''fusee_primary.bin'' muss anschließend gestartet werden, bspw. über [https://wiidatabase.de/switch-downloads/exploits/fusee-gelee/ Fusée Gelée].
Um Atmosphère zu "installieren" muss lediglich die Release-ZIP auf die SD-Karte entpackt werden. Die ''fusee.bin'' muss anschließend gestartet werden, bspw. über [https://wiidatabase.de/switch-downloads/exploits/fusee-gelee/ Fusée Gelée] oder (auf [[Mariko|Mariko-Geräten]]) per Modchip.


== Features ==
== Features ==
{{Stub|Typ=Dieser Abschnitt}}
=== Homebrew Menu ===
=== Homebrew Menu ===
Standardmäßig gibt es zwei Möglichkeiten, das Homebrew Menu aufzurufen:
Standardmäßig gibt es zwei Möglichkeiten, das Homebrew Menu aufzurufen:
Zeile 100: Zeile 198:
Letztere Möglichkeit ist nicht empfohlen, da das Homebrew Menu sonst im "Applet-Modus" gestartet wird und nicht den vollen Arbeitsspeicher zur Verfügung stehen hat. Allerdings ist es somit möglich, Homebrews aufzurufen, während ein Spiel läuft (bspw. [https://wiidatabase.de/switch-downloads/switch-tools/screen-nx/ screen-nx] um Screenshots hochzuladen oder [https://wiidatabase.de/switch-downloads/switch-tools/edizon/ EdiZon] um Cheats zu erstellen).
Letztere Möglichkeit ist nicht empfohlen, da das Homebrew Menu sonst im "Applet-Modus" gestartet wird und nicht den vollen Arbeitsspeicher zur Verfügung stehen hat. Allerdings ist es somit möglich, Homebrews aufzurufen, während ein Spiel läuft (bspw. [https://wiidatabase.de/switch-downloads/switch-tools/screen-nx/ screen-nx] um Screenshots hochzuladen oder [https://wiidatabase.de/switch-downloads/switch-tools/edizon/ EdiZon] um Cheats zu erstellen).


Die Tasten-Kombination lässt sich in der "<code>/atmosphere/config/override_config.ini</code>" festlegen, siehe [[#Button Overrides|Button Overrides]].
Die Tasten-Kombination lässt sich in der "<code>/atmosphere/config/override_config.ini</code>" festlegen, siehe [[#Overrides|Button Overrides]].


=== Button Overrides ===
=== Overrides ===
Mithilfe der Button Overrides (Knopfüberschreibungen) ist es möglich, das Überschreibverhalten des Homebrew Menus zu konfigurieren. So kann bspw. eingestellt werden, dass das Homebrew Menu gestartet werden soll, wenn "Y" gedrückt wird, während das Album gestartet wird.
Mithilfe der Overrides ist es möglich, das Verhalten für Atmosphère für bestimmte Anwendungen zu ändern. Mit den Button Overrides (Knopfüberschreibungen) kann bspw. das Überschreibverhalten des Homebrew Menus konfiguriert werden. So kann bspw. eingestellt werden, dass das Homebrew Menu gestartet werden soll, wenn "Y" gedrückt wird, während das Album gestartet wird.
 
Mit der [https://wiidatabase.de/switch-downloads/switch-tools/hekate-toolbox/ Hekate Toolbox] lassen sich die Button Overrides grafisch direkt auf der Konsole bearbeiten.


Zuerst muss die "<code>/atmosphere/config_templates/override_config.ini</code>" nach "<code>/atmosphere/config/</code>" kopiert und mit einem Texteditor geöffnet werden. Die Datei ist folgendermaßen aufgebaut:
Zuerst muss die "<code>/atmosphere/config_templates/override_config.ini</code>" nach "<code>/atmosphere/config/</code>" kopiert und mit einem Texteditor geöffnet werden. Die Datei ist folgendermaßen aufgebaut:
Zeile 119: Zeile 219:
| {{TitleID}}
| {{TitleID}}
| <code>010000000000100D</code>
| <code>010000000000100D</code>
| Legt einen Titel fest, für den die nachfolgende Tasten-Konfiguration gelten soll (in dem Beispiel das Album), um das Homebrew Menu zu starten.
| Legt einen Titel fest, für den die nachfolgende Konfiguration gelten soll (in dem Beispiel das Album).
|-
|-
| <code>override_key_0</code>
| <code>override_key_0</code>
Zeile 125: Zeile 225:
| <code>R</code>
| <code>R</code>
| Knopf, der gedrückt gehalten (oder nicht gehalten) werden soll, um das Homebrew Menu zu starten. In dem Beispiel muss "R" gedrückt gehalten werden, während das Album aufgerufen wird.
| Knopf, der gedrückt gehalten (oder nicht gehalten) werden soll, um das Homebrew Menu zu starten. In dem Beispiel muss "R" gedrückt gehalten werden, während das Album aufgerufen wird.
|-
| <code>override_address_space_0</code>
| <code>39_bit</code>, <code>36_bit</code> oder <code>32_bit</code>
| <code>39_bit</code>
|  Adressraum für den Homebrew Launcher für diesen Titel.<br>
'''Standard:''' <code>39_bit</code>
|-
|-
| <code>program_id_1</code>
| <code>program_id_1</code>
| {{TitleID}}
| {{TitleID}}
| <code>0100E95004038000</code>
| <code>0100E95004038000</code>
| Legt einen weiteren Titel fest, für den die nachfolgende Tasten-Konfiguration gelten soll (in dem Beispiel Xenoblade Chronicles 2) um das Homebrew Menu zu starten.
| Legt einen weiteren Titel fest, für den die nachfolgende Konfiguration gelten soll (in dem Beispiel Xenoblade Chronicles 2).
|-
|-
| <code>override_key_1</code>
| <code>override_key_1</code>
Zeile 136: Zeile 242:
| Knopf, der gedrückt gehalten (oder nicht gehalten) werden soll, um das Homebrew Menu zu starten. In dem Beispiel darf "ZL" '''nicht''' gedrückt gehalten werden, während Xenoblade Chronicles 2 aufgerufen wird. Wird die Taste dennoch gehalten, wird das Spiel aufgerufen.
| Knopf, der gedrückt gehalten (oder nicht gehalten) werden soll, um das Homebrew Menu zu starten. In dem Beispiel darf "ZL" '''nicht''' gedrückt gehalten werden, während Xenoblade Chronicles 2 aufgerufen wird. Wird die Taste dennoch gehalten, wird das Spiel aufgerufen.
|-
|-
| colspan="4" | Bis zu acht verschiedene Konfigurationen werden unterstützt (<code>program_id_0</code> bis <code>program_id_7</code> bzw. <code>override_key_0</code> bis <code>override_key_7</code>).
| <code>override_address_space_1</code>
| Siehe oben
| <code>39_bit</code>
|  Siehe oben
|-
| colspan="4" | Bis zu acht verschiedene Konfigurationen werden unterstützt (<code>program_id_0</code> bis <code>program_id_7</code> bzw. <code>override_key_0</code> bis <code>override_key_7</code> und <code>override_address_space_0</code> bis <code>override_address_space_7</code>). Wenn "<code>program_id_0</code>" nicht gesetzt ist, sondern nur "<code>override_key_0</code>" bezieht sich die Konfiguration aufs Album. "<code>_0</code>" kann auch weggelassen werden.
|-
|-
| <code>override_any_app</code>
| <code>override_any_app</code>
Zeile 148: Zeile 259:
| Bestimmt, welcher Knopf gedrückt (oder nicht gedrückt) gehalten werden soll, während ein Titel aufgerufen wird (gilt nicht für Applets!), um das Homebrew Menu zu starten, wenn <code>override_any_app</code> auf <code>true</code> steht. In dem Beispiel wird das Homebrew Menu nur aufgerufen, wenn "Y" gedrückt gehalten wird, während ein Spiel gestartet wird. Sind oben spezifische TitleIDs angegeben, sind diese von dieser Konfiguration ausgenommen!<br>
| Bestimmt, welcher Knopf gedrückt (oder nicht gedrückt) gehalten werden soll, während ein Titel aufgerufen wird (gilt nicht für Applets!), um das Homebrew Menu zu starten, wenn <code>override_any_app</code> auf <code>true</code> steht. In dem Beispiel wird das Homebrew Menu nur aufgerufen, wenn "Y" gedrückt gehalten wird, während ein Spiel gestartet wird. Sind oben spezifische TitleIDs angegeben, sind diese von dieser Konfiguration ausgenommen!<br>
'''Merkhilfe''': "Starte das Homebrew Menu wenn Y gedrückt gehalten wird"
'''Merkhilfe''': "Starte das Homebrew Menu wenn Y gedrückt gehalten wird"
|-
| <code>override_any_app_address_space</code>
| <code>39_bit</code>, <code>36_bit</code> oder <code>32_bit</code>
| <code>39_bit</code>
|  Adressraum für den Homebrew Launcher für jeden Titel.<br>
'''Standard:''' <code>39_bit</code>
|-
|-
| <code>path</code>
| <code>path</code>
Zeile 255: Zeile 372:
| (De-)aktiviert den Telemetrie-Upload zu Nintendo.<br>
| (De-)aktiviert den Telemetrie-Upload zu Nintendo.<br>
<code>0x0</code> = deaktiviert, <code>0x1</code> = aktiviert
<code>0x0</code> = deaktiviert, <code>0x1</code> = aktiviert
|-
! colspan="4" | [usb]
|-
! Config-Key
! Wert
! Beispiel
! Erklärung
|-
| {{Anker|usb30_force_enabled}}<code>usb30_force_enabled</code>
| <code>0x0</code> oder <code>0x1</code>
| <code>u8!0x0</code>
| (De-)aktiviert USB-3.0-Superspeed für Homebrews.<br>
<code>0x0</code> = System-Standard (deaktiviert), <code>0x1</code> = aktiviert
|-
|-
! colspan="4" | [ro]
! colspan="4" | [ro]
Zeile 266: Zeile 396:
| <code>0x0</code> oder <code>0x1</code>
| <code>0x0</code> oder <code>0x1</code>
| <code>u8!0x0</code>
| <code>u8!0x0</code>
| Weist "ro" an, NROs nicht streng zu überprüfen.<br>
| Weist "ro" an, NROs nicht streng zu überprüfen. Darunter fallen Signatur, die Programm-ID und der Typ.<ref>https://github.com/Atmosphere-NX/Atmosphere/blob/48b0b2fc46c7331ba3cb9b297475db9e0d82cd66/stratosphere/ro/source/impl/ro_nrr_utils.cpp#L48</ref><br>
<code>0x0</code> = deaktiviert, <code>0x1</code> = aktiviert
|-
! colspan="4" | [lm]
|-
! Config-Key
! Wert
! Beispiel
! Erklärung
|-
| {{Anker|enable_sd_card_logging}}<code>enable_sd_card_logging</code>
| <code>0x0</code> oder <code>0x1</code>
| <code>u8!0x1</code>
| (De-)aktiviert das Logging auf die SD-Karte.<br>
<code>0x0</code> = deaktiviert, <code>0x1</code> = aktiviert
|-
| {{Anker|sd_card_log_output_directory}}<code>sd_card_log_output_directory</code>
| String
| <code>str!atmosphere/binlogs</code>
| Konfiguriert den Pfad, in dem Logs gespeichert werden
|-
! colspan="4" | [erpt]
|-
! Config-Key
! Wert
! Beispiel
! Erklärung
|-
| {{Anker|disable_automatic_report_cleanup}}<code>disable_automatic_report_cleanup</code>
| <code>0x0</code> oder <code>0x1</code>
| <code>u8!0x1</code>
| Wenn aktiviert, werden automatisch alle "erpt_reports" auf der SD-Karte gelöscht, wenn mehr als 1000 Stück vorhanden sind.<br>
<code>0x0</code> = deaktiviert, <code>0x1</code> = aktiviert
<code>0x0</code> = deaktiviert, <code>0x1</code> = aktiviert
|-
|-
Zeile 279: Zeile 440:
| Unsigned 64-Bit Integer (<code>0x0</code> bis <code>0xFFFFFFFFFFFFFFFF</code>)
| Unsigned 64-Bit Integer (<code>0x0</code> bis <code>0xFFFFFFFFFFFFFFFF</code>)
| <code>u8!0x1388</code>
| <code>u8!0x1388</code>
| Gibt die Zeit in Millisekunden an, nach der im "[[#fatal|fatal]]"-Absturzbildschirm (mit dem Atmosphère-Logo) automatisch neu [[#Reboot-Payload|in einen Payload]] gestartet werden soll. In dem Beispiel nach fünf Sekunden (1338 Millisekunden [https://www.binaryhexconverter.com/decimal-to-hex-converter in Hex] = 5000 Millisekunden = 5 Sekunden).<br>
| Gibt die Zeit in Millisekunden an, nach der im "[[#fatal|fatal]]"-Absturzbildschirm (mit dem Atmosphère-Logo) automatisch neu [[#Reboot-Payload|in einen Payload]] gestartet werden soll. In dem Beispiel nach fünf Sekunden (1388 Millisekunden [https://www.binaryhexconverter.com/decimal-to-hex-converter in Hex] = 5000 Millisekunden = 5 Sekunden).<br>
<code>0x0</code> = Reboote nie automatisch
<code>0x0</code> = Reboote nie automatisch
|-
|-
Zeile 313: Zeile 474:
| <code>0x0</code> oder <code>0x1</code>
| <code>0x0</code> oder <code>0x1</code>
| <code>0x0</code>
| <code>0x0</code>
| (De-)aktiviert das Lesen der [https://switchbrew.org/wiki/Calibration CAL0-Partition] für Homebrews (enthält u.a. wichtige konsolenspezifische Schlüssel).<br>
| (De-)aktiviert das Lesen der [https://switchbrew.org/wiki/Calibration PRODINFO-Partition] für Homebrews (enthält u.a. wichtige konsolenspezifische Schlüssel).<br>
<code>0x0</code> = deaktiviert, <code>0x1</code> = aktiviert.<br>
<code>0x0</code> = deaktiviert, <code>0x1</code> = aktiviert.<br>
|-
|-
Zeile 323: Zeile 484:
'''Diese Einstellung ist experimentell und kann mit Datenverlust einhergehen!''' Das bloße Aktivieren dieser Option leitet noch keine Speicherstände um - dies geschicht per Flags auf Titel-basis, siehe [[#Speicherstand-Redirection|Speicherstand-Redirection]].
'''Diese Einstellung ist experimentell und kann mit Datenverlust einhergehen!''' Das bloße Aktivieren dieser Option leitet noch keine Speicherstände um - dies geschicht per Flags auf Titel-basis, siehe [[#Speicherstand-Redirection|Speicherstand-Redirection]].
|-
|-
| {{Anker|enable_deprecated_hid_mitm}}<code>enable_deprecated_hid_mitm</code>
| {{Anker|enable_am_debug_mode}}<code>enable_am_debug_mode</code>
| <code>0x0</code> oder <code>0x1</code>
| <code>0x0</code>
| Mit dieser Einstellung wird der "DebugModeFlag" für den [https://switchbrew.org/wiki/Applet_Manager_services Applet Manager] aktiviert.<br>
<code>0x0</code> = deaktiviert, <code>0x1</code> = aktiviert.
|-
| {{Anker|enable_dns_mitm}}<code>enable_dns_mitm</code>
| <code>0x0</code> oder <code>0x1</code>
| <code>0x1</code>
| Mit dieser Einstellung wird [[#dns_mitm|dns_mitm]] aktiviert.<br>
<code>0x0</code> = deaktiviert, <code>0x1</code> = aktiviert.
|-
| {{Anker|add_defaults_to_dns_hosts}}<code>add_defaults_to_dns_hosts</code>
| <code>0x0</code> oder <code>0x1</code>
| <code>0x1</code>
| Stellt Atmosphères Standard-HOSTS-Datei einer eigenen voran, die Telemetrie blockiert. Die [https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/features/dns_mitm.md#atmosph%C3%A8re-defaults Standard-Einträge] können auf GitHub gefunden werden.<br>
<code>0x0</code> = deaktiviert, <code>0x1</code> = aktiviert.
|-
| {{Anker|enable_dns_mitm_debug_log}}<code>enable_dns_mitm_debug_log</code>
| <code>0x0</code> oder <code>0x1</code>
| <code>0x0</code>
| Aktiviert den Debug-Log von dns_mitm in <code>/atmosphere/logs/dns_mitm_debug.log</code>.<br>
<code>0x0</code> = deaktiviert, <code>0x1</code> = aktiviert.
|-
| {{Anker|enable_htc}}<code>enable_htc</code>
| <code>0x0</code> oder <code>0x1</code>
| <code>0x0</code>
| Aktiviert Atmosphères [[#htc|Reimplementierung von htc]] (Host-Target Connection).<br>
<code>0x0</code> = deaktiviert, <code>0x1</code> = aktiviert.
|-
| {{Anker|enable_log_manager}}<code>enable_log_manager</code>
| <code>0x0</code> oder <code>0x1</code>
| <code>0x0</code>
| Aktiviert Atmosphères Reimplementierung des Log-Managers. Wenn [[#enable_htc|enable_htc]] auf <code>0x1</code> steht, ist dieser immer aktiviert.<br>
<code>0x0</code> = deaktiviert, <code>0x1</code> = aktiviert.
|-
| {{Anker|enable_standalone_gdbstub}}<code>enable_standalone_gdbstub</code>
| <code>0x0</code> oder <code>0x1</code>
| <code>0x1</code>
| Aktiviert Atmosphères experimentellen Standalone GDB-Stub zum Debuggen. Dies geschieht auf Port 22225 ([https://github.com/Atmosphere-NX/Atmosphere/releases/tag/1.2.3 mehr dazu]).<br>
<code>0x0</code> = deaktiviert, <code>0x1</code> = aktiviert.
|-
| {{Anker|enable_external_bluetooth_db}}<code>enable_external_bluetooth_db</code>
| <code>0x0</code> oder <code>0x1</code>
| <code>0x0</code> oder <code>0x1</code>
| <code>0x1</code>
| <code>0x1</code>
| Aktiviert den hid_mitm-Workaround für alte Homebrews (siehe [[#hid_mitm|Komponente -> Stratosphère -> hid_mitm]]).<br>
| Synchronisiert die Datenbank der verbundenen Bluetooth-Controller auf die SD-Karte in den Pfad <code>SD://atmosphere/bluetooth_devices.db</code>, damit diese zwischen einem Sys- und EmuMMC angeglichen werden kann.<br>
<code>0x0</code> = deaktiviert, <code>0x1</code> = aktiviert.<br>
'''Achtung:''' Ist das Feature aktiviert, eine Datenbank mit mehr als 10 Controllern gespeichert und eine Firmware < 13.0.0 wird gebootet, wird die Datenbank auf 10 Controller gekürzt.<br>
'''Diese Einstellung wird in Zukunft entfernt!'''
<code>0x0</code> = deaktiviert, <code>0x1</code> = aktiviert.
|-
|-
! colspan="4" | [hbloader]
! colspan="4" | [hbloader]
Zeile 345: Zeile 548:
| Unsigned 64-Bit Integer (<code>0x0</code> bis <code>0xFFFFFFFFFFFFFFFF</code>)
| Unsigned 64-Bit Integer (<code>0x0</code> bis <code>0xFFFFFFFFFFFFFFFF</code>)
| <code>u8!0x8600000</code>
| <code>u8!0x8600000</code>
| Kontrolliert, wie viel Speicher anderen Applets zur Verfügung stehen soll, während Homebrews im Applet-Modus ausgeführt werden. Hiermiet ist es bspw. möglich, das Tastatur- oder Web-Applet neben einer Homebrew ohne Absturz laufen zu lassen. Der Standard-Wert sind ca. 140 MB.<br>
| Kontrolliert, wie viel Speicher anderen Applets zur Verfügung stehen soll, während Homebrews im Applet-Modus ausgeführt werden. Hiermit ist es bspw. möglich, das Tastatur- oder Web-Applet neben einer Homebrew ohne Absturz laufen zu lassen. Der Standard-Wert sind ca. 140 MB.<br>
Hat keinen Effekt, wenn <code>applet_heap_size</code> nicht auf <code>0x0</code> steht!
Hat keinen Effekt, wenn <code>applet_heap_size</code> nicht auf <code>0x0</code> steht!
|-
|-
|}
=== {{Anker|BCT.ini}}stratosphere.ini ===
Mit der "<code>/atmosphere/config/stratosphere.ini</code>" (früher "<code>BCT.ini</code>" für ([https://switchbrew.org/wiki/BCT '''B'''oot '''C'''onfiguration '''T'''able]) lassen sich Einstellungen festlegen, die beim Start des Systems geladen werden müssen und während der Laufzeit nicht verändert werden dürfen. Sie sollten nur von erfahrenen Usern geändert werden!<ref>[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/features/configurations.md#stratosphereini configurations.md, Abschnitt "stratosphere.ini"]</ref>
Zuvor muss die stratosphere.ini aus "<code>/atmosphere/config_templates/stratosphere.ini</code>" kopiert werden.
{| class="wikitable" border="1"
|-
! colspan="4" | [stratosphere]
|-
! Config-Key
! Wert
! Beispiel
! Erklärung
|-
| {{Anker|nogc}}<code>nogc</code>
| <code>0</code> oder <code>1</code>
| <code>1</code>
| Erzwingt das (De-)Aktivieren der NoGC-Patches, welche das Aktualisieren der GameCard-Treiber-Firmware ([https://switchbrew.org/wiki/Gamecard_ASIC LOTUS3]) verhindern. Dadurch lassen sich auch keine GameCards starten.<br>
<code>0</code> = NoGC-Patches erzwungen deaktiviert, <code>1</code> = NoGC-Patches erzwungen aktiviert<br>
Es gibt keinen Standardwert - Atmosphère versucht standardmäßig selbst mithilfe der Anzahl der gebrannten GameCard-FUSES herauszufinden, ob ein NoGC-Patch notwendig ist.
|}
=== exosphere.ini ===
Mit der "<code>/exosphere.ini</code>" lässt sich das Verhalten von Atmosphères Secure Monitor anpassen.<ref>https://github.com/Atmosphere-NX/Atmosphere/blob/prodinfo_memes/config_templates/exosphere.ini</ref> Die INI muss vorher aus "<code>/atmosphere/config_templates/exosphere.ini</code>" kopiert werden. Früher befanden sich diese Einstellungen in der BCT.ini.
{| class="wikitable" border="1"
! Config-Key
! Wert
! Beispiel
! Erklärung
|-
| {{Anker|debugmode}}<code>debugmode</code>
| <code>0</code> oder <code>1</code>
| <code>1</code>
| Signalisiert dem Kernel, dass der Debugging-Mode aktiv ist. Wenn der Debug-Mode deaktiviert ist, wird eventuell der Debugger in zukünftigen Atmosphère-Versionen nicht mehr funktionieren.<br>
<code>0</code> = Debug-Mode deaktiviert, <code>1</code> = Debug-Mode aktiviert (Standard)
|-
| {{Anker|debugmode_user}}<code>debugmode_user</code>
| <code>0</code> oder <code>1</code>
| <code>0</code>
| Signalisiert dem Userland, dass der Debugging-Mode aktiv ist.<br>
<code>0</code> = Debug-Mode im Userland deaktiviert (Standard), <code>1</code> = Debug-Mode im Userland aktiviert
|-
| {{Anker|disable_user_exception_handlers}}<code>disable_user_exception_handlers</code>
| <code>0</code> oder <code>1</code>
| <code>0</code>
| Deaktiviert Exception-Handler im Usermode. Dies sorgt dafür, dass Atmosphère bei Fehlern nicht sauber heruntergefahren wird, weshalb ein Aktivieren dieser Option (also das Deaktivieren der Usermode Exception Handler) nicht empfohlen wird.<br>
<code>0</code> = Usermode Exception Handler sind aktiviert (Standard), <code>1</code> = Usermode Exception Handler sind deaktiviert
|-
| {{Anker|enable_user_pmu_access}}<code>enable_user_pmu_access</code>
| <code>0</code> oder <code>1</code>
| <code>0</code>
| Aktiviert den Zugriff auf die PMU-Register vom Userland aus (Power-Management). Es ist nicht bekannt, was das Aktivieren dieser Option für Auswirkungen auf Spiele, etc. hat.<br>
<code>0</code> = PMU-Register-Zugriff deaktiviert (Standard), <code>1</code> = PMU-Register-Zugriff aktiviert
|-
| {{Anker|blank_prodinfo_sysmmc}}<code>blank_prodinfo_sysmmc</code>
| <code>0</code> oder <code>1</code>
| <code>0</code>
| Wenn diese Option aktiviert ist, wird die [https://switchbrew.org/wiki/Calibration PRODINFO-Partition] mit wichtigen Hardware-Keys und -Zertifikaten "pseudo-gelöscht", sodass das System keine validen Keys und keine Seriennummer mehr erkennt. Es ist nicht bekannt, ob es sicher ist, dies zu nutzen, da diese Informationen eventuell an anderer Stelle vom System gecached werden. '''Die eigentliche PRODINFO-Partition wird hierbei nicht angerührt!''' ''Auch bekannt als "Incognito".''
'''Achtung:''' Ab der Firmware 17.0.0 [[Nintendo-Switch-Firmware_17.0.0#Fatal_Error_mit_aktiviertem_PRODINFO-Blanking|führt die Aktivierung zu einem "Fatal Error"]], wenn die Konsole mit dem Internet verbunden wird.
<code>0</code> = Deaktiviert (Standard), <code>1</code> = Aktiviert
|-
| {{Anker|blank_prodinfo_emummc}}<code>blank_prodinfo_emummc</code>
| <code>0</code> oder <code>1</code>
| <code>0</code>
| Gleiches wie oben, nur für den EmuMMC.
'''Achtung:''' Ab der Firmware 17.0.0 [[Nintendo-Switch-Firmware_17.0.0#Fatal_Error_mit_aktiviertem_PRODINFO-Blanking|führt die Aktivierung zu einem "Fatal Error"]], wenn die Konsole mit dem Internet verbunden wird.
<code>0</code> = Deaktiviert (Standard), <code>1</code> = Aktiviert
|-
| {{Anker|allow_writing_to_cal_sysmmc}}<code>allow_writing_to_cal_sysmmc</code>
| <code>0</code> oder <code>1</code>
| <code>0</code>
| Ermöglicht den Schreibzugriff auf die [https://switchbrew.org/wiki/Calibration PRODINFO-Partition] für Homebrews. Ohne ein sicheres Backup ist das Aktivieren nicht empfohlen, weshalb ein verschlüsseltes Backup im MMC angelegt und jedes Mal verifiziert wird. Schlägt dies fehl, wird der Schreibzugriff weiterhin blockiert. '''Im EmuMMC ist das Schreiben auf die PRODINFO-Partition immer erlaubt.'''
<code>0</code> = Deaktiviert (Standard), <code>1</code> = Aktiviert
|-
| {{Anker|log_port}}<code>log_port</code>
| <code>0</code> bis <code>3</code>
| <code>0</code>
| Kontrolliert, welcher UART-Port für das Logging verwendet werden soll.<br>
<code>0</code> = UART-A (Standard), <code>1</code> = UART-B, <code>2</code> = UART-C, <code>3</code> = UART-D
|-
| {{Anker|log_baud_rate}}<code>log_baud_rate</code>
| <code>0</code> bis <code>115200</code>
| <code>0</code>
| Kontrolliert die [[w:Symbolrate|Symbolrate]], mit der die Logs auf dem eingestellten UART-Port übertragen werden soll.<br>
<code>0</code> wird als 115200 (Standard) behandelt
|-
| {{Anker|log_inverted}}<code>log_inverted</code>
| <code>0</code> oder <code>1</code>
| <code>0</code>
| Gibt an, ob der Logging UART-Port invertiert ist.<br>
<code>0</code> = Nein (Standard), <code>1</code> = Ja
|
|}
|}


Zeile 406: Zeile 708:
| <code>pt</code>
| <code>pt</code>
| Portugiesisch
| Portugiesisch
|-
| <code>pt-BR</code>
| Brasilianisches Portugiesisch
|-
|-
| <code>ru</code>
| <code>ru</code>
Zeile 452: Zeile 757:


=== Cheats ===
=== Cheats ===
Atmosphère unterstützt Action-Replay-artige Cheats und ist kompatibel zu [[SX OS|Gateshark]]-Codes. Eine umfangreiche Dokumentation zum Erstellen von Cheats kann im [https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/cheats.md Atmosphère GitHub] gefunden werden. Cheats müssen als Textdatei an folgendem Ort auf der SD-Karte platziert werden:
Atmosphère unterstützt Action-Replay-artige Cheats und ist kompatibel zu [[SX OS|Gateshark]]-Codes. Eine umfangreiche Dokumentation zum Erstellen von Cheats kann im [https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/features/cheats.md Atmosphère GitHub] gefunden werden. Cheats müssen als Textdatei an folgendem Ort auf der SD-Karte platziert werden:


<code>/atmosphere/contents/{{TitleID}}/cheats/<abbr title="Build-ID des Spiels in Hexadezimal">''BUILD-ID''</abbr>.txt</code>
<code>/atmosphere/contents/{{TitleID}}/cheats/<abbr title="Build-ID des Spiels in Hexadezimal">''BUILD-ID''</abbr>.txt</code>


Die Build-ID des Spiels ist dazu da, Cheats für bestimmte Spiele-Versionen zu unterschieden. [https://github.com/WerWolv/EdiZon/releases EdiZon v4] zeigt bspw. die Build-ID des Spiels an. Fertige Cheats lassen sich per EdiZon oder direkt [https://github.com/WerWolv/EdiZon_CheatsConfigsAndScripts/tree/master/Cheats#atmosph%C3%A8re-cheats auf GitHub herunterladen].
Die Build-ID des Spiels dient dazu, Cheats für bestimmte Spiele-Versionen zu unterschieden. [https://github.com/WerWolv/EdiZon/releases EdiZon v4] zeigt bspw. die Build-ID des Spiels an. Fertige Cheats lassen sich per EdiZon oder direkt [https://github.com/WerWolv/EdiZon_CheatsConfigsAndScripts/tree/master/Cheats#atmosph%C3%A8re-cheats auf GitHub herunterladen].


Es empfiehlt sich noch, in den System Settings "[[#dmnt_cheats_enabled_by_default|dmnt_cheats_enabled_by_default]]" auf "0x0" und "[[#dmnt_always_save_cheat_toggles|dmnt_always_save_cheat_toggles]]" auf "0x1" zu setzen, da so Cheats selbst per bspw. EdiZon aktiviert werden können und der Cheat-Status immer gespeichert wird. Letzterer wird unter "<code>/atmosphere/contents/{{TitleID}}/cheats/toggles.txt</code>" gespeichert.
Es empfiehlt sich noch, in den System Settings "[[#dmnt_cheats_enabled_by_default|dmnt_cheats_enabled_by_default]]" auf "0x0" und "[[#dmnt_always_save_cheat_toggles|dmnt_always_save_cheat_toggles]]" auf "0x1" zu setzen, da so Cheats selbst per bspw. EdiZon aktiviert werden können und der Cheat-Status immer gespeichert wird. Letztere werden unter "<code>/atmosphere/contents/{{TitleID}}/cheats/toggles.txt</code>" gespeichert.


Standardmäßig werden Cheats aktiviert, wenn ein Spiel gestartet und dabei nicht "L" gedrückt gehalten wird. Dies lässt sich in den Button Overrides unter "[[#cheat_enable_key|cheat_enable_key]]" ändern.
Standardmäßig werden Cheats aktiviert, wenn ein Spiel gestartet und dabei nicht "L" gedrückt gehalten wird. Dies lässt sich in den Button Overrides unter "[[#cheat_enable_key|cheat_enable_key]]" ändern.
=== Splash-Screen ===
Ein eigener Splash-Screen wird beim Start des Systems angezeigt und muss in die package3 injiziert werden. Dazu steht im Git-Repositorium ein [https://github.com/Atmosphere-NX/Atmosphere/blob/master/utilities/insert_splash_screen.py Python-Skript] zur Verfügung, welches wie folgt aufgerufen werden muss:
{{Pre|'''python''' insert_splash_screen.py customsplash.png pfad/zur/package3}}
Das Bild sollte eine Auflösung von exakt 1280x720 Pixeln besitzen.
=== EmuMMC ===
Ein EmuMMC ist eine getrennte Umgebung des Systems auf der SD-Karte, in der bspw. nur Homebrew ausgeführt werden kann und der normale SysMMC unangetastet bleibt. Geläufig ist auch der Begriff "EmuNAND".
Die Einrichtung eines EmuMMC ist nicht mit Atmosphère möglich - hierfür muss [https://wiidatabase.de/switch-downloads/custom-firmware/hekate/ hekate] verwendet werden, welches auch automatisch die Konfigurationsdatei schreibt. Wird [[hekate]] als Bootloader genutzt, kann auch bequem in den SysMMC gebootet werden, ohne eine Konfigurationsdatei bearbeiten zu müssen. Ansonsten muss "<code>emummc!enabled = 1</code>" in der "<code>emummc/emummc.ini</code>" auf "0" gestellt werden.
=== erpt ===
Mithilfe von Atmosphères eigener Reimplementierung von "[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/components/modules/erpt.md erpt]" (Error Report) werden Crash Reports nicht mehr im System-Speicherstand, sondern auf der SD-Karte im Pfad "<code>/atmosphere/erpt_reports/</code>" angelegt. Dies verhindert das Hochladen dieser zu Nintendo, wenn die Original Firmware gebootet wird.


=== fatal ===
=== fatal ===
[[Datei:Atmosphere fatal.png|mini|Atmosphères "fatal" Absturzbildschirm]]
[[Datei:Atmosphere fatal.png|mini|Atmosphères "fatal" Absturzbildschirm]]
"fatal" ist der Absturzbildschirm der Nintendo Switch. Atmosphère überschreibt [https://switchbrew.org/wiki/Fatal_services diesen Service] mit einem eigenen, der die Logs auch auf der SD-Karte unter "<code>/atmosphere/fatal_reports/</code>", anstatt im Speicher der Switch speichert. So wird auch verhindert, dass eventuelle Fehler-Logs zu Nintendo hochgeladen werden. Auch besteht die Möglichkeit, per "POWER"-Knopf die Konsole normal neu zu starten (nicht in Atmosphère) oder einen Lautstärkeknopf, um den [[#Reboot-Payload|Reboot-Payload]] zu starten. "[[#fatal_auto_reboot_interval|fatal_auto_reboot_interval]]" kann auch auf einen Wert gesetzt werden, um die Konsole automatisch neu in den Reboot-Payload zu starten.
"fatal" ist der Absturzbildschirm der Nintendo Switch. Atmosphère [https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/components/modules/fatal.md überschreibt] diesen Service mit einem eigenen, der die Logs auch auf der SD-Karte unter "<code>/atmosphere/fatal_reports/</code>", anstatt im Speicher der Switch speichert. So wird auch verhindert, dass eventuelle Fehler-Logs zu Nintendo hochgeladen werden. Auch besteht die Möglichkeit, per "POWER"-Knopf die Konsole normal neu zu starten (nicht in Atmosphère) oder einen Lautstärkeknopf, um den [[#Reboot-Payload|Reboot-Payload]] zu starten. "[[#fatal_auto_reboot_interval|fatal_auto_reboot_interval]]" kann auch auf einen Wert gesetzt werden, um die Konsole automatisch neu in den Reboot-Payload zu starten.


Nicht zu verwechseln mit dem Pfad "<code>/atmosphere/fatal_errors/</code>", in dem nur Fehlerreports von fusee-primary abgelegt werden.
Nicht zu verwechseln mit dem Pfad "<code>/atmosphere/fatal_errors/</code>", in dem nur Fehlerreports von fusee abgelegt werden.
 
=== htc ===
Atmosphère beinhaltet eine Reimplementierung von "htc", dem "Host-Target Connection" Verbindungsprotokoll. Mit diesem lässt sich mithilfe der PC-Applikation "Starlink" zwischen PC und Switch kommunizieren und bspw. Gameplay streamen. Dieses Feature ist noch nicht fertig und Starlink wurde noch nicht veröffentlicht.


=== Reboot-Payload ===
=== Reboot-Payload ===
Unter "<code>/atmosphere/reboot_payload.bin</code>" kann ein beliebiger Fusée-Gelée-Payload abgelegt werden, der gestartet werden soll, wenn die Konsole neu gestartet wird (falls in den [[#power_menu_reboot_function|System Settings]] <code>power_menu_reboot_function</code> auf <code>payload</code> steht) oder bei einem Reboot über den Absturzbildschirm "fatal". Auch startet die "reboot_to_payload.nro" diesen Payload. Standardmäßig handelt es sich hierbei lediglich um eine Kopie von "fusee-primary.bin".
Unter "<code>/atmosphere/reboot_payload.bin</code>" kann ein beliebiger Fusée-Gelée-Payload abgelegt werden, der gestartet werden soll, wenn die Konsole neu gestartet wird (falls in den [[#power_menu_reboot_function|System Settings]] <code>power_menu_reboot_function</code> auf <code>payload</code> steht) oder bei einem Reboot über den Absturzbildschirm "fatal". Auch startet die "reboot_to_payload.nro" diesen Payload. Standardmäßig handelt es sich hierbei lediglich um eine Kopie von "fusee.bin".


=== KIPs ===
=== KIPs ===
Zeile 475: Zeile 798:


==== KIP-Patches ====
==== KIP-Patches ====
Zusätzlich dazu kann Atmosphère auch bestehende Kernel-Module patchen. Hierfür müssen IPS-Patches in folgenden Ordner platziert werden:
{{Achtung|Hintergrund=#FFCCCC|Ab Atmosphère v1.7.0 werden KIP-Patches nicht mehr unterstützt.}}
 
Mit Atmosphère-Versionen älter als v1.7.0 lassen sich auch bestehende Kernel-Module patchen. Hierfür müssen IPS-Patches in folgendem Ordner platziert werden:


<code>/atmosphere/kip_patches/''NAME''/</code>
<code>/atmosphere/kip_patches/''NAME''/</code>


Wobei "''NAME''" durch einen eigenen Namen ersetzt werden muss. Innerhalb dieser Ordner können mehrere IPS-Patches abgelegt werden, die den Dateinamen des SHA256-Hashes der KIP tragen müssen. Dies wird bspw. für [https://wiidatabase.de/switch-downloads/hacks/signatur-patches/ Signatur-Patches] eingesetzt.
Wobei "''NAME''" durch einen eigenen Namen ersetzt werden muss. Innerhalb dieser Ordner können mehrere IPS-Patches abgelegt werden, die den Dateinamen des SHA256-Hashes der KIP tragen müssen. Dies wird bspw. für Signatur-Patches eingesetzt.
 
=== NRO-Patches ===
NROs lassen sich mithilfe von IPS/IPS32-Patches auf der SD-Karte patchen, wenn diese in folgendem Pfad liegen:
 
<code>/atmosphere/nro_patches/''NAME''/<abbr title="Build-ID der NRO im Hexadezimalsystem">''BUILD-ID''</abbr>.ips</code>
 
Wobei "''NAME''" durch einen eigenen Namen ersetzt werden muss. Bei der Build-ID können nachgestellte Nullen weggelassen werden.


=== NSO-Patches ===
=== NSO-Patches ===
Zeile 499: Zeile 831:
=== LayeredFS ===
=== LayeredFS ===
"LayeredFS" ermöglicht es, Dateien von Spielen mit denen aus der SD-Karte auszutauschen, ohne das eigentliche Spiel modifizieren zu müssen. Es ist dabei eine bequeme Art, Spiele-Mods zu nutzen. Das Knopf-Verhalten zum Aktivieren von LayeredFS wird über den "[[#override_key|override_key]]" Button Override gesteuert. Standardmäßig wird LayeredFS immer aktiviert.
"LayeredFS" ermöglicht es, Dateien von Spielen mit denen aus der SD-Karte auszutauschen, ohne das eigentliche Spiel modifizieren zu müssen. Es ist dabei eine bequeme Art, Spiele-Mods zu nutzen. Das Knopf-Verhalten zum Aktivieren von LayeredFS wird über den "[[#override_key|override_key]]" Button Override gesteuert. Standardmäßig wird LayeredFS immer aktiviert.
'''ACHTUNG:''' Der "<code>/atmosphere/contents/</code>" Ordner hieß früher "<code>/atmosphere/titles/</code>". Er wird automatisch umbenannt, wenn eine neue Atmosphère-Version gestartet wird.


==== RomFS ====
==== RomFS ====
Zeile 506: Zeile 840:


oder als fertig verpacktes RomFS in <code>/atmosphere/contents/{{TitleID}}/romfs.bin</code>.
oder als fertig verpacktes RomFS in <code>/atmosphere/contents/{{TitleID}}/romfs.bin</code>.
===== HTML-Bedienungsanleitungen =====
Um die Inhalte in der Bedienungsanleitung zu ändern, platziere sie mit der gleichen Dateistruktur in:
<code>/atmosphere/contents/{{TitleID}}/manual_html/</code>


==== ExeFS ====
==== ExeFS ====
Zeile 525: Zeile 864:


Speicherstände werden in "<code>/atmosphere/saves/</code>" abgelegt, getrennt nach Sys- und [[#EmuMMC|EmuMMC]]. Es wird ein neuer Speicherstand erstellt, wenn keiner existiert - es wird also nicht der aus dem internen Speicher kopiert!
Speicherstände werden in "<code>/atmosphere/saves/</code>" abgelegt, getrennt nach Sys- und [[#EmuMMC|EmuMMC]]. Es wird ein neuer Speicherstand erstellt, wenn keiner existiert - es wird also nicht der aus dem internen Speicher kopiert!
=== dns_mitm ===
Mit dem Atmosphère-eigenen Systemmodul '''dns_mitm''' lassen sich DNS-Abfragen manipulieren. Die Funktionalität wird dabei durch die [[#System_Settings|System Settings]] gesteuert. Standardmäßig werden Nintendos Telemetrie-Server blockiert.
Folgende Pfade werden nacheinander geladen, wobei beim ersten Fund keine weitere mehr beachtet wird:
* '''Nur im EmuMMC:''' <code>/atmosphere/hosts/emummc_%04lx.txt</code> (formatiert mit der Nummer des EmuMMC aus der <code>emummc.ini</code>)
* '''Nur im EmuMMC:''' <code>/atmosphere/hosts/emummc.txt</code>
* '''Nur im SysMMC:''' <code>/atmosphere/hosts/sysmmc.txt</code>
* '''Beide MMCs:''' <code>/atmosphere/hosts/default.txt</code> (wird mit Standard-Einträgen erstellt, falls noch nicht existent)
Die Standard-Einträge von Atmosphère werden eigenen Einträgen '''vorangestellt'''. Diese sehen zurzeit so aus:<ref>https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/features/dns_mitm.md#atmosph%C3%A8re-defaults</ref>
<pre># Nintendo telemetry servers
127.0.0.1 receive-%.dg.srv.nintendo.net receive-%.er.srv.nintendo.net</pre>
Um eigene Einträge hinzuzufügen, muss eine Textdatei an einer der oben genannten Stellen erstellt werden. Die erste Spalte enthält die Ziel-IP, gefolgt von den umzubiegenden Domains. Um bspw. "wiidatabase.de" auf "8.8.8.8" umzuleiten, müsste die HOSTS-Datei so aussehen:
<pre>8.8.8.8 wiidatabase.de</pre>
Folgende spezielle Zeichen lassen sich zusätzlich in der Domain nutzen:
* <code>*</code> ist ein Wildcard-Zeichen, welches beliebig viele Zeichen (auch null) matcht
* <code>%</code> wird durch das Ergebnis von <code>nsd!environment_identifier</code> ersetzt, welches auf Produktivgeräten immer <code>lp1</code> ausgibt
Um beispielsweise alle Einträge aller Seiten, die mit "wii" anfangen und auf ".de" enden auf "8.8.8.8" weiterzuleiten, kann folgende HOSTS-Datei benutzt werden:
<pre>8.8.8.8 wii*.de</pre>
Dies wirkt sich sowohl auf "wii.de", als auch auf "wiidb.de" und "wiidatabase.de" aus.
Beim Start wird die geladene Hosts-Datei mitsamt aller geparsten Einträge nach <code>/atmosphere/logs/dns_mitm_startup.log</code> geloggt. Wenn das [[#enable_dns_mitm_debug_log|Logging]] in der system_settings.ini aktiviert wurde, werden zusätzlich alle DNS-Abfragen (plus ob Weiterleitungen angewendet wurden) in <code>/atmosphere/logs/dns_mitm_debug.log</code> geloggt.
==== Nintendo- und Update-Server blockieren ====
Um 90DNS nachzuahmen und alle Nintendo- und Update-Server zu blockieren, können die folgenden Host-Einträge benutzt werden (Achtung, [[#enable_dns_mitm|enable_dns_mitm]] muss auf "<code>0x1</code>" stehen!):<ref>https://old.reddit.com/r/SwitchHacks/comments/lb5v5i/atmosphere_0180_released_new_dns_mitm/gls6h5a/</ref>
<pre># 90DNS
127.0.0.1 *nintendo.com
127.0.0.1 *nintendo.net
127.0.0.1 *nintendo.jp
127.0.0.1 *nintendo.co.jp
127.0.0.1 *nintendo.co.uk
127.0.0.1 *nintendo-europe.com
127.0.0.1 *nintendowifi.net
127.0.0.1 *nintendo.es
127.0.0.1 *nintendo.co.kr
127.0.0.1 *nintendo.tw
127.0.0.1 *nintendo.com.hk
127.0.0.1 *nintendo.com.au
127.0.0.1 *nintendo.co.nz
127.0.0.1 *nintendo.at
127.0.0.1 *nintendo.be
127.0.0.1 *nintendods.cz
127.0.0.1 *nintendo.dk
127.0.0.1 *nintendo.de
127.0.0.1 *nintendo.fi
127.0.0.1 *nintendo.fr
127.0.0.1 *nintendo.gr
127.0.0.1 *nintendo.hu
127.0.0.1 *nintendo.it
127.0.0.1 *nintendo.nl
127.0.0.1 *nintendo.no
127.0.0.1 *nintendo.pt
127.0.0.1 *nintendo.ru
127.0.0.1 *nintendo.co.za
127.0.0.1 *nintendo.se
127.0.0.1 *nintendo.ch
127.0.0.1 *nintendoswitch.com
127.0.0.1 *nintendoswitch.com.cn
127.0.0.1 *nintendoswitch.cn
95.216.149.205 *conntest.nintendowifi.net
95.216.149.205 *ctest.cdn.nintendo.net</pre>
=== Daybreak ===
[[Datei:Atmosphère Daybreak.jpg|mini|Daybreak]]
Mithilfe der enthaltenen Applikation "'''Daybreak'''" lassen sich System-Updates sowohl zum Up-, als auch zum Downgraden verwenden. Hierbei wird der Atmosphère-Service "ams:su" verwendet, der die gleiche Logik wie Nintendos Shell zur Installation von Updates über eine Game Card benutzt. Die Update-NCAs werden dabei aus einem beliebigen Ordner auf der SD-Karte installiert, optional lässt sich der exFAT-Treiber mitinstallieren. Die ".cmnt" muss hierbei aber in ".cnmt.nca" umbenannt werden, was bspw. [https://gist.github.com/HookedBehemoth/df36b5970e1c5b1b512ec7bdd9043c6e per] [https://gist.github.com/antiKk/279966c27fdfd9c7fe63b4ae410f89c4 Skript] erledigt werden kann.
== Häufig gestellte Fragen ==
=== Blackscreen nach System-Update ===
Dies kann mehrere Ursachen haben:
* Atmosphère ist nicht aktuell
* Nicht alle Dateien von Atmosphère wurden beim Kopieren auf die SD-Karte ersetzt
* Atmosphère ist noch nicht kompatibel mit der aktuellen Firmware
* Ein Custom-Theme wurde installiert - hierfür die Ordner "<code>/atmosphere/contents/0100000000001000</code>" und "<code>/atmosphere/contents/0100000000001013</code>" entfernen.
* Ein inkompatibles Systemmodul ist installiert - in dem Falle empfiehlt es sich, den ganzen Ordner "<code>/atmosphere/contents/</code>" temporär wegzuverschieben
=== GameCards starten nicht mehr ===
Dies passiert, wenn von einer niedrigeren Firmware aktualisiert wurde und die neue Firmare den GameCard-Treiber aktualisiert. Um ein Downgrade zu verhindern, werden hier ebenfalls eFuses "[[Anti-Downgrade|gebrannt]]", was bedeutet, dass die Aktualisierung des Treibers blockiert wird. Der Grund ist der, dass ein späteres Downgrade dazu führen würde, dass GameCards auf der niedrigeren Firmware nicht mehr abgespielt werden können.
Um dies zu beheben, muss einfach einmalig die Original-Firmware gestartet werden. Dies führt aber zu oben erwähntem Nachteil.
=== {{Anker|enable_deprecated_hid_mitm}} Controller-Eingaben in Homebrews werden nicht erkannt ===
Mit der [[Nintendo-Switch-Firmware 9.0.0|Firmware 9.0.0]] wurden die HID-Komponenten für Controller so sehr geändert, dass libnx (die Bibliothek zum Bauen von Switch-Homebrews) keine Controller-Eingaben mehr erkennt. Dieses Problem wurde zwar in neueren libnx-Versionen behoben, allerdings müssen Homebrews mit der neuen libnx-Version neu gebaut werden. Da nicht jede Homebrew sofort aktualisiert wird/werden kann, wurde als Übergang ein temporäres Modul eingeführt, welches das Problem behebt.<ref>[https://github.com/Atmosphere-NX/Atmosphere/releases/tag/0.9.4 Atmosphère v0.9.4]</ref> Mit Atmosphère v0.10.2 wurde es allerdings standardmäßig deaktiviert<ref>[https://github.com/Atmosphere-NX/Atmosphere/releases/tag/0.10.2 Atmosphère v0.10.2]</ref> und mit v0.18.0 gänzlich entfernt.<ref>[https://wiidatabase.de/atmosphere-v0-18-0/ Atmosphère v0.18.0]</ref>
Zurzeit besteht kein Workaround; die Anwendung muss vom Entwickler angepasst oder (falls möglich) mit einer neueren Version von libnx kompiliert werden.


== Trivia ==
== Trivia ==
* [[SX OS]] verwendet als Basis Atmosphère (siehe auch [[SX OS#Kopierter Atmosphère-Code und Lizenzverstoß]])
* [[SX OS]] verwendet als Basis Atmosphère (siehe auch [[SX OS#Kopierter Atmosphère-Code und Lizenzverstoß]])
* Am 03. Juli 2020 ließ Nintendo die Download-Seite von WiiDatabase.de aus den Google-Suchergebnissen entfernen.<ref>[https://wiidatabase.de/nintendo-laesst-wiidatabase-de-atmosphere-seite-aus-google-entfernen/ Nintendo lässt WiiDatabase.de Atmosphère-Seite aus Google entfernen]</ref>
* Obwohl der Quellcode von Atmosphère unter der GPLv2 freigegeben ist, gibt es zwei Ausnahmen von dieser Lizenz:<ref>[https://github.com/Atmosphere-NX/Atmosphere#licensing Atmosphere#Licensing] README auf GitHub</ref>
** Die Emulatoren yuzu und Ryujinx dürfen Atmosphère-Code kopieren und unter der GPLv2 oder aktueller oder unter der MIT-Lizenz freigeben
** Nintendo darf den Code von Atmosphère unter den Bedingungen der [https://opensource.org/licenses/0BSD Null-Klausel BSD-Lizenz] verwenden (im Grunde genommen Public Domain, aber mit Haftungsausschluss)


== Einzelnachweise ==
== Einzelnachweise ==