Atmosphère is a work-in-progress customized firmware for the Nintendo Switch.
Go to file
tslater2006 4d430a4c61
Updates to Cheats documentation (#1568)
* docs: update cheats doc to clarify Code Type 5 encoding

This change removes references to the "M" nibble for the "Register Address" encoding of Code Type 5 whis is not used in this mode.

In the dword block the "M" has been replaced with a "0"

* docs: update cheats doc to clarify register usage on Code Type 5

This adds additional clarification for "Register Address Encoding" mode of Code Type 5 that the "R" nibble reflects both the destination as well as the base memory address.

* docs: update cheats doc to make Code Types consistent

Code Types are now consistently written in hex notation.
2021-07-16 11:17:03 -07:00
.github/ISSUE_TEMPLATE Update issue template to ask whether sysmmc or emummc. 2021-05-12 08:27:21 -07:00
config_templates ams: bump version to 0.19.4 2021-06-08 08:09:05 -07:00
docs Updates to Cheats documentation (#1568) 2021-07-16 11:17:03 -07:00
emummc git subrepo push emummc 2021-06-22 16:13:04 -07:00
exosphere exo: fix SE aes-ctr usage in GetSecureData 2021-07-16 10:55:49 -07:00
fusee ams: basic support for 12.1.0 2021-07-06 07:13:56 -07:00
img Push all graphical resources to main repo, add credits 2018-05-01 18:42:23 -06:00
libraries kern: since 10.0.0, KDebug::GetThreadContext always returns X0-X7 2021-07-13 13:00:16 -07:00
mesosphere kern: update initial cache management to match latest kernel 2021-07-12 18:30:01 -07:00
sept exo: update for 12.1.0 2021-07-06 06:55:59 -07:00
stratosphere ams: std::optional -> util::optional 2021-07-08 02:37:26 -07:00
thermosphere build: use DWARFv4 explicitly for IDA compatibility with debug elfs 2021-06-25 23:48:41 -07:00
troposphere build: use DWARFv4 explicitly for IDA compatibility with debug elfs 2021-06-25 23:48:41 -07:00
utilities erpt: add (stubbed, TODO after 0.19.0) support for 12.0.0 2021-04-11 03:42:16 -07:00
.gitattributes libstratosphere: use from /atmosphere/libraries 2019-12-09 18:54:29 -08:00
.gitignore ams: add transient unit testing sysmodule to gitignore 2021-02-04 02:08:49 -08:00
.gitmodules Remove boost submodule 2019-12-08 16:27:45 -08:00
LICENSE Add license and disclaimer. 2018-01-17 23:54:38 -08:00
Makefile build: use DWARFv4 explicitly for IDA compatibility with debug elfs 2021-06-25 23:48:41 -07:00
README.md licensing: update exemptions (approved by contributors). 2020-04-16 17:33:04 -07: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.