Nintendo Switch (Homebrew) - Revision history

Ha1vorsen at 01:33, 28 October 2024

2024-10-28T01:33:30Z

← Older revision		Revision as of 20:33, 27 October 2024
Line 122:		Line 122:
	* The Nintendo Switch OS is a major rewrite of the Nintendo 3DS operating system of the same name.		* The Nintendo Switch OS is a major rewrite of the Nintendo 3DS operating system of the same name.

	== ~~Troubleshooting~~ ==		== First Usage Guides / Frequent Questions ==

			=== What is Atmosphère? ===
			Atmosphère is the custom firmware that you're using on your console. Custom firmware handles all of the invisible patches that you use once you boot into the main Switch menus; it's the software that makes modding your Switch "useful".

			CFW has no visible menu, and there is '''no visible difference''' between a console simply using CFW and one using original firmware (OFW), unless you take advantage of the features in CFW to modify the appearance and functionality of your console.

			=== What is Hekate? ===
			Before the console turns on, there is (normally) invisible software that handles the startup of the console. This applies to most electronic devices. This invisible software software is called the '''bootloader''', and it handles the preparation of the device. When you hacked the Switch, you also gave it a custom bootloader menu named ''Hekate'' ("heh-KAH-tay"). This software serves to add flexibility to how the Nintendo Switch starts up, and provides an interface for you to select different payloads/OSes to launch upon startup, including OSes like Android and Linux.

			=== What is Horizon? ===
			Horizon is the Switch's native OS. Atmosphère applies customisations to this OS, and fully replaces some parts of it behind the scenes, even if you can't see those replacements.

	=== Software ===		=== Software ===

Ha1vorsen: /* Software */

2023-08-01T14:41:07Z

Software

← Older revision		Revision as of 09:41, 1 August 2023
Line 128:		Line 128:
	* '''Nintendo Switch does not boot past Nintendo Switch logo!''' One of these things are likely busted: PRODINFO, your USER partition, your SYSTEM partition, your partition table is messed up. If you run Atmosphère, a rogue sysmodule or corrupt microSD may also be to blame.		* '''Nintendo Switch does not boot past Nintendo Switch logo!''' One of these things are likely busted: PRODINFO, your USER partition, your SYSTEM partition, your partition table is messed up. If you run Atmosphère, a rogue sysmodule or corrupt microSD may also be to blame.
	* '''Nintendo Switch does not boot past Nintendo logo!''' You may have corrupted one of the boot stage slots. Restore a BCPKG2 backup.		* '''Nintendo Switch does not boot past Nintendo logo!''' You may have corrupted one of the boot stage slots. Restore a BCPKG2 backup.
	*After injecting a payload and booting, an error about an unknown package1 version appears! Your homebrew software does not support the Horizon firmware you are trying to run. Update your homebrew, or wait for a new release.		*'''After injecting a payload and booting, an error about an unknown package1 version appears!''' Your homebrew software does not support the Horizon firmware you are trying to run. Update your homebrew, or wait for a new release.
	*'''My homebrew software has a NOFAT error message!''' Your microSD is corrupt. Reformat it, or obtain a new card.		*'''My homebrew software has a NOFAT error message!''' Your microSD is corrupt. Reformat it, or obtain a new card.

Ha1vorsen at 14:36, 1 August 2023

2023-08-01T14:36:57Z

