1
0
Fork 0
mirror of https://github.com/Atmosphere-NX/Atmosphere.git synced 2024-11-22 20:06:40 +00:00
Atmosphère is a work-in-progress customized firmware for the Nintendo Switch.
Find a file
Michael Scire 02e987819b ncm: work around change in Nintendo save handling behavior
Static save files do not require an entry in the save data indexer to mount.
Prior to 17.0.0, save data files were considered static if userid was 0.
In 17.0.0+, only 8000000000000000 is static.

However, some users using cfw do not have an entry for 8000000000000120 in the indexer,
for various reasons (but mostly manual nand-restore, I think). Thus, on boot of 17.0.0+,
FS will say 8000000000000120 is not present (not in indexer), and NCM will create it anew.

The 8000000000000120 save will then be empty, and then the firmware can't boot.

To workaround this, logic has been re-enabled on 17.0.0+ for building the content meta database.
Thus, if the user encounters this error, the 8000000000000120 save will be emptied, but then
it will be automatically reconstructed, fixing the problem.
2023-10-12 08:55:58 -07:00
.github/ISSUE_TEMPLATE Update issue template to ask whether sysmmc or emummc. 2021-05-12 08:27:21 -07:00
config_templates Add system setting to mirror bluetooth pairing database to sd card (#1787) 2023-03-10 10:06:38 -07:00
docs docs: commit saddest changelog of all time, this is your brain on going to vacation 2023-08-21 17:30:06 -07:00
emummc emummc: fix offsets for 17.0.0 2023-10-12 08:55:58 -07:00
exosphere bpc.mitm/exo: support pmic reboot/shutdown on mariko (thanks @CTCaer) 2023-10-12 08:55:58 -07:00
fusee fusee: support parsing 17.0.0+ INI 2023-10-12 08:55:58 -07:00
img utils: add script for inserting custom image into package3 2021-09-06 16:26:50 -07:00
libraries ncm: work around change in Nintendo save handling behavior 2023-10-12 08:55:58 -07:00
mesosphere kern: update KMemoryRegionType values for new ids + SecureUnknown region 2023-10-12 08:55:58 -07:00
stratosphere ncm: work around change in Nintendo save handling behavior 2023-10-12 08:55:58 -07:00
tests strat: add windows socket api, linux/macos TODO 2022-03-27 14:36:31 -07:00
thermosphere build: remove unnecessary g-dwarf4 flags 2022-02-14 14:58:52 -08:00
troposphere haze: implement android operations 2023-10-11 18:57:49 -07:00
utilities utils: update erpt script 2023-10-12 08:55:58 -07:00
.gitattributes linguist: add vanity corrections 2021-09-11 20:03:42 -07:00
.gitignore util: update function dtors, update gitignore 2022-03-21 17:21:44 -07:00
.gitmodules Remove boost submodule 2019-12-08 16:27:45 -08:00
atmosphere.mk jpegdec: stop bundling (TODO post-prerelease) 2023-10-12 08:55:58 -07:00
LICENSE
Makefile ams: support building unit test programs on windows/linux/macos 2022-03-21 17:21:44 -07:00
README.md Update ReSwitched Team URL 2023-01-20 19:01:33 -08:00

Banner

License Chat on Discord

Atmosphère is a work-in-progress customized firmware for the Nintendo Switch.

Components

Atmosphère consists of multiple components, each of which replaces/modifies a different component of the system:

  • Fusée: First-stage Loader, responsible for loading and validating stage 2 (custom TrustZone) plus package2 (Kernel/FIRM sysmodules), and patching them as needed. This replaces all functionality normally in Package1loader/NX Bootloader.
    • Sept: Payload used to enable support for runtime key derivation on 7.0.0.
  • Exosphère: Customized TrustZone, to run a customized Secure Monitor
  • Thermosphère: EL2 EmuNAND support, i.e. backing up and using virtualized/redirected NAND images
  • Stratosphère: Custom Sysmodule(s), both Rosalina style to extend the kernel/provide new features, and of the loader reimplementation style to hook important system actions
  • Troposphère: Application-level Horizon OS patches, used to implement desirable CFW features

Licensing

This software is licensed under the terms of the GPLv2, with exemptions for specific projects noted below.

You can find a copy of the license in the LICENSE file.

Exemptions:

  • The yuzu Nintendo Switch emulator and the Ryujinx Team and Contributors are exempt from GPLv2 licensing. They are permitted, each at their individual discretion, to instead license any source code authored for the Atmosphère project as either GPLv2 or later or the MIT license. In doing so, they may alter, supplement, or entirely remove the copyright notice for each file they choose to relicense. Neither the Atmosphère project nor its individual contributors shall assert their moral rights against any of the aforementioned projects.
  • Nintendo is exempt from GPLv2 licensing and may (at its option) instead license any source code authored for the Atmosphère project under the Zero-Clause BSD license.

Credits

Atmosphère is currently being developed and maintained by SciresM, TuxSH, hexkyz, and fincs.
In no particular order, we credit the following for their invaluable contributions:

  • switchbrew for the libnx project and the extensive documentation, research and tool development pertaining to the Nintendo Switch.
  • devkitPro for the devkitA64 toolchain and libnx support.
  • ReSwitched Team for additional documentation, research and tool development pertaining to the Nintendo Switch.
  • ChaN for the FatFs module.
  • Marcus Geelnard for the bcl-1.2.0 library.
  • naehrwert and st4rk for the original hekate project and its hwinit code base.
  • CTCaer for the continued hekate project's fork and the minerva_tc project.
  • m4xw for development of the emuMMC project.
  • Riley for suggesting "Atmosphere" as a Horizon OS reimplementation+customization project name.
  • hedgeberg for research and hardware testing.
  • lioncash for code cleanup and general improvements.
  • jaames for designing and providing Atmosphère's graphical resources.
  • Everyone who submitted entries for Atmosphère's splash design contest.
  • All those who actively contribute to the Atmosphère repository.