Atmosphère: Unterschied zwischen den Versionen

1.673 Bytes hinzugefügt ,  4. Dezember 2023
K
K (→‎KIP-Patches: Update)
(15 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 187: Zeile 187:


== 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.
 
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 261: 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"
|-
| {{Anker|override_key_album}}<code>override_key</code>
| [[#Tasten|Taste]]
| <code>R</code>
| Bestimmt, welcher Knopf gedrückt (oder nicht gedrückt) gehalten werden soll, um [[#LayeredFS|LayeredFS]] (Mods) zu aktivieren. Wird in dem Beispiel "X" gedrückt gehalten, wird LayeredFS für diesen Titel deaktiviert. Ist bspw. nur "ZL" eingestellt, werden Mods nur aktiviert, wenn "ZL" gedrückt gehalten wird.<br>
'''Merkhilfe''': "Aktiviere LayeredFS, wenn X nicht gedrückt gehalten wird"
|-
|-
| <code>override_any_app_address_space</code>
| <code>override_any_app_address_space</code>
Zeile 422: Zeile 414:
| {{Anker|sd_card_log_output_directory}}<code>sd_card_log_output_directory</code>
| {{Anker|sd_card_log_output_directory}}<code>sd_card_log_output_directory</code>
| String
| String
| <code>str!atmosphere/binlogs/code>
| <code>str!atmosphere/binlogs</code>
| Konfiguriert den Pfad, in dem Logs gespeichert werden
| 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
|-
|-
! colspan="4" | [atmosphere]
! colspan="4" | [atmosphere]
Zeile 469: 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 513: Zeile 518:
| <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>
| 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>0x1</code>
| 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>
'''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>
<code>0x0</code> = deaktiviert, <code>0x1</code> = aktiviert.
<code>0x0</code> = deaktiviert, <code>0x1</code> = aktiviert.
|-
|-
Zeile 530: 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!
|-
|-
Zeile 593: Zeile 611:
| <code>0</code> oder <code>1</code>
| <code>0</code> oder <code>1</code>
| <code>0</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 Infos eventuell anderswo vom System gecached werden. '''Die eigentliche PRODINFO-Partition wird hierbei nicht angerührt!''' ''Auch bekannt als "Incognito".''
| 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
<code>0</code> = Deaktiviert (Standard), <code>1</code> = Aktiviert
|-
|-
Zeile 600: Zeile 621:
| <code>0</code>
| <code>0</code>
| Gleiches wie oben, nur für den EmuMMC.
| 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
<code>0</code> = Deaktiviert (Standard), <code>1</code> = Aktiviert
|-
|-
Zeile 775: Zeile 799:
<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 ===
=== NRO-Patches ===
Zeile 871: Zeile 895:


==== Nintendo- und Update-Server blockieren ====
==== 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>
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
<pre># 90DNS
127.0.0.1 *nintendo.com
127.0.0.1 *nintendo.com
Zeile 919: Zeile 943:
* Nicht alle Dateien von Atmosphère wurden beim Kopieren auf die SD-Karte ersetzt
* Nicht alle Dateien von Atmosphère wurden beim Kopieren auf die SD-Karte ersetzt
* 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 die Ordner "<code>/atmosphere/contents/0100000000001000</code>" und "<code>/atmosphere/contents/0100000000001013</code>" entfernen.
* Ein inkompatibles Systemmodul ist installiert
* Ein inkompatibles Systemmodul ist installiert


Zeile 935: Zeile 959:
* [[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 ==