7.838
Bearbeitungen
Atmosphère: Unterschied zwischen den Versionen
Aus WiiDatabase Wiki
Zur Navigation springenZur Suche springen
→System Settings: disable_automatic_report_cleanup
ICON (Diskussion | Beiträge) (→ams_mitm: dns_mitm) |
ICON (Diskussion | Beiträge) (→System Settings: disable_automatic_report_cleanup) |
||
| (35 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 17: | Zeile 17: | ||
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> | 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 == | ||
| Zeile 23: | Zeile 25: | ||
=== Hauptkomponenten === | === Hauptkomponenten === | ||
* {{Anker|Fusee}}'''Fusée''': Bootloader, verifiziert und startet Exosphère und Package2 (Kernel/FIRM-Systemmodule) und patcht diese, falls nötig. | * {{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. | * '''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. | ||
* {{Anker|Stratosphere}}'''Stratosphère''': Eigene Systemmodule mit neuen Features und zur Erweiterung bestehender. | * {{Anker|Stratosphere}}'''Stratosphère''': Eigene Systemmodule mit neuen Features und zur Erweiterung bestehender. | ||
* '''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> | ||
| Zeile 77: | Zeile 78: | ||
| [https://switchbrew.org/wiki/Fatal_services fatal] | | [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. | | 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]''' | | {{Anker|jpegdec}}'''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/components/modules/jpegdec.md jpegdec]''' | ||
| Zeile 87: | Zeile 93: | ||
| [https://switchbrew.org/wiki/Loader_services loader] | | [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). | | 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]''' | | '''[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". | | Dient der Verwaltung von Inhalten (bspw. NAND-Speicherständen). "ncm" steht für "Nintendo Content Manager". | ||
| [https://switchbrew.org/wiki/NCM_services ncm] | | [https://switchbrew.org/wiki/NCM_services ncm] | ||
| | | | ||
|- | |- | ||
| {{Anker|pgl}}[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/components/modules/pgl.md pgl] | | {{Anker|pgl}}[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/components/modules/pgl.md pgl] | ||
| Zeile 111: | Zeile 122: | ||
| Verwaltet Dienste. "sm" steht für "Service Manager". | | Verwaltet Dienste. "sm" steht für "Service Manager". | ||
| [https://switchbrew.org/wiki/Services_API sm] | | [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 | | 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]''' | | '''[https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/components/modules/spl.md spl]''' | ||
| Zeile 134: | Zeile 145: | ||
| '''fs_mitm''' | | '''fs_mitm''' | ||
| Kann Dateien von Titeln mit denen auf der SD-Karte ersetzen, auch bekannt als "'''LayeredFS'''". | | Kann Dateien von Titeln mit denen auf der SD-Karte ersetzen, auch bekannt als "'''LayeredFS'''". | ||
|- | |- | ||
| '''ns_mitm''' | | '''ns_mitm''' | ||
| Zeile 153: | Zeile 157: | ||
Die Inhalte in ''(kursiven Klammern)'' dienen der Erklärung | Die Inhalte in ''(kursiven Klammern)'' dienen der Erklärung | ||
{{Pre|SD-Karte | {{Pre|SD-Karte | ||
| fusee | | fusee.bin ''(Payload, der an die Switch gesendet werden muss, um den Bootprozess einzuleiten, separater Download)'' | ||
| hbmenu.nro ''(Homebrew Menu)'' | | hbmenu.nro ''(Homebrew Menu)'' | ||
| | | | ||
+---atmosphere | +---atmosphere | ||
| | hbl.nsp ''(Homebrew Loader, der das Homebrew Menü lädt)'' | | | hbl.nsp ''(Homebrew Loader, der das Homebrew Menü lädt)'' | ||
| | package3 ''(Signierter/verschlüsselter Fusée-Teil)'' | |||
| | reboot_payload.bin ''([[#Reboot-Payload|Reboot-Payload]], Kopie von fusee-primary, wird bei einem Neustart ausgeführt) | | | reboot_payload.bin ''([[#Reboot-Payload|Reboot-Payload]], Kopie von fusee-primary, wird bei einem Neustart ausgeführt) | ||
| | stratosphere.romfs ''([[#Systemmodule|Atmosphères Systemmodule]], waren früher im "contents"-Ordner | |||
| | | | | | ||
| +---config ''(Konfigurationsdateien)'' | | +---config ''(Konfigurationsdateien)'' | ||
| | | | | | ||
| +---config_templates ''(Konfigurationstemplates)'' | | +---config_templates ''(Konfigurationstemplates)'' | ||
| | exosphere.ini ''([[#exosphere.ini|Einstellungen für Exosphère]])'' | | | exosphere.ini ''([[#exosphere.ini|Einstellungen für Exosphère]])'' | ||
| | override_config.ini ''([[#Overrides|Overrides]])'' | | | override_config.ini ''([[#Overrides|Overrides]])'' | ||
| | stratosphere.ini ''([[#stratosphere.ini|Einstellungen für Stratosphère und fusee-primary]])'' | |||
| | system_settings.ini ''([[#System Settings|Atmosphère-Einstellungen]])'' | | | system_settings.ini ''([[#System Settings|Atmosphère-Einstellungen]])'' | ||
| | | | | | ||
| +--- | | +---flags ''([[#Flags|Flags]])'' | ||
| | | | | | ||
| +---fatal_errors ''(Fehlerreports von fusee-primary)'' | | +---fatal_errors ''(Fehlerreports von fusee-primary)'' | ||
| Zeile 193: | Zeile 180: | ||
| | | | | | ||
| \---kip_patches ''([[#KIP-Patches|KIP-Patches]])'' | | \---kip_patches ''([[#KIP-Patches|KIP-Patches]])'' | ||
| | | | ||
\---switch ''(Ordner für Homebrews)'' | \---switch ''(Ordner für Homebrews)'' | ||
| Zeile 204: | Zeile 189: | ||
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. 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]. | ||
Für [[Mariko]]-Geräte wird empfohlen, [https://wiidatabase.de/switch-downloads/custom-firmware/spacecraft-nx/ Spacecraft-NX] auf den SX Core/Lite zu flashen. Danach muss die "fusee | Für [[Mariko]]-Geräte wird empfohlen, [https://wiidatabase.de/switch-downloads/custom-firmware/spacecraft-nx/ Spacecraft-NX] auf den SX Core/Lite zu flashen. Danach muss die "fusee.bin" in "payload.bin" umbenannt und in den Root der SD-Karte kopiert werden. | ||
== Features == | == Features == | ||
| Zeile 220: | Zeile 205: | ||
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. | 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/ | 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 395: | Zeile 380: | ||
| (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 407: | Zeile 405: | ||
| <code>u8!0x0</code> | | <code>u8!0x0</code> | ||
| 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> | | 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 463: | Zeile 492: | ||
'''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| | | {{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>0x0</code> oder <code>0x1</code> | ||
| <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.<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| | | {{Anker|enable_log_manager}}<code>enable_log_manager</code> | ||
| <code>0x0</code> oder <code>0x1</code> | | <code>0x0</code> oder <code>0x1</code> | ||
| <code>0x0</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. | <code>0x0</code> = deaktiviert, <code>0x1</code> = aktiviert. | ||
|- | |- | ||
| Zeile 496: | Zeile 554: | ||
|} | |} | ||
=== BCT.ini === | === {{Anker|BCT.ini}}stratosphere.ini === | ||
Mit der "<code>/atmosphere/config/BCT.ini</code>" ([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# | 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 | Zuvor muss die stratosphere.ini aus "<code>/atmosphere/config_templates/stratosphere.ini</code>" kopiert werden. | ||
{| class="wikitable" border="1" | {| class="wikitable" border="1" | ||
|- | |- | ||
! colspan="4" | [stratosphere] | ! colspan="4" | [stratosphere] | ||
| Zeile 548: | Zeile 574: | ||
<code>0</code> = NoGC-Patches erzwungen deaktiviert, <code>1</code> = NoGC-Patches erzwungen aktiviert<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. | Es gibt keinen Standardwert - Atmosphère versucht standardmäßig selbst mithilfe der Anzahl der gebrannten GameCard-FUSES herauszufinden, ob ein NoGC-Patch notwendig ist. | ||
|} | |} | ||
| Zeile 604: | Zeile 624: | ||
| <code>0</code> oder <code>1</code> | | <code>0</code> oder <code>1</code> | ||
| <code>0</code> | | <code>0</code> | ||
| Ermöglicht den Schreibzugriff auf die [https://switchbrew.org/wiki/Calibration PRODINFO-Partition] für | | 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 | <code>0</code> = Deaktiviert (Standard), <code>1</code> = Aktiviert | ||
|- | |- | ||
| Zeile 738: | Zeile 758: | ||
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 === | === EmuMMC === | ||
| Zeile 751: | Zeile 778: | ||
"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. | "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 | 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 | 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 788: | Zeile 818: | ||
* <code>boot2.flag</code>: Weist den Process Manager an, diesen Titeln während des Bootvorgangs zu starten (für Systemmodule) | * <code>boot2.flag</code>: Weist den Process Manager an, diesen Titeln während des Bootvorgangs zu starten (für Systemmodule) | ||
* <code>redirect_save.flag</code>: Aktiviert die [[#Speicherstand-Redirection|Speicherstand-Redirection]] für diesen Titel | * <code>redirect_save.flag</code>: Aktiviert die [[#Speicherstand-Redirection|Speicherstand-Redirection]] für diesen Titel | ||
Folgende Globale Flags existieren in "<code>/atmosphere/flags/</code>": | |||
* <code>clean_stratosphere_for_0.19.0.flag</code>: Löscht alte Systemmodule aus dem "contents"-Ordner, da diese seit v0.19.0 in die <code>stratosphere.romfs</code> gebündelt sind | |||
=== LayeredFS === | === LayeredFS === | ||
| Zeile 824: | Zeile 858: | ||
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#hosts-file-selection</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 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:<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 === | === Daybreak === | ||
| Zeile 836: | Zeile 939: | ||
* Atmosphère ist noch nicht kompatibel mit der aktuellen Firmware | * Atmosphère ist noch nicht kompatibel mit der aktuellen Firmware | ||
* Ein Custom-Theme wurde installiert - hierfür den Ordner "<code>/atmosphere/contents/0100000000001000</code>" entfernen. | * Ein Custom-Theme wurde installiert - hierfür den Ordner "<code>/atmosphere/contents/0100000000001000</code>" entfernen. | ||
* Ein inkompatibles Systemmodul ist installiert | |||
=== GameCards starten nicht mehr === | === GameCards starten nicht mehr === | ||
| Zeile 841: | Zeile 945: | ||
Um dies zu beheben, muss einfach einmalig die Original-Firmware gestartet werden. Dies führt aber zu oben erwähntem Nachteil. | 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> | * 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 == | ||