← Older revision		Revision as of 09:36, 1 August 2023
Line 3:		Line 3:
	Atmosphère reimplements many aspects of the original system software as open source software; a step which allows for much more customisability than bytecode patches that are executed at runtime that merely modify existing system modules like most other custom firmwares.		Atmosphère reimplements many aspects of the original system software as open source software; a step which allows for much more customisability than bytecode patches that are executed at runtime that merely modify existing system modules like most other custom firmwares.

	Atmosphère, specifically, has not been on record to cause a single Nintendo network ban to date. This is corroborated by [https://docs.google.com/spreadsheets/d/1yws700EAKpBeYX0CILIZsOOv_JuLSRDUVIUEoe-Dz44/edit this spreadsheet], developer testing, and feedback from banned users, which invariably pinpoint a catalyst stemming from user error, where the user has partaken an action that is known to be bannable. Custom firmware is not equivalent to piracy; only the participation of the latter ~~have~~ been ~~actionable~~.		Atmosphère, specifically, has not been on record to cause a single Nintendo network ban to date. This is corroborated by [https://docs.google.com/spreadsheets/d/1yws700EAKpBeYX0CILIZsOOv_JuLSRDUVIUEoe-Dz44/edit this spreadsheet], developer testing, and feedback from banned users, which invariably pinpoint a catalyst stemming from user error, where the user has partaken an action that is known to be bannable. Custom firmware is not equivalent to piracy; only the participation of the latter has been acted upon by Nintendo, historically.

	Using custom firmware on the Nintendo Switch is considered safe, as long as certain actions are avoided. Contrary to popular rhetoric, ''[https://youtu.be/ZCH_ytgaZx8?t=5257 Nintendo has shown a distinct tolerance to homebrew users]'' and seems to actively allow their presence, as they are able to detect any console running a custom firmware. Nintendo chooses to ban only specific bad actors such as pirates and online cheaters. '''While this can change at any time''', ~~the previous sentence~~ has remained true to this day.		Using custom firmware on the Nintendo Switch is considered safe, as long as certain actions are avoided. Contrary to popular rhetoric, ''[https://youtu.be/ZCH_ytgaZx8?t=5257 Nintendo has shown a distinct tolerance to homebrew users]'' and seems to actively allow their presence, as they are able to detect any console running a custom firmware. Nintendo chooses to ban only specific bad actors such as pirates and online cheaters. '''While this can change at any time''', this behaviour has remained true to this day.

	These actions, for the most part, are disruptive to Nintendo's online infrastructure or sales strategy, and are generally actions that go outside of the scope of legitimate custom firmware usage. These actions also setting a custom avatar, which have been the subject of controversy due to adult content being uploaded by CFW users in the past, and eShop financial fraud, which constitutes a Nintendo Account ban entirely, forfeiting any digital collections held by the account. However, Nintendo account integrity is not a concern for console bans stemming solely via CFW.		These actions, for the most part, are disruptive to Nintendo's online infrastructure or sales strategy, and are generally actions that go outside of the scope of legitimate custom firmware usage. These actions also setting a custom avatar, which have been the subject of controversy due to adult content being uploaded by CFW users in the past, and eShop financial fraud, which constitutes a Nintendo Account ban entirely, forfeiting any digital collections held by the account. However, Nintendo account integrity is not a concern for console bans stemming solely via CFW.

Ha1vorsen: verb plurality agreement

2023-08-01T14:34:40Z

verb plurality agreement

← Older revision		Revision as of 09:34, 1 August 2023
Line 1:		Line 1:
	The [[Nintendo Switch]] is home to a vast homebrew community which ~~have~~ propagated from before the console launch date in 2017. In this time, there have been major technical strives and discoveries that span many devices outside of the Nintendo console itself. One of the most in-depth reverse engineering projects within console hacking is the [[Nintendo Switch (Homebrew)#Atmosphère\|Atmosphère]] project, which reimplements Horizon(NX), the operating system of the console.		The [[Nintendo Switch]] is home to a vast homebrew community which has propagated from before the console launch date in 2017. In this time, there have been major technical strives and discoveries that span many devices outside of the Nintendo console itself. One of the most in-depth reverse engineering projects within console hacking is the [[Nintendo Switch (Homebrew)#Atmosphère\|Atmosphère]] project, which reimplements Horizon(NX), the operating system of the console.

	Atmosphère reimplements many aspects of the original system software as open source software; a step which allows for much more customisability than bytecode patches that are executed at runtime that merely modify existing system modules like most other custom firmwares.		Atmosphère reimplements many aspects of the original system software as open source software; a step which allows for much more customisability than bytecode patches that are executed at runtime that merely modify existing system modules like most other custom firmwares.

Ha1vorsen: /* Homebrew Software */

2023-08-01T03:59:57Z

Homebrew Software

← Older revision		Revision as of 22:59, 31 July 2023
Line 39:		Line 39:

	==== Homebrew Software ====		==== Homebrew Software ====
	I use [https://github.com/Chrscool8/Homebrew-Details Homebrew Details] 0.95[https://wiki.halcove.com/files/homebrew_details.nro] as my primary homebrew browser. I plan to patch it to allow touchscreen input, as this layout and design is unrivaled. Unfortunately, even compared to its 1.0 release. Th		I use [https://github.com/Chrscool8/Homebrew-Details Homebrew Details] 0.95[https://wiki.halcove.com/files/homebrew_details.nro] as my primary homebrew browser. I plan to patch it to allow touchscreen input, as this layout and design is unrivaled. Unfortunately, even compared to its 1.0 release.

Ha1vorsen at 03:57, 1 August 2023

2023-08-01T03:57:40Z

← Older revision		Revision as of 22:57, 31 July 2023
Line 1:		Line 1:
	The Nintendo Switch is home to a vast homebrew community which have propagated from before the console launch date in 2017. In this time, there have been major technical strives and discoveries that span many devices outside of the Nintendo console itself. One of the most ~~major and~~ in-depth reverse engineering projects within console ~~gaming~~ is the [[Nintendo Switch (Homebrew)#Atmosphère\|Atmosphère]] project		The [[Nintendo Switch]] is home to a vast homebrew community which have propagated from before the console launch date in 2017. In this time, there have been major technical strives and discoveries that span many devices outside of the Nintendo console itself. One of the most in-depth reverse engineering projects within console hacking is the [[Nintendo Switch (Homebrew)#Atmosphère\|Atmosphère]] project, which reimplements Horizon(NX), the operating system of the console.

	Atmosphère reimplements many aspects of the original system software as open source software; a step which allows for much more customisability than bytecode patches that are executed at runtime that merely modify existing system modules like most other custom firmwares.		Atmosphère reimplements many aspects of the original system software as open source software; a step which allows for much more customisability than bytecode patches that are executed at runtime that merely modify existing system modules like most other custom firmwares.

Ha1vorsen: /* Troubleshooting */

2023-03-17T01:10:09Z

Troubleshooting

← Older revision		Revision as of 20:10, 16 March 2023
Line 126:		Line 126:
	=== Software ===		=== Software ===

	* Nintendo Switch does not boot past Nintendo Switch logo! One of these things are likely busted: PRODINFO, your USER partition, your SYSTEM partition, your partition table is messed up. If you run Atmosphère, a rogue sysmodule or corrupt microSD may also be to blame.		* '''Nintendo Switch does not boot past Nintendo Switch logo!''' One of these things are likely busted: PRODINFO, your USER partition, your SYSTEM partition, your partition table is messed up. If you run Atmosphère, a rogue sysmodule or corrupt microSD may also be to blame.
	* Nintendo Switch does not boot past Nintendo logo! You may have corrupted one of the boot stage slots. Restore a BCPKG2 backup.		* '''Nintendo Switch does not boot past Nintendo logo!''' You may have corrupted one of the boot stage slots. Restore a BCPKG2 backup.
	*After injecting a payload and booting, an error about an unknown package1 version appears! Your homebrew software does not support the Horizon firmware you are trying to run. Update your homebrew, or wait for a new release.		*After injecting a payload and booting, an error about an unknown package1 version appears! Your homebrew software does not support the Horizon firmware you are trying to run. Update your homebrew, or wait for a new release.
	*My homebrew software has a NOFAT error message! Your microSD is corrupt. Reformat it, or obtain a new card.		*'''My homebrew software has a NOFAT error message!''' Your microSD is corrupt. Reformat it, or obtain a new card.

	=== Hardware ===		=== Hardware ===

	* Nintendo Switch does not boot past Nintendo Switch logo, does not display on the dock, or does not charge! It is highly likely that the M92T36 chip has been blown out by overvoltage, or a physical short. Common causes are using an uncertified USB-A to USB-C cable to charge the unit, or using a third party dock. Third party AC adapters which don't utilise USB also can cause this. Your Switch will likely need to have the M92T36 replaced. A blown BQ24193 may also be the culprit.		* '''Nintendo Switch does not boot past Nintendo Switch logo, does not display on the dock, or does not charge!''' It is highly likely that the M92T36 chip has been blown out by overvoltage, or a physical short. Common causes are using an uncertified USB-A to USB-C cable to charge the unit, or using a third party dock. Third party AC adapters which don't utilise USB also can cause this. Your Switch will likely need to have the M92T36 replaced. A blown BQ24193 may also be the culprit.
	* Screen shows ink-like blotches that obstruct gameplay! Replace the screen. Duh.		* '''Screen shows ink-like blotches that obstruct gameplay!''' Replace the screen. Duh.
	* Nintendo Switch emits a grinding or sawing noise when pressed together! This is the fan scraping against the console's metal backplate. Please do not press the console together.		* '''Nintendo Switch emits a grinding or sawing noise when pressed together!''' This is the fan scraping against the console's metal backplate. Please do not press the console together.
	* Nintendo Switch turns off abruptly, even with remaining battery! The battery may be decalibrated. This can happen to any device with a battery. This occurs when the battery percentage is not synchronised with the physical amount of remaining power. This can be solved by charging the device for double the amount of time it normally takes to reach 100%, and draining it down to zero before fully charging it again. The battery is now calibrated.		* '''Nintendo Switch turns off abruptly, even with remaining battery!''' The battery may be decalibrated. This can happen to any device with a battery. This occurs when the battery percentage is not synchronised with the physical amount of remaining power. This can be solved by charging the device for double the amount of time it normally takes to reach 100%, and draining it down to zero before fully charging it again. The battery is now calibrated.
	* Nintendo Switch does not turn on! Is the unit in RCM? Is the unit fully charged? Have you a modchip installed? If so, check the FAQ of the RCMX86 install guide.		* '''Nintendo Switch does not turn on!''' Is the unit in RCM? Is the unit fully charged? Have you a modchip installed? If so, check the FAQ of the RCMX86 install guide.
	* Nintendo Switch does not enter RCM! All consoles can enter RCM, regardless of whether or not you're able to exploit RCM itself. If the console cannot enter RCM, it is never the fault of software. Instead, a dirty or defective bridging device ("jig"), a dirty or defective console-side slot, or torn ribbon cables will always be the culprit, if the user is following the correct steps to enter RCM (VOL+, Power, Home).		* '''Nintendo Switch does not enter RCM!''' All consoles can enter RCM, regardless of whether or not you're able to exploit RCM itself. If the console cannot enter RCM, it is never the fault of software. Instead, a dirty or defective bridging device ("jig"), a dirty or defective console-side slot, or torn ribbon cables will always be the culprit, if the user is following the correct steps to enter RCM (VOL+, Power, Home).

Ha1vorsen at 11:30, 15 March 2023

2023-03-15T11:30:19Z

← Older revision		Revision as of 06:30, 15 March 2023
Line 20:		Line 20:

	==== Sysmodules ====		==== Sysmodules ====
	~~These~~ are ~~sysmodules~~ that I consider essential ~~to the~~ usage of my console.		There are a few modules that change and enhance the functionality of the Switch. I consider them to be essential in basic usage of the console.
	[[File:SwitchPresence.png\|thumb\|An example of SwitchPresence-Rewritten.]]		[[File:SwitchPresence.png\|thumb\|An example of SwitchPresence-Rewritten.]]
	[https://github.com/cathery/sys-ftpd-light sys-ftpd-light] - FTP server running at all times, allowing remote access to the microSD's files. Can be toggled on or off via controller inputs and starts alongside the console. Access to the FTP server can be restricted via user-defined credentials defined in a configuration file on the microSD card.		[https://github.com/cathery/sys-ftpd-light sys-ftpd-light] - FTP server running at all times, allowing remote access to the microSD's files. Can be toggled on or off via controller inputs and starts alongside the console. Access to the FTP server can be restricted via user-defined credentials defined in a configuration file on the microSD card.

			[https://github.com/exelix11/dvr-patches DVR-Patches] - Technically a compatibility patch for Sys-DVR to run under almost all games, but has the side effect of allowing video recording under almost any title.

	[https://github.com/WerWolv/Tesla-Menu Tesla-Menu] - Overlay menu allowing the use of cheats and advanced sysmodules in real-time, alongside currently running software. Overlays are distributed via .ovl files and installable in /switch.		[https://github.com/WerWolv/Tesla-Menu Tesla-Menu] - Overlay menu allowing the use of cheats and advanced sysmodules in real-time, alongside currently running software. Overlays are distributed via .ovl files and installable in /switch.
Line 41:		Line 43:


	The title I use to serve as the homebrew browser via title takeover is [https://www.nintendo.com/store/products/rogue-bit-switch/ Rogue Bit] - this way, I can simply launch Rogue Bit straight from the HOME Menu to get into a fully escalated ~~homebr~~ [https://www.nintendo.com/store/products/rogue-bit-switch/ Since it is a ~~gamr~~ based around hacking, it is a fitting icon.]~~ew menu.~~		The title I use to serve as the homebrew browser via title takeover is [https://www.nintendo.com/store/products/rogue-bit-switch/ Rogue Bit] - this way, I can simply launch Rogue Bit straight from the HOME Menu to get into a fully escalated homebrew launcher. [https://www.nintendo.com/store/products/rogue-bit-switch/ Since it is a game based around hacking, it is a fitting icon.]

	== Custom firmwares ==		== Custom firmwares ==

Ha1vorsen: /* Homebrew Software */

2023-02-15T05:01:10Z

Homebrew Software

← Older revision		Revision as of 00:01, 15 February 2023
Line 37:		Line 37:

	==== Homebrew Software ====		==== Homebrew Software ====
	I use [https://github.com/Chrscool8/Homebrew-Details Homebrew Details] 0.95[https://wiki.halcove.com/files/homebrew_details.nro] as my primary homebrew browser. I plan to patch it to allow touchscreen input, as this layout and design is ~~unmatchable for me and has~~, ~~unfortunately, drastically changed ever since the~~ 1.0 release. The title I use to serve as the homebrew browser via title takeover is [https://www.nintendo.com/store/products/rogue-bit-switch/ Rogue Bit] - this way, I can simply launch Rogue Bit straight from the HOME Menu to get into a fully escalated ~~homebrew~~ menu.		I use [https://github.com/Chrscool8/Homebrew-Details Homebrew Details] 0.95[https://wiki.halcove.com/files/homebrew_details.nro] as my primary homebrew browser. I plan to patch it to allow touchscreen input, as this layout and design is unrivaled. Unfortunately, even compared to its 1.0 release. Th



			The title I use to serve as the homebrew browser via title takeover is [https://www.nintendo.com/store/products/rogue-bit-switch/ Rogue Bit] - this way, I can simply launch Rogue Bit straight from the HOME Menu to get into a fully escalated homebr [https://www.nintendo.com/store/products/rogue-bit-switch/ Since it is a gamr based around hacking, it is a fitting icon.]ew menu.

	== Custom firmwares ==		== Custom firmwares ==

	===== Atmosphère =====		===== Atmosphère =====
	Atmosphère is the main custom firmware for Nintendo Switch, developed primarily by SciresM of the ReSwitched team. The name is a allusion; Atmosphère runs on top of [[Nintendo Switch#Horizon\|Horizon]], referencing how the atmosphere ~~physically lays~~ on top of the horizon. Its current [https://github.com/Atmosphere-NX/Atmosphere/releases release] is 1.3.2.		Atmosphère is the main custom firmware for Nintendo Switch, developed primarily by SciresM of the ReSwitched team. The name is a allusion; Atmosphère runs on top of [[Nintendo Switch#Horizon\|Horizon]], referencing how the atmosphere rests on top of the horizon. Its current [https://github.com/Atmosphere-NX/Atmosphere/releases release] is 1.4.1.

	===== ReiNX =====		===== ReiNX =====

Ha1vorsen at 00:54, 15 June 2022

2022-06-15T00:54:23Z

← Older revision		Revision as of 19:54, 14 June 2022
Line 5:		Line 5:
	Atmosphère, specifically, has not been on record to cause a single Nintendo network ban to date. This is corroborated by [https://docs.google.com/spreadsheets/d/1yws700EAKpBeYX0CILIZsOOv_JuLSRDUVIUEoe-Dz44/edit this spreadsheet], developer testing, and feedback from banned users, which invariably pinpoint a catalyst stemming from user error, where the user has partaken an action that is known to be bannable. Custom firmware is not equivalent to piracy; only the participation of the latter have been actionable.		Atmosphère, specifically, has not been on record to cause a single Nintendo network ban to date. This is corroborated by [https://docs.google.com/spreadsheets/d/1yws700EAKpBeYX0CILIZsOOv_JuLSRDUVIUEoe-Dz44/edit this spreadsheet], developer testing, and feedback from banned users, which invariably pinpoint a catalyst stemming from user error, where the user has partaken an action that is known to be bannable. Custom firmware is not equivalent to piracy; only the participation of the latter have been actionable.

	Using custom firmware on the Nintendo Switch is considered safe, as long as certain actions are avoided. Contrary to popular rhetoric, ''[https://youtu.be/ZCH_ytgaZx8?t=5257 Nintendo has shown a distinct tolerance to homebrew users]'' and seems to actively allow their presence, as they are able to detect any console running a custom firmware. Nintendo chooses to ban only specific bad actors such as pirates and online cheaters. '''While this can change at any time''', the previous sentence ~~remains~~ true to this day.		Using custom firmware on the Nintendo Switch is considered safe, as long as certain actions are avoided. Contrary to popular rhetoric, ''[https://youtu.be/ZCH_ytgaZx8?t=5257 Nintendo has shown a distinct tolerance to homebrew users]'' and seems to actively allow their presence, as they are able to detect any console running a custom firmware. Nintendo chooses to ban only specific bad actors such as pirates and online cheaters. '''While this can change at any time''', the previous sentence has remained true to this day.

	These actions, for the most part, are disruptive to Nintendo's online infrastructure or sales strategy, and are generally actions that go outside of the scope of legitimate custom firmware usage. These actions also setting a custom avatar, which have been the subject of controversy due to adult content being uploaded by CFW users in the past, and eShop financial fraud, which constitutes a Nintendo Account ban entirely, forfeiting any digital collections held by the account. However, Nintendo account integrity is not a concern for console bans stemming solely via CFW.		These actions, for the most part, are disruptive to Nintendo's online infrastructure or sales strategy, and are generally actions that go outside of the scope of legitimate custom firmware usage. These actions also setting a custom avatar, which have been the subject of controversy due to adult content being uploaded by CFW users in the past, and eShop financial fraud, which constitutes a Nintendo Account ban entirely, forfeiting any digital collections held by the account. However, Nintendo account integrity is not a concern for console bans stemming solely via CFW.